Mit dem Solarwatt Manager Flex steuerst du dein lokales Energiesystem, doch die Datenübernahme in Home Assistant erfordert etwas Handarbeit. Über die lokale REST-Schnittstelle lassen sich Messwerte für Netzeinspeisung, Netzbezug und Batteriespeicher direkt abgreifen. Diese Anleitung zeigt dir, wie du die Endpunkte abfragst und per YAML sauber als Entität in Home Assistant anlegst.
Das brauchst du
- Home Assistant mit Zugriff auf die Datei
configuration.yaml - Einen Solarwatt Manager Flex im lokalen Netzwerk (idealerweise mit fester IP-Adresse)
1. Datenpunkte im Netzwerk ermitteln
Der Solarwatt Manager Flex stellt eine lokale Schnittstelle bereit. Öffne deinen Webbrowser und rufe die Adresse http://<IP-DEINES-MANAGERS>/rest/items auf, um die Liste aller gemeldeten Datenpunkte im JSON-Format einzusehen.
Suche im JSON nach den Bezeichnungen deiner Komponenten (zum Beispiel nach batteryStateOfCharge, harmonized_net_power_in oder harmonized_net_power_out). Die einzelnen Datenpunkte lassen sich anschließend gezielt über ihre jeweilige URL abfragen.
2. REST-Sensoren in configuration.yaml eintragen
Trage die gewünschten Sensoren in deine Konfiguration ein. Der direkte Abruf einzelner Datenpunkte verhindert Fehler, die bei festen Array-Nummern entstehen, wenn sich die Liste der Geräte ändert. Da die Rohdaten häufig Zeitstempel und Einheiten im Text enthalten (wie 1729607445000|8.33 W), zerlegst du den String über split oder trim in eine reine Zahl.
Füge den folgenden Block in deine configuration.yaml ein und passe die IP-Adresse 192.168.1.176 sowie die IDs deiner Komponenten an:
sensor:
- platform: rest
resource: "http://192.168.1.176/rest/items/solarwattBattery_batteryflex_BatteryFlex_0BC333_batteryChannelGroup_batteryStateOfCharge"
name: "Solarwatt - Batterieladestand"
unique_id: "intern.solarwatt.battery.soc"
device_class: battery
state_class: measurement
unit_of_measurement: "%"
value_template: "{{ float(value_json.state) }}"
- platform: rest
resource: "http://192.168.1.176/rest/items/kiwigrid_location_standard_f3383059f84f_harmonized_power_in"
name: "Solarwatt - Netzbezug Leistung"
unique_id: "intern.solarwatt.net.power.in"
device_class: power
state_class: measurement
unit_of_measurement: "W"
value_template: "{{ float(value_json.state.split('|')[1].split(' ')[0]) }}"
- platform: rest
resource: "http://192.168.1.176/rest/items/kiwigrid_location_standard_f3383059f84f_harmonized_power_out"
name: "Solarwatt - Netzeinspeisung Leistung"
unique_id: "intern.solarwatt.net.power.out"
device_class: power
state_class: measurement
unit_of_measurement: "W"
value_template: "{{ float(value_json.state.split('|')[1].split(' ')[0]) }}"3. Konfiguration prüfen und neu laden
Prüfe die Konfiguration unter Entwicklerwerkzeuge > YAML > Konfiguration prüfen. Lade anschließend den Bereich REST-Entitäten neu oder starte Home Assistant neu, damit die Sensoren initialisiert werden.
4. Optional: Integralsensor für Energiewerte
Liefert dein Endpunkt lediglich die aktuelle Leistung in Watt, kannst du daraus über einen Helfer fortlaufende Verbrauchswerte berechnen.
Gehe zu Einstellungen > Geräte & Dienste > Helfer > Helfer erstellen und wähle Riemannsummenintegralsensor. Wähle als Eingangssensor deine Netzeinspeisung oder den Netzbezug, nutze als Integrationsmethode die Linke Riemannsche Summe und stelle das Metrik-Präfix auf k (Kilo) sowie die Zeiteinheit auf Stunden.
Funktioniert es?
Öffne Entwicklerwerkzeuge > Zustände und filtere nach sensor.solarwatt. Die neuen Sensoren müssen einen numerischen Wert für Ladestand und Leistungswerte anzeigen. Die Werte aktualisieren sich im Abfrageintervall der REST-Integration.
Wenn es nicht klappt
- Entität zeigt „unknown“: Das Format im Feld
stateweicht ab. Rufe den REST-Link direkt im Browser auf und prüfe, ob der String ein Trennzeichen wie|enthält oder lediglich mit der Einheit abschließt. Passe dasvalue_templateentsprechend an. - Fehlermeldung „Authorization required“: Bei bestimmten Firmware-Versionen verlangt die Weboberfläche Zugangsdaten. Prüfe das Gerätepasswort des Energiemanagers (oft auf einem Aufkleber am Gerät oder im Schaltschrank).
- Sensor liefert unerwartete Werte: Kontrolliere die Einheiten und die Typen in der Konfiguration sowie die Trennzeichen der Rohdaten.
Mit den sauberen Messwerten im System kannst du nun Wallboxen oder Haushaltsgeräte gezielt bei PV-Überschuss automatisieren.
Quellen: Forum: Simon42 – Forum, community.simon42.com, community.simon42.com, community.home-assistant.io