In Home Assistant betreiben
Wenn Home Assistant ohnehin Ihre Anlaufstelle ist, kann RBgrid dort statt daneben laufen: derselbe Messkern, als ESPHome-Gerät geflasht, mit jedem Stromkreis im Energie-Dashboard und ohne zweite App, die Sie pflegen müssen.
Was Sie brauchen
Ein ESP32 mit 16 MB Flash und PSRAM — ein WROVER oder ein S3 auf dem N16R8-Modul — dieselbe Platine wie bei der eigenständigen Firmware, plus Ihre rbAmp-Module. Softwareseitig: Home Assistant 2026.1 oder neuer mit HACS und, wenn Sie es in Ihre eigene Konfiguration einbauen, ESPHome 2026.5.3 oder neuer auf dem ESP-IDF-Framework.
Hub flashen
Laden Sie das Werks-Image für Ihre Platine von der Release-Seite des Pakets herunter, öffnen Sie dann web.esphome.io in Chrome oder Edge, wählen Sie Connect, wählen Sie den seriellen Port Ihrer Platine, wählen Sie Install und die heruntergeladene Datei. Es gibt zwei Images: eines für den ESP32-WROVER, eines für den ESP32-S3.
Richten Sie das WLAN direkt nach dem Flashen über dasselbe USB-Kabel ein, wenn der Installer es anbietet — dann braucht der Hub seinen Setup-Zugangspunkt gar nicht erst. Wenn Sie den Zugangspunkt doch nutzen, ändern Sie sein Passwort, sobald der Hub übernommen ist.
Oder in Ihre eigene Konfiguration einbauen
Wenn Sie Ihre ESPHome-Geräte bereits als YAML führen, fügen Sie die Komponente als externe Quelle hinzu, statt ein Werks-Image zu flashen:
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]esptool funktioniert ebenfalls: Das Werks-Image wird bei Offset 0x0 geschrieben.
⚠️ Das betrifft Ihren eigenen YAML-Build, nicht das fertige Image. Die Komponente bringt eine Partitionstabelle mit der Anwendung bei 0x20000 mit. Der USB-Weg von ESPHome — Manual download → Factory format und esphome run an einen seriellen Port — geht vom Standard 0x10000 aus, sodass eine so geflashte Platine nichts Neues startet: Eine leere Platine startet nicht, und eine Platine mit einem älteren Image läuft still weiter mit dem alten.
Für eine Erstinstallation über USB verwenden Sie das fertige Werks-Image von der Releases-Seite — es ist mit den echten Offsets zusammengeführt und wird bei 0x0 geschrieben — oder esptool mit den Offsets aus der eigenen flasher_args.json Ihres Builds. Sobald der Hub im Netzwerk ist, installieren Sie Ihre eigenen Builds über die Luft: 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, sodass der Offset zwangsläufig stimmt.
In Home Assistant hinzufügen
Die Reihenfolge ist hier wichtig. Fügen Sie den Hub zuerst in der ESPHome-Integration hinzu — Home Assistant hat ihn selbst gefunden — und erst danach die RBgrid-Integration.
Die RBgrid-Integration ist nicht in der HACS-Standardliste; wenn Sie in HACS danach suchen, finden Sie nichts, bis Sie sie selbst hinzugefügt haben. Fügen Sie in HACS https://github.com/rb-amp/rbgrid-ha als benutzerdefiniertes Repository hinzu, Kategorie Integration. Es erscheint in Home Assistant als RBgrid.
- Ein Hub stellt zwölf Messplätze bereit — dieselben zwölf, für die der Hub den Verlauf speichert. Der Name jedes Platzes ist von Anfang an da; die übrigen Entitäten eines Platzes erscheinen, sobald Sie ihm einen Punkt zuweisen. Nach der Übernahme sehen Sie also zwölf Namen statt zwölf Geräte voller leerer Sensoren.
- Wenn Sie einen Platz freigeben und einem anderen Punkt geben, laufen die Gesamtwerte dieses Platzes von dort weiter, wo sie waren; die Statistiken von Home Assistant können deshalb bei der Umstellung einen Sprung zeigen. Die Zeitreihe je Punkt, die die Integration importiert, ist die saubere Ansicht davon.
- Eine Währung durchgängig: Was immer Ihr Tarif ist, jede Geldentität ist darin.
- Die Energie-Entitäten gehen direkt ins Energie-Dashboard — sie sind vom Typ kumulativ, den es erwartet, also gibt es nichts zu templaten und kein
utility_meterzu bauen.
Und das Geld ist die eigene Rechnung des Hubs, nicht die von Home Assistant: Er holt den Day-Ahead-Preis für Ihre Zone, wendet Ihren Vertrag an und bepreist jede 15-Minuten-Periode mit deren eigenem Preis — wie auf einem eigenständigen Hub. Was das für Ihre Kosten bedeutet
Lizenz
Die ESPHome-Komponente und die Home-Assistant-Integration sind MIT. Die eigenständige Hub-Firmware wird unter PolyForm Noncommercial veröffentlicht, und diese Lizenz gilt hier nicht: Diese beiden Pakete sind MIT aus eigenem Recht.