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

Pylontech in Home Assistant: MQTT-auto-discovery of REST

Twee wegen, allebei in de firmware, geen van beide heeft een custom component nodig. Hoe elke werkt, wat u krijgt en welke u kiest.

Kort gezegd: er zijn twee manieren om een Pylontech-accu met Pylon-Monitor in Home Assistant te krijgen, en beide zitten al in het apparaat. Gebruikt u de Mosquitto-broker, kies dan MQTT-auto-discovery: vier velden invullen en elf sensoren verschijnen vanzelf, plus sensoren voor elke accu. Zonder MQTT kiest u het REST-platform: het apparaat maakt de YAML voor u aan, klaar om te plakken. Geen custom component, geen HACS.

Twee wegen, allebei al in de firmware

Zoek op „Pylontech Home Assistant” en u vindt custom components, HACS-repositories en YAML uit forumdraadjes van jaren terug. Met Pylon-Monitor hoeft u in Home Assistant niets te installeren. Beide methoden lezen dezelfde gegevens van de Console-poort van de accu. De keuze hangt dus niet af van de functies, maar van wat u al heeft draaien.

Optie 1: MQTT-auto-discovery (de snelle weg)

Draait Home Assistant al de add-on Mosquitto broker, zoals bij de meeste installaties, kies dan deze. Vul IP-adres, poort, gebruiker en wachtwoord van de broker in op de Settings-pagina van het apparaat en sla op. Zo'n vijf seconden later verschijnen elf sensoren onder Instellingen → Apparaten & diensten → MQTT, gebundeld in één apparaat met de naam Pylon-Monitor. Geen YAML, geen herstart, geen entiteiten met de hand aanmaken.

De elf sensoren zijn SOC, SOH, spanning, stroom, vermogen, accutemperatuur, MOSFET-temperatuur, laadcycli, accustatus, celonbalans en het aantal accu's. Die laatste is toegevoegd op verzoek van een klant: de JSON-API had hem altijd al, maar in MQTT bespaart hij een aparte REST-aanroep. Bij meerdere accu's krijgt elke unit ook eigen sensoren (SOC, SOH, cycli, spanning, status), met model, BMS-versie en serienummer als attributen.

Daarnaast is er een beschikbaarheids-topic, gebaseerd op een MQTT-„last will”-bericht. Verliest het apparaat stroom of WiFi, dan worden alle sensoren grijs in Home Assistant in plaats van te blijven hangen op hun laatste waarde. Dat is belangrijker dan het klinkt: een bevroren SOC die er normaal uitziet, is precies waarom een alarm voor een lege accu nooit afgaat.

Settings-pagina van Pylon-Monitor met ingevulde MQTT-brokervelden voor Home Assistant
Broker-IP, poort, gebruiker, wachtwoord: dat is de hele MQTT-instelling 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.
Tip: maak een aparte MQTT-gebruiker voor het apparaat aan (in de configuratie van de Mosquitto-add-on of bij Personen in Home Assistant) in plaats van uw eigen login te gebruiken. Het kost een minuut en u kunt het apparaat later los de toegang ontnemen.

Optie 2: REST, als u geen MQTT gebruikt

Geen broker? Het ingebouwde rest-platform van Home Assistant kan /api.json van het apparaat elke 30 seconden uitlezen en zes sensoren aanmaken: SOC, SOH, spanning, stroom, vermogen en status. De YAML hoeft u niet te schrijven. De Settings-pagina van het apparaat maakt hem aan met uw IP-adres al ingevuld, en bij recente firmware staat ook de toegangssleutel erin die de API nu vraagt. Kopiëren, plakken in configuration.yaml, Home Assistant herstarten.

Door het Pylon-Monitor-apparaat automatisch gegenereerd REST-YAML-blok voor Pylontech-sensoren in Home Assistant
Het REST-blok, door het apparaat aangemaakt met het juiste IP-adres. Niets uit het hoofd te typen.
Editor van configuration.yaml in Home Assistant met het geplakte REST-sensorblok van Pylon-Monitor
Ongewijzigd geplakt in configuration.yaml.
Meterkaart in Home Assistant met de entiteit Pylontech SOC geselecteerd, op 50%
Een van de nieuwe sensoren (Pylontech SOC) op een meterkaart, hier op 50%.
Gebruik niet allebei voor dezelfde waarden. MQTT-auto-discovery plus het REST-blok geeft dubbele entiteiten. Kies er één. MQTT dekt alles wat REST doet, met vijf sensoren meer, de sensoren per accu en het beschikbaarheidssignaal. Er is zelden een reden om ze te combineren.

Welke kiest u?

Meerdere omvormers, meerdere losse accustapels? Elke stapel krijgt een eigen Pylon-Monitor, en elk verschijnt als apart apparaat in Home Assistant. Een klant met drie stapels van acht US2000 vroeg ons precies dat; zo werkt het.

Wat u met de sensoren doet

Sensoren alleen zijn cijfers op een kaart. Een paar automatiseringen die ze nuttig maken:

Wat deze cijfers betekenen, en welke een echt alarm verdienen, staat in onze gids over SOC, SOH en celverschil.

Snel problemen oplossen

Geen Home Assistant?

Dit alles draait op hetzelfde /api.json-endpoint en dezelfde MQTT-topics als de koppelingen met Jeedom, Node-RED, Domoticz en openHAB. Deze gids behandelt de andere platforms.

Tuya / SmartLife

Tuya en SmartLife praten alleen met de cloud van Tuya, en er bestaat geen officiële Pylontech-koppeling voor. U kunt wel een onofficiële brug bouwen met IFTTT, Make.com of Apilio, via de publieke URL die het apparaat kan publiceren (Settings > Public JSON access > „Enable a real public URL”). De stappen staan in onze gids over Pylontech-monitoring en in ons antwoord op een klantvraag.

Veelgestelde vragen

Heb ik een MQTT-broker nodig om Pylontech in Home Assistant te gebruiken?
Nee. Draait u geen MQTT-broker, dan kan het ingebouwde REST-platform van Home Assistant de JSON-API van het apparaat rechtstreeks bevragen en zes sensoren aanmaken — geen broker nodig.
Hoeveel sensoren geeft Pylontech-monitoring mij in Home Assistant?
MQTT auto-discovery maakt 11 sensoren plus een beschikbaarheidssignaal aan. Het REST-platform maakt 6 sensoren aan uit dezelfde onderliggende data. Heeft uw pack meer dan één Pylontech-batterij, dan publiceert MQTT ook 5 sensoren per batterij (SOC, SOH, cycli, spanning, status), en de JSON API geeft altijd de volledige uitsplitsing per batterij, ongeacht welke integratie u gebruikt.
Kan ik MQTT en REST tegelijk gebruiken?
Dat kan, maar niet voor dezelfde waarden — dat levert dubbele entiteiten op. Kies MQTT als u een broker heeft (dekt alles wat REST doet, en meer); gebruik REST alleen als dat niet zo is.

Pylon-Monitor heeft ze allebei: MQTT-auto-discovery en de REST-YAML-generator zitten in het apparaat, klaar zodra u het aansluit.

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