No
No
N/A
Adafruit Metro ESP32-S2
Full-size ESP32-S2 dev board with USB-C and STEMMA QT - great for breadboarding and secure applications.
72 × 53.2 mm
ESP32-S2
MCU
240MHz
clock
4MB
flash
320KB
SRAM
28· 20 ADC
GPIO
Wi-Fi
radio
Pinout
28 pins · 2.54 mm pitch
| Pin | GPIO | Labels | Status | Capabilities | Notes |
|---|---|---|---|---|---|
| 1 | 0 | PIN_BUTTON1 | strapping | - | |
| 2 | 1 | A2T1PWM | safe | adc · touch | |
| 3 | 2 | A3T2PWM | safe | adc · touch | |
| 4 | 3 | A4T3PWM | safe | adc · touch | |
| 5 | 4 | A5T4PWM | safe | adc · touch | |
| 6 | 5 | TXA6T5PWM | uart | adc · touch · uart | |
| 7 | 6 | RXA7T6PWM | uart | adc · touch · uart | |
| 8 | 7 | A8T7PWM | safe | adc · touch | |
| 9 | 8 | A9T8PWM | safe | adc · touch | |
| 10 | 9 | A10T9PWM | strapping | adc · touch | |
| 11 | 10 | A11T10PWM | strapping | adc · touch | |
| 12 | 11 | A12T11PWM | strapping | adc · touch | |
| 13 | 12 | A13T12PWM | strapping | adc · touch | |
| 14 | 13 | A14T13PWM | strapping | adc · touch | |
| 15 | 14 | A15T14PWM | strapping | adc · touch | |
| 16 | 15 | A16PWM | strapping | adc | |
| 17 | 16 | A17PWM | strapping | adc | |
| 18 | 17 | A0DAC1PWM | safe | adc · dac | |
| 19 | 18 | A1DAC2PWM | safe | adc · dac | |
| 20 | 19 | A18PWM | uart | adc | |
| 21 | 20 | A19PWM | uart | adc | |
| 22 | 33 | SDAPWM | strapping | i2c | |
| 23 | 34 | SCLPWM | strapping | i2c | |
| 24 | 35 | MOSIPWM | strapping | spi | |
| 25 | 36 | SCKPWM | strapping | spi | |
| 26 | 37 | MISOPWM | strapping | spi | |
| 27 | 42 | LED_BUILTINSSPWM | strapping | spi | |
| 28 | 45 | PIN_NEOPIXELPWM | strapping | - |
Start with these
10 pins with no boot or system involvementA2T1A3T2A4T3A5T4TXA6RXA7A8T7A9T8A0DAC1A1DAC2
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| Pin | Label | What to know | Role |
|---|---|---|---|
| PIN_BUTTON1 | GPIO0 | Must be pulled high for normal boot; pulling low at reset enters bootloader (download mode). Also serves as SPI flash data-in (SPID) line when using external flash memory. | Strapping |
| A16 | XTAL_32K_P | If an external 32 kHz crystal is used for RTC, this pin is dedicated to the crystal and cannot be used as GPIO. | Other |
| A17 | XTAL_32K_N | If using an external 32 kHz crystal, this pin is connected to the crystal and should not be used as general I/O. | Other |
| LED_BUILTIN | MTMS | JTAG TMS pin; should not be repurposed if JTAG debugging or programming via JTAG is required. | Other |
| PIN_NEOPIXEL | GPIO45 | Must be set correctly at boot (usually low for 3.3 V); improper level can cause boot failure or flash malfunction. | Strapping |
Only if you know the tricks
wired to flash or USB - expect a fight| Pin | Label | What to know | Role |
|---|---|---|---|
| A10 | FSPIHD | Typically used as flash/PSRAM IO line in certain configurations; avoid using as GPIO if flash or PSRAM is present. | Flash |
| A11 | FSPICS0 | Often used as flash chip select in some designs; not available for GPIO when controlling flash. | Flash |
| A12 | FSPID | Used for flash data transfer in certain configurations; should be avoided for general use if flash is connected. | Flash |
| A13 | FSPICLK | Used as flash clock line in some boards; not free for GPIO if driving flash. | Flash |
| A14 | FSPIQ | Used for flash data output in certain configurations; avoid using as GPIO if connected to flash. | Flash |
| A15 | FSPIWP | Used as flash write-protect/data line on some modules; not recommended for other usage. | Flash |
| A18 | USB_D- | Used for USB communication; using this pin as general GPIO can interfere with USB functionality. | USB |
| A19 | USB_D+ | Dedicated to USB interface; repurposing as GPIO may disrupt USB connectivity. | USB |
| SDA | SPIHD | Connected to SPI flash (hold/data line); not available for general-purpose use. | Flash |
| SCL | SPIWP | Connected to SPI flash (write-protect/data line); not recommended for other use. | Flash |
| MOSI | FSPID | Used by internal flash/PSRAM on some ESP32-S2 variants; avoid using as GPIO to prevent conflicts. | Flash |
| SCK | FSPICLK | May be connected to internal flash or used for high-speed SPI; not intended for general GPIO use. | Flash |
| MISO | FSPIQ | Used for internal flash/PSRAM data in some models; should not be repurposed for GPIO. | 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 28 pins on the Adafruit Metro ESP32-S2 are usable GPIO, spaced at the standard 2.54 mm pitch. Peripheral wiring is straightforward: I²C is mapped to SDA on…
All 28 pins on the Adafruit Metro ESP32-S2 are usable GPIO, spaced at the standard 2.54 mm pitch.
Peripheral wiring is straightforward: I²C is mapped to SDA on GPIO33 and SCL on GPIO34; the SPI bus (MOSI, MISO, SCK, SS) is broken out in full; TX/RX on GPIO5 and GPIO6 cover serial logging and flashing.
Beyond plain digital I/O you get 20 ADC-capable pins for sensors and battery monitoring, 14 capacitive-touch inputs and 2 true DAC outputs.
5 of the exposed pins carry boot-time or system duties on the ESP32-S2 (PIN_BUTTON1, A16, A17 and 2 more) - check the guidance above before wiring anything to them. A2, A3, A4, A5 and 6 more are free of any such role - the safest first picks.
Getting started
flash your first firmware in ~2 minutes1
Connect over USB
Native USB - shows up as a port right away, no driver needed. 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 GPIO1 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: "ESP32S2 Dev Module"▸
USB CDC On Boot: "Enabled"▸
Flash Size: "4MB (32Mb)"▸
Flash Mode: "DIO"▸
PSRAM: "QSPI PSRAM"▸
Partition Scheme: "Default 4MB with spiffs (1.2MB APP / 1.5MB SPIFFS)" (default)▸
Upload Speed: "921600"▸
▸ every other Tools option — leave at default
Board: ESP32S2 Dev Module USB CDC On Boot: Enabled Flash Size: 4MB (32Mb) Flash Mode: DIO PSRAM: QSPI PSRAM Partition Scheme: Default 4MB with spiffs (1.2MB APP / 1.5MB SPIFFS) Upload Speed: 921600
Find it: Tools ▸ Board ▸ ESP32 Arduino ▸ ESP32S2 Dev Module
// blink the onboard LED
void setup() {
pinMode(1, OUTPUT);
}
void loop() {
digitalWrite(1, HIGH); delay(500);
digitalWrite(1, LOW); delay(500);
}board to selectesp32-s2-saola-1⧉ copy
[env:adafruit_metro_esp32s2]
platform = espressif32
board = esp32-s2-saola-1
framework = arduino
monitor_speed = 115200
upload_speed = 921600
board_build.arduino.memory_type = qio_qspi
build_flags = -DBOARD_HAS_PSRAMFind it: PlatformIO Home ▸ Boards, search
esp32-s2-saola-1 — or type it after board =.board to selectesp32-s2-saola-1⧉ copy
esp32:
board: esp32-s2-saola-1
variant: adafruit_metro_esp32s2
framework:
type: esp-idf
psram:
mode: quad
speed: 80MHz
# blink - GPIO1
output:
- platform: gpio
pin: 1
id: led_out
light:
- platform: binary
name: "LED"
output: led_outFind it: search ESPHome's board list for
esp32-s2-saola-1 (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.
esptool.py --chip esp32s2 --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-S2 · 72 × 53.2 mmCompute
MCU
ESP32-S2
Clock
240 MHz
SRAM · Flash
320 KB · 4MB · 2MB (QSPI) PSRAM
Radio
Wi-Fi
802.11 b/g/n 2.4 GHz
Bluetooth
-
Antenna
PCB
I/O
GPIO · ADC
28 · 20
UART · I²C · SPI
2 · 1 · 4
PWM
8 channels
Power
USB
USB-C
Serial
Native (CDC)
Boot address
0x1000
Flashing
Upload · OTA
esptool_py · esp_ota
Flash · Boot mode
DIO · QIO
Sketch · Data
1.25 MB · 320 KB
72 × 53.2 mm · pin pitch 2.54 mm
The Adafruit Metro ESP32-S2 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 1.25 MB with 320 KB available for data.
About this board
Inside sits the ESP32-S2 - a single-core Xtensa with native USB-OTG and no Bluetooth.
At $24.95 it's on the expensive side for an ESP32-S2 board - most land around $20.
Around the module: 2MB (QSPI) PSRAM, a STEMMA QT connector, an addressable RGB LED (GPIO45), a battery fuel gauge (MAX17048), battery charging via JST-PH 2.0, status LEDs (On, Charge, User) and Reset/DFU (BOOT0) buttons.
It flashes over native USB - no serial-converter driver needed, which isn't a given among ESP32-S2 boards.
Where to buy
prices are typical street pricesAdafruit Metro ESP32-S2
$24.95per unit, typical
Resources
Similar boards
