MQTT-energiemeter voor Home Assistant: Handmatige YAML-configuratie

Handmatig een MQTT-energiemeter configureren in Home Assistant

Een MQTT-energiemeter kan spanning, stroom, actief vermogen en geïmporteerde/geëxporteerde energie publiceren naar een broker op uw lokale netwerk. Home Assistant abonneert zich op die gegevens en zet de JSON-waarden om in sensor-entiteiten die kunnen worden gebruikt in dashboards, automatiseringen en het Energy Dashboard.

Deze handleiding legt de Handmatige MQTT-methode uit voor IAMMETER-energiemeters:

1. configureer de MQTT-broker in de WebUI van de meter;
2. verbind Home Assistant met dezelfde broker;
3. definieer de vereiste MQTT-sensoren in YAML;
4. voeg geïmporteerde en geëxporteerde energie toe aan het Energy Dashboard.

Handmatige MQTT geeft u volledige controle over entiteitsnamen, onderwerpen, templates en metadata. Als u wilt dat Home Assistant het apparaat en de entiteiten automatisch aanmaakt, gebruik dan MQTT Discovery in plaats daarvan.

Handmatige MQTT en MQTT Discovery zijn verschillende methoden

Beide methoden gebruiken een MQTT-broker, maar de Home Assistant-configuratie is anders.

Voor deze handleiding laat u HA MQTT Discovery uitgeschakeld in de WebUI van de meter. Die schakelaar is alleen nodig wanneer u Home Assistant automatische discovery wilt gebruiken.

Wat u nodig heeft

• een IAMMETER-energiemeter met de huidige firmware;
• een MQTT-broker die bereikbaar is voor zowel de meter als Home Assistant;
• het brokeradres, de poort, gebruikersnaam en wachtwoord;
• het serienummer van de meter;
• toegang tot de Home Assistant YAML-configuratie.

De broker kan draaien op dezelfde machine als Home Assistant, in de Mosquitto broker add-on, op een andere LAN-server of op een externe host. Gebruik een lokale broker wanneer u wilt dat het volledige datapad binnen het LAN blijft.

Alle huidige IAMMETER-meters ondersteunen Handmatige MQTT. Enkelfasige, dubbelkanaals en driefasige modellen publiceren verschillende JSON-arraystructuren, dus de waardetemplates moeten overeenkomen met de daadwerkelijke payload.

Stap 1: Configureer de MQTT-broker in de WebUI van de meter

Open de lokale WebUI van de meter en ga naar Instellingen. Configureer:

Sla de instellingen op en laat de meter opnieuw verbinding maken.

De huidige firmware-WebUI ondersteunt deze brokerinstellingen direct. U hoeft de gebruikersnaam en het wachtwoord niet te configureren via de historische lokale API-procedure.

Voor volledige meter-zijde configuratie en instructies voor oudere firmware, zie publiceer IAMMETER-gegevens naar een MQTT-broker.

MQTT-modus en IAMMETER Cloud

Wanneer de Run Mode van de meter wordt gewijzigd naar MQTT, publiceert deze metingen naar uw broker in plaats van ze te uploaden naar IAMMETER Cloud. Handmatige MQTT en IAMMETER Cloud werken daarom niet gelijktijdig vanaf dezelfde meter.

Als u Home Assistant en IAMMETER Cloud tegelijkertijd nodig heeft, gebruik dan een lokale HTTP- of Modbus TCP-integratie. Vergelijk de beschikbare methoden in de Home Assistant-energiemeterintegratiehandleiding.

Stap 2: Verifieer het MQTT-onderwerp en de payload

IAMMETER publiceert real-time metingen naar:

device/{SN}/realtime

Vervang {SN} door het serienummer van de meter. Bijvoorbeeld:

device/80123456/realtime

Voordat u Home Assistant-sensoren configureert, abonneer u op het onderwerp met een MQTT-client en bevestig dat berichten aankomen. Dit voorkomt dat YAML-problemen worden vermengd met broker-, inlog-, firewall- of onderwerpproblemen.

Enkelfasige JSON

Een enkelfasige meter gebruikt een Data-array. De eerste vijf waarden zijn:

Voorbeeld:

{
  "method": "uploadsn",
  "SN": "12345678",
  "Data": [228.91, 1.61, 225, 15066.47, 0]
}

Meerkanalen- en driefasige JSON

Meerkanalen- en driefasige meters gebruiken een Datas-array. Elke geneste array vertegenwoordigt een fase of meetkanaal:

Datas[0] → fase/kanaal A
Datas[1] → fase/kanaal B
Datas[2] → fase/kanaal C, indien aanwezig

Binnen elke fase-/kanaalarray zijn de gebruikelijke posities:

Inspecteer altijd het daadwerkelijke MQTT-bericht van uw model en firmware voordat u templates kopieert. Zie de volledige IAMMETER JSON-gegevensdefinitie.

Stap 3: Verbind Home Assistant met de broker

In Home Assistant:

1. Ga naar Instellingen → Apparaten & services.
2. Selecteer Integratie toevoegen.
3. Zoek naar MQTT.
4. Voer hetzelfde brokeradres, dezelfde poort, gebruikersnaam en wachtwoord in als gebruikt door de meter.
5. Bevestig dat de MQTT-integratie succesvol verbinding maakt.

Als Home Assistant deze broker al gebruikt, voeg dan geen dubbele MQTT-integratie toe. De handmatig gedefinieerde sensoren gebruiken de bestaande brokerverbinding.

Stap 4: Voeg Handmatige MQTT-sensoren toe in YAML

De onderstaande voorbeelden gebruiken de huidige mqtt: sensor:-configuratiestructuur van Home Assistant. Vervang het serienummer in elke state_topic.

Enkelfasige energiemeter YAML

mqtt:
  sensor:
    - name: "IAMMETER Voltage"
      unique_id: "iammeter_12345678_voltage"
      state_topic: "device/12345678/realtime"
      value_template: "{{ value_json.Data[0] | float(0) }}"
      unit_of_measurement: "V"
      device_class: voltage
      state_class: measurement

    - name: "IAMMETER Current"
      unique_id: "iammeter_12345678_current"
      state_topic: "device/12345678/realtime"
      value_template: "{{ value_json.Data[1] | float(0) }}"
      unit_of_measurement: "A"
      device_class: current
      state_class: measurement

    - name: "IAMMETER Active Power"
      unique_id: "iammeter_12345678_active_power"
      state_topic: "device/12345678/realtime"
      value_template: "{{ value_json.Data[2] | float(0) }}"
      unit_of_measurement: "W"
      device_class: power
      state_class: measurement

    - name: "IAMMETER Imported Energy"
      unique_id: "iammeter_12345678_import_energy"
      state_topic: "device/12345678/realtime"
      value_template: "{{ value_json.Data[3] | float(0) }}"
      unit_of_measurement: "kWh"
      device_class: energy
      state_class: total_increasing

    - name: "IAMMETER Exported Energy"
      unique_id: "iammeter_12345678_export_energy"
      state_topic: "device/12345678/realtime"
      value_template: "{{ value_json.Data[4] | float(0) }}"
      unit_of_measurement: "kWh"
      device_class: energy
      state_class: total_increasing

unique_id laat Home Assistant entiteitsinstellingen beheren via de UI. Houd elke ID uniek en stabiel. Verander het niet alleen om de weergegeven entiteit te hernoemen.

Driefasige energiemeter YAML

Het volgende voorbeeld maakt de fase-A-entiteiten aan. Dupliceer het blok voor fasen B en C, verander Datas[0] naar Datas[1] en Datas[2], en gebruik aparte namen en unieke ID's.

mqtt:
  sensor:
    - name: "IAMMETER Voltage A"
      unique_id: "iammeter_80123456_voltage_a"
      state_topic: "device/80123456/realtime"
      value_template: "{{ value_json.Datas[0][0] | float(0) }}"
      unit_of_measurement: "V"
      device_class: voltage
      state_class: measurement

    - name: "IAMMETER Current A"
      unique_id: "iammeter_80123456_current_a"
      state_topic: "device/80123456/realtime"
      value_template: "{{ value_json.Datas[0][1] | float(0) }}"
      unit_of_measurement: "A"
      device_class: current
      state_class: measurement

    - name: "IAMMETER Active Power A"
      unique_id: "iammeter_80123456_active_power_a"
      state_topic: "device/80123456/realtime"
      value_template: "{{ value_json.Datas[0][2] | float(0) }}"
      unit_of_measurement: "W"
      device_class: power
      state_class: measurement

    - name: "IAMMETER Imported Energy A"
      unique_id: "iammeter_80123456_import_energy_a"
      state_topic: "device/80123456/realtime"
      value_template: "{{ value_json.Datas[0][3] | float(0) }}"
      unit_of_measurement: "kWh"
      device_class: energy
      state_class: total_increasing

    - name: "IAMMETER Exported Energy A"
      unique_id: "iammeter_80123456_export_energy_a"
      state_topic: "device/80123456/realtime"
      value_template: "{{ value_json.Datas[0][4] | float(0) }}"
      unit_of_measurement: "kWh"
      device_class: energy
      state_class: total_increasing

Voor WEM2067 en andere meerkanalenmodellen, maak alleen het aantal kanaalblokken aan dat aanwezig is in de daadwerkelijke Datas-payload.

Vermijd twee mqtt:-blokken op het hoogste niveau

Als configuration.yaml al een mqtt:-sectie bevat, voeg dan de sensoren toe onder de bestaande sectie. YAML kan niet veilig twee onafhankelijke sleutels op het hoogste niveau met dezelfde naam bevatten.

Voor een grote configuratie kunt u MQTT-sensoren in een bijgevoegd bestand bewaren, maar volg de include-structuur en inspringregels van Home Assistant.

Stap 5: Controleer de configuratie en laad de sensoren

Na het opslaan van de YAML:

1. voer de Home Assistant-configuratiecontrole uit;
2. corrigeer eventuele YAML-, inspring- of templatefouten;
3. herstart Home Assistant indien nodig;
4. open Ontwikkelaarsinstrumenten → Statussen;
5. bevestig dat elke MQTT-entiteit een aannemelijke waarde, eenheid, apparaatklasse en statusklasse heeft.

De entiteitswaarde moet veranderen nadat een nieuw bericht aankomt op device/{SN}/realtime.

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

Het Energy Dashboard van Home Assistant vereist cumulatieve energie-entiteiten. De YAML-voorbeelden gebruiken:

unit_of_measurement: "kWh"
device_class: energy
state_class: total_increasing

Ga naar Instellingen → Dashboards → Energie en selecteer:

• IAMMETER Imported Energy voor netverbruik;
• IAMMETER Exported Energy voor teruglevering aan het net.

Voor een driefasige meter kiest u de entiteitsstructuur die past bij de installatie en het Home Assistant-dashboardontwerp. U kunt fase-energie afzonderlijk weergeven of een geschikte totale entiteit aanmaken, maar tel geen waarden bij elkaar op zonder te bevestigen hoe de meter fase- en netto-energie rapporteert voor de geselecteerde bedradingsmodus.

Selecteer niet de actief-vermogen-entiteit gemeten in watt in een Energy Dashboard-energieveld. Vermogen is een momentane snelheid; het dashboard vereist cumulatieve kWh.

Kies een MQTT-publicatie-interval

Huidige IAMMETER-firmware ondersteunt een MQTT-publicatie-interval tot 2 seconden. Het kortste interval is niet altijd de beste instelling.

Voorgestelde startpunten:

Houd rekening met broker-capaciteit, groei van de Home Assistant-recorder, netwerkbetrouwbaarheid en het aantal entiteiten. Een bericht met veel fasewaarden kan meerdere Home Assistant-sensoren tegelijk bijwerken.

Ondersteunde IAMMETER-modellen

Alle huidige IAMMETER-energiemeters ondersteunen Handmatige MQTT. Hun belangrijkste verschil voor Home Assistant is de payload-structuur en het aantal meetkanalen.

WEM3046T en WEM3046TE meten de 5 A secundaire uitgang van externe stroomtransformatoren. Pas de juiste CT-verhouding toe om primaire zijdewaarden te verkrijgen. Dit is een kenmerk van het meetsysteem, geen MQTT- of Home Assistant-beperking.

Probleemoplossing

Er komen geen MQTT-berichten aan

• Controleer het brokeradres en de poort in de WebUI van de meter.
• Bevestig de gebruikersnaam en het wachtwoord.
• Controleer brokerlogboeken op authenticatie- of verbindingsfouten.
• Bevestig dat de meter de broker kan bereiken via eventuele firewall- of VLAN-regels.
• Abonneer u op device/{SN}/realtime met een onafhankelijke MQTT-client.

Berichten komen aan, maar Home Assistant-entiteiten zijn niet beschikbaar

• Bevestig dat Home Assistant verbonden is met dezelfde broker.
• Controleer het exacte onderwerp en serienummer.
• Vergelijk Data versus Datas met de daadwerkelijke payload.
• Valideer YAML-inspringing en templates.
• Controleer Home Assistant-logboeken na het herladen of herstarten.

Sommige entiteiten tonen nul of de verkeerde meting

• Kopieer geen enkelfasig Data-template voor een Datas-payload.
• Verifieer de array-positie tegen de JSON-definitie.
• Bevestig de fase-/kanaalindex.
• Voor WEM3046T/WEM3046TE, bevestig de externe CT-verhouding.

Energie-entiteiten ontbreken in het Energy Dashboard

Bevestig alle drie de velden:

unit_of_measurement: "kWh"
device_class: energy
state_class: total_increasing

Bevestig ook dat de entiteit geldige numerieke gegevens heeft ontvangen en verschijnt in Ontwikkelaarsinstrumenten → Statussen.

Dubbele apparaten of sensoren verschijnen

Handmatige MQTT en MQTT Discovery kunnen afzonderlijke entiteiten van dezelfde meter aanmaken. Als u de YAML-methode gebruikt, houd dan HA MQTT Discovery uitgeschakeld, tenzij u bewust beide sets wilt en unieke entiteitsnamen heeft gepland.

Gerelateerde handleidingen

• Publiceer IAMMETER-gegevens naar uw MQTT-broker
• Gebruik MQTT Discovery in plaats van YAML
• Vergelijk alle IAMMETER–Home Assistant-integratiemethoden
• IAMMETER JSON-gegevensdefinitie
• Upgrade IAMMETER-firmware

Bijgewerkt: 19 juli 2026.