IAMMETER Wi-Fi enerģijas skaitītājs: lokālās API un atvērtās saskarnes

IAMMETER Wi-Fi enerģijas skaitītājs: lokālās API un atvērtās saskarnes

IAMMETER Wi-Fi enerģijas skaitītāji atbalsta gan IAMMETER-Cloud, gan lokālās un trešo pušu integrācijas.

Pieejamās saskarnes ietver:

• Lokālo HTTP API lokālajā tīklā (LAN)
• MQTT un MQTTS publicēšanu
• Modbus TCP
• TCP/TLS augšupielādi
• HTTP/HTTPS augšupielādi
• Autonomu lokālo darbību

Šīs saskarnes ļauj IAMMETER skaitītājiem darboties kā atvērtiem datu avotiem:

• Home Assistant un citām viedās mājas platformām
• Node-RED automatizācijai
• Pašmitinātiem datu paneļiem
• PLC un SCADA sistēmām
• Pielāgotām enerģijas pārvaldības sistēmām (EMS)
• Pielāgotām ēku pārvaldības sistēmām (BMS)
• Trešo pušu datu serveriem

Šajā rokasgrāmatā vispirms aprakstīta pašreizējā programmaparatūra un WebUI. Vecākas programmaparatūras ekrānuzņēmumi un konfigurēšanas metodes saglabāti pēdējā "Legacy" sadaļā.

Gatavu lietotni, kas balstīta uz šīm iespējām, skatiet sadaļās Mājas enerģijas monitoringa risinājums, Saules enerģijas monitoringa risinājums vai lokālais monitorings bez interneta pieslēguma.

1) Atjauniniet uz jaunāko programmaparatūru

IAMMETER programmaparatūra tiek atjaunināta nepārtraukti. Pirms integrācijas konfigurēšanas pārbaudiet aktuālo laidienu un modeļa saderību:

• IAMMETER programmaparatūras laidienu lapa

Jaunākās programmaparatūras WebUI tieši piedāvā biežāk lietotos konfigurācijas iestatījumus. Manuālie konfigurācijas API izsaukumi, kas aprakstīti vēlāk šajā rakstā, galvenokārt noder vecāku instalāciju uzturēšanai.

2) Izvēlieties darba režīmu pašreizējā WebUI

Izvēlieties darba režīmu atbilstoši tam, kur skaitītājam jānosūta dati vai kā tam jādarbojas lokāli.

Darba režīms nosaka datu augšupielādes uzvedību. Lokālās API un Modbus TCP pieejamība joprojām jāpārbauda konkrētajam skaitītāja modelim, programmaparatūrai un izvēlētajai integrācijai.

3) Kāpēc atvērtās saskarnes ir svarīgas

Atvērtās saskarnes ļauj lietotājiem pašiem izlemt, kur elektrības dati tiek apstrādāti un glabāti.

Tipiski iemesli:

• Mērījumu saglabāšana lokālajā tīklā
• Telemetrijas nosūtīšana uz esošu serveri
• Enerģijas datu savienošana ar Home Assistant vai Node-RED
• Pielāgotu datu paneļu un trauksmju veidošana
• Elektrības datu apvienošana ar tarifiem, saules enerģijas vai slodzes vadības loģiku
• Darbība objektā ar ierobežotu vai neuzticamu interneta pieslēgumu

Mākoņa un lokālā piekļuve nav savstarpēji izslēdzošas. Piemērotā arhitektūra ir atkarīga no tā, vai projektam nepieciešamas IAMMETER-Cloud atskaites, lokāla platforma, trešās puses serveris vai to kombinācija.

4) Datu nosūtīšana uz trešās puses serveri

4.1 TCP un TLS

IAMMETER var nosūtīt skaitītāja datus uz TCP vai TLS gala punktu.

Pašreizējā WebUI:

1. Izvēlieties TCP darba režīmu.
2. Ievadiet galamērķa adresi.
3. Konfigurējiet augšupielādes intervālu.
4. Saglabājiet iestatījumus un pārbaudiet datus saņemošajā serverī.

TCP serverim izmantojiet:

{domain-or-ip}:{port}

Piemērs:

abc.com:12345

TLS serverim izmantojiet:

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

Piemērs:

tls://abc.com:12345

Pašreizējās programmaparatūras pārskatā norādīts minimālais augšupielādes intervāls — 2 sekundes. Pirms īsa intervāla izvēles apstipriniet pašreizējo programmaparatūru un saņemošā servera jaudu.

4.2 MQTT un MQTTS

IAMMETER var publicēt telemetriju tieši uz parastu MQTT brokeri vai izmantot MQTTS šifrētai datu pārraidei atbalstošajās programmaparatūrās.

Pašreizējā WebUI:

1. Izvēlieties MQTT darba režīmu.
2. Ievadiet brokera IP adresi vai domēnu un portu atbilstošā MQTT vai MQTTS formātā.
3. Ja nepieciešama autentifikācija, ievadiet brokera lietotājvārdu un paroli.
4. Konfigurējiet augšupielādes intervālu.
5. Saglabājiet un pārbaudiet, ka ziņojumi nonāk brokerī.

Parastam MQTT ievadiet brokera adresi un portu bez mqtt:// priedēkļa:

192.168.11.163:1883

MQTTS gadījumā iekļaujiet mqtts:// priedēkli:

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

Piemērs:

mqtts://broker.example.com:8883

MQTTS atbalstam, kas aprakstīts 2025. gada novembra programmaparatūras atjauninājumā, pašlaik ir šādi ierobežojumi:

• Tiek atbalstīts tikai TLS 1.2 un vecāki.
• Pielāgota CA sertifikāta augšupielāde netiek atbalstīta.
• Resursdatora vārda (hostname) pārbaude netiek atbalstīta.
• Klienta puses sertifikāti abpusējai TLS autentifikācijai netiek atbalstīti.

Šie ierobežojumi ir svarīgi, izvēloties brokeri un izvērtējot sistēmas drošības prasības.

Pašreizējās programmaparatūras pārskatā norādīts minimālais augšupielādes intervāls — 2 sekundes.

Home Assistant MQTT Discovery ir papildu Home Assistant atklāšanas funkcija; tā nav nepieciešama katrai MQTT integrācijai. Skatiet:

• IAMMETER MQTT integrācijas rokasgrāmata
• MQTT Discovery funkcija Home Assistant

uploadInterval attālināta mainīšana, izmantojot MQTT/MQTTS

Ar programmaparatūru, kas aprakstīta 2025. gada novembra atjauninājumā, skaitītājs MQTT režīmā automātiski abonē:

device/{sn}/config

Publicējiet šādu JSON no cita MQTT klienta, lai attālināti mainītu augšupielādes intervālu:

{"uploadInterval": 10}

Aizstājiet 10 ar vajadzīgo intervālu sekundēs un {sn} ar skaitītāja sērijas numuru tēmā.

Šī attālinātā MQTT konfigurācija atšķiras no vecākās lokālās /api/uploadinterval metodes, kas saglabāta "Legacy" sadaļā.

4.3 HTTP un HTTPS

IAMMETER var nosūtīt datus uz pielāgotu HTTP/HTTPS serveri.

Pašreizējā WebUI:

1. Izvēlieties HTTP darba režīmu.
2. Ievadiet servera adresi un portu.
3. Konfigurējiet augšupielādes intervālu.
4. Saglabājiet un pārbaudiet pieprasījumus serverī.

Pašreizējā programmaparatūra atbalsta gan noklusēto HTTPS portu, gan pielāgotu HTTPS portu.

Izmantojiet vienu no šiem formātiem:

• Parasts HTTP bez norādīta porta: {address} — pēc noklusējuma porta 80.
• Parasts HTTP ar pielāgotu portu: {address}:{port}.
• HTTPS bez norādīta porta: https://{address} — pēc noklusējuma porta 443.
• HTTPS ar pielāgotu portu: https://{address}:{port} — tiek izmantots norādītais ports.

Priedēklis https:// izvēlas HTTPS. Ports 443 vairs nav vienīgais HTTPS pieejamais ports.

Piemēri:

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

Programmaparatūras laidiena aprakstu skatiet rakstā Jaunā programmaparatūra ievieš MQTTS, attālo konfigurāciju un pielāgotu HTTPS portu.

Par servera puses datu apstrādi skatiet arī rakstu IAMMETER integrēšana ar trešās puses serveri.

5) Datu lasīšana lokāli, izmantojot HTTP

Pievienojiet skaitītāju lokālajam tīklam un pieprasiet datus no tā lokālās IP adreses. Šiem pieprasījumiem nav nepieciešams IAMMETER-Cloud.

Pārbaudi API interaktīvi: atveriet IAMMETER lokālās API pārlūku, ievadiet skaitītāja lokālo IP adresi un izvēlieties WEM API testa lapu. Swagger stila pārlūks parāda pieejamās lokālās API un ļauj sūtīt testa pieprasījumus tieši no pārlūka. Jūsu pārlūkam un IAMMETER skaitītājam jāatrodas vienā lokālajā tīklā.

5.1 GET /api/monitorjson

Atgriež reāllaika elektriskos mērījumus.

Standarta dati ietver tādas vērtības kā:

• Spriegums
• Strāva
• Aktīvā jauda
• Importa kWh (saņemtā enerģija)
• Eksporta kWh (atdotā enerģija)
• Frekvence
• Jaudas koeficients

Atbildes piemērs:

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

Mērījumu masīvu skaits ir atkarīgs no skaitītāja modeļa un kanālu skaita.

Ja reaktīvās jaudas mērīšana ir iespējota atbalstošā modelī/programmaparatūrā, atbildes formātā var būt papildu lauki. Skatiet Reaktīvās jaudas mērījumu datu formāts.

5.2 GET /api/monitor

Atgriež paplašinātu reāllaika atbildi, kas ietver arī Wi-Fi informāciju, piemēram:

• ssid — pievienotā piekļuves punkta nosaukums
• sig — Wi-Fi signāla stiprums

Izmantojiet šo gala punktu, ja integrācijai nepieciešami gan elektriskie mērījumi, gan pamata Wi-Fi statuss.

5.3 GET /api/wifidata

Atgriež programmaparatūras, ierīces un tīkla konfigurācijas informāciju.

Piemērs:

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

Nepublicējiet atbildes, kas satur ierīces sērijas numurus, MAC adreses, iekšējo adresāciju vai Wi-Fi informāciju, ja vien vērtības nav attīrītas.

6) JSON formāts visos augšupielādes režīmos

IAMMETER izmanto vienotu pamata JSON mērījumu struktūru HTTP, TCP, MQTT un lokālajā API. Tas samazina darbu, ja viena saņemošā sistēma atbalsta vairākas pārraides metodes.

Pārraides metode un iesaiņojums (envelope) joprojām var ietekmēt to, kā uztvērējs pieslēdzas, autentificējas vai veido ziņojuma rāmi. Ieviesiet saņemošo sistēmu atbilstoši dokumentētajam izvēlētā režīma formātam.

• IAMMETER enerģijas skaitītāja JSON datu definīcija

7) Modbus TCP

IAMMETER skaitītāji atbalsta Modbus TCP tiešai LAN integrācijai ar saderīgiem klientiem.

Tipiski klienti:

• Home Assistant
• PLC
• SCADA sistēmas
• Rūpnieciskie vārtejas (gateway)
• Pielāgotas Modbus lietotnes

Atsauces:

• IAMMETER Modbus TCP pārskats
• Home Assistant integrācijas pārskats

Pirms ieviešanas apstipriniet skaitītāja modeli, programmaparatūru, reģistru definīcijas, aptaujas intervālu un klienta uzvedību.

8) Integrācijas scenāriji

9) Pašreizējo saskarņu kopsavilkums un resursi

Papildu resursi:

• Jaunākā programmaparatūra
• MQTTS un pielāgotā HTTPS porta programmaparatūras piezīme
• Video apmācības
• JSON datu definīcija
• Modbus TCP pārskats
• Izstrādājiet savu sistēmu
• Monitorings bez interneta pieslēguma

IAMMETER lokālās API un atvērtie protokoli ļauj sākt ar reāllaika monitoringu un vēlāk pievienot pielāgotu EMS, pašmitinātu datu paneli vai automatizācijas darbplūsmu.

10) Mantotās programmaparatūras lapas un konfigurācijas metodes

Tālāk sniegtais materiāls saglabāts tikai skaitītājiem, kuros joprojām darbojas vecāka programmaparatūra, vai lietotājiem, kas uztur esošu integrāciju. Jaunām instalācijām atjauniniet uz jaunāko programmaparatūru un izmantojiet pašreizējo WebUI, kur vien nepieciešamā iespēja ir pieejama.

10.1 Mantotā darba režīma lapa

Vecākā programmaparatūra izmantoja šādu darba režīma izvēles lapu:

Izkārtojums un opciju nosaukumi var neatbilst iepriekš šajā rokasgrāmatā parādītajai pašreizējai WebUI.

10.2 Mantotā TCP/TLS lapa

Vecākās programmaparatūras integrācijas var atsaukties uz šo TCP/TLS konfigurācijas lapu un saistīto rokasgrāmatu:

• Mantotā trešās puses servera integrācijas rokasgrāmata
• Mantotais video "augšupielāde uz serveri"

10.3 Mantotā MQTT lapa

Vecākā MQTT dokumentācija izmantoja šo konfigurācijas saskarni:

Pašreizējai darbplūsmai izmantojiet šī raksta sākumā sniegtās pašreizējās WebUI instrukcijas un atjaunināto MQTT integrācijas rokasgrāmatu.

10.4 Mantotā HTTP/HTTPS lapa

Vecākā programmaparatūra izmantoja šādu HTTP/HTTPS galamērķa lapu:

Mantotā integrācijas rokasgrāmata saglabāta rakstā Augšupielāde, izmantojot HTTP/HTTPS.

Šajā vecākajā darbplūsmā HTTPS bija saistīts ar noklusēto portu 443 un neprasīja https:// priedēkli. Pašreizējā programmaparatūra savukārt izmanto https:// priedēkli HTTPS izvēlei un atbalsta gan noklusēto portu 443, gan tieši norādītu pielāgotu portu.

10.5 Mantotās konfigurācijas API

Tālāk minētie lokālie API izsaukumi parādījās vecākās konfigurācijas darbplūsmās. Pašreizējā programmaparatūrā atbilstošie iestatījumi parasti jākonfigurē, izmantojot WebUI, ja vien attiecīgā iespēja ir pieejama.

/api/uploadinterval?x=<seconds>

Mantotā metode augšupielādes intervāla iestatīšanai režīmos, kas nav Cloud.

/api/mqtt

Mantotā metode MQTT akreditācijas datu konfigurēšanai.

/api/netmetring

Mantotā metode Neto enerģijas uzskaites (Net Energy Metering) režīma iespējošanai vai atspējošanai.

• Neto enerģijas uzskaites atsauce

/api/ctcratio

Mantotā metode dokumentētā C fāzes reizinātāja piemērošanai noteiktos divfāžu vai līdzsvarotos scenārijos.

• CTC koeficienta atsauce

/api/reactive

Mantotā metode reaktīvās jaudas un reaktīvās enerģijas mērīšanas iespējošanai vai atspējošanai atbalstošajās programmaparatūrās/modeļos.

• Reaktīvās jaudas atsauce

/api/ratio — tikai WEM3046T

WEM3046T izmanto ārējos strāvas transformatorus (CT) ar 5 A sekundārajiem izejas signāliem. Vecākos konfigurācijas norādījumos CT koeficients tika iestatīts ar:

/api/ratio?x={ct_ratio}

Piemērs:

/api/ratio?x=400

Šis gala punkts ir specifisks WEM3046T modelim un nav derīgs citiem IAMMETER modeļiem. Pašreizējā programmaparatūrā izmantojiet modeļa pašreizējo WebUI konfigurāciju, ja tā ir pieejama.

Mantotais materiāls saglabāts atpakaļejošai atsaucei; jaunās instalācijās ievērojiet jaunākās programmaparatūras WebUI.