Heltec WiFi Kit 32(V3)

An ESP32-S3 board with an integrated 0.96" OLED display, designed for compact, battery-powered IoT and wireless projects.

USB-C
Heltec WiFi Kit 32(V3) board
50.2 × 25.5 mm
ESP32-S3
MCU
240MHz
clock
8MB
flash
512KB
SRAM
27· 20 ADC
GPIO
BLE 5.0+ WiFi
radio
On this page

Pinout

27 pins · 2.54 mm pitch
View:
Heltec WiFi Kit 32(V3) pinout diagram
PinGPIOLabelsStatusCapabilitiesNotes
10KEY_BUILTINstrapping-
21A0T1PWMsafeadc · touch
32A1T2PWMsafeadc · touch
43A2T3PWMstrappingadc · touch
54A3T4PWMsafeadc · touch
65A4T5PWMsafeadc · touch
76A5T6PWMsafeadc · touch
87A6T7PWMsafeadc · touch
98SSA7T8PWMsafeadc · touch · spi
109SCKA8T9PWMstrappingadc · touch · spi
1110MOSIA9T10PWMstrappingadc · touch · spi
1211MISOA10T11PWMstrappingadc · touch · spi
1312A11T12PWMstrappingadc · touch
1413A12T13PWMstrappingadc · touch
1514A13T14PWMstrappingadc · touch
1615A14PWMsafeadc
1716A15PWMsafeadc
1817A16SDA_OLEDPWMsafeadc
1918A17SCL_OLEDPWMsafeadc
2019A18PWMuartadc
2120A19PWMuartadc
2221SDARST_OLEDPWMsafei2c
2322SCLPWMsafei2c
2435LED_BUILTINLEDstrapping-
2536Vextstrapping-
2643TXstrappinguart
2744RXstrappinguart

Start with these

13 pins with no boot or system involvement
A0T1A1T2A3T4A4T5A5T6A6T7SSA7A14PWMA15PWMA16SDA_OLEDA17SCL_OLEDSDARST_OLEDSCLPWM

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 pulled high (default) or low (to enter UART download mode) at reset. Using it for other functions can interfere with boot mode configuration.Strapping
A2GPIO3Sampled at reset to select JTAG interface (USB Serial/JTAG controller vs. external pins). Improper use can disable external JTAG or alter debug interface.Strapping
TXU0TXD (GPIO43)Used for bootloader output and UART console logs. If repurposed, you will lose the default serial output (and programming via UART0).Other
RXU0RXD (GPIO44)Used for bootloader input (download mode via serial). If repurposed, you cannot use the default UART0 download mode for programming the chip.Other

Only if you know the tricks

wired to flash or USB - expect a fight
PinLabelWhat to knowRole
SCKFSPIHDConnected to external flash (data/hold signal) on most modules. Not recommended for use as GPIO, since it must remain dedicated to flash communication.Flash
MOSIFSPICS0Used to select the external flash chip. It is required for flash access and cannot be repurposed without losing flash connectivityFlash
MISOFSPIDUsed as a data line for flash (and in-package PSRAM). It should not be used as GPIO when the flash/PSRAM is in use.Flash
A11FSPICLKDrives the flash (and PSRAM) clock. This critical signal must be reserved for memory and not used as general GPIO.Flash
A12FSPIQUsed as a data line for flash/PSRAM transfers. Not available for other uses when flash/PSRAM is connected.Flash
A13FSPIWPConnected to external flash (data/write-protect signal). Not recommended as GPIO because it’s reserved for flash operations.Flash
A18USB_D-By default connected to the on-chip USB Serial/JTAG controller. Using it as general GPIO without reconfiguring IO MUX will interfere with USB functionality.USB
A19USB_D+By default connected to the on-chip USB Serial/JTAG controller. Using it as general GPIO without reconfiguring IO MUX will interfere with USB functionality.USB
LED_BUILTINFSPID / PSRAM_D0In modules with octal PSRAM, this pin is connected to the PSRAM data line. It is reserved for memory interface and not free for general GPIO when flash/PSRAM is present.Flash
VextFSPICLK / PSRAM_CLKIn modules with octal PSRAM, this pin drives the PSRAM clock. It must be dedicated to the memory interface, not used as a regular GPIO when that interface is in use.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(V3) 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…

The Heltec WiFi Kit 32(V3) 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 GPIO43 and GPIO44 cover serial logging and flashing.

On the analog side there are 20 ADC-capable pins for sensors and battery monitoring and 14 capacitive-touch inputs.

If you want zero surprises, A0, A1, A3, A4 and 9 more are free of any such role - the safest first picks. 4 of the exposed pins carry boot-time or system duties on the ESP32-S3 (KEY_BUILTIN, A2, TX and 1 more).

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 GPIO1 - swap for your board's LED pin if different.
Tools → Board settings Copy
Board:            Heltec Wifi Kit 32 V3
Flash Size:       8MB · DIO
Upload Speed:     921600

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

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

Specifications

ESP32-S3 · 50.2 × 25.5 mm
Compute
MCU
ESP32-S3
Clock
240 MHz
SRAM · Flash
512 KB · 8MB
Radio
Wi-Fi
802.11 b/g/n
Bluetooth
5.0 LE
Antenna
PCB
I/O
GPIO · ADC
27 · 20
UART · I²C · SPI
3 · 2 · 4
PWM
8 channels
Power
USB
USB-C
Serial
CP2102
Boot address
0x0
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 Kit 32(V3) 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

At its core is the ESP32-S3 - a dual-core Xtensa with vector extensions suited to AI workloads.

Expect to pay about $12.99 - less than the ~$30 most ESP32-S3 boards go for.

27 GPIO are broken out - more than most ESP32-S3 boards, so the pin budget is rarely the constraint.

Onboard you'll find an OLED 0.96" 128x64 display, battery charging via JST-SH 1.25mm and Reset/PRG buttons.

  • Vext pin (GPIO36) switches the 3.3V rail to the OLED & external sensors (350mA max)
  • Onboard Li-Po charger with battery-voltage sensing via ADC on GPIO1 (VBAT)

Where to buy

prices are typical street prices
Heltec WiFi Kit 32(V3)
Heltec WiFi Kit 32(V3)
$12.99per unit, typical

Resources

Similar boards