MQTT-energimåler for Home Assistant: Manuelt YAML-oppsett

Konfigurer en MQTT-energimåler manuelt i Home Assistant

En MQTT-energimåler kan publisere spenning, strøm, aktiv effekt og importert/eksportert energi til en broker på det lokale nettverket. Home Assistant abonnerer på disse dataene og konverterer JSON-verdiene til sensorenheter som kan brukes i dashboards, automasjoner og Energy Dashboard.

Denne veiledningen forklarer Manuell MQTT-metoden for IAMMETER-energimålere:

1. konfigurer MQTT-brokeren i målerens WebUI;
2. koble Home Assistant til samme broker;
3. definer de nødvendige MQTT-sensorene i YAML;
4. legg til importert og eksportert energi i Energy Dashboard.

Manuell MQTT gir deg full kontroll over enhetsnavn, emner, maler og metadata. Hvis du foretrekker at Home Assistant oppretter enheten og entitetene automatisk, kan du bruke MQTT Discovery i stedet.

Manuell MQTT og MQTT Discovery er forskjellige metoder

Begge metodene bruker en MQTT-broker, men oppsettet i Home Assistant er forskjellig.

For denne veiledningen: la HA MQTT Discovery være deaktivert i målerens WebUI. Den bryteren er bare nødvendig når du ønsker automatisk oppdagelse i Home Assistant.

Hva du trenger

• en IAMMETER-energimåler med aktuell fastvare;
• en MQTT-broker som både måleren og Home Assistant kan nå;
• brokerens adresse, port, brukernavn og passord;
• målerens serienummer;
• tilgang til Home Assistants YAML-konfigurasjon.

Brokeren kan kjøre på samme maskin som Home Assistant, i Mosquitto-broker-tillegget, på en annen LAN-server eller på en ekstern vert. Bruk en lokal broker når du vil at hele datastien skal forbli innenfor LAN-et.

Alle nåværende IAMMETER-målere støtter Manuell MQTT. Enfasede, to-kanals og trefasede modeller publiserer forskjellige JSON-array-strukturer, så verdimalene må samsvare med den faktiske datapakken.

Trinn 1: Konfigurer MQTT-brokeren i målerens WebUI

Åpne målerens lokale WebUI og gå til Innstillinger. Konfigurer:

Lagre innstillingene og la måleren koble seg på nytt.

Den nåværende fastvarens WebUI støtter disse broker-innstillingene direkte. Du trenger ikke å konfigurere brukernavn og passord gjennom den gamle lokale API-prosedyren.

For fullstendig konfigurasjon på målersiden og instruksjoner for eldre fastvare, se publiser IAMMETER-data til en MQTT-broker.

MQTT-modus og IAMMETER Cloud

Når målerens Run Mode endres til MQTT, publiserer den målingene til brokeren din i stedet for å laste dem opp til IAMMETER Cloud. Manuell MQTT og IAMMETER Cloud kan derfor ikke kjøre samtidig fra samme måler.

Hvis du trenger både Home Assistant og IAMMETER Cloud samtidig, bruk en lokal HTTP- eller Modbus TCP-integrasjon i stedet. Sammenlign de tilgjengelige metodene i integrasjonsveiledningen for Home Assistant-energimålere.

Trinn 2: Verifiser MQTT-emnet og datapakken

IAMMETER publiserer sanntidsmålinger til:

device/{SN}/realtime

Erstatt {SN} med målerens serienummer. For eksempel:

device/80123456/realtime

Før du konfigurerer Home Assistant-sensorer, abonner på emnet med en MQTT-klient og bekreft at meldingene kommer frem. Dette hindrer at YAML-feilsøking blandes sammen med problemer med broker, legitimasjon, brannmur eller emne.

Enfaset JSON

En enfaset måler bruker en Data-array. De fem første verdiene er:

Eksempel:

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

Flerkanals- og trefaset JSON

Flerkanals- og trefasede målere bruker en Datas-array. Hver nestet array representerer en fase eller målekanal:

Datas[0] → fase/kanal A
Datas[1] → fase/kanal B
Datas[2] → fase/kanal C, når tilstede

Innenfor hver fase-/kanal-array er de vanlige plasseringene:

Undersøk alltid den faktiske MQTT-meldingen fra modellen og fastvaren din før du kopierer maler. Se komplett IAMMETER JSON-datadefinisjon.

Trinn 3: Koble Home Assistant til brokeren

I Home Assistant:

1. Gå til Innstillinger → Enheter og tjenester.
2. Velg Legg til integrasjon.
3. Søk etter MQTT.
4. Angi samme broker-adresse, port, brukernavn og passord som måleren bruker.
5. Bekreft at MQTT-integrasjonen kobler til.

Hvis Home Assistant allerede bruker denne brokeren, ikke legg til en duplisert MQTT-integrasjon. De manuelt definerte sensorene vil bruke den eksisterende broker-tilkoblingen.

Trinn 4: Legg til Manuell MQTT-sensorer i YAML

Eksemplene nedenfor bruker Home Assistants nåværende mqtt: sensor:-konfigurasjonsstruktur. Erstatt serienummeret i hver state_topic.

Enfaset energimåler-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 lar Home Assistant håndtere entitetsinnstillingene i brukergrensesnittet. Hold hver ID unik og stabil. Ikke endre den bare for å gi den viste entiteten et nytt navn.

Trefaset energimåler-YAML

Eksemplet nedenfor oppretter fase-A-entitetene. Dupliser blokken for fase B og C, endre Datas[0] til Datas[1] og Datas[2], og bruk forskjellige navn og unike ID-er.

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

For WEM2067 og andre flerkanalsmodeller: opprett bare det antallet kanalblokker som faktisk finnes i Datas-datapakken.

Unngå to mqtt:-blokker på øverste nivå

Hvis configuration.yaml allerede inneholder en mqtt:-seksjon, legg sensorene under den eksisterende seksjonen. YAML kan ikke trygt inneholde to uavhengige nøkler på øverste nivå med samme navn.

For en stor konfigurasjon kan du holde MQTT-sensorene i en inkludert fil, men følg Home Assistants inkluderingsstruktur og innrykksregler.

Trinn 5: Sjekk konfigurasjonen og last inn sensorene

Etter at du har lagret YAML-en:

1. kjør Home Assistants konfigurasjonssjekk;
2. rett opp eventuelle YAML-, innrykks- eller malfeil;
3. start Home Assistant på nytt om nødvendig;
4. åpne Utviklerverktøy → Tilstander;
5. bekreft at hver MQTT-entitet har en sannsynlig verdi, enhet, enhetsklasse og tilstandsklasse.

Entitetsverdien bør endres etter at en ny melding ankommer på device/{SN}/realtime.

Trinn 6: Legg til importert og eksportert energi i Energy Dashboard

Home Assistants Energy Dashboard krever kumulative energientiteter. YAML-eksemplene bruker:

unit_of_measurement: "kWh"
device_class: energy
state_class: total_increasing

Gå til Innstillinger → Dashboards → Energi og velg:

• IAMMETER Imported Energy for forbruk fra strømnettet;
• IAMMETER Exported Energy for tilbakelevering til strømnettet.

For en trefaset måler bør du velge entitetsstrukturen som passer installasjonen og utformingen av Home Assistant-dashboardet. Du kan vise faseenergien enkeltvis eller opprette en passende totalentitet, men ikke legg sammen verdier uten å bekrefte hvordan måleren rapporterer fase- og nettoenergi for den valgte koblingsmodusen.

Ikke velg aktiv-effekt-entiteten som måles i watt i et energifelt i Energy Dashboard. Effekt er en øyeblikkelig rate; dashboardet krever kumulativ kWh.

Velg et MQTT-publiseringsintervall

Nåværende IAMMETER-fastvare støtter et MQTT-publiseringsintervall ned til 2 sekunder. Det korteste intervallet er ikke alltid den beste innstillingen.

Foreslåtte utgangspunkter:

Vurder broker-kapasitet, Home Assistants recorder-vekst, nettverkets pålitelighet og antallet entiteter. En melding med mange faseverdier kan oppdatere flere Home Assistant-sensorer samtidig.

Støttede IAMMETER-modeller

Alle nåværende IAMMETER-energimålere støtter Manuell MQTT. Den viktigste forskjellen for Home Assistant er datapakkestrukturen og antallet målekanaler.

WEM3046T og WEM3046TE måler 5 A-sekundæruttaket fra eksterne strømtransformatorer (CT). Bruk riktig CT-forhold for å få verdier på primærsiden. Dette er en egenskap ved målesystemet, ikke en begrensning i MQTT eller Home Assistant.

Feilsøking

Ingen MQTT-meldinger kommer frem

• Kontroller broker-adressen og porten i målerens WebUI.
• Bekreft brukernavnet og passordet.
• Sjekk broker-loggene for autentiserings- eller tilkoblingsfeil.
• Bekreft at måleren kan nå brokeren gjennom eventuelle brannmur- eller VLAN-regler.
• Abonner på device/{SN}/realtime med en uavhengig MQTT-klient.

Meldinger kommer frem, men entitetene i Home Assistant er utilgjengelige

• Bekreft at Home Assistant er koblet til samme broker.
• Sjekk det eksakte emnet og serienummeret.
• Sammenlign Data mot Datas med den faktiske datapakken.
• Valider YAML-innrykk og maler.
• Sjekk Home Assistant-loggene etter omlasting eller omstart.

Noen entiteter viser null eller feil måling

• Ikke kopier en enfaset Data-mal for en Datas-datapakke.
• Kontroller array-plasseringen mot JSON-definisjonen.
• Bekreft fase-/kanalindeksen.
• For WEM3046T/WEM3046TE: bekreft det eksterne CT-forholdet.

Energientiteter mangler i Energy Dashboard

Bekreft alle tre feltene:

unit_of_measurement: "kWh"
device_class: energy
state_class: total_increasing

Bekreft også at entiteten har mottatt gyldige numeriske data og vises i Utviklerverktøy → Tilstander.

Dupliserte enheter eller sensorer vises

Manuell MQTT og MQTT Discovery kan opprette separate entiteter fra samme måler. Hvis du bruker YAML-metoden, hold HA MQTT Discovery deaktivert med mindre du bevisst ønsker begge settene og har planlagt unike entitetsnavn.

Relaterte veiledninger

• Publiser IAMMETER-data til din MQTT-broker
• Bruk MQTT Discovery i stedet for YAML
• Sammenlign alle IAMMETER–Home Assistant-integrasjonsmetoder
• IAMMETER JSON-datadefinisjon
• Oppgrader IAMMETER-fastvaren

Oppdatert: 19. juli 2026.