Passa al contenuto principale

Flashing del firmware

Il flashing avviene in due fasi: un primo flash una tantum via USB per portare il dispositivo online, poi l'installazione della configurazione Superhome via wireless.

Passaggi

1. Installa ESPHome in Home Assistant

Impostazioni → App → Installa app → cerca ESPHome Device Builder → Install → Start.

2. Primo flash via USB (ESPHome Web)

Questo primo flash si esegue dal tuo computer via USB, non dalla macchina su cui gira Home Assistant.

Usa Google Chrome

Il web flasher funziona solo in Google Chrome. Collega il display ESP32 via USB al computer su cui apri Chrome, non alla macchina HAOS.

  1. Apri la dashboard ESPHome e clicca New Device.
  2. Nella pagina che si apre, clicca Open ESPHome Web, poi Connect.
  3. Seleziona il display dall'elenco delle porte seriali, poi scegli Prepare for first use e lascia che esegua l'installazione.
  4. Segui le istruzioni per connettere il dispositivo al tuo WiFi. Usa la stessa rete su cui gira Home Assistant.

3. Adotta il dispositivo in ESPHome

Torna all'ESPHome Builder in Home Assistant. In alto compare un banner che segnala che è stato rilevato un nuovo dispositivo.

  1. Clicca Show, poi Take control, e assegnagli il nome che preferisci.
  2. Installa la configurazione che ESPHome propone.
  3. Attendi finché i log mostrano il dispositivo connesso alla tua rete e la riga Boot seems successful; resetting boot loop counter.

4. Applica la configurazione Superhome

  1. Nell'ESPHome Builder, clicca Edit sul dispositivo e sostituisci il contenuto con lo YAML di esphome-gesture-display.yml nel repository Superhome. Mantieni le credenziali WiFi e la chiave di cifratura API che ESPHome ha impostato per questo dispositivo (lo YAML le referenzia tramite i secrets).
  2. Per maggiore stabilità e meno errori di connessione, consigliamo di impostare un IP statico nel blocco manual_ip dello YAML. Se preferisci usare il DHCP, rimuovi invece il blocco manual_ip.
  3. Clicca Save, poi Install → Wirelessly.
  4. Questa operazione richiede un po' di tempo. Al termine, il dispositivo si riconnette e i log mostrano di nuovo Boot seems successful; resetting boot loop counter. A quel punto puoi cliccare Stop. Questo chiude solo la finestra dei log; non arresta il display.

5. Aggiungi a Home Assistant

In Home Assistant → Impostazioni → Dispositivi, il display viene rilevato automaticamente. Aggiungilo. Per verificare che funzioni, apri il dispositivo e commuta la sua entità backlight: lo schermo dovrebbe accendersi e spegnersi.

6. Posiziona il display

Scollega il display dal computer, mettilo dove preferisci e alimentalo via USB-C. Si riconnette al WiFi da solo e inizia a iscriversi ai sensori sensor.superhome_*.