Strapping pin ESP32: S3, C3, C6 e ESP32 classico

Tutti gli strapping pin di ESP32 classico, S3, C3 e C6 con livello di default e funzione, presi dai datasheet, più le regole per usarli senza sorprese.

Pubblicato
Tempo di lettura
8 min
Categoria
Guide
Un maker con occhiali tondi indica tre pin evidenziati in arancione su un disegno di chip quadrato, accanto a un pulsante e a un'etichetta con la scritta Strapping pins.

In breve

Gli strapping pin vengono letti al reset per scegliere il boot mode. ESP32 classico: GPIO0, 2, 5, 12, 15. S3: GPIO0, 3, 45, 46. C3: GPIO2, 8, 9. C6: GPIO4, 5, 8, 9, 15.

Uno strapping pin è un GPIO che l'ESP32 legge al reset per decidere come avviarsi. L'ESP32 classico ne ha cinque: GPIO0, 2, 5, 12 e 15. L'ESP32-S3 ne ha quattro: GPIO0, 3, 45 e 46. L'ESP32-C3 ne ha tre: GPIO2, 8 e 9. L'ESP32-C6 ne ha cinque: GPIO4, 5, 8, 9 e 15.

Colleghi un sensore a un pin, la scheda non parte più, e lo stesso sensore su un altro pin funziona. Quasi sempre la storia degli strapping pin è questa. I pin cambiano da chip a chip, quindi un tutorial scritto per una scheda può portarti dritto in una trappola su un'altra. Questa guida mette a confronto i quattro chip. Ogni pin, livello di default e funzione arriva dai datasheet di ESP32 (v5.3), ESP32-S3 (v2.2), ESP32-C3 (v2.5) ed ESP32-C6 (v1.6), nei capitoli Boot Configurations, e ti mostro come se la cavano due firmware OpenGizmo.

Cos'è uno strapping pin e quando lo legge il chip?

Uno strapping pin è un GPIO la cui tensione viene campionata dalla logica di reset del chip per scegliere un'opzione di avvio, come il boot normale o il download mode. Ognuno ha un latch: secondo i datasheet, "at chip reset, the latches sample the bit values of their respective strapping pins and store them until the chip is powered down or shut down", e poi i pin sono "freed up to be used as regular IO pins".

Ne derivano due cose.

  • Il livello conta solo intorno al reset. Un pulsante su GPIO0 può fare da pulsante utente quando il firmware è in esecuzione: è così che il Gizmo Ticker usa il pulsante BOOT della XIAO ESP32-S3 per il factory reset da 10 secondi.
  • Se lasci uno strapping pin scollegato, il suo livello lo decide una resistenza interna debole. I datasheet dicono che i valori di default "are determined by pins' internal weak pull-up/pull-down resistors at reset if the pins are not connected to any circuit, or connected to an external high-impedance circuit". Un componente che pilota il pin con decisione, o una resistenza di pull che aggiungi tu, vince su quel default.

Ogni datasheet indica anche un tempo di hold (tH) per il livello di strapping dopo che il pin di reset torna alto: minimo 1 ms sull'ESP32 classico e 3 ms su S3, C3 e C6. Tutto ciò che colleghi deve aver stabilizzato il suo livello entro quel tempo.

Quali sono gli strapping pin di ESP32, S3, C3 e C6?

Ecco tutti gli strapping pin, con il default che il chip assegna loro quando nient'altro li pilota. Flottante significa nessuna resistenza di pull interna: il livello lo decide il tuo circuito (o il rumore).

ChipStrapping pinDefault al resetCosa seleziona
ESP32GPIO0Pull-up (1)Boot mode, insieme a GPIO2
ESP32GPIO2Pull-down (0)Boot mode, insieme a GPIO0
ESP32GPIO12 (MTDI)Pull-down (0)Tensione di alimentazione della flash VDD_SDIO
ESP32GPIO15 (MTDO)Pull-up (1)Log di boot su U0TXD; timing SDIO slave
ESP32GPIO5Pull-up (1)Timing SDIO slave
ESP32-S3GPIO0Pull-up debole (1)Boot mode, insieme a GPIO46
ESP32-S3GPIO46Pull-down debole (0)Boot mode; stampa dei messaggi della ROM
ESP32-S3GPIO45Pull-down debole (0)Tensione VDD_SPI
ESP32-S3GPIO3FlottanteSorgente del segnale JTAG
ESP32-C3GPIO9Pull-up debole (1)Boot mode, insieme a GPIO8
ESP32-C3GPIO8FlottanteBoot mode; stampa dei messaggi della ROM
ESP32-C3GPIO2FlottanteBoot mode (pull-up consigliato)
ESP32-C6GPIO9Pull-up debole (1)Boot mode, insieme a GPIO8
ESP32-C6GPIO8FlottanteBoot mode; stampa dei messaggi della ROM
ESP32-C6GPIO15FlottanteSorgente del segnale JTAG
ESP32-C6GPIO4 (MTMS), GPIO5 (MTDI)FlottanteFronte del clock SDIO

Strapping pin di ESP32, ESP32-S3, ESP32-C3 ed ESP32-C6 come etichette colorate: verde per il pull-up di default, rosso per il pull-down, blu per flottante

Tre dettagli sono facili da perdere. Primo: su ESP32-S3 ed ESP32-C6 il pin JTAG (GPIO3 e GPIO15) non ha nessuna resistenza di pull interna, e i datasheet dicono che il suo livello "must be controlled by the external circuit that cannot be in a high impedance state". Conta solo se gli eFuse JTAG del chip sono stati cambiati rispetto al valore di default 0: con i default, la tabella JTAG del datasheet dice che il pin viene ignorato. Secondo: sull'ESP32-C3 il datasheet precisa che GPIO2 "actually does not determine SPI Boot and Joint Download Boot mode", ma consiglia di metterlo in pull-up per via dei glitch. Terzo: sul C6, GPIO4 e GPIO5 compaiono nel datasheet con i loro nomi JTAG, MTMS e MTDI. Scelgono solo il fronte del clock SDIO, una funzione che la maggior parte degli sketch Arduino non tocca mai, ed entrambi sono flottanti di default.

Come si entra in download mode su ogni chip?

Il download mode è lo stato in cui il bootloader nella ROM aspetta esptool o un flasher da browser invece di eseguire il tuo firmware. A sceglierlo sono i livelli dei pin di boot al reset, e cambiano da famiglia a famiglia: per questo il consiglio "tieni premuto BOOT" che funziona su una scheda può fallire su un'altra.

Livelli per il download mode al reset: GPIO0 e GPIO2 bassi sull'ESP32, GPIO0 e GPIO46 bassi sull'S3, GPIO9 basso e GPIO8 alto su C3 e C6

ChipBoot normale (SPI boot)Download modeNote dal datasheet
ESP32GPIO0 = 1, GPIO2 qualsiasiGPIO0 = 0 e GPIO2 = 0GPIO2 ha un pull-down, quindi lasciarlo scollegato funziona
ESP32-S3GPIO0 = 1, GPIO46 qualsiasiGPIO0 = 0 e GPIO46 = 0GPIO46 ha di default un pull-down debole
ESP32-C3GPIO9 = 1, GPIO8 qualsiasi, GPIO2 = 1GPIO9 = 0, GPIO8 = 1, GPIO2 = 1GPIO8 è flottante di default. GPIO2 non è decisivo, ma il datasheet consiglia il pull-up
ESP32-C6GPIO9 = 1, GPIO8 qualsiasiGPIO9 = 0 e GPIO8 = 1GPIO8 = 0 con GPIO9 = 0 è una combinazione non valida che provoca comportamenti imprevisti

La pagina di esptool sul boot mode di Espressif dice la stessa cosa per il chip classico: "The ESP32 will enter the serial bootloader when GPIO0 is held low on reset", e GPIO2 "must also be either left unconnected/floating, or driven Low". In pratica, per l'ESP32 classico e per l'S3 basta un pulsante BOOT su GPIO0, perché GPIO2 e GPIO46 hanno già un pull-down di default. C3 e C6 sono diversi: GPIO8 non ha pull interno, quindi il download mode funziona solo se GPIO8 è alto al reset, con una resistenza già sulla scheda o una che aggiungi tu. Non ho letto gli schemi di nessuna scheda C3 o C6, quindi controlla la tua.

Se una scheda non vuole entrare in download mode, la checklist completa è in Failed to connect to ESP32: no serial data received.

Cosa succede se usi GPIO12, GPIO0 o GPIO2 sull'ESP32 classico?

È sull'ESP32 classico che si concentrano quasi tutti i guai da strapping, perché le sue schede di sviluppo portano fuori tutti e cinque gli strapping pin e i tutorial li usano senza farsi problemi.

  • GPIO12 alto al reset porta la flash a 1,8 V. GPIO12 è MTDI. Il datasheet dice che con MTDI = 0 (il default) VDD_SDIO è alimentato da VDD3P3_RTC, tipicamente 3,3 V, mentre con MTDI = 1 è alimentato da un LDO interno a 1,8 V. La pagina di esptool avverte che tenerlo alto "may prevent flashing and/or booting if 3.3V flash is used and this pin is pulled high, causing the flash to brownout". Un sensore o un pull-up di un bus che tiene GPIO12 alto al reset è il modo più facile per finirci dentro.
  • GPIO0 basso al reset significa download mode, non il tuo sketch. Tutto ciò che tiene GPIO0 basso durante il reset, come un driver che si accende a livello basso o un pulsante rimasto premuto, fa aspettare un flasher al chip. La pagina di esptool nota che l'ESP32 ha una resistenza di pull interna da 45 kΩ su GPIO0, quindi un circuito esterno che deve vincerla ha bisogno di una resistenza forte, "for example a 10k resistor to GND".
  • GPIO2 alto con GPIO0 basso tiene il chip fuori dal download mode. Il download mode vuole entrambi i pin bassi (o GPIO2 flottante, visto che di default ha un pull-down), quindi un componente che porta GPIO2 alto mentre tieni premuto BOOT lascia il flasher in attesa, e ti ritrovi con un errore di connessione.
  • GPIO15 basso zittisce il log di boot. Il datasheet dice che MTDO = 0 disabilita la stampa della ROM su U0TXD. Non è grave, ma sembra un serial monitor morto.

Niente di tutto questo è un motivo per evitare del tutto questi pin. È un motivo per sapere quale parte del circuito li pilota nel momento del reset, che non è la stessa cosa di ciò che fa quando il firmware è in esecuzione. Per le altre limitazioni del chip classico (GPIO6-GPIO11 di solito collegati alla flash SPI, GPIO34-GPIO39 solo input), guarda la guida ai GPIO di ESP-IDF e, per la ESP32-CAM in particolare, ESP32-CAM GPIO pins: which are really free.

Come evitano gli strapping pin i progetti OpenGizmo?

Entrambi i progetti con la XIAO ESP32-S3 stanno alla larga dall'unico pad di strapping della scheda, e il Gizmo Camera mostra cosa succede quando uno strapping pin viene preso per un altro scopo.

Una maker indica alla lavagna lo schizzo di una XIAO con un pad cerchiato come GPIO3, accanto allo schizzo di una ESP32-CAM

Il Gizmo Reolink Switch mette il pulsante su GPIO1, il buzzer su GPIO2 e l'LCD su GPIO5 e GPIO6. Il commento nel suo config.cpp spiega perché: "clear of D2 (GPIO3, a boot strapping pin) and of the serial pads D6 and D7". Dei quattro strapping pin dell'S3, solo GPIO3 è su un pad della XIAO ESP32-S3, secondo la mappa dei pin in XIAO ESP32-S3 pinout: which pins are safe to use. GPIO0 è il pulsante BOOT, mentre GPIO45 e GPIO46 non hanno un'etichetta D nella mappa di Seeed.

Il Gizmo Camera gira sulla ESP32-CAM di AI Thinker, un ESP32 classico, e la camera si prende lo strapping pin per sé. Il suo camera_pins.h dice:

camera_pins.h
camera_pins.h
#define XCLK_GPIO_NUM 0 // Also the BOOT strapping pin, so the firmware never reads it as a button
Riga 1, col. 1UTF-8cpp

Ecco perché il firmware della camera non ha il factory reset con il pulsante BOOT, mentre il Ticker ce l'ha: sulla ESP32-CAM GPIO0 porta il clock della camera dopo il boot, e per far dimenticare il Wi-Fi alla scheda si passa dalla web app. Il pulsante IO0 della scheda resta comunque la strada per il download mode, come mostra la guida alla programmazione con ESP32-CAM-MB.

Come usare uno strapping pin in sicurezza?

Prima scegli un pin che non sia di strapping. Quando non puoi, segui questa lista:

  • Trova il pin nella tabella qui sopra per il tuo chip esatto, non per la famiglia che ricordi.
  • Capisci cosa vede il pin al reset: il livello a riposo del componente, un pull-up su un bus, o un driver che si accende prima del chip.
  • Confronta quel livello con il default del chip. Se coincide, o se la funzione non ti interessa (uno strap per il timing SDIO che non usi), sei a posto.
  • Se non coincide, sposta il componente su un altro pin o aggiungi una resistenza che ripristini il livello di default. Falla forte: le resistenze di pull interne del chip sono circa 45 kΩ sull'ESP32 classico, e la pagina di esptool usa 10 kΩ verso GND come esempio.
  • Prova sia la pressione del pulsante di reset sia un'accensione a freddo: i datasheet dicono che gli strap vengono campionati all'accensione e a un reset hardware.
  • Non contare mai sul fatto che un pin flottante di default (GPIO3 dell'S3, GPIO2 e GPIO8 del C3, GPIO4, 5, 8 e 15 del C6) resti da solo a un livello fisso.

Un'ultima regola: non copiare la mappa dei pin da un chip all'altro. Il config.h del Gizmo Ticker blocca la build con un #error se non si compila per la XIAO ESP32-S3, così una scheda sbagliata non può collegare in silenzio il display a un pin che significa altro. Per scegliere la scheda in partenza, which ESP32 should you buy confronta i chip, e XIAO ESP32-S3 vs C3 vs C6 copre le tre schede XIAO.

Quali strapping pin contano di più per la tua scheda?

Su un ESP32 classico guarda prima GPIO12 (può impedire l'avvio a una scheda con flash a 3,3 V) e poi GPIO0 e GPIO2. Su una XIAO ESP32-S3 solo GPIO3 arriva a un pad, e con gli eFuse di default viene ignorato al boot. Altre schede S3 possono portare fuori più dei quattro. Su ESP32-C3 ed ESP32-C6, GPIO8 e GPIO9 decidono tra l'esecuzione del tuo firmware e il download mode, e GPIO9 è il pulsante BOOT sulle schede che ce l'hanno.

I limiti vanno dichiarati. Ho controllato ogni pin, default e funzione sulle quattro versioni di datasheet citate sopra, e le scelte di pin di OpenGizmo sui repository, ma non ho misurato con l'oscilloscopio nessuna scheda al reset e non ho letto gli schemi delle schede C3 o C6. I datasheet vengono rivisti, quindi guarda la versione attuale prima di far produrre un PCB. Se sei alle prime armi con la famiglia di chip, parti da what is the ESP32; se il flash fallisce, la tappa successiva è la checklist per il failed to connect.

Domande frequenti

Trova risposte rapide alle domande più comuni su questo argomento.

Il datasheet dell'ESP32-S3 elenca quattro strapping pin: GPIO0 e GPIO46 scelgono il boot mode, GPIO45 la tensione VDD_SPI e GPIO3 la sorgente del segnale JTAG. GPIO0 ha di default un pull-up debole, GPIO45 e GPIO46 un pull-down debole, mentre GPIO3 è flottante, senza pull interno.

Pubblicato

Pronto 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.

Leggi anche

Esplora le categorie