Home Assistant Modbus TCP Energiemeter Setup Handleiding

Home Assistant Modbus TCP Energiemeter Integratie

Modbus TCP is een van de snelste manieren om een energiemeter te verbinden met Home Assistant. Het werkt via het lokale netwerk, is niet afhankelijk van een internetverbinding en is geschikt voor real-time vermogensmonitoring, automatisering op basis van zonne-energieoverschot, lastregeling en het Home Assistant Energy Dashboard.

Alle huidige IAMMETER energiemeters ondersteunen Modbus TCP. U kunt ze op twee manieren integreren met Home Assistant:

1. IAMMETER HACS Modbus-integratie — UI-configuratie, automatisch aangemaakte entiteiten en een instelbaar scan-interval.
2. Home Assistant ingebouwde Modbus-integratie — YAML-configuratie met directe controle over registers en sensoren.

Deze handleiding legt de verschillen uit en helpt u de juiste methode te kiezen.

HACS Modbus of ingebouwde Home Assistant Modbus?

Beide methoden lezen dezelfde lokale Modbus TCP-gegevens van de meter. Het belangrijkste verschil is hoe de Home Assistant-entiteiten worden geconfigureerd.

Voor de meeste gebruikers is de HACS Modbus-integratie de eenvoudigere optie. Gebruik de ingebouwde Modbus-integratie van Home Assistant wanneer u een aangepaste registerlijst, naamgevingsschema voor entiteiten, schalingsregel of polling-interval voor individuele sensoren nodig heeft.

Als u geen snelle updates nodig heeft, vergelijk dan de HTTP- en MQTT-alternatieven in het Home Assistant energiemeter integratieoverzicht.

Voordat u begint

U heeft nodig:

• een IAMMETER energiemeter die is verbonden met hetzelfde LAN als Home Assistant;
• het lokale IP-adres van de meter;
• TCP-poort 502 die bereikbaar is tussen Home Assistant en de meter;
• een recente firmwareversie van de meter;
• HACS geïnstalleerd als u kiest voor de IAMMETER HACS-integratie.

Het is een goed idee om het IP-adres van de meter te reserveren in uw router. Een veranderend DHCP-adres is een veelvoorkomende reden waarom een werkende Modbus-integratie later onbereikbaar wordt.

Methode 1: IAMMETER Modbus configureren via HACS

De IAMMETER HACS Modbus-integratie is ontworpen voor gebruikers die snel lokale gegevens willen zonder elk register handmatig in YAML te definiëren.

Stap 1: Installeer de integratie

1. Open HACS in Home Assistant.
2. Zoek naar IamMeter Modbus.
3. Installeer de laatste release.
4. Herstart Home Assistant indien gevraagd.

Project- en release-informatie:

• IAMMETER HACS Modbus repository
• IAMMETER HACS Modbus releases

Gebruik de nieuwste beschikbare release. De scan-interval instelling wordt ondersteund door de bijgewerkte integratie en wordt doorgegeven aan de DataUpdateCoordinator.

Stap 2: Voeg de meter toe in Home Assistant

1. Ga naar Instellingen → Apparaten en services.
2. Selecteer Integratie toevoegen.
3. Zoek naar IamMeter Modbus.
4. Voer het IP-adres van de meter en de Modbus TCP-poort in.
5. Selecteer het juiste metertype of faseconfiguratie.
6. Stel het scan-interval in, of behoud de standaardwaarde van 3 seconden.
7. Dien het formulier in en bevestig dat het apparaat en de entiteiten zijn aangemaakt.

De integratie maakt een verschillend aantal entiteiten aan voor eenfasige, tweekanaals en driefasige meters. Een kortere entiteitenlijst betekent niet dat een eenfasig model beperkte Home Assistant-ondersteuning heeft.

Stap 3: Controleer de entiteiten

Open het IAMMETER-apparaat onder Instellingen → Apparaten en services. Afhankelijk van het model kunnen beschikbare entiteiten het volgende omvatten:

• spanning;
• stroom;
• actief vermogen;
• arbeidsfactor;
• geïmporteerde energie;
• geëxporteerde energie;
• reactief vermogen of reactieve energie indien beschikbaar gesteld door de betreffende meter en registerset.

Geïmporteerde en geëxporteerde energie-entiteiten gebruiken kWh en bevatten de Home Assistant-energiemetadata die vereist is voor het Energy Dashboard.

Stap 4: Kies een geschikt scan-interval

Het standaard scan-interval is 3 seconden. Dit is een praktisch startpunt voor live dashboards en vermogensgebaseerde automatiseringen.

Aanbevolen startpunten:

Een instelling van één seconde is een poll-verzoek, geen garantie dat elk Home Assistant-dashboard zichtbaar één keer per seconde ververst. Netwerklatentie, het aantal registers, recorder-belasting en het vernieuwingsgedrag van de frontend beïnvloeden ook het resultaat.

Vermijd onnodig agressief pollen. Voor de meeste automatiseringen is een stabiele update van 2–5 seconden nuttiger dan het kortst mogelijke interval.

Methode 2: Gebruik de ingebouwde Modbus-integratie van Home Assistant

Home Assistant bevat een standaard Modbus-integratie. Deze methode is volledig lokaal en vereist geen HACS, maar de verbinding en sensoren worden in YAML gedefinieerd.

Het volgende voorbeeld leest spanning en actief vermogen van een eenfasige meter:

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

Vervang 192.168.1.6 door het werkelijke IP-adres van de meter. Raadpleeg de toepasselijke registerkaart voordat u meer sensoren toevoegt:

• IAMMETER Modbus TCP registerkaart
• Home Assistant Modbus documentatie

Veelgebruikte IAMMETER Modbus-registers

De volgende adressen illustreren de standaard faseblokken die worden gebruikt door gangbare IAMMETER-meters. Gebruik altijd de actuele registerdocumentatie als gezaghebbende referentie.

Gebruik de gedocumenteerde schaal, precisie en woordvolgorde voor elk register. Leid de energieschaling niet af van het spanningsvoorbeeld.

Na het bewerken van YAML:

1. voer de configuratiecontrole van Home Assistant uit;
2. herstart Home Assistant;
3. open Ontwikkeltools → Statussen;
4. bevestig dat de nieuwe entiteiten plausibele waarden en eenheden hebben.

Voeg geïmporteerde en geëxporteerde energie toe aan het Energy Dashboard

Het Home Assistant Energy Dashboard heeft cumulatieve energie-entiteiten nodig, geen momentaan vermogen.

Neem voor een handmatig geconfigureerde Modbus-energiesensor de juiste metadata op:

unit_of_measurement: kWh
device_class: energy
state_class: total_increasing

Ga vervolgens naar Instellingen → Dashboards → Energie en selecteer de geïmporteerde energie-entiteit als netverbruik en de geëxporteerde energie-entiteit als teruglevering aan het net.

Selecteer geen actief-vermogen-entiteit gemeten in watt voor een Energy Dashboard-energieveld. Vermogen toont het huidige tarief; geïmporteerde/geëxporteerde kWh registreert cumulatieve energie.

Ondersteunde IAMMETER-modellen

Alle huidige IAMMETER energiemeters ondersteunen zowel HACS Modbus als de ingebouwde Modbus-integratie van Home Assistant.

WEM3046T en WEM3046TE meten de 5 A secundaire uitgang van een externe stroomtransformator. Om de werkelijke primaire stroom, het vermogen en de energie te verkrijgen, moet de juiste CT-verhouding worden toegepast. Dit is een eigenschap van het 5 A CT-meetsysteem, geen beperking van de Home Assistant- of Modbus-compatibiliteit.

Kunnen Modbus en IAMMETER Cloud tegelijkertijd werken?

Ja. Home Assistant leest Modbus TCP lokaal terwijl de meter kan blijven uploaden naar IAMMETER Cloud. U hoeft de meter niet in MQTT-uploadmodus te zetten om Modbus te gebruiken.

Dit geeft u twee complementaire weergaven:

• snelle lokale gegevens en automatiseringen in Home Assistant;
• langetermijnrapporten, elektriciteitskostenanalyse, zonne-energieanalyse en externe toegang in IAMMETER Cloud.

Vermijd meerdere hoogfrequente Modbus-clients

Gebruik één actieve Modbus TCP-polling-client per meter als het veilige implementatiemodel. Configureer niet tegelijkertijd Home Assistant, Node-RED, een PLC en een andere logger om dezelfde meter onafhankelijk op hoge frequentie te pollen.

Als meerdere systemen dezelfde live metingen nodig hebben, laat dan één systeem Modbus lezen en distribueer de gegevens, of gebruik een MQTT-architectuur waarbij meerdere consumenten zich abonneren op een broker.

Problemen oplossen

Home Assistant kan geen verbinding maken met poort 502

• Bevestig dat Home Assistant en de meter zich in hetzelfde bereikbare netwerk bevinden.
• Controleer het IP-adres van de meter en reserveer het in de router.
• Controleer of TCP-poort 502 niet wordt geblokkeerd door een firewall of VLAN-regel.
• Zorg ervoor dat een andere Modbus-client de verbinding niet vasthoudt of herhaaldelijk heropent.

Entiteiten zijn niet beschikbaar of waarden veranderen niet

• Bevestig het geselecteerde meter-/fasetype in de HACS-integratie.
• Controleer bij YAML het slave-ID, registeradres, gegevenstype, schaal en woordvolgorde.
• Verhoog het scan-interval tijdelijk om overmatig agressief pollen uit te sluiten.
• Herstart de integratie na het wijzigen van het IP-adres van de meter.

Waarden zijn onwaarschijnlijk hoog of laag

• Controleer de registerschaal en het gegevenstype.
• Controleer voor WEM3046T/WEM3046TE de externe CT-verhouding.
• Bevestig dat de entiteit overeenkomt met de verwachte fase of het meetkanaal.

Energie-entiteiten verschijnen niet in het Energy Dashboard

• Gebruik cumulatieve geïmporteerde/geëxporteerde energie in kWh.
• Bevestig device_class: energy.
• Bevestig state_class: total_increasing.
• Gebruik geen vermogensentiteit in watt.

Bouw automatiseringen met real-time vermogensgegevens

Zodra de Modbus-entiteiten werken, kan Home Assistant actief vermogen of netexportvermogen gebruiken om andere apparaten aan te sturen. Voorbeelden zijn onder meer:

• een relais aansturen op basis van real-time Modbus-vermogensgegevens;
• een EV opladen wanneer de zonne-export een drempel overschrijdt;
• water verwarmen met beschikbaar zonne-energieoverschot;
• de gebruiker waarschuwen wanneer het huishoudelijk verbruik een limiet overschrijdt;
• een regelbare last verminderen voordat dure piektarief-elektriciteit wordt geïmporteerd.

Houd de integratiehandleiding gericht op het eerst tot stand brengen van betrouwbare gegevens. Voeg pas regelingslogica toe na controle van de tekenconventie, eenheden, update-interval en gedrag wanneer de meter onbereikbaar wordt.

Gerelateerde Home Assistant-handleidingen

• Vergelijk elke IAMMETER–Home Assistant-integratiemethode
• Configureer een energiemeter met een MQTT-server
• Home Assistant MQTT Discovery voor een energiemeter
• Home Assistant zonne-energiemonitoring
• Home Assistant en Grafana