ESP32 non si connette: No serial data received

Risolvi 'Failed to connect to ESP32: No serial data received' passo passo: cavo dati, driver, porte, download mode su S3, C3, XIAO e ESP32-CAM-MB.

Pubblicato
Tempo di lettura
8 min
Un maker perplesso davanti a un laptop che mostra un messaggio rosso 'Failed to connect' mentre preme il pulsante BOOT di una piccola scheda ESP32 collegata via USB.

In breve

L'errore significa che esptool non ha ricevuto risposta dal bootloader ROM del chip. Controlla prima cavo dati e porta, poi forza la download mode a mano: tieni BOOT (GPIO0), tocca RESET e riprova.

Failed to connect to ESP32: No serial data received significa che esptool ha aperto la porta seriale ma dal bootloader ROM del chip non è tornato nulla. Espressif lo collega all'hardware: una scheda guasta, linee RX/TX scollegate o un reset in download mode andato male. Nella pratica di solito si riduce a un cavo USB solo ricarica, una porta sbagliata o occupata, una scheda che non è mai entrata in download mode oppure un'alimentazione debole. Le vediamo in quest'ordine, partendo dalla soluzione più economica.

Questa guida copre le schede ESP32 classiche, i chip con USB nativa (ESP32-S3, C3, C6), la XIAO ESP32-S3 e la ESP32-CAM-MB. Il testo dell'errore e le cause arrivano dalla pagina di troubleshooting di esptool di Espressif, mentre le sequenze per le singole schede sono quelle che i progetti OpenGizmo usano per flashare il firmware dal browser.

Cosa significa "No serial data received"?

La download mode è lo stato in cui il bootloader ROM dell'ESP32 aspetta esptool sulla porta seriale. Il chip ci entra quando GPIO0 è tenuto basso al reset (il pulsante "BOOT" fa proprio questo). Esptool manda pacchetti di sincronizzazione e l'errore compare quando non torna indietro nemmeno un byte. Secondo i documenti di Espressif "di solito indica un qualche problema hardware": una scheda che non funziona affatto, linee RX/TX non collegate o un problema nel reset in download mode.

L'esptool attuale (ho controllato i sorgenti della 5.1.0 e della 4.8.1) lo stampa così:

Codice
Codice
A fatal error occurred: Failed to connect to ESP32: No serial data received.
For troubleshooting steps visit: https://docs.espressif.com/projects/esptool/en/latest/troubleshooting.html
Riga 2, col. 1UTF-8Testo semplice

Il nome del chip cambia in base al tuo target (ESP32-S3, ESP32-C3). Nei post più vecchi puoi trovare un altro messaggio per la stessa situazione, per esempio "Timed out waiting for packet header". Non sono riuscito a trovare quella stringa nei sorgenti di esptool 3.3.2, 4.8.1 e 5.1.0, quindi non so dire quale versione la stampasse. Se la vedi, le soluzioni qui sotto valgono comunque.

Il flasher nel browser delle pagine dei progetti è basato su esptool-js 0.7.1 e, quando non riesce a raggiungere il chip, mostra "Failed to connect with the device". Stesso problema, frase più corta, stesse soluzioni.

Tre sintomi di una connessione ESP32 fallita e la prima soluzione per ciascuno: nessuna porta, porta senza connessione e un errore a metà del flash

Cosa vediCausa più probabilePrima cosa da provare
Nessuna nuova porta seriale quando colleghi la schedaCavo solo ricarica, driver mancante, porta guastaCambia il cavo, cambia porta USB
La porta compare, 'No serial data received'Il chip non è in download mode, oppure un altro programma occupa la portaChiudi gli altri terminali, poi BOOT premuto + RESET
'Wrong boot mode detected (0xXX)!'Il chip risponde, ma l'auto-reset non ha funzionatoEntra in download mode a mano
'Invalid head of packet (0xXX)'Cavo difettoso, cortocircuiti sulla breadboard, brownoutCambia cavo, abbassa il baud rate
Si blocca a metà del flashAlimentazione instabile o baud rate troppo altoRiprova con un baud rate più basso

1. È il cavo? Come riconosci un cavo solo ricarica?

Un cavo solo ricarica ha i fili di alimentazione ma non la coppia dati: la scheda si accende e il computer non vede niente. Le pagine di Espressif non descrivono questo caso e non ho numeri su quanto sia comune, ma il README di Gizmo Camera mette "prova un altro cavo USB (alcuni caricano e basta)" tra i primi controlli, e provare non costa nulla.

  1. Scollega la scheda e ricollegala. Guarda l'elenco delle porte: ls /dev/tty* su Linux, ls /dev/cu.* su macOS, Gestione dispositivi su Windows (la guida di Espressif alla connessione seriale usa lo stesso metodo: confronta l'elenco con e senza la scheda).
  2. Se non compare niente di nuovo, prova un cavo che sai portare dati, per esempio quello del telefono che sincronizzi con il computer.
  3. Collegalo direttamente al computer, non a un hub o alla porta USB di un monitor.

A questo punto dovresti vedere una nuova voce. Se c'è, vai avanti. Se non c'è, prova la scheda su un secondo computer prima di dare la colpa a lei.

2. È il driver o un problema di permessi?

Le schede con un bridge USB-seriale hanno bisogno del driver del chip bridge. La pagina di Espressif sulla boot mode cita FTDI, CP210x e CH340x come i convertitori più comuni, e la sua guida alla connessione seriale dice che di solito i driver sono già inclusi nel sistema operativo. Se la porta compare in Gestione dispositivi con un'icona di avviso, installa il driver del chip stampato sulla tua scheda.

Altre due cose nascondono una scheda che funziona:

  • Un altro programma occupa la porta. Il classico è un monitor seriale rimasto aperto in un'altra finestra, e su Linux può dare fastidio anche modem-manager. Chiudili e riprova.
  • Permessi su Linux. esptool ha bisogno dell'accesso in lettura e scrittura alla porta. Aggiungi il tuo utente al gruppo dialout (o uucp su alcune distribuzioni), poi esci e rientra nella sessione:
Dai al tuo utente l'accesso alla porta seriale
sudo usermod -a -G dialout $USER

3. Come si entra in download mode a mano?

La maggior parte delle schede di sviluppo si resetta da sola in download mode: esptool agita le linee DTR e RTS del bridge USB, collegate a GPIO0 e a EN. Quando quel circuito manca, è lento o non è affidabile, lo fai tu. La pagina di Espressif sulla boot mode lo riassume così: tieni premuto il pulsante Boot (GPIO0) e premi EN. GPIO0 basso al reset seleziona il bootloader seriale ROM, mentre GPIO0 alto (o lasciato flottante, grazie al pull-up interno) seleziona l'esecuzione normale.

Un maker tiene premuto il pulsante BOOT di una minuscola scheda XIAO mentre ne collega il cavo USB-C, con il terminale di un laptop che aspetta accanto

Sequenze di pulsanti, tieni premuto e tocca, per la XIAO ESP32-S3, la ESP32-CAM-MB e una generica scheda di sviluppo ESP32

XIAO ESP32-S3

La pagina getting started di Seeed documenta due modi per entrare in bootloader mode, entrambi con i pulsanti BOOT e Reset:

  1. Tieni premuto BOOT, collega il cavo USB senza rilasciarlo, poi rilascia BOOT.
  2. Oppure tieni premuto BOOT mentre alimenti la scheda e premi Reset una volta.

Seeed dice anche di provare prima a premere solo Reset se la porta non compare o l'upload fallisce. Entrambi i pulsanti stanno sopra la scheda, quindi con il case chiuso di un dispositivo basato su XIAO come Gizmo Ticker non ci arrivi. I miei appunti sulla XIAO dicono la stessa cosa: una volta chiuso, flasha e resetta tutto via USB. Per una porta ostinata, apri la scatola e usa la sequenza BOOT sul banco.

ESP32-CAM sulla ESP32-CAM-MB

La ESP32-CAM di AI Thinker non ha una porta USB: si innesta sulla ESP32-CAM-MB, un piccolo adattatore USB con i pulsanti IO0 e RST. Gizmo Camera documenta la sequenza manuale nel suo README: tieni premuto IO0, premi e rilascia RST, poi rilascia IO0 e flasha di nuovo. IO0 è GPIO0, lo stesso pin del BOOT. Nel case stampato li premi con una graffetta attraverso i forellini sui lati lunghi. Il procedimento completo è nella guida alla programmazione con la ESP32-CAM-MB.

Scheda di sviluppo generica

Tieni premuto BOOT, premi e rilascia EN (spesso con scritto RESET), rilascia BOOT e avvia l'upload. Per alcuni chip contano anche altri pin oltre a GPIO0: sull'ESP32-S3, GPIO46 deve essere flottante o basso per entrare nel bootloader seriale. La guida sugli strapping pin per chip tratta il resto.

4. Perché fallisce sui chip con USB nativa (ESP32-S3, C3, C6)?

Chip come ESP32-S3, ESP32-C3 ed ESP32-C6 hanno un controller USB Serial/JTAG integrato, quindi tra il computer e l'ESP non c'è nessun chip bridge. Espressif dice che "è in grado di mettere" il chip "in download mode automaticamente", quindi le cause legate al bridge qui per lo più non valgono. Ce ne sono però altre:

  • Il firmware si è preso i pin USB. Il controller è a funzione fissa: non si può riconfigurare per altro che non sia una porta seriale e JTAG. Ma se l'applicazione riconfigura o disattiva i pin USB (sull'ESP32-S3 sono GPIO19 per D- e GPIO20 per D+, secondo la guida di Espressif alla console), il dispositivo sparisce dal computer. La soluzione è la sequenza manuale: porta basso il pin di boot (GPIO0 sull'ESP32-S3, GPIO9 sull'ESP32-C6) e resetta il chip, poi flasha uno sketch che lascia stare l'USB.
  • Deep sleep. Sull'ESP32-S3 il dispositivo USB Serial/JTAG risulta scollegato mentre il chip è in deep sleep e si ricollega quando si risveglia. Uno sketch che dorme quasi sempre è difficile da beccare: usa la sequenza BOOT.
  • La scheda non riparte dopo un download manuale. Se sei entrato in download mode con BOOT ed EN, esptool non riesce a uscirne con il reset predefinito, perché USB Serial/JTAG fa solo un core reset che non rilegge il pin di boot. Aggiungi --after watchdog-reset, oppure premi EN o ricollega la scheda.

I comandi usano la sintassi di esptool 5 (esptool, write-flash con il trattino); le vecchie versioni 4.x scrivono esptool.py e write_flash.

Terminale
esptool --port /dev/ttyACM0 --after watchdog-reset write-flash 0x0 merged.bin

Sostituisci porta e file con i tuoi. Su Linux le schede con USB nativa di solito compaiono come /dev/ttyACM* e quelle con bridge come /dev/ttyUSB*, anche se non l'ho verificato su tutte le schede.

5. Problemi di alimentazione che sembrano errori di flash

Se la connessione funziona ma il flash muore a metà, o vedi Invalid head of packet, sospetta l'alimentazione e il cavo. Espressif dice che l'alimentazione a 3,3 V deve fornire fino a 70 mA continui con picchi da 200 a 300 mA, e deve avere abbastanza capacità per reggere quei picchi (troubleshooting di esptool). Avverte anche che l'uscita a 3,3 V degli adattatori FTDI FT232R e delle schede Arduino non fornisce abbastanza corrente, e che i moduli breakout molto semplici non integrano abbastanza capacità per funzionare in modo affidabile senza componenti aggiuntivi.

Prova, una cosa alla volta: un cavo più corto o migliore, un'altra porta, togliere la scheda dalla breadboard (le breadboard possono mandare in corto i pin della flash SPI) e scollegare tutto ciò che è attaccato ai pin GPIO. Un brownout durante il flash è la stessa storia del reset del brownout detector, solo prima nel boot.

6. Ultima spiaggia: baud rate, flag del chip e un trace

Sei ancora bloccato? Cambia una cosa alla volta:

  1. Abbassa il baud rate. Espressif suggerisce -b 9600 come valore molto lento per escludere un problema di baud. Il default di esptool è 115200, e la connessione iniziale è limitata a quel valore.
  2. Indica il chip. Saltare l'autorilevamento con --chip esp32s3 elimina una variabile.
  3. Traccia la conversazione. esptool --trace mostra ogni scambio seriale, così capisci se torna indietro qualcosa o no.
Terminale
esptool --chip esp32s3 --port /dev/ttyACM0 --baud 9600 --trace flash-id

flash-id legge l'ID del chip flash senza scrivere niente, quindi è un test sicuro. Se risponde, la connessione va bene e il problema era nel passaggio di flash. Se la connessione funziona ma non sei sicuro di dove finisca l'immagine nella flash, la tabella delle partizioni dell'ESP32 spiegata mostra com'è organizzata.

Cosa ricordare

"No serial data received" è un errore di comunicazione, non un giudizio sul firmware. Scendi lungo la lista: cavo dati, porta e permessi, download mode a mano (BOOT premuto, poi RESET), poi alimentazione e baud rate. Il cavo e la sequenza BOOT manuale sono le prime due cose da escludere, ma Espressif non dà statistiche su quale sia la causa più comune, e una scheda morta o un chip USB-UART danneggiato restano possibili quando tutto il resto fallisce.

Non ho provato le sequenze su ogni scheda di questo post. I passaggi per la XIAO e la ESP32-CAM-MB vengono dal wiki di Seeed e dal README di Gizmo Camera, il resto dalla documentazione di Espressif. Il comportamento può cambiare in base alla revisione della scheda, al chip bridge e al sistema operativo. Quando la connessione funziona, flashare dal browser è il modo più rapido per mettere un progetto sulla scheda, e cos'è un ESP32 dà il contesto sui chip citati qui. Se usi una XIAO ESP32-S3 e al tuo sketch servono pin liberi, la guida al pinout della XIAO ESP32-S3 mostra quali sono sicuri.

Domande frequenti

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

Significa che esptool ha aperto la porta seriale ma non ha ricevuto nessun byte dal bootloader ROM dell'ESP32. Secondo la pagina di troubleshooting di Espressif di solito è un problema hardware: cavo solo ricarica, linee RX/TX scollegate, scheda guasta o reset in download mode fallito.

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