Pinout XIAO ESP32-S3: quali pin usare senza rischi
Pinout XIAO ESP32-S3: da D0 a D10 con i GPIO, i pad I2C, SPI e UART di default, l'unico pad di strapping da evitare e due mappe dei pin da firmware reali.
- Autore
Mauro Brambilla- Pubblicato
- Tempo di lettura
- 9 min
- Categoria
- Guide

In breve
La XIAO ESP32-S3 ha 11 pad GPIO, da D0 a D10. D0, D1 e D3 sono GPIO semplici, D4 e D5 sono I2C, da D8 a D10 c'è l'SPI, D6 e D7 sono UART e D2 (GPIO3) è l'unico strapping pin da evitare.
La XIAO ESP32-S3 di Seeed Studio ha 11 pad GPIO, da D0 a D10. Le scelte più sicure sono D0, D1 e D3 (GPIO1, GPIO2 e GPIO4) per un pulsante o un buzzer, D4 e D5 per l'I2C e da D8 a D10 per l'SPI. Lascia libero D2 (GPIO3, uno strapping pin) e, se puoi, tieni D6 e D7 per la seriale.
Hai una scheda minuscola, 14 pad e un componente da collegare senza brutte sorprese all'avvio. Questa guida associa ogni pad al suo GPIO dell'ESP32-S3, segnala quelli con un tranello e mostra le due mappe dei pin reali dietro il Gizmo Ticker e il Gizmo Reolink Switch. I numeri vengono dalla wiki di Seeed Studio, dal datasheet dell'ESP32-S3 (versione 2.2) e dai repository dei firmware, e alla fine segno cosa non ho potuto verificare.
Qual è il pinout della XIAO ESP32-S3 (da D0 a D10 ai GPIO)?
La XIAO ESP32-S3 porta fuori 14 pad: tre di alimentazione (5V, GND, 3V3) e undici pad GPIO con l'etichetta da D0 a D10. L'etichetta D è il nome che Seeed dà al pad, mentre il numero GPIO è quello del chip. Nel codice puoi usare l'uno o l'altro: nel pins_arduino.h del core Arduino per questa scheda D0 è una costante pari a 1 (GPIO1), mentre il firmware del Reolink Switch, qui sotto, usa direttamente i numeri GPIO.

Con la porta USB-C in alto e i componenti rivolti verso di te, da D0 a D6 scorrono lungo il bordo sinistro, mentre il bordo destro riporta 5V, GND, 3V3, D10, D9, D8, D7. La tabella aggiunge cosa sa fare ogni pad. ADC e touch vengono dall'elenco dei pin del datasheet: da GPIO1 a GPIO10 sono su ADC1 e da GPIO1 a GPIO14 hanno il touch sensing. Due cose non stanno su nessun pad: i pulsanti BOOT e RESET e il LED utente sul GPIO21, che secondo la wiki di Seeed si accende quando il pin è LOW.
| Pad | GPIO | Funzione di default | ADC / touch | Verdetto |
|---|---|---|---|---|
| D0 | 1 | nessuna | ADC1, touch 1 | Sicuro: GPIO libero |
| D1 | 2 | nessuna | ADC1, touch 2 | Sicuro: GPIO libero |
| D2 | 3 | nessuna | ADC1, touch 3 | Da evitare: strapping pin |
| D3 | 4 | nessuna | ADC1, touch 4 | Sicuro: GPIO libero |
| D4 | 5 | I2C SDA | ADC1, touch 5 | Sicuro, meglio tenerlo per l'I2C |
| D5 | 6 | I2C SCL | ADC1, touch 6 | Sicuro, meglio tenerlo per l'I2C |
| D6 | 43 | UART TX | nessuno | Attenzione: pad della seriale |
| D7 | 44 | UART RX | nessuno | Attenzione: pad della seriale |
| D8 | 7 | SPI SCK | ADC1, touch 7 | Sicuro, meglio tenerlo per l'SPI |
| D9 | 8 | SPI MISO | ADC1, touch 8 | Sicuro, meglio tenerlo per l'SPI |
| D10 | 9 | SPI MOSI | ADC1, touch 9 | Sicuro, meglio tenerlo per l'SPI |
Altri due pin hanno un'etichetta D nella tabella di Seeed, D11 (GPIO42) e D12 (GPIO41), ma non sono tra i 14 pad dell'header. La wiki di Seeed li indica come pin analogici, ma dice anche che non supportano l'ADC, e questo concorda con il datasheet: il suo elenco dei pin analogici si ferma al GPIO20. Nessuno dei due firmware OpenGizmo li usa.
Quali sono i pin I2C, SPI e UART di default?
Un pin di default è il pad che gli oggetti Wire, SPI e Serial1 del core Arduino scelgono quando non gli passi nessun pin. La wiki di Seeed indica l'I2C su D4 (SDA, GPIO5) e D5 (SCL, GPIO6), l'SPI su D8 (SCK, GPIO7), D9 (MISO, GPIO8) e D10 (MOSI, GPIO9) e la UART su D6 (TX, GPIO43) e D7 (RX, GPIO44). Non elenca nessun pad di chip select di default.
"Di default" non vuol dire "fisso". Il datasheet dice che le periferiche si possono instradare sui pin GPIO tramite la GPIO matrix, per questo entrambi i firmware OpenGizmo passano i pin in modo esplicito. Questa è l'intera configurazione I2C del Reolink Switch, da display.cpp:
Wire.begin(config::DISPLAY_SDA_PIN, config::DISPLAY_SCL_PIN); // GPIO5 and GPIO6: D4 and D5
Wire.setClock(100000);E questa è la configurazione SPI del Ticker, da matrix.cpp:
SPI.begin(CLK_PIN, -1, DATA_PIN); // sck = GPIO7 (D8), no MISO, mosi = GPIO9 (D10)Quel -1 è un trucco da rubare. Una matrice MAX7219 riceve soltanto dati, quindi il firmware avvia l'SPI senza MISO e il pad D9, che di default è il MISO, diventa la linea di chip select. Se il tuo dispositivo risponde, tieni D9 per il MISO e prendi il CS da D0, D1 o D3. I collegamenti di quel display sono in MAX7219 FC16 con ESP32: collegamenti, logica a 3,3 V, specchiatura.
Per l'I2C, quando uno schermo resta vuoto, i primi da controllare sono l'indirizzo e l'alimentazione a 5 V, non i pad. LCD I2C 16x2 con ESP32 che non funziona ripassa tutta quella checklist.
Quali pin della XIAO ESP32-S3 sono strapping pin da evitare?
Uno strapping pin è un GPIO che il chip legge al reset per decidere come avviarsi. L'ESP32-S3 ne ha quattro, secondo il capitolo sulla configurazione di boot del datasheet: GPIO0 e GPIO46 (modalità di boot), GPIO45 (tensione VDD_SPI) e GPIO3 (sorgente del segnale JTAG). I livelli di default e cosa seleziona ciascuno li trovi in Strapping pin dell'ESP32, chip per chip. Su questa scheda il GPIO0 è il pulsante BOOT, il GPIO3 è il pad D2, mentre GPIO45 e GPIO46 non hanno un'etichetta D nella mappa di Seeed.
La risposta pratica quindi è breve: D2 è l'unico strapping pin su un pad. I latch campionano questi pin solo al reset e il datasheet dice che poi i pin sono liberi di fare da normale I/O, ed è per questo che un pulsante BOOT sul GPIO0 può fare anche da pulsante utente quando il firmware è in esecuzione. Il README di gizmo-common fa proprio così: tenere premuto BOOT per 10 secondi mentre il dispositivo è in funzione avvia il ripristino di fabbrica.
Allora D2 è davvero pericoloso? Con gli eFuse JTAG al valore di default 0, la tabella JTAG del datasheet dice che il GPIO3 viene ignorato all'avvio. Il rischio comincia su un chip in cui EFUSE_STRAP_JTAG_SEL è stato bruciato: lì il livello sul GPIO3 al reset decide da dove arriva il JTAG. Il datasheet dice anche che il GPIO3 non ha una resistenza di pull interna. Non ho provato cosa fa una XIAO di serie con D2 tenuto basso al reset, quindi seguo la regola prudente che il firmware Reolink dichiara in un commento nel codice: stare lontano da D2. Se finisci i pad, D2 è l'ultimo che userei, come ingresso con una resistenza tutta sua.
Anche altri GPIO sono off limits, ma sulla XIAO non puoi raggiungerli. La guida GPIO di ESP-IDF dice che da GPIO26 a GPIO32 sono di solito usati per la flash SPI e la PSRAM, da GPIO33 a GPIO37 pure con flash o PSRAM octal, e che GPIO19 e GPIO20 sono usati di default dall'USB-JTAG. Nessuno di loro ha un'etichetta D qui. Gli strapping pin cambiano da chip a chip, quindi non copiare questo elenco su un C3 o su un ESP32 classico: Strapping pin dell'ESP32, chip per chip li confronta.
Quali pin possono pilotare in sicurezza un pulsante, un buzzer o un sensore?
Usa prima D0, D1 e D3. Sono GPIO semplici, senza funzione di bus di default e senza ruolo nel boot, e se un domani cambi idea hanno anche ADC1 e touch. Poi scegli in base a cosa colleghi.

- Un pulsante: collegalo tra il pad e GND e attiva il pull-up interno. Il datasheet indica il weak pull-up interno a 45 kΩ tipici. Il Reolink Switch lo fa su D0 con
pinMode(config::BUTTON_PIN, INPUT_PULLUP)e legge LOW come premuto, con un debounce di 40 ms. - Un buzzer: il Reolink Switch pilota il suo buzzer da D1 con un semplice
digitalWrite, che va bene per un buzzer attivo, cioè uno che suona con un livello continuo. La tabella DC del datasheet dà 40 mA in source e 28 mA in sink come valori tipici all'impostazione di drive più forte, ma non ho misurato la corrente di quel buzzer e il repository non ne indica il codice. Come regola pratica, non un numero del datasheet, tutto ciò che assorbe più di qualche milliampere va dietro a un transistor. - Un componente a 5 V: i pad sono segnali a 3,3 V. La tensione massima d'ingresso alta del datasheet è VDD più 0,3 V, quindi una logica a 5 V non va direttamente su un pad D. Alimentalo invece dal pad 5V: la wiki di Seeed lo etichetta VBUS e dice che non porta tensione quando la scheda va a batteria. Dal pad 3V3 regolato, secondo la wiki di Seeed, puoi prelevare 700 mA.
- Un sensore su un bus: usa D4 e D5 per l'I2C e da D8 a D10 per l'SPI, come nella sezione precedente.
- Un ingresso analogico: uno qualsiasi tra D0-D5 e D8-D10, che stanno su ADC1 (da GPIO1 a GPIO10).
- Seriale: D6 e D7 sono GPIO43 e GPIO44, i pin TX e RX della UART0 del chip. La wiki di Seeed dice che la UART0 non è usata di default perché trasporta la comunicazione seriale USB, e il suo esempio con
Serial1usa proprio D6 e D7. Tienili per un GPS, un sensore o un'altra scheda che parla in seriale.
Conta anche il lato stampato in 3D. Nei case OpenGizmo i fili escono di lato dalla scheda, dai pad del bordo, quindi il pad che scegli decide anche da dove passa un cavo. Le regole di progetto dei case sono in Regole di progetto per un case ESP32 stampato in 3D.
Cosa cambia sulla XIAO ESP32-S3 Sense e Plus?
La Sense e la Plus usano lo stesso chip, ma gli extra occupano dei GPIO, quindi i pin liberi cambiano. Le mie note sui componenti coprono solo la scheda standard, perciò per le altre due mi baso su quello che dice la wiki di Seeed.
| Scheda | Cosa aggiunge | Pin che occupa o aggiunge |
|---|---|---|
| Standard | Niente oltre al chip | Da D0 a D10 sui pad, LED utente sul GPIO21 |
| Sense | Telecamera, microfono PDM, slot per scheda SD | Telecamera GPIO10-18, 38-40, 47, 48. Microfono GPIO41 e GPIO42 (D12 e D11). CS della scheda SD GPIO21, con SCK, MISO e MOSI condivisi con D8-D10 |
| Plus | 16 MB di flash, 8 MB di PSRAM, più pad | Pad extra da D11 a D19 sui GPIO 38-42, 10, 13, 12 e 11 (la wiki di Seeed elenca D11 e D12 due volte con GPIO diversi e la sua tabella delle specifiche dice 18 GPIO, quindi controlla) |
Quella che frega è la Sense: il suo slot SD condivide i pad SPI da D8 a D10, quindi un display SPI su quei pad può entrare in conflitto con la scheda. La wiki di Seeed dice che tagliando J3 si scollegano i resistori di pull-up della scheda SD, il che disattiva la scheda e ripristina il normale comportamento dell'SPI. I pad SPI del Gizmo Ticker sono proprio da D8 a D10 e l'ambiente PlatformIO del progetto punta alla scheda standard seeed_xiao_esp32s3. Se scegli una Sense o una Plus, controlla la tabella della wiki per la tua scheda prima di copiare qualsiasi pin. Quale XIAO scegliere, all'inizio, è il tema di XIAO ESP32-S3 vs C3 vs C6.
Come hanno scelto i pin il Ticker e il Reolink Switch?
Entrambi i firmware usano pad vicini tra loro, sul bordo accanto all'alimentazione, ed entrambi lasciano vuoti D2, D6 e D7. Lo dice il commento in config.cpp del Reolink Switch: l'LCD sta sui pad I2C di default, il pulsante e il buzzer accanto, "clear of D2 (GPIO3, a boot strapping pin) and of the serial pads D6 and D7".

| Progetto | Componente | Pad | GPIO |
|---|---|---|---|
| Gizmo Ticker | MAX7219 DIN | D10 | 9 |
| Gizmo Ticker | MAX7219 CS | D9 | 8 |
| Gizmo Ticker | MAX7219 CLK | D8 | 7 |
| Gizmo Reolink Switch | Pulsante | D0 | 1 |
| Gizmo Reolink Switch | Buzzer | D1 | 2 |
| Gizmo Reolink Switch | LCD SDA | D4 | 5 |
| Gizmo Reolink Switch | LCD SCL | D5 | 6 |
La scelta del Ticker ha una ragione fisica. Le mie note sui componenti per la scheda fanno notare che il bordo destro riporta 5V, GND, 3V3, D10, D9, D8, D7, che è vicino all'ordine di un ingresso MAX7219 (VCC, GND, DIN, CS, CLK), quindi un cavo piatto corre dritto da una parte all'altra e il filo del 3V3 resta semplicemente libero. config.h definisce i pin solo se ARDUINO_XIAO_ESP32S3 è impostato e altrimenti ferma la build con un #error, così su un'altra scheda non finisci con un cablaggio sbagliato senza accorgertene. La costruzione completa è in Come costruire un crypto ticker con ESP32 e MAX7219.
Il codice del Reolink Switch usa i numeri GPIO invece delle etichette D, e il suo commento spiega perché: così i test nativi si compilano sul computer. Il comportamento di pulsante, buzzer e LCD è nella guida Controllare un NVR Reolink con un ESP32.
Un display per criptovalute connesso al WiFi, realizzato con ESP32, matrice LED MAX7219 e web app Nuxt 4 configurabile dal browser.
- Ticker di criptovalute in tempo reale
- Matrice LED MAX7219
- Configurazione via web
Una precisazione, già che ci siamo: non tutti i dispositivi OpenGizmo usano una XIAO. La Gizmo Camera gira su una ESP32-CAM AI Thinker, che ha una storia di pin completamente diversa, raccontata in GPIO dell'ESP32-CAM: quali sono davvero liberi.
Quali pin della XIAO ESP32-S3 scegliere per primi?
Parti da D0, D1 e D3 per pulsanti, buzzer, LED e semplici ingressi. Usa D4 e D5 per l'I2C e da D8 a D10 per l'SPI, oppure reinstradali nel codice, visto che i pad sono solo dei default. Tieni D6 e D7 per la seriale e lascia stare D2 (GPIO3), perché è l'unico strapping pin su un pad. Tieni ogni segnale a 3,3 V.
È quello che fanno due firmware funzionanti: il Ticker usa tre pad su un bordo, il Reolink Switch ne usa quattro ed entrambi stanno alla larga da D2, D6 e D7. I limiti vale la pena dirli chiaramente. Ho controllato i numeri dei pin sulla wiki di Seeed, sul datasheet e nel codice, ma non ho guardato nessun pad con l'oscilloscopio, non ho provato D2 tenuto basso al reset e non ho misurato la corrente del buzzer. La wiki di Seeed non indica nessun limite di corrente per pin e non ho verificato le revisioni della scheda. Per la vista a livello di chip sui pin di boot leggi Strapping pin dell'ESP32, chip per chip e, se stai ancora scegliendo una scheda, parti da quale ESP32 comprare.
Domande frequenti
Trova risposte rapide alle domande più comuni su questo argomento.
I pin I2C di default della XIAO ESP32-S3 sono D4 per SDA (GPIO5) e D5 per SCL (GPIO6), secondo la wiki di Seeed Studio. Puoi passare altri pin a Wire.begin(sda, scl), perché l'ESP32-S3 può instradare l'I2C sulla maggior parte dei GPIO, ma D4 e D5 sono quelli che Wire di Arduino usa senza altre indicazioni.
Autore
Mauro BrambillaPronto a costruire il tuo gizmo?
Scegli un progetto ESP32 open source e segui la sua guida passo passo, dalla lista dei componenti e dai collegamenti fino al firmware e al primo avvio.







