Heltec WiFi LoRa 32(V2)

Improved LoRa ESP32 board with better power management - suited for off-grid and battery-powered systems.

Micro-USB
Heltec WiFi LoRa 32(V2) board
50.2 × 25.5 mm
ESP32
MCU
240MHz
clock
8MB
flash
520KB
SRAM
24· 16 ADC
GPIO
BLE 4.2+ WiFi
radio
On this page

Pinout

24 pins · 2.54 mm pitch
View:
Heltec WiFi LoRa 32(V2) pinout diagram
PinGPIOLabelsStatusCapabilitiesNotes
10KEY_BUILTINA11T1strappingadc · touch
21TXPWMuartuart
32A12T2PWMstrappingadc · touch
43RXPWMuartuart
54A10T0SDA_OLEDPWMstrappingadc · touch
65SCKPWMstrappingspi
712A15T5PWMstrappingadc · touch
813A14T4PWMstrappingadc · touch
914A16T6RST_LoRaPWMstrappingadc · touch
1015A13T3SCL_OLEDPWMstrappingadc · touch
1116RST_OLEDPWMstrapping-
1218SSPWMsafespi
1319MISOPWMsafespi
1421SDAVextPWMsafei2c
1522SCLPWMsafei2c
1625LED_BUILTINA18DAC1LEDPWMsafeadc · dac
1726A19DAC2DIO0PWMsafeadc · dac
1827MOSIA17T7PWMsafeadc · touch · spi
1932A4T9PWMsafeadc · touch
2033A5T8PWMsafeadc · touch
2134A6DIO2strappingadc
2235A7DIO1strappingadc
2336A0strappingadc
2439A3strappingadc

Start with these

9 pins with no boot or system involvement
SSPWMMISOPWMSDAVextSCLPWMLED_BUILTINA18A19DAC2MOSIA17A4T9A5T8

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
PinLabelWhat to knowRole
KEY_BUILTINGPIO0Must be HIGH during boot for normal startup; if held LOW on reset, forces flash programming mode.Strapping
A12GPIO2If driven HIGH on reset (while IO0 is LOW), selects an unsupported SDIO boot mode, causing boot failure.Strapping
A10GPIO4Sampled at reset for boot config; should not be driven at boot (affects boot mode timing).Strapping
SCKGPIO5Must be HIGH during boot; if pulled LOW at reset, alters SDIO slave timing and may prevent normal boot.Strapping
A15MTDI (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
A14MTCK (GPIO13)Used for JTAG debugging (TCK); avoid using as GPIO if JTAG is needed.Other
A16MTMS (GPIO14)Used for JTAG debugging (TMS); driving it as GPIO may interfere with JTAG or produce spurious signals at boot.Other
A13MTDO (GPIO15)Keep HIGH during boot (internal PU); if LOW on reset, bootloader log is silenced and boot mode may change.Strapping
A6GPIO34Cannot be used as output (no drive capability); only suitable for analog/digital input.Other
A7GPIO35Cannot be used as output; only suitable for input.Other
A0GPIO36 (SENSOR_VP)Cannot be used as output; only suitable for input (e.g., analog read).Other
A3GPIO39 (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
PinLabelWhat to knowRole
TXU0TXD (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
RXU0RXD (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_OLEDGPIO16Connected 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 All 24 pins on the Heltec WiFi LoRa 32(V2) are usable GPIO, spaced at the standard 2.54 mm pitch. Peripheral wiring is straightforward: I²C is mapped to SDA on…

All 24 pins on the Heltec WiFi LoRa 32(V2) are usable GPIO, spaced at the standard 2.54 mm pitch.

Peripheral wiring is straightforward: 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.

Beyond plain digital I/O you get 16 ADC-capable pins for sensors and battery monitoring, 10 capacitive-touch inputs and 2 true DAC outputs.

12 of the exposed pins carry boot-time or system duties on the ESP32 (KEY_BUILTIN, A12, A10 and 9 more) - check the guidance above before wiring anything to them. SS, MISO, SDA, SCL and 5 more are free of any such role - the safest first picks.

Getting started

flash your first firmware in ~2 minutes
Tool:
1
Connect over USB
Serial chip: CP2102. Not detected? Hold BOOT while plugging in.
2
Flash with your tool
Arduino IDE, PlatformIO, ESPHome or esptool - copy the settings on the right.
3
Verify it runs
The blink example uses GPIO18 - swap for your board's LED pin if different.
Tools → Board settings Copy
Board:            Heltec Wifi Lora 32 V2
Flash Size:       8MB · DIO
Upload Speed:     921600

// blink
pinMode(18, OUTPUT);
digitalWrite(18, LOW);   // on (often inverted)
platformio.ini Copy
[env:heltec_wifi_lora_32_V2]
platform = espressif32
board = esp32dev
framework = arduino
monitor_speed = 115200
upload_speed = 921600
device.yaml Copy
esp32:
  board: esp32dev
  variant: heltec_wifi_lora_32_V2
  framework:
    type: esp-idf

# blink - GPIO18
output:
  - platform: gpio
    pin: 18
    id: led_out
light:
  - platform: binary
    name: "LED"
    output: led_out
shell Copy
esptool.py --chip esp32 --port /dev/ttyACM0 \
  write_flash 0x0 firmware.bin
Build details: sketch space 3342336 B · data 327680 B · DIO

Specifications

ESP32 · 50.2 × 25.5 mm
Compute
MCU
ESP32
Clock
240 MHz
SRAM · Flash
520 KB · 8MB
Radio
Wi-Fi
802.11 b/g/n
Bluetooth
4.2 LE
Antenna
PCB
I/O
GPIO · ADC
24 · 16
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 · QIO
Sketch · Data
3.19 MB · 320 KB
25.5 mm50.2 mm
50.2 × 25.5 mm · pin pitch 2.54 mm
The Heltec WiFi LoRa 32(V2) uses esptool_py for firmware uploads, esp_ota for over-the-air (OTA) updates. Flash mode is DIO with QIO boot mode. The maximum sketch size is 3.19 MB with 320 KB available for data.

About this board

Inside sits the ESP32 - a dual-core Xtensa with both Bluetooth Classic and BLE.

The $17.90 price tag is typical for an ESP32 board.

Around the module: an OLED 0.96" 128x64 display, LoRa (SX1276), battery charging via JST-SH 1.25mm and Reset/PRG buttons.

  • 2.4GHz metal spring antenna for Wi-Fi/BT; IPEX (u.FL) connector with external antenna for LoRa
  • Onboard Li-Po charge/discharge management with automatic USB/battery power switching
  • LoRa variants ship as SX1276 (868/915MHz) or SX1278 (433MHz)

Where to buy

prices are typical street prices
Heltec WiFi LoRa 32(V2)
Heltec WiFi LoRa 32(V2)
$17.90per unit, typical

Resources

Similar boards