In breve: ci sono due modi per portare una batteria Pylontech in Home Assistant con Pylon-Monitor, ed entrambi sono già nel dispositivo. Se usate il broker Mosquitto, scegliete l'auto-discovery MQTT: quattro campi da compilare e undici sensori compaiono da soli, più i sensori di ogni batteria. Senza MQTT, scegliete la piattaforma REST: il dispositivo genera lo YAML per voi, pronto da incollare. Nessun componente personalizzato, niente HACS.
Due strade, entrambe già nel firmware
Cercando «Pylontech Home Assistant» si trovano componenti personalizzati, repository HACS e YAML copiato da forum di anni fa. Con Pylon-Monitor non c'è nulla da installare in Home Assistant. I due metodi leggono gli stessi dati dalla porta Console della batteria: la scelta quindi non dipende dalle funzioni, ma da ciò che avete già in funzione.
Opzione 1: auto-discovery MQTT (la più rapida)
Se Home Assistant ha già il componente aggiuntivo Mosquitto broker, come la maggior parte delle installazioni, usate questa. Inserite IP, porta, utente e password del broker nella pagina Settings del dispositivo e salvate. Circa cinque secondi dopo, undici sensori compaiono in Impostazioni → Dispositivi e servizi → MQTT, raggruppati in un unico dispositivo chiamato Pylon-Monitor. Niente YAML, niente riavvio, nessuna entità da creare a mano.
Gli undici sensori sono SOC, SOH, tensione, corrente, potenza, temperatura della batteria, temperatura dei MOSFET, cicli di carica, stato della batteria, squilibrio delle celle e numero di batterie. L'ultimo è stato aggiunto su richiesta di un cliente: l'API JSON lo aveva già, ma averlo in MQTT evita una chiamata REST separata. Con più batterie, ogni unità ha anche i propri sensori (SOC, SOH, cicli, tensione, stato), con modello, versione del BMS e numero di serie come attributi.
C'è poi un topic di disponibilità, basato su un messaggio MQTT di «ultime volontà». Se il dispositivo perde alimentazione o WiFi, tutti i sensori diventano grigi in Home Assistant invece di restare bloccati sull'ultimo valore. Conta più di quanto sembri: un SOC bloccato che sembra normale è proprio il motivo per cui un allarme di batteria scarica non scatta mai.

Il cavo che collega la batteria master alla prima slave deve partire dal LINK PORT 1 della master — mai dal LINK PORT 0. Si inserisce nel LINK PORT 0 della slave, e ogni batteria successiva ripete lo stesso schema 1 → 0. Collegato al contrario, la master non vede mai il resto dello stack e il Pylon-Monitor mostrerà sempre una sola batteria, per quante ne abbiate.
Opzione 2: REST, se non usate MQTT
Niente broker? La piattaforma rest integrata in Home Assistant può leggere il /api.json del dispositivo ogni 30 secondi e creare sei sensori: SOC, SOH, tensione, corrente, potenza e stato. Non dovete scrivere lo YAML. La pagina Settings del dispositivo lo genera con il vostro IP già inserito e, con il firmware recente, contiene anche la chiave di accesso che l'API ora richiede. Copiate, incollate in configuration.yaml, riavviate Home Assistant.
configuration.yaml, senza modifiche.
Quale scegliere
- Avete già un broker Mosquitto: auto-discovery MQTT. Più veloce da configurare, più sensori, e il solo segnale di disponibilità vale la scelta.
- Niente broker, e nessuna voglia di installarne uno solo per questo: REST va benissimo. Una lettura ogni 30 secondi invece di un invio immediato non cambia nulla per una batteria, i suoi valori non si muovono così in fretta.
- Una grande installazione Home Assistant con decine di dispositivi MQTT: uno in più sul broker non costa nulla. Andate su MQTT.
Più inverter e più pile di batterie separate? Ogni pila ha il suo Pylon-Monitor, e ognuno compare come dispositivo distinto in Home Assistant. Un cliente con tre pile da otto US2000 ce l'ha chiesto; ecco come funziona.
Cosa fare con i sensori
Dei sensori da soli sono numeri su una scheda. Alcune automazioni che li rendono utili:
- Avviso di batteria scarica. Un'automazione che scatta quando il SOC scende sotto una soglia e invia una notifica tramite l'app di Home Assistant. Comoda se preferite tenere tutti gli avvisi in Home Assistant invece di usare l'allarme Pushover del dispositivo.
- Tenere d'occhio lo squilibrio delle celle. Raramente salta da un giorno all'altro, ma una lenta crescita nell'arco di settimane è esattamente ciò che mostra un grafico storico di Home Assistant e che un'occhiata allo schermo non vede.
- Una scheda accanto ai dati solari. Se seguite già produzione e consumi in Home Assistant, mettere SOC e potenza della Pylontech nella stessa dashboard vi dà il quadro completo in un solo posto.
Cosa significano questi numeri, e quali meritano un vero allarme, è spiegato nella nostra guida a SOC, SOH e scarto tra le celle.
Risoluzione rapida dei problemi
- La riga MQTT resta rossa: controllate l'IP del broker e le credenziali. Un utente MQTT dedicato (vedi il consiglio sopra) risolve quasi sempre il caso di un login Home Assistant riutilizzato e rifiutato.
- Entità doppie: MQTT e REST sono configurati per gli stessi valori. Togliete uno dei due.
- Un sensore risulta «non disponibile»: se succede proprio quando il dispositivo perde WiFi o alimentazione, è il segnale di disponibilità che fa il suo lavoro, non un bug.
- I sensori REST si sono fermati dopo un aggiornamento: il firmware recente richiede la chiave di accesso sull'API. Ricopiate lo YAML dalla pagina Settings, ora contiene la chiave.
Non usate Home Assistant?
Tutto questo si basa sullo stesso endpoint /api.json e sugli stessi topic MQTT usati per Jeedom, Node-RED, Domoticz e openHAB. Questa guida copre le altre piattaforme.
Tuya / SmartLife
Tuya e SmartLife parlano solo con il cloud di Tuya, e non esiste un'integrazione Pylontech ufficiale per loro. Potete comunque costruire un ponte non ufficiale con IFTTT, Make.com o Apilio, usando l'URL pubblico che il dispositivo può pubblicare (Settings > Public JSON access > «Enable a real public URL»). I passaggi sono nella nostra guida al monitoraggio Pylontech e nella nostra risposta a un cliente che l'ha chiesto.
Domande frequenti
- Serve un broker MQTT per usare Pylontech in Home Assistant?
- No. Se non gestite un broker MQTT, la piattaforma REST integrata di Home Assistant può interrogare direttamente l'API JSON del dispositivo e creare sei sensori — nessun broker richiesto.
- Quanti sensori dà il monitoraggio Pylontech in Home Assistant?
- L'auto-discovery MQTT crea 11 sensori più un segnale di disponibilità. La piattaforma REST crea 6 sensori dagli stessi dati di base. Se il vostro pack conta più di una batteria Pylontech, MQTT pubblica anche 5 sensori per ogni batteria (SOC, SOH, cicli, tensione, stato), e l'API JSON espone sempre il dettaglio completo per batteria indipendentemente dall'integrazione usata.
- Posso usare MQTT e REST contemporaneamente?
- Potete, ma non dovreste per gli stessi valori — crea entità duplicate. Scegliete MQTT se avete un broker (copre tutto ciò che fa REST, e altro); usate REST solo se non lo avete.
Pylon-Monitor le ha entrambe: l'auto-discovery MQTT e il generatore di YAML REST sono nel dispositivo, pronti appena lo collegate.
Ordina ora — 64 € Acquisto una tantum, 64 € in totale — IVA non applicabile, nessun abbonamento.