Yes
No
N/A
Heltec WiFi Kit 32
ESP32 dev board with OLED display and LoRa-ready design - ideal for visual feedback in wireless projects.
50.2 × 25.5 mm
ESP32
MCU
240MHz
clock
4MB
flash
520KB
SRAM
27· 18 ADC
GPIO
BLE 4.2+ WiFi
radio
Pinout
27 pins · 2.54 mm pitch
| Pin | GPIO | Labels | Status | Capabilities | Notes |
|---|---|---|---|---|---|
| 1 | 0 | KEY_BUILTINA11T1 | strapping | adc · touch | |
| 2 | 1 | TXPWM | uart | uart | |
| 3 | 2 | A12T2PWM | strapping | adc · touch | |
| 4 | 3 | RXPWM | uart | uart | |
| 5 | 4 | A10T0SDA_OLEDPWM | strapping | adc · touch | |
| 6 | 5 | SSPWM | strapping | spi | |
| 7 | 12 | A15T5PWM | strapping | adc · touch | |
| 8 | 13 | A14T4PWM | strapping | adc · touch | |
| 9 | 14 | A16T6PWM | strapping | adc · touch | |
| 10 | 15 | A13T3SCL_OLEDPWM | strapping | adc · touch | |
| 11 | 16 | RST_OLEDPWM | strapping | - | |
| 12 | 18 | SCKPWM | safe | spi | |
| 13 | 19 | MISOPWM | safe | spi | |
| 14 | 21 | SDAVextPWM | safe | i2c | |
| 15 | 22 | SCLPWM | safe | i2c | |
| 16 | 23 | MOSIPWM | safe | spi | |
| 17 | 25 | LED_BUILTINA18DAC1LEDPWM | safe | adc · dac | |
| 18 | 26 | A19DAC2PWM | safe | adc · dac | |
| 19 | 27 | A17T7PWM | safe | adc · touch | |
| 20 | 32 | A4T9PWM | safe | adc · touch | |
| 21 | 33 | A5T8PWM | safe | adc · touch | |
| 22 | 34 | A6 | strapping | adc | |
| 23 | 35 | A7 | strapping | adc | |
| 24 | 36 | A0 | strapping | adc | |
| 25 | 37 | A1 | strapping | adc | |
| 26 | 38 | A2 | strapping | adc | |
| 27 | 39 | A3 | strapping | adc |
Start with these
10 pins with no boot or system involvementSCKPWMMISOPWMSDAVextSCLPWMMOSIPWMLED_BUILTINA18A19DAC2A17T7A4T9A5T8
Freely assignable - no strapping, flash, USB or JTAG duties. Ideal first picks for buttons, sensors and LEDs.
Fine - with a little care
sampled at boot or shared with debug/serial| Pin | Label | What to know | Role |
|---|---|---|---|
| KEY_BUILTIN | GPIO0 | Must be HIGH during boot for normal startup; if held LOW on reset, forces flash programming mode. | Strapping |
| A12 | GPIO2 | If driven HIGH on reset (while IO0 is LOW), selects an unsupported SDIO boot mode, causing boot failure. | Strapping |
| A10 | GPIO4 | Sampled at reset for boot config; should not be driven at boot (affects boot mode timing). | Strapping |
| SS | GPIO5 | Must be HIGH during boot; if pulled LOW at reset, alters SDIO slave timing and may prevent normal boot. | Strapping |
| A15 | MTDI (GPIO12) | Keep LOW during boot (internal PD); pulling HIGH at reset selects 1.8V flash mode, causing flash brownout if 3.3V flash is used. | Strapping |
| A14 | MTCK (GPIO13) | Used for JTAG debugging (TCK); avoid using as GPIO if JTAG is needed. | Other |
| A16 | MTMS (GPIO14) | Used for JTAG debugging (TMS); driving it as GPIO may interfere with JTAG or produce spurious signals at boot. | Other |
| A13 | MTDO (GPIO15) | Keep HIGH during boot (internal PU); if LOW on reset, bootloader log is silenced and boot mode may change. | Strapping |
| A6 | GPIO34 | Cannot be used as output (no drive capability); only suitable for analog/digital input. | Other |
| A7 | GPIO35 | Cannot be used as output; only suitable for input. | Other |
| A0 | GPIO36 (SENSOR_VP) | Cannot be used as output; only suitable for input (e.g., analog read). | Other |
| A1 | GPIO37 (SENSOR_CAPP) | Cannot be used as output; only suitable for input. | Other |
| A2 | GPIO38 (SENSOR_CAPN) | Cannot be used as output; only suitable for input. | Other |
| A3 | GPIO39 (SENSOR_VN) | Cannot be used as output; only suitable for input. | Other |
Only if you know the tricks
wired to flash or USB - expect a fight| Pin | Label | What to know | Role |
|---|---|---|---|
| TX | U0TXD (GPIO1) | Connected to on-board USB-UART for uploading and logs; drives serial output at boot, so using as GPIO can disrupt programming or console. | USB |
| RX | U0RXD (GPIO3) | Used for receiving data from USB-UART (programming); also pulled HIGH at boot for console communication, so using as GPIO can disrupt uploads. | USB |
| RST_OLED | GPIO16 | Connected to internal PSRAM on PSRAM-enabled modules; not usable as GPIO on those modules. | Flash |
These are recommendations, not hard rules - with the right pull-ups, timing and boot-state awareness most pins can be made to work. When in doubt, start green.
Pinout notes The Heltec WiFi Kit 32 pinout brings out 27 GPIO pins at a 2.54 mm pitch - every one of them usable in your project. For peripherals, I²C is mapped to SDA on…
The Heltec WiFi Kit 32 pinout brings out 27 GPIO pins at a 2.54 mm pitch - every one of them usable in your project.
For peripherals, I²C is mapped to SDA on GPIO21 and SCL on GPIO22; the SPI bus (MOSI, MISO, SCK, SS) is broken out in full; TX/RX on GPIO1 and GPIO3 cover serial logging and flashing.
On the analog side there are 18 ADC-capable pins for sensors and battery monitoring, 10 capacitive-touch inputs and 2 true DAC outputs.
If you want zero surprises, SCK, MISO, SDA, SCL and 6 more are free of any such role - the safest first picks. 14 of the exposed pins carry boot-time or system duties on the ESP32 (KEY_BUILTIN, A12, A10 and 11 more).
Getting started
flash your first firmware in ~2 minutes1
Connect over USB
Uses a CP2102 bridge - install the CP210x driver if no port appears. Not detected? Hold BOOT while plugging in.
2
Match & flash
Set the Tools options shown, then click Upload.
3
Verify it runs
The onboard LED on GPIO18 blinks - swap the pin if your board's LED differs.
Set these in Tools · leave everything else at default
Arduino IDE 2.x — Tools Copy
Board: "ESP32 Dev Module"▸
Flash Size: "4MB (32Mb)"▸
Flash Mode: "DIO"▸
Partition Scheme: "Default 4MB with spiffs (1.2MB APP / 1.5MB SPIFFS)" (default)▸
Upload Speed: "921600"▸
▸ every other Tools option — leave at default
Board: ESP32 Dev Module Flash Size: 4MB (32Mb) Flash Mode: DIO Partition Scheme: Default 4MB with spiffs (1.2MB APP / 1.5MB SPIFFS) Upload Speed: 921600
Find it: Tools ▸ Board ▸ ESP32 Arduino ▸ ESP32 Dev Module
// blink the onboard LED
void setup() {
pinMode(18, OUTPUT);
}
void loop() {
digitalWrite(18, HIGH); delay(500);
digitalWrite(18, LOW); delay(500);
}board to selectesp32dev⧉ copy
[env:heltec_wifi_kit_32]
platform = espressif32
board = esp32dev
framework = arduino
monitor_speed = 115200
upload_speed = 921600Find it: PlatformIO Home ▸ Boards, search
esp32dev — or type it after board =.board to selectesp32dev⧉ copy
esp32:
board: esp32dev
variant: heltec_wifi_kit_32
framework:
type: esp-idf
# blink - GPIO18
output:
- platform: gpio
pin: 18
id: led_out
light:
- platform: binary
name: "LED"
output: led_outFind it: search ESPHome's board list for
esp32dev (same ids as PlatformIO).esptool doesn't pick board settings — a prebuilt .bin already has them baked in. This is just the raw flash command.
esptool.py --chip esp32 --port /dev/ttyACM0 \
--baud 921600 write_flash 0x0 firmware.bin--port = your /dev/tty* (macOS/Linux) or COMx (Windows).Build details: sketch space 1310720 B · data 327680 B · DIO
Specifications
ESP32 · 50.2 × 25.5 mmCompute
MCU
ESP32
Clock
240 MHz
SRAM · Flash
520 KB · 4MB
Radio
Wi-Fi
802.11 b/g/n
Bluetooth
4.2 LE
Antenna
PCB
I/O
GPIO · ADC
27 · 18
UART · I²C · SPI
3 · 2 · 4
PWM
16 channels
Power
USB
Micro-USB
Serial
CP2102
Boot address
0x1000
Display
Screen
OLED · 0.96" · 128x64
Driver
SSD1306
Touch
No
Flashing
Upload · OTA
esptool_py · esp_ota
Flash · Boot mode
DIO · DIO
Sketch · Data
1.25 MB · 320 KB
50.2 × 25.5 mm · pin pitch 2.54 mm
The Heltec WiFi Kit 32 uses esptool_py for firmware uploads, esp_ota for over-the-air (OTA) updates. Flash mode is DIO with DIO boot mode. The maximum sketch size is 1.25 MB with 320 KB available for data.
About this board
At its core is the ESP32 - a dual-core Xtensa with both Bluetooth Classic and BLE.
Onboard you'll find an OLED 0.96" 128x64 display, battery charging via SH1.25-2 and Reset/PRG buttons.
Resources
Similar boards
