ESP32 DevKit V1 (Espressif)

The ESP32 DevKit V1 is a high-performance, low-cost microcontroller board designed for Internet of Things (IoT) applications.

ESP32 DevKit V1.0

At a glance

Pins and properties exactly as the circuit editor and simulator define this part. The text below explains how to use them.

Board facts

Board facts
FactValue
Operating voltage3.3 V
FamilyEspressif
Python runtimemicropython
Wi-FiYes
BluetoothYes
Native USBNo

Pinout

Pinout of the ESP32 DevKit V1.0. Select a label to see that pin in the table below.

The ESP32 DevKit V1 is a high-performance, low-cost microcontroller board designed for Internet of Things (IoT) applications. It is powered by the popular Espressif ESP32 system-on-chip (SoC).


1. Hardware Specifications

  • Processor: Dual-core Tensilica Xtensa 32-bit LX6 microprocessor running at 240 MHz.
  • Logic Level: 3.3V. All pins operate on 3.3V logic.
  • Memory Limits: 4 MB Flash memory, 520 KB SRAM (sufficient for running MicroPython and holding large WiFi stacks).
  • Wireless: Integrated 802.11 b/g/n Wi-Fi and Bluetooth v4.2 / BLE.

2. Detailed Pinout & GPIO Map

Below is the complete physical-to-code mapping table for the ESP32 DevKit V1 (30-pin layout):

Pins of this board
PinKindFeaturesAlternate functionsNotes
ENSpecialENABLE, RESETPulls low to reset the board. Connected to EN button.
VPAnalogADC, Input onlyGPIO36, ADC1_0, RTCIO0Input Only. No internal pull-up/pull-down resistors.
VNAnalogADC, Input onlyGPIO39, ADC1_3, RTCIO3Input Only. No internal pull-up/pull-down resistors.
D34AnalogADC, Input onlyGPIO34, ADC1_6, RTCIO4Input Only. No internal pull-up/pull-down resistors.
D35AnalogADC, Input onlyGPIO35, ADC1_7, RTCIO5Input Only. No internal pull-up/pull-down resistors.
D32GPIOPWM, ADC, TouchGPIO32, PWM, ADC1_4, TOUCH9, RTCIO9Touch sensor pin 9.
D33GPIOPWM, ADC, TouchGPIO33, PWM, ADC1_5, TOUCH8, RTCIO8Touch sensor pin 8.
D25GPIOPWM, ADC, DACGPIO25, PWM, DAC1, ADC2_8, RTCIO6True 8-bit digital-to-analog converter channel.
D26GPIOPWM, ADC, DACGPIO26, PWM, DAC2, ADC2_9, RTCIO7True 8-bit digital-to-analog converter channel.
D27GPIOPWM, ADC, TouchGPIO27, PWM, ADC2_7, TOUCH7, RTCIO17Touch sensor pin 7.
D14GPIOPWM, ADC, TouchGPIO14, PWM, ADC2_6, TOUCH6, RTCIO16SPI Serial Clock.
D12GPIOPWM, ADC, TouchGPIO12, PWM, ADC2_5, TOUCH5, RTCIO15Bootstrap Pin. Must not be pulled high during boot (causes flashing fails).
D13GPIOPWM, ADC, TouchGPIO13, PWM, ADC2_4, TOUCH4, RTCIO14SPI Master Out Slave In.
GNDGround
VINPower5-12V
D23GPIOPWMGPIO23, PWM, MOSI, SPIVSPI Master Out Slave In.
D22GPIOPWMGPIO22, PWM, SCL, I2CI2C Serial Clock line.
TX0GPIOPWMGPIO1, PWM, UART0Connected to USB-to-UART converter chip. Do not use.
RX0GPIOPWMGPIO3, PWM, UART0Connected to USB-to-UART converter chip. Do not use.
D21GPIOPWMGPIO21, PWM, SDA, I2CI2C Serial Data line.
D19GPIOPWMGPIO19, PWM, MISO, SPIVSPI Master In Slave Out.
D18GPIOPWMGPIO18, PWM, SCK, SPIVSPI Serial Clock.
D5GPIOPWMGPIO5, PWM, CS, SPISPI Chip Select channel.
TX2GPIOPWMGPIO17, PWM, UART2Serial UART 2 Transmit channel.
RX2GPIOPWMGPIO16, PWM, UART2Serial UART 2 Receive channel.
D4GPIOPWM, ADC, TouchGPIO4, PWM, ADC2_0, TOUCH0Touch sensor pin 0.
D2GPIOPWM, ADC, TouchGPIO2, PWM, ADC2_2, TOUCH2Bootstrap Pin / User LED. Onboard blue diagnostic LED; must be low during download.
D15GPIOPWM, ADC, TouchGPIO15, PWM, ADC2_3, TOUCH3Bootstrap Pin. Outputs boot log state at startup.
GNDGround
3V3Power3.3V, LDO OUT
  • BOOT: Not a wireable GPIO in OMS — it's modeled purely as the physical BOOT button, not a header pin you can connect components to. Must be held low (default board behavior) to enter flashing mode; high/floating to run your program.

3. Power, Logic Level & Bootstrap Pin Warnings

[!CAUTION] Strict 3.3V Logic Tolerance: The ESP32 microchip is not 5V tolerant. Applying 5V to any GPIO pin will damage the internal silicon die. Always run external sensors at 3.3V, or interface with 5V components using level shifters.

  • Power Input: Powered via Micro-USB (5V) or VIN (5V to 12V).
  • 3.3V Output Rail: Derived from the board's regulator. Supports current draws up to 600mA (adequate for Wi-Fi and SD card modules).

[!WARNING] Bootstrap Pins — Do Not Pull During Startup: Several ESP32 GPIO pins sample their voltage level during the boot sequence to configure the chip's startup mode. Pulling these pins to the wrong level prevents the board from starting or causes persistent flashing failures:

  • GPIO 0 (D0 / BOOT button): Must be HIGH (or floating) to run application code. Pull it LOW only when you want to enter download (flashing) mode.
  • GPIO 2 (D2 / Onboard LED): Must be LOW during download mode. Do not connect a pull-up resistor to this pin.
  • GPIO 12 (D12): Must be LOW at boot. Pulling GPIO 12 HIGH causes the ESP32 to boot at 1.8V flash voltage and fail to read 3.3V flash chips.
  • GPIO 15 (D15): Must be HIGH at boot (has internal pull-up). Pulling it LOW suppresses boot log output on UART0.

4. Compiler Settings & IDE Properties

When targeting this board, the compiler utilizes the following parameters:

  • FQBN: esp32:esp32:esp32
  • Default Flashing Baud Rate: 921600 (adjustable to 115200 in upload speed dropdown for poor quality cables).
  • Flash Mode / File Type: esp (uploaded as multiple binary segments: bootloader, partitions table, and application app).
  • Flash Memory Offsets: { bootloader: 0x1000, partitions: 0x8000, app: 0x10000 }
  • Programming Runtimes: Supports both C++ (Arduino) and MicroPython. Selecting MicroPython instructs the file manager to write file nodes into the ESP32's local FAT filesystem over Web Serial REPL.

5. Supported Blockly Board Blocks

Drawing the blocks…

6. Simulator and Flashing Diagnostics

  • Simulator: Runs in a web-worker container. Simulates basic digital state transitions, variables, and delays. Advanced features (Wi-Fi, Bluetooth, Touch sensors, DAC outputs) bypass simulation and require a physical board.
  • Flashing Guide: Connect the board over USB. Click Connect Serial. Select the COM port corresponding to your CP2102/CH340 USB adapter. Click Flash. The IDE uses the Web Serial API and esptool-js library to upload segments; the board enters bootloader mode automatically via an internal DTR/RTS reset sequence — no manual button press is needed for a standard flash. If the connection times out, unplug and reconnect the USB cable, then try Flash again. Persistent failures are usually a bootstrap-pin conflict — double-check nothing external is pulling GPIO0/2/12/15 to the wrong level at boot (Section 3 above).

7. Communication Buses & Electrical Capabilities

Beyond the per-pin table above, here's the board's bus-level capability summary (from its own capabilities config):

BusDetails
UART2 hardware buses — UART0 (TX0=GPIO1, RX0=GPIO3, shared with the USB programming port) and UART2 (TX2=GPIO17, RX2=GPIO16, free for a second serial device).
I2CDefault on D21 (SDA) / D22 (SCL) — ESP32's I2C peripheral can be remapped to other pins in principle, but these are OMS's defaults.
SPIDefault (VSPI) on MOSI D23, MISO D19, SCK D18, CS D5.
1-WireNo dedicated 1-Wire hardware peripheral. Sensors like the DHT11 bit-bang the timing on any regular digital pin instead.
Analog (ADC)15 ADC-capable pins total (4 input-only: VP/VN/D34/D35, plus 11 dual-purpose digital+analog pins), 12-bit resolution.
DAC2 true hardware DAC channels — D25 and D26, 8-bit resolution.
PWM16 channels, 16-bit resolution, up to a modeled 40 MHz.
Touch9 capacitive touch-capable pins: D2, D4, D12, D13, D14, D15, D27, D32, D33.

Electrical limits: max 40 mA per pin, max 1200 mA total across all pins combined. VIN accepts 5–12V.


8. Further Reading


ESP32 DevKit V1 (Espressif) — OMS Parts