Piranha ESP-32
Affordable ESP32 board for maker and DIY use - suitable for automation, sensors, and Wi-Fi control.
Pinout
16 pins| Pin | GPIO | Labels | Status | Capabilities | Notes |
|---|---|---|---|---|---|
| 1 | 0 | KEY_BUILTINA11T1 | strapping | adc · touch | |
| 2 | 1 | TXPWM | uart | uart | |
| 3 | 2 | LED_BUILTINPWM | strapping | - | |
| 4 | 3 | RXPWM | uart | uart | |
| 5 | 5 | SSPWM | strapping | spi | |
| 6 | 12 | A15T5PWM | strapping | adc · touch | |
| 7 | 13 | A14T4PWM | strapping | adc · touch | |
| 8 | 14 | A16T6PWM | strapping | adc · touch | |
| 9 | 15 | A13T3PWM | strapping | adc · touch | |
| 10 | 18 | SCKPWM | safe | spi | |
| 11 | 19 | MISOPWM | safe | spi | |
| 12 | 21 | SDAPWM | safe | i2c | |
| 13 | 22 | SCLPWM | safe | i2c | |
| 14 | 23 | MOSIPWM | safe | spi | |
| 15 | 25 | A18DAC1PWM | safe | adc · dac | |
| 16 | 26 | A19DAC2PWM | safe | adc · dac |
Start with these
7 pins with no boot or system involvementFreely 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 |
| LED_BUILTIN | GPIO2 | If driven HIGH on reset (while IO0 is LOW), selects an unsupported SDIO boot mode, causing boot failure. | 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 |
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 |
Pinout notes The Piranha ESP-32 pinout brings out 16 GPIO pins - every one of them usable in your project. For peripherals, I²C is mapped to SDA on GPIO21 and SCL on…
The Piranha ESP-32 pinout brings out 16 GPIO pins - 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 7 ADC-capable pins for sensors and battery monitoring, 5 capacitive-touch inputs and 2 true DAC outputs.
If you want zero surprises, SCK, MISO, SDA, SCL and 3 more are free of any such role - the safest first picks. 7 of the exposed pins carry boot-time or system duties on the ESP32 (KEY_BUILTIN, LED_BUILTIN, SS and 4 more).
Getting started
flash your first firmware in ~2 minutesBoard: Piranha
Flash Size: 4MB · DIO
Upload Speed: 921600
// blink
pinMode(18, OUTPUT);
digitalWrite(18, LOW); // on (often inverted)[env:piranha_esp-32]
platform = espressif32
board = esp32dev
framework = arduino
monitor_speed = 115200
upload_speed = 921600esp32:
board: esp32dev
variant: piranha_esp-32
framework:
type: esp-idf
# blink - GPIO18
output:
- platform: gpio
pin: 18
id: led_out
light:
- platform: binary
name: "LED"
output: led_outesptool.py --chip esp32 --port /dev/ttyACM0 \
write_flash 0x0 firmware.binSpecifications
ESP32About this board
At its core is the ESP32 - a dual-core Xtensa with both Bluetooth Classic and BLE.
Only 16 GPIO are broken out, where most ESP32 boards manage about 24 - worth checking the pinout covers what you need.
Onboard you'll find Reset/Boot buttons.
Resources
Similar boards
