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í:
- Pàgina de llançament del firmware (imeter.club): https://imeter.club/topic/11
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

Últim firmwareInterfície web

(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).
- Per a un servidor TLS, utilitzeu
tls://{domini}:{port}(per exemple,tls://abc.com:12345).
Interval de càrrega:L'interval mínim de càrrega és2 segons.
🔹 Configuració del firmware antic
- Guia:Integració de servidors de tercers (TCP/TLS)
- Vídeo:Pujar dades energètiques a un servidor de tercers

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

🔹 Configuració del firmware antic
Publica telemetria a un broker MQTT local o públic.

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

🔹 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.

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.
x=2duplica les lectures de la Fase C (corrent, potència, kWh). 📘Explicació de la relació CTC
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
- Llançaments de firmware
- Videotutorials
- Definició de JSON
- Visió general de Modbus/TCP
- Desenvolupa el teu propi sistema
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