Sviluppa il tuo sistema di monitoraggio energetico con IAMMETER

Sviluppa il tuo sistema di monitoraggio energetico con IAMMETER

I misuratori di energia Wi-Fi IAMMETER forniscono interfacce dati aperte per sviluppatori, integratori di sistema e clienti che realizzano il proprio software di monitoraggio energetico.

Puoi recuperare le misurazioni direttamente dal misuratore, far sì che il misuratore carichi i dati sul tuo server, distribuire un servizio self-hosted IAMMETER o creare un'applicazione basata sulle API IAMMETER-Cloud.

Questa pagina è la guida di navigazione per sviluppatori per la scelta di un'architettura. Collega alle attuali definizioni dei protocolli e ai documenti di implementazione, senza duplicare ogni parametro API.

Se la tua prima domanda è se un misuratore IAMMETER può funzionare senza accesso a Internet o a IAMMETER-Cloud, inizia con Utilizzare un misuratore di energia Wi-Fi senza Internet o Cloud. Per un confronto orientato alle piattaforme, consulta Integrazione Self-hosted e Open-source.

1. Scegli l'architettura del tuo sistema

Ci sono quattro modi principali per utilizzare i dati IAMMETER nella tua applicazione.

Architettura	Flusso dati	Più indicato per	IAMMETER-Cloud richiesto?
Leggere il misuratore localmente	Applicazione → Misuratore	Dashboard LAN, automazione, PLC e SCADA	No
Far caricare i dati al misuratore	Misuratore → Server o broker del cliente	Cloud personalizzato, EMS, BMS e backend IoT	No
Distribuire software self-hosted IAMMETER	Misuratore → IAMMETER-Docker o IAMMETER-Central → Applicazione	Utenti che desiderano archiviazione e API senza costruire il backend completo	No
Basarsi sulle API IAMMETER-Cloud	Misuratore → IAMMETER-Cloud → Applicazione	Applicazioni che vogliono riutilizzare dati e servizi IAMMETER-Cloud	Sì

La scelta corretta dipende da dove devono essere archiviati i dati, se il progetto necessita di funzionamento indipendente da Internet, la frequenza di aggiornamento richiesta e quanto sviluppo backend si desidera mantenere.

2. Leggere i dati direttamente dal misuratore

Scegli questa architettura quando l'applicazione e il misuratore sono sulla stessa rete locale.

Misuratore IAMMETER ← API HTTP locale o Modbus TCP ← La tua applicazione

La tua applicazione controlla l'intervallo di polling e memorizza qualsiasi storico di cui ha bisogno. Non è richiesto alcun servizio cloud IAMMETER per il percorso dati locale.

2.1 API HTTP locale

Il misuratore fornisce endpoint HTTP locali per recuperare misurazioni come tensione, corrente, potenza attiva, energia importata ed energia esportata.

Gli endpoint di misurazione comuni includono:

• /api/monitorjson
• /api/monitor

L'accesso all'API HTTP locale è un punto di partenza pratico per:

• dashboard personalizzate;
• script eseguiti su PC, NAS o Raspberry Pi;
• integrazioni low-code;
• applicazioni locali che non richiedono polling al secondo.

Consulta la Guida all'API locale e all'interfaccia aperta IAMMETER per le definizioni aggiornate degli endpoint e gli esempi.

2.2 Modbus TCP

Utilizza Modbus TCP quando il progetto richiede:

• polling locale al secondo;
• integrazione PLC o SCADA;
• controllo della potenza in tempo reale;
• integrazione con un EMS o BMS industriale;
• un protocollo standard basato su registri.

Consulta la Guida ai registri Modbus TCP e all'integrazione IAMMETER.

2.3 Cosa deve fornire la tua applicazione

La lettura locale diretta restituisce le misurazioni del misuratore. La tua applicazione rimane responsabile per qualsiasi funzione aggiuntiva di cui ha bisogno, inclusi:

• archiviazione dati;
• aggregazione oraria, giornaliera e mensile;
• dashboard e report;
• utenti e permessi;
• allarmi e logica di automazione;
• backup e conservazione.

Se non vuoi costruire queste funzioni backend dall'inizio, considera IAMMETER-Docker o IAMMETER-Central.

3. Caricare i dati del misuratore direttamente sul tuo server

Scegli questa architettura quando il misuratore deve avviare la connessione e inviare dati a un endpoint gestito da te.

Misuratore IAMMETER → MQTT/MQTTS, HTTP/HTTPS o TCP/TLS → Il tuo server

Il firmware IAMMETER attuale supporta diverse interfacce di upload:

Interfaccia	Componente lato cliente	Applicazione tipica
MQTT / MQTTS	Broker e subscriber MQTT	Piattaforme IoT, automazione e pipeline di messaggi
HTTP / HTTPS	Endpoint HTTP	Backend REST, servizio cloud o EMS personalizzato
TCP / TLS	Server TCP	Collector personalizzato e integrazione a livello di protocollo

Il misuratore e il tuo server utilizzano una struttura JSON di misurazione IAMMETER coerente attraverso i metodi di upload supportati. Esamina la definizione dei dati prima di implementare il tuo parser.

Risorse di implementazione:

• Pubblicare i dati IAMMETER sul tuo broker MQTT
• Caricare i dati IAMMETER su un server di terze parti
• Definizione JSON delle misurazioni IAMMETER
• Firmware attuale, API locali e interfacce aperte
• Ultimo firmware IAMMETER e informazioni sull'aggiornamento

Un server sulla stessa LAN può funzionare senza accesso a Internet. Un endpoint remoto richiede comunque un percorso funzionante attraverso Internet, una WAN privata o una VPN.

4. Utilizzare il software self-hosted IAMMETER

IAMMETER offre due opzioni self-hosted per gli utenti che desiderano una distribuzione privata dei dati senza implementare ogni componente backend da soli.

4.1 IAMMETER-Docker

IAMMETER-Docker è un sistema di monitoraggio energetico self-hosted open-source. Fornisce raccolta dati locale, funzioni di monitoraggio di base, grafici e API.

È generalmente adatto per:

• individui e sviluppatori;
• distribuzioni su Raspberry Pi, mini PC e NAS;
• monitoraggio energetico domestico o solare su rete privata;
• progetti che necessitano di un'interfaccia funzionante oltre alle API;
• utenti che vogliono sviluppare un'interfaccia utente personalizzata su un backend già pronto.

Continua con:

• Distribuire IAMMETER-Docker
• Funzionalità avanzate di IAMMETER-Docker
• Modalità Datalogger offline

4.2 IAMMETER-Central

IAMMETER-Central è un middleware dati self-hosted per utenti aziendali, installatori e integratori di sistema.

Si concentra su:

• registrazione e gestione dei dispositivi IAMMETER;
• archiviazione delle misurazioni del misuratore in un database controllato dal cliente;
• fornitura di API standardizzate per un'applicazione cliente;
• separazione dell'acquisizione dati del dispositivo dall'ERP, EMS, BMS o frontend del cliente.

IAMMETER-Central non tenta di fornire la logica di business completa di un'applicazione di gestione energetica. È utile quando il cliente desidera un livello middleware dati mantenuto e costruirà la propria interfaccia utente o funzioni di business.

Consulta Opzioni di self-hosting IAMMETER per un confronto tra IAMMETER-Docker, IAMMETER-Central, piattaforme open-source e integrazione diretta con server.

5. Basarsi sulle API IAMMETER-Cloud

Utilizzare IAMMETER-Cloud è un altro modo per sviluppare una dashboard o un'applicazione personalizzata. In questa architettura, il misuratore carica i dati su IAMMETER-Cloud e la tua applicazione recupera i dati esposti dalle API IAMMETER-Cloud.

Misuratore IAMMETER → IAMMETER-Cloud → API Cloud → La tua applicazione

Questa opzione può ridurre lo sviluppo lato dispositivo e di acquisizione dati, ma non è un'architettura offline o indipendente dal cloud.

È adatta quando:

• il misuratore già invia i report a IAMMETER-Cloud;
• la tua applicazione vuole riutilizzare i dati ospitati nel cloud;
• l'accesso a Internet è disponibile;
• non è richiesto mantenere l'intera pipeline dati all'interno della rete locale.

Consulta la Documentazione API IAMMETER-Cloud per le operazioni API supportate e i requisiti di autenticazione.

6. Integrazione con una piattaforma open-source esistente

Prima di costruire un sistema di monitoraggio completo, verifica se una piattaforma esistente fornisce già le funzioni di archiviazione, dashboard e automazione di cui hai bisogno.

IAMMETER può essere integrato con:

• Home Assistant
• Node-RED
• OpenHAB
• ioBroker
• Zabbix
• ThingsBoard

Queste pagine specifiche per piattaforma sono le guide di implementazione. Per un confronto più ampio, utilizza la Panoramica sull'integrazione Self-hosted e Open-source.

7. Scegli il miglior punto di partenza

Requisito del progetto	Punto di partenza consigliato
Script semplice o dashboard LAN	API HTTP locale
Dati locali al secondo o controllo industriale	Modbus TCP
Infrastruttura MQTT esistente	Upload MQTT o MQTTS
Backend web esistente	Upload HTTP o HTTPS
Collector socket personalizzato	Upload TCP o TLS
Monitoraggio privato pronto all'uso per un utente individuale	IAMMETER-Docker
Middleware aziendale per ERP, EMS o BMS	IAMMETER-Central
Dashboard e automazione per smart home	Home Assistant
Applicazione basata su dati IAMMETER-Cloud esistenti	API IAMMETER-Cloud

8. Checklist di sviluppo

Prima dell'implementazione, conferma:

1. quali misurazioni e fasi fornisce il misuratore selezionato;
2. se i dati saranno acquisiti tramite polling o push;
3. l'intervallo di aggiornamento richiesto;
4. se il sistema deve funzionare durante un'interruzione di Internet;
5. dove saranno archiviati i dati storici;
6. se è richiesto il trasporto protetto con TLS;
7. come l'applicazione autenticherà utenti e dispositivi;
8. se IAMMETER-Cloud deve rimanere parte dell'architettura;
9. la versione del firmware utilizzata per la validazione;
10. come verranno eseguiti il backup di configurazione, log e dati.

9. Documentazione correlata

• Utilizzare IAMMETER senza Internet o IAMMETER-Cloud
• API locali e interfacce aperte IAMMETER
• Panoramica sull'integrazione Self-hosted e Open-source
• Caricare dati su un server di terze parti
• Integrazione del misuratore di energia MQTT
• Integrazione del misuratore di energia Modbus TCP
• Opzioni di self-hosting IAMMETER

Ultimo aggiornamento: 16 luglio 2026