Pylontech in Home Assistant, MQTT, JSON e Jeedom
Il cloud serve quando sei fuori. A casa, PylonCheck passa i suoi dati direttamente al tuo sistema sulla rete — senza cloud, senza account, e continua a funzionare anche se internet è giù.
Auto-discovery MQTT: zero YAML
Inserisci l’indirizzo del broker (e utente / password se presenti) nella pagina Impostazioni del box. In pochi secondi Home Assistant crea un dispositivo PylonCheck con i suoi sensori:
- Stato di carica, stato di salute, numero di cicli
- Tensione, corrente, potenza
- Temperatura della batteria e del BMS / MOSFET
- Stato di carica, numero di batterie, squilibrio celle (mV)
- Un segnale di disponibilità online / offline
rest.Topic
Tutti i topic sono retained: un sottoscrittore che parte dopo riceve subito gli ultimi valori. Il prefisso è l’hostname del box (predefinito pylon-check).
pylon-check/status online | offline (retained, last will)
pylon-check/state whole stack: soc, voltage, current, power, state…
pylon-check/battery1/state battery 1 of the stack
pylon-check/battery2/state battery 2 …
homeassistant/sensor/pylon-check/…/config auto-discovery (retained)Ogni messaggio state è un oggetto JSON con gli stessi campi dell’API qui sotto: lo stesso template funziona ovunque.
Una GET, tutta la batteria
GET http://pylon-check.local/api.json (o l’IP del box) restituisce lo stato completo. Esempio abbreviato:
{
"system": { "firmware": "1.0.1", "uptime": 86400 },
"battery_link": true,
"summary": { "soc": 87, "voltage": 52.41, "current": 23.5,
"power": 1231.6, "state": "Charging", "units": 3 },
"health": { "soh": 98, "cycles": 412 },
"temps": { "battery": 24.0, "mosfet": 26.5, "low": 23.0, "high": 25.1 },
"cells": { "count": 15, "min": 3271, "max": 3280, "delta": 9,
"mv": [3274, 3276, 3271, "…"] },
"unitsDetail": [
{ "label": "Battery 1", "voltage": 52.41, "current": 7.9,
"soc": 87, "soh": 98, "cycles": 412, "state": "Charging" }
]
}Una chiave di accesso facoltativa si imposta nelle Impostazioni; l’API si legge allora con ?key=…. I valori si aggiornano ogni pochi secondi.
Esempio REST per Home Assistant
# configuration.yaml — only needed if you prefer REST to MQTT
rest:
- resource: http://pylon-check.local/api.json
scan_interval: 30
sensor:
- name: "Pylontech SOC"
value_template: "{{ value_json.summary.soc }}"
unit_of_measurement: "%"
device_class: battery
- name: "Pylontech power"
value_template: "{{ value_json.summary.power }}"
unit_of_measurement: "W"
device_class: power
- name: "Pylontech cell spread"
value_template: "{{ value_json.cells.delta }}"
unit_of_measurement: "mV"Jeedom, Node-RED, openHAB, Domoticz
Jeedom
Installa il plugin jMQTT, puntalo al broker e iscriviti a pylon-check/#: lo stack e ogni batteria compaiono come equipaggiamenti. Oppure usa il plugin Script con l’API JSON.
Node-RED
Un nodo mqtt in su pylon-check/state, o un nodo http request su /api.json ogni 30 secondi.
openHAB, Domoticz, ioBroker
Qualsiasi sistema che parli MQTT o legga JSON via HTTP può usare PylonCheck. Niente di proprietario.
Domande
Home Assistant ha bisogno del cloud PylonCheck?
No. Home Assistant legge il box direttamente sulla tua rete. Cloud e Home Assistant possono funzionare insieme.
Devo scrivere YAML?
No, con l’auto-discovery MQTT i sensori compaiono da soli. Lo YAML serve solo se scegli l’integrazione REST.
Sostituisce l’integrazione dell’inverter?
La completa: l’inverter dà i flussi di potenza, PylonCheck ciò che sa la batteria stessa — SOH, celle, temperature, dettaglio per batteria.
Posso avere ogni batteria come sensori separati?
Sì. Ogni batteria ha il proprio topic MQTT e l’API JSON le elenca una per una.
La tua batteria, ovunque. Per 39 €.
Dashboard cloud, storico, avvisi, Home Assistant e MQTT inclusi. Nessun abbonamento.