ESPHome o firmware custom su ESP32: quale scegliere
ESPHome o firmware custom per ESP32? Una tabella per decidere, cosa ESPHome non sa fare e perché web app, portal e server MCP di OpenGizmo usano PlatformIO.
- Autore
Mauro Brambilla- Pubblicato
- Tempo di lettura
- 7 min
- Categoria
- Confronti

In breve
Usa ESPHome quando la scheda è un sensore o un interruttore comandato da Home Assistant. Scrivi firmware custom quando deve servire una sua web app, un suo setup o una sua API, come le tre di OpenGizmo.
Usa ESPHome quando il tuo ESP32 è un sensore, un interruttore o un display comandato da Home Assistant: lo descrivi in YAML e ESPHome genera e compila il firmware. Usa un firmware custom (C++ tuo sul framework Arduino o su ESP-IDF, oppure MicroPython) quando la scheda deve fare qualcosa che nessun componente copre, come servire una sua web app o parlare un protocollo tutto suo.
Tutti e tre i progetti OpenGizmo usano un firmware custom, compilato con PlatformIO. In questo post metto le due strade una accanto all'altra, con la documentazione di ESPHome (controllata a novembre 2026) e il codice vero di Gizmo Ticker, Gizmo Reolink Switch e Gizmo Camera. Una cosa subito: non ho rifatto questi progetti in ESPHome, quindi quando dico che una funzione non ha un posto, parlo della documentazione che ho letto, non di un esperimento.
Cosa ti dà ESPHome?
ESPHome è uno strumento che trasforma un file YAML in firmware per un ESP32 o un chip simile. La sua home page dice che ti lascia costruire dispositivi per la smart home senza scrivere codice, e che ogni dispositivo funziona con Home Assistant già pronto, in locale. Elenchi i componenti (un sensore di temperatura su un pin, un relè, un display) e ESPHome li compila e li flasha.
Ci sono quattro cose incluse, e fanno risparmiare parecchio tempo:
- Un'API nativa per Home Assistant. Aggiungi
api:alla configurazione e il dispositivo compare tra le integrazioni scoperte, come descrive la pagina del componente API. La cifratura è opzionale. - Aggiornamenti OTA. Il componente OTA offre il protocollo nativo, un upload dalla pagina web del dispositivo o il download da un web server, più una safe mode per riprendersi da una build sbagliata.
- Fallback Wi-Fi. Con un blocco
ap:il componente Wi-Fi avvia un hotspot solo quando il router non è raggiungibile (il default diap_timeoutè 90 secondi), e il captive portal ti permette di cambiare rete o caricare un firmware. - Una libreria di componenti. Un esempio da questo blog: il componente display MAX7219 supporta chip in catena, rotazione e scorrimento.
Quest'ultimo punto conta per essere onesti. Non è l'hardware il motivo per cui OpenGizmo salta ESPHome: esiste un componente per la catena MAX7219 del Ticker, e un componente per la camera ESP32 la cui pagina include un esempio di pin per Ai-Thinker, la famiglia di schede che usa Gizmo Camera.
ESPHome contro Arduino, ESP-IDF e MicroPython
ESPHome sta sopra i framework, quindi il confronto vero è uno stack. La pagina della piattaforma ESP32 dice che ESPHome usa ESP-IDF di default e offre Arduino per ESP32 classico, S2, S3 e C3, integrato come componente ESP-IDF. Scrivere firmware custom significa scegliere direttamente uno degli altri.
| Opzione | Cosa scrivi | Quando va bene | Costo principale |
|---|---|---|---|
| ESPHome | YAML, con lambda in C++ quando serve | Sensori, interruttori e display per Home Assistant | Le funzioni arrivano dai componenti, e la tua app non ha un posto dove vivere |
| Arduino-ESP32 | C++ con le librerie Arduino | Dispositivi custom con un grande ecosistema di librerie | Scrivi e mantieni tutto quello che sta sopra le librerie |
| ESP-IDF | C o C++ sul framework di Espressif | Controllo totale del chip e dei driver | Si parte in salita e serve più codice per ogni funzione |
| MicroPython | Python, eseguito da un REPL | Esperimenti veloci e scripting | Un runtime sul chip e meno librerie pronte per componenti esotici |
Alcune fonti per la tabella: la documentazione di Arduino-ESP32 dice che il core 3.3.12 si basa su ESP-IDF 5.5, quindi i due sono una sola famiglia. La guida di ESP-IDF lo chiama il framework di Espressif per le applicazioni IoT, compilato con CMake e Ninja. Il riferimento ESP32 di MicroPython elenca ESP32, C3, C6, S2 e S3 e un REPL su UART0 a 115200 baud. La colonna "costo principale" è un mio giudizio, non un benchmark: qui non ho misurato niente.
Per la parte di toolchain del firmware custom, il confronto tra Arduino IDE e PlatformIO ha tutti i dettagli. Questo post parla del livello sopra: se scrivere un firmware oppure no.
Quando conviene ESPHome?
ESPHome è la scelta giusta quando la risposta a "chi parla con questa scheda?" è Home Assistant. In quel caso integrazione, aggiornamenti e hotspot di fallback arrivano gratis, e poche righe di YAML sostituiscono centinaia di righe di C++ che altrimenti dovresti mantenere.
È giusto anche quando vuoi tanti dispositivi simili, perché ognuno è un file corto. Ed è la partenza migliore se non vuoi scrivere C++: è proprio lo scopo dichiarato dello strumento.

| Se la tua scheda... | Usa |
|---|---|
| È un sensore, un relè o un display comandato da Home Assistant | ESPHome |
| Va configurata e aggiornata senza scrivere codice | ESPHome |
| Ha bisogno di un protocollo o di una libreria senza componente ESPHome e ti sta bene scrivere una lambda | ESPHome con lambda |
| Deve servire una sua web app, non una dashboard | Firmware custom |
| Ha bisogno di un setup, di un'API o di un flasher da browser che progetti tu | Firmware custom |
| Deve far girare uno standard che altri possono chiamare, come un server MCP | Firmware custom |
Cosa non sa fare ESPHome?
ESPHome non è una scatola chiusa, e ha delle vie di fuga da conoscere. Le lambda sono C++ dentro il YAML che può leggere qualsiasi componente tramite il suo ID, e la funzione external components importa codice della community o locale da un repository Git o da una cartella. ESPHome avverte anche che copia le lambda nel C++ generato senza validarle.
I limiti saltano fuori quando il prodotto è l'interfaccia, non il dispositivo:
- Il web server è una pagina fissa. Il componente web_server ha tre versioni dell'interfaccia, asset locali, autenticazione opzionale e
js_includeecss_includeper le aggiunte. La documentazione non descrive un modo per ospitare una pagina tua separata. - Anche il captive portal è una pagina fissa. La sua documentazione offre le impostazioni Wi-Fi e l'upload del firmware, e l'unica opzione è la compressione degli asset incorporati.
- Le richieste HTTP hanno default piccoli. Il componente http_request tiene un buffer di risposta da 1 kB finché non lo alzi, e su ESP32 verifica di default i certificati HTTPS: con un certificato autofirmato serve un file CA (
ca_certificate_path, che la pagina consiglia) oppureverify_ssl: false, che secondo la pagina riduce la sicurezza. - L'API nativa parla con pochi client. La pagina dell'API dice che la usano solo lo strumento ESPHome, Home Assistant e ioBroker. Un agente AI o un tuo script non è in quella lista.
Nessuno di questi è un bug. Descrivono uno strumento che ottimizza per i dispositivi, non per i prodotti.
Come cambiano aggiornamenti e setup Wi-Fi?
ESPHome include sia un sistema di aggiornamento sia un hotspot Wi-Fi di fallback, e i due approcci differiscono per chi possiede il codice. Con ESPHome configuri l'hotspot di fallback e la piattaforma OTA, e l'implementazione la mantiene il progetto. Con un firmware custom scegli ogni pezzo tu, e questo ti dà libertà, ma anche il conto da pagare.
OpenGizmo è un buon esempio del conto. Il captive portal è codice mio: gizmo-common avvia un hotspot aperto, risponde a ogni nome DNS con il proprio indirizzo e reindirizza le richieste di test a /ap-setup. Il confronto tra i metodi di provisioning Wi-Fi mostra cosa costa in termini di sicurezza. E non c'è nessun OTA: i tre firmware usano la tabella delle partizioni huge_app.csv, un solo slot app da 3 MB, quindi gli aggiornamenti passano da USB dal browser, come spiega il confronto dei metodi OTA. Chi usa ESPHome ha OTA e safe mode senza scrivere una riga.
Perché i progetti OpenGizmo usano un firmware custom?
Quattro motivi, e ognuno si vede nei repository. Sono motivi per questi prodotti, non per ogni scheda.

La web app è il prodotto
Ogni scheda serve una web app Nuxt 4. La build è nuxt generate, poi gizmo-embed di gizmo-common trasforma i file statici in array C++ compressi con gzip sotto microcontroller/src/webui/, come descrivono le note sulla web UI incorporata. Il firmware li serve dal gestore del not-found, con i file con hash in cache per un anno. L'immagine finale dell'app è un unico file da circa 1,7 a 1,8 MB (le dimensioni sono nel post sull'OTA). Il web server documentato di ESPHome non ha uno slot per questo.

Il setup è progettato, non configurato
La pagina di setup fa parte della stessa web app, e gizmo-common limita a quattro percorsi API quello che l'hotspot può raggiungere. È il genere di dettaglio che il portale fisso di ESPHome non sa esprimere. gizmo-common salva le credenziali Wi-Fi nella memoria NVS della scheda tramite la libreria Arduino Preferences. Se il prodotto non avesse una web app propria, il portale sarebbe la prima parte che passerei a ESPHome.
La Camera parla MCP
Gizmo Camera risponde alle richieste Model Context Protocol su /mcp e serve una guida per gli agenti su /llms.txt. Il codice del protocollo è mcp_protocol.cpp, 509 righe, coperto da test nativi. Si potrebbe impacchettare come external component di ESPHome, ma il codice del protocollo andrebbe comunque scritto, solo dentro un altro sistema di build.
Il client Reolink ha regole sue
Il Reolink Switch fa il login per ottenere un token di sessione, lo rinnova un minuto prima che l'NVR lo faccia scadere, raggruppa i comandi e riprova su una connessione nuova quando l'NVR chiude quella tenuta aperta. Chiama anche setInsecure() perché gli NVR Reolink presentano di solito certificati autofirmati, un compromesso che spiego in quel post. Quella logica sta in reolink.cpp e reolink_protocol.cpp, e il secondo file è testato sul computer.
Aggiungi il lato build: ogni repository fissa piattaforma, librerie e tag di gizmo-common in platformio.ini, e lancia pio test -e native prima di ogni release. Il post su Arduino IDE e PlatformIO mostra quel file.
Quindi, da quale conviene partire?
Parti da ESPHome se Home Assistant è il front end, e lo dico anche se per OpenGizmo non lo uso: toglie le parti noiose e facili da sbagliare. Passa al firmware custom quando ti accorgi di litigare con lo strumento. Per OpenGizmo sarebbero l'app, il flasher e l'API che la scheda gestisce da sé.
Il costo di questa scelta lo porti tu. Io mantengo un portale, un flasher, un workflow di release e il codice del protocollo, e le schede non hanno OTA. Cosa ho verificato: le pagine di ESPHome linkate sopra, a novembre 2026, e il codice dei tre repository. Cosa no: che ESPHome non possa riprodurre uno qualsiasi di questi progetti, l'uso di flash o RAM di ESPHome, e il suo comportamento con la XIAO ESP32-S3 sul tuo hardware. Poi leggi la panoramica di OpenGizmo per vedere il progetto intero, oppure quale ESP32 comprare se non hai ancora scelto la scheda.
Domande frequenti
Trova risposte rapide alle domande più comuni su questo argomento.
Nessuno dei due è meglio in assoluto. ESPHome è più veloce quando la scheda è un sensore, un interruttore o un display comandato da Home Assistant, perché lo descrivi in YAML. Il firmware custom vince quando la scheda deve servire una sua web app, avere un suo setup o parlare un protocollo per cui ESPHome non ha componenti.
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.






