The ESP32-S2 DevKitC-1 is a secure, single-core WiFi SoC optimized for cost-effective IoT applications that require native USB support.
1. Hardware Specifications
- Processor: Single-core Xtensa 32-bit LX7 CPU running at 240 MHz.
- Logic Level: 3.3V. All pins operate on 3.3V logic.
- Memory Limits: 4 MB Flash memory, 320 KB SRAM, plus 2 MB external PSRAM for extended buffer spaces (crucial for cryptographic functions and frame buffering).
- Wireless: Integrated 802.11 b/g/n Wi-Fi. Note: The ESP32-S2 does not support Bluetooth.
2. Detailed Pinout & GPIO Map
Below is the physical-to-code mapping table for the ESP32-S2 DevKitC-1 (36 GPIO pins total):
| Physical Pin Label | GPIO ID | Pin Type | Pin Functions / Mappings | Warnings & Cautions |
|---|---|---|---|---|
| D1 | 1 | Analog / GPIO | ADC1_CH0, Touch 1 | Cap-touch channel 1. |
| D2 | 2 | Analog / GPIO | ADC1_CH1, Touch 2 | Cap-touch channel 2. |
| D3 | 3 | Analog / GPIO | ADC1_CH2, Touch 3 | Cap-touch channel 3. |
| D4 | 4 | Analog / GPIO | ADC1_CH3, Touch 4 | Cap-touch channel 4. |
| D5 | 5 | Analog / GPIO | ADC1_CH4, Touch 5 | Cap-touch channel 5. |
| D6 | 6 | Analog / GPIO | ADC1_CH5, Touch 6 | Cap-touch channel 6. |
| D7 | 7 | Analog / GPIO | ADC1_CH6, Touch 7 | Cap-touch channel 7. |
| D8 | 8 | Analog / I2C | ADC1_CH7, Touch 8, I2C SDA | Default I2C Serial Data pin. |
| D9 | 9 | Analog / I2C | ADC1_CH8, Touch 9, I2C SCL | Default I2C Serial Clock pin. |
| D10 | 10 | Analog / GPIO | ADC1_CH9, Touch 10 | Cap-touch channel 10. |
| D11 | 11 | Analog / GPIO | ADC2_CH0, Touch 11 | Cap-touch channel 11. |
| D12 | 12 | Analog / GPIO | ADC2_CH1, Touch 12 | Cap-touch channel 12. |
| D13 | 13 | Analog / GPIO | ADC2_CH2, Touch 13 | Cap-touch channel 13. |
| D14 | 14 | Analog / GPIO | ADC2_CH3, Touch 14 | Cap-touch channel 14. |
| D15 | 15 | Analog / GPIO | ADC2_CH4 | No touch function on this pin. |
| D16 | 16 | Analog / GPIO | ADC2_CH5 | No touch function on this pin. |
| D17 | 17 | Analog / DAC | ADC2_CH6, DAC1 | True analog DAC output channel. |
| D18 | 18 | Analog / DAC | ADC2_CH7, DAC2 | True analog DAC output channel. |
| D19 | 19 | Digital | GPIO | General Purpose Input / Output. |
| D20 | 20 | Digital | GPIO | General Purpose Input / Output. |
| D21 | 21 | Digital | GPIO | General Purpose Input / Output. |
| D33 | 33 | Digital | GPIO | General Purpose Input / Output. |
| D34 | 34 | Digital / SPI | SPI CS | Default SPI Chip Select pin. |
| D35 | 35 | Digital / SPI | SPI MOSI | Default SPI Master Out Slave In pin. |
| D36 | 36 | Digital / SPI | SPI SCK | Default SPI Serial Clock pin. |
| D37 | 37 | Digital / SPI | SPI MISO | Default SPI Master In Slave Out pin. |
| D38–D42 | 38–42 | Digital | GPIO | General Purpose Input / Output (5 pins). |
| D45, D46 | 45, 46 | Digital | GPIO | General Purpose Input / Output. |
| D0 | 0 | Digital | GPIO / Boot strap | Real ESP32-S2 hardware uses this as a boot-mode strap pin, same role as GPIO0 on plain ESP32. |
| TX / RX | — | Digital | UART0 | Console/programming UART — avoid other serial devices on these two pins during upload. |
[!NOTE] Real ESP32-S2 silicon routes native USB (D-/D+) through dedicated USB_D-/USB_D+ pads, not a regular labeled GPIO header pin — and OMS's own board model doesn't tag any pin with a native-USB capability at all. See Section 3 below: native USB HID is not currently supported in OMS regardless.
3. Power Architecture and Native USB
- Native USB hardware: The ESP32-S2 chip does have a real native-USB peripheral capable of USB HID (keyboard/mouse/MIDI emulation) — but OMS currently has no Blockly extension exposing this. There is no way to program HID behavior on this board from OMS today, despite the hardware supporting it.
- Power rails: Accepts 5V from USB or DC inputs. Outputs regulated 3.3V to power auxiliary sensors. GPIO logic operates strictly on 3.3V.
4. Compiler Settings & IDE Properties
When targeting this board, the compiler is intended to use the following parameters:
- FQBN:
esp32:esp32:esp32s2 - Default Flashing Baud Rate:
921600 - Flash Mode / File Type:
esp - Flash Memory Offsets:
{ bootloader: 0x1000, partitions: 0x8000, app: 0x10000 } - Programming Runtimes: Supports C++ (Arduino) and MicroPython.
[!WARNING] Known bug: the board id this board actually uses internally (
esp32s2) doesn't match any key in the compiler's board-config lookup table (which only has hyphen/underscore forms likeesp32-s2) — so compiling currently silently falls back to plain ESP32's FQBN (esp32:esp32:esp32) instead of the S2-specific one above. See Known_Bugs.md §2.0.


