Installare RBgrid dentro Home Assistant: la procedura passo passo, inclusi i tre modi in cui va storto

Ha una Home Assistant, ha sentito dire che RBgrid può girare al suo interno come dispositivo ESPHome, e ha fatto la cosa più ovvia: ha aperto HACS e ha cercato.

Non è uscito niente. È normale, e non dice nulla sul fatto che l'integrazione esista.

RBgrid non è nell'elenco predefinito di HACS. Finché non lo aggiunge lei stesso, la ricerca non trova nulla — quindi il risultato vuoto non è una prova di assenza, è il primo passo previsto di un percorso di cui nessuno le ha parlato. Questo articolo è quel percorso, con i punti in cui va storto nominati invece che nascosti.

Qualcosa è già andato storto? I guasti sono raccolti in una tabella alla fine — sintomo, causa, cosa fare.

Cosa serve prima di iniziare

⚠️ La versione di Home Assistant è un requisito, non una raccomandazione. Il pannello RBgrid si basa sulle risposte delle azioni, che le versioni più vecchie non hanno. Su una Home Assistant più vecchia il pannello semplicemente non funziona — e ciò che vedrà sembra un'integrazione guasta, non un'installazione vecchia. Se il pannello è vuoto, controlli prima questo.

1. Caricare il firmware sull'hub

Scarichi l'immagine di fabbrica per la sua scheda dalle release di rb-amp/rbgrid-esphome — ce ne sono due, una per ESP32-WROVER e una per ESP32-S3. Poi apra web.esphome.io con Chrome o Edge, scelga Connect, selezioni la porta seriale della scheda, scelga Install e indichi il file scaricato.

Home Assistant qui non le chiede una chiave di cifratura API: l'immagine pronta è costruita senza, quindi il dispositivo viene aggiunto con una sola conferma. La chiave viene richiesta solo se ha costruito una sua configurazione con una chiave.

Imposti il Wi-Fi subito dopo il flash, con lo stesso cavo USB, quando l'installer lo propone. Così l'hub non avrà mai bisogno del suo punto di accesso di configurazione. Se invece passa dal punto di accesso, cambi la password una volta che l'hub è stato adottato.

esptool funziona anche: l'immagine di fabbrica viene scritta all'offset 0x0.

⚠️ Questo riguarda la sua build YAML, non l'immagine pronta. Il componente porta una tabella delle partizioni con l'applicazione all'offset 0x20000, mentre gli strumenti USB di ESPHome presuppongono il valore standard 0x10000. Se flasha via USB con gli strumenti di ESPHome — esphome run su una porta seriale, oppure Manual download → Factory format — la sua build finisce all'indirizzo sbagliato e la scheda non avvia nulla di nuovo: una scheda vuota non si avvia, e una scheda con un'immagine precedente continua silenziosamente a eseguire la vecchia.

Per una prima installazione via USB, usi l'immagine di fabbrica pronta dalla pagina delle release (è già unita con gli offset reali e va scritta su 0x0), oppure esptool con gli offset dal flasher_args.json della sua build. Quando l'hub è in rete, carichi le sue build via aggiornamento OTA — esphome run con l'hub raggiungibile, oppure Install → Wirelessly. Nell'OTA viene inviata solo l'applicazione e il dispositivo la colloca usando la propria tabella delle partizioni, quindi l'offset è giusto per costruzione.

Questo è il passaggio che fallisce in silenzio. È già dentro lo strumento di ESPHome, questo le propone un download in formato factory, il file sembra giusto, il flash riesce — e poi la scheda non fa nulla. Non c'è un errore da cercare, ed è per questo che di solito si legge come hardware guasto.

Oppure lo costruisca nella sua configurazione

Se tiene già i suoi dispositivi ESPHome come YAML, aggiunga il componente come sorgente esterna invece di flashare un'immagine di fabbrica:

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]

2. Aggiungere RBgrid in HACS come repository personalizzato

Questo è il passaggio per cui, in cima all'articolo, il risultato della ricerca faceva da segnaposto, e sono tre azioni, non una:

1. in HACS, aggiunga https://github.com/rb-amp/rbgrid-ha come repository personalizzato, categoria Integration;
2. installi RBgrid da lì;
3. riavvii Home Assistant.

Il riavvio non è facoltativo e non è una superstizione — un'integrazione appena installata viene caricata all'avvio.

3. Configurare prima ESPHome, poi RBgrid

Dopo il riavvio, Settings → Devices & services dovrebbe mostrare due schede: ESPHome (il dispositivo stesso) e RBgrid (questa integrazione).

Configuri prima quella di ESPHome. La scheda RBgrid attende quella, perché RBgrid comunica con un dispositivo che Home Assistant già conosce; configurando nell'ordine inverso, non ha nulla a cui agganciarsi.

Poi prema Configure sulla scheda RBgrid. Lungo il percorso ESPHome propone la sua finestra Name and assign, che elenca l'hub e i suoi slot — prema Skip; i nomi arrivano dai punti stessi.

L'ultimo passaggio ha due caselle di spunta che conviene leggere invece di cliccarle senza guardare:

• Configure the Energy dashboard with this hub — attiva per impostazione predefinita quando la sua Energy dashboard è vuota. È ciò che mette le entità dell'hub nella dashboard.
• Set the hub's tariff plan to Home Assistant's currency — lasci attiva. L'hub e Home Assistant devono contare nella stessa valuta, perché tra le due non c'è alcuna conversione: la Energy dashboard si limita a etichettare i numeri dell'hub con la propria valuta. Se le due dovessero differire, la scheda Tariff del pannello lo segnala e offre una correzione con un clic.

Al termine, il pannello RBgrid Hub compare nella barra laterale (anche su /rbgrid), l'importazione delle statistiche parte entro un minuto, e la Energy dashboard mostra l'hub dopo la successiva ora piena, perché quelle statistiche vengono scritte un paio di minuti dopo ogni ora.

⚠️ Nessuna scheda RBgrid? mDNS non raggiunge Home Assistant su tutte le reti — una rete bridge di Docker è il caso tipico. Usi invece Add integration → RBgrid: elenca gli hub che l'integrazione ESPHome ha già. Lo stesso vale dopo aver rimosso un hub: Home Assistant non lo riscopre da sola, quindi o la riavvii o usi Add integration.

4. Cosa vede dopo l'adozione, e perché sembra scarno

Un punto è una singola misura con un nome — un circuito che definisce nel pannello RBgrid, collegato a una pinza su un canale del modulo. Uno slot è il posto che quel punto occupa in Home Assistant. Un hub espone dodici slot di misura — gli stessi dodici per cui conserva lo storico. Il nome di ogni slot c'è fin dall'inizio; il resto delle entità di uno slot compare quando a quello slot viene associato un punto, cosa che fa nella scheda Points del pannello.

Quindi dopo l'adozione vede dodici nomi, non dodici dispositivi pieni di sensori vuoti. È il terzo fatto che la gente legge come un guasto: un'integrazione che ha aggiunto quasi nulla. Ha aggiunto la struttura; le entità arrivano man mano che dà agli slot qualcosa da fare.

Due conseguenze da sapere prima di riorganizzare qualcosa:

• Se libera uno slot e lo assegna a un punto diverso, i totali cumulativi di quello slot proseguono da dove erano, quindi le statistiche di Home Assistant possono mostrare un gradino nel punto del cambio. La serie per punto che l'integrazione importa è la vista pulita.
• Una sola valuta ovunque. Qualunque sia la sua tariffa, ogni entità monetaria è nella stessa valuta.

Le entità energetiche finiscono direttamente nella Energy dashboard: sono del tipo cumulativo che essa si aspetta, quindi non serve nel mezzo nessun sensore template né utility_meter.

I quattro guasti, in un solo posto

Cosa non fa

• Non rende l'hub dipendente da Home Assistant. Questo è uno dei due modi di far girare lo stesso nucleo di misura; l'altro è l'app dell'hub stesso. Passare dall'uno all'altro in seguito significa riflashare e ricominciare lo storico da zero, quindi vale la pena sceglierlo con consapevolezza.
• Non accende né spegne nulla. L'hub misura e valorizza; decidono le automazioni.
• Non dà a Home Assistant una risoluzione di 15 minuti. I periodi sono quelli dell'hub; ciò che arriva alle statistiche di Home Assistant è orario.

Per saperne di più

• Esegua RBgrid dentro Home Assistant — il riferimento per questo percorso, incluso ciò che fa il pannello.
• Due modi per far girare RBgrid, e come scegliere — se non è ancora sicuro che questo sia il suo percorso.
• Quick start — prima accensione, il punto di accesso e la sua password.
• Prezzi di mercato (Market prices) — anche su questo percorso funzionano i prezzi day-ahead.