Modbus TCP energimåler-integrasjon: registre og testing
Modbus TCP energimåler-integrasjon for lokal overvåking
Modbus TCP lar et lokalt program lese elektriske målinger direkte fra en IAMMETER Wi-Fi-energimåler.
Det er egnet for:
- PLC- og SCADA-systemer;
- Home Assistant og Node-RED;
- lokale energistyringssystemer (EMS);
- bygningsstyringssystemer (BMS);
- ettsekunds overvåking og automatisering;
- applikasjoner som må fungere uten IAMMETER-Cloud.
IAMMETER energimåler
│
│ Wi-Fi / LAN
│ Modbus TCP
▼
Home Assistant, Node-RED, PLC, SCADA eller egendefinert EMS
Klienten starter hver forespørsel. Måleren returnerer registerverdier for spenning, strøm, aktiv effekt, importert energi, eksportert energi, effektfaktor, frekvens og andre støttede målinger.
Modbus TCP er et lokalt avspørringsgrensesnitt. Hvis måleren skal publisere data til en broker, bruk MQTT. Hvis den skal laste opp data til en kundeserver, se Motta IAMMETER-data på din egen server.
1. Hvorfor bruke Modbus TCP?
Sammenlignet med skybasert avspørring eller periodiske måleropplastinger gir Modbus TCP:
- direkte tilgang over det lokale nettverket;
- ingen avhengighet av IAMMETER-Cloud for databanen;
- et standardisert registerbasert grensesnitt;
- ettsekunds avspørring for støttede applikasjoner;
- signerte verdier for aktiv effekt for toveis energiovervåking;
- kompatibilitet med vanlige automatiserings- og industrielle verktøy.
Typiske bruksområder inkluderer:
- å styre en last basert på sanntids netteffekt;
- å lese solproduksjon, nettoverføring eller kretsbelastning lokalt;
- å legge til en energimåler i Home Assistant;
- å samle målinger i Node-RED;
- å integrere elektrisitetsdata i en PLC, SCADA, EMS eller BMS.
2. Støttede IAMMETER-målere
Gjeldende IAMMETER-energimålermodeller støtter de tilgjengelige Home Assistant- og åpne integreringsmodusene, inkludert Modbus TCP. Den utgåtte WEM3162 er ikke omtalt i denne veiledningen.
Den viktigste forskjellen mellom modellene er antall og formål på målekanalene:
- enkanalsmålere eksponerer fase A-registerblokken;
- tokanals- eller deltfasemålere bruker de aktuelle kanalblokkene;
- trefasemålere eksponerer fase A-, B- og C-blokkene;
- støttede målere kan også eksponere totaler og valgfrie reaktive målinger.
Valider alltid registerresponsen opp mot den eksakte modellen og fastvaren som brukes i prosjektet.
WEM3046T og WEM3046TE
WEM3046T og WEM3046TE måler 5 A-sekundærutgangen til en ekstern strømtransformator.
Primærsideverdiene for strøm, effekt og energi må derfor bruke den aktuelle eksterne CT-omsetningen. Dette skaleringskravet skyldes målerens 5 A CT-inngangsdesign; det er ikke en Modbus TCP- eller plattformspesifikk oppførsel.
Hold CT-omsetningshåndteringen dokumentert og testet der disse modellene er integrert.
3. Tilkoblingsparametere
Det offisielle IAMMETER Modbus Poll-eksemplet bruker:
| Parameter | Eksempelverdi |
|---|---|
| Tilkobling | Modbus TCP/IP |
| Vert | Målerens lokale IP-adresse |
| TCP-port | 502 |
| Enhet / Unit ID | 1 |
| Funksjonskode | 03 — Les holding-registre |
| Svartidsavbrudd | 1000 ms i eksemplet |

Bruk målerens LAN-IP-adresse som vert. Å reservere adressen i ruteren kan hindre at en integrasjon bryter sammen etter en DHCP-adresseendring.
Verdiene ovenfor er parameterne som vises i det offisielle eksemplet. Bekreft den faktiske fastvaren og nettstedskonfigurasjonen før du hardkoder dem i produksjonsprogramvare.
4. Rask test med Modbus Poll
For å bekrefte tilkoblingen før du konfigurerer en full plattform:
- koble datamaskinen og IAMMETER-måleren til samme LAN;
- finn målerens lokale IP-adresse;
- opprett en Modbus TCP/IP-tilkobling til port
502; - sett Device ID til
1; - velg funksjonskode
03; - forespør holding-registre fra adresse
0; - sammenlign de returnerte råverdiene med skaleringsreglene nedenfor.

Skjermbildet bruker en visningsfrekvens på 500 ms for testing. For normal bruk anbefaler IAMMETER-dokumentasjonen ettsekunds avspørring i stedet for å behandle den raskeste klientinnstillingen som det støttede produksjonsintervallet.
Hvis tilkoblingen mislykkes, kontroller:
- at måleren og klienten er på samme tilgjengelige nettverk;
- målerens IP-adresse;
- TCP-port 502 og brannmurregler;
- Device ID og funksjonskode;
- om et annet program allerede styrer den tiltenkte avspørringsprosessen;
- målerens fastvareversjon.
5. Registerdatatyper og skalering
IAMMETER bruker 16-bits holding-registre.
16-bits verdier
Spenning, strøm, effektfaktor og frekvens bruker ett register:
| Måling | Råtype | Konvertering |
|---|---|---|
| Spenning | Usignert 16-bit | V = raw / 100 |
| Strøm | Usignert 16-bit | A = raw / 100 |
| Effektfaktor | Usignert 16-bit | PF = raw / 1000 |
| Frekvens | Usignert 16-bit | Hz = raw / 100 |
32-bits verdier
Aktiv effekt, akkumulert energi og reaktive verdier bruker to påfølgende registre.
Det offisielle Modbus Poll-eksemplet viser høyordens 16-bits ordet først. Kombiner ordene slik:
raw32 = (register[n] << 16) | register[n + 1]
Tolk aktiv og reaktiv effekt som signerte 32-bits verdier. Tolk pulstellere for akkumulert energi som usignerte 32-bits verdier.
| Måling | Råtype | Konvertering |
|---|---|---|
| Aktiv effekt | Signert 32-bit | W = raw32 |
| Importert/forover energi | Usignert 32-bit | kWh = raw32 / 800 |
| Eksportert/revers energi | Usignert 32-bit | kWh = raw32 / 800 |
| Reaktiv effekt | Signert 32-bit | var = raw32 |
| Induktiv/kapasitiv reaktiv energi | Usignert 32-bit | kvarh = raw32 / 1000 |
Signert aktiv effekt gjør at en integrasjon kan skille motsatte effektretninger. Bekreft fortegnskonvensjonen mot CT-orienteringen og applikasjonens kabling under idriftsettelse.
6. Kjerneregisterkart for Modbus
Registeradressene nedenfor er desimale forskyvninger. Klienten bør bruke funksjonskode 03.
Fase A
| Adresse | Lengde | Måling | Konvertering |
|---|---|---|---|
| 0 | 1 | Spenning | Usignert, /100 V |
| 1 | 1 | Strøm | Usignert, /100 A |
| 2 | 2 | Aktiv effekt | Signert, W |
| 4 | 2 | Importert/forover energi | Usignert, /800 kWh |
| 6 | 2 | Eksportert/revers energi | Usignert, /800 kWh |
| 8 | 1 | Effektfaktor | Usignert, /1000 |
| 9 | 1 | Modellidentifikator i det gamle kartet | Ikke bruk som eneste gjeldende modellkatalog |
Fase B
| Adresse | Lengde | Måling | Konvertering |
|---|---|---|---|
| 10 | 1 | Spenning | Usignert, /100 V |
| 11 | 1 | Strøm | Usignert, /100 A |
| 12 | 2 | Aktiv effekt | Signert, W |
| 14 | 2 | Importert/forover energi | Usignert, /800 kWh |
| 16 | 2 | Eksportert/revers energi | Usignert, /800 kWh |
| 18 | 1 | Effektfaktor | Usignert, /1000 |
| 19 | 1 | Reservert | Ikke i bruk |
Fase C
| Adresse | Lengde | Måling | Konvertering |
|---|---|---|---|
| 20 | 1 | Spenning | Usignert, /100 V |
| 21 | 1 | Strøm | Usignert, /100 A |
| 22 | 2 | Aktiv effekt | Signert, W |
| 24 | 2 | Importert/forover energi | Usignert, /800 kWh |
| 26 | 2 | Eksportert/revers energi | Usignert, /800 kWh |
| 28 | 1 | Effektfaktor | Usignert, /1000 |
| 29 | 1 | Reservert | Ikke i bruk |
Frekvens og totaler
| Adresse | Lengde | Måling | Konvertering |
|---|---|---|---|
| 30 | 1 | Frekvens | Usignert, /100 Hz |
| 31 | 1 | Reservert | Ikke i bruk |
| 32 | 2 | Total aktiv effekt | Signert, W |
| 34 | 2 | Total importert/forover energi | Usignert, /800 kWh |
| 36 | 2 | Total eksportert/revers energi | Usignert, /800 kWh |
Totalregisterne er mest relevante for flerkanalsmålere. For en enkanalsintegrasjon, bruk de aktuelle fase A-verdiene og valider eventuelle returnerte totaler.
7. Valgfrie reaktive registre
Reaktive registre er bare tilgjengelige når reaktiv måling støttes og er aktivert av den aktuelle måleren og fastvaren.
| Adresse | Lengde | Måling | Konvertering |
|---|---|---|---|
| 38 | 2 | Fase A reaktiv effekt | Signert, var |
| 40 | 2 | Fase A induktiv reaktiv energi | Usignert, /1000 kvarh |
| 42 | 2 | Fase A kapasitiv reaktiv energi | Usignert, /1000 kvarh |
| 44 | 2 | Fase B reaktiv effekt | Signert, var |
| 46 | 2 | Fase B induktiv reaktiv energi | Usignert, /1000 kvarh |
| 48 | 2 | Fase B kapasitiv reaktiv energi | Usignert, /1000 kvarh |
| 50 | 2 | Fase C reaktiv effekt | Signert, var |
| 52 | 2 | Fase C induktiv reaktiv energi | Usignert, /1000 kvarh |
| 54 | 2 | Fase C kapasitiv reaktiv energi | Usignert, /1000 kvarh |
Ikke anta at disse verdiene er aktive på alle installasjoner. Bekreft modellen, fastvaren og innstillingen for reaktiv måling.
8. Registre for enhetsinformasjon
| Adresse | Lengde | Beskrivelse |
|---|---|---|
| 56 | 8 | Enhetens serienummer |
| 64 | 1 | Driftstid i sekunder |
Behandle serienumre og andre enhetsidentifikatorer som driftsdata. Unngå å publisere ikke-sanerte verdier i skjermbilder, logger eller offentlige eksempler.
9. Integreringseksempler
Home Assistant
Modbus TCP er IAMMETER-alternativet i Home Assistant for brukere som trenger raske lokale avlesninger og automatisering.
Bruk IAMMETER Home Assistant-integreringsveiledningen som den viktigste inngangen til HA. Den skiller målersidens konfigurasjon fra Home Assistant-konfigurasjonen og lenker til de gjeldende Modbus-implementeringsmetodene.
Video:
Node-RED
Node-RED kan avspørre holding-registrene, normalisere råverdiene og sende målingene videre til automatiseringsflyter, databaser eller dashbord.
PLC, SCADA, EMS og BMS
For en industriell eller kommersiell integrasjon:
- dokumenter hvilken registerkartversjon som brukes;
- bruk riktig signert/usignert konvertering;
- valider byte- og ordrekkefølge;
- bekreft CT-orientering og CT-omsetning;
- definer tidsavbrudds- og gjenforsøksatferd;
- overvåk siste vellykkede avspørring;
- unngå ikke-støttede avspørringsfrekvenser;
- test nettverksavbrudd og gjenoppretting.
Egendefinert programvare
En egendefinert Modbus TCP-klient bør skille:
- tilkoblings- og gjenforsøkslogikk;
- registeravlesninger;
- 16-bits og 32-bits dekoding;
- målermodell- og kanalkartlegging;
- CT-omsetningsnormalisering der det er nødvendig;
- lagrings- og applikasjonslogikk.
10. Modbus TCP eller et annet IAMMETER-grensesnitt?
| Krav | Anbefalt grensesnitt |
|---|---|
| Ettsekunds lokal avspørring | Modbus TCP |
| Enkel JSON-henting over LAN | Lokal HTTP API |
| Publisere data til flere forbrukere | MQTT |
| Måler laster opp til en kunde-tjeneste på nettet | HTTP/HTTPS |
| Måler laster opp til en egendefinert socket-server | TCP/TLS |
| Ferdig plattformsammenligning | Veiledning for åpen kildekode-integrasjon |
Relaterte veiledninger:
- IAMMETERs lokale API-er og åpne grensesnitt
- Plattformer for energiovervåking med åpen kildekode
- Utvikle ditt eget energiovervåkingssystem
- Bruk IAMMETER uten internett eller sky
11. Fastvare
Modbus TCP er ikke lenger en eksperimentell oppgradering som bare beskrives av den opprinnelige 2022-utgivelsesprosessen. For en gjeldende installasjon, bruk den nyeste fastvaren som er tilgjengelig for målermodellen:
Noter fastvareversjonen som brukes for å validere registerkartet og avspørringsatferden.
12. Tidligere utgivelsesinformasjon
Denne artikkelen ble opprinnelig publisert da Modbus TCP-støtte ble introdusert gjennom en fastvareoppgradering.
De eldre instruksjonene omtalte fastvare 75.68 som et krav for oppgradering og ba brukere om å be om en oppgradering gjennom tilbakemeldingssystemet. Den prosessen er bare tatt med her som historisk sammenheng og bør ikke brukes for en ny installasjon.
Ressurs for den opprinnelige utgivelsen:
Sist oppdatert: 16. juli 2026