Eseguitelo dentro Home Assistant

Se Home Assistant è già il posto in cui guardate, RBgrid può vivere lì invece che accanto: lo stesso nucleo di misura, flashato come dispositivo ESPHome, con ogni circuito nella vostra dashboard Energia e nessuna seconda app da tenere.

Di cosa avete bisogno

Un ESP32 con 16 MB di flash e PSRAM — un WROVER, oppure un S3 con modulo N16R8 — la stessa scheda del firmware autonomo, più i vostri moduli rbAmp. Lato software: Home Assistant 2026.1 o successivo con HACS e, se lo costruite nella vostra configurazione, ESPHome 2026.5.3 o successivo sul framework ESP-IDF.

Flashate l'hub

Scaricate l'immagine di fabbrica per la vostra scheda dalla pagina delle release del pacchetto, poi aprite web.esphome.io in Chrome o Edge, scegliete Connect, selezionate la porta seriale della scheda, scegliete Install e selezionate il file scaricato. Ci sono due immagini: una per l'ESP32-WROVER, una per l'ESP32-S3.

Configurate il Wi-Fi subito dopo il flashing, con lo stesso cavo USB, quando l'installer lo propone — così l'hub non ha mai bisogno del suo access point di configurazione. Se usate l'access point, cambiatene la password una volta associato l'hub.

Oppure costruitelo dentro la vostra configurazione

Se tenete già i vostri dispositivi ESPHome come YAML, aggiungete il componente come sorgente esterna invece di flashare un'immagine di fabbrica:

yaml
  external_components:
    - source:
        type: git
        url: https://github.com/rb-amp/rbgrid-esphome
        ref: v1.2.0   # the tag of the release you are installing — see the repository's Releases
        path: esphome/components
      components: [rbgrid]

Funziona anche esptool: l'immagine di fabbrica si scrive all'offset 0x0.

⚠️ Questo riguarda la vostra build YAML, non l'immagine già pronta. Il componente porta una tabella delle partizioni con l'applicazione a 0x20000. Il percorso USB di ESPHome — Manual download → Factory format, e esphome run su una porta seriale — presuppone lo standard 0x10000, quindi una scheda flashata così non avvia nulla di nuovo: una scheda vuota non si avvia, e una scheda con un'immagine più vecchia continua in silenzio a eseguire quella vecchia.

Per una prima installazione via USB, usate l'immagine di fabbrica pronta dalla pagina delle release — è già unita con gli offset reali e si scrive a 0x0 — oppure esptool con gli offset del vostro flasher_args.json di build. Quando l'hub è in rete, installate le vostre build over-the-air: esphome run con l'hub raggiungibile, oppure Install → Wirelessly. Over-the-air viene inviata solo l'applicazione e il dispositivo la colloca usando la propria tabella delle partizioni, quindi l'offset è giusto per costruzione.

Aggiungetelo a Home Assistant

Qui l'ordine conta. Aggiungete prima l'hub nell'integrazione ESPHome — Home Assistant lo avrà già trovato da solo — e solo dopo aggiungete l'integrazione RBgrid.

L'integrazione RBgrid non è nell'elenco predefinito di HACS, quindi cercarla in HACS non trova nulla finché non la aggiungete voi. In HACS, aggiungete https://github.com/rb-amp/rbgrid-ha come repository personalizzato, categoria Integration. Compare in Home Assistant come RBgrid.

  • Un hub espone dodici slot di misura — gli stessi dodici per cui l'hub conserva lo storico. Il nome di ogni slot c'è fin dall'inizio; il resto delle entità di uno slot compare quando assegnate un punto, quindi dopo l'adozione vedete dodici nomi e non dodici dispositivi di sensori vuoti.
  • Se liberate uno slot e lo assegnate a un punto diverso, i totali cumulativi di quello slot proseguono da dove erano, quindi le statistiche di Home Assistant possono mostrare un salto al cambio. La serie per punto che l'integrazione importa è la vista pulita.
  • Una sola valuta ovunque: qualunque sia la valuta della vostra tariffa, ogni entità monetaria è in quella.
  • Le entità energia vanno direttamente nella dashboard Energia — sono del tipo cumulativo che si aspetta, quindi non c'è nulla da templare e nessun utility_meter da costruire.

E il denaro è quello dell'hub, non il calcolo di Home Assistant: scarica il prezzo del giorno prima per la vostra zona, applica il vostro contratto e prezza ogni periodo di 15 minuti al prezzo proprio di quel periodo — come su un hub autonomo. Cosa significa per i vostri costi

Licenza

Il componente ESPHome e l'integrazione Home Assistant sono MIT. Il firmware autonomo dell'hub è pubblicato sotto PolyForm Noncommercial e quella licenza non si applica qui: questi due pacchetti sono MIT di per sé.