Ontworpen & gemaakt in Frankrijk 6K fans op Facebook · Volg ons
INTEGRATIES7 min. leestijdDoor het Pylon-Monitor-teamBijgewerkt op

Pylontech met Jeedom, Node-RED, Domoticz en openHAB

Geen Home Assistant? Hetzelfde JSON-endpoint en dezelfde MQTT-topics werken in Jeedom, Node-RED, Domoticz, openHAB en alles wat een HTTP-verzoek kan doen.

Kort gezegd: ja, een Pylontech-accu is uit te lezen met Jeedom, Node-RED, Domoticz, openHAB of Grafana. Pylon-Monitor biedt de accugegevens aan als eenvoudige JSON op één adres in uw netwerk, /api.json, en kan ze ook via MQTT publiceren. Alles wat een HTTP-verzoek kan doen of zich op een MQTT-topic kan abonneren, kan ermee werken, zonder plugin van ons en zonder SDK van een fabrikant.

Eén JSON-endpoint voor elk platform

Home Assistant krijgt de meeste aandacht en heeft een eigen gids. Daaronder is het mechanisme bewust eenvoudig: één HTTP-adres, GET /api.json?key=…, met de toegangssleutel van de Settings-pagina van het apparaat, en gewone JSON als antwoord. Jeedom, Node-RED, Domoticz, openHAB, Grafana, een Python-script of een cronjob met curl lezen precies dezelfde gegevens.

JSON-API-antwoord van een Pylontech-monitoringapparaat met gestructureerde accugegevens
Dit ene JSON-antwoord voedt alle koppelingen hieronder. Niets platformspecifieks op het apparaat.
Aansluitpaneel van een Pylontech master-accu: de RJ45-kabel in de CONSOLE-poort voedt de Pylon-Monitor, terwijl de koppelkabel vanaf LINK PORT 1 naar de slave-accu loopt
Op de master-accu: CONSOLE naar de Pylon-Monitor, LINK PORT 1 naar de slave-accu.
De fout die bijna iedereen maakt: LINK PORT 1, niet LINK PORT 0
De kabel die uw master-accu met de eerste slave verbindt, moet vertrekken vanaf LINK PORT 1 op de master — nooit vanaf LINK PORT 0. Hij gaat in LINK PORT 0 van de slave, en elke volgende accu herhaalt hetzelfde patroon 1 → 0. Andersom aangesloten ziet de master de rest van de stapel nooit en toont de Pylon-Monitor altijd maar één accu.

Jeedom

Jeedom heeft geen Pylontech-plugin nodig. Installeer de standaard JSON-plugin uit de Jeedom-market, laat een apparaat verwijzen naar http://<apparaat-ip>/api.json?key=<toegangssleutel> en koppel JSON-paden aan commando's: summary>soc, summary>voltage, summary>state, net>rssi enzovoort. Elke 30 tot 60 seconden uitlezen is ruim genoeg. Een accu verandert niet snel genoeg om meer te vragen.

Node-RED

Twee manieren, vergelijkbaar met de keuze in Home Assistant. Ofwel uitlezen met een http request-node (methode GET, URL http://<apparaat-ip>/api.json?key=<toegangssleutel>, terug als „a parsed JSON object”), gestart door een inject-node met timer, en daarna velden als msg.payload.summary.soc lezen. Ofwel, als MQTT op het apparaat is ingesteld, abonneren op pylon-monitor/state met een MQTT-in-node. De gegevens komen dan binnen zodra ze worden gepubliceerd, zonder uitleeslus om te beheren.

Domoticz

Domoticz heeft geen kant-en-klaar sensortype dat JSON uitleest, maar de gebruikelijke omweg is beproefd: een kort script (Python, of de Lua- of Blockly-events van Domoticz) haalt /api.json op vaste tijden op en zet de waarden via de API van Domoticz in Dummy-sensoren. Het kost een paar minuten meer dan Jeedom of Node-RED, maar u doet het maar één keer. Daarna gedragen de sensoren zich als elk ander Domoticz-apparaat, met grafieken en meldingen.

openHAB

De HTTP Binding van openHAB doet dit standaard. Maak een Thing aan dat naar http://<apparaat-ip>/api.json?key=<toegangssleutel> verwijst met een verversingsinterval, en koppel elk kanaal met een JSONPath-transformatie aan een JSON-pad om summary.soc, summary.voltage enzovoort in aparte Items te krijgen. De generieke HTTP-binding volstaat, een eigen binding is niet nodig.

Grafana, scripts en al het andere

Heeft een tool een gegevensbron „JSON API” of „HTTP”, dan kan die dit endpoint op dezelfde manier lezen: de JSON API-plugin van Grafana, de HTTP-input van Telegraf, een Python-script met requests, een shell-regel met curl | jq. Het apparaat maakt het niet uit wat er aan de andere kant van het verzoek zit. Dat betekent ook dat het niet nutteloos wordt op de dag dat u van domoticaplatform wisselt.

Tuya / SmartLife

Tuya en SmartLife praten alleen met de cloud van Tuya, dus aan het lokale JSON-adres hebben ze rechtstreeks niets. Het apparaat kan dezelfde JSON op een publieke HTTPS-link zetten (Settings > Public JSON access > „Enable a real public URL”), die IFTTT, Make.com of Apilio kunnen lezen en doorgeven aan SmartLife. Het is onofficieel en u bouwt het zelf. De details staan in onze gids over Pylontech-monitoring en in ons antwoord op een klantvraag.

Uitlezen of MQTT?

De meeste platforms hierboven lezen de JSON-API op vaste tijden uit. Dat is eenvoudig en werkt overal. Spreekt uw platform ook MQTT (Node-RED en Home Assistant doen dat), dan komen de gegevens via een abonnement op pylon-monitor/state binnen zodra ze worden gepubliceerd, in plaats van bij de volgende uitlezing. U krijgt er ook het bewaarde beschikbaarheids-topic bij: u weet meteen wanneer het apparaat zelf offline is, in plaats van het te moeten raden uit een oude waarde. Toch is elke 30 tot 60 seconden uitlezen ruim voldoende voor een accu. Niets hiervan hoeft per seconde bij te werken.

Overal dezelfde gegevens. Home Assistant heeft een eigen auto-discovery omdat daar het vaakst om wordt gevraagd, niet omdat de andere platforms tweederangs zijn. Ze lezen allemaal dezelfde JSON-structuur en dezelfde MQTT-topics. Zodra de gegevens binnenkomen, leest u hier wat de velden betekenen.

Veelgestelde vragen

Werkt Pylontech-monitoring met Jeedom?
Ja. De standaard JSON-plugin uit de Jeedom-store kan het /api.json-eindpunt van het apparaat rechtstreeks bevragen en velden koppelen aan commando's — geen aangepaste Jeedom-plugin nodig.
Kan ik een Pylontech-accu aansluiten op Node-RED?
Ja, op twee manieren: /api.json bevragen met een http request-node, of abonneren op het MQTT state-topic met een MQTT-in-node als MQTT op het apparaat is geconfigureerd.
Werkt dit ook met Domoticz of openHAB?
Ja. Domoticz gebruikt doorgaans een klein script om waarden via zijn eigen API naar Dummy/Virtual-sensoren te sturen; de ingebouwde HTTP Binding van openHAB kan het JSON-eindpunt rechtstreeks bevragen, zonder aangepaste binding.

De JSON-API en MQTT-topics van Pylon-Monitor zijn open, gedocumenteerd en aan geen enkel platform gebonden: sluit het aan op wat u al gebruikt.

Nu bestellen — 64 € Eenmalige aankoop, € 64 in totaal — geen btw, geen abonnement.

Sluit u aan bij 6.000 Pylon-Monitor-fans op Facebook

Nieuws, firmware-updates, echte installaties en tips: volg de pagina en stel uw vragen aan de community.

Volg ons op Facebook