Pylontech in Home Assistant: la guida completa all'integrazione MQTT e REST

Due vie d'accesso, entrambe già integrate nel firmware

Chiedete a dieci persone come collegherebbero una batteria Pylontech a Home Assistant e otterrete dieci mezze risposte diverse, con componenti personalizzati, repository HACS, o YAML copiato da un forum di tre anni fa. Con Pylon-Monitor non c'è da indovinare: il dispositivo integra due percorsi di integrazione direttamente nel firmware, e nessuno dei due richiede di installare nulla lato Home Assistant.

Entrambi leggono lo stesso dato di base — la porta Console della batteria — quindi la scelta non riguarda le capacità, ma ciò che avete già in funzione.

Opzione 1 — Auto-discovery MQTT, la via veloce

Se Home Assistant ha già in esecuzione il componente aggiuntivo Mosquitto broker (la maggior parte delle installazioni ce l'ha), questa è l'opzione da usare. Inserite IP del broker, porta, nome utente e password nella pagina Settings del dispositivo, salvate, e in circa cinque secondi dieci sensori compaiono automaticamente in Impostazioni → Dispositivi e servizi → MQTT — raggruppati sotto un'unica scheda dispositivo chiamata Pylon-Monitor. Niente YAML, nessun riavvio, nessuna entità da definire manualmente.

I dieci sensori: SOC, SOH, tensione, corrente, potenza, temperatura batteria, temperatura MOSFET, cicli di carica, stato della batteria e squilibrio delle celle. Più un segnale extra che conta più di quanto sembri: un topic di disponibilità sostenuto da un vero Last-Will-and-Testament MQTT, che fa sì che ogni sensore si oscuri correttamente in Home Assistant nel momento in cui il dispositivo perde alimentazione o WiFi — invece di rimanere silenziosamente bloccato sull'ultimo valore conosciuto, che è esattamente la modalità di guasto che frega le persone (un allarme che non scatta mai perché l'"ultimo SOC conosciuto" sembrava normale).

Opzione 2 — REST, se non usate MQTT

Nessun broker, nessun problema. La piattaforma rest integrata di Home Assistant può interrogare direttamente l'endpoint /api.json del dispositivo ogni 30 secondi e creare sei sensori — SOC, SOH, tensione, corrente, potenza e stato. Il blocco YAML non va scritto da zero: la pagina Settings del dispositivo lo genera da sola per voi, con l'IP attuale già inserito. Copiate, incollate in configuration.yaml, riavviate Home Assistant.

Quale scegliere in pratica?

• Avete già un broker Mosquitto attivo? Usate l'auto-discovery MQTT. Più veloce da configurare, dà più sensori, e solo il segnale di disponibilità vale la pena.
• Nessun broker, e non volete installarne uno solo per questo? REST funziona benissimo. I dieci secondi extra di latenza di polling rispetto al push quasi istantaneo di MQTT non contano per la telemetria della batteria — non cambia velocemente.
• Gestite una grande istanza HA con già decine di dispositivi MQTT? Un dispositivo in più sul broker non costa nulla. Andate con MQTT.

Cosa fare davvero con i sensori

Dieci (o sei) nuovi sensori, da soli, sono solo numeri su una scheda. Alcune idee di automazione per trasformarli in qualcosa di utile:

• Notifica SOC basso. Un'automazione semplice attivata quando il sensore SOC scende sotto una soglia — notifica push tramite l'app Home Assistant, senza bisogno dell'allarme Pushover proprio del dispositivo se preferite centralizzare gli avvisi in HA.
• Monitoraggio dello squilibrio delle celle. Lo squilibrio raramente sale di colpo, ma una lenta deriva verso l'alto nel corso di settimane è esattamente ciò che un grafico storico di Home Assistant coglie e che un'occhiata occasionale allo schermo TFT non vedrebbe mai.
• Una scheda dashboard accanto ai vostri dati solari/inverter. Se già monitorate produzione e consumo in Home Assistant, mettere i sensori SOC e potenza Pylontech sulla stessa dashboard vi dà finalmente il quadro completo in un unico posto, invece di passare da un'app all'altra.

Per approfondire cosa significano davvero questi numeri e quali meritano un vero allarme (rispetto a quelli che sono solo rumore di fondo), vedete Diagnostica Pylontech 101.

Risoluzione rapida dei problemi

• La riga MQTT resta rossa / non si connette: ricontrollate IP e credenziali del broker — un utente MQTT dedicato (vedi consiglio sopra) è la soluzione più comune quando un login HA riutilizzato fallisce inaspettatamente.
• Entità duplicate: avete configurato MQTT e REST contemporaneamente per gli stessi valori — rimuovetene uno.
• Un sensore mostra "non disponibile": se accade esattamente quando il dispositivo perde WiFi o alimentazione, è il segnale di disponibilità che funziona come previsto, non un bug.

Non usate Home Assistant?

Tutto quanto sopra si basa sullo stesso endpoint /api.json e sugli stessi topic MQTT che alimentano anche le integrazioni con Jeedom, Node-RED, Domoticz e openHAB — vedete tutti gli altri modi per collegare una batteria Pylontech a una piattaforma domotica se Home Assistant non è il vostro sistema.