IAMMETER Wi-Fi-energiamittari: Paikallinen integrointi ja avoimen rajapinnan opas

IAMMETER Wi-Fi-energiamittari: Paikallinen integrointi ja avoimen rajapinnan opas

IAMMETER-mittareita käyttäville kehittäjille ja järjestelmäintegraattoreilleilmanIAMMETER-pilvi.

IAMMETER Wi-Fi -energiamittarit on suunniteltu sekä pilvipohjaisiin että paikallisiin integraatioihin, ja ne tarjoavat avoimia API-rajapintoja (HTTP, MQTT, Modbus/TCP), joiden avulla kehittäjät voivat rakentaa omia energianhallintajärjestelmiään (EMS), kiinteistönhallintajärjestelmiään (BMS) tai älykkäitä kodin automaatioalustojaan.

IAMMETER-laiteohjelmistoa päivitetään jatkuvasti. Tässä dokumentissa luetellaan kaikki uusimman laiteohjelmiston tukemat paikalliset ja avoimet integraatio-ominaisuudet.(Jatkuvasti päivitetty)

1) Laiteohjelmistopäivitys

Hanki uusimmat laiteohjelmistojulkaisut täältä:

• Laiteohjelmiston julkaisusivu (meter.club): https://imeter.club/topic/11

2) Suoritustilat (ei pilvi)

Valitse tila sen perusteella, miten integroit tai käytät laitetta.

Vanhan laiteohjelmiston käyttöliittymä

Uusin laiteohjelmistoVerkkokäyttöliittymä

(Muut asiakirjasi osat pysyvät muuttumattomina viimeisimpään versioon verrattuna.)

3) TCP / TLS / MQTT-integraatio

3.1 TCP ja TLS

Mittarit voivat lähettää dataa suoraan TCP/TLS-päätepisteeseesi.

🔹 Uusi laiteohjelmiston kokoonpano

Uusimman laiteohjelmiston määritysprosessi on samanlainen kuin aiemmissa versioissa.

Suoritustila: TCP

Osoite:

• TCP-palvelimelle — kirjoita{verkkotunnus}:{portti}(esim.,abc.com:12345).
• TLS-palvelimelle — käytätls://{verkkotunnus}:{portti}(esim.,tls://abc.com:12345).

Latausväli:Lyhin latausväli on2 sekuntia.

🔹 Vanhan laiteohjelmiston kokoonpano

• Opas:Kolmannen osapuolen palvelinintegraatio (TCP/TLS)
• Video:Lataa energiatiedot kolmannen osapuolen palvelimelle

3.2 MQTT

🔹 Uusi laiteohjelmiston kokoonpano

Suoritustila: MQTT Osoite:Anna IP-osoite tai verkkotunnus portin kera, esim.192.168.11.163:1883 Käyttäjätunnus / Salasana:MQTT-välittäjän tunnistetiedot (valinnainen, jos välittäjä ei vaadi niitä)

Latausväli:Minimiväli on2 sekuntia. HA MQTT -löytö: Ota MQTT-etsintä käyttöön Home Assistantissa

🔹 Vanhan laiteohjelmiston kokoonpano

Julkaise telemetriatiedot paikalliselle tai julkiselle MQTT-välittäjälle.

• Opas:MQTT-integraatio-opas

4) HTTP/HTTPS-integraatio

🔹 Vanhan laiteohjelmiston kokoonpano

Mittarit voivat lähettää tietoja suoraan mukautetulle palvelimellesi.

• Tiedon hyötykuorman muoto on identtinen TCP/MQTT-tilojen kanssa.
• Mitä tahansa porttia voidaan käyttää.
• Portti443ottaa HTTPS:n käyttöön automaattisesti.
• Yksityiskohdat:Lähetä HTTP/HTTPS-yhteyden kautta

🔹 Uusi laiteohjelmiston kokoonpano

Osoite:Syöttömuoto on sama kuin vanhassa laiteohjelmistossa.

• Jos porttia ei ole määritetty, oletusportti on80.
• Vain portti443käyttää HTTPS-postia; kaikki muut portit käyttävät HTTP-postia.

5) Paikallinen API (HTTP lähiverkon kautta)

Käytä mittaria paikallisesti sen lähiverkon IP-osoitteen kautta – pilviyhteyttä ei tarvita.

5.1 GET /api/monitorjson

Palauttaa reaaliaikaisen mittausdatan.Kentät:Jännite, virta, pätöteho, eteen-/taaksepäin kWh, taajuus, tehokerroin.

Esimerkki:

{
”menetelmä”: ”lataukset”,
”mac”: ”B0F8933C4F94”,
”versio”: ”i.75.97.9”,
”palvelin”: ”em”,
”sarjanumero”: ”3E0BAF87”,
”tiedot”: [
[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]
]
}

📘 Loistehon mittauksen laajennus

5.2 GET /api/monitor

Edistynyt versioMonitorjson, sisältää Wi-Fi-signaalin tiedot:

• SSID(yhdistetyn tukiaseman nimi)
• allekirjoitus(signaalin voimakkuus)

5.3 GET /api/wifidata

Palauttaa Wi-Fi- ja verkkoasetukset.

{
”versio”: ”i.75.97.9”, ”SN”: ”3E0BAF87”, ”mac”: ”B0F8933C4F94”,
”tyyppi”: ”PM”, ”ssid”: ”CMCC-laohe”, ”ip”: ”192.168.11.62”,
”verkkomaski”: ”255.255.255.0”, ”gw”: ”192.168.11.253”,
”dns”: ”114.114.114.114.114”, ”dhcp”: 1, ”runMode”: ”tcp”, ”uploadinterval”: 60
}

5.4 GET /api/uploadinterval?x=

Asettaa latausvälin (sekunteina).

Toimii muissa kuin pilvitiloissa (TCP/HTTP/MQTT).

SisäänUusin laiteohjelmisto, tämä parametri voidaan nyt määrittää suoraanWebUI-käyttöliittymäkutsumatta API:a manuaalisesti.

5.5 GET /api/mqtt

Määrittää MQTT-tunnistetiedot. 📘MQTT Config API -dokumentaatio

SisäänUusin laiteohjelmisto, tämä parametri voidaan nyt määrittää suoraanWebUI-käyttöliittymäkutsumatta API:a manuaalisesti.

5.6 GET /api/netmetring

VaihdaNettoenergian mittaus (NEM)tila. 📘Ota NEM-tila käyttöön

SisäänUusin laiteohjelmisto, tämä parametri voidaan nyt määrittää suoraanWebUI-käyttöliittymäkutsumatta API:a manuaalisesti.

5.7 GET /api/ctcratio

SäätääVaiheen C kerroinjaetun vaiheen/tasapainotetun skenaarioissa.

• x=2kaksinkertaistaa vaiheen C lukemat (virta, teho, kWh). 📘CTC-suhteen selitys

SisäänUusin laiteohjelmisto, tämä parametri voidaan nyt määrittää suoraanWebUI-käyttöliittymäkutsumatta API:a manuaalisesti.

5.8 GET /api/reactive

Ottaa käyttöön tai poistaa käytöstäLoisteho (Q)jaLoisenergia (kVARh)mittaus. 📘Loistehon dokumentaatio

SisäänUusin laiteohjelmisto, tämä parametri voidaan nyt määrittää suoraanWebUI-käyttöliittymäkutsumatta API:a manuaalisesti.

5.9 GET /api/suhde (saatavilla vain mallille WEM3046T)

KoskaWEM3046Tkäyttää ulkoisia CT-transistoreita5A:n toissijaiset lähdöt(esim. 1000:5, 1500:5, 2000:5 jne.), mitatut arvot (virta, teho, energia) on kerrottava virtamuuntajan suhteella.

Esimerkki:

/api/suhde?x=400

• Aseta suhde: /api/suhde?x={ct_suhde}
• Kyselyiden suhde: /api/suhde

VainWEM3046Ttukee ulkoisia 5A virtamuuntajia — tämä API ei ole voimassa muissa malleissa.

6) JSON-muodon yhdenmukaisuus

Kaikki viestintämuodot —HTTP, TCP, MQTT, paikallinen API— käytä samaa JSON-rakennetta. 📘JSON-datan määritelmä

7) Modbus/TCP-tuki

IAMMETER-mittarit tukevat natiivistiModbus/TCP, mikä mahdollistaa suoran integroinninKotiavustaja, PLC:t, taiSCADA-järjestelmäjärjestelmät.

• Modbus/TCP-yleiskatsaus
• Home Assistant Modbus -esimerkki

8) Tuetut integraatioskenaariot

9) Resurssit

• Laiteohjelmistojulkaisut
• Video-opetusohjelmat
• JSON-määritelmä
• Modbus/TCP-yleiskatsaus
• Kehitä oma järjestelmäsi

10) Kehittäjän yhteenveto

| Ominaisuus | Käyttöoikeus | Muistiinpanot | | -- ...---------- | | Reaaliaikainen paikallinen data | Paikallinen API |/api/monitorjson, /api/monitor| | Kolmannen osapuolen lataus | TCP/TLS, HTTP/HTTPS | Sama hyötykuorman kaava | | MQTT-julkaisu | MQTT-välittäjä |/api/mqtttunnistetietojen asettamiseen | | Netin mittaus | Paikallinen API |/api/netmetrointi| | Loisteho/energia | Paikallinen API |/api/reactive| | Vaihe-C kerroin | Paikallinen API |/api/ctcratio?x=1 | | CT-suhde (WEM3046T) | Paikallinen API |/api/ratio?x=` | | Modbus/TCP | Modbus-asiakasohjelma | Yhteensopiva HA/PLC/SCADA-laitteiden kanssa |

Viimeksi päivitetty: 15. lokakuuta 2025