Oppsettsveiledning for Home Assistant Modbus TCP-strømmåler

Integrering av Home Assistant Modbus TCP strømmåler

Modbus TCP er en av de raskeste måtene å koble en strømmåler til Home Assistant. Det fungerer over det lokale nettverket, er ikke avhengig av internettilkobling, og er egnet for sanntids strømovervåking, soloverskuddsautomasjon, laststyring og Home Assistant Energy Dashboard.

Alle nåværende IAMMETER-strømmålere støtter Modbus TCP. Du kan integrere dem med Home Assistant på to måter:

1. IAMMETER HACS Modbus-integrasjon — UI-konfigurasjon, automatisk opprettede enheter og et konfigurerbart skanneintervall.
2. Home Assistants innebygde Modbus-integrasjon — YAML-konfigurasjon med direkte kontroll over registre og sensorer.

Denne veiledningen forklarer forskjellene og hjelper deg med å konfigurere den riktige metoden.

HACS Modbus eller innebygd Home Assistant Modbus?

Begge metodene leser de samme lokale Modbus TCP-dataene fra måleren. Hovedforskjellen er hvordan Home Assistant-enhetene konfigureres.

For de fleste brukere er HACS Modbus-integrasjonen det enkleste alternativet. Bruk Home Assistants innebygde Modbus-integrasjon når du trenger en egendefinert registerliste, navngivingsskjema, skaleringsregel eller polling-intervall for individuelle sensorer.

Hvis du ikke trenger raske oppdateringer, kan du sammenligne HTTP- og MQTT-alternativene i oversikten over energimålerintegrasjon for Home Assistant.

Før du begynner

Du trenger:

• en IAMMETER-strømmåler koblet til samme LAN som Home Assistant;
• målerens lokale IP-adresse;
• TCP-port 502 tilgjengelig mellom Home Assistant og måleren;
• en nyere fastvareversjon på måleren;
• HACS installert hvis du velger IAMMETER HACS-integrasjonen.

Det er lurt å reservere målerens IP-adresse i ruteren. En endret DHCP-adresse er en vanlig årsak til at en fungerende Modbus-integrasjon blir utilgjengelig senere.

Metode 1: Konfigurer IAMMETER Modbus via HACS

IAMMETER HACS Modbus-integrasjonen er designet for brukere som ønsker raske lokale data uten å måtte definere hvert register manuelt i YAML.

Trinn 1: Installer integrasjonen

1. Åpne HACS i Home Assistant.
2. Søk etter IamMeter Modbus.
3. Installer den nyeste utgivelsen.
4. Start Home Assistant på nytt hvis du blir bedt om det.

Prosjekt- og utgivelsesinformasjon:

• IAMMETER HACS Modbus-arkiv
• IAMMETER HACS Modbus-utgivelser

Bruk den nyeste tilgjengelige utgivelsen. Innstillingen for skanneintervall støttes av den oppdaterte integrasjonen og videresendes til DataUpdateCoordinator.

Trinn 2: Legg til måleren i Home Assistant

1. Gå til Innstillinger → Enheter og tjenester.
2. Velg Legg til integrasjon.
3. Søk etter IamMeter Modbus.
4. Skriv inn målerens IP-adresse og Modbus TCP-port.
5. Velg riktig måler- eller fasekonfigurasjon.
6. Angi skanneintervallet, eller behold standardverdien på 3 sekunder.
7. Send inn skjemaet og bekreft at enheten og enhetene blir opprettet.

Integrasjonen oppretter et ulikt antall enheter for enfase-, tokanals- og trefasemålere. En kortere enhetsliste betyr ikke at en enfasemodell har begrenset Home Assistant-støtte.

Trinn 3: Kontroller enhetene

Åpne IAMMETER-enheten under Innstillinger → Enheter og tjenester. Avhengig av modell kan tilgjengelige enheter omfatte:

• spenning;
• strøm;
• aktiv effekt;
• effektfaktor;
• importert energi;
• eksportert energi;
• reaktiv effekt eller reaktiv energi når dette er eksponert av den aktuelle måleren og registersettet.

Enhetene for importert og eksportert energi bruker kWh og inkluderer Home Assistant-energimetadataene som kreves av Energy Dashboard.

Trinn 4: Velg et passende skanneintervall

Standardskanneintervallet er 3 sekunder. Dette er et praktisk utgangspunkt for live-dashboards og effektbaserte automasjoner.

Anbefalte utgangspunkter:

En innstilling på ett sekund er en polling-forespørsel, ikke en garanti for at alle Home Assistant-dashboards faktisk oppdateres en gang i sekundet. Nettverksforsinkelse, antall registre, recorder-belastning og frontend-oppfriskningsatferd påvirker også resultatet.

Unngå unødvendig aggressiv polling. For de fleste automasjoner er en stabil oppdatering på 2–5 sekunder mer nyttig enn det kortest mulige intervallet.

Metode 2: Bruk Home Assistants innebygde Modbus-integrasjon

Home Assistant inkluderer en standard Modbus-integrasjon. Denne metoden er helt lokal og krever ikke HACS, men tilkoblingen og sensorene defineres i YAML.

Følgende eksempel leser spenning og aktiv effekt fra en enfasemåler:

modbus:
  - name: iammeter_hub
    type: tcp
    host: 192.168.1.6
    port: 502
    sensors:
      - name: IAMMETER Voltage
        slave: 1
        address: 0
        input_type: holding
        data_type: uint16
        scale: 0.01
        precision: 1
        unit_of_measurement: V
        device_class: voltage
        state_class: measurement
        scan_interval: 5

      - name: IAMMETER Active Power
        slave: 1
        address: 2
        input_type: holding
        data_type: int32
        unit_of_measurement: W
        device_class: power
        state_class: measurement
        scan_interval: 5

Erstatt 192.168.1.6 med målerens faktiske IP-adresse. Sjekk det aktuelle registerkartet før du legger til flere sensorer:

• IAMMETER Modbus TCP registerkart
• Home Assistant Modbus-dokumentasjon

Vanlige IAMMETER Modbus-registre

Følgende adresser illustrerer de standard faseblokkene som brukes av vanlige IAMMETER-målere. Bruk alltid den gjeldende registerdokumentasjonen som autoritativ referanse.

Bruk den dokumenterte skaleringen, presisjonen og ordrekkefølgen for hvert register. Ikke utled energiskalering fra spenningseksemplet.

Etter at du har redigert YAML:

1. kjør Home Assistants konfigurasjonssjekk;
2. start Home Assistant på nytt;
3. åpne Utviklerverktøy → Tilstander;
4. bekreft at de nye enhetene har plausible verdier og enheter.

Legg til importert og eksportert energi i Energy Dashboard

Home Assistant Energy Dashboard trenger kumulative energienheter, ikke øyeblikkelig effekt.

For en manuelt konfigurert Modbus-energisensor inkluderer du de aktuelle metadataene:

unit_of_measurement: kWh
device_class: energy
state_class: total_increasing

Gå deretter til Innstillinger → Dashboards → Energi og velg den importerte energienheten som nettforsyning og den eksporterte energienheten som tilbakelevering til nettet.

Ikke velg en aktiv-effekt-enhet målt i watt for et energifelt i Energy Dashboard. Effekt viser gjeldende rate; importert/eksportert kWh registrerer kumulativ energi.

Støttede IAMMETER-modeller

Alle nåværende IAMMETER-strømmålere støtter både HACS Modbus og Home Assistants innebygde Modbus-integrasjon.

WEM3046T og WEM3046TE måler 5 A-sekundærutgangen til en ekstern strømtransformator. For å få faktisk primærstrøm, effekt og energi må riktig CT-forhold brukes. Dette er en egenskap ved 5 A CT-målesystemet, ikke en begrensning i Home Assistant- eller Modbus-kompatibiliteten.

Kan Modbus og IAMMETER Cloud brukes samtidig?

Ja. Home Assistant leser Modbus TCP lokalt mens måleren kan fortsette å laste opp til IAMMETER Cloud. Du trenger ikke å endre måleren til MQTT-opplastingsmodus for å bruke Modbus.

Dette gir deg to komplementære visninger:

• raske lokale data og automasjoner i Home Assistant;
• langsiktige rapporter, strømkostnadsanalyse, solanalyse og ekstern tilgang i IAMMETER Cloud.

Unngå flere høyfrekvente Modbus-klienter

Bruk én aktiv Modbus TCP-polling-klient per måler som en trygg distribusjonsmodell. Ikke konfigurer Home Assistant, Node-RED, en PLC og en annen logger til å polle samme måler uavhengig med høy frekvens.

Hvis flere systemer trenger de samme live-målingene, la ett system lese Modbus og redistribuere dataene, eller bruk en MQTT-arkitektur der flere forbrukere abonnerer på en broker.

Feilsøking

Home Assistant kan ikke koble til port 502

• Bekreft at Home Assistant og måleren er på samme tilgjengelige nettverk.
• Kontroller målerens IP-adresse og reserver den i ruteren.
• Sjekk at TCP-port 502 ikke er blokkert av en brannmur- eller VLAN-regel.
• Sørg for at en annen Modbus-klient ikke holder eller gjentatte ganger gjenåpner tilkoblingen.

Enheter er utilgjengelige eller verdier endres ikke

• Bekreft valgt måler-/fasetype i HACS-integrasjonen.
• Med YAML: kontroller slave-ID, registeradresse, datatype, skalering og ordrekkefølge.
• Øk skanneintervallet midlertidig for å utelukke for aggressiv polling.
• Start integrasjonen på nytt etter at du har endret målerens IP-adresse.

Verdier er urimelig høye eller lave

• Kontroller registerskaleringen og datatypen.
• For WEM3046T/WEM3046TE: kontroller eksternt CT-forhold.
• Bekreft at enheten tilsvarer den forventede fasen eller målekanalen.

Energienheter vises ikke i Energy Dashboard

• Bruk kumulativ importert/eksportert energi i kWh.
• Bekreft device_class: energy.
• Bekreft state_class: total_increasing.
• Ikke bruk en effektenhet i watt.

Bygg automasjoner med sanntids strømdata

Når Modbus-enhetene fungerer, kan Home Assistant bruke aktiv effekt eller netteksport-effekt til å styre andre enheter. Eksempler inkluderer:

• styr et relé med sanntids Modbus-strømdata;
• lad en elbil når soleksporten overstiger en terskel;
• varm vann med tilgjengelig soloverskudd;
• varsle brukeren når husholdningens forbruk overstiger en grense;
• reduser en styrbar last før dyr topplaststrøm importeres.

Hold integrasjonsveiledningen fokusert på å etablere pålitelige data først. Legg til kontrolllogikk først etter at du har sjekket fortegnskonvensjonen, enhetene, oppdateringsintervallet og atferden når måleren blir utilgjengelig.

Relaterte Home Assistant-veiledninger

• Sammenlign alle IAMMETER–Home Assistant-integreringsmetoder
• Konfigurer en energimåler med en MQTT-server
• Home Assistant MQTT Discovery for en energimåler
• Home Assistant solenergiovervåking
• Home Assistant og Grafana