Home Assistant MQTT Discovery til en energimåler

Home Assistant MQTT Discovery til en energimåler

Home Assistant MQTT Discovery lader en energimåler oprette sine enheds- og sensorenheder automatisk. Når måleren og Home Assistant har forbindelse til den samme MQTT-broker, kan Home Assistant opdage måleren uden manuel MQTT-sensor-YAML.

IAMMETER understøtter MQTT Discovery på alle nuværende energimålere. Afhængigt af modellen opretter Home Assistant enheder for spænding, strøm, aktiv effekt, importeret energi, eksporteret energi og andre tilgængelige fase- eller kanalmålinger.

Brug denne metode, når du ønsker:

• lokal MQTT-energiovervågning;
• automatisk oprettelse af enheder og sensor-enheder;
• hurtigere opdateringer end HTTP-integrationerne;
• Energy Dashboard-kompatible enheder for importeret/eksporteret energi;
• minimal Home Assistant-konfiguration.

Hvis du har brug for fuld kontrol over emner (topics), skabeloner, enhedsnavne og metadata, så brug i stedet guiden til manuel MQTT-energimåler.

MQTT Discovery versus manuel MQTT

Begge metoder kræver en MQTT-broker, men kun Discovery opretter Home Assistant-enheder automatisk.

Aktivér ikke Discovery og definér samtidig de samme målinger manuelt, medmindre du bevidst ønsker to separate sæt enheder.

Krav

Du skal bruge:

• en IAMMETER-energimåler med firmware i.76.058.8 eller nyere;
• en MQTT-broker, som måleren og Home Assistant kan nå;
• brokerens adresse, port, brugernavn og adgangskode;
• Home Assistant med MQTT-integrationen aktiveret.

Firmware i.76.058.8 er den stabile udgivelsesbaseline for MQTT Discovery. Det tidligere i.76.02-image var en testfirmware og bør ikke længere installeres eller linkes som den anbefalede version.

For aktuelle rettelser og de nyeste MQTT-muligheder kan du opgradere til den nyeste IAMMETER-firmware.

Trin 1: Forbind Home Assistant til MQTT-brokeren

Hvis Home Assistant ikke allerede er forbundet til brokeren:

1. Åbn Indstillinger → Enheder og tjenester.
2. Vælg Tilføj integration.
3. Søg efter MQTT.
4. Indtast brokerens adresse, port, brugernavn og adgangskode.
5. Bekræft, at MQTT-integrationen forbinder korrekt.

Hvis Home Assistant allerede bruger den påtænkte broker, skal du beholde den eksisterende MQTT-integration. Opret ikke en anden brokerforbindelse for IAMMETER-enheden.

MQTT Discovery er som standard aktiveret i en normal Home Assistant-MQTT-opsætning. Hvis Discovery er blevet deaktiveret, eller der bruges et ikke-standard Discovery-prefix, skal du sikre, at måleren og Home Assistant bruger kompatible indstillinger.

Trin 2: Konfigurér MQTT Discovery i målerens WebUI

Åbn målerens lokale WebUI, og gå til Indstillinger. Konfigurér:

Gem indstillingerne, og lad måleren genstarte eller oprette forbindelse igen.

Den nyeste firmware viser de nødvendige indstillinger i WebUI. Der er ikke behov for at kalde det gamle /api/mqttha?x=1-endepunkt.

Indstillingen HA MQTT Discovery er specifikt til Home Assistants automatiske opdagelse. Til en generel broker, et brugerdefineret system, en Node-RED-flow eller manuel MQTT-konfiguration skal du lade den være deaktiveret og bruge målerens standard MQTT-publiceringsformat i stedet.

Trin 3: Bekræft, at Home Assistant opdager måleren

Når måleren har forbindelse til brokeren:

1. Åbn Indstillinger → Enheder og tjenester → MQTT.
2. Se efter en nyopdaget IAMMETER-enhed.
3. Åbn enheden, og gennemgå sensor-enhederne.
4. Bekræft, at spænding, strøm, effekt og energiværdier er plausible.
5. Kontrollér, at det forventede antal faser eller målekanaler er til stede.

Discovery-konfiguration og måletilstand sendes via forskellige MQTT-emner. Home Assistant bruger Discovery-konfigurationen til at oprette enhederne og opdaterer derefter deres værdier, når statussætningen ankommer.

Hvis enheden ikke vises, skal du først kontrollere brokerforbindelsen og emnerne, inden du genstarter. En genstart af Home Assistant kan ikke reparere en forkert brokeradresse eller afviste MQTT-legitimationsoplysninger.

Energy Dashboard-understøttelse

Nuværende IAMMETER-MQTT-Discovery-nyttelaster indeholder de nødvendige metadata for enheder med importeret og eksporteret energi:

unit_of_measurement: kWh
device_class: energy
state_class: total_increasing

IAMMETER bruger de kompakte MQTT-Discovery-nøgler, der svarer til disse felter, herunder:

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

Når sensor-enhederne har modtaget gyldige data:

1. gå til Indstillinger → Dashboards → Energy;
2. vælg sensor-enheden for importeret energi til netforbrug;
3. vælg sensor-enheden for eksporteret energi til tilbagelevering til nettet;
4. gem Energy Dashboard-konfigurationen.

Vælg ikke en enhed med øjeblikkelig aktiv effekt i watt til et energifelt. Energy Dashboard kræver kumulerede kWh.

Enfasede og trefasede modeller opretter forskellige energienheder. Vælg de enheder, der svarer til målerens tilslutning og den måde, installationen måler netimport/-eksport på.

Vælg et MQTT-opdateringsinterval

Den nyeste IAMMETER-firmware understøtter MQTT-opdateringer helt ned til 2 sekunder. Et kortere interval giver Home Assistant friskere effektaflæsninger, men skaber også mere broker-trafik, flere enhedsopdateringer og mere recorder-data.

Foreslåede udgangspunkter:

Brug kun det korteste interval, når automatiseringen har gavn af det. Energy Dashboard-totaler kræver generelt ikke opdateringer hvert andet sekund.

IAMMETER Cloud-kompatibilitet

MQTT Discovery ændrer målerens kørselstilstand til MQTT. Måleren sender sine målinger til den konfigurerede broker og uploader dem ikke samtidig til IAMMETER Cloud.

Hvis du skal bruge både Home Assistant og IAMMETER Cloud fra den samme måler, skal du i stedet vælge en lokal HTTP- eller Modbus TCP-integration. Disse metoder læser måleren lokalt, mens dens normale Cloud-upload fortsætter.

Sammenlign mulighederne i oversigten over Home Assistant-energimålerintegrationer.

Understøttede IAMMETER-modeller

Alle nuværende IAMMETER-energimålere understøtter MQTT Discovery. Den største forskel er antallet af faser/kanaler og dermed antallet af oprettede enheder.

WEM3046T og WEM3046TE måler 5 A-sekundærudgangen fra eksterne strømtransformere. Det korrekte CT-forhold skal anvendes for at få primærsidens strøm, effekt og energi. Dette er et krav i målesystemet, ikke en begrænsning i Home Assistant eller MQTT Discovery.

Den udgåede WEM3162 er ikke inkluderet i det nuværende kompatibilitetsomfang.

Fejlfinding af MQTT Discovery

Home Assistant opdager ikke måleren

• Bekræft, at måleren og Home Assistant bruger den samme broker.
• Kontrollér brokerens adresse, port, brugernavn og adgangskode.
• Bekræft, at HA MQTT Discovery er aktiveret i målerens WebUI.
• Kontrollér broker-logfilerne for afviste forbindelser eller godkendelsesfejl.
• Bekræft, at Home Assistants MQTT-integration er forbundet.
• Abonnér på brokerens Home Assistant-Discovery-prefix med en MQTT-klient, og kontrollér, om der er konfigurationsbeskeder til stede.

Enheden vises, men sensor-enhederne er utilgængelige

• Bekræft, at måleren fortsætter med at publicere statussætninger efter Discovery-konfigurationen.
• Kontrollér, om en firewall, VLAN eller broker-ACL tillader både Discovery- og statusemner.
• Bekræft, at måleren ikke har skiftet til en anden broker.
• Opgrader til den nyeste firmware, og opret forbindelse igen.

Importeret/eksporteret energi kan ikke vælges i Energy Dashboard

• Bekræft, at sensor-enheden har modtaget en gyldig numerisk kWh-værdi.
• Åbn Udviklerværktøjer → Tilstande, og inspicér dens enhed, enhedsklasse og tilstandsklasse.
• Fjern forældede enheder, der blev oprettet af tidlig testfirmware, før du vurderer den aktuelle Discovery-nyttelast.
• Bekræft, at du vælger en energienhed og ikke en enhed med aktiv effekt.

Duplikerede MQTT-enheder vises

Duplikater opstår normalt, når:

• manuel MQTT-YAML og MQTT Discovery begge er aktive;
• målerens serienummer eller Discovery-unikke ID er ændret;
• tidlig firmware publicerede en anden Discovery-konfiguration;
• der stadig er retentionsemner fra en gammel konfiguration på brokeren.

Vælg enten manuel MQTT eller MQTT Discovery til de samme målinger, og fjern derefter den forældede konfiguration.

Fjern gamle retentions-Discovery-enheder

MQTT-Discovery-konfigurationsbeskeder gemmes normalt af brokeren, så Home Assistant kan oprette enhederne igen efter en genstart. Hvis et gammelt konfigurationsemne stadig findes, kan det være utilstrækkeligt kun at slette enheden i Home Assistant-brugergrænsefladen — enheden kan vende tilbage, når den retentionslagrede konfiguration modtages igen.

Sikker oprydningsprocedure:

1. Deaktivér HA MQTT Discovery på måleren, eller afbryd den midlertidigt, så den ikke straks publicerer den gamle konfiguration igen.
2. Brug en MQTT-klient til at inspicere Home Assistant-Discovery-prefixet, normalt homeassistant/#.
3. Identificér kun de konfigurationsemner, der tilhører den berørte IAMMETER-serie- eller enhedsidentitet.
4. Publicér en tom retentionsnyttelast til hvert forældet konfigurationsemne.
5. Fjern den forældede enhed/de forældede enheder fra Home Assistant, hvis de stadig findes.
6. Aktivér Discovery igen på den nuværende firmware.
7. Bekræft, at der oprettes én enhed og de forventede nuværende sensor-enheder.

Slet ikke hele homeassistant/#-retentionsemnetræet på en delt broker. Det kan fjerne Discovery-konfiguration for andre enheder.

Hvornår er manuel MQTT det bedre valg?

Brug manuel MQTT i stedet, når du har brug for:

• brugerdefinerede enhedsnavne og unikke ID'er;
• brugerdefinerede JSON-skabeloner eller beregninger;
• kun et udvalgt undersæt af målinger;
• en emnestruktur, der deles med andre programmer end Home Assistant;
• eksplicit kontrol over enhedsklasse og tilstandsklasse;
• kompatibilitet med et system, hvor Home Assistant Discovery bevidst er deaktiveret.

Relaterede guider

• Manuel MQTT-energimålerkonfiguration til Home Assistant
• Publicér IAMMETER-data til en MQTT-broker
• Sammenlign alle IAMMETER–Home Assistant-integrationsmetoder
• Opgrader til den nyeste IAMMETER-firmware
• Home Assistant MQTT-dokumentation

Opdateret: 19. juli 2026.