Pylontech in Home Assistant, MQTT, JSON en Jeedom
De cloud is voor als je weg bent. Thuis geeft PylonCheck zijn gegevens rechtstreeks via je netwerk aan je eigen systeem — zonder cloud, zonder account, ook als internet uitvalt.
MQTT auto-discovery: nul YAML
Vul op de pagina Instellingen van de box het adres van je broker in (en eventueel gebruiker / wachtwoord). Binnen enkele seconden maakt Home Assistant een apparaat PylonCheck met zijn sensoren:
- Laadtoestand, State of Health, aantal cycli
- Spanning, stroom, vermogen
- Batterij- en BMS-/MOSFET-temperatuur
- Laadstatus, aantal batterijen, celonbalans (mV)
- Een online-/offline-beschikbaarheidssignaal
rest-integratie.Topics
Alle topics zijn retained: een abonnee die later start, krijgt meteen de laatste waarden. Het voorvoegsel is de hostnaam van de box (standaard pylon-check).
pylon-check/status online | offline (retained, last will)
pylon-check/state whole stack: soc, voltage, current, power, state…
pylon-check/battery1/state battery 1 of the stack
pylon-check/battery2/state battery 2 …
homeassistant/sensor/pylon-check/…/config auto-discovery (retained)Elk state-bericht is een JSON-object met dezelfde velden als de API hieronder — hetzelfde sjabloon werkt overal.
Eén GET, de hele batterij
GET http://pylon-check.local/api.json (of het IP van de box) geeft de volledige status. Ingekort voorbeeld:
{
"system": { "firmware": "1.0.1", "uptime": 86400 },
"battery_link": true,
"summary": { "soc": 87, "voltage": 52.41, "current": 23.5,
"power": 1231.6, "state": "Charging", "units": 3 },
"health": { "soh": 98, "cycles": 412 },
"temps": { "battery": 24.0, "mosfet": 26.5, "low": 23.0, "high": 25.1 },
"cells": { "count": 15, "min": 3271, "max": 3280, "delta": 9,
"mv": [3274, 3276, 3271, "…"] },
"unitsDetail": [
{ "label": "Battery 1", "voltage": 52.41, "current": 7.9,
"soc": 87, "soh": 98, "cycles": 412, "state": "Charging" }
]
}Een optionele toegangssleutel kan in de Instellingen worden ingesteld; de API lees je dan met ?key=…. De waarden worden om de paar seconden ververst.
REST-voorbeeld voor Home Assistant
# configuration.yaml — only needed if you prefer REST to MQTT
rest:
- resource: http://pylon-check.local/api.json
scan_interval: 30
sensor:
- name: "Pylontech SOC"
value_template: "{{ value_json.summary.soc }}"
unit_of_measurement: "%"
device_class: battery
- name: "Pylontech power"
value_template: "{{ value_json.summary.power }}"
unit_of_measurement: "W"
device_class: power
- name: "Pylontech cell spread"
value_template: "{{ value_json.cells.delta }}"
unit_of_measurement: "mV"Jeedom, Node-RED, openHAB, Domoticz
Jeedom
Installeer de plugin jMQTT, wijs hem naar je broker en abonneer op pylon-check/#: de stack en elke batterij verschijnen als apparatuur. Of gebruik de Script-plugin op de JSON-API.
Node-RED
Een mqtt in-node op pylon-check/state, of een http request-node op /api.json elke 30 seconden.
openHAB, Domoticz, ioBroker
Elk systeem dat MQTT spreekt of JSON via HTTP leest, kan PylonCheck gebruiken. Niets is gesloten.
Vragen
Heeft Home Assistant de PylonCheck-cloud nodig?
Nee. Home Assistant leest de box rechtstreeks op je netwerk. Cloud en Home Assistant kunnen tegelijk draaien.
Moet ik YAML schrijven?
Nee, met MQTT auto-discovery verschijnen de sensoren vanzelf. YAML is alleen nodig voor de REST-integratie.
Vervangt dit de omvormerintegratie?
Het vult ze aan: de omvormer geeft de vermogensstromen, PylonCheck wat de batterij zelf weet — SOH, cellen, temperaturen, detail per batterij.
Krijg ik elke batterij als aparte sensoren?
Ja. Elke batterij heeft een eigen MQTT-topic en de JSON-API toont ze één voor één.
Je batterij, van overal. Voor 39 €.
Cloud-dashboard, historiek, meldingen, Home Assistant en MQTT inbegrepen. Geen abonnement.