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

Pylontech in Home Assistant: MQTT-Auto-Discovery oder REST

Zwei Wege, beide in der Firmware, keiner braucht eine Custom Component. Wie jeder funktioniert, was er liefert und welchen Sie wählen sollten.

Kurz gesagt: Es gibt zwei Wege, eine Pylontech-Batterie mit Pylon-Monitor in Home Assistant zu bringen, und beide sind schon im Gerät eingebaut. Wenn Sie den Mosquitto-Broker nutzen, nehmen Sie MQTT-Auto-Discovery: vier Felder ausfüllen, und elf Sensoren erscheinen von selbst, dazu Sensoren für jede einzelne Batterie. Ohne MQTT nehmen Sie die REST-Plattform: Das Gerät erzeugt das YAML für Sie, fertig zum Einfügen. Keine Custom Component, kein HACS.

Zwei Wege, beide schon in der Firmware

Wer nach „Pylontech Home Assistant“ sucht, findet Custom Components, HACS-Repositories und YAML aus jahrealten Forenbeiträgen. Mit Pylon-Monitor muss auf der Home-Assistant-Seite nichts installiert werden. Beide Methoden lesen dieselben Daten vom Console-Anschluss der Batterie. Die Wahl hängt also nicht vom Funktionsumfang ab, sondern davon, was bei Ihnen schon läuft.

Option 1: MQTT-Auto-Discovery (der schnelle Weg)

Läuft in Home Assistant bereits das Add-on Mosquitto broker, wie in den meisten Installationen, nehmen Sie diesen Weg. Tragen Sie IP-Adresse, Port, Benutzer und Passwort des Brokers auf der Settings-Seite des Geräts ein und speichern Sie. Etwa fünf Sekunden später erscheinen elf Sensoren unter Einstellungen → Geräte & Dienste → MQTT, gebündelt in einem Gerät namens Pylon-Monitor. Kein YAML, kein Neustart, keine Entitäten von Hand anlegen.

Die elf Sensoren sind SOC, SOH, Spannung, Strom, Leistung, Batterietemperatur, MOSFET-Temperatur, Ladezyklen, Batteriestatus, Zellungleichgewicht und die Anzahl der Batterien. Den letzten haben wir auf Wunsch eines Kunden ergänzt: Die JSON-API hatte ihn schon immer, aber in MQTT spart er einen eigenen REST-Aufruf. Bei mehreren Batterien bekommt jede Einheit zusätzlich eigene Sensoren (SOC, SOH, Zyklen, Spannung, Status), mit Modell, BMS-Version und Seriennummer als Attribute.

Dazu kommt ein Verfügbarkeits-Topic mit einer MQTT-„Last Will“-Nachricht. Verliert das Gerät Strom oder WLAN, werden alle Sensoren in Home Assistant grau, statt auf ihrem letzten Wert stehen zu bleiben. Das ist wichtiger, als es klingt: Ein eingefrorener SOC, der normal aussieht, ist genau der Grund, warum ein Alarm bei niedrigem Ladestand nie auslöst.

Settings-Seite von Pylon-Monitor mit ausgefüllten MQTT-Brokerfeldern für Home Assistant
Broker-IP, Port, Benutzer, Passwort: Das ist die ganze MQTT-Einrichtung am Gerät.
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.
Tipp: Legen Sie für das Gerät einen eigenen MQTT-Benutzer an (in der Konfiguration des Mosquitto-Add-ons oder unter „Personen“ in Home Assistant), statt Ihr eigenes Login zu verwenden. Das dauert eine Minute, und Sie können dem Gerät den Zugang später getrennt entziehen.

Option 2: REST, wenn Sie kein MQTT nutzen

Kein Broker? Die eingebaute rest-Plattform von Home Assistant kann /api.json des Geräts alle 30 Sekunden abrufen und sechs Sensoren anlegen: SOC, SOH, Spannung, Strom, Leistung und Status. Das YAML müssen Sie nicht schreiben. Die Settings-Seite des Geräts erzeugt es mit Ihrer IP-Adresse, und bei aktueller Firmware enthält es auch den Zugangsschlüssel, den die API inzwischen verlangt. Kopieren, in configuration.yaml einfügen, Home Assistant neu starten.

Vom Pylon-Monitor automatisch erzeugter REST-YAML-Block für Pylontech-Sensoren in Home Assistant
Der REST-Block, vom Gerät mit der richtigen IP-Adresse erzeugt. Nichts muss aus dem Gedächtnis getippt werden.
Editor für configuration.yaml in Home Assistant mit dem eingefügten REST-Sensorblock von Pylon-Monitor
Unverändert in configuration.yaml eingefügt.
Anzeigekarte in Home Assistant mit der Entität Pylontech SOC, hier bei 50 %
Einer der neuen Sensoren (Pylontech SOC) auf einer Anzeigekarte, hier bei 50 %.
Nicht beides für dieselben Werte verwenden. MQTT-Auto-Discovery plus REST-Block ergibt doppelte Entitäten. Entscheiden Sie sich für einen Weg. MQTT deckt alles ab, was REST kann, dazu fünf weitere Sensoren, die Sensoren pro Batterie und das Verfügbarkeitssignal. Es gibt selten einen Grund, beides zu kombinieren.

Welcher Weg der richtige ist

Mehrere Wechselrichter, mehrere getrennte Batteriestapel? Jeder Stapel bekommt seinen eigenen Pylon-Monitor, und jeder erscheint als eigenes Gerät in Home Assistant. Ein Kunde mit drei Stapeln zu je acht US2000 hat genau das gefragt; so funktioniert es.

Was man mit den Sensoren macht

Neue Sensoren allein sind nur Zahlen auf einer Karte. Ein paar Automationen, die sie nützlich machen:

Was diese Werte bedeuten und welche einen echten Alarm verdienen, steht in unserem Leitfaden zu SOC, SOH und Zellabweichung.

Schnelle Fehlersuche

Sie nutzen kein Home Assistant?

All das beruht auf demselben /api.json-Endpunkt und denselben MQTT-Topics wie die Anbindungen an Jeedom, Node-RED, Domoticz und openHAB. Dieser Leitfaden behandelt die anderen Plattformen.

Tuya / SmartLife

Tuya und SmartLife sprechen nur mit Tuyas eigener Cloud, und eine offizielle Pylontech-Integration gibt es dafür nicht. Eine inoffizielle Brücke über IFTTT, Make.com oder Apilio lässt sich trotzdem bauen, mit der öffentlichen URL, die das Gerät veröffentlichen kann (Settings > Public JSON access > „Enable a real public URL“). Die Schritte stehen in unserem Leitfaden zum Pylontech-Monitoring und in unserer Antwort auf eine Kundenfrage.

Häufige Fragen

Brauche ich einen MQTT-Broker, um Pylontech in Home Assistant zu nutzen?
Nein. Wer keinen MQTT-Broker betreibt, kann die in Home Assistant eingebaute REST-Plattform nutzen, die die JSON-API des Geräts direkt abfragt und sechs Sensoren erstellt — kein Broker nötig.
Wie viele Sensoren liefert Pylontech-Monitoring in Home Assistant?
MQTT-Auto-Discovery erstellt 11 Sensoren plus ein Verfügbarkeitssignal. Die REST-Plattform erstellt 6 Sensoren aus denselben zugrunde liegenden Daten. Besteht Ihr Pack aus mehr als einer Pylontech-Batterie, veröffentlicht MQTT zusätzlich 5 Sensoren je Batterie (SOC, SOH, Zyklen, Spannung, Status), und die JSON-API liefert unabhängig von der gewählten Integration stets die vollständige Aufschlüsselung je Batterie.
Kann ich MQTT und REST gleichzeitig nutzen?
Technisch ja, für dieselben Werte aber nicht empfehlenswert — es entstehen doppelte Entitäten. MQTT wählen, wenn ein Broker vorhanden ist (deckt alles ab, was REST kann, und mehr); REST nur nutzen, wenn kein Broker läuft.

Pylon-Monitor bringt beides mit: MQTT-Auto-Discovery und den REST-YAML-Generator, direkt im Gerät und ab dem Einstecken bereit.

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