IAMMETER Wi-Fi merilnik energije: lokalni API-ji in odprti vmesniki

IAMMETER Wi-Fi merilnik energije: lokalni API-ji in odprti vmesniki

Merilniki energije IAMMETER Wi-Fi podpirajo IAMMETER-Cloud ter lokalne integracije in integracije tretjih oseb.

Na voljo so naslednji vmesniki:

• Lokalni HTTP API prek LAN omrežja
• Objavljanje prek MQTT in MQTTS
• Modbus TCP
• Nalaganje prek TCP/TLS
• Nalaganje prek HTTP/HTTPS
• Samostojno lokalno delovanje

Ti vmesniki omogočajo, da merilniki IAMMETER delujejo kot odprti viri podatkov za:

• Home Assistant in druge platforme za pametni dom
• Avtomatizacijo z Node-RED
• Samogostene nadzorne plošče
• Sisteme PLC in SCADA
• Sisteme za upravljanje energije po meri (EMS)
• Sisteme za upravljanje stavb po meri (BMS)
• Podatkovne strežnike tretjih oseb

Ta priročnik najprej opisuje trenutno vdelano programsko opremo in WebUI. Posnetki zaslona in načini konfiguracije za starejšo vdelano programsko opremo so ohranjeni v zadnjem razdelku Legacy.

Za aplikacijo, pripravljeno za uporabo in zgrajeno na teh zmogljivostih, si oglejte Spremljanje porabe energije v domu, Spremljanje sončne energije ali lokalno spremljanje brez dostopa do interneta.

1) Posodobitev na najnovejšo vdelano programsko opremo

Vdelana programska oprema IAMMETER se nenehno posodablja. Pred konfiguracijo integracije preverite trenutno izdajo in združljivost modela:

• Stran z izdajami vdelane programske opreme IAMMETER

WebUI najnovejše vdelane programske opreme neposredno prikazuje pogosto uporabljene možnosti konfiguracije. Ročni klici API za konfiguracijo, ohranjeni kasneje v tem članku, so uporabni predvsem pri vzdrževanju starejših namestitev.

2) Izbira načina delovanja v trenutnem WebUI

Izberite način delovanja glede na to, kam naj merilnik pošilja podatke ali kako naj deluje lokalno.

Način delovanja nadzoruje obnašanje nalaganja podatkov. Razpoložljivost lokalnega API-ja in Modbus TCP je treba še vedno preveriti glede na model merilnika, vdelano programsko opremo in izbrano integracijo.

3) Zakaj so odprti vmesniki pomembni

Odprti vmesniki uporabnikom omogočajo odločanje o tem, kje se podatki o porabi električne energije obdelujejo in shranjujejo.

Običajni razlogi vključujejo:

• Ohranjanje meritev znotraj lokalnega omrežja
• Pošiljanje telemetrije na obstoječi strežnik
• Povezovanje energetskih podatkov s Home Assistant ali Node-RED
• Izdelavo nadzornih plošč in alarmov po meri
• Združevanje podatkov o električni energiji s tarifami, sončno energijo ali logiko nadzora obremenitve
• Delovanje na lokaciji z omejenim ali nezanesljivim dostopom do interneta

Dostop v oblaku in lokalni dostop nista nujno medsebojno izključujoča. Primerna arhitektura je odvisna od tega, ali projekt potrebuje poročila IAMMETER-Cloud, lokalno platformo, strežnik tretje osebe ali kombinacijo.

4) Pošiljanje podatkov na strežnik tretje osebe

4.1 TCP in TLS

IAMMETER lahko pošilja podatke merilnika na TCP ali TLS končno točko.

V trenutnem WebUI:

1. Izberite način delovanja TCP.
2. Vnesite ciljni naslov.
3. Konfigurirajte interval nalaganja.
4. Shranite nastavitve in preverite podatke na strežniku, ki jih sprejema.

Za strežnik TCP uporabite:

{domain-or-ip}:{port}

Primer:

abc.com:12345

Za strežnik TLS uporabite:

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

Primer:

tls://abc.com:12345

Pregled trenutne vdelane programske opreme navaja najmanjši interval nalaganja 2 sekundi. Pred izbiro kratkega intervala preverite trenutno vdelano programsko opremo in zmogljivost strežnika, ki podatke sprejema.

4.2 MQTT in MQTTS

IAMMETER lahko telemetrijo objavlja neposredno na navadnem MQTT posredniku ali pa pri podprti vdelani programski opremi uporablja MQTTS za šifriran prenos.

V trenutnem WebUI:

1. Izberite način delovanja MQTT.
2. Vnesite naslov IP ali domeno in vrata posrednika v ustreznem formatu MQTT ali MQTTS.
3. Vnesite uporabniško ime in geslo posrednika, kadar je potrebna avtentikacija.
4. Konfigurirajte interval nalaganja.
5. Shranite in preverite, da sporočila prispejo do posrednika.

Za navaden MQTT vnesite naslov in vrata posrednika brez predpone mqtt://:

192.168.11.163:1883

Za MQTTS vključite predpono mqtts://:

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

Primer:

mqtts://broker.example.com:8883

Podpora za MQTTS, opisana v posodobitvi vdelane programske opreme novembra 2025, ima naslednje trenutne omejitve:

• Podpira TLS 1.2 in nižje.
• Nalaganje potrdila CA po meri ni podprto.
• Preverjanje imena gostitelja ni podprto.
• Potrdila na strani odjemalca za medsebojno avtentikacijo TLS niso podprta.

Te omejitve so pomembne pri izbiri posrednika in ocenjevanju varnostnih zahtev namestitve.

Pregled trenutne vdelane programske opreme navaja najmanjši interval nalaganja 2 sekundi.

Home Assistant MQTT Discovery je dodatna funkcija odkrivanja Home Assistant; ni potrebna za vsako integracijo MQTT. Glejte:

• Priročnik za integracijo MQTT pri IAMMETER
• MQTT Discovery v Home Assistant

Spreminjanje uploadInterval na daljavo prek MQTT/MQTTS

Pri vdelani programski opremi, opisani v posodobitvi novembra 2025, se merilnik, ki deluje v načinu MQTT, samodejno naroči na:

device/{sn}/config

Če želite interval nalaganja spremeniti na daljavo, iz drugega odjemalca MQTT objavite naslednji JSON:

{"uploadInterval": 10}

Zamenjajte 10 z želenim intervalom v sekundah in {sn} s serijsko številko merilnika v temi.

Ta oddaljena konfiguracija MQTT se razlikuje od starejše lokalne metode /api/uploadinterval, ki je ohranjena v razdelku Legacy.

4.3 HTTP in HTTPS

IAMMETER lahko pošilja podatke na HTTP/HTTPS strežnik po meri.

V trenutnem WebUI:

1. Izberite način delovanja HTTP.
2. Vnesite naslov in vrata strežnika.
3. Konfigurirajte interval nalaganja.
4. Shranite in preverite zahteve na strežniku.

Trenutna vdelana programska oprema podpira tako privzeta vrata HTTPS kot tudi vrata HTTPS po meri.

Uporabite enega od naslednjih formatov:

• Navaden HTTP brez izrecno navedenih vrat: {address} — privzeto uporabi vrata 80.
• Navaden HTTP z vrati po meri: {address}:{port}.
• HTTPS brez izrecno navedenih vrat: https://{address} — privzeto uporabi vrata 443.
• HTTPS z vrati po meri: https://{address}:{port} — uporabi navedena vrata.

Predpona https:// izbere HTTPS. Vrata 443 niso več edina vrata, ki so na voljo za HTTPS.

Primeri:

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

Za objavo o izdaji vdelane programske opreme glejte Nova vdelana programska oprema dodaja MQTTS, oddaljeno konfiguracijo in vrata HTTPS po meri.

Za obravnavo podatkov na strani strežnika glejte tudi Integracija IAMMETER s strežnikom tretje osebe.

5) Lokalno branje podatkov prek HTTP

Merilnik povežite v LAN omrežje in zahtevajte podatke z njegovega lokalnega naslova IP. Te zahteve ne potrebujejo IAMMETER-Cloud.

API-je preizkusite interaktivno： Odprite IAMMETER Local API Explorer, vnesite lokalni naslov IP merilnika in izberite testno stran WEM API. Raziskovalec v slogu Swagger navaja razpoložljive lokalne API-je in omogoča pošiljanje testnih zahtev neposredno iz brskalnika. Vaš brskalnik in merilnik IAMMETER morata biti v istem LAN omrežju.

5.1 GET /api/monitorjson

Vrne meritve električne energije v realnem času.

Standardni podatki vključujejo vrednosti, kot so:

• Napetost
• Tok
• Delovna moč
• Prejeta/uvozna kWh
• Oddana/izvozna kWh
• Frekvenca
• Faktor moči

Primer odgovora:

{
  "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]
  ]
}

Število nizov meritev je odvisno od modela merilnika in števila kanalov.

Če je pri podprtem modelu/vdelani programski opremi omogočeno merjenje jalove moči, lahko format odgovora vsebuje dodatna polja. Glejte Format podatkov merjenja jalove moči.

5.2 GET /api/monitor

Vrne razširjen odgovor v realnem času, ki vključuje tudi informacije o Wi-Fi, kot so:

• ssid — ime povezane dostopne točke
• sig — moč signala Wi-Fi

To končno točko uporabite, kadar integracija potrebuje tako meritve električne energije kot tudi osnovni status Wi-Fi.

5.3 GET /api/wifidata

Vrne informacije o vdelani programski opremi, napravi in konfiguraciji omrežja.

Primer:

{
  "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
}

Ne objavljajte odgovorov, ki vsebujejo serijske številke naprav, naslove MAC, notranje naslove ali informacije o Wi-Fi, razen če so bile vrednosti sanirane.

6) Format JSON v različnih načinih nalaganja

IAMMETER uporablja dosledno osnovno strukturo meritev JSON v okviru HTTP, TCP, MQTT in lokalnega API-ja. To zmanjša količino potrebnega dela, kadar en sprejemni sistem podpira več načinov prenosa.

Način prenosa in ovoj lahko še vedno vplivata na to, kako se sprejemnik poveže, avtenticira ali oblikuje sporočilo. Sprejemni sistem implementirajte v skladu z dokumentiranim formatom za izbrani način.

• Definicija podatkov JSON merilnika energije IAMMETER

7) Modbus TCP

Merilniki IAMMETER podpirajo Modbus TCP za neposredno integracijo v LAN omrežju z združljivimi odjemalci.

Običajni odjemalci vključujejo:

• Home Assistant
• Krmilnike PLC
• Sisteme SCADA
• Industrijske prehode (gateway)
• Aplikacije Modbus po meri

Reference:

• Pregled IAMMETER Modbus TCP
• Pregled integracije s Home Assistant

Pred namestitvijo preverite model merilnika, vdelano programsko opremo, definicijo registrov, interval anketiranja in obnašanje odjemalca.

8) Scenariji integracije

9) Povzetek trenutnih vmesnikov in viri

Dodatni viri:

• Najnovejša vdelana programska oprema
• Opomba o vdelani programski opremi MQTTS in vratih HTTPS po meri
• Video vadnice
• Definicija podatkov JSON
• Pregled Modbus TCP
• Razvijte svoj sistem
• Spremljanje brez dostopa do interneta

Lokalni API-ji in odprti protokoli IAMMETER omogočajo, da začnete s spremljanjem v realnem času in pozneje dodate EMS po meri, samogosteno nadzorno ploščo ali potek avtomatizacije.

10) Strani starejše vdelane programske opreme in načini konfiguracije

Naslednje gradivo je ohranjeno samo za merilnike, ki še vedno uporabljajo starejšo vdelano programsko opremo, ali za uporabnike, ki vzdržujejo obstoječo integracijo. Za novo namestitev posodobite na najnovejšo vdelano programsko opremo in uporabite trenutni WebUI povsod, kjer je zahtevana možnost na voljo.

10.1 Stran z načini delovanja (Legacy)

Starejša vdelana programska oprema je uporabljala naslednjo stran za izbiro načina delovanja:

Postavitev in imena možnosti se morda ne ujemajo s trenutnim WebUI, prikazanim prej v tem priročniku.

10.2 Stran TCP/TLS (Legacy)

Integracije s starejšo vdelano programsko opremo se lahko nanašajo na to konfiguracijsko stran TCP/TLS in povezani priročnik:

• Stari priročnik za integracijo strežnika tretje osebe
• Stari video o nalaganju na strežnik

10.3 Stran MQTT (Legacy)

Starejša dokumentacija MQTT je uporabljala ta konfiguracijski vmesnik:

Za trenutni potek dela uporabite navodila za trenutni WebUI iz prejšnjega dela tega članka ter posodobljen Priročnik za integracijo MQTT.

10.4 Stran HTTP/HTTPS (Legacy)

Starejša vdelana programska oprema je uporabljala naslednjo stran z HTTP/HTTPS ciljem:

Stari priročnik za integracijo je ohranjen na strani Nalaganje prek HTTP/HTTPS.

V tem starejšem poteku dela je bil HTTPS povezan s privzetimi vrati 443 in ni zahteval predpone https://. Trenutna vdelana programska oprema namesto tega uporablja predpono https:// za izbiro HTTPS ter podpira bodisi privzeta vrata 443 bodisi izrecno navedena vrata po meri.

10.5 Stari konfiguracijski API-ji

Naslednji klici lokalnega API-ja so se pojavljali v starejših konfiguracijskih potekih dela. Pri trenutni vdelani programski opremi je treba ustrezne nastavitve običajno konfigurirati prek WebUI, kadar je možnost na voljo.

/api/uploadinterval?x=<seconds>

Stara metoda za nastavitev intervala nalaganja, ki ni v oblaku.

/api/mqtt

Stara metoda za konfiguracijo poverilnic MQTT.

/api/netmetring

Stara metoda za omogočanje ali onemogočanje načina Net Energy Metering.

• Referenca za Net Energy Metering

/api/ctcratio

Stara metoda za uporabo dokumentiranega množitelja faze C v posebnih scenarijih deljene faze ali uravnoteženih scenarijih.

• Referenca za razmerje CTC

/api/reactive

Stara metoda za omogočanje ali onemogočanje merjenja jalove moči in jalove energije pri podprti vdelani programski opremi/modelih.

• Referenca za jalovo moč

/api/ratio — samo WEM3046T

WEM3046T uporablja zunanje tokovne transformatorje (CT) s sekundarnimi izhodi 5 A. Starejša navodila za konfiguracijo so razmerje CT nastavljala z:

/api/ratio?x={ct_ratio}

Primer:

/api/ratio?x=400

Ta končna točka je specifična za WEM3046T in ni veljavna za druge modele IAMMETER. Za trenutno vdelano programsko opremo uporabite trenutno WebUI konfiguracijo modela, kadar je na voljo.

Gradivo Legacy je ohranjeno za nazaj; trenutne namestitve naj sledijo WebUI najnovejše vdelane programske opreme.