Zum Inhalt

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

  1. Öffne in OpenDTU-OnBattery Einstellungen → Stromzähler und schalte Aktiviere Stromzähler ein.
  2. Wähle als Stromzählertyp HTTP(S) + JSON.
  3. Trag die Werte aus der Tabelle ein.
  4. Prüfe die Eingaben unter Konfiguration testen mit HTTP(S)-Anfrage(n) senden und Antwort(en) verarbeiten — OpenDTU-OnBattery zeigt dann die gelesene Leistung.
  5. 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.local lö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.