Intégration Home Assistant

Choisissez votre intégration

Ouvrez la page Settings de l'appareil (http://<IP-APPAREIL>/settings). Les deux options se configurent depuis là. Choisissez-en une — elles sont indépendantes et peuvent être activées/désactivées séparément.

Option 1 — Auto-découverte MQTT

Recommandé si vous utilisez déjà l'add-on Mosquitto / MQTT broker dans Home Assistant. Une fois la connexion au broker configurée, l'appareil publie ses configurations de découverte Home Assistant sur les topics standards homeassistant/sensor/…, et les capteurs apparaissent dans Paramètres → Appareils et services → MQTT en quelques secondes — regroupés sous un seul appareil nommé Pylon-Monitor.

Ce que vous renseignez sur l'appareil

Sur la page Settings de l'appareil, ouvrez la carte MQTT Home Assistant et remplissez ces quatre champs exactement comme le firmware les attend :

Enregistrez. La ligne MQTT du tableau de bord du Pylon-Monitor passe au bleu (Connected) en ~5 secondes, et les dix capteurs ci-dessous sont publiés automatiquement — aucune configuration manuelle d'entité. Pour désactiver MQTT, videz simplement les quatre champs et enregistrez.

Topics publiés par le firmware

Le nom d'hôte de l'appareil (par défaut pylon-monitor) sert de préfixe de topic et d'identifiant de découverte. Remplacez-le ci-dessous par le nom d'hôte que vous avez choisi. Les dix capteurs sont regroupés sous une seule carte appareil Home Assistant nommée Pylon-Monitor.

Les dix capteurs partagent un unique topic d'état depuis lequel ils tirent leurs valeurs :

pylon-monitor/state

La charge utile, actualisée environ toutes les 40 secondes (un cycle complet d'interrogation de la batterie), ressemble à ceci :

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

L'appareil publie aussi un topic de disponibilité (en ligne/hors ligne) avec un Last-Will-and-Testament, afin que chaque capteur grise correctement dans Home Assistant si l'appareil perd l'alimentation ou le WiFi, au lieu de rester figé silencieusement sur sa dernière valeur :

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

Option 2 — Interrogation API REST

Aucun broker MQTT requis. La plateforme rest intégrée à Home Assistant interroge l'appareil toutes les 30 secondes et crée 6 capteurs. Le bloc YAML ci-dessous est exactement celui que le firmware génère lui-même dans la page Settings (avec votre IP actuelle pré-remplie) — copiez-le depuis là sans rien taper, ou utilisez la version ci-dessous.

Le JSON renvoyé par l'appareil

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

Ceci est simplifié pour la lisibilité — la vraie réponse inclut aussi les objets temps, cells, net et alarms. Notez que SOH se trouve sous health, pas sous summary — une erreur de copier-coller fréquente.

Collez ceci dans 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 }}"

Redémarrez Home Assistant. Les 6 capteurs apparaissent sous Paramètres → Appareils et services → Entités, recherchables via pylontech.

Node-RED

Utilisez un nœud http request, méthode GET, URL http://<IP-APPAREIL>/api.json, retour a parsed JSON object. Lisez ensuite msg.payload.summary.soc (ou tout autre champ) en aval. Si MQTT est configuré sur l'appareil, vous pouvez aussi vous abonner directement à pylon-monitor/state avec un nœud MQTT-in — aucune interrogation nécessaire.

Jeedom

Installez le plugin JSON, pointez un équipement vers http://<IP-APPAREIL>/api.json, puis associez les chemins JSON à des commandes (ex. summary>soc, summary>voltage, summary>state).