Node-RED, Home Assistant o il vostro script, collegati alla manutenzione

Quando l’API HTTP è la strada giusta

FreeMaint decodifica da solo alcuni dispositivi: i contatori di energia Shelly e due sensori LoRaWAN Milesight. Tutto il resto passa dall’API HTTP, e questo copre gran parte di un sito industriale: un analizzatore di rete Modbus letto da Node-RED, un sensore di Home Assistant, un sistema di gestione dell’edificio che esporta i suoi punti, un PLC che pubblica già i suoi contatori, un sensore di vibrazione letto dal proprio gateway.

FreeMaint non parla direttamente Modbus, MQTT, BACnet né OPC UA. È una scelta voluta: il gateway che si trova già sulla vostra rete conosce il protocollo e la mappa dei registri, e a FreeMaint servono solo i valori. Un flusso Node-RED o un breve script che trasforma i registri in JSON richiede di solito poche righe.

• Flussi Node-RED che leggono dispositivi Modbus RTU o TCP
• Automazioni di Home Assistant che inoltrano i sensori
• Router Teltonika con Data to Server
• Gateway PLC e di gestione dell’edificio
• Script su un piccolo PC o un Raspberry Pi

Com’è fatta una richiesta

La richiesta è un POST all’URL che FreeMaint mostra quando create il collegamento, con due header: Authorization, che porta la chiave di accesso, e Content-Type impostato su application/json. Il corpo elenca degli elementi: ogni elemento è un identificativo di dispositivo, un nome visualizzato e un orario facoltativi, e i suoi punti. Un punto ha una chiave come power o energy_total, un valore e, idealmente, un’unità, una grandezza e, per i contatori, il tipo cumulativo.

FreeMaint risponde 202 quando i dati sono accettati e li memorizza in pochi secondi. Una richiesta malformata riceve una risposta 400 che indica il problema, così un gateway configurato male si corregge in pochi minuti invece di essere scoperto settimane dopo. Ogni collegamento accetta fino a 120 richieste al minuto; oltre questa soglia FreeMaint risponde 429 e il vostro sistema dovrebbe riprovare più tardi.

Ore di funzionamento ed energia dal vostro sistema

Se il vostro PLC conta già le ore di funzionamento, inviate il contatore come valore cumulativo e collegate il canale al contaore dell’asset: i piani preventivi scattano su di esso. Se comunica solo potenza o corrente, lasciate che sia FreeMaint a calcolare le ore di funzionamento da quel canale. Per l’energia, collegate il canale a un contatore di energia e FreeMaint registra una lettura ogni 15 minuti con il suo costo e la sua CO2.

Piani e limiti

L’API HTTP fa parte di FreeMaint Connect, nel piano Business a 99 USD al mese per azienda, a tariffa fissa, con 100 canali attivi. Il piano Enterprise ne comprende 5.000. Un canale inattivo non conta e i dati già ricevuti restano visibili su tutti i piani. Per leggere e scrivere il resto di FreeMaint, come ordini di lavoro, asset e ricambi, esistono anche un’API GraphQL nel piano Business e webhook in uscita firmati a partire dal piano Starter.