Home Assistant Modbus TCP energimåler – opsætningsvejledning

Home Assistant Modbus TCP energimåler-integration

Modbus TCP er en af de hurtigste måder at forbinde en energimåler til Home Assistant. Det fungerer over det lokale netværk, er ikke afhængig af en internetforbindelse og er velegnet til realtids-effektovervågning, solcelleoverskudsautomatisering, laststyring og Home Assistant Energy Dashboard.

Alle nuværende IAMMETER-energimålere understøtter Modbus TCP. Du kan integrere dem med Home Assistant på to måder:

1. IAMMETER HACS Modbus-integration — UI-konfiguration, automatisk oprettede entiteter og et konfigurerbart scanningsinterval.
2. Home Assistants indbyggede Modbus-integration — YAML-konfiguration med direkte kontrol over registre og sensorer.

Denne vejledning forklarer forskellene og hjælper dig med at konfigurere den rigtige metode.

HACS Modbus eller indbygget Home Assistant Modbus?

Begge metoder læser de samme lokale Modbus TCP-data fra måleren. Den største forskel er, hvordan Home Assistant-entityerne konfigureres.

For de fleste brugere er HACS Modbus-integrationen den enklere mulighed. Brug Home Assistants indbyggede Modbus-integration, når du har brug for en brugerdefineret registerliste, navngivningsskema for entiteter, skaleringsregel eller polling-interval for individuelle sensorer.

Hvis du ikke har brug for hurtige opdateringer, kan du sammenligne HTTP- og MQTT-alternativerne i Home Assistant energimåler-integrationsoversigt.

Før du går i gang

Du skal bruge:

• en IAMMETER-energimåler tilsluttet det samme LAN som Home Assistant;
• målerens lokale IP-adresse;
• TCP-port 502, der er tilgængelig mellem Home Assistant og måleren;
• en nyere firmwareversion til måleren;
• HACS installeret, hvis du vælger IAMMETER HACS-integrationen.

Det er en god idé at reservere målerens IP-adresse i din router. En skiftende DHCP-adresse er en almindelig årsag til, at en fungerende Modbus-integration senere bliver utilgængelig.

Metode 1: Konfigurér IAMMETER Modbus via HACS

IAMMETER HACS Modbus-integrationen er designet til brugere, der ønsker hurtige lokale data uden manuelt at definere hvert register i YAML.

Trin 1: Installér integrationen

1. Åbn HACS i Home Assistant.
2. Søg efter IamMeter Modbus.
3. Installér den nyeste udgivelse.
4. Genstart Home Assistant, hvis du bliver bedt om det.

Projekt- og udgivelsesoplysninger:

• IAMMETER HACS Modbus repository
• IAMMETER HACS Modbus releases

Brug den nyeste tilgængelige udgivelse. Scanningsinterval-indstillingen understøttes af den opdaterede integration og videregives til DataUpdateCoordinator.

Trin 2: Tilføj måleren i Home Assistant

1. Gå til Indstillinger → Enheder og tjenester.
2. Vælg Tilføj integration.
3. Søg efter IamMeter Modbus.
4. Indtast målerens IP-adresse og Modbus TCP-port.
5. Vælg den passende måler-type eller fasekonfiguration.
6. Angiv scanningsintervallet, eller behold standardværdien på 3 sekunder.
7. Send formularen, og bekræft, at enheden og entityerne er oprettet.

Integrationen opretter et forskelligt antal entiteter for enkeltfase-, dobbeltkanal- og trefasemålere. En kortere entity-liste betyder ikke, at en enfaset model har begrænset Home Assistant-support.

Trin 3: Kontrollér entityerne

Åbn IAMMETER-enheden under Indstillinger → Enheder og tjenester. Afhængigt af modellen kan tilgængelige entiteter omfatte:

• spænding;
• strøm;
• aktiv effekt;
• effektfaktor;
• importeret energi;
• eksporteret energi;
• reaktiv effekt eller reaktiv energi, når den udstilles af den relevante måler og det pågældende registersæt.

Entityerne for importeret og eksporteret energi bruger kWh og inkluderer de Home Assistant-energimetadata, der kræves af Energy Dashboard.

Trin 4: Vælg et passende scanningsinterval

Standard-scanningsintervallet er 3 sekunder. Det er et praktisk udgangspunkt for live-dashboards og effektbaserede automatiseringer.

Anbefalede udgangspunkter:

En indstilling på ét sekund er en polling-anmodning, ikke en garanti for, at hvert Home Assistant-dashboard synligt opdateres én gang i sekundet. Netværksforsinkelse, antallet af registre, recorder-belastning og frontend-opdateringsadfærd påvirker også resultatet.

Undgå unødvendigt aggressiv polling. For de fleste automatiseringer er en stabil opdatering på 2–5 sekunder mere nyttig end det kortest mulige interval.

Metode 2: Brug Home Assistants indbyggede Modbus-integration

Home Assistant indeholder en standard Modbus-integration. Denne metode er helt lokal og kræver ikke HACS, men forbindelsen og sensorerne defineres i YAML.

Følgende eksempel læser spænding og aktiv effekt fra en enfaset må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

Erstat 192.168.1.6 med målerens faktiske IP-adresse. Tjek det relevante registerkort, før du tilføjer flere sensorer:

• IAMMETER Modbus TCP registerkort
• Home Assistant Modbus-dokumentation

Almindelige IAMMETER Modbus-registre

Følgende adresser illustrerer de standard faseblokke, der bruges af almindelige IAMMETER-målere. Brug altid den aktuelle registerdokumentation som autoritativ reference.

Brug den dokumenterede skala, præcision og word order for hvert register. Udled ikke energiskalering ud fra spændingseksemplet.

Efter redigering af YAML:

1. kør Home Assistants konfigurationskontrol;
2. genstart Home Assistant;
3. åbn Udviklingsværktøjer → Tilstande;
4. bekræft, at de nye entiteter har plausible værdier og enheder.

Tilføj importeret og eksporteret energi til Energy Dashboard

Home Assistant Energy Dashboard har brug for kumulative energi-entiteter, ikke øjeblikkelig effekt.

For en manuelt konfigureret Modbus-energisensor skal du inkludere de relevante metadata:

unit_of_measurement: kWh
device_class: energy
state_class: total_increasing

Gå derefter til Indstillinger → Dashboards → Energi, og vælg entityet for importeret energi som netforbrug og entityet for eksporteret energi som tilbageføring til nettet.

Vælg ikke et aktiv-effekt-entity, der måles i watt, til et energifelt i Energy Dashboard. Effekt viser den aktuelle rate; importeret/eksporteret kWh registrerer kumulativ energi.

Understøttede IAMMETER-modeller

Alle nuværende IAMMETER-energimålere understøtter både HACS Modbus og Home Assistants indbyggede Modbus-integration.

WEM3046T og WEM3046TE måler 5 A-sekundæroutputtet fra en ekstern strømtransformator. For at få den faktiske primærsidestrøm, -effekt og -energi skal det korrekte CT-forhold anvendes. Dette er en egenskab ved 5 A CT-målesystemet, ikke en begrænsning i Home Assistant- eller Modbus-kompatibiliteten.

Kan Modbus og IAMMETER Cloud fungere samtidigt?

Ja. Home Assistant læser Modbus TCP lokalt, mens måleren kan fortsætte med at uploade til IAMMETER Cloud. Du behøver ikke at ændre måleren til MQTT-uploadtilstand for at bruge Modbus.

Dette giver dig to komplementære visninger:

• hurtige lokale data og automatiseringer i Home Assistant;
• langtidsrapporter, elprisanalyse, solanalyse og fjernadgang i IAMMETER Cloud.

Undgå flere højfrekvente Modbus-klienter

Brug én aktiv Modbus TCP-pollingklient pr. måler som den sikre udrulningsmodel. Konfigurér ikke Home Assistant, Node-RED, en PLC og en anden logger til uafhængigt at polle den samme måler med høj frekvens.

Hvis flere systemer har brug for de samme live-målinger, så lad ét system læse Modbus og videredistribuere dataene, eller brug en MQTT-arkitektur, hvor flere forbrugere abonnerer på en broker.

Fejlfinding

Home Assistant kan ikke oprette forbindelse til port 502

• Bekræft, at Home Assistant og måleren er på det samme tilgængelige netværk.
• Bekræft målerens IP-adresse, og reserver den i routeren.
• Kontrollér, at TCP-port 502 ikke er blokeret af en firewall- eller VLAN-regel.
• Sørg for, at en anden Modbus-klient ikke holder eller gentagne gange genåbner forbindelsen.

Entityerne er utilgængelige, eller værdierne ændrer sig ikke

• Bekræft den valgte måler-/fasetype i HACS-integrationen.
• Med YAML skal du kontrollere slave-ID'et, registeradressen, datatypen, skalaen og word order.
• Forøg scanningsintervallet midlertidigt for at udelukke for aggressiv polling.
• Genstart integrationen, efter du har ændret målerens IP-adresse.

Værdierne er usandsynligt høje eller lave

• Kontrollér registerskaleringen og datatypen.
• For WEM3046T/WEM3046TE skal du kontrollere det eksterne CT-forhold.
• Bekræft, at entityet svarer til den forventede fase eller målekanal.

Energi-entityerne vises ikke i Energy Dashboard

• Brug kumulativ importeret/eksporteret energi i kWh.
• Bekræft device_class: energy.
• Bekræft state_class: total_increasing.
• Brug ikke et effekt-entity i watt.

Byg automatiseringer med realtids-effektdata

Når Modbus-entityerne virker, kan Home Assistant bruge aktiv effekt eller neteksporteffekt til at styre andre enheder. Eksempler omfatter:

• styr et relæ ud fra realtids-Modbus-effektdata;
• oplad en elbil, når soleksporten overstiger en tærskel;
• opvarm vand med tilgængeligt solcelleoverskud;
• underret brugeren, når husholdningens forbrug overstiger en grænse;
• reducer en styrbar last, før der importeres dyr el til spidslasttakst.

Hold din integrationsvejledning fokuseret på først at etablere pålidelige data. Tilføj kun styrelogik, efter at du har kontrolleret fortegnskonventionen, enhederne, opdateringsintervallet og adfærden, når måleren bliver utilgængelig.

Relaterede Home Assistant-vejledninger

• Sammenlign alle IAMMETER–Home Assistant-integrationsmetoder
• Konfigurér en energimåler med en MQTT-server
• Home Assistant MQTT Discovery til en energimåler
• Home Assistant overvågning af solenergi
• Home Assistant og Grafana