Heltec WiFi LoRa 32 (V1)

The original WiFi LoRa 32 (V1) - ESP32 + SX1276/78 LoRa with a 0.96" OLED and micro-USB, superseded by the V2 and the S3-based V3.

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

Heltec WiFi LoRa 32 (V1) Pinout

36 pins · 2.54 mm pitch
Heltec WiFi LoRa 32 (V1) pinout diagram, high resolution: all 36 pins, with GPIO numbers, ADC channels and strapping pins
Heltec WiFi LoRa 32 (V1) pinout, drawn by ESPboards from the ESP32 Series Datasheet v5.3.
PinGPIOLabelsStatusCapabilitiesNotes
1-GNDground-
2-5Vpower-
3-3V3power-
4-GNDground-
53RXPWMuartuart
61TXPWMuartuart
7-RSTENcontrol-
80KEY_BUILTINA11T1strappingadc · touch
922SCLPWMsafei2c
1019MISOPWMLoRa_MISOsafespi
1123GPIO23safepwmOn the header (V1 pinout PDF)
1218SSPWMLoRa_CSsafespi
135SCKPWMLoRa_SCKstrappingspi
1415A13T3PWMOLED_SCLstrappingadc · touch
152A12T2PWMstrappingadc · touch
164A10T0PWMOLED_SDAsafeadc · touch
1717GPIO17uartuart · pwmOn the header (V1 pinout PDF)
1816PWMOLED_RSTsafe-
19-GNDground-
20-5Vpower-
21-3V3power-
2236A0strappingadc
2337GPIO37A1strappingadcOn the header (V1 pinout PDF); input-only
2438GPIO38A2strappingadcOn the header (V1 pinout PDF); input-only
2539A3strappingadc
2634A6strappingadc
2735A7strappingadc
2832A4T9PWMLoRa_DIO2safeadc · touch
2933A5T8PWMLoRa_DIO1safeadc · touch
3025LED_BUILTINA18DAC1LEDPWMsafeadc · dac
3126A19DAC2PWMLoRa_DIO0safeadc · dac
3227MOSIA17T7PWMLoRa_MOSIsafeadc · touch · spi
3314A16T6PWMLoRa_RSTstrappingadc · touch
3412A15T5PWMstrappingadc · touch
3513A14T4PWMstrappingadc · touch
3621SDAPWMsafei2c
Download the Heltec WiFi LoRa 32 (V1) pinout Free to use and share for non-commercial work, as long as you credit espboards.dev. License.
28 GPIOs broken out 5 free · 15 need care · 8 to avoid

Start with these

5 pins with no boot or system involvement
SCLGPIO22GPIO23GPIO17LED_BUILTINGPIO25SDAGPIO21

Freely assignable - no strapping, flash, USB or JTAG duties. Ideal first picks for buttons, sensors and LEDs.

Fine - with a little care

15 pins · 10 things to know
RXGPIO3 Default UART0 RX pin for USB-serial programming (console input). UART

Used for receiving data from USB-UART (programming); also pulled HIGH at boot for console communication, so using as GPIO can disrupt uploads.

TXGPIO1 Default UART0 TX pin for USB-serial programming and console. UART

Connected to on-board USB-UART for uploading and logs; drives serial output at boot, so using as GPIO can disrupt programming or console.

KEY_BUILTINGPIO0 Bootstrapping pin (enter bootloader when low); internal pull-up. Strapping

Must be HIGH during boot for normal startup; if held LOW on reset, forces flash programming mode.

A13GPIO15A10GPIO4PWMGPIO16 Used by the OLED onboard hardware

Wired to the OLED on this board. The pin is yours if you give that up, but nothing else can share it.

  • A13
  • A10
  • PWM
A12GPIO2 Bootstrapping pin (must be low or floating at reset); internal pull-down. Strapping

If driven HIGH on reset (while IO0 is LOW), selects an unsupported SDIO boot mode, causing boot failure.

A0GPIO36 Input-only GPIO (no output); ADC1 channel 0, Hall sensor VP. Other

Cannot be used as output; only suitable for input (e.g., analog read).

GPIO37GPIO38A3GPIO39A7GPIO35 Input-only GPIOs with ADC1 channels - no output driver Other

Cannot be used as output; only suitable for input.

  • GPIO37Input-only GPIO (no output); ADC1 channel 1.
  • GPIO38Input-only GPIO (no output); ADC1 channel 2.
  • A3Input-only GPIO (no output); ADC1 channel 3, Hall sensor VN.
  • A7Input-only GPIO (no output driver); ADC1 channel 7.
A6GPIO34 Input-only GPIO (no output driver); ADC1 channel 6. Other

Cannot be used as output (no drive capability); only suitable for analog/digital input.

A15GPIO12 Bootstrapping pin; JTAG TDI; sets flash voltage (VDD_SDIO); also HSPIQ (flash data line). Strapping

Keep LOW during boot (internal PD); pulling HIGH at reset selects 1.8V flash mode, causing flash brownout if 3.3V flash is used.

A14GPIO13 JTAG clock pin (TCK); also ADC2 channel 4 / Touch4 input. JTAG

Used for JTAG debugging (TCK); avoid using as GPIO if JTAG is needed.

Only if you know the tricks

8 pins · 1 thing to know
MISOGPIO19SSGPIO18SCKGPIO5A4GPIO32A5GPIO33A19GPIO26MOSIGPIO27A16GPIO14 Used by the SX1276 LoRa radio onboard hardware

Wired to the SX1276 LoRa radio on this board, which is soldered down. Driving it from your own code breaks that function.

  • MISO
  • SS
  • SCK
  • A4
  • A5
  • A19
  • MOSI
  • A16
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.

The Heltec WiFi LoRa 32 (V1) pinout brings out 36 pins at a 2.54 mm pitch - 28 usable GPIO alongside the GND, 5V and 3V3 power rails.

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, PWM on 2 pins, 10 capacitive-touch inputs and 2 true DAC outputs.

If you want zero surprises, SCL, GPIO23, GPIO17, LED_BUILTIN and 1 more are free of any such role - the safest first picks. 15 of the exposed pins carry boot-time or system duties on the ESP32 (RX, TX, KEY_BUILTIN and 12 more).

Getting started

flash your first firmware in ~2 minutes
Tool:
1
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
GPIO22 toggles - wire an LED and resistor to it, or change the pin to your board's own LED.
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.ino Copy
// toggle GPIO22 - wire an LED and resistor to it
void setup() {
  pinMode(22, OUTPUT);
}
void loop() {
  digitalWrite(22, HIGH); delay(500);
  digitalWrite(22, LOW);  delay(500);
}
board to selectesp32dev⧉ copy
platformio.ini Copy
[env:heltec_wifi_lora_32]
platform = espressif32
board = esp32dev
framework = arduino
monitor_speed = 115200
upload_speed = 921600
Find it: PlatformIO Home ▸ Boards, search esp32dev - or type it after board =.
board to selectesp32dev⧉ copy
device.yaml Copy
esp32:
  board: esp32dev
  variant: esp32
  framework:
    type: esp-idf

# blink - GPIO22
output:
  - platform: gpio
    pin: 22
    id: led_out
light:
  - platform: binary
    name: "LED"
    output: led_out
Find 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.
terminal Copy
esptool.py --chip esp32 --port /dev/ttyACM0 \
  --baud 921600 write_flash 0x1000 firmware.bin
--port = your /dev/tty* (macOS/Linux) or COMx (Windows).
Build details: sketch space 1310720 B · data 327680 B · DIO

Downloads

Free for non-commercial use, credit espboards.dev · License
Heltec WiFi LoRa 32 (V1) board illustration, front

Board illustration

The bare Heltec WiFi LoRa 32 (V1) board drawn to scale at 50.2 × 25.5 mm, with no pin labels on it. Made for slide decks, wiring diagrams and project write-ups where a photo is too busy. Take the scalable SVG for print or editing, the high-resolution PNG to drop straight in, or the transparent PNG when you need it with no background behind it.

Heltec WiFi LoRa 32 (V1) pinout diagram

Pinout diagram

Every pin on both sides of the board with its functions, drawn by ESPboards from the ESP32 Series Datasheet v5.3 - the same sheet shown at the top of this page. The PNG is a high-resolution image for screens, the SVG is vector so it stays sharp at any size, and the PDF is laid out to print on A4 or Letter.

Free for non-commercial use, with the credit line kept.

Embed the Heltec WiFi LoRa 32 (V1) pinout

Paste this where you want the diagram. Keep the credit line - it is what the licence asks for, and it is the only thing we want in return.

<figure>
  <img src="https://cdn.espboards.net/boards/heltec-wifi-lora-32/diagram-1600.png"
       alt="Heltec WiFi LoRa 32 (V1) pinout diagram" width="1600" loading="lazy">
  <figcaption>
    Heltec WiFi LoRa 32 (V1) pinout by
    <a href="https://www.espboards.dev/esp32/heltec_wifi_lora_32/">ESPboards</a>,
    <a href="https://creativecommons.org/licenses/by-nc/4.0/">CC BY-NC 4.0</a>
  </figcaption>
</figure>

Using it commercially? Ask us first - it takes one email.

Yours to use, share and adapt for non-commercial work, as long as you credit espboards.dev - the full terms and ready-made credit lines are here.

Specifications

ESP32 · 50.2 × 25.5 mm · vs other ESP32 chips →
Compute
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
28 · 18
UART · I²C · SPI
3 · 2 · 2
PWM
16 channels
Power
USB
Micro-USB
Serial
CP2102
Boot address
0x1000
Electrical
Input
5V USB · 3.7V LiPo
Consumption
-
Regulator
-
Display
Screen
OLED · 0.96" · 128x64
Driver
SSD1306
Touch
No
Flashing
Upload · OTA
esptool_py · esp_ota
Flash · Boot mode
DIO · QIO
Sketch · Data
1.25 MB · 320 KB

Dimensions

Heltec WiFi LoRa 32 (V1) board, drawn to scale
25.5 mm50.2 mm
50.2 × 25.5 mm · pin pitch 2.54 mm
The Heltec WiFi LoRa 32 (V1) 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 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, LoRa (SX1276), battery charging via SH1.25-2 and Reset/PRG buttons.

  • 50.2 x 25.5 mm on Heltec's V2 dimension drawing (the same outline as the V3, so V3 cases fit); the spec table in the same datasheet says 51 x 25.5
  • Wi-Fi/BLE via a printed PCB antenna (the V2 swapped it for a metal spring)
  • V1 specifics: 4 MB flash, 26 MHz crystal, LoRa DIO1 / DIO2 on GPIO33 / GPIO32 (the V2 moved them to 35 / 34), no Vext switch
  • Revisions: V1 (2017), V2 (2018, 8 MB flash, 40 MHz crystal, Vext), V2.1 (2019), V3 (2022, ESP32-S3 + SX1262). Heltec lists the V2 as phasing out in favour of the V3.
  • LoRa uses an external antenna through an IPEX/u.FL connector
  • Onboard LiPo charging with automatic USB/battery power switching

Resources

Similar boards