Ontworpen & gemaakt in Frankrijk 6K fans op Facebook · Volg ons

Pylontech in Home Assistant

Uw Pylon-Monitor spreekt Home Assistant van zichzelf — geen HACS, geen aangepaste integratie, niets te installeren op het apparaat. Vul 4 velden in en de sensoren verschijnen vanzelf (MQTT auto-discovery), of plak een kant-en-klaar REST-YAML-blok als u geen broker draait. Alles blijft op uw lokale netwerk.

Kort gezegd: dit krijgt u in Home Assistant

  • Uw Pylontech-accu verschijnt vanzelf in Home Assistant: laadniveau, laad- en ontlaadvermogen, spanning en temperaturen, elke minuut bijgewerkt.
  • Met meerdere accu’s krijgt elke accu zijn eigen laadniveau, gezondheid (SOH), cycli en spanning, zodat u ziet welke sneller veroudert.
  • De gegevens voeden het Energie-dashboard en uw automatiseringen, bijvoorbeeld een melding op uw telefoon als de accu onder 20 % zakt.
  • Niets te installeren op de accu of in HACS, geen cloudaccount: alles blijft op uw thuisnetwerk.
Bekijk het · ongeveer één minuut

Pylontech in Home Assistant, in ongeveer een minuut

Draait de Mosquitto-add-on al in Home Assistant, dan is dit echt de hele procedure. Kijk hoe het gaat en maak daarna uw eerste automatisering met de generator verderop.

  1. 0:001Op de Pylon-Monitor: 4 velden

    Settings-pagina van het apparaat, kaart Home Assistant — MQTT: het IP van uw Home Assistant, poort 1883, een gebruiker en zijn wachtwoord. Save changes, klaar.

    Home Assistant — MQTTOption 1

    Recommended if you already run the Mosquitto add-on. All sensors appear automatically, no YAML.

    Save changes

    Home Assistant (MQTT) Connected

  2. 0:202In Home Assistant: niets te doen

    Het apparaat Pylon-Monitor verschijnt vanzelf onder MQTT met zijn 11 sensoren, plus 5 per accu bij een pakket van meerdere accu’s. Geen YAML, geen herstart.

    Instellingen › Apparaten & diensten › MQTT

    Pylon-MonitorPylon-Monitor.com · Pylontech console monitor
    Nieuw
    • Battery SOCsensor.pylon_monitor_battery_soc94 %
    • Battery powersensor.pylon_monitor_battery_power−350 W
    • Battery voltagesensor.pylon_monitor_battery_voltage48.62 V
    • Battery currentsensor.pylon_monitor_battery_current−7.20 A
    • Battery statesensor.pylon_monitor_battery_stateDischarging
    • Battery SOHsensor.pylon_monitor_battery_soh96 %
    • Battery tempsensor.pylon_monitor_battery_temp23.4 °C
    • MOSFET tempsensor.pylon_monitor_mosfet_temp28.1 °C
    • Charge cyclessensor.pylon_monitor_charge_cycles486
    • Cell imbalancesensor.pylon_monitor_cell_imbalance12 mV
    • Battery countsensor.pylon_monitor_battery_count2

    + Battery 1 SOC, Battery 1 SOH, Battery 1 cycles… · Battery 2 …

  3. 1:003Uw Pylontech, live

    Meters, geschiedenis, pagina Energie, automatiseringen: de sensoren verversen na elke uitlezing van de accu, standaard elke 60 s.

Illustratie met gesimuleerde waarden voor een pakket van 2 accu’s. De teksten op het apparaat en de sensornamen zijn de echte.

Home Assistant-automatiseringen

Uw apparaten draaien op de zon, vanzelf

Pylon-Monitor vertelt Home Assistant wanneer de batterij vol raakt en wanneer ze bijna leeg is. Vier eenvoudige regels, en de wasmachine, de boiler en de auto gebruiken uw zon in plaats van het net. Bekijk een dag:

10:00

Uw zonneproductie

Uw verbruik

OverzichtLive

Automatiseringen

  • Wasmachine op de zon
  • De auto volgt de zon
  • Gratis warm water
  • Zachte avondverwarming

Logboek

    • Zonneproductie
    • Huis en verwarming
    • Wasmachine
    • Boiler
    • Elektrische auto
    • Batterijniveau
    • Van het net
    • Voor weinig aan het net verkocht
    Zonnestroom thuis gebruikt0 %
    Van het net gekocht0
    Zelfvoorziening0 %
    Bespaard op deze dag0tegenover dezelfde dag zonder automatisering
    Over een jaar0als 150 dagen er zo uitzien
    Maak deze automatiseringen in 2 minuten →

    Simulatie van een zonnige dag voor een huis met 5 kWp panelen, een batterij van 10 kWh, een auto die 10 kWh nodig heeft en een boiler. Elk apparaat krijgt in beide scenario’s evenveel energie; alleen het moment verandert. Uw cijfers hangen af van uw installatie, uw tarief en het weer.

    Wat u nodig hebt

    1Een Pylon-MonitorAangesloten op de CONSOLE-poort van de master-batterij — elk model, met scherm of Lite.
    2Home AssistantElke recente installatie: HA OS, Supervised, Container of Core.
    35 minutenPlus de add-on Mosquitto broker als u voor optie 1 (MQTT) kiest.
    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.

    Kies uw integratie

    Beide opties stelt u in op de Settings-pagina van het apparaat (http://pylon-monitor.local/settings of http://<APPARAAT-IP>/settings). Kies er één — ze zijn onafhankelijk.

    Optie 2

    REST API

    Geen broker nodig. Home Assistant leest het ingebouwde JSON-eindpunt /api.json rechtstreeks. De Settings-pagina van het apparaat schrijft de YAML voor u, met uw IP en uw aantal batterijen al ingevuld.

    U doet: de YAML in configuration.yaml plakken en herstarten
    HA krijgt: 6 sensoren, plus SOH en cycli per batterij
    Updates: Home Assistant vraagt elke 30 s op
    Optie 2 instellen ↓
    Uw apparaat vinden. Op een model met scherm staan het IP-adres en pylon-monitor.local onderaan het scherm. Op de Lite (zonder scherm) opent u http://pylon-monitor.local, of zoekt u „pylon-monitor” in de lijst met verbonden apparaten van uw router. Voor een ijzersterke integratie geeft u het een vast adres: een DHCP-reservering in uw router (aanbevolen) of de kaart Static IP op de Settings-pagina.

    Optie 1 — MQTT auto-discovery

    Aanbevolen als u de add-on Mosquitto broker in Home Assistant gebruikt. Zodra het apparaat met de broker verbonden is, publiceert het standaard discovery-berichten op homeassistant/sensor/… en verschijnen de sensoren binnen enkele seconden onder Instellingen → Apparaten & diensten → MQTT, gegroepeerd onder één apparaat genaamd Pylon-Monitor.

    1. Vul 4 velden in op het apparaat

    Zoek op de Settings-pagina van het apparaat de kaart Home Assistant — MQTT en vul deze velden in (labels precies zoals het apparaat ze toont):

    Broker IP<IP van uw Home Assistant>
    Port1883
    Usernamemqtt-pylon
    New password•••••••• (het wachtwoord)
    Settings-pagina van de Pylon-Monitor — kaart Home Assistant MQTT met Broker IP, Port, Username en wachtwoord

    Klik op Save changes. Een paar seconden later toont de regel Home Assistant (MQTT) op het dashboard van het apparaat Connected en worden de sensoren hieronder aangemaakt — geen entiteit om met de hand in te stellen. MQTT uitzetten: maak Broker IP leeg en sla op.

    Welke gebruiker en welk wachtwoord? De Mosquitto-add-on accepteert gebruikersaccounts van Home Assistant. Maak er een aparte aan (Instellingen → Personen → Persoon toevoegen, zet „Inloggen toestaan” aan, bijv. mqtt-pylon) en gebruik die hier in plaats van uw beheerdersaccount. Het broker-IP is gewoon het IP van uw Home Assistant als Mosquitto daarop draait.

    2. De sensoren in Home Assistant

    De apparaatnaam (standaard pylon-monitor, aan te passen in Settings) dient als topic-prefix. Hebt u hem veranderd, vervang dan pylon-monitor hieronder door die van u.

    Sensor in Home AssistantDiscovery-topicEenheid / type
    Battery SOChomeassistant/sensor/pylon-monitor/soc/config% · battery
    Battery SOHhomeassistant/sensor/pylon-monitor/soh/config% · mdi:battery-heart-variant
    Battery voltagehomeassistant/sensor/pylon-monitor/voltage/configV · voltage
    Battery currenthomeassistant/sensor/pylon-monitor/current/configA · current
    Battery powerhomeassistant/sensor/pylon-monitor/power/configW · power
    Battery temphomeassistant/sensor/pylon-monitor/temp/config°C · temperature
    MOSFET temphomeassistant/sensor/pylon-monitor/mostemp/config°C · temperature
    Charge cycleshomeassistant/sensor/pylon-monitor/cycles/configmdi:counter
    Battery statehomeassistant/sensor/pylon-monitor/state/configmdi:battery-sync
    Cell imbalancehomeassistant/sensor/pylon-monitor/celldelta/configmV · mdi:scale-balance
    Battery counthomeassistant/sensor/pylon-monitor/units/configmdi:battery-multiple

    Ze lezen allemaal hun waarde uit één bewaard (retained) state-topic, bijgewerkt na elke uitlezing van de batterij:

    pylon-monitor/state

    Het gecombineerde bericht ziet er zo uit:

    {
      "soc": 94,
      "soh": 96,
      "voltage": 48.62,
      "current": -7.20,
      "power": -350.1,
      "temp": 23.4,
      "mostemp": 28.1,
      "cycles": 486,
      "celldelta": 12,
      "units": 2,
      "state": "Discharging",
      "hw": "gen2",
      "pack": "lv"
    }

    3. Meerdere batterijen? Sensoren voor elke batterij

    Zodra uw pack meer dan één Pylontech-batterij heeft, maakt het apparaat ook 5 sensoren per batterij aan — Battery 1 SOC, Battery 1 SOH, Battery 1 cycles, Battery 1 voltage, Battery 1 state, dan Battery 2, 3… — elk op een eigen topic (pylon-monitor/battery1/state, pylon-monitor/battery2/state…). Ideaal om de batterij te spotten die sneller veroudert dan de rest.

    pylon-monitor/battery1/state
    { "voltage": 48.61, "current": -3.60, "power": -175.0, "soc": 94, "soh": 97,
      "cycles": 480, "charge_cnt": 391, "discharge_cnt": 0, "state": "Discharging",
      "model": "US3000C", "bms_sw": "…", "serial": "…",
      "cell_min_mv": 3238, "cell_max_mv": 3247, "cell_delta_mv": 9, "cell_count": 15 }

    Deze sensoren hebben ook attributen, zichtbaar in het detailvenster van elke sensor: batterijmodel, BMS-versie, serienummer en — zodra de cellen zijn uitgelezen — laagste en hoogste celspanning en het verschil daartussen. Zo onderscheidt u „Battery 3” van „Battery 4” zonder extra entiteiten.

    Het apparaat houdt ook een beschikbaarheids-topic bij met een „Last Will”: verliest het stroom of wifi, dan wordt elke sensor in Home Assistant „niet beschikbaar” in plaats van stilletjes op de laatste waarde te blijven staan.

    pylon-monitor/status  →  "online" (retained)  |  "offline" (Last Will, retained)

    Optie 2 — REST API

    Geen MQTT-broker nodig. De ingebouwde rest-integratie van Home Assistant leest het apparaat elke 30 seconden uit. Het makkelijkst: kopieer het blok uit de kaart Home Assistant — REST van de Settings-pagina — daar staan uw IP en een paar SOH + cycli voor elke daadwerkelijk gevonden batterij al in. De versie hieronder is hetzelfde sjabloon voor een pack met 2 batterijen. Sinds firmware 3.4.0 (Lite 1.1.0, generatie 1: 3.1) vereist /api.json uw toegangssleutel — het blok dat u uit het apparaat kopieert bevat ?key=… al. Hebt u REST vóór de update ingesteld, voeg dan ?key=<uw Access key> (Settings → Public JSON access) toe aan de regel resource:. MQTT verandert niet.

    Settings-pagina van de Pylon-Monitor — REST-YAML-blok gegenereerd met het IP-adres van het apparaat

    De JSON die het apparaat teruggeeft

    GET http://<DEVICE-IP>/api.json?key=<ACCESS-KEY>
    
    {
      "system": "pylon-monitor",
      "firmware": "3.3.2",
      "hw": "gen2",
      "battery_link": true,
      "summary": {
        "soc": 94,
        "voltage": 48.62,
        "current": -7.20,
        "power": -350.10,
        "state": "Discharging",
        "units": 2
      },
      "health": {
        "soh": 96,
        "cycles": 486,
        "charge_cnt": 782,
        "discharge_cnt": 0
      },
      "unitsDetail": [
        { "soc": 94, "soh": 97, "cycles": 480, "model": "US3000C", "...": "..." },
        { "soc": 94, "soh": 95, "cycles": 492, "model": "US3000C", "...": "..." }
      ]
    }

    Ingekort voor de leesbaarheid: het volledige antwoord bevat ook temps, cells, alarms en net, en unitsDetail geeft spanning, stroom, SOC, SOH, cycli, model en serienummer van elke batterij (aanwezig als het pack er meerdere heeft). Let op: SOH staat onder health, niet onder summary — een klassieke copy-paste-fout.

    Plak dit in configuration.yaml

    # Access key: device Settings > Public JSON access (required since
    # firmware 3.4.0 / Lite 1.1.0 / gen. 1 3.1). The block generated by the
    # device's own Settings page already contains it.
    rest:
      - resource: http://<DEVICE-IP>/api.json?key=<ACCESS-KEY>
        scan_interval: 30
        sensor:
          - name: "Pylontech SOC"
            unique_id: pylontech_soc
            value_template: "{{ value_json.summary.soc }}"
            unit_of_measurement: "%"
            device_class: battery
            state_class: measurement
          - name: "Pylontech SOH"
            unique_id: pylontech_soh
            value_template: "{{ value_json.health.soh }}"
            unit_of_measurement: "%"
            state_class: measurement
          - name: "Pylontech Voltage"
            unique_id: pylontech_voltage
            value_template: "{{ value_json.summary.voltage }}"
            unit_of_measurement: "V"
            device_class: voltage
            state_class: measurement
          - name: "Pylontech Current"
            unique_id: pylontech_current
            value_template: "{{ value_json.summary.current }}"
            unit_of_measurement: "A"
            device_class: current
            state_class: measurement
          - name: "Pylontech Power"
            unique_id: pylontech_power
            value_template: "{{ value_json.summary.power }}"
            unit_of_measurement: "W"
            device_class: power
            state_class: measurement
          - name: "Pylontech State"
            unique_id: pylontech_state
            value_template: "{{ value_json.summary.state }}"
          # One SOH + cycles pair per battery (only on a pack of 2 or more):
          - name: "Pylontech Battery 1 SOH"
            unique_id: pylontech_battery1_soh
            value_template: "{{ value_json.unitsDetail[0].soh }}"
            unit_of_measurement: "%"
            state_class: measurement
          - name: "Pylontech Battery 1 cycles"
            unique_id: pylontech_battery1_cycles
            value_template: "{{ value_json.unitsDetail[0].cycles }}"
            state_class: measurement
          - name: "Pylontech Battery 2 SOH"
            unique_id: pylontech_battery2_soh
            value_template: "{{ value_json.unitsDetail[1].soh }}"
            unit_of_measurement: "%"
            state_class: measurement
          - name: "Pylontech Battery 2 cycles"
            unique_id: pylontech_battery2_cycles
            value_template: "{{ value_json.unitsDetail[1].cycles }}"
            state_class: measurement
    configuration.yaml van Home Assistant met de REST-sensoren van de Pylon-Monitor

    Herstart Home Assistant (Ontwikkelhulpmiddelen → Herstarten). De sensoren verschijnen onder Instellingen → Apparaten & diensten → Entiteiten — zoek op pylontech.

    Meterkaart in Home Assistant met de Pylontech SOC-sensor
    Gebruik optie 1 en 2 niet tegelijk — dan hebt u elke waarde dubbel. MQTT dekt al alles wat REST doet, en meer; kies er één en blijf daarbij.

    Energiedashboard

    Voor een batterij verwacht het energiedashboard van Home Assistant twee tellers in kWh: geladen energie en ontladen energie. De Pylon-Monitor levert het batterijvermogen in W (positief = laden, negatief = ontladen), dus u maakt ze één keer aan met helpers:

    1. Splits het vermogen met twee template-sensoren: laadvermogen = het positieve deel, ontlaadvermogen = het negatieve deel als positief getal.
    2. Zet elk om naar kWh met een Integraal-helper (Riemann-som), prefix „k”, methode „Links”.
    3. Voeg in Instellingen → Dashboards → Energie, onder Thuisbatterij, de twee tellers toe: energie erin, energie eruit.

    Hetzelfde in YAML (entiteitsnamen van MQTT; bij optie 2 gebruikt u sensor.pylontech_power):

    template:
      - sensor:
          - name: "Battery charge power"
            unique_id: pylontech_charge_power
            unit_of_measurement: "W"
            device_class: power
            state_class: measurement
            state: "{{ [states('sensor.pylon_monitor_battery_power') | float(0), 0] | max }}"
          - name: "Battery discharge power"
            unique_id: pylontech_discharge_power
            unit_of_measurement: "W"
            device_class: power
            state_class: measurement
            state: "{{ [0 - (states('sensor.pylon_monitor_battery_power') | float(0)), 0] | max }}"
    
    sensor:
      - platform: integration
        source: sensor.battery_charge_power
        name: "Battery energy in"
        unique_id: pylontech_energy_in
        unit_prefix: k
        round: 2
        method: left
      - platform: integration
        source: sensor.battery_discharge_power
        name: "Battery energy out"
        unique_id: pylontech_energy_out
        unit_prefix: k
        round: 2
        method: left

    Controleer de exacte naam van uw vermogenssensor in Instellingen → Entiteiten (zoek op „power”): die wijkt af als u het apparaat hebt hernoemd of meerdere Pylon-Monitors hebt.

    Automatiseringsgenerator

    Kies wat u wilt bewaken, stel de drempel in en kies wat er moet gebeuren: de YAML schrijft zichzelf, met de echte sensornamen van de Pylon-Monitor. Standaard de klassieker: een melding als de accu onder 20 % zakt.

    Wat bewaken

    Drempel

    Dan

    automation.yaml

    In Home Assistant: Instellingen › Automatiseringen & scènes › Automatisering maken › ⋮ › Bewerken in YAML, plakken, Opslaan.

    Hetzelfde idee met Battery state, Cell imbalance (bijvoorbeeld boven 50 mV) of sensoren die langer dan 10 minuten niet beschikbaar zijn — het teken dat het apparaat offline is.

    Node-RED, Jeedom en andere

    Node-RED — een http request-node, methode GET, URL http://<APPARAAT-IP>/api.json?key=<ACCESS-KEY>, return „a parsed JSON object”, en lees daarna msg.payload.summary.soc (of een ander veld). Met MQTT ingesteld is een mqtt in-node op pylon-monitor/state nog eenvoudiger: geen polling.

    Jeedom — installeer de plugin JSON, laat een apparaat naar http://<APPARAAT-IP>/api.json?key=<ACCESS-KEY> wijzen en koppel paden aan commando's (bijv. summary>soc, summary>voltage, summary>state).

    Al het andere — openHAB, ioBroker, Domoticz, EVCC of uw eigen scripts: alles wat MQTT of een HTTP-JSON-eindpunt leest, werkt met dezelfde topics en dezelfde /api.json.

    Vragen

    Werkt het met de Lite (zonder scherm)?

    Ja. MQTT auto-discovery en de REST API zitten in de firmware van elk model: met scherm, Lite, eerste en tweede generatie. Alleen het vinden van het IP verschilt: pylon-monitor.local of de apparatenlijst van uw router.

    Mijn REST-sensoren zijn na een firmware-update niet meer beschikbaar — waarom?

    Sinds firmware 3.4.0 (Lite 1.1.0, generatie 1: 3.1) vraagt het apparaat om een wachtwoord dat u bij de eerste toegang aanmaakt, en heeft <code>/api.json</code> uw toegangssleutel nodig: de Europese cyberbeveiligingsregels voor verbonden apparaten (RED-richtlijn, EN 18031) verplichten nu dat elk apparaat beveiligd is. Open het apparaat één keer in een browser om uw wachtwoord aan te maken, voeg dan <code>?key=&lt;Access key&gt;</code> (<em>Settings → Public JSON access</em>) toe aan uw regel <code>resource:</code> en herstart Home Assistant. MQTT-sensoren blijven ongewijzigd werken.

    Heb ik internet of de Pylon-Monitor Cloud nodig?

    Nee. Home Assistant praat rechtstreeks met het apparaat op uw lokale netwerk. De gratis Cloud is optioneel: die voegt alleen toegang op afstand en langetermijngeschiedenis toe.

    Ik heb meerdere batterijen: zie ik ze allemaal apart?

    Ja. Met MQTT maakt het apparaat 5 sensoren per batterij aan (SOC, SOH, cycli, spanning, status), met model en serienummer als attributen. Met REST voegt de gegenereerde YAML SOH en cycli per batterij toe.

    Hoe vaak worden de waarden bijgewerkt?

    Na elke uitlezing van de batterij: standaard elke 60 seconden, instelbaar van 30 tot 300 seconden met de instelling Battery polling op de Settings-pagina. Met REST vraagt Home Assistant elke 30 seconden op.

    Mijn sensoren zijn „niet beschikbaar”: wat controleer ik?

    Dat is het beschikbaarheidssignaal dat zijn werk doet: het apparaat is niet meer met de broker verbonden (stroomuitval, wifi, broker herstart). Open de pagina van het apparaat: de regel Home Assistant (MQTT) toont Connected of Offline. Het probeert het zelf elke 10 seconden opnieuw.

    Kan Home Assistant de batterij aansturen?

    Nee, en dat is bewust: de integratie biedt alleen sensoren om te lezen. Niets in Home Assistant kan een instelling van uw batterij of het BMS wijzigen.

    Heb ik HACS of een aangepaste integratie nodig?

    Nee. MQTT auto-discovery en de REST-integratie horen bij Home Assistant zelf. Alleen de Mosquitto-add-on moet u installeren, en alleen als u voor MQTT kiest.

    Nog geen Pylon-Monitor?

    Steek hem in de CONSOLE-poort, verbind hem met uw wifi, en uw Pylontech verschijnt in Home Assistant. V2 met scherm € 64, Lite zonder scherm € 49.

    Uitgebreide MQTT- & REST-gids →

    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