Ho sentim, el teu navegador no admet JavaScript!
Inicia sessió

Desenvolupeu el vostre propi sistema de monitorització energètica amb IAMMETER

Desenvolupeu el vostre propi sistema de monitorització energètica amb IAMMETER

Els comptadors d'energia Wi-Fi d'IAMMETER ofereixen interfícies de dades obertes per a desenvolupadors, integradors de sistemes i clients que construeixen el seu propi programari de monitorització energètica.

Podeu recuperar les mesures directament del comptador, fer que el comptador enviï les dades al vostre servidor, desplegar un servei allotjat en local d'IAMMETER o construir una aplicació sobre les API d'IAMMETER-Cloud.

Aquesta pàgina és la guia de navegació per a desenvolupadors sobre com triar una arquitectura. Enllaça a les definicions de protocol i als documents d'implementació actuals, en comptes de duplicar cada paràmetre de les API.

Si la vostra primera pregunta és si un comptador IAMMETER pot funcionar sense accés a Internet ni a IAMMETER-Cloud, comenceu amb Utilitzar un comptador d'energia Wi-Fi sense Internet ni núvol. Per a una comparació orientada a plataformes, vegeu Integració autoallotjada i de codi obert.

1. Tria de l'arquitectura del vostre sistema

Hi ha quatre maneres principals d'utilitzar les dades d'IAMMETER en la vostra pròpia aplicació.

Arquitectura Flux de dades Més adequada per a Requereix IAMMETER-Cloud?
Llegir el comptador localment Aplicació → Comptador Quadres de comandament LAN, automatització, PLC i SCADA No
Fer que el comptador enviï les dades Comptador → Servidor o broker del client Núvols personalitzats, EMS, BMS i backends IoT No
Desplegar el programari autoallotjat d'IAMMETER Comptador → IAMMETER-Docker o IAMMETER-Central → Aplicació Usuaris que volen emmagatzematge i API sense construir el backend complet No
Construir sobre les API d'IAMMETER-Cloud Comptador → IAMMETER-Cloud → Aplicació Aplicacions que volen reutilitzar les dades i els serveis d'IAMMETER-Cloud

L'elecció correcta depèn d'on s'han d'emmagatzemar les dades, de si el projecte necessita funcionar sense Internet, de la freqüència d'actualització requerida i de la quantitat de desenvolupament de backend que voleu mantenir.

2. Llegir les dades directament del comptador

Trieu aquesta arquitectura quan l'aplicació i el comptador es troben a la mateixa xarxa local.

Comptador IAMMETER ← API HTTP local o Modbus TCP ← La vostra aplicació

La vostra aplicació controla l'interval de consulta (polling) i emmagatzema l'historial que necessiti. No es requereix cap servei al núvol d'IAMMETER per a la via de dades local.

2.1 API HTTP local

El comptador ofereix endpoins HTTP locals per recuperar mesures com ara tensió, corrent, potència activa, energia importada i energia exportada.

Els endpoins de mesura habituals inclouen:

  • /api/monitorjson
  • /api/monitor

L'accés a l'API HTTP local és un punt de partida pràctic per a:

  • quadres de comandament personalitzats;
  • scripts que s'executen en un PC, NAS o Raspberry Pi;
  • integracions de baix codi;
  • aplicacions locals que no requereixen consultes cada segon.

Consulteu la Guia d'API local i interfícies obertes d'IAMMETER per a les definicions d'endpoins i els exemples actuals.

2.2 Modbus TCP

Utilitzeu Modbus TCP quan el projecte requereixi:

  • consulta local cada segon;
  • integració amb PLC o SCADA;
  • control de potència en temps real;
  • integració amb un EMS o BMS industrial;
  • un protocol estàndard basat en registres.

Consulteu la Guia de registres i integració Modbus TCP d'IAMMETER.

2.3 Què ha de proporcionar la vostra aplicació

La lectura local directa retorna les mesures del comptador. La vostra aplicació continua sent responsable de qualsevol funció addicional que requereixi, incloent-hi:

  • emmagatzematge de dades;
  • agregació horària, diària i mensual;
  • quadres de comandament i informes;
  • usuaris i permisos;
  • alarmes i lògica d'automatització;
  • còpies de seguretat i retenció.

Si no voleu construir aquestes funcions de backend des del principi, considereu IAMMETER-Docker o IAMMETER-Central.

3. Enviar les dades del comptador directament al vostre servidor

Trieu aquesta arquitectura quan el comptador hagi d'iniciar la connexió i enviar dades a un endpoint gestionat per vosaltres.

Comptador IAMMETER → MQTT/MQTTS, HTTP/HTTPS o TCP/TLS → El vostre servidor

El firmware actual d'IAMMETER admet diverses interfícies d'enviament:

Interfície Component del costat del client Aplicació típica
MQTT / MQTTS Broker i subscriptor MQTT Plataformes IoT, automatització i canonades de missatges
HTTP / HTTPS Endpoint HTTP Backend REST, servei al núvol o EMS personalitzat
TCP / TLS Servidor TCP Recopilador personalitzat i integració a nivell de protocol

El comptador i el vostre servidor utilitzen una estructura JSON de mesures IAMMETER coherent en tots els mètodes d'enviament admesos. Reviseu la definició de dades abans d'implementar el vostre analitzador.

Recursos d'implementació:

Un servidor a la mateixa LAN pot funcionar sense accés a Internet. Un endpoint remot encara requereix una ruta funcional a través d'Internet, una WAN privada o una VPN.

4. Utilitzar el programari autoallotjat d'IAMMETER

IAMMETER ofereix dues opcions autoallotjades per als usuaris que volen un desplegament privat de dades sense implementar ells mateixos tots els components del backend.

4.1 IAMMETER-Docker

IAMMETER-Docker és un sistema de monitorització energètica de codi obert i autoallotjat. Proporciona recollida de dades local, funcions de monitorització bàsiques, gràfics i API.

En general, és adequat per a:

  • particulars i desenvolupadors;
  • desplegaments en Raspberry Pi, mini PC i NAS;
  • monitorització d'energia domèstica o solar en una xarxa privada;
  • projectes que necessiten una interfície funcional a més de les API;
  • usuaris que volen desenvolupar una interfície personalitzada sobre un backend ja preparat.

Continueu amb:

4.2 IAMMETER-Central

IAMMETER-Central és un middleware de dades autoallotjat per a usuaris empresarials, instal·ladors i integradors de sistemes.

Se centra en:

  • el registre i la gestió de dispositius IAMMETER;
  • l'emmagatzematge de les mesures dels comptadors en una base de dades controlada pel client;
  • la provisió d'API estandarditzades per a l'aplicació del client;
  • la separació de la ingesta de dades dels dispositius respecte de l'ERP, EMS, BMS o front-end del client.

IAMMETER-Central no pretén proporcionar la lògica de negoci completa d'una aplicació de gestió energètica. És útil quan el client vol una capa de middleware de dades mantinguda i construirà la seva pròpia interfície d'usuari o funcions de negoci.

Consulteu Opcions d'autoallotjament d'IAMMETER per a una comparació entre IAMMETER-Docker, IAMMETER-Central, plataformes de codi obert i integració directa amb servidor.

5. Construir sobre les API d'IAMMETER-Cloud

Utilitzar IAMMETER-Cloud és una altra manera de desenvolupar un quadre de comandament o una aplicació personalitzada. En aquesta arquitectura, el comptador envia les dades a IAMMETER-Cloud i la vostra aplicació recupera les dades exposades per les API d'IAMMETER-Cloud.

Comptador IAMMETER → IAMMETER-Cloud → API al núvol → La vostra aplicació

Aquesta opció pot reduir el desenvolupament del costat del dispositiu i de la ingesta de dades, però no és una arquitectura fora de línia ni independent del núvol.

És adequada quan:

  • el comptador ja informa a IAMMETER-Cloud;
  • la vostra aplicació vol reutilitzar les dades allotjades al núvol;
  • hi ha accés a Internet disponible;
  • no es requereix mantenir la canonada de dades completa dins de la xarxa local.

Consulteu la Documentació de l'API d'IAMMETER-Cloud per a les operacions d'API admeses i els requisits d'autenticació.

6. Integrar-se amb una plataforma de codi obert existent

Abans de construir un sistema de monitorització complet, comproveu si una plataforma existent ja proporciona les funcions d'emmagatzematge, quadres de comandament i automatització que necessiteu.

IAMMETER es pot integrar amb:

Aquestes pàgines específiques per a plataformes són les guies d'implementació. Per a una comparació més àmplia, utilitzeu la Visió general d'integració autoallotjada i de codi obert.

7. Trieu el millor punt de partida

Requisit del projecte Punt de partida recomanat
Script o quadre de comandament LAN senzill API HTTP local
Dades locals cada segon o control industrial Modbus TCP
Infraestructura MQTT existent Enviament per MQTT o MQTTS
Backend web existent Enviament per HTTP o HTTPS
Recopilador de sockets personalitzat Enviament per TCP o TLS
Monitorització privada preparada per utilitzar per a un usuari individual IAMMETER-Docker
Middleware empresarial per a ERP, EMS o BMS IAMMETER-Central
Quadre de comandament i automatització per a llar intel·ligent Home Assistant
Aplicació construïda sobre dades existents d'IAMMETER-Cloud API d'IAMMETER-Cloud

8. Llista de verificació per al desenvolupament

Abans de la implementació, confirmeu:

  1. quines mesures i fases proporciona el comptador seleccionat;
  2. si les dades es consultaran (polling) o s'enviaran (push);
  3. l'interval d'actualització requerit;
  4. si el sistema ha de funcionar durant un tall d'Internet;
  5. on s'emmagatzemaran les dades històriques;
  6. si es requereix transport protegit amb TLS;
  7. com autenticarà l'aplicació usuaris i dispositius;
  8. si IAMMETER-Cloud ha de continuar formant part de l'arquitectura;
  9. la versió del firmware utilitzada per a la validació;
  10. com es faran còpies de seguretat de la configuració, els registres i les dades.

9. Documentació relacionada

Última actualització: 16 de juliol de 2026

Amunt