WiFiduino32

ESP32 board with Arduino-style form - ideal for easy transition to wireless IoT using familiar layout.

Micro-USB
WiFiduino32 board
68.6 × 53.4 mm
ESP32
MCU
240MHz
clock
4MB
flash
520KB
SRAM
23· 6 ADC
GPIO
BLE 4.2+ WiFi
radio
On this page

Pinout

23 pins · 2.54 mm pitch
View:
PinGPIOLabelsStatusCapabilitiesNotes
10KEY_BUILTINT1strappingtouch
21TXD1PWMuartuart
32LED_BUILTIND13T2PWMstrappingtouch
43RXD0PWMuartuart
54A5T0PWMstrappingadc · touch
65SDASSPWMstrappingspi · i2c
712A2T5PWMstrappingadc · touch
813A4T4PWMstrappingadc · touch
914A1T6PWMstrappingadc · touch
1015D3T3PWMstrappingtouch
1116SCLPWMstrappingi2c
1217D2PWMstrapping-
1318SCKD12PWMsafespi
1419MISOD11PWMsafespi
1521D10PWMsafe-
1622D9PWMsafe-
1723MOSID8PWMsafespi
1825D6DAC1PWMsafedac
1926D7DAC2PWMsafedac
2027A0T7PWMsafeadc · touch
2132D4T9PWMsafetouch
2233D5T8PWMsafetouch
2335A3strappingadc

Start with these

10 pins with no boot or system involvement
SCKD12MISOD11D10PWMD9PWMMOSID8D6DAC1D7DAC2A0T7D4T9D5T8

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 HIGH during boot for normal startup; if held LOW on reset, forces flash programming mode.Strapping
LED_BUILTINGPIO2If driven HIGH on reset (while IO0 is LOW), selects an unsupported SDIO boot mode, causing boot failure.Strapping
A5GPIO4Sampled at reset for boot config; should not be driven at boot (affects boot mode timing).Strapping
SDAGPIO5Must be HIGH during boot; if pulled LOW at reset, alters SDIO slave timing and may prevent normal boot.Strapping
A2MTDI (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
A4MTCK (GPIO13)Used for JTAG debugging (TCK); avoid using as GPIO if JTAG is needed.Other
A1MTMS (GPIO14)Used for JTAG debugging (TMS); driving it as GPIO may interfere with JTAG or produce spurious signals at boot.Other
D3MTDO (GPIO15)Keep HIGH during boot (internal PU); if LOW on reset, bootloader log is silenced and boot mode may change.Strapping
A3GPIO35Cannot be used as output; only suitable for input.Other

Only if you know the tricks

wired to flash or USB - expect a fight
PinLabelWhat to knowRole
TXU0TXD (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
RXU0RXD (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
SCLGPIO16Connected to internal PSRAM on PSRAM-enabled modules; not usable as GPIO on those modules.Flash
D2GPIO17Connected to internal PSRAM on PSRAM-enabled modules; not usable as GPIO on those modules.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 All 23 pins on the WiFiduino32 are usable GPIO, spaced at the standard 2.54 mm pitch. Peripheral wiring is straightforward: I²C is mapped to SDA on GPIO5 and…

All 23 pins on the WiFiduino32 are usable GPIO, spaced at the standard 2.54 mm pitch.

Peripheral wiring is straightforward: I²C is mapped to SDA on GPIO5 and SCL on GPIO16; the SPI bus (MOSI, MISO, SCK, SS) is broken out in full; TX/RX on GPIO1 and GPIO3 cover serial logging and flashing.

Beyond plain digital I/O you get 6 ADC-capable pins for sensors and battery monitoring, 10 capacitive-touch inputs and 2 true DAC outputs.

9 of the exposed pins carry boot-time or system duties on the ESP32 (KEY_BUILTIN, LED_BUILTIN, A5 and 6 more) - check the guidance above before wiring anything to them. SCK, MISO, D10, D9 and 6 more are free of any such role - the safest first picks.

Getting started

flash your first firmware in ~2 minutes
Tool:
1
Connect over USB
Install your USB-serial driver (CH340 / CP210x) 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
The onboard LED on GPIO18 blinks - swap the pin if your board's LED differs.
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
// blink the onboard LED
void setup() {
  pinMode(18, OUTPUT);
}
void loop() {
  digitalWrite(18, HIGH); delay(500);
  digitalWrite(18, LOW);  delay(500);
}
board to selectesp32dev⧉ copy
platformio.ini Copy
[env:wifiduino32]
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: wifiduino32
  framework:
    type: esp-idf

# blink - GPIO18
output:
  - platform: gpio
    pin: 18
    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 0x0 firmware.bin
--port = your /dev/tty* (macOS/Linux) or COMx (Windows).
Build details: sketch space 1310720 B · data 327680 B · DIO

Specifications

ESP32 · 68.6 × 53.4 mm
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
23 · 6
UART · I²C · SPI
3 · 2 · 4
PWM
16 channels
Power
USB
Micro-USB
Serial
-
Boot address
0x1000
Flashing
Upload · OTA
esptool_py · esp_ota
Flash · Boot mode
DIO · DIO
Sketch · Data
1.25 MB · 320 KB
53.4 mm68.6 mm
68.6 × 53.4 mm · pin pitch 2.54 mm
The WiFiduino32 uses esptool_py for firmware uploads, esp_ota for over-the-air (OTA) updates. Flash mode is DIO with DIO boot mode. The maximum sketch size is 1.25 MB with 320 KB available for data.

About this board

Inside sits the ESP32 - a dual-core Xtensa with both Bluetooth Classic and BLE.

Around the module: status LEDs (Power, RUN (GPIO2)) and Reset buttons.

Resources

Similar boards