OpenDTU-OnBattery¶
OpenDTU-OnBattery regelt deinen Wechselrichter nach der Leistung am Netzanschluss — zum Beispiel für eine Nulleinspeisung mit dem Dynamic Power Limiter. Diese Leistung holt es sich direkt vom WattWächter Plus: per HTTP aus der REST-API, ohne MQTT-Broker und ohne zusätzlichen Zähler im Verteiler.
OpenDTU oder OpenDTU-OnBattery?
Das ursprüngliche OpenDTU liest nur den Wechselrichter aus und hat keinen Eingang für einen Stromzähler. Diese Anleitung gilt für den Ableger OpenDTU-OnBattery.
Das Wichtigste¶
| URL | http://192.168.178.106/api/v1/history/latest (IP-Adresse deines WattWächters) |
| JSON-Pfad | 16.7.0/value |
| Einheit | W |
| Vorzeichen | positiv = Bezug, negativ = Einspeisung — so erwartet es OpenDTU-OnBattery, nicht umkehren |
Voraussetzungen¶
- Dein Stromzähler liefert die aktuelle Leistung (
16.7.0). Ob das so ist, zeigt das Dashboard unter Alle Zählerwerte. Fehlt der Wert, muss der Zähler meist erst per PIN freigeschaltet werden — siehe Vorbereitung. - OpenDTU-OnBattery und WattWächter sind im selben Netzwerk.
- Der WattWächter hat eine feste IP-Adresse (DHCP-Reservierung im Router oder feste IP in den Einstellungen). Wie du die aktuelle IP findest, steht in den FAQs.
Der Endpunkt¶
GET /api/v1/history/latest liefert bei jedem Aufruf die zuletzt vom Zähler empfangenen Werte:
curl -s http://192.168.178.106/api/v1/history/latest
{
"timestamp": 1791403049,
"datetime": "2026-10-07T21:57:29",
"telegram": "full",
"1.8.0": { "value": 12345.678, "unit": "kWh", "name": "Bezug" },
"2.8.0": { "value": 42.123, "unit": "kWh", "name": "Einspeisung" },
"16.7.0": { "value": -812.400, "unit": "W", "name": "Leistung" }
}
Die aktuelle Leistung steht unter 16.7.0 im Feld value. OpenDTU-OnBattery trennt die Ebenen im JSON-Pfad mit einem Schrägstrich — die Punkte gehören zum Namen:
16.7.0/value
Der Wert ist in Watt, positiv bei Bezug aus dem Netz und negativ bei Einspeisung.
In OpenDTU-OnBattery einrichten¶
- Öffne in OpenDTU-OnBattery Einstellungen → Stromzähler und schalte Aktiviere Stromzähler ein.
- Wähle als Stromzählertyp
HTTP(S) + JSON. - Trag die Werte aus der Tabelle ein.
- Prüfe die Eingaben unter Konfiguration testen mit HTTP(S)-Anfrage(n) senden und Antwort(en) verarbeiten — OpenDTU-OnBattery zeigt dann die gelesene Leistung.
- Speichern. Die Leistung erscheint anschließend in der Live-Ansicht.
| Feld | Eintrag |
|---|---|
| Abfrageintervall | 2 Sekunden |
| Individuelle HTTP(S) Anfragen pro Wert | aus |
| URL (Wert 1) | http://192.168.178.106/api/v1/history/latest |
| Authentifizierungsverfahren | Ohne |
| HTTP Header - Name / Wert | leer — außer mit API-Sicherheit |
| Zeitüberschreitung | 1000 Millisekunden |
| JSON-Pfad | 16.7.0/value |
| Einheit | W |
| Vorzeichen umkehren | aus |
Wert 2 und Wert 3 bleiben deaktiviert: 16.7.0 ist bereits die Summe aller Phasen.
Abfrageintervall
Der WattWächter beantwortet geräteweit höchstens 25 Anfragen in 10 Sekunden (siehe REST-API → Rate Limit). Mit 2 Sekunden bleibt genug Luft für die Weboberfläche und andere Abfragen.
Danach richtest du in OpenDTU-OnBattery den Dynamic Power Limiter ein — er nutzt den Stromzähler als Regelgröße.
Mit API-Sicherheit¶
Ab Werk ist die REST-API ohne Token erreichbar. Hast du unter Einstellungen → API-Sicherheit die Authentifizierung eingeschaltet, gib OpenDTU-OnBattery den READ-Token als HTTP-Header mit:
| Feld | Eintrag |
|---|---|
| Authentifizierungsverfahren | Ohne |
| HTTP Header - Name | X-Api-Token |
| HTTP Header - Wert | dein READ-Token |
Alternative: MQTT¶
Läuft bei dir ohnehin ein MQTT-Broker, kann OpenDTU-OnBattery die Leistung auch dort abholen: Stromzählertyp MQTT, als Topic WattWaechter/wattwaechter-XXXXXXXXXXXX/16.7.0, der JSON-Pfad bleibt leer. Stell dafür am WattWächter das Sendeintervall auf wenige Sekunden — ab Werk sendet er nur alle 60 Sekunden, das ist für eine Regelung zu träge.
Fehlerbehebung¶
„Unable to access JSON key '16.7.0'“
Die Antwort enthält keine aktuelle Leistung. Prüf im Dashboard unter Alle Zählerwerte, ob der Zähler 16.7.0 liefert — oft fehlt nur die Freischaltung per PIN. Achte außerdem auf die Schreibweise des Pfads: 16.7.0/value, mit Schrägstrich und ohne 1-0: davor.
HTTP 401
Am WattWächter ist die API-Sicherheit eingeschaltet. Trag den READ-Token als Header ein, siehe Mit API-Sicherheit.
HTTP 429
Zu viele Anfragen in kurzer Zeit. Erhöh das Abfrageintervall und prüf, ob noch andere Systeme den WattWächter im Sekundentakt abfragen.
Keine Verbindung oder Zeitüberschreitung
- Hat der WattWächter eine neue IP-Adresse bekommen? Vergib im Router eine DHCP-Reservierung.
- Den Namen
wattwaechter-XXXXXXXXXXXX.locallöst OpenDTU-OnBattery nur auf, wenn dort in den Netzwerk-Einstellungen mDNS eingeschaltet ist. Mit der IP-Adresse bist du davon unabhängig.
Der Wechselrichter regelt in die falsche Richtung
Vorzeichen umkehren muss aus sein: Der WattWächter liefert Bezug positiv und Einspeisung negativ, genau wie OpenDTU-OnBattery es erwartet.