Oltre Home Assistant: Pylontech con Jeedom, Node-RED, Domoticz e openHAB

Un unico endpoint JSON, tutte le piattaforme

Home Assistant riceve la maggior parte dell'attenzione — comprensibile, è la piattaforma domotica più diffusa, e le abbiamo dedicato un'intera guida. Ma il meccanismo reale sottostante è deliberatamente semplice: un unico endpoint HTTP, GET /api.json?key=… (la chiave di accesso mostrata nei Settings del dispositivo), JSON semplice come risposta. Tutto ciò che può fare una richiesta HTTP e analizzare JSON può estrarne i dati della batteria Pylontech. Questo vale per Jeedom, Node-RED, Domoticz, openHAB, Grafana, uno script Python, un cron job con curl — tutti leggono esattamente lo stesso dato, nessuno ha bisogno di un SDK proprietario o di una chiave API.

Jeedom

Jeedom non ha bisogno di un plugin Pylontech dedicato. Installate il plugin standard JSON dallo store Jeedom, puntate un'apparecchiatura a http://<ip-dispositivo>/api.json?key=<access-key>, e mappate i percorsi JSON sui comandi — summary>soc, summary>voltage, summary>state, net>rssi, e così via. Un intervallo di polling di 30–60 secondi è più che sufficiente; la telemetria della batteria non cambia abbastanza velocemente da richiedere qualcosa di più stretto.

Node-RED

Due opzioni, che rispecchiano quasi esattamente la scelta per Home Assistant. Interrogare con un nodo http request (metodo GET, URL http://<ip-dispositivo>/api.json?key=<access-key>, tipo di ritorno "a parsed JSON object"), attivato da un nodo inject su un timer, poi leggere campi come msg.payload.summary.soc più avanti nel flusso. Oppure, se MQTT è già configurato sul dispositivo, iscriversi direttamente a pylon-monitor/state con un nodo MQTT-in — gli aggiornamenti arrivano man mano che avvengono, nessun ciclo di polling da gestire.

Domoticz

Domoticz non include nativamente un tipo di sensore per il polling JSON, ma la soluzione standard è ben collaudata: un piccolo script (Python, o lo scripting eventi Lua/Blockly proprio di Domoticz) recupera /api.json con un timer e invia i valori a sensori Dummy/Virtual tramite l'API JSON propria di Domoticz. Richiede qualche minuto di configurazione in più rispetto a Jeedom o Node-RED, ma è un'operazione da fare una sola volta, e i sensori si comportano poi esattamente come qualsiasi altro dispositivo Domoticz — grafici storici completi, notifiche, tutto.

openHAB

L'HTTP Binding di openHAB gestisce questo nativamente: definite un Thing che punta a http://<ip-dispositivo>/api.json?key=<access-key> con un intervallo di aggiornamento, poi mappate i singoli channel su percorsi JSON tramite una trasformazione (JSONPath) per estrarre summary.soc, summary.voltage, ecc. in Item separati. Nessun binding personalizzato necessario — quello HTTP generico copre tutto.

Tuya / SmartLife — un ponte non ufficiale via IFTTT, Make.com o Apilio

I dispositivi Tuya e l'app SmartLife comunicano solo con il cloud proprio di Tuya — non esiste un endpoint JSON generico dal loro lato come qui, e non esiste un'integrazione ufficiale Pylontech-Tuya. Nemmeno questo dispositivo pretende di esserlo. Ciò che offre è il pezzo mancante per un ponte no-code: attivate Settings > Public JSON access > "Enable a real public URL" e pylon-monitor.com ripubblica il JSON del vostro dispositivo su un link HTTPS stabile, raggiungibile da qualsiasi luogo — senza port forwarding, senza VPN, nulla esposto sul vostro router.

Con questo URL in mano, una piattaforma di automazione no-code (con piano gratuito) può interrogarlo e inviare i valori a un dispositivo virtuale Tuya o a un webhook rivolto a SmartLife:

• IFTTT — un applet Webhooks/JSON che interroga l'URL secondo una pianificazione, alimentando un'azione SmartLife.
• Make.com (ex Integromat) — un modulo HTTP che legge l'URL, un parser JSON, poi un modulo Tuya/SmartLife o un webhook di ritorno verso la piattaforma IoT di Tuya.
• Apilio — costruito specificamente attorno alle automazioni Tuya/SmartLife, con un proprio trigger di richiesta HTTP che può interrogare direttamente un URL come questo.

Nulla di tutto ciò è ufficialmente supportato da Tuya o da Pylon-Monitor — è un ponte che assemblate voi stessi con strumenti gratuiti esistenti, non un'integrazione certificata. Ma se volete il SOC o lo stato della vostra batteria su una dashboard SmartLife, o in una routine Alexa/Google che capisce solo dispositivi Tuya, l'URL pubblico sopra è il pezzo che vi mancava.

Grafana, script e qualsiasi altra cosa

Se uno strumento ha una sorgente dati "JSON API" o "HTTP" — il plugin JSON API di Grafana, l'input HTTP di Telegraf, uno script Python con requests, una riga shell con curl | jq — può leggere questo endpoint allo stesso modo. Questo non è deliberatamente un giardino recintato: al dispositivo non importa cosa c'è dall'altra parte della richiesta HTTP, il che significa che non diventa obsoleto il giorno in cui cambiate piattaforma domotica.

Polling vs MQTT: cosa usare e dove

La maggior parte delle piattaforme sopra elencate interroga di default l'API JSON con un timer, il che è semplice e funziona ovunque. Se la vostra piattaforma parla anche MQTT (Node-RED e Home Assistant lo fanno entrambi nativamente), iscriversi a pylon-monitor/state invece fa sì che gli aggiornamenti arrivino nel momento in cui vengono pubblicati anziché attendere il polling successivo — e ottenete anche gratuitamente il topic di disponibilità retained, per sapere immediatamente se il dispositivo stesso è andato offline invece di indovinarlo da un valore non aggiornato. Interrogare ogni 30–60 secondi resta comunque più che sufficiente per tutto ciò che riguarda la batteria — non sono dati che beneficiano di una latenza sotto il secondo.