Home Assistant Integration

Wählen Sie Ihre Integration

Öffnen Sie die Settings-Seite des Geräts (http://<GERÄTE-IP>/settings). Beide Optionen werden dort konfiguriert. Wählen Sie eine — sie sind unabhängig und können separat aktiviert/deaktiviert werden.

Option 1 — MQTT-Auto-Discovery

Empfohlen, wenn Sie bereits das Add-on Mosquitto / MQTT broker in Home Assistant verwenden. Sobald die Broker-Verbindung eingerichtet ist, veröffentlicht das Gerät Home-Assistant-Discovery-Konfigurationen auf den Standard-Topics homeassistant/sensor/…, und die Sensoren erscheinen innerhalb weniger Sekunden unter Einstellungen → Geräte & Dienste → MQTT — gruppiert unter einem einzigen Gerät namens Pylon-Monitor.

Was Sie am Gerät eingeben

Öffnen Sie auf der Settings-Seite des Geräts die Karte MQTT Home Assistant und füllen Sie diese vier Felder genau so aus, wie die Firmware sie erwartet:

Speichern. Die MQTT-Zeile im Dashboard des Pylon-Monitor wird innerhalb von ~5 Sekunden blau (Connected), und die zehn Sensoren unten werden automatisch veröffentlicht — keine manuelle Entitätskonfiguration nötig. Um MQTT zu deaktivieren, leeren Sie einfach die vier Felder und speichern Sie.

Von der Firmware veröffentlichte Topics

Der Gerätehostname (Standard pylon-monitor) wird als Topic-Präfix und Discovery-Node-ID verwendet. Ersetzen Sie ihn unten durch den von Ihnen gewählten Hostnamen. Alle zehn Sensoren sind unter einer Home-Assistant-Gerätekarte namens Pylon-Monitor gruppiert.

Alle zehn Sensoren teilen sich ein einziges State-Topic, aus dem sie ihre Werte beziehen:

pylon-monitor/state

Die Nutzlast, etwa alle 40 Sekunden aktualisiert (ein vollständiger Batterie-Abfragezyklus), sieht so aus:

{
  "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"
}

Das Gerät veröffentlicht außerdem ein Verfügbarkeits-Topic (online/offline) mit einem Last-Will-and-Testament, sodass jeder Sensor in Home Assistant korrekt ausgegraut wird, wenn das Gerät Strom oder WLAN verliert, statt stillschweigend auf seinem letzten Wert einzufrieren:

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

Option 2 — REST-API-Abfrage

Kein MQTT-Broker nötig. Die in Home Assistant eingebaute rest-Plattform fragt das Gerät alle 30 Sekunden ab und erstellt 6 Sensoren. Der YAML-Block unten ist genau der, den die Firmware selbst auf der Settings-Seite generiert (mit bereits eingetragener aktueller IP) — kopieren Sie ihn von dort ohne zu tippen, oder verwenden Sie die Version unten.

Das vom Gerät zurückgegebene JSON

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
  }
}

Zur besseren Lesbarkeit gekürzt — die echte Antwort enthält außerdem die Objekte temps, cells, net und alarms. Beachten Sie: SOH befindet sich unter health, nicht unter summary — ein häufiger Copy-&-Paste-Fehler.

Fügen Sie dies in configuration.yaml ein

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 }}"

Starten Sie Home Assistant neu. Die 6 Sensoren erscheinen unter Einstellungen → Geräte & Dienste → Entitäten, auffindbar über pylontech.

Node-RED

Verwenden Sie einen http request-Node, Methode GET, URL http://<GERÄTE-IP>/api.json, Rückgabe a parsed JSON object. Lesen Sie anschließend msg.payload.summary.soc (oder ein beliebiges anderes Feld) weiter unten im Flow. Falls MQTT auf dem Gerät konfiguriert ist, können Sie auch direkt mit einem MQTT-in-Node pylon-monitor/state abonnieren — kein Abfragen nötig.

Jeedom

Installieren Sie das JSON-Plugin, richten Sie ein Gerät auf http://<GERÄTE-IP>/api.json aus und ordnen Sie dann JSON-Pfade Befehlen zu (z. B. summary>soc, summary>voltage, summary>state).