Home Assistant MQTT Discovery for en energimåler

Home Assistant MQTT Discovery for en energimåler

Home Assistant MQTT Discovery gjør at en energimåler automatisk kan opprette sine enhets- og sensorenheter. Når måleren og Home Assistant er koblet til samme MQTT-broker, kan Home Assistant oppdage måleren uten manuell MQTT-sensor-YAML.

IAMMETER støtter MQTT Discovery på alle nåværende energimålere. Avhengig av modell oppretter Home Assistant enheter for spenning, strøm, aktiv effekt, importert energi, eksportert energi og andre tilgjengelige fase- eller kanalmålinger.

Bruk denne metoden når du ønsker:

• lokal MQTT-energiovervåking;
• automatisk oppretting av enheter og sensorer;
• raskere oppdateringer enn HTTP-integrasjonene;
• importerte/eksporterte energienheter som er kompatible med Energy Dashboard;
• minimal Home Assistant-konfigurasjon.

Hvis du trenger full kontroll over topicer, maler, enhetsnavn og metadata, bruk Manual MQTT-guiden for energimålere i stedet.

MQTT Discovery sammenlignet med Manual MQTT

Begge metodene krever en MQTT-broker, men bare Discovery oppretter Home Assistant-enheter automatisk.

Ikke aktiver Discovery og definer de samme målingene manuelt samtidig, med mindre du bevisst ønsker to separate sett med enheter.

Krav

Du trenger:

• en IAMMETER-energimåler med fastvare i.76.058.8 eller nyere;
• en MQTT-broker som både måleren og Home Assistant kan nå;
• brokerens adresse, port, brukernavn og passord;
• Home Assistant med MQTT-integrasjonen aktivert.

Fastvare i.76.058.8 er stabilitetsutgivelsen som er grunnlaget for MQTT Discovery. Den tidligere i.76.02-utgaven var testfastvare og bør ikke lenger installeres eller lenkes som anbefalt versjon.

For nåværende rettelser og de nyeste MQTT-alternativene kan du oppgradere til nyeste IAMMETER-fastvare.

Trinn 1: Koble Home Assistant til MQTT-brokeren

Hvis Home Assistant ikke allerede er koblet til brokeren:

1. Åpne Innstillinger → Enheter og tjenester.
2. Velg Legg til integrasjon.
3. Søk etter MQTT.
4. Angi brokerens adresse, port, brukernavn og passord.
5. Bekreft at MQTT-integrasjonen kobler til uten feil.

Hvis Home Assistant allerede bruker den aktuelle brokeren, behold den eksisterende MQTT-integrasjonen. Ikke opprett en andre broker-tilkobling for IAMMETER-enheten.

MQTT Discovery er aktivert som standard i en vanlig Home Assistant MQTT-oppsett. Hvis discovery er deaktivert eller det brukes et ikke-standard discovery-prefiks, må du sørge for at måleren og Home Assistant bruker kompatible innstillinger.

Trinn 2: Konfigurer MQTT Discovery i målerens WebUI

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

Lagre innstillingene og la måleren starte på nytt eller koble til igjen.

Den nyeste fastvaren viser de nødvendige innstillingene i WebUI. Det er ikke nødvendig å kalle det gamle /api/mqttha?x=1-endepunktet.

Alternativet HA MQTT Discovery er spesifikt for automatisk discovery i Home Assistant. For en generell broker, eget system, Node-RED-flyt eller Manual MQTT-konfigurasjon, la det være deaktivert og bruk målerens standard MQTT-publiseringsformat i stedet.

Trinn 3: Bekreft at Home Assistant oppdager måleren

Etter at måleren kobler til brokeren:

1. Åpne Innstillinger → Enheter og tjenester → MQTT.
2. Se etter en nylig oppdaget IAMMETER-enhet.
3. Åpne enheten og gjennomgå enhetene (entities).
4. Bekreft at spenning, strøm, effekt og energiverdier er rimelige.
5. Kontroller at forventet antall faser eller målekanaler er til stede.

Discovery-konfigurasjon og måletilstand sendes gjennom forskjellige MQTT-topicer. Home Assistant bruker discovery-konfigurasjonen til å opprette enhetene og oppdaterer deretter verdiene når statusmeldinger ankommer.

Hvis enheten ikke dukker opp, start på nytt først etter at du har kontrollert broker-tilkoblingen og topicene. En omstart av Home Assistant kan ikke fikse feil brokeradresse eller avviste MQTT-innlogginger.

Energy Dashboard-støtte

Nåværende IAMMETER MQTT Discovery-nyttelaster inneholder nødvendig metadata for importerte og eksporterte energienheter:

unit_of_measurement: kWh
device_class: energy
state_class: total_increasing

IAMMETER bruker de kompakte MQTT Discovery-nøklene som tilsvarer disse feltene, blant annet:

{
  "unit_of_meas": "kWh",
  "dev_cla": "energy",
  "stat_cla": "total_increasing"
}

Etter at enhetene har mottatt gyldige data:

1. gå til Innstillinger → Dashbord → Energi;
2. velg den importerte energienheten for nettforbruk;
3. velg den eksporterte energienheten for tilbakelevering til nettet;
4. lagre Energy Dashboard-konfigurasjonen.

Ikke velg en øyeblikkelig aktiv-effekt-enhet i watt for et energifelt. Energy Dashboard krever kumulert kWh.

Énfase- og trefase-modeller oppretter forskjellige energienheter. Velg enhetene som tilsvarer målerens kobling og måten installasjonen måler nettimport/-eksport på.

Velg et MQTT-oppdateringsintervall

Den nyeste IAMMETER-fastvaren støtter MQTT-oppdateringer ned til 2 sekunder. Et kortere intervall gir Home Assistant ferskere effektavlesninger, men skaper også mer broker-trafikk, flere enhetsoppdateringer og mer recorder-data.

Foreslåtte utgangspunkter:

Bruk det korteste intervallet bare når automatiseringen faktisk har nytte av det. Energy Dashboard-totaler krever vanligvis ikke tosekunders oppdateringer.

IAMMETER Cloud-kompatibilitet

MQTT Discovery endrer målerens Run Mode til MQTT. Måleren sender målingene til den konfigurerte brokeren og laster dem ikke samtidig opp til IAMMETER Cloud.

Hvis du trenger både Home Assistant og IAMMETER Cloud fra samme måler, velg en lokal HTTP- eller Modbus TCP-integrasjon i stedet. Disse metodene leser måleren lokalt mens den vanlige Cloud-opplastingen fortsetter.

Sammenlign alternativene i oversikten over Home Assistant-energimålerintegrasjoner.

Støttede IAMMETER-modeller

Alle nåværende IAMMETER-energimålere støtter MQTT Discovery. Hovedforskjellen er antall faser/kanaler og dermed antall enheter som opprettes.

WEM3046T og WEM3046TE måler 5 A-sekundærutgangen fra eksterne strømtransformatorer. Riktig CT-forhold må brukes for å få primærsidens strøm, effekt og energi. Dette er et krav i målesystemet, ikke en begrensning i Home Assistant eller MQTT Discovery.

Den utgåtte WEM3162 er ikke inkludert i nåværende kompatibilitetsomfang.

Feilsøking av MQTT Discovery

Home Assistant oppdager ikke måleren

• Bekreft at måleren og Home Assistant bruker samme broker.
• Kontroller brokerens adresse, port, brukernavn og passord.
• Bekreft at HA MQTT Discovery er aktivert i målerens WebUI.
• Sjekk broker-loggene for avviste tilkoblinger eller autorisasjonsfeil.
• Kontroller at Home Assistants MQTT-integrasjon er tilkoblet.
• Abonner på brokerens Home Assistant discovery-prefiks med en MQTT-klient og sjekk om konfigurasjonsmeldinger finnes.

Enheten vises, men enhetene (entities) er utilgjengelige

• Bekreft at måleren fortsetter å publisere statusmeldinger etter discovery-konfigurasjonen.
• Sjekk om en brannmur, VLAN eller broker-ACL tillater både discovery- og statustopicer.
• Kontroller at måleren ikke har byttet til en annen broker.
• Oppgrader til nyeste fastvare og koble til igjen.

Importert/eksportert energi kan ikke velges i Energy Dashboard

• Bekreft at enheten har mottatt en gyldig numerisk kWh-verdi.
• Åpne Utviklerverktøy → Tilstander og kontroller enhetens måleenhet, device class og state class.
• Fjern foreldede enheter opprettet av tidlig testfastvare før du vurderer den nåværende discovery-nyttelasten.
• Bekreft at du velger en energienhet, ikke en aktiv-effekt-enhet.

Dupliserte MQTT-enheter vises

Duplikater oppstår vanligvis når:

• både Manual MQTT-YAML og MQTT Discovery er aktive;
• målerens serienummer eller discovery-unike ID er endret;
• tidlig fastvare publiserte en annen discovery-konfigurasjon;
• retained discovery-topicer fra en gammel konfigurasjon fortsatt ligger på brokeren.

Velg enten Manual MQTT eller MQTT Discovery for de samme målingene, og fjern deretter den foreldede konfigurasjonen.

Fjerne gamle retained Discovery-enheter

Discovery-konfigurasjonsmeldinger i MQTT blir vanligvis beholdt (retained) av brokeren slik at Home Assistant kan opprette enhetene på nytt etter en omstart. Hvis et gammelt konfigurasjonstopic ligger igjen, kan det være utilstrekkelig å bare slette enheten i Home Assistant-grensesnittet — enheten kan komme tilbake når den retained-konfigurasjonen mottas igjen.

Sikker oppryddingsprosedyre:

1. Deaktiver HA MQTT Discovery på måleren eller koble den fra midlertidig, slik at den ikke umiddelbart publiserer den gamle konfigurasjonen på nytt.
2. Bruk en MQTT-klient til å inspisere Home Assistant discovery-prefikset, vanligvis homeassistant/#.
3. Identifiser bare konfigurasjonstopicene som tilhører den berørte IAMMETER-serienummeret/enheten.
4. Publiser en tom retained-nyttelast til hvert foreldede konfigurasjonstopic.
5. Fjern den foreldede enheten/enhetene fra Home Assistant hvis de fortsatt finnes.
6. Aktiver Discovery igjen på nåværende fastvare.
7. Bekreft at én enhet og de forventede nåværende enhetene opprettes.

Ikke slett hele det retained homeassistant/#-topic-treet på en delt broker. Det kan fjerne discovery-konfigurasjon for andre, urelaterte enheter.

Når Manual MQTT er det bedre valget

Bruk Manual MQTT i stedet når du trenger:

• egendefinerte enhetsnavn og unike ID-er;
• egendefinerte JSON-maler eller beregninger;
• bare et utvalgt delsett av målingene;
• en topic-struktur som deles med andre applikasjoner enn Home Assistant;
• eksplisitt kontroll over device class og state class;
• kompatibilitet med et system der Home Assistant Discovery bevisst er deaktivert.

Relaterte guider

• Manual MQTT-konfigurasjon av energimåler for Home Assistant
• Publiser IAMMETER-data til en MQTT-broker
• Sammenlign alle IAMMETER–Home Assistant-integrasjonsmetoder
• Oppgrader til nyeste IAMMETER-fastvare
• Home Assistant MQTT-dokumentasjon

Oppdatert: 19. juli 2026.