Comptador d'energia Wi-Fi IAMMETER: APIs locals i interfícies obertes

Comptador d'energia Wi-Fi IAMMETER: APIs locals i interfícies obertes

Els comptadors d'energia Wi-Fi IAMMETER admeten IAMMETER-Cloud, així com integracions locals i de tercers.

Les interfícies disponibles inclouen:

• API HTTP local a través de la LAN
• Publicació MQTT i MQTTS
• Modbus TCP
• Enviament TCP/TLS
• Enviament HTTP/HTTPS
• Funcionament local autònom

Aquestes interfícies permeten que els comptadors IAMMETER actuïn com a fonts de dades obertes per a:

• Home Assistant i altres plataformes de casa intel·ligent
• Automatització amb Node-RED
• Panells de control allotjats en el vostre propi servidor
• Sistemes PLC i SCADA
• Sistemes personalitzats de gestió d'energia (EMS)
• Sistemes personalitzats de gestió d'edificis (BMS)
• Servidors de dades de tercers

Aquesta guia descriu primer el firmware actual i el WebUI. Les captures de pantalla i els mètodes de configuració del firmware més antic es conserven a la secció final de Legacy.

Per a una aplicació llesta per utilitzar basada en aquestes capacitats, vegeu Monitorització de l'energia domèstica, Monitorització de l'energia solar o monitorització local sense accés a Internet.

1) Actualitzeu al firmware més recent

El firmware d'IAMMETER s'actualitza contínuament. Abans de configurar una integració, comproveu la versió actual i la compatibilitat amb el model:

• Pàgina de versions del firmware IAMMETER

El WebUI del firmware més recent mostra directament les opcions de configuració més habituals. Les crides d'API de configuració manual que es conserven més endavant en aquest article són útils principalment quan es mantenen instal·lacions més antigues.

2) Trieu el mode d'execució al WebUI actual

Seleccioneu un mode d'execució segons on hagi d'enviar les dades el comptador o com hagi de funcionar localment.

El mode d'execució controla el comportament d'enviament de dades. La disponibilitat de l'API local i de Modbus TCP sempre s'ha de comprovar segons el model de comptador, el firmware i la integració seleccionada.

3) Per què són importants les interfícies obertes

Les interfícies obertes permeten als usuaris decidir on es processen i s'emmagatzemen les dades elèctriques.

Els motius habituals inclouen:

• Mantenir els mesuraments dins de la xarxa local
• Enviar la telemetria a un servidor existent
• Connectar les dades d'energia amb Home Assistant o Node-RED
• Crear panells de control i alarmes personalitzats
• Combina les dades elèctriques amb tarifes, energia solar o lògica de control de càrregues
• Operar en una ubicació amb accés a Internet limitat o poc fiable

L'accés al núvol i el local no són necessàriament excloents. L'arquitectura adequada depèn de si el projecte necessita informes d'IAMMETER-Cloud, una plataforma local, un servidor de tercers o una combinació.

4) Envieu dades a un servidor de tercers

4.1 TCP i TLS

IAMMETER pot enviar les dades del comptador a un punt final TCP o TLS.

Al WebUI actual:

1. Seleccioneu el mode d'execució TCP.
2. Introduïu l'adreça de destinació.
3. Configureu l'interval d'enviament.
4. Deseu la configuració i verifiqueu les dades al servidor receptor.

Per a un servidor TCP, utilitzeu:

{domain-or-ip}:{port}

Exemple:

abc.com:12345

Per a un servidor TLS, utilitzeu:

tls://{domain-or-ip}:{port}

Exemple:

tls://abc.com:12345

La documentació del firmware actual indica un interval d'enviament mínim de 2 segons. Confirmeu el firmware actual i la capacitat del servidor receptor abans de seleccionar un interval curt.

4.2 MQTT i MQTTS

IAMMETER pot publicar telemetria directament en un broker MQTT normal o utilitzar MQTTS per al transport xifrat en firmware compatible.

Al WebUI actual:

1. Seleccioneu el mode d'execució MQTT.
2. Introduïu l'adreça IP o el domini del broker i el port amb el format MQTT o MQTTS adequat.
3. Introduïu l'usuari i la contrasenya del broker quan calgui autenticació.
4. Configureu l'interval d'enviament.
5. Deseu i verifiqueu que els missatges arriben al broker.

Per a MQTT estàndard, introduïu l'adreça i el port del broker sense prefix mqtt://:

192.168.11.163:1883

Per a MQTTS, incloeu el prefix mqtts://:

mqtts://{mqtt-broker-address}:{port}

Exemple:

mqtts://broker.example.com:8883

El suport MQTTS documentat a l'actualització de firmware de novembre de 2025 té les limitacions actuals següents:

• Admet TLS 1.2 i versions anteriors.
• No admet la càrrega d'un certificat CA personalitzat.
• No admet la verificació del nom d'amfitrió.
• No admet certificats de client per a l'autenticació TLS mútua.

Aquestes limitacions són importants a l'hora de triar un broker i avaluar els requisits de seguretat del desplegament.

La documentació del firmware actual indica un interval d'enviament mínim de 2 segons.

Home Assistant MQTT Discovery és una funció addicional de descobriment de Home Assistant; no és necessària per a totes les integracions MQTT. Vegeu:

• Guia d'integració MQTT d'IAMMETER
• MQTT Discovery a Home Assistant

Canvieu uploadInterval de forma remota mitjançant MQTT/MQTTS

Amb el firmware descrit a l'actualització de novembre de 2025, un comptador en mode MQTT se subscriu automàticament a:

device/{sn}/config

Publiqueu el JSON següent des d'un altre client MQTT per canviar l'interval d'enviament de forma remota:

{"uploadInterval": 10}

Substituïu 10 per l'interval requerit en segons i {sn} pel número de sèrie del comptador al tema.

Aquesta configuració remota per MQTT és diferent del mètode local /api/uploadinterval més antic que es conserva a la secció de Legacy.

4.3 HTTP i HTTPS

IAMMETER pot enviar dades a un servidor HTTP/HTTPS personalitzat.

Al WebUI actual:

1. Seleccioneu el mode d'execució HTTP.
2. Introduïu l'adreça i el port del servidor.
3. Configureu l'interval d'enviament.
4. Deseu i verifiqueu les peticions al servidor.

El firmware actual admet tant el port HTTPS per defecte com un port HTTPS personalitzat.

Utilitzeu un d'aquests formats:

• HTTP sense port explícit: {address} — utilitza el port 80 per defecte.
• HTTP amb port personalitzat: {address}:{port}.
• HTTPS sense port explícit: https://{address} — utilitza el port 443 per defecte.
• HTTPS amb port personalitzat: https://{address}:{port} — utilitza el port especificat.

El prefix https:// selecciona HTTPS. El port 443 ja no és l'únic port disponible per a HTTPS.

Exemples:

api.example.com
api.example.com:8080
https://api.example.com
https://api.example.com:8443

Consulteu El nou firmware afegeix MQTTS, configuració remota i port HTTPS personalitzat per a la nota de versió del firmware.

Per al tractament de les dades al costat del servidor, vegeu també Integreu IAMMETER amb un servidor de tercers.

5) Llegiu les dades localment mitjançant HTTP

Connecteu el comptador a la LAN i sol·liciteu dades des de la seva adreça IP local. Aquestes peticions no requereixen IAMMETER-Cloud.

Proveu les APIs de forma interactiva: obriu l'Explorador d'APIs locals d'IAMMETER, introduïu l'adreça IP local del comptador i seleccioneu la pàgina de prova de l'API WEM. L'explorador d'estil Swagger enumera les APIs locals disponibles i us permet enviar peticions de prova directament des del navegador. El vostre navegador i el comptador IAMMETER han d'estar a la mateixa LAN.

5.1 GET /api/monitorjson

Retorna els mesuraments elèctrics en temps real.

Les dades estàndard inclouen valors com:

• Tensió
• Corrent
• Potència activa
• kWh d'importació/avanç
• kWh d'exportació/revers
• Freqüència
• Factor de potència

Exemple de resposta:

{
  "method": "uploadsn",
  "mac": "B0F8933C4F94",
  "version": "i.75.97.9",
  "server": "em",
  "SN": "3E0BAF87",
  "Datas": [
    [220.0, 9.99, 2198, 11.337, 11.201, 49.99, 1.00],
    [222.5, 9.99, 1100, 11.039, 10.908, 49.99, 0.50],
    [263.5, 9.99, 1213, 10.975, 10.846, 49.99, 0.55]
  ]
}

El nombre de matrius de mesurament depèn del model de comptador i del nombre de canals.

Si el mesurament de potència reactiva està activat en un model/firmware compatible, el format de resposta pot incloure camps addicionals. Vegeu Format de dades del mesurament de potència reactiva.

5.2 GET /api/monitor

Retorna una resposta estesa en temps real que també inclou informació de Wi-Fi com:

• ssid — nom del punt d'accés connectat
• sig — intensitat del senyal Wi-Fi

Utilitzeu aquest punt final quan una integració necessiti tant mesuraments elèctrics com l'estat bàsic de la Wi-Fi.

5.3 GET /api/wifidata

Retorna informació de configuració del firmware, del dispositiu i de la xarxa.

Exemple:

{
  "version": "i.75.97.9",
  "SN": "3E0BAF87",
  "mac": "B0F8933C4F94",
  "type": "PM",
  "ssid": "example-wifi",
  "ip": "192.168.11.62",
  "netmask": "255.255.255.0",
  "gw": "192.168.11.1",
  "dns": "192.168.11.1",
  "dhcp": 1,
  "runMode": "tcp",
  "uploadinterval": 60
}

No publiqueu respostes que continguin números de sèrie del dispositiu, adreces MAC, adreçament intern o informació de Wi-Fi tret que els valors s'hagin anonimitzat.

6) Format JSON en tots els modes d'enviament

IAMMETER utilitza una estructura JSON de mesurament principal coherent en HTTP, TCP, MQTT i l'API local. Això redueix la feina necessària quan un mateix sistema receptor admet diversos mètodes de transport.

El mètode de transport i l'embolcall poden afectar igualment com un receptor es connecta, s'autentica o emmarca un missatge. Implementeu el sistema receptor d'acord amb el format documentat per al mode seleccionat.

• Definició de dades JSON del comptador d'energia IAMMETER

7) Modbus TCP

Els comptadors IAMMETER admeten Modbus TCP per a la integració directa a la LAN amb clients compatibles.

Els clients habituals inclouen:

• Home Assistant
• PLC
• Sistemes SCADA
• Passarel·les industrials
• Aplicacions Modbus personalitzades

Referències:

• Visió general de Modbus TCP d'IAMMETER
• Visió general de la integració amb Home Assistant

Confirmeu el model de comptador, el firmware, la definició de registres, l'interval de consulta i el comportament del client abans del desplegament.

8) Escenaris d'integració

9) Resum d'interfícies actuals i recursos

Recursos addicionals:

• Firmware més recent
• Nota de firmware MQTTS i port HTTPS personalitzat
• Tutorials en vídeo
• Definició de dades JSON
• Visió general de Modbus TCP
• Desenvolupeu el vostre propi sistema
• Monitorització sense accés a Internet

Les APIs locals i els protocols oberts d'IAMMETER permeten començar amb la monitorització en temps real i afegir després un EMS personalitzat, un panell de control allotjat pròpiament o un flux de treball d'automatització.

10) Pàgines i mètodes de configuració del firmware Legacy

El material següent es conserva únicament per als comptadors que encara executen firmware més antic o per als usuaris que mantenen una integració existent. Per a una instal·lació nova, actualitzeu al firmware més recent i utilitzeu el WebUI actual sempre que hi hagi disponible l'opció requerida.

10.1 Pàgina de mode d'execució Legacy

El firmware més antic utilitzava la pàgina de selecció de mode d'execució següent:

La disposició i els noms de les opcions poden no coincidir amb el WebUI actual que es mostra anteriorment en aquesta guia.

10.2 Pàgina TCP/TLS Legacy

Les integracions amb firmware més antic poden fer referència a aquesta pàgina de configuració TCP/TLS i a la guia relacionada:

• Guia d'integració amb servidor de tercers (Legacy)
• Vídeo d'enviament al servidor (Legacy)

10.3 Pàgina MQTT Legacy

La documentació MQTT més antiga utilitzava aquesta interfície de configuració:

Per al flux de treball actual, utilitzeu les instruccions del WebUI actual que apareixen més amunt en aquest article i la Guia d'integració MQTT actualitzada.

10.4 Pàgina HTTP/HTTPS Legacy

El firmware més antic utilitzava la pàgina de destinació HTTP/HTTPS següent:

La guia d'integració Legacy es conserva a Enviament mitjançant HTTP/HTTPS.

En aquest flux de treball més antic, HTTPS estava associat al port per defecte 443 i no requeria el prefix https://. El firmware actual utilitza en canvi el prefix https:// per seleccionar HTTPS i admet tant el port per defecte 443 com un port personalitzat especificat explícitament.

10.5 APIs de configuració Legacy

Les crides d'API locals següents apareixien en fluxos de configuració anteriors. En el firmware actual, la configuració corresponent s'ha de fer normalment a través del WebUI quan l'opció estigui disponible.

/api/uploadinterval?x=<seconds>

Mètode Legacy per definir l'interval d'enviament fora del núvol (non-Cloud).

/api/mqtt

Mètode Legacy per configurar les credencials MQTT.

/api/netmetring

Mètode Legacy per activar o desactivar el mode de mesurament net d'energia (Net Energy Metering).

• Referència de Net Energy Metering

/api/ctcratio

Mètode Legacy per aplicar el multiplicador de fase-C documentat en escenaris específics de bifàsic (split-phase) o equilibrats.

• Referència del coeficient CTC

/api/reactive

Mètode Legacy per activar o desactivar el mesurament de potència reactiva i d'energia reactiva en firmware/models compatibles.

• Referència de potència reactiva

/api/ratio — només per a WEM3046T

El WEM3046T utilitza transformadors de corrent (CT) externs amb sortides secundàries de 5 A. Les instruccions de configuració més antigues definien el coeficient del CT amb:

/api/ratio?x={ct_ratio}

Exemple:

/api/ratio?x=400

Aquest punt final és específic del WEM3046T i no és vàlid per a altres models d'IAMMETER. Per al firmware actual, utilitzeu la configuració del WebUI actual del model quan estigui disponible.

El material Legacy es conserva com a referència retrospectiva; les instal·lacions actuals han de seguir el WebUI del firmware més recent.