Contor de energie Wi-Fi IAMMETER: Ghid de integrare locală și interfață deschisă

Contor de energie Wi-Fi IAMMETER: Ghid de integrare locală și interfață deschisă 1) Actualizare firmware 2) Moduri de rulare (non-Cloud) Interfață utilizator firmware vechi Cel mai recent firmware WebUI 3) Integrare TCP / TLS / MQTT 3.1 TCP și TLS 🔹 Configurație firmware nouă 🔹 Configurație firmware veche 3.2 MQTT 🔹 Configurație firmware nouă 🔹 Configurație firmware veche 4) Integrare HTTP / HTTPS 🔹 Configurație firmware veche 🔹 Configurație firmware nouă 5) API local (HTTP prin LAN) 5.1 GET /api/monitorjson 5.2 GET /api/monitor 5.3 GET /api/wifidata 5.4 GET /api/uploadinterval?x=<secunde> 5.5 GET /api/mqtt 5.6 GET /api/netmetring 5.7 GET /api/ctcratio 5.8 GET /api/reactive 5.9 GET /api/ratio (disponibil doar pentru WEM3046T) 6) Consistența formatului JSON 7) Suport Modbus/TCP 8) Scenarii de integrare acceptate 9) Resurse 10) Rezumatul dezvoltatorului

Contor de energie Wi-Fi IAMMETER: Ghid de integrare locală și interfață deschisă

Pentru dezvoltatori și integratori de sisteme care utilizează contoare IAMMETERfărăIAMMETRU-Cloud.

Contoarele de energie Wi-Fi IAMMETER sunt concepute atât pentru integrări bazate pe cloud, cât și locale, oferind API-uri deschise (HTTP, MQTT, Modbus/TCP) care permit dezvoltatorilor să își construiască propriile sisteme de management al energiei (EMS), sisteme de management al clădirilor (BMS) sau platforme inteligente de automatizare a locuințelor.

Firmware-ul IAMMETER este actualizat continuu. Acest document listează toate funcțiile de integrare locală și deschisă acceptate de cel mai recent firmware.(Actualizat continuu)

1) Actualizare firmware

Obțineți cele mai recente versiuni de firmware aici:

Pagina de lansare a firmware-ului (imeter.club): https://imeter.club/topic/11

2) Moduri de rulare (non-Cloud)

Alegeți un mod în funcție de modul în care integrați sau utilizați dispozitivul.

Modul	Descriere	Utilizare tipică
Nor	Încărcați datele în IAMMETER-Cloud	🚫 Nu este acoperit în acest articol
TCP	Încărcați pe servere terțe prin intermediulTCP/TLSsauMQTT	Servere locale, brokeri personalizați
HTTP	Încărcați pe servere terțe prin intermediulHTTP/HTTPS	API-uri REST personalizate/backend-uri web
MQTT	Încărcați datele direct către un broker MQTT	Disponibil doar în cea mai recentă versiune de firmware
Independent	Fără încărcare de date; contorul acționează ca un server local care răspunde la API-uri sau clienți Modbus/TCP	Disponibil doar în cea mai recentă versiune de firmware

Interfață utilizator firmware vechi

Ecran de selectare a modului de rulare a firmware-ului vechi

Cel mai recent firmwareInterfață web

Noua interfață WebUI cu firmware care afișează opțiunile modului de rulare

(Restul documentului este neschimbat față de ultima versiune.)

3) Integrare TCP / TLS / MQTT

3.1 TCP și TLS

Contoarele pot trimite date direct către endpoint-ul TCP/TLS.

🔹 Configurație firmware nouă

Procesul de configurare din cel mai recent firmware este similar cu cel din versiunile anterioare.

Mod de rulare: TCP

Adresa:

Pentru un server TCP — introduceți{domeniu}:{port}(de exemplu,abc.com:12345).
Pentru un server TLS — utilizațitls://{domeniu}:{port}(de exemplu,tls://abc.com:12345).

Interval de încărcare:Intervalul minim de încărcare este2 secunde.

🔹 Configurație firmware veche

Exemplu de configurare TCP/TLS cu firmware vechi

3.2 MQTT

🔹 Configurație firmware nouă

Mod de rulare: MQTT Adresa:Introduceți adresa IP sau domeniul cu portul, de ex.,192.168.11.163:1883 Nume utilizator / Parolă:Acreditări broker MQTT (opțional dacă brokerul nu le solicită)

Interval de încărcare:Intervalul minim este2 secunde. Descoperire HA MQTT: Activează descoperirea MQTT în Home Assistant

Exemplu de configurare a unui nou broker MQTT cu firmware

🔹 Configurație firmware veche

Publicați telemetria către un broker MQTT local sau public.

Ghid:Ghid de integrare MQTT

Interfață de configurare MQTT cu firmware vechi

4) Integrare HTTP / HTTPS

🔹 Configurație firmware veche

Contoarele pot posta date direct pe serverul dvs. personalizat.

Formatul sarcinii utile a datelor este identic cu modurile TCP/MQTT.
Se poate folosi orice port.
Port443activează automat HTTPS.
Detalii:Încărcați prin HTTP/HTTPS

Exemplu de postare a datelor HTTP/HTTPS cu firmware vechi

🔹 Configurație firmware nouă

Adresa:Formatul de intrare este același ca la firmware-ul vechi.

Dacă nu este specificat niciun port, portul implicit este80.
Numai port443folosește HTTPS post; toate celelalte porturi folosesc HTTP post.

Ecran de configurare a adresei HTTP/HTTPS cu firmware nou

5) API local (HTTP prin LAN)

Accesați contorul local prin intermediul adresei IP LAN — nu este necesară o conexiune la cloud.

5.1 `GET /api/monitorjson`

Returnează date de măsurare în timp real.Câmpuri:Tensiune, Curent, Putere activă, kWh direct/invers, Frecvență, Factor de putere.

Exemplu:

{
„metodă”: „uploadsn”,
„mac”: „B0F8933C4F94”,
„versiune”: „i.75.97.9”,
„server”: „em”,
„SN”: „3E0BAF87”,
„Date”: [
[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]
]
}

📘 Extensie de măsurare a puterii reactive

5.2 `GET /api/monitor`

Versiune avansată aMonitorjson, include informații despre semnalul Wi-Fi:

SSID(numele punctului de acces conectat)
semnătură(puterea semnalului)

5.3 `GET /api/wifidata`

Returnează configurația Wi-Fi și a rețelei.

{
„versiune”: „i.75.97.9”, „SN”: „3E0BAF87”, „mac”: „B0F8933C4F94”,
„tip”: „PM”, „ssid”: „CMCC-laohe”, „ip”: „192.168.11.62”,
„mască de rețea”: „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=<secunde>`

Setează intervalul de încărcare (în secunde).

Funcționează în moduri non-Cloud (TCP/HTTP/MQTT).

ÎnCel mai recent firmware, acest parametru poate fi acum configurat direct dinInterfață WebUI, fără a apela manual API-ul.

5.5 `GET /api/mqtt`

Configurează acreditările MQTT. 📘Documentația API-ului de configurare MQTT

ÎnCel mai recent firmware, acest parametru poate fi acum configurat direct dinInterfață WebUI, fără a apela manual API-ul.

5.6 `GET /api/netmetring`

ComutăMăsurarea energiei nete (NEM)mod. 📘Activează modul NEM

ÎnCel mai recent firmware, acest parametru poate fi acum configurat direct dinInterfață WebUI, fără a apela manual API-ul.

5.7 `GET /api/ctcratio`

AjusteazăMultiplicatorul de fază Cpentru scenarii cu fază divizată/echilibrată.

x=2dublează citirile fazei C (curent, putere, kWh). 📘Explicație privind raportul CTC

ÎnCel mai recent firmware, acest parametru poate fi acum configurat direct dinInterfață WebUI, fără a apela manual API-ul.

5.8 `GET /api/reactiv`

Activează sau dezactiveazăPutere reactivă (Q)șiEnergie reactivă (kVARh)măsurare. 📘Documentație privind puterea reactivă

ÎnCel mai recent firmware, acest parametru poate fi acum configurat direct dinInterfață WebUI, fără a apela manual API-ul.

5.9 `GET /api/ratio` (disponibil doar pentru WEM3046T)

De cândWEM3046Tutilizează CT-uri externe cuIeșiri secundare de 5A(de exemplu, 1000:5, 1500:5, 2000:5 etc.), valorile măsurate (curent, putere, energie) trebuie înmulțite cu raportul transformatorului de curent.

Exemplu:

/api/ratio?x=400

Raportul setat: /api/ratio?x={ct_ratio}
Raportul de interogări: /api/raport

NumaiWEM3046Tacceptă CT-uri externe de 5A — această API nu este validă pentru alte modele.

6) Consistența formatului JSON

Toate modurile de comunicare —HTTP, TCP, MQTT, API local— folosește aceeași structură JSON. 📘Definiția datelor JSON

7) Suport Modbus/TCP

Contoarele IAMMETER suportă nativModbus/TCP, permițând integrarea directă cuAsistent acasă, PLC-uri, sauSCADAsisteme.

8) Scenarii de integrare acceptate

Sistem	Protocol(e)	Exemplu de utilizare	Referinţă
Asistent acasă	HTTP / Modbus / MQTT	Tablou de bord și automatizare	Ghid
Nod-ROȘU	HTTP / Modbus / MQTT	Fluxuri de automatizare	Ghid
OpenHAB / ioBroker	HTTP	Tablouri de bord locale	Integrare
Zabbix	HTTP	Monitorizarea tablourilor de bord	Integrare
Thingsboard	HTTP	Vizualizare IoT	Integrare
Servere personalizate	HTTP / MQTT / TCP	Ingerare de date la nivel de întreprindere sau local	Construiește-ți propriul sistem

9) Resurse

10) Rezumatul dezvoltatorului

| Capacitate | Acces | Note | | --------------------- | ------------------- | ---------------------------------- | | Date locale în timp real | API local |/api/monitorjson, /api/monitor| | Încărcare de la terți | TCP/TLS, HTTP/HTTPS | Aceeași schemă de sarcină utilă | | Publicare MQTT | Broker MQTT |/api/mqttpentru a seta acreditările | | Măsurare netă | API local |/api/netmetring| | Putere/energie reactivă | API local |/api/reactive| | Multiplicator de fază C | API local |/api/ctcratio?x=1 | | Raport CT (WEM3046T) | API local |/api/ratio?x=` | | Modbus/TCP | Client Modbus | Compatibil cu HA/PLC/SCADA |

Ultima actualizare: 15 octombrie 2025