Entworfen & hergestellt in Frankreich 6K Fans auf Facebook · Folgen Sie uns
INTEGRATIONEN7 Min. LesezeitVom Pylon-Monitor-TeamAktualisiert am

Pylontech mit Jeedom, Node-RED, Domoticz und openHAB

Kein Home Assistant? Derselbe JSON-Endpunkt und dieselben MQTT-Topics funktionieren in Jeedom, Node-RED, Domoticz, openHAB und allem, was eine HTTP-Anfrage stellen kann.

Kurz gesagt: Ja, eine Pylontech-Batterie lässt sich mit Jeedom, Node-RED, Domoticz, openHAB oder Grafana auslesen. Pylon-Monitor stellt die Batteriedaten als einfaches JSON unter einer einzigen Adresse in Ihrem Netz bereit, /api.json, und kann sie zusätzlich per MQTT veröffentlichen. Alles, was eine HTTP-Anfrage stellen oder ein MQTT-Topic abonnieren kann, kann sie nutzen, ohne Plugin von uns und ohne Hersteller-SDK.

Ein JSON-Endpunkt für alle Plattformen

Home Assistant bekommt die meiste Aufmerksamkeit und hat einen eigenen Leitfaden. Darunter ist der Mechanismus bewusst einfach: eine HTTP-Adresse, GET /api.json?key=…, mit dem Zugangsschlüssel von der Settings-Seite des Geräts, und als Antwort reines JSON. Jeedom, Node-RED, Domoticz, openHAB, Grafana, ein Python-Skript oder ein Cronjob mit curl lesen genau dieselben Daten.

JSON-API-Antwort eines Pylontech-Überwachungsgeräts mit strukturierten Batteriedaten
Diese eine JSON-Antwort speist alle Anbindungen unten. Am Gerät gibt es nichts Plattformspezifisches.
Anschlussfeld einer Pylontech-Master-Batterie: Das RJ45-Kabel im CONSOLE-Port versorgt den Pylon-Monitor, während das Verbindungskabel vom LINK PORT 1 zur Slave-Batterie führt
An der Master-Batterie: CONSOLE zum Pylon-Monitor, LINK PORT 1 zur Slave-Batterie.
Der Fehler, den fast alle machen: LINK PORT 1, nicht LINK PORT 0
Das Kabel, das Ihre Master-Batterie mit der ersten Slave-Batterie verbindet, muss vom LINK PORT 1 der Master abgehen — niemals vom LINK PORT 0. Es wird am LINK PORT 0 der Slave eingesteckt, und jede weitere Batterie wiederholt dasselbe Muster 1 → 0. Andersherum verkabelt sieht die Master den Rest des Stapels nie, und der Pylon-Monitor zeigt immer nur eine einzige Batterie an.

Jeedom

Jeedom braucht kein Pylontech-Plugin. Installieren Sie das Standard-Plugin JSON aus dem Jeedom-Market, richten Sie ein Gerät auf http://<geräte-ip>/api.json?key=<zugangsschlüssel> ein und ordnen Sie JSON-Pfade Befehlen zu: summary>soc, summary>voltage, summary>state, net>rssi und so weiter. Eine Abfrage alle 30 bis 60 Sekunden reicht völlig. Eine Batterie ändert sich nicht schnell genug, um mehr zu brauchen.

Node-RED

Zwei Wege, ähnlich wie bei Home Assistant. Entweder Abfrage mit einem http request-Node (Methode GET, URL http://<geräte-ip>/api.json?key=<zugangsschlüssel>, Rückgabe „a parsed JSON object“), ausgelöst von einem Inject-Node mit Timer, und danach Felder wie msg.payload.summary.soc lesen. Oder, wenn MQTT auf dem Gerät eingerichtet ist, mit einem MQTT-in-Node pylon-monitor/state abonnieren. Dann kommen die Daten an, sobald sie veröffentlicht werden, ohne Abfrageschleife.

Domoticz

Domoticz hat keinen fertigen Sensortyp, der JSON abfragt, aber der übliche Umweg ist erprobt: Ein kurzes Skript (Python oder die Lua- bzw. Blockly-Events von Domoticz) holt /api.json in festen Abständen und schreibt die Werte über die Domoticz-API in Dummy-Sensoren. Das dauert ein paar Minuten länger als bei Jeedom oder Node-RED, aber man macht es nur einmal. Danach verhalten sich die Sensoren wie jedes andere Domoticz-Gerät, mit Verlaufsdiagrammen und Benachrichtigungen.

openHAB

Das HTTP Binding von openHAB erledigt das von Haus aus. Legen Sie ein Thing an, das auf http://<geräte-ip>/api.json?key=<zugangsschlüssel> zeigt, mit einem Aktualisierungsintervall, und ordnen Sie jeden Channel per JSONPath-Transformation einem JSON-Pfad zu, um summary.soc, summary.voltage und so weiter in eigene Items zu bekommen. Das generische HTTP-Binding genügt, ein eigenes Binding ist nicht nötig.

Grafana, Skripte und alles andere

Hat ein Werkzeug eine Datenquelle „JSON API“ oder „HTTP“, kann es diesen Endpunkt genauso lesen: das JSON-API-Plugin von Grafana, der HTTP-Input von Telegraf, ein Python-Skript mit requests, ein Shell-Einzeiler mit curl | jq. Dem Gerät ist egal, was am anderen Ende der Anfrage sitzt. Das heißt auch: Es wird nicht nutzlos, wenn Sie eines Tages die Hausautomationsplattform wechseln.

Tuya / SmartLife

Tuya und SmartLife sprechen nur mit Tuyas Cloud, mit der lokalen JSON-Adresse können sie also direkt nichts anfangen. Das Gerät kann dasselbe JSON unter einem öffentlichen HTTPS-Link veröffentlichen (Settings > Public JSON access > „Enable a real public URL“), den IFTTT, Make.com oder Apilio lesen und an SmartLife weitergeben. Das ist inoffiziell und selbst gebaut. Die Einzelheiten stehen in unserem Leitfaden zum Pylontech-Monitoring und in unserer Antwort auf eine Kundenfrage.

Abfragen oder MQTT?

Die meisten Plattformen oben fragen die JSON-API in festen Abständen ab. Das ist einfach und funktioniert überall. Spricht Ihre Plattform auch MQTT (Node-RED und Home Assistant tun das), kommen die Daten über ein Abo von pylon-monitor/state an, sobald sie veröffentlicht werden, statt bei der nächsten Abfrage. Dazu gibt es das gespeicherte Verfügbarkeits-Topic: Sie wissen sofort, wenn das Gerät selbst offline ist, statt aus einem veralteten Wert zu raten. Trotzdem: Eine Abfrage alle 30 bis 60 Sekunden reicht für eine Batterie völlig. Hier braucht nichts sekundengenaue Aktualisierung.

Überall dieselben Daten. Home Assistant hat eine eigene Auto-Discovery, weil danach am häufigsten gefragt wird, nicht weil die anderen Plattformen zweitklassig wären. Alle lesen dieselbe JSON-Struktur und dieselben MQTT-Topics. Sobald die Daten fließen, steht hier, was die Felder bedeuten.

Häufige Fragen

Funktioniert Pylontech-Monitoring mit Jeedom?
Ja. Das im Jeedom-Store verfügbare Standard-JSON-Plugin kann den /api.json-Endpunkt des Geräts direkt abfragen und Felder auf Befehle abbilden — kein eigenes Jeedom-Plugin nötig.
Kann ich eine Pylontech-Batterie mit Node-RED verbinden?
Ja, auf zwei Arten: /api.json mit einem http-request-Node abfragen, oder das MQTT-State-Topic mit einem MQTT-in-Node abonnieren, falls MQTT auf dem Gerät konfiguriert ist.
Funktioniert das auch mit Domoticz oder openHAB?
Ja. Domoticz nutzt in der Regel ein kleines Skript, um Werte über die eigene API in Dummy-/Virtual-Sensoren zu schreiben; das eingebaute HTTP-Binding von openHAB kann den JSON-Endpunkt direkt abfragen, ohne eigenes Binding.

Die JSON-API und die MQTT-Topics von Pylon-Monitor sind offen, dokumentiert und an keine Plattform gebunden: Schließen Sie es an das an, was Sie schon nutzen.

Jetzt bestellen — 64 € Einmaliger Kauf, 64 € gesamt — keine MwSt., kein Abo.

Werden Sie einer von 6.000 Pylon-Monitor-Fans auf Facebook

Neuigkeiten, Firmware-Updates, echte Installationen und Tipps: Folgen Sie der Seite und stellen Sie Ihre Fragen der Community.

Auf Facebook folgen