Home Assistant Modbus TCP-energimätarintegrering

Home Assistant Modbus TCP-energimätarintegrering

Modbus TCP är ett av de snabbaste sätten att ansluta en energimätare till Home Assistant. Det fungerar över det lokala nätverket, är inte beroende av en internetanslutning och passar för övervakning av effekt i realtid, automatisering av solöverskott, laststyrning och Home Assistant Energy Dashboard.

Alla nuvarande IAMMETER-energimätare stödjer Modbus TCP. Du kan integrera dem med Home Assistant på två sätt:

1. IAMMETER HACS Modbus-integrering – UI-konfiguration, automatiskt skapade entities och ett konfigurerbart skanningsintervall.
2. Home Assistants inbyggda Modbus-integrering – YAML-konfiguration med direkt kontroll över register och sensorer.

Den här guiden förklarar skillnaderna och hjälper dig att konfigurera rätt metod.

HACS Modbus eller inbyggd Home Assistant-Modbus?

Båda metoderna läser samma lokala Modbus TCP-data från mätaren. Den stora skillnaden är hur entities konfigureras i Home Assistant.

För de flesta användare är HACS Modbus-integreringen det enklare alternativet. Använd Home Assistants inbyggda Modbus-integrering när du behöver en egen registerlista, egen namngivning av entities, skaleringsregel eller pollningsintervall för enskilda sensorer.

Om du inte behöver snabba uppdateringar kan du jämföra HTTP- och MQTT-alternativen i översikten av Home Assistant-energimätarintegreringar.

Innan du börjar

Du behöver:

• en IAMMETER-energimätare ansluten till samma LAN som Home Assistant;
• mätarens lokala IP-adress;
• TCP-port 502 tillgänglig mellan Home Assistant och mätaren;
• en nyare firmwareversion på mätaren;
• HACS installerat om du väljer IAMMETER HACS-integreringen.

Reservera gärna mätarens IP-adress i routern. En föränderlig DHCP-adress är en vanlig orsak till att en fungerande Modbus-integrering senare blir otillgänglig.

Metod 1: Konfigurera IAMMETER Modbus via HACS

IAMMETER HACS Modbus-integreringen är avsedd för användare som vill ha snabb lokal data utan att definiera varje register manuellt i YAML.

Steg 1: Installera integreringen

1. Öppna HACS i Home Assistant.
2. Sök efter IamMeter Modbus.
3. Installera den senaste versionen.
4. Starta om Home Assistant om du blir ombedd.

Projekt- och versionsinformation:

• IAMMETER HACS Modbus-repositoriet
• IAMMETER HACS Modbus-releaser

Använd den senaste tillgängliga versionen. Inställningen för skanningsintervall stöds av den uppdaterade integreringen och skickas vidare till DataUpdateCoordinator.

Steg 2: Lägg till mätaren i Home Assistant

1. Gå till Settings → Devices & services.
2. Välj Add integration.
3. Sök efter IamMeter Modbus.
4. Ange mätarens IP-adress och Modbus TCP-port.
5. Välj lämplig mätartyp eller faskonfiguration.
6. Ställ in skanningsintervallet, eller behåll standardvärdet 3 sekunder.
7. Skicka formuläret och bekräfta att enheten och entities har skapats.

Integreringen skapar olika många entities för enfas-, tvåkanaliga och trefasiga mätare. En kortare entitetslista betyder inte att en enfasmodell har begränsat Home Assistant-stöd.

Steg 3: Kontrollera entities

Öppna IAMMETER-enheten under Settings → Devices & services. Beroende på modell kan tillgängliga entities omfatta:

• spänning;
• ström;
• aktiv effekt;
• effektfaktor;
• importerad energi;
• exporterad energi;
• reaktiv effekt eller reaktiv energi om mätaren och registersatsen exponerar det.

Entities för importerad och exporterad energi använder kWh och inkluderar den Home Assistant-metadata för energi som Energy Dashboard kräver.

Steg 4: Välj ett lämpligt skanningsintervall

Standardskanningsintervallet är 3 sekunder. Det är en praktisk utgångspunkt för live-dashboards och automatiseringar baserade på effekt.

Rekommenderade utgångspunkter:

En inställning på en sekund är en pollningsförfrågan, inte en garanti för att varje Home Assistant-dashboard synbart uppdateras en gång per sekund. Nätverksfördröjning, antal register, recorder-belastning och frontend-uppdateringsbeteende påverkar också resultatet.

Undvik onödigt aggressiv polling. För de flesta automatiseringar är en stabil uppdatering på 2–5 sekunder mer användbar än det kortaste möjliga intervallet.

Metod 2: Använd Home Assistants inbyggda Modbus-integrering

Home Assistant innehåller en standard Modbus-integrering. Den här metoden är helt lokal och kräver inte HACS, men anslutningen och sensorerna definieras i YAML.

Följande exempel läser spänning och aktiv effekt från en enfasmätare:

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

Ersätt 192.168.1.6 med mätarens faktiska IP-adress. Kontrollera den aktuella registerkartan innan du lägger till fler sensorer:

• IAMMETER Modbus TCP-registerkarta
• Home Assistant Modbus-dokumentation

Vanliga IAMMETER Modbus-register

Följande adresser illustrerar standardfasblocken som används av vanliga IAMMETER-mätare. Använd alltid den aktuella registerdokumentationen som auktoritativ referens.

Använd dokumenterad skala, precision och ordordning för varje register. Härled inte energiskalning från spänningsexemplet.

Efter att du har redigerat YAML:

1. kör Home Assistants konfigurationskontroll;
2. starta om Home Assistant;
3. öppna Developer tools → States;
4. bekräfta att de nya entities har rimliga värden och enheter.

Lägg till importerad och exporterad energi i Energy Dashboard

Home Assistant Energy Dashboard behöver kumulativa energientities, inte momentan effekt.

För en manuellt konfigurerad Modbus-energisensor, inkludera lämplig metadata:

unit_of_measurement: kWh
device_class: energy
state_class: total_increasing

Gå sedan till Settings → Dashboards → Energy och välj entiteten för importerad energi som nätförbrukning (grid consumption) och entiteten för exporterad energi som återmatning till nätet (return to grid).

Välj inte en aktiv-effektentity mätt i watt för ett energifält i Energy Dashboard. Effekt visar den aktuella förbrukningstakten; importerad/exporterad kWh registrerar kumulativ energi.

Stödda IAMMETER-modeller

Alla nuvarande IAMMETER-energimätare stödjer både HACS Modbus och Home Assistants inbyggda Modbus-integrering.

WEM3046T och WEM3046TE mäter 5 A-sekundäruppgången från en extern strömtransformator. För att få den faktiska strömmen, effekten och energin på primärsidan måste rätt CT-förhållande tillämpas. Det är en egenskap hos 5 A CT-mätsystemet, inte en begränsning i Home Assistant- eller Modbus-kompatibiliteten.

Kan Modbus och IAMMETER Cloud fungera samtidigt?

Ja. Home Assistant läser Modbus TCP lokalt medan mätaren kan fortsätta ladda upp till IAMMETER Cloud. Du behöver inte ändra mätaren till MQTT-uppladdningsläge för att använda Modbus.

Det ger dig två kompletterande vyer:

• snabb lokal data och automatiseringar i Home Assistant;
• långsiktiga rapporter, elkostnadsanalys, solanalys och fjärråtkomst i IAMMETER Cloud.

Undvik flera Modbus-klienter med hög frekvens

Använd en aktiv Modbus TCP-pollningsklient per mätare som säker driftsmodell. Konfigurera inte Home Assistant, Node-RED, en PLC och ytterligare en logger att polla samma mätare oberoende av varandra med hög frekvens.

Om flera system behöver samma live-mätningar, låt ett system läsa Modbus och distribuera datan vidare, eller använd en MQTT-arkitektur där flera konsumenter prenumererar på en broker.

Felsökning

Home Assistant kan inte ansluta till port 502

• Bekräfta att Home Assistant och mätaren finns i samma nåbara nätverk.
• Verifiera mätarens IP-adress och reservera den i routern.
• Kontrollera att TCP-port 502 inte blockeras av en brandväggs- eller VLAN-regel.
• Se till att inte en annan Modbus-klient håller eller upprepade gånger öppnar anslutningen.

Entities är otillgängliga eller värdena ändras inte

• Bekräfta vald mätar- eller fastyp i HACS-integreringen.
• Med YAML: verifiera slave-ID, registeradress, datatyp, skala och ordordning.
• Öka skanningsintervallet tillfälligt för att utesluta alltför aggressiv polling.
• Starta om integreringen efter att mätarens IP-adress har ändrats.

Värdena är orimligt höga eller låga

• Kontrollera registrets skala och datatyp.
• För WEM3046T/WEM3046TE, verifiera det externa CT-förhållandet.
• Bekräfta att entiteten motsvarar rätt fas eller mätkanal.

Energi-entities visas inte i Energy Dashboard

• Använd kumulativ importerad/exporterad energi i kWh.
• Bekräfta device_class: energy.
• Bekräfta state_class: total_increasing.
• Använd inte en effektentity i watt.

Bygg automatiseringar med effektdata i realtid

När Modbus-entities fungerar kan Home Assistant använda aktiv effekt eller nätets exporteffekt för att styra andra enheter. Exempel:

• styra ett relä från Modbus-effektdata i realtid;
• ladda en EV när solexporten överstiger en tröskel;
• värma vatten med tillgängligt solöverskott;
• meddela användaren när hushållets förbrukning överstiger en gräns;
• minska en styrbar last innan dyr el på toppris importeras.

Håll integreringsguiden fokuserad på att först få tillförlitlig data. Lägg till styrlogik först efter att du har kontrollerat teckenkonvention, enheter, uppdateringsintervall och beteendet när mätaren blir otillgänglig.

Relaterade Home Assistant-guider

• Jämför alla IAMMETER–Home Assistant-integreringsmetoder
• Konfigurera en energimätare med en MQTT-server
• Home Assistant MQTT Discovery för en energimätare
• Solövervakning med Home Assistant
• Home Assistant och Grafana