Home Assistant-integratie

Kies je integratie

Open de Settings-pagina van het apparaat (http://<APPARAAT-IP>/settings). Beide opties worden daar geconfigureerd. Kies er één — ze zijn onafhankelijk en kunnen apart in-/uitgeschakeld worden.

Optie 1 — MQTT auto-discovery

Aanbevolen als je al de add-on Mosquitto / MQTT broker gebruikt in Home Assistant. Zodra de broker-verbinding is ingesteld, publiceert het apparaat Home Assistant discovery-configuraties naar de standaard homeassistant/sensor/…-topics, en verschijnen sensoren binnen enkele seconden onder Instellingen → Apparaten & diensten → MQTT — gegroepeerd onder één apparaat genaamd Pylon-Monitor.

Wat je op het apparaat invult

Open op de Settings-pagina van het apparaat de kaart MQTT Home Assistant en vul deze vier velden precies in zoals de firmware ze verwacht:

Opslaan. De MQTT-regel op het dashboard van de Pylon-Monitor wordt binnen ~5 seconden blauw (Connected), en de tien sensoren hieronder worden automatisch gepubliceerd — geen handmatige entiteitsconfiguratie nodig. Om MQTT uit te schakelen, maak je de vier velden gewoon leeg en sla je op.

Topics die de firmware publiceert

De hostnaam van het apparaat (standaard pylon-monitor) wordt gebruikt als topic-prefix en discovery-node-id. Vervang deze hieronder door de hostnaam die je hebt gekozen. Alle tien sensoren zijn gegroepeerd onder één Home Assistant-apparaatkaart genaamd Pylon-Monitor.

Alle tien sensoren delen één state-topic waaruit ze hun waarden halen:

pylon-monitor/state

De payload, ongeveer elke 40 seconden vernieuwd (één volledige batterij-pollcyclus), 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,
  "state": "Discharging"
}

Het apparaat publiceert ook een beschikbaarheids-topic (online/offline) met een Last-Will-and-Testament, zodat elke sensor in Home Assistant correct grijs wordt als het apparaat stroom of WiFi verliest, in plaats van stilzwijgend te bevriezen op de laatste waarde:

pylon-monitor/status  →  "online" (retained) or "offline" (LWT, retained)

Optie 2 — REST API-polling

Geen MQTT-broker nodig. Het ingebouwde rest-platform van Home Assistant bevraagt het apparaat elke 30 seconden en maakt 6 sensoren aan. Het YAML-blok hieronder is exact hetzelfde als wat de firmware zelf genereert op de Settings-pagina (met je huidige IP al ingevuld) — kopieer het vandaar zonder te typen, of gebruik de versie hieronder.

De JSON die het apparaat teruggeeft

GET http://<DEVICE-IP>/api.json

{
  "system": "pylon-monitor",
  "firmware": "2.0",
  "summary": {
    "soc": 94,
    "voltage": 48.62,
    "current": -7.20,
    "power": -350.10,
    "state": "Discharging"
  },
  "health": {
    "soh": 96,
    "cycles": 486
  }
}

Dit is ingekort voor de leesbaarheid — het echte antwoord bevat ook de objecten temps, cells, net en alarms. Let op: SOH staat onder health, niet onder summary — een veelgemaakte copy-paste-fout.

Plak dit in configuration.yaml

rest:
  - resource: http://<DEVICE-IP>/api.json
    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 }}"

Herstart Home Assistant. De 6 sensoren verschijnen onder Instellingen → Apparaten & diensten → Entiteiten, doorzoekbaar via pylontech.

Node-RED

Gebruik een http request-node, methode GET, URL http://<APPARAAT-IP>/api.json, return a parsed JSON object. Lees vervolgens msg.payload.summary.soc (of een ander veld) verderop in de flow. Als MQTT op het apparaat is geconfigureerd, kun je ook rechtstreeks abonneren op pylon-monitor/state met een MQTT-in-node — geen polling nodig.

Jeedom

Installeer de JSON-plugin, wijs een apparaat aan naar http://<APPARAAT-IP>/api.json, en koppel vervolgens JSON-paden aan commando's (bijv. summary>soc, summary>voltage, summary>state).