ESP32-H Series GPIO Reference
ESP32-H Series GPIO Reference
The ESP32-H Series currently consists of the ESP32-H2 processor. Unlike other members of the ESP32 family, the ESP32-H2 is designed specifically for low-power wireless applications using Thread, Zigbee, IEEE 802.15.4, and Bluetooth® Low Energy. It does not include Wi-Fi.
GPIO assignments vary between individual development boards and modules. This page summarizes the GPIO characteristics of the ESP32-H Series and provides guidance for DIY holiday lighting applications.
GPIO Summary
| Processor | Approximate GPIO | Input | Output | USB | Wireless | Notes |
|---|---|---|---|---|---|---|
| ESP32-H2 | Up to 28 | Yes | Yes | Native USB Serial/JTAG | Thread, Zigbee, Bluetooth LE | Single-core RISC-V processor. |
GPIO Categories
Recommended for Pixel Outputs
Most GPIO pins capable of digital output may be used for pixel data provided they are not reserved by the processor, development board, or firmware.
Boot (Strapping) Pins
Several GPIO pins are sampled during reset to determine processor startup mode. Refer to the processor datasheet and development board documentation before assigning these pins.
Reserved Pins
Some GPIO pins are reserved for onboard SPI flash memory or USB Serial/JTAG functionality depending on the module and development board.
USB Pins
GPIO pins assigned to the native USB Serial/JTAG interface should generally not be reassigned unless USB communication is no longer required.
Processor Notes
ESP32-H2
- Single-core RISC-V processor
- Thread support
- Zigbee support
- Bluetooth® Low Energy
- IEEE 802.15.4 radio
- Native USB Serial/JTAG
- Ultra-low-power operation
- No Wi-Fi capability
Practical Notes
Although the processor may support a particular GPIO, the development board may not expose every pin.
Some GPIO pins may already be connected to:
- USB interface
- Status LEDs
- Boot and reset buttons
- Flash memory
- Battery monitoring circuits
- Sensors
- Radio circuitry
Always consult the development board schematic before assigning GPIO pins.
Community Verified GPIO
The following information has been verified through testing by members of the DIY holiday lighting community.
| Development Board | Processor | Firmware | Version | Verified Pixel Outputs | Verified By | Notes |
|---|---|---|---|---|---|---|
| No community testing submitted yet. |
Additional community testing is encouraged.
Firmware Considerations
Firmware may impose additional GPIO restrictions beyond those defined by the processor or development board.
Support for the ESP32-H Series continues to evolve. Always verify GPIO availability for the firmware version being used.
See: