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.

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.
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.
configuration.yaml eingefügt.
Welcher Weg der richtige ist
- Sie haben schon einen Mosquitto-Broker: MQTT-Auto-Discovery. Schneller eingerichtet, mehr Sensoren, und das Verfügbarkeitssignal allein lohnt sich.
- Kein Broker, und keine Lust, nur dafür einen zu installieren: REST reicht völlig. Eine Abfrage alle 30 Sekunden statt sofortiger Übertragung spielt bei einer Batterie keine Rolle, ihre Werte ändern sich nicht so schnell.
- Eine große Home-Assistant-Installation mit Dutzenden MQTT-Geräten: Ein Gerät mehr am Broker kostet nichts. Nehmen Sie MQTT.
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:
- Benachrichtigung bei niedrigem Ladestand. Eine Automation, die auslöst, wenn der SOC unter eine Schwelle fällt, und eine Push-Nachricht über die Home-Assistant-App schickt. Praktisch, wenn Sie alle Warnungen lieber in Home Assistant bündeln als den Pushover-Alarm des Geräts zu nutzen.
- Das Zellungleichgewicht beobachten. Es springt selten über Nacht, aber ein langsamer Anstieg über Wochen ist genau das, was ein Verlaufsdiagramm in Home Assistant zeigt und ein kurzer Blick aufs Display nicht.
- Eine Karte neben Ihren Solardaten. Wenn Sie Erzeugung und Verbrauch schon in Home Assistant verfolgen, gehören SOC und Leistung der Pylontech aufs selbe Dashboard. Dann sehen Sie alles an einem Ort.
Was diese Werte bedeuten und welche einen echten Alarm verdienen, steht in unserem Leitfaden zu SOC, SOH und Zellabweichung.
Schnelle Fehlersuche
- Die MQTT-Zeile bleibt rot: Prüfen Sie Broker-IP und Zugangsdaten. Ein eigener MQTT-Benutzer (siehe Tipp oben) löst meistens das Problem, wenn ein wiederverwendetes Home-Assistant-Login abgelehnt wird.
- Doppelte Entitäten: MQTT und REST sind für dieselben Werte eingerichtet. Entfernen Sie eines.
- Ein Sensor zeigt „nicht verfügbar“: Passiert das genau dann, wenn das Gerät WLAN oder Strom verliert, ist das Verfügbarkeitssignal am Werk, kein Fehler.
- REST-Sensoren nach einem Update tot: Aktuelle Firmware verlangt den Zugangsschlüssel an der API. Kopieren Sie das YAML erneut von der Settings-Seite, es enthält jetzt den Schlüssel.
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.