ESP32 Brownout detector was triggered: cause e rimedi

Perché l'ESP32 si resetta con 'Brownout detector was triggered', come trovare l'anello debole dell'alimentazione e quali rimedi funzionano su ESP32-CAM.

Pubblicato
Tempo di lettura
8 min
Un maker con gli occhiali guarda sorpreso una scheda ESP32 sulla scrivania, accanto a un'icona di batteria scarica, a un grafico della tensione che scende sotto una linea tratteggiata e a un'etichetta Brownout.

In breve

Il reset da brownout significa che l'alimentazione dell'ESP32 è scesa sotto la soglia del detector, di solito durante un picco di Wi-Fi o l'impulso del LED flash. Sistema cavo, porta o condensatori, non il detector.

Brownout detector was triggered è il messaggio che un ESP32 stampa poco prima di resettarsi da solo, perché la tensione di alimentazione è scesa sotto la soglia del detector. Un brownout è un calo della tensione che non toglie del tutto l'alimentazione, ma è abbastanza profondo da rendere inaffidabile un chip. Su un ESP32 o una ESP32-CAM succede di solito quando il Wi-Fi o un LED flash assorbono all'improvviso più corrente di quella che la porta USB, il cavo o il regolatore riescono a fornire.

La tua scheda è bloccata in un reset loop, con quella riga che scorre nel monitor seriale? Troviamo l'anello debole dell'alimentazione, sistemiamolo e lasciamo il detector acceso. I fatti qui sotto vengono dai sorgenti di ESP-IDF, dal datasheet dell'ESP32 e dalle linee guida di progettazione hardware di Espressif, più quello che fanno davvero il firmware di Gizmo Camera e quello di Gizmo Ticker. Non ho misurato nessuna linea con un oscilloscopio, quindi riporto numeri misurati solo quando vengono dalle loro fonti.

Cosa significa "Brownout detector was triggered"?

L'ESP32 ha un detector hardware che confronta la tensione di alimentazione con una soglia. Il Kconfig di ESP-IDF (v5.5) descrive l'opzione CONFIG_ESP_BROWNOUT_DET, "Hardware brownout detect & reset", così: il detector sa dire se la tensione è più bassa di un valore preciso e, in quel caso, "it will reset the chip in order to prevent unintended behaviour". È attivo di default.

La riga esatta arriva da brownout.c in ESP-IDF: Brownout detector was triggered. Quel file la stampa nella modalità basata sull'interrupt, in cui l'handler scrive il messaggio, svuota la UART e poi resetta il sistema via software. Secondo il Kconfig, questa modalità esiste per i primi chip ESP32 classici, il cui reset diretto da brownout non funziona (errata 3.4 dell'ESP32), e per il codice che deve fare qualcosa prima del riavvio. In ogni caso il motivo del reset risulta un brownout: ESP-IDF lo chiama ESP_RST_BROWNOUT, e la pagina sui motivi di reset di Arduino-ESP32 lo chiama RTCWDT_BROWN_OUT_RESET, "Reset when the vdd voltage is not stable".

Una linea di alimentazione a 3,3 V scende sotto il livello di brownout predefinito di 2,43 V dell'ESP32 classico, vicino al minimo di 2,3 V del datasheet, e il chip si resetta

Quale tensione lo fa scattare?

Il livello si sceglie in fase di build e cambia da chip a chip. Questi valori vengono dai file Kconfig di ESP-IDF v5.5, che li definiscono stime variabili da chip a chip:

ChipLivello predefinitoSoglia predefinita (V)Intervallo selezionabile (V)
ESP32ESP_BROWNOUT_DET_LVL_SEL_02,43 ± 0,05da 2,43 a 2,80
ESP32-S3ESP_BROWNOUT_DET_LVL_SEL_72,44da 2,44 a 3,30
ESP32-C3ESP_BROWNOUT_DET_LVL_SEL_72,51da 2,51 a 3,27

Per confronto, il datasheet dell'ESP32 (v5.3) indica una tensione di funzionamento da 2,3 V a 3,6 V e consiglia 3,3 V da un'alimentazione in grado di erogare 500 mA o più. Quindi il detector predefinito scatta appena sopra il minimo del chip stesso. È un indizio utile: la linea non è scesa solo un po', è crollata a pochi decimi di volt dal minimo del chip.

Perché l'ESP32 si resetta quando parte il Wi-Fi?

Perché la radio è il carico improvviso più grande. Il datasheet dell'ESP32 (tabella 5-4) indica 240 mA tipici in trasmissione 802.11b a +19,5 dBm e 180 mA per 802.11n MCS7, misurati con un duty cycle del 50%, quindi i picchi possono essere più alti delle medie. Le linee guida di progettazione hardware di Espressif dicono che quando l'ESP32 trasmette può esserci un aumento improvviso di corrente "causing power rail collapse", e consigliano almeno 10 µF all'ingresso principale dell'alimentazione e 0,1 µF vicino ai pin di alimentazione digitale. Questi valori dei condensatori sono scritti per chi progetta schede, ma mostrano dov'è il problema: il picco di corrente deve arrivare da qualcosa che sta vicino al chip.

Il chip non è mai solo, quindi gli altri carichi si sommano:

  • ESP32-CAM: la fotocamera usa la stessa alimentazione, e il LED flash sulla scheda è sul GPIO4 (Random Nerd Tutorials). Il firmware di Gizmo Camera accende quel LED, aspetta 150 ms perché l'esposizione si adatti, poi scatta il fotogramma, e tiene sveglia la radio Wi-Fi con WiFi.setSleep(false). Il suo README elenca come brownout la scheda che si riavvia "when the flash fires or during Wi-Fi setup".
  • Matrice LED: Gizmo Ticker alimenta la sua matrice MAX7219 dal pad 5 V della XIAO ESP32-S3, e la luminosità (intensità da 0 a 15) è un'impostazione della web app. Una matrice luminosa più il Wi-Fi sono un carico più grande del solo chip. Non ne ho misurato la corrente, e i collegamenti sono spiegati in MAX7219 FC16 con ESP32.
  • Flashing: esptool dice che l'alimentazione a 3,3 V deve reggere "up to 70mA continuous, 200-300mA peak" e avere abbastanza capacità (troubleshooting di esptool), e che "the chip might be browning out" in caso di errore "Invalid head of packet". La guida a failed to connect copre questo lato.

Dov'è l'anello debole dell'alimentazione?

Il detector guarda l'alimentazione del chip, quindi non può dirti quale pezzo a monte sia il colpevole. I 5 V della porta USB passano per il cavo, il connettore e il regolatore della scheda, e solo dopo arrivano al chip.

Una ESP32-CAM alimentata da un caricatore tramite un cavo USB lungo e sottile, un grafico della tensione che scende sotto la soglia, e accanto un cavo spesso e un condensatore

Percorso dell'alimentazione dalla porta USB al cavo, alla scheda ESP32-CAM-MB, alla linea a 3,3 V e all'ESP32, con l'anello debole tipico sotto ogni stadio

Cambia una cosa alla volta e ripeti il test con lo stesso trigger (per esempio scattare un'istantanea con il flash acceso):

  1. Cambia il cavo. Usa un cavo dati corto e spesso. Makerguides consiglia fili corti e grossi (22 AWG o più), e espboards.dev una coppia di alimentazione da 24 AWG. Un cavo sottile fa cadere la tensione sotto carico ed è la cosa più economica da provare.
  2. Cambia porta. Una porta del portatile o un hub non alimentato può limitare la corrente, e il datasheet chiede un'alimentazione in grado di erogare 500 mA o più. Prova un caricatore da muro o un hub alimentato.
  3. Togli la breadboard e gli extra. Makerguides sconsiglia di alimentare tramite breadboard. Scollega display, LED e sensori, e guarda se il reset sparisce.
  4. Inserisci bene la scheda. Sulla ESP32-CAM, 5 V e GND passano dalle file di pin della sua base USB, quindi un modulo inserito a metà può far calare la tensione, cosa che non ho misurato. La guida alla ESP32-CAM-MB mostra come inserirla.
  5. Usa il pin 5 V su una ESP32-CAM nuda. Random Nerd Tutorials dice che in molti hanno segnalato errori alimentandola a 3,3 V e consiglia il pin 5 V.

Dovresti vedere il reset loop fermarsi, o almeno arrivare più tardi nel boot. Se si ferma dopo una modifica, tienila e passa al punto successivo solo se il problema ritorna.

La scheda ESP32-CAM-MB aiuta o peggiora le cose?

Aiuta per comodità e non aggiunge capacità: è una presa micro-USB e un chip seriale, quindi resti limitato dal cavo e dalla porta che ci stanno dietro. Non ho trovato lo schema della scheda MB, quindi non so quale regolatore e quali condensatori abbia e non posso dire come differiscano le sue revisioni. Se una fotocamera funziona su una porta e va in brownout su un'altra, la variabile è la porta.

Quale rimedio funziona: condensatore o alimentazione esterna?

Entrambi possono aiutare, e risolvono problemi diversi. Un condensatore di bulk è un condensatore grande messo ai capi dell'alimentazione, che fornisce i brevi picchi che la sorgente non riesce a dare. Makerguides suggerisce 470 µF o più tra 5 V e GND (attento alla polarità), più un ceramico da 0,1 µF; espboards.dev suggerisce da 470 a 1000 µF a basso ESR messo vicino alla scheda, con un 0,1 µF in parallelo. Sono consigli della community, non numeri di Espressif, quindi usali come punto di partenza.

CausaSintomo tipicoRimedioImpegno
Cavo sottile o lungoSi resetta all'avvio del Wi-Fi o con il LED flashCavo dati corto e spessoBasso
Porta USB o hub deboleFunziona con un caricatore, non con un portatilePorta alimentata o alimentatore da 5 V da 1 A o piùBasso
Contatto lasco o breadboardSi resetta quando tocchi la schedaReinserisci, togli la breadboardBasso
Troppo caricoSi resetta alla massima luminosità dei LED o con il flashAbbassa la luminosità, togli carichiBasso
Carico a picchi su un'alimentazione al limiteSi resetta solo a brevi raffiche470 µF o più tra 5 V e GND, vicino alla schedaMedio
Regolatore danneggiatoSi resetta con ogni alimentazione che proviSostituisci la schedaMedio

Un alimentatore a 5 V stabilizzato da 1 A è il minimo che indicano sia Makerguides sia espboards.dev per la ESP32-CAM, e Makerguides suggerisce 2 A. Se il tuo progetto pilota una matrice LED come quella del ticker, abbassarne l'intensità è un test rapido del carico: se i reset spariscono, l'alimentazione era al limite.

Conviene disattivare il brownout detector?

No, non come soluzione. Disattivarlo, con CONFIG_ESP_BROWNOUT_DET impostato a n nella configurazione di ESP-IDF, o con la diffusa riga Arduino che scrive 0 in RTC_CNTL_BROWN_OUT_REG, ferma il reset e il messaggio. Non dà al chip più tensione. Il detector esiste, nelle parole di Espressif, "to prevent unintended behaviour", quindi senza di lui il chip continua a girare mentre l'alimentazione è sotto il livello per cui sarebbe stato resettato. Lo stesso Makerguides avverte che così il problema di alimentazione non si risolve e possono comparire Wi-Fi instabile, errori della fotocamera o video disturbato.

Spegnerlo ha senso in un solo caso: una breve prova diagnostica, per vedere se il resto del codice funziona, a patto di riattivarlo dopo.

Nemmeno l'opzione del livello, CONFIG_ESP_BROWNOUT_DET_LVL_SEL, è una via di fuga. Su ESP32 classico, ESP32-S3 ed ESP32-C3 il valore predefinito è già il livello più basso dell'elenco, quindi l'opzione può solo far resettare il chip prima. Quelle opzioni riguardano i progetti ESP-IDF: l'Arduino core include una configurazione precompilata, e non ho verificato quale livello usi il core della fotocamera.

Se non riesci a trovare l'anello debole, riduci il carico: espboards.dev suggerisce di abbassare la frequenza della CPU con setCpuFrequencyMhz(80) o di usare il deep sleep quando sei inattivo (vedi consumo reale in deep sleep dell'ESP32).

Come distingui un brownout da un cavo flat della fotocamera difettoso (0x105)?

Leggi il log. Un brownout stampa Brownout detector was triggered e resetta il chip, ancora e ancora. L'errore della fotocamera è un'altra riga, che arriva dal driver della fotocamera: Camera probe failed with error 0x105(ESP_ERR_NOT_FOUND). ESP-IDF definisce 0x105 come "Requested resource not found", e nel driver esp32-camera viene scritto quando il rilevamento del sensore fallisce. In altre parole, il chip gira bene ma non ha trovato nessuna fotocamera.

Nel firmware di Gizmo Camera, un avvio fallito della fotocamera non resetta niente: il firmware continua a girare così la web app può dire cosa non va, e mostra "Camera not found". Il rimedio del README è spegnere la scheda, controllare che il cavo flat sia inserito fino in fondo e con il fermo chiuso, e riaccenderla. Non ho trovato nessuna fonte che colleghi 0x105 a un brownout, quindi trattali come problemi separati. Se vedi 0x105 senza la riga del brownout, sistema prima il cavo flat; se vedi la riga del brownout, parti dall'alimentazione. La guida ai pin GPIO della ESP32-CAM spiega quali pin occupa la fotocamera.

Cosa ricordare

Il brownout detector è solo il messaggero. "Brownout detector was triggered" significa che l'alimentazione del chip è scesa sotto una soglia di circa 2,4-2,5 V con i valori predefiniti di ESP32, S3 e C3, di solito quando il Wi-Fi o un LED flash hanno aggiunto carico a un cavo, una porta o un contatto deboli. Parti dalla modifica più economica: cavo, porta, inserimento, carico, poi un condensatore di bulk o un alimentatore a 5 V da 1 A o più.

Cosa non ho verificato: la corrente misurata per Gizmo Camera o per il ticker, lo schema della ESP32-CAM-MB e i valori dei condensatori oltre quanto consigliano le fonti linkate. I risultati variano anche con la revisione della scheda e con il chip. Quando la fotocamera resta su, il passo successivo è una richiesta HTTP che restituisce un JPEG, oppure la guida alla ESP32-CAM-MB se stai ancora litigando con la scheda stessa.

Domande frequenti

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

Puoi, ma nascondi il sintomo e tieni la causa. Il detector resetta il chip quando l'alimentazione scende sotto la soglia, quindi senza di lui l'ESP32 continua a girare su una linea che cala, e di solito ne risultano Wi-Fi instabile, errori della fotocamera o video disturbato. Sistema invece cavo, porta o condensatori.

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