Progettato e realizzato in Francia 6K fan su Facebook · Seguiteci
HOME ASSISTANT8 min di letturaDal team Pylon-MonitorAggiornato il

Pylontech in Home Assistant: auto-discovery MQTT o REST

Due strade, entrambe nel firmware, nessuna richiede un componente personalizzato. Come funziona ciascuna, cosa offre e quale scegliere.

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.

Pagina Settings di Pylon-Monitor con i campi del broker MQTT di Home Assistant compilati
IP del broker, porta, utente, password: è tutta la configurazione MQTT sul dispositivo.
Pannello di una batteria Pylontech master: il cavo RJ45 nella porta CONSOLE alimenta il Pylon-Monitor, mentre il cavo di collegamento parte dal LINK PORT 1 verso la batteria slave
Sulla batteria master: CONSOLE verso il Pylon-Monitor, LINK PORT 1 verso la batteria slave.
L'errore che fanno quasi tutti: LINK PORT 1, non LINK PORT 0
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.
Consiglio: create un utente MQTT dedicato al dispositivo (nella configurazione del componente Mosquitto o nelle impostazioni Persone di Home Assistant) invece di riutilizzare il vostro. Ci vuole un minuto e potrete revocargli l'accesso separatamente in futuro.

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.

Blocco YAML REST per Home Assistant generato automaticamente dal dispositivo Pylon-Monitor
Il blocco REST, generato dal dispositivo con l'IP giusto. Niente da digitare a memoria.
Editor configuration.yaml di Home Assistant con il blocco di sensori REST Pylon-Monitor incollato
Incollato così com'è in configuration.yaml, senza modifiche.
Scheda Indicatore di Home Assistant con l'entità Pylontech SOC selezionata, al 50 %
Uno dei nuovi sensori (Pylontech SOC) su una scheda Indicatore, qui al 50 %.
Non usate entrambi per gli stessi valori. Auto-discovery MQTT più blocco REST significa entità doppie. Sceglietene uno. MQTT copre già tutto ciò che fa REST, con cinque sensori in più, i sensori per batteria e il segnale di disponibilità: raramente c'è motivo di combinarli.

Quale scegliere

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:

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

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.

Unisciti ai 6000 fan di Pylon-Monitor su Facebook

Novità, aggiornamenti firmware, installazioni reali e consigli: seguite la pagina e fate le vostre domande alla community.

Seguiteci su Facebook