Ho sentim, el teu navegador no admet JavaScript!

Mesurador d'energia Wi-Fi IAMMETER: Guia d'integració local i interfície oberta

Mesurador d'energia Wi-Fi IAMMETER: Guia d'integració local i interfície oberta

Per a desenvolupadors i integradors de sistemes que utilitzen mesuradors IAMMETERsenseIAMPERMETER-Núvol.

Els comptadors d'energia Wi-Fi IAMMETER estan dissenyats tant per a integracions basades en el núvol com locals, i proporcionen API obertes (HTTP, MQTT, Modbus/TCP) que permeten als desenvolupadors crear els seus propis sistemes de gestió d'energia (EMS), sistemes de gestió d'edificis (BMS) o plataformes d'automatització de la llar intel·ligent.

El firmware d'IAMMETER s'actualitza contínuament. Aquest document enumera totes les funcions d'integració local i oberta compatibles amb el firmware més recent.(Actualitzat contínuament)


1) Actualització del firmware

Obtingueu les darreres versions de firmware aquí:


2) Modes d'execució (no al núvol)

Trieu un mode segons com integreu o utilitzeu el dispositiu.

Mode Descripció Ús típic
Núvol Puja dades a IAMMETER-Cloud 🚫 No tractat en aquest article
TCP Puja a servidors de tercers mitjançantTCP/TLSoMQTT Servidors locals, agents personalitzats
HTTP Puja a servidors de tercers mitjançantHTTP/HTTPS API REST/backends web personalitzats
MQTT Puja dades directament a un broker MQTT Només disponible amb el firmware més recent
Autònom Sense càrrega de dades; el mesurador actua com a servidor local que respon a les API o als clients Modbus/TCP Només disponible amb el firmware més recent

Interfície d'usuari del firmware antic

Pantalla de selecció del mode d'execució del firmware antic

Últim firmwareInterfície web

Nova interfície d'usuari web del firmware que mostra les opcions del mode d'execució


(La resta del document continua sense canvis respecte a la darrera versió.)

3) Integració TCP / TLS / MQTT

3.1 TCP i TLS

Els comptadors poden enviar dades directament al punt final TCP/TLS.

🔹 Nova configuració del firmware

El procés de configuració del firmware més recent és similar al de les versions anteriors.

Mode d'execució: TCP

Adreça:

  • Per a un servidor TCP, introduïu{domini}:{port}(per exemple,abc.com:12345). Exemple de configuració d'adreça de servidor TCP
  • Per a un servidor TLS, utilitzeutls://{domini}:{port}(per exemple,tls://abc.com:12345). Exemple de configuració d'adreça de servidor TLS

Interval de càrrega:L'interval mínim de càrrega és2 segons.

🔹 Configuració del firmware antic

Exemple de configuració TCP/TLS de firmware antic


3.2 MQTT

🔹 Nova configuració del firmware

Mode d'execució: MQTT Adreça:Introduïu la IP o el domini amb el port, p. ex.,192.168.11.163:1883 Nom d'usuari / Contrasenya:Credencials del broker MQTT (opcional si el broker no les requereix)

Interval de càrrega:L'interval mínim és2 segons. Descobriment de MQTT d'alta disponibilitat: Activa la detecció de MQTT a Home Assistant

Exemple de configuració del nou broker MQTT de firmware

🔹 Configuració del firmware antic

Publica telemetria a un broker MQTT local o públic.

Interfície de configuració MQTT del firmware antic


4) Integració HTTP / HTTPS

🔹 Configuració del firmware antic

Els comptadors poden enviar dades directament al vostre servidor personalitzat.

  • El format de la càrrega útil de dades és idèntic als modes TCP/MQTT.
  • Es pot utilitzar qualsevol port.
  • Port443activa HTTPS automàticament.
  • Detalls:Pujada via HTTP/HTTPS

Exemple de publicació de dades HTTP/HTTPS de firmware antic

🔹 Nova configuració del firmware

Adreça:El format d'entrada és el mateix que el del firmware antic.

  • Si no s'especifica cap port, el port per defecte és80.
  • Només port443utilitza HTTPS post; tots els altres ports utilitzen HTTP post.

Pantalla de configuració d'adreça HTTP/HTTPS del nou firmware


5) API local (HTTP sobre LAN)

Accediu al comptador localment a través de la seva IP LAN; no cal connexió al núvol.

5.1 GET /api/monitorjson

Retorna dades de mesurament en temps real.Camps:Voltatge, corrent, potència activa, kWh directe/invers, freqüència, factor de potència.

Exemple:

{
"mètode": "uploadsn",
"mac": "B0F8933C4F94",
"versió": "i.75.97.9",
"servidor": "em",
"SN": "3E0BAF87",
"Dades": [
[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]
]
}

📘 Extensió de mesura de potència reactiva


5.2 GET /api/monitor

Versió avançada deMonitorjson, inclou informació del senyal Wi-Fi:

  • SSID(nom del punt d'accés connectat)
  • signatura(intensitat del senyal)

5.3 GET /api/wifidata

Retorna la configuració de la xarxa Wi-Fi i de xarxa.

{
"versió": "i.75.97.9", "SN": "3E0BAF87", "mac": "B0F8933C4F94",
"tipus": "PM", "ssid": "CMCC-laohe", "ip": "192.168.11.62",
"màscara de xarxa": "255.255.255.0", "gw": "192.168.11.253",
"dns": "114.114.114.114", "dhcp": 1, "runMode": "tcp", "uploadinterval": 60
}

5.4 GET /api/uploadinterval?x=<segons>

Estableix l'interval de càrrega (en segons).

Funciona en modes que no són al núvol (TCP/HTTP/MQTT).

En elÚltim firmware, aquest paràmetre ara es pot configurar directament des delInterfície d'usuari web, sense cridar l'API manualment.


5.5 GET /api/mqtt

Configura les credencials de MQTT. 📘Documentació de l'API de configuració de MQTT

En elÚltim firmware, aquest paràmetre ara es pot configurar directament des delInterfície d'usuari web, sense cridar l'API manualment.


5.6 GET /api/netmetring

Activa/desactivaMesura d'energia neta (NEM)mode. 📘Activa el mode NEM

En elÚltim firmware, aquest paràmetre ara es pot configurar directament des delInterfície d'usuari web, sense cridar l'API manualment.


5.7 GET /api/ctcratio

AjustaMultiplicador de fase Cper a escenaris de fase dividida/equilibrats.

En elÚltim firmware, aquest paràmetre ara es pot configurar directament des delInterfície d'usuari web, sense cridar l'API manualment.


5.8 GET /api/reactiu

Activa o desactivaPotència reactiva (Q)iEnergia reactiva (kVARh)mesura. 📘Documentació de potència reactiva

En elÚltim firmware, aquest paràmetre ara es pot configurar directament des delInterfície d'usuari web, sense cridar l'API manualment.


5.9 GET /api/ratio (només disponible per a WEM3046T)

Des delWEM3046Tutilitza TC externs ambSortides secundàries de 5A(per exemple, 1000:5, 1500:5, 2000:5, etc.), els valors mesurats (corrent, potència, energia) s'han de multiplicar per la relació del transformador de corrent.

Exemple:

/api/ràtio?x=400
  • Estableix la proporció: /api/ratio?x={ct_ratio}
  • Ràtio de consultes: /api/ràtio

NomésWEM3046Tadmet TC externs de 5A; aquesta API no és vàlida per a altres models.


6) Coherència del format JSON

Tots els modes de comunicació —HTTP, TCP, MQTT, API local— utilitzen la mateixa estructura JSON. 📘Definició de dades JSON


7) Suport Modbus/TCP

Els mesuradors IAMMETER són compatibles de manera nativaModbus/TCP, permetent la integració directa ambAuxiliar de la llar, PLCs, oSCADAsistemes.


8) Escenaris d'integració compatibles

Sistema Protocol(s) Exemple d'ús Referència
Auxiliar de la llar HTTP / Modbus / MQTT Tauler de control i automatització Guia
Node-VERMELL HTTP / Modbus / MQTT Fluxos d'automatització Guia
OpenHAB / ioBroker HTTP Taulers de control locals Integració
ZABBIX HTTP Taulers de control de monitorització Integració
Tauler de coses HTTP Visualització de la IoT Integració
Servidors personalitzats HTTP / MQTT / TCP Ingestió de dades empresarials o locals Crea el teu propi sistema

9) Recursos


10) Resum del desenvolupador

| Capacitat | Accés | Notes | | --------------------- | ------------------- | ---------------------------------- | | Dades locals en temps real | API local |/api/monitorjson, /api/monitor| | Càrrega de tercers | TCP/TLS, HTTP/HTTPS | Mateix esquema de càrrega útil | | Publicació MQTT | Broker MQTT |/api/mqttper definir credencials | | Mesurament de la xarxa | API local |/api/netmetring| | Energia/potència reactiva | API local |/api/reactive| | Multiplicador de fase C | API local |/api/ctcratio?x=1 | | Ràtio CT (WEM3046T) | API local |/api/ratio?x=` | | Modbus/TCP | Client Modbus | Compatible amb HA/PLC/SCADA |


Darrera actualització: 15 d'octubre de 2025

Superior