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.

Pubblicato
Tempo di lettura
7 min
Categoria
Confronti
Un maker pensieroso con occhiali rotondi sta tra un file YAML e un file C++, con frecce tratteggiate da entrambi verso una scheda ESP32.

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 di ap_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.

OpzioneCosa scriviQuando va beneCosto principale
ESPHomeYAML, con lambda in C++ quando serveSensori, interruttori e display per Home AssistantLe funzioni arrivano dai componenti, e la tua app non ha un posto dove vivere
Arduino-ESP32C++ con le librerie ArduinoDispositivi custom con un grande ecosistema di librerieScrivi e mantieni tutto quello che sta sopra le librerie
ESP-IDFC o C++ sul framework di EspressifControllo totale del chip e dei driverSi parte in salita e serve più codice per ogni funzione
MicroPythonPython, eseguito da un REPLEsperimenti veloci e scriptingUn 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.

Due card: ESPHome per sensori, relè e display, con Home Assistant come interfaccia e YAML al posto del C++; firmware custom per una web app propria, un setup e un'API propri

Se la tua scheda...Usa
È un sensore, un relè o un display comandato da Home AssistantESPHome
Va configurata e aggiornata senza scrivere codiceESPHome
Ha bisogno di un protocollo o di una libreria senza componente ESPHome e ti sta bene scrivere una lambdaESPHome con lambda
Deve servire una sua web app, non una dashboardFirmware custom
Ha bisogno di un setup, di un'API o di un flasher da browser che progetti tuFirmware custom
Deve far girare uno standard che altri possono chiamare, come un server MCPFirmware 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_include e css_include per 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) oppure verify_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.

Una XIAO su breadboard manda il Wi-Fi a un telefono che mostra la sua app di impostazioni, con le etichette app on the board e no cloud, e un case stampato accanto

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.

Catena di build: la cartella webapp di Nuxt, gizmo-embed verso C++ compresso con gzip, una build PlatformIO, poi la scheda che serve la UI

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

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