Piranha ESP-32
Affordable ESP32 board for maker and DIY use - suitable for automation, sensors, and Wi-Fi control.
Piranha ESP-32 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
9 pins · 9 things to knowKEY_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.
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.
LED_BUILTINGPIO2 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.
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.
SSGPIO5 Bootstrapping pin; internal pull-up; VSPI CS0 (default SPI chip-select); acts as FSPIWP (flash write-protect) on internal-flash variants. Strapping
Must be HIGH during boot; if pulled LOW at reset, alters SDIO slave timing and may prevent normal boot.
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.
A16GPIO14 JTAG mode select pin (TMS); also HSPI CLK and PWM-capable GPIO. JTAG
Used for JTAG debugging (TMS); driving it as GPIO may interfere with JTAG or produce spurious signals at boot.
A13GPIO15 Bootstrapping pin; JTAG TDO; controls UART0 boot log output; also HSPICS0 (secondary SPI CS). Strapping
Keep HIGH during boot (internal PU); if LOW on reset, bootloader log is silenced and boot mode may change.
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. 9 of the exposed pins carry boot-time or system duties on the ESP32 (KEY_BUILTIN, TX, LED_BUILTIN and 6 more).
Getting started
flash your first firmware in ~2 minutesBoard: 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
// toggle GPIO18 - wire an LED and resistor to it
void setup() {
pinMode(18, OUTPUT);
}
void loop() {
digitalWrite(18, HIGH); delay(500);
digitalWrite(18, LOW); delay(500);
}[env:piranha_esp-32]
platform = espressif32
board = esp32dev
framework = arduino
monitor_speed = 115200
upload_speed = 921600esp32dev - or type it after board =.esp32:
board: esp32dev
variant: esp32
framework:
type: esp-idf
# blink - GPIO18
output:
- platform: gpio
pin: 18
id: led_out
light:
- platform: binary
name: "LED"
output: led_outesp32dev (same ids as PlatformIO).esptool.py --chip esp32 --port /dev/ttyACM0 \
--baud 921600 write_flash 0x1000 firmware.bin--port = your /dev/tty* (macOS/Linux) or COMx (Windows).Specifications
ESP32 · vs other ESP32 chips →About 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
