Aziz Bench

Generatore di configurazioni ESPHome

Scegli la scheda, aggiungi sensori e uscite e ottieni una configurazione pronta da caricare, con le chiavi di API e OTA generate nel tuo browser. I pin che potrebbero impedire l’avvio della scheda vengono segnalati prima di collegare i fili.

Vai al file YAML generato ↓
Dispositivo
Framework

Nelle versioni attuali di ESPHome ESP-IDF è il framework predefinito per l’ESP32. Scegli Arduino solo se un componente che ti serve lo richiede.

Lettere minuscole, numeri e trattini. Diventa il nome di rete, per esempio sensor-node.local.

Sensori e uscite

Nessun componente per ora: aggiungine uno dall’elenco qui sotto.

Rete e Home Assistant

Se il WiFi non funziona, la scheda apre una sua rete da cui inserire nuove credenziali con il telefono.

Fa risparmiare un secondo o due a ogni connessione, utile con il deep sleep.

Chiavi e password sono generate nel tuo browser e salvate solo lì, quindi restano le stesse quando torni. Creane di nuove per ogni nuovo dispositivo.

Extra

sensor-node.yaml

esphome:
  name: sensor-node
  friendly_name: "Nodo sensori"

esp32:
  board: esp32dev
  framework:
    type: esp-idf

logger:

api:
  encryption:
    key: "GENERATED-IN-YOUR-BROWSER"

ota:
  - platform: esphome
    encryption:

wifi:
  ssid: !secret wifi_ssid
  password: !secret wifi_password
  ap:
    ssid: "Nodo sensori Fallback"
    password: "GENERATED-IN-YOUR-BROWSER"

captive_portal:

sensor:
  - platform: dht
    pin: GPIO4
    model: DHT22
    temperature:
      name: "Clima temperature"
    humidity:
      name: "Clima humidity"
    update_interval: 60s
  - platform: wifi_signal
    name: "WiFi signal"
    update_interval: 60s
  - platform: uptime
    name: "Uptime"

switch:
  - platform: gpio
    pin: GPIO26
    name: "Relè"
    restore_mode: RESTORE_DEFAULT_OFF
secrets.yaml 
wifi_ssid: "YourNetworkName"
wifi_password: "YourWiFiPassword"

Salva questo file accanto alla configurazione, nella cartella di ESPHome, con nome e password della tua rete WiFi.

Come usare il file

Installa ESPHome, come componente aggiuntivo ESPHome Device Builder in Home Assistant oppure con pip install esphome sul computer. Salva la configurazione con il nome del dispositivo, per esempio sensor-node.yaml, e metti nella stessa cartella un secrets.yaml con nome e password della rete WiFi.

La prima volta carica il firmware via USB, con esphome run sensor-node.yaml o dal Device Builder. Dopo, gli aggiornamenti passano dal WiFi. Home Assistant trova il dispositivo in rete e chiede la chiave di crittografia dell’API, che è nella configurazione.

I pin che possono impedire l’avvio

Alcuni pin vengono letti al reset per decidere come si avvia il chip. Sull’ESP32 sono i GPIO 0, 2, 5, 12 e 15; sull’ESP8266 D3, D4 e D8. Un sensore o un modulo relè che li tira dalla parte sbagliata all’accensione può bloccare la scheda. Il generatore segnala questi pin negli elenchi; il pinout interattivo dell’ESP32 li spiega uno per uno.

Aggiornamenti OTA cifrati

Dalla versione 2026.9 ESPHome può cifrare gli aggiornamenti via rete con la stessa chiave dell’API di Home Assistant, e lo consiglia al posto della vecchia password OTA. Il generatore usa la crittografia come impostazione predefinita. Se il tuo ESPHome è più vecchio, scegli l’opzione con la password oppure aggiorna prima ESPHome.

Deep sleep a batteria

Con il deep sleep la scheda si sveglia, invia le letture e torna a dormire. Un IP statico accorcia la connessione e fa risparmiare energia a ogni risveglio. Per stimare quanto dura la batteria con il tuo intervallo di risveglio usa il calcolatore di autonomia per ESP32.

Domande frequenti

Serve Home Assistant per usare ESPHome?

No. L’API serve a Home Assistant, ma ESPHome funziona anche da solo con la pagina web sulla porta 80, oppure con MQTT. Senza Home Assistant puoi disattivare l’API e attivare la pagina web.

Dove metto la password del WiFi?

In secrets.yaml, un file separato nella stessa cartella della configurazione. La configurazione vi fa riferimento solo con !secret wifi_ssid e !secret wifi_password, così puoi condividere il file YAML senza esporre la password.

A cosa serve la chiave di crittografia dell’API?

Cifra il traffico tra il dispositivo e Home Assistant. Home Assistant la chiede quando aggiungi il dispositivo. Con l’OTA cifrato la stessa chiave protegge anche gli aggiornamenti del firmware.

Perché ESPHome mi avvisa per un pin di strapping?

Il chip legge i pin di strapping al reset per decidere come avviarsi. Usarli è consentito, ma un circuito che li tira dalla parte sbagliata all’accensione può impedire l’avvio. Preferisci altri pin, oppure assicurati che niente li piloti durante l’avvio.

Che scheda scelgo per una ESP32 DevKit generica?

esp32dev va bene per la maggior parte delle schede con modulo ESP32-WROOM-32, comprese la DevKitC e la DOIT DevKit V1 a 30 pin. Scegli le opzioni C3 o S3 solo se sulla tua scheda c’è un ESP32-C3 o un ESP32-S3.

Posso aggiungere altri sensori in seguito?

Sì. Modifica il file YAML in ESPHome e ricaricalo via WiFi. Puoi anche tornare su questa pagina: impostazioni e chiavi restano salvate nel tuo browser.