Adafruit Metro ESP32-S2

Full-size ESP32-S2 dev board with USB-C and STEMMA QT - great for breadboarding and secure applications.

USB-C Native USB
Adafruit Metro ESP32-S2 board
72 × 53.2 mm
ESP32-S2
MCU
240MHz
clock
4MB
flash
320KB
SRAM
28· 20 ADC
GPIO
Wi-Fi
radio
On this page

Adafruit Metro ESP32-S2 Pinout

28 pins · 2.54 mm pitch
Adafruit Metro ESP32-S2 pinout diagram
PinGPIOLabelsStatusCapabilitiesNotes
10PIN_BUTTON1strapping-
21A2T1PWMsafeadc · touch
32A3T2PWMsafeadc · touch
43A4T3PWMsafeadc · touch
54A5T4PWMsafeadc · touch
65TXA6T5PWMuartadc · touch · uart
76RXA7T6PWMuartadc · touch · uart
87A8T7PWMsafeadc · touch
98A9T8PWMsafeadc · touch
109A10T9PWMstrappingadc · touch
1110A11T10PWMstrappingadc · touch
1211A12T11PWMstrappingadc · touch
1312A13T12PWMstrappingadc · touch
1413A14T13PWMstrappingadc · touch
1514A15T14PWMstrappingadc · touch
1615A16PWMstrappingadc
1716A17PWMstrappingadc
1817A0DAC1PWMsafeadc · dac
1918A1DAC2PWMsafeadc · dac
2019A18PWMuartadc
2120A19PWMuartadc
2233SDAPWMsafei2c
2334SCLPWMsafei2c
2435MOSIPWMsafespi
2536SCKPWMsafespi
2637MISOPWMsafespi
2742LED_BUILTINSSPWMstrappingspi
2845PIN_NEOPIXELPWMstrapping-
28 GPIOs broken out 15 free · 11 need care · 2 to avoid

Start with these

15 pins with no boot or system involvement
A2GPIO1A3GPIO2A4GPIO3A5GPIO4TXGPIO5RXGPIO6A8GPIO7A9GPIO8A0GPIO17A1GPIO18SDAGPIO33SCLGPIO34MOSIGPIO35SCKGPIO36MISOGPIO37

Freely assignable - no strapping, flash, USB or JTAG duties. Ideal first picks for buttons, sensors and LEDs.

Fine - with a little care

11 pins · 6 things to know
PIN_BUTTON1GPIO0 Bootstrapping pin; selects boot mode (SPI Boot vs UART Download). Strapping

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.

A10GPIO9A11GPIO10A12GPIO11A13GPIO12A14GPIO13A15GPIO14 General-purpose SPI2 (FSPI) IO MUX pins Other

IO MUX pin of the general-purpose SPI2 (FSPI) bus, not of the in-package flash - that sits on GPIO26-32. The datasheet does not restrict it, so it is only taken if your board wires flash, an SD card or a display to FSPI.

  • A10General-purpose SPI2 (FSPI) IO MUX pin - hold/data line (FSPIHD)
  • A11General-purpose SPI2 (FSPI) IO MUX pin - chip select (FSPICS0)
  • A12General-purpose SPI2 (FSPI) IO MUX pin - data in (FSPID)
  • A13General-purpose SPI2 (FSPI) IO MUX pin - clock (FSPICLK)
  • A14General-purpose SPI2 (FSPI) IO MUX pin - data out (FSPIQ)
  • A15General-purpose SPI2 (FSPI) IO MUX pin - write-protect/data line (FSPIWP)
A16GPIO15 32.768 kHz RTC crystal oscillator positive input (XTAL_32K_P); also functions as GPIO15 (U0RTS, ADC2_CH4). Other

If an external 32 kHz crystal is used for RTC, this pin is dedicated to the crystal and cannot be used as GPIO.

A17GPIO16 32.768 kHz RTC crystal negative input (XTAL_32K_N); also GPIO16 (U0CTS, ADC2_CH5). Other

If using an external 32 kHz crystal, this pin is connected to the crystal and should not be used as general I/O.

LED_BUILTINGPIO42 JTAG test mode select pin (MTMS); also GPIO42. JTAG

JTAG TMS pin; should not be repurposed if JTAG debugging or programming via JTAG is required.

PIN_NEOPIXELGPIO45 Bootstrapping pin; selects flash supply voltage (VDD_SPI) (0 = 3.3 V, 1 = 1.8 V). Strapping

Must be set correctly at boot (usually low for 3.3 V); improper level can cause boot failure or flash malfunction.

Only if you know the tricks

2 pins · 2 things to know
A18GPIO19 USB OTG D- line (full-speed USB data -); also available as GPIO19/RTC_GPIO19 and ADC2 channel 8. USB

Used for USB communication; using this pin as general GPIO can interfere with USB functionality.

A19GPIO20 USB OTG D+ line (full-speed USB data +); also serves as GPIO20/RTC_GPIO20 and ADC2 channel 9. USB

Dedicated to USB interface; repurposing as GPIO may disrupt USB connectivity.

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.

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.

11 of the exposed pins carry boot-time or system duties on the ESP32-S2 (PIN_BUTTON1, A10, A11 and 8 more) - check the guidance above before wiring anything to them. A2, A3, A4, A5 and 11 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
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
GPIO1 toggles - wire an LED and resistor to it, or change the pin to your board's own LED.
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.ino Copy
// toggle GPIO1 - wire an LED and resistor to it
void setup() {
  pinMode(1, OUTPUT);
}
void loop() {
  digitalWrite(1, HIGH); delay(500);
  digitalWrite(1, LOW);  delay(500);
}
board to selectesp32-s2-saola-1⧉ copy
platformio.ini 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_PSRAM
Find it: PlatformIO Home ▸ Boards, search esp32-s2-saola-1 - or type it after board =.
board to selectesp32-s2-saola-1⧉ copy
device.yaml Copy
esp32:
  board: esp32-s2-saola-1
  variant: 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_out
Find 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.
terminal Copy
esptool.py --chip esp32s2 --port /dev/ttyACM0 \
  --baud 921600 write_flash 0x1000 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 mm · vs other ESP32 chips →
Compute
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 · 2 · 2
PWM
8 channels
Power
USB
USB-C
Serial
Native (CDC)
Boot address
0x1000
Electrical
Input
5V USB · 6-12V DC jack · 3.7V LiPo
Consumption
-
Regulator
AP2112K-3.3
Flashing
Upload · OTA
esptool_py · esp_ota
Flash · Boot mode
DIO · QIO
Sketch · Data
1.25 MB · 320 KB

Dimensions

53.2 mm72 mm
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 prices
Adafruit Metro ESP32-S2
Adafruit Metro ESP32-S2
$24.95per unit, typical

Resources

Similar boards