Hardy Barth Wallbox per REST API in Home Assistant

Für die Wallbox cPµ1 von Hardy Barth gibt es in Home Assistant keine vorgefertigte Integration – also keine fertige Schnittstelle zur automatischen Erkennung. Über das integrierte eCB1-Smartmeter stellt die Ladestation jedoch eine lokale REST API bereit, die Messwerte im JSON-Format ausgibt. In dieser Anleitung richtest du die passenden Sensoren über die Basiskonfiguration manuell ein, um Leistungswerte zu visualisieren.

Das brauchst du

Eine installierte Home-Assistant-Instanz
Eine Hardy Barth Wallbox (cPµ1) mit eCB1-Steuerung im selben lokalen Netzwerk
Einen Text-Editor für die Konfigurationsdateien

1. Endpunkt im Netzwerk prüfen

Die Wallbox stellt ihre Messdaten auf dem Controller unter einem HTTP-Pfad bereit. Standardmäßig lautet die Adresse für die Socket-Messung http://ecb1.local/api/v1/meters/1. Falls dein Router lokale Hostnamen nicht auflöst, ersetzt du ecb1.local durch die feste IP-Adresse der Wallbox. Die Rückmeldung liefert ein verschachteltes JSON-Objekt mit OBIS-Kennzahlen, darunter lgwb (Saldo Active power+/- bzw. aktuelle Leistung +/-) oder 1-0:1.4.0 (Active power+ bzw. aktuelle Leistung +).

2. REST-Sensoren in die Konfiguration eintragen

Da keine Klick-Oberfläche für benutzerdefinierte REST-Abfragen existiert, trägst du die Definition direkt in deine Systemdatei ein. Wir nutzen die rest:-Plattform, damit Home Assistant mit nur einer einzigen HTTP-Abfrage alle benötigten Werte gleichzeitig abholt.

Füge den folgenden Block in deine configuration.yaml ein:

rest:
  - resource: "http://ecb1.local/api/v1/meters/1"
    sensor:
      - name: "aktuelle Leistung +/-"
        value_template: "{{ value_json['meter']['data']['lgwb'] }}"
        unit_of_measurement: "W"
      - name: "aktuelle Leistung +"
        value_template: "{{ value_json['meter']['data']['1-0:1.4.0'] }}"
        unit_of_measurement: "W"

rest:
  - resource: "http://ecb1.local/api/v1/meters/1"
    sensor:
      - name: "aktuelle Leistung +/-"
        value_template: "{{ value_json['meter']['data']['lgwb'] }}"
        unit_of_measurement: "W"
      - name: "aktuelle Leistung +"
        value_template: "{{ value_json['meter']['data']['1-0:1.4.0'] }}"
        unit_of_measurement: "W"

Da die OBIS-Kennzahlen Sonderzeichen wie Punkte und Bindestriche enthalten, muss der JSON-Pfad zwingend in eckigen Klammern mit einfachen Anführungszeichen geschrieben werden (value_json['meter']['data']['1-0:1.4.0']).

Siehe auch Philips Luftreiniger / Air Purifier in Home Assistant einbinden

3. Konfiguration anwenden

Nachdem du die Datei gespeichert hast, übernimmst du die Änderungen in Home Assistant, damit die neuen Sensoren geladen werden.

Funktioniert es?

Navigiere zu Einstellungen > Geräte & Dienste > Entitäten. Eine Entität ist ein einzelner Datenpunkt mit einem Status in Home Assistant. Suche nach den neu erstellten Leistungssensoren. Wenn die Ladestation aktiv antwortet, siehst du dort sofort die aktuellen Messwerte inklusive Einheit.

Wenn es nicht klappt

Entität bleibt „nicht verfügbar“: Prüfe im Webbrowser, ob die Adresse http://ecb1.local/api/v1/meters/1 erreichbar ist. Wenn nicht, tausche ecb1.local gegen die feste IP-Adresse deines eCB1-Controllers aus.
Fehlermeldung beim YAML-Prüfen: Achte auf exakte Einrückungen im YAML-Code und stelle sicher, dass rest: auf oberster Ebene steht und nicht unter sensor: eingerückt wurde.
Template-Fehler im Log: Hast du die eckige Klammerung value_json['meter']['data']['...'] verwendet? Die Punkt-Notation (wie value_json.meter.data.1-0:1.4.0) schlägt wegen der Bindestriche fehl.

Mit den fertigen Sensoren bindest du die Messwerte deiner Wallbox unkompliziert in Home Assistant ein.

Quellen: Forum: Simon42 – Forum, community.simon42.com, cloudapp.dev

Hardy Barth Wallbox: Sensoren per REST API in Home Assistant einbinden