RBgrid

Anleitungen ·

RBgrid in Home Assistant installieren: die Anleitung, einschließlich der drei Fehlerfälle

  • Getestet mit Firmware v1.2.1
  • Erste Schritte

Sie haben eine Home Assistant, Sie haben gehört, dass RBgrid darin als ESPHome-Gerät laufen kann, und Sie haben das Naheliegende getan: HACS geöffnet und danach gesucht.

Nichts kam zurück. Das ist korrekt und sagt nichts darüber, ob die Integration existiert.

RBgrid steht nicht in der Standardliste von HACS. Solange Sie es nicht selbst hinzufügen, findet die Suche nichts — das Suchergebnis, das Sie gerade bekommen haben, ist also kein Beleg für das Fehlen, sondern der erwartbare erste Schritt auf einem Weg, den Ihnen niemand gezeigt hat. Dieser Artikel ist dieser Weg, mit den Stellen, an denen er schiefgeht, benannt statt verborgen.

Ist schon etwas schiefgegangen? Die Fehler sind in einer Tabelle am Ende gesammelt — Symptom, Ursache und was zu tun ist.

Was Sie vor dem Start brauchen

Board ein ESP32 mit 16 MB Flash und PSRAM — ein WROVER oder ein ESP32-S3 auf dem Modul N16R8. Dasselbe Board wie für die eigenständige Firmware.
Modules Ihre rbAmp-Module und Zangen, wie gewohnt.
Home Assistant 2026.1 oder neuer, mit HACS.
ESPHome nur wenn Sie die Komponente in Ihre eigene YAML-Konfiguration einbauen: 2026.5.3 oder neuer auf dem ESP-IDF-Framework. Das Flashen des fertigen Images braucht hier nichts.

⚠️ Die Home-Assistant-Version ist tragend, keine Empfehlung. Das RBgrid-Panel stützt sich auf Action-Responses, die ältere Versionen nicht haben. Auf einer älteren Home Assistant funktioniert das Panel schlicht nicht — und Sie sehen etwas, das wie eine kaputte Integration aussieht und nicht wie eine alte Installation. Ist das Panel leer, prüfen Sie das zuerst.

1. Den Hub flashen

Laden Sie das Factory-Image für Ihr Board von den Releases von rb-amp/rbgrid-esphome herunter — es gibt zwei, eins für den ESP32-WROVER und eins für den ESP32-S3. Öffnen Sie dann web.esphome.io in Chrome oder Edge, wählen Sie Connect, den seriellen Port Ihres Boards, Install, und die heruntergeladene Datei.

Home Assistant fragt Sie hier nicht nach einem API-Verschlüsselungsschlüssel: Das fertige Image wird ohne einen gebaut, daher wird das Gerät mit einer einzigen Bestätigung hinzugefügt. Einen Schlüssel fragt es nur ab, wenn Sie Ihre eigene Konfiguration mit einem gebaut haben.

Richten Sie das WLAN direkt nach dem Flashen ein, über dasselbe USB-Kabel, wenn der Installer es anbietet. Dann braucht der Hub seinen Setup-Zugangspunkt gar nicht erst. Gehen Sie stattdessen über den Zugangspunkt, ändern Sie dessen Passwort einmal, sobald der Hub übernommen ist.

esptool funktioniert auch: Das Factory-Image wird bei Offset 0x0 geschrieben.

⚠️ Das betrifft Ihren eigenen YAML-Build, nicht das fertige Image. Die Komponente bringt eine Partitionstabelle mit, in der die Anwendung bei 0x20000 liegt, während die eigenen USB-Werkzeuge von ESPHome den Standardwert 0x10000 annehmen. Wird über USB mit den eigenen Werkzeugen von ESPHome geflasht — esphome run auf einen seriellen Port oder Manual download → Factory format — landet Ihr Build an der falschen Adresse, und das Board startet nichts Neues: Ein leeres Board kommt nicht hoch, und ein Board mit älterem Image läuft still mit dem alten weiter.

Für eine Erstinstallation über USB verwenden Sie das fertige Factory-Image von der Releases-Seite (es ist mit den echten Offsets zusammengeführt und geht nach 0x0), oder esptool mit den Offsets aus der eigenen flasher_args.json Ihres Builds. Sobald der Hub im Netzwerk ist, spielen Sie Ihre eigenen Builds über die Luft auf — esphome run, wenn der Hub erreichbar ist, oder Install → Wirelessly. Über die Luft wird nur die Anwendung gesendet, und das Gerät legt sie mit seiner eigenen Partitionstabelle ab, daher stimmt der Offset per Konstruktion.

Das ist der Schritt, der still fehlschlägt. Sie sind bereits im ESPHome-Werkzeug, es bietet Ihnen einen Download im Factory-Format an, die Datei sieht richtig aus, das Flashen gelingt — und danach tut das Board nichts. Es gibt keinen Fehler, nach dem man suchen könnte, deshalb wird es meist als tote Hardware gelesen.

Oder bauen Sie es in Ihre eigene Konfiguration ein

Wenn Sie Ihre ESPHome-Geräte bereits als YAML führen, fügen Sie die Komponente als externe Quelle hinzu, statt ein Factory-Image zu flashen:

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]

2. RBgrid in HACS als custom repository hinzufügen

Das ist der Schritt, für den das Suchergebnis oben in diesem Artikel stand, und er besteht aus drei Aktionen, nicht aus einer:

  1. Fügen Sie in HACS https://github.com/rb-amp/rbgrid-ha als custom repository hinzu, Kategorie Integration;
  2. installieren Sie RBgrid daraus;
  3. starten Sie Home Assistant neu.

Der Neustart ist nicht optional und kein Aberglaube — eine neu installierte Integration wird beim Start geladen.

3. Zuerst ESPHome einrichten, dann RBgrid

Nach dem Neustart sollten unter Settings → Devices & services zwei Karten erscheinen: ESPHome (das Gerät selbst) und RBgrid (diese Integration).

Richten Sie zuerst die ESPHome-Karte ein. Die RBgrid-Karte wartet auf sie, weil RBgrid mit einem Gerät spricht, das Home Assistant bereits kennt; in umgekehrter Reihenfolge hat sie nichts, woran sie sich anhängen könnte.

Drücken Sie dann auf der RBgrid-Karte Configure. Unterwegs bietet ESPHome seinen eigenen Dialog Name and assign an, der den Hub und seine Steckplätze auflistet — drücken Sie Skip; die Namen kommen von den Punkten selbst.

Der letzte Schritt hat zwei Kontrollkästchen, die Sie lesen statt wegzuklicken sollten:

  • Configure the Energy dashboard with this hub — standardmäßig an, wenn Ihr Energie-Dashboard leer ist. Damit kommen die Entitäten des Hubs auf das Dashboard.
  • Set the hub's tariff plan to Home Assistant's currency — lassen Sie es an. Hub und Home Assistant müssen in einer Währung rechnen, weil nichts zwischen ihnen umrechnet: Das Energie-Dashboard beschriftet die Zahlen des Hubs einfach mit seiner eigenen Währung. Wenn die beiden je abweichen, sagt das der Tab Tariff im Panel und bietet eine Korrektur mit einem Klick an.

Wenn das fertig ist, steht das Panel RBgrid Hub in Ihrer Seitenleiste (auch unter /rbgrid), der Import der Statistiken beginnt innerhalb einer Minute, und das Energie-Dashboard zeigt den Hub nach der nächsten vollen Stunde, weil diese Statistiken ein paar Minuten nach jeder vollen Stunde geschrieben werden.

⚠️ Gar keine RBgrid-Karte? mDNS erreicht Home Assistant nicht in jedem Netzwerk — ein Docker-Bridge-Netzwerk ist der häufige Fall. Verwenden Sie stattdessen Add integration → RBgrid: Das listet die Hubs auf, die die ESPHome-Integration bereits hat. Dasselbe gilt nach dem Entfernen eines Hubs: Home Assistant findet ihn nicht von selbst wieder, also starten Sie entweder neu oder nutzen Add integration.

4. Was Sie nach der Übernahme sehen und warum es spärlich wirkt

Ein Punkt ist eine benannte Messung — ein Stromkreis, den Sie im RBgrid-Panel definieren, gebunden an eine Zange auf einem Modulkanal. Ein Steckplatz ist der Platz, den ein Punkt in Home Assistant einnimmt. Ein Hub stellt zwölf Messsteckplätze bereit — dieselben zwölf, für die der Hub den Verlauf führt. Der Name jedes Steckplatzes ist von Anfang an da; der Rest der Entitäten eines Steckplatzes erscheint, sobald ein Punkt daran gebunden ist, was Sie auf dem Reiter Points des Panels tun.

Nach der Übernahme sehen Sie also zwölf Namen, nicht zwölf Geräte voller leerer Sensoren. Das ist die dritte Sache, die Leute als Fehler lesen: eine Integration, die fast nichts hinzugefügt hat. Sie hat die Struktur hinzugefügt; die Entitäten kommen, wenn Sie den Steckplätzen Arbeit geben.

Zwei Folgen, die Sie kennen sollten, bevor Sie anfangen, Dinge umzuordnen:

  • Wenn Sie einen Steckplatz freigeben und einem anderen Punkt geben, laufen die Gesamtzählerstände dieses Steckplatzes von dort weiter, wo sie waren — daher kann die Statistik von Home Assistant an der Umschaltstelle einen Sprung zeigen. Die Zeitreihe pro Punkt, die die Integration importiert, ist die saubere Ansicht davon.
  • Eine Währung durchgehend. Egal, in welcher Währung Ihr Tarif ist, jede Geldentität ist in ihr.

Die Energie-Entitäten gehen direkt auf das Energie-Dashboard: Sie sind die kumulativen Typen, die es erwartet, daher ist dazwischen kein Template-Sensor oder utility_meter nötig.

Die vier Fehler auf einen Blick

Was Sie sehen Was es ist Was zu tun ist
HACS-Suche liefert nichts erwartet — RBgrid steht nicht in der Standardliste als custom repository hinzufügen, installieren, neu starten (Schritt 2)
Keine RBgrid-Karte erscheint mDNS erreicht Home Assistant nicht — oft ein Docker-Bridge-Netzwerk Add integration → RBgrid, das die Hubs auflistet, die ESPHome bereits hat (Schritt 3)
Das Board tut nach einem erfolgreichen Flash nichts Ihr eigener Build ging über USB, wo ESPHome 0x10000 annimmt und diese Partitionstabelle die Anwendung bei 0x20000 ablegt das fertige Factory-Image flashen oder esptool mit den Offsets aus Ihrer flasher_args.json; spätere Builds über die Luft aufspielen (Schritt 1)
Panel ist leer, oder die Integration wirkt kaputt Home Assistant älter als 2026.1: das Panel braucht Action-Responses Home Assistant aktualisieren
Nach der Übernahme fast keine Entitäten zwölf Steckplatznamen ohne gebundene Punkte Punkte auf dem Reiter Points des Panels binden; die Entitäten folgen (Schritt 4)

Was das nicht tut

  • Es macht den Hub nicht abhängig von Home Assistant. Das ist einer von zwei Wegen, denselben Messkern zu betreiben; der andere ist die eigene App des Hubs. Ein späterer Wechsel bedeutet Neu-Flashen und den Verlauf wieder bei null zu beginnen, daher lohnt es sich, bewusst zu wählen.
  • Es schaltet nichts ein oder aus. Der Hub misst und bepreist; Automationen entscheiden.
  • Es gibt Home Assistant keine Auflösung im 15-Minuten-Takt. Die Perioden des Hubs sind die des Hubs; was in die Statistiken von Home Assistant gelangt, ist stündlich.

Wo Sie mehr lesen