Learn

XIAO ESP32-S3 pinout: D0 to D10 and the GPIO behind each pad

Beginner

Or see every lesson.

  • 526parts on the bench
  • 46boards running now
  • 1.00xreal time, on every board
XIAO ESP32-S3: a knob on D0live0.000 s 0.00x
Click to open it in the editor
The XIAO knob circuit on the ESP32-S3: D0 is A0 on GPIO 1, and the count is printed as the converter gives it.

The Seeed XIAO ESP32-S3 puts the same Xtensa LX7 chip as the DevKitC-1, running at 240 MHz, on the XIAO family's small outline. It measures 21 by 17.5 mm and has fourteen castellated pads, seven down each long edge, spaced 0.6 inch apart. That lets it push into a breadboard across the channel. This page lists every pad and what each one does in Mokxi's simulator.

The silkscreen numbers are the XIAO family's own, matching Arduino's XIAO_ESP32S3 board definition, and sketches here use them. D0 to D10 are defined for you. The pads with the converter also carry analog names: A0 to A5 plus A8 to A10. USB-C goes to the chip's own USB port, which is what Serial and the serial monitor use.

Every pin on the board

The table has one row for each of the 15 holes of the XIAO ESP32-S3 in Mokxi, in the order of the part's pin list, which follows the board's headers. A row that says "Not a GPIO" is a supply, a ground or a control pin, and a sketch cannot drive it.

Every row below is worked out from the same board model the simulator runs: the pin list, the Circuit Doctor's pin data and the default bus pins.

XIAO ESP32-S3: every hole in Mokxi's pin list
PinSketch nameWhat it can doWatch out for
D0D0 (GPIO 1)Digital in and out. Analog in, A0. PWM.3.3 V logic.
D1D1 (GPIO 2)Digital in and out. Analog in, A1. PWM.3.3 V logic.
D2D2 (GPIO 3)Digital in and out. Analog in, A2. PWM.3.3 V logic.
D3D3 (GPIO 4)Digital in and out. Analog in, A3. PWM.3.3 V logic.
D4D4 (GPIO 5)Digital in and out. Analog in, A4. PWM. I2C SDA (default).3.3 V logic.
D5D5 (GPIO 6)Digital in and out. Analog in, A5. PWM. I2C SCL (default).3.3 V logic.
D6D6 (GPIO 43)Digital in and out. PWM. UART TX.3.3 V logic.
5V-A 5 V power pin: 5V.Not a GPIO.
GND-Ground.-
3V3-A 3.3 V power pin: 3V3.Not a GPIO.
D10D10 (GPIO 9)Digital in and out. Analog in, A10. PWM. SPI MOSI (default).3.3 V logic.
D9D9 (GPIO 8)Digital in and out. Analog in, A9. PWM. SPI MISO (default).3.3 V logic.
D8D8 (GPIO 7)Digital in and out. Analog in, A8. PWM. SPI SCK (default).3.3 V logic.
D7D7 (GPIO 44)Digital in and out. PWM. SPI SS (default). UART RX.3.3 V logic.
_RF-The board's _RF pin.Not a GPIO.

How to read the table

The Pin column is what is printed on the board. The Sketch name column is what a sketch writes, with the GPIO number in brackets, because the XIAO D numbers are not GPIO numbers. D6 is GPIO 43, for example, and D0 is GPIO 1.

A hole that has no sketch name is a supply, a ground or a control pin. It is listed so the table matches the board, hole for hole.

Power and ground pins

The XIAO ESP32-S3 has 1 ground holes in its pin list. Its 5 V pins are 5V. Its 3.3 V pins are 3V3. Pins named for a job, not for a GPIO, are _RF. A sketch cannot drive any of these with digitalWrite.

PWM and analog pins

Every GPIO pad can drive PWM with analogWrite: every GPIO pad.

These pins can read an analog voltage with analogRead: D0, D1, D2, D3, D4, D5, D10, D9 and D8. The pins run at 3.3 V.

The default I2C and SPI pins

Wire uses SDA on D4 (GPIO 5) and SCL on D5 (GPIO 6).

SPI uses SCK on D8 (GPIO 7), MISO on D9 (GPIO 8), MOSI on D10 (GPIO 9) and SS on D7 (GPIO 44).

Which pin should I use for what?

For an LED, a buzzer or a switch, any GPIO row in the table will do. For dimming, pick a PWM pin: every GPIO pad. For a potentiometer or an analog sensor, use D0, D1, D2, D3, D4, D5, D10, D9 and D8. For an I2C module, wire SDA to D4 (GPIO 5) and SCL to D5 (GPIO 6). For an SPI module, wire SCK to D8 (GPIO 7), MISO to D9 (GPIO 8) and MOSI to D10 (GPIO 9), and use D7 (GPIO 44) for SS. The pins run at 3.3 V logic.

The user LED

The yellow LED is on GPIO 21, and no pad reaches it. It is wired from 3.3 V to the pin, so it lights when the pin is LOW. That means digitalWrite(LED_BUILTIN, LOW) turns it on.

LED_BUILTIN is 21. It may feel backwards at first. Just remember: LOW means lit, HIGH means dark.

The BOOT and RESET buttons are buttons, not pads. BOOT grounds GPIO 0.

Reading analog values

The analog pads are D0 to D5, D8, D9 and D10, named A0 to A5 and A8 to A10. At the converter's default 12 dB attenuation, the full scale is about 2.9 V here.

So a potentiometer wired across 3.3 V will read 4095 over only its top eighth. Keep that in mind when a knob seems to max out early.

Sharing pads

Every pad can do PWM. The default I2C bus sits on D4 for SDA and D5 for SCL. The default SPI bus uses D8 for SCK, D9 for MISO, D10 for MOSI and D7 for SS.

D6 and D7 are also the UART pins, TX and RX. The board runs at 3.3 V logic. If you need more pins than this small board offers, programs built for it also run on the DevKitC-1.

What the model has and what it leaves out

Mokxi models one Xtensa LX7 core, GPIO through the GPIO matrix, UART0 and the USB serial port, the timers, ADC1, LEDC PWM and the RMT. Programs built for this board also run on the ESP32-S3 DevKitC-1, and the other way around.

The model leaves out the camera connector and the microSD slot of the Sense version, the battery charger, the PSRAM, the second core and a real radio. Bluetooth LE is simulated: a phone in the editor Bluetooth pane, not a real radio. WiFi joins a simulated network.

Open this circuit in the editor. XIAO ESP32-S3: a knob on D0, wired as it runs at the top of this page. Change a part or a value and run it again.

Open the circuit

Questions

What are the XIAO ESP32-S3 I2C pins?

SDA is D4 (GPIO 5) and SCL is D5 (GPIO 6).

What are the XIAO ESP32-S3 SPI pins?

SCK is D8 (GPIO 7), MISO is D9 (GPIO 8), MOSI is D10 (GPIO 9) and SS is D7 (GPIO 44).

How do i turn on the led?

The yellow LED is on GPIO 21 and lights on LOW. Use `digitalWrite(LED_BUILTIN, LOW)` to turn it on.

What voltage does the board use?

The logic voltage is 3.3 V. The LED is also wired from 3.3 V to its pin.

Which pins can do analog?

`D0` to `D5` plus `D8`, `D9` and `D10`. They are named `A0` to `A5` and `A8` to `A10`.

Does it have wifi?

It joins Mokxi's simulated network, with the name and password set as board properties. There is no real radio or real internet.

What does the boot button do?

BOOT grounds GPIO 0. RESET and BOOT are buttons, not pads.

Build this for real

Open the editor, change a value and watch the number move with it. Nothing to install, and no account needed.