Modbus TCP -energiamittarin integrointi: rekisterit ja testaus
Modbus TCP -energiamittarin integrointi paikalliseen seurantaan
Modbus TCP:n avulla paikallinen sovellus voi lukea sähkömittauksia suoraan IAMMETERin Wi-Fi-energiamittarista.
Se soveltuu:
- PLC- ja SCADA-järjestelmiin;
- Home Assistantiin ja Node-REDiin;
- paikallisiin energianhallintajärjestelmiin (EMS);
- rakennusten hallintajärjestelmiin (BMS);
- sekunnin välein tapahtuvaan seurantaan ja automaatioon;
- sovelluksiin, joiden on toimittava ilman IAMMETER-Cloudia.
IAMMETER energy meter
│
│ Wi-Fi / LAN
│ Modbus TCP
▼
Home Assistant, Node-RED, PLC, SCADA or custom EMS
Asiakas aloittaa jokaisen pyynnön. Mittari palauttaa rekisteriarvot jännitteelle, virralle, pätöteholle, tuodulle energialle, viedylle energialle, tehokertoimelle, taajuudelle ja muille tuetuille mittauksille.
Modbus TCP on paikallinen kyselyliittymä. Jos mittarin pitää julkaista tietoja brokerille, käytä MQTT:tä. Jos sen pitää lähettää tietoja asiakkaan palvelimelle, katso IAMMETER-tietojen vastaanottaminen omalle palvelimellesi.
1. Miksi käyttää Modbus TCP:tä?
Verrattuna pilvikyselyyn tai mittarin säännöllisiin lähetyksiin Modbus TCP tarjoaa:
- suoran pääsyn lähiverkon yli;
- ei riippuvuutta IAMMETER-Cloudista datapolun osalta;
- vakioidun rekisteripohjaisen liittymän;
- sekunnin välein tapahtuvan kyselyn tuetuissa sovelluksissa;
- etumerkilliset pätötehoarvot kaksisuuntaiseen energianseurantaan;
- yhteensopivuuden yleisten automaatio- ja teollisuustyökalujen kanssa.
Tyypillisiä käyttötarkoituksia ovat:
- kuorman ohjaus reaaliaikaisen verkkotehon perusteella;
- aurinkotuotannon, verkon vaihdon tai piirikuorman paikallinen luku;
- energiamittarin lisääminen Home Assistantiin;
- mittausten kerääminen Node-REDissä;
- sähködatan integrointi PLC-, SCADA-, EMS- tai BMS-järjestelmään.
2. Tuetut IAMMETER-mittarit
Nykyiset IAMMETER-energiamittarimallit tukevat saatavilla olevia Home Assistant - ja avoimen integroinnin tiloja, mukaan lukien Modbus TCP:n. Käytöstä poistettua WEM3162-mallia ei käsitellä tässä oppaassa.
Tärkein ero mallien välillä on mittauskanavien lukumäärä ja tarkoitus:
- yksikanavaiset mittarit tarjoavat vaiheen A rekisterilohkon;
- kaksikanavaiset tai kaksivaiheiset mittarit käyttävät sovellettavia kanavalohkoja;
- kolmivaiheiset mittarit tarjoavat vaiheiden A, B ja C lohkot;
- tuetut mittarit voivat tarjota myös summa-arvoja ja valinnaisia loismittauksia.
Varmista aina rekisterivastaus projektissa käytetyn tarkan mallin ja laiteohjelmiston mukaisesti.
WEM3046T ja WEM3046TE
WEM3046T ja WEM3046TE mittaavat ulkoisen virtamuuntajan 5 A:n toisio-ulostuloa.
Ensiöpuolen virta-, teho- ja energia-arvoissa on siis käytettävä sovellettavaa ulkoista CT-suhdetta. Tämä skaalausvaatimus johtuu mittarin 5 A:n CT-tulorakenteesta; se ei ole Modbus TCP:lle tai tietylle alustalle ominainen käyttäytyminen.
Dokumentoi ja testaa CT-suhteen käsittely aina, kun näitä malleja integroidaan.
3. Yhteysparametrit
Virallinen IAMMETERin Modbus Poll -esimerkki käyttää:
| Parametri | Esimerkkiarvo |
|---|---|
| Yhteys | Modbus TCP/IP |
| Isäntä | Mittarin paikallinen IP-osoite |
| TCP-portti | 502 |
| Laite-/yksikkötunnus | 1 |
| Toimintokoodi | 03 — Read Holding Registers (pitorekisterien luku) |
| Vastausaikakatkaisu | 1000 ms esimerkissä |

Käytä mittarin lähiverkon IP-osoitetta isäntänä. Osoitteen varaaminen reitittimessä voi estää integraation katkeamisen DHCP-osoitteen muutoksen jälkeen.
Yllä olevat arvot ovat virallisessa esimerkissä näkyvät parametrit. Varmista todellinen laiteohjelmisto ja kohteen määritykset ennen kuin kovakoodaat ne tuotanto-ohjelmistoon.
4. Nopea testi Modbus Pollilla
Voit varmistaa yhteyden ennen koko alustan määritystä:
- yhdistä tietokone ja IAMMETER-mittari samaan lähiverkkoon;
- selvitä mittarin paikallinen IP-osoite;
- luo Modbus TCP/IP -yhteys porttiin
502; - aseta laitetunnukseksi (Device ID)
1; - valitse toimintokoodiksi (Function Code)
03; - pyydä pitorekistereitä osoitteesta
0alkaen; - vertaa palautettuja raaka-arvoja alla oleviin skaalaussääntöihin.

Kuvakaappauksessa käytetään 500 ms:n näyttöskannausta testausta varten. Normaalikäytössä IAMMETERin dokumentaatio suosittelee sekunnin välein tapahtuvaa kyselyä sen sijaan, että nopeinta asiakasasetusta pidettäisiin tuettuna tuotantovälinä.
Jos yhteys epäonnistuu, tarkista:
- että mittari ja asiakas ovat samassa tavoitettavassa verkossa;
- mittarin IP-osoite;
- TCP-portti 502 ja palomuurisäännöt;
- laitetunnus ja toimintokoodi;
- onko jokin toinen sovellus jo ohjaamassa suunniteltua kyselytyönkulkua;
- mittarin laiteohjelmistoversio.
5. Rekisterien tietotyypit ja skaalaus
IAMMETER käyttää 16-bittisiä pitorekistereitä.
16-bittiset arvot
Jännite, virta, tehokerroin ja taajuus käyttävät yhtä rekisteriä:
| Mittaus | Raakatyyppi | Muunnos |
|---|---|---|
| Jännite | Etumerkitön 16-bittinen | V = raw / 100 |
| Virta | Etumerkitön 16-bittinen | A = raw / 100 |
| Tehokerroin | Etumerkitön 16-bittinen | PF = raw / 1000 |
| Taajuus | Etumerkitön 16-bittinen | Hz = raw / 100 |
32-bittiset arvot
Pätöteho, kumulatiivinen energia ja loisarvot käyttävät kahta peräkkäistä rekisteriä.
Virallinen Modbus Poll -esimerkki näyttää korkean 16-bittisen sanan ensin. Yhdistä sanat seuraavasti:
raw32 = (register[n] << 16) | register[n + 1]
Tulkitse pätö- ja loisteho etumerkillisinä 32-bittisinä arvoina. Tulkitse kumulatiiviset energiapulssilaskurit etumerkittöminä 32-bittisinä arvoina.
| Mittaus | Raakatyyppi | Muunnos |
|---|---|---|
| Pätöteho | Etumerkillinen 32-bittinen | W = raw32 |
| Tuotu energia | Etumerkitön 32-bittinen | kWh = raw32 / 800 |
| Viety energia | Etumerkitön 32-bittinen | kWh = raw32 / 800 |
| Loisteho | Etumerkillinen 32-bittinen | var = raw32 |
| Induktiivinen/kapasitiivinen loisenergia | Etumerkitön 32-bittinen | kvarh = raw32 / 1000 |
Etumerkillinen pätöteho mahdollistaa integraation erottaa vastakkaiset tehosuunnat. Varmista etumerkkikäytäntö CT:n suunnan ja sovelluksen kytkennän mukaisesti käyttöönoton yhteydessä.
6. Keskeinen Modbus-rekisterikartta
Alla olevat rekisteriosoitteet ovat desimaalisiirroksia. Asiakkaan tulee käyttää toimintokoodia 03.
Vaihe A
| Osoite | Pituus | Mittaus | Muunnos |
|---|---|---|---|
| 0 | 1 | Jännite | Etumerkitön, /100 V |
| 1 | 1 | Virta | Etumerkitön, /100 A |
| 2 | 2 | Pätöteho | Etumerkillinen, W |
| 4 | 2 | Tuotu energia | Etumerkitön, /800 kWh |
| 6 | 2 | Viety energia | Etumerkitön, /800 kWh |
| 8 | 1 | Tehokerroin | Etumerkitön, /1000 |
| 9 | 1 | Mallitunniste vanhassa kartassa | Älä käytä ainoana nykyisen mallin luettelona |
Vaihe B
| Osoite | Pituus | Mittaus | Muunnos |
|---|---|---|---|
| 10 | 1 | Jännite | Etumerkitön, /100 V |
| 11 | 1 | Virta | Etumerkitön, /100 A |
| 12 | 2 | Pätöteho | Etumerkillinen, W |
| 14 | 2 | Tuotu energia | Etumerkitön, /800 kWh |
| 16 | 2 | Viety energia | Etumerkitön, /800 kWh |
| 18 | 1 | Tehokerroin | Etumerkitön, /1000 |
| 19 | 1 | Varattu | Ei käytössä |
Vaihe C
| Osoite | Pituus | Mittaus | Muunnos |
|---|---|---|---|
| 20 | 1 | Jännite | Etumerkitön, /100 V |
| 21 | 1 | Virta | Etumerkitön, /100 A |
| 22 | 2 | Pätöteho | Etumerkillinen, W |
| 24 | 2 | Tuotu energia | Etumerkitön, /800 kWh |
| 26 | 2 | Viety energia | Etumerkitön, /800 kWh |
| 28 | 1 | Tehokerroin | Etumerkitön, /1000 |
| 29 | 1 | Varattu | Ei käytössä |
Taajuus ja summa-arvot
| Osoite | Pituus | Mittaus | Muunnos |
|---|---|---|---|
| 30 | 1 | Taajuus | Etumerkitön, /100 Hz |
| 31 | 1 | Varattu | Ei käytössä |
| 32 | 2 | Pätöteho yhteensä | Etumerkillinen, W |
| 34 | 2 | Tuotu energia yhteensä | Etumerkitön, /800 kWh |
| 36 | 2 | Viety energia yhteensä | Etumerkitön, /800 kWh |
Summarekisterit ovat olennaisimpia monikanavaisille mittareille. Yksikanavaisessa integraatiossa käytä sovellettavia vaiheen A arvoja ja varmista palautetut summa-arvot.
7. Valinnaiset loisrekisterit
Loisrekisterit ovat käytettävissä vain, kun sovellettava mittari ja laiteohjelmisto tukevat loismittausta ja se on käytössä.
| Osoite | Pituus | Mittaus | Muunnos |
|---|---|---|---|
| 38 | 2 | Vaiheen A loisteho | Etumerkillinen, var |
| 40 | 2 | Vaiheen A induktiivinen loisenergia | Etumerkitön, /1000 kvarh |
| 42 | 2 | Vaiheen A kapasitiivinen loisenergia | Etumerkitön, /1000 kvarh |
| 44 | 2 | Vaiheen B loisteho | Etumerkillinen, var |
| 46 | 2 | Vaiheen B induktiivinen loisenergia | Etumerkitön, /1000 kvarh |
| 48 | 2 | Vaiheen B kapasitiivinen loisenergia | Etumerkitön, /1000 kvarh |
| 50 | 2 | Vaiheen C loisteho | Etumerkillinen, var |
| 52 | 2 | Vaiheen C induktiivinen loisenergia | Etumerkitön, /1000 kvarh |
| 54 | 2 | Vaiheen C kapasitiivinen loisenergia | Etumerkitön, /1000 kvarh |
Älä oleta, että nämä arvot ovat käytössä jokaisessa asennuksessa. Varmista malli, laiteohjelmisto ja loismittauksen asetus.
8. Laitetietorekisterit
| Osoite | Pituus | Kuvaus |
|---|---|---|
| 56 | 8 | Laitteen sarjanumero |
| 64 | 1 | Käyntiaika sekunteina |
Käsittele sarjanumeroita ja muita laitetunnisteita operatiivisena datana. Vältä puhdistamattomien arvojen julkaisemista kuvakaappauksissa, lokeissa tai julkisissa esimerkeissä.
9. Integrointiesimerkkejä
Home Assistant
Modbus TCP on IAMMETERin Home Assistant -vaihtoehto käyttäjille, jotka tarvitsevat nopeita paikallisia lukemia ja automaatiota.
Käytä IAMMETERin Home Assistant -integrointiopasta pääasiallisena HA-tulokohtana. Se erottaa mittaripuolen määrityksen Home Assistantin määrityksestä ja linkittää nykyisiin Modbus-toteutustapoihin.
Video:
Node-RED
Node-RED voi kysellä pitorekistereitä, normalisoida raaka-arvot ja ohjata mittaukset automaatiovuohon, tietokantoihin tai kojelaudoille.
PLC, SCADA, EMS ja BMS
Teollisuus- tai kaupalliseen integraatioon:
- dokumentoi käytetty rekisterikartan versio;
- käytä oikeaa etumerkillistä/etumerkitöntä muunnosta;
- varmista tavu- ja sanajärjestys;
- varmista CT-suunta ja CT-suhde;
- määritä aikakatkaisu- ja uudelleenyrityskäyttäytyminen;
- seuraa viimeisintä onnistunutta kyselyä;
- vältä tukemattomia kyselytaajuuksia;
- testaa verkon katkokset ja palautuminen.
Mukautettu ohjelmisto
Mukautetun Modbus TCP -asiakkaan tulisi erottaa:
- yhteys- ja uudelleenyrityslogiikka;
- rekisteriluvut;
- 16- ja 32-bittinen dekoodaus;
- mittarimallin ja kanavien kartoitus;
- CT-suhteen normalisointi tarvittaessa;
- tallennus- ja sovelluslogiikka.
10. Modbus TCP vai jokin muu IAMMETER-rajapinta?
| Vaatimus | Suositeltu rajapinta |
|---|---|
| Paikallinen kysely sekunnin välein | Modbus TCP |
| Yksinkertainen JSON-haku lähiverkossa | Paikallinen HTTP-rajapinta |
| Tietojen julkaisu useille vastaanottajille | MQTT |
| Mittarin lähetykset asiakkaan verkkopalveluun | HTTP/HTTPS |
| Mittarin lähetykset mukautettuun socket-palvelimeen | TCP/TLS |
| Valmiiden alustojen vertailu | Avoimen lähdekoodin integrointiopas |
Aiheeseen liittyvät oppaat:
- IAMMETERin paikalliset API:t ja avoimet rajapinnat
- Avoimen lähdekoodin energianseuranta-alustat
- Kehitä oma energianseurantajärjestelmäsi
- IAMMETERin käyttö ilman internetiä tai pilveä
11. Laiteohjelmisto
Modbus TCP ei ole enää kokeellinen päivitys, jota kuvattiin vain alkuperäisessä vuoden 2022 julkaisuprosessissa. Nykyiseen asennukseen käytä mittarimallille saatavilla olevaa uusinta laiteohjelmistoa:
Merkitse ylös käytetty laiteohjelmistoversio rekisterikartan ja kyselykäyttäytymisen varmistamista varten.
12. Vanhan julkaisun tiedot
Tämä artikkeli julkaistiin alun perin, kun Modbus TCP -tuki otettiin käyttöön laiteohjelmistopäivityksen kautta.
Vanhemmat ohjeet mainitsivat laiteohjelmiston 75.68 päivityksen edellytyksenä ja pyysivät käyttäjiä pyytämään päivitystä palautejärjestelmän kautta. Tämä prosessi on säilytetty vain historiallisena taustana, eikä sitä tule käyttää uudessa asennuksessa.
Alkuperäinen julkaisuresurssi:
Päivitetty viimeksi: 16. heinäkuuta 2026