Home Assistant MQTT Discovery za števec energije

Home Assistant MQTT Discovery za števec energije

Home Assistant MQTT Discovery omogoča števcu energije, da samodejno ustvari svojo napravo in senzorske entitete. Ko se števec in Home Assistant povežeta z istim MQTT brokerjem, lahko Home Assistant zazna števec brez ročnega YAML za MQTT senzorje.

IAMMETER podpira MQTT Discovery na vseh trenutnih števcih energije. Odvisno od modela Home Assistant ustvari entitete za napetost, tok, delovno moč, prevzeto energijo, oddano energijo in druge razpoložljive meritve faz ali kanalov.

To metodo uporabite, kadar želite:

• lokalno MQTT spremljanje energije;
• samodejno ustvarjanje naprav in entitet;
• hitrejše posodobitve kot pri HTTP integracijah;
• entitete prevzete/oddane energije, združljive z Energy Dashboard;
• minimalno konfiguracijo Home Assistant.

Če potrebujete popoln nadzor nad temami, predlogami, imeni entitet in metapodatki, uporabite namesto tega vodnik za ročni MQTT števec energije.

MQTT Discovery v primerjavi z ročnim MQTT

Obe metodi zahtevata MQTT broker, vendar samo Discovery samodejno ustvarja entitete v Home Assistant.

Ne omogočajte Discovery in hkrati ročno definirajte istih meritev, razen če namerno želite dva ločena niza entitet.

Zahteve

Potrebujete:

• IAMMETER števec energije s programsko opremo i.76.058.8 ali novejšo;
• MQTT broker, dosegljiv za števec in Home Assistant;
• naslov brokerja, vrata, uporabniško ime in geslo;
• Home Assistant z omogočeno MQTT integracijo.

Programska oprema i.76.058.8 je stabilna izhodiščna različica za MQTT Discovery. Starejša slika i.76.02 je bila testna programska oprema in je ne smete več nameščati ali navajati kot priporočeno različico.

Za trenutne popravke in najnovejše MQTT možnosti nadgradite na najnovejšo programsko opremo IAMMETER.

1. korak: Povežite Home Assistant z MQTT brokerjem

Če Home Assistant še ni povezan z brokerjem:

1. Odprite Settings → Devices & services.
2. Izberite Add integration.
3. Poiščite MQTT.
4. Vnesite naslov brokerja, vrata, uporabniško ime in geslo.
5. Preverite, da se MQTT integracija uspešno poveže.

Če Home Assistant že uporablja želeni broker, ohranite obstoječo MQTT integracijo. Ne ustvarjajte druge povezave z brokerjem za napravo IAMMETER.

MQTT Discovery je v običajni nastavitvi Home Assistant MQTT omogočen privzeto. Če je bil Discovery onemogočen ali je uporabljena neprivzeta predpona Discovery, se prepričajte, da števec in Home Assistant uporabljata združljive nastavitve.

2. korak: Nastavite MQTT Discovery v spletnem vmesniku števca

Odprite lokalni spletni vmesnik števca in pojdite na Nastavitve. Konfigurirajte:

Shranite nastavitve in počakajte, da se števec znova zažene ali ponovno poveže.

Najnovejša programska oprema prikaže potrebne nastavitve v spletnem vmesniku. Ni treba klicati zgodovinske končnice /api/mqttha?x=1.

Možnost HA MQTT Discovery je namenjena izključno samodejnemu zaznavanju v Home Assistant. Za splošen broker, sistem po meri, tok Node-RED ali ročno konfiguracijo MQTT jo pustite onemogočeno in uporabite standardni format objavljanja MQTT števca.

3. korak: Preverite, ali Home Assistant zazna števec

Ko se števec poveže z brokerjem:

1. Odprite Settings → Devices & services → MQTT.
2. Poiščite na novo zaznano napravo IAMMETER.
3. Odprite napravo in preglejte entitete.
4. Preverite, da so vrednosti napetosti, toka, moči in energije verodostojne.
5. Preverite, da je prisotno pričakovano število faz ali merilnih kanalov.

Konfiguracija Discovery in stanje meritev se pošiljata prek različnih MQTT tem. Home Assistant uporabi konfiguracijo Discovery za ustvarjanje entitet, nato pa posodobi njihove vrednosti, ko prispejo sporočila stanja.

Če se naprava ne prikaže, znova zaženite šele po preverjanju povezave z brokerjem in tem. Ponovni zagon Home Assistant ne more odpraviti napačnega naslova brokerja ali zavrnjenih MQTT poverilnic.

Podpora za Energy Dashboard

Trenutni tovori IAMMETER MQTT Discovery vključujejo zahtevane metapodatke za entitete prevzete in oddane energije:

unit_of_measurement: kWh
device_class: energy
state_class: total_increasing

IAMMETER uporablja kompaktne ključe MQTT Discovery, ki ustrezajo tem poljem, vključno z:

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

Ko entitete prejmejo veljavne podatke:

1. pojdite na Settings → Dashboards → Energy;
2. izberite entiteto prevzete energije za odjem iz omrežja;
3. izberite entiteto oddane energije za oddajo v omrežje;
4. shranite konfiguracijo Energy Dashboard.

Ne izberite entitete trenutne delovne moči v vatih za polje energije. Energy Dashboard zahteva kumulativne kWh.

Enofazni in trifazni modeli ustvarijo različne entitete energije. Izberite entitete, ki ustrezajo ožičenju števca in načinu, kako napeljava meri odjem iz omrežja oziroma oddajo vanj.

Izbira intervala posodabljanja MQTT

Najnovejša programska oprema IAMMETER podpira posodobitve MQTT do 2 sekund. Krajši interval daje Home Assistant sveže odčitke moči, vendar ustvarja tudi več prometa brokerja, posodobitev entitet in podatkov snemalnika.

Predlagana izhodišča:

Najkrajši interval uporabite le, kadar ima avtomatizacija od njega koristi. Vsote v Energy Dashboard na splošno ne zahtevajo posodobitev vsaki 2 sekundi.

Združljivost z IAMMETER Cloud

MQTT Discovery spremeni način delovanja števca v MQTT. Števec pošilja meritve na konfiguriranega brokerja in jih hkrati ne nalaga v IAMMETER Cloud.

Če potrebujete tako Home Assistant kot IAMMETER Cloud z istega števca, izberite lokalno HTTP ali Modbus TCP integracijo. Ti metodi bereta števec lokalno, medtem ko se njegovo običajno nalaganje v Cloud nadaljuje.

Primerjajte možnosti v pregledu integracij Home Assistant števca energije.

Podprti modeli IAMMETER

Vsi trenutni števci energije IAMMETER podpirajo MQTT Discovery. Glavna razlika je število faz/kanalov in s tem število ustvarjenih entitet.

WEM3046T in WEM3046TE merita sekundarni izhod 5 A zunanjih tokovnih transformatorjev. Za pridobitev toka, moči in energije na primarni strani je treba uporabiti pravilno razmerje CT. To je zahteva merilnega sistema, ne omejitev Home Assistant ali MQTT Discovery.

Ukinjeni WEM3162 ni vključen v trenutni obseg združljivosti.

Odpravljanje težav z MQTT Discovery

Home Assistant ne zazna števca

• Preverite, da števec in Home Assistant uporabljata isti broker.
• Preverite naslov brokerja, vrata, uporabniško ime in geslo.
• Preverite, da je HA MQTT Discovery omogočen v spletnem vmesniku števca.
• Preverite dnevnike brokerja za zavrnjene povezave ali napake pri avtorizaciji.
• Preverite, da je MQTT integracija Home Assistant povezana.
• Z MQTT odjemalcem se naročite na predpono Discovery Home Assistant na brokerju in preverite, ali so prisotna konfiguracijska sporočila.

Naprava se prikaže, vendar entitete niso na voljo

• Preverite, da števec po konfiguraciji Discovery še naprej objavlja sporočila stanja.
• Preverite, ali požarni zid, VLAN ali ACL brokerja dovoljuje tako teme Discovery kot stanja.
• Preverite, da se števec ni preklopil na drug broker.
• Nadgradite na najnovejšo programsko opremo in se ponovno povežite.

Prevzete/oddane energije ni mogoče izbrati v Energy Dashboard

• Preverite, da je entiteta prejela veljavno številčno vrednost kWh.
• Odprite Developer tools → States in preverite njeno enoto, razred naprave in razred stanja.
• Odstranite zastarele entitete, ki jih je ustvarila zgodnja testna programska oprema, preden ocenite trenutni tovor Discovery.
• Preverite, da izbirate entiteto energije in ne entitete delovne moči.

Pojavijo se podvojene entitete MQTT

Podvojene entitete se običajno pojavijo, kadar:

• sta aktivna tako ročni YAML za MQTT kot MQTT Discovery;
• se je spremenila serijska številka števca ali enolični ID Discovery;
• je zgodnja programska oprema objavila drugačno konfiguracijo Discovery;
• na brokerju ostanejo zadržane teme Discovery iz stare konfiguracije.

Za iste meritve izberite bodisi ročni MQTT bodisi MQTT Discovery in nato odstranite zastarelo konfiguracijo.

Odstranjevanje starih zadržanih entitet Discovery

Konfiguracijska sporočila MQTT Discovery broker običajno zadrži, da lahko Home Assistant po ponovnem zagonu znova ustvari entitete. Če stara konfiguracijska tema ostane, samo brisanje naprave v uporabniškem vmesniku Home Assistant morda ne bo dovolj – entiteta se lahko vrne, ko je zadržana konfiguracija znova prejeta.

Varen postopek čiščenja:

1. Onemogočite HA MQTT Discovery na števcu ali ga začasno odklopite, da ne bo takoj znova objavil stare konfiguracije.
2. Z MQTT odjemalcem preglejte predpono Discovery Home Assistant, običajno homeassistant/#.
3. Identificirajte samo konfiguracijske teme, ki pripadajo zadevni serijski številki/napravi IAMMETER.
4. Na vsako zastarelo konfiguracijsko temo objavite prazen zadržan tovor.
5. Odstranite zastarelo napravo/entitete iz Home Assistant, če še obstajajo.
6. Na trenutni programski opremi znova omogočite Discovery.
7. Preverite, da sta ustvarjeni ena naprava in pričakovane trenutne entitete.

Ne brišite celotnega drevesa zadržanih tem homeassistant/# na deljenem brokerju. To bi lahko odstranilo konfiguracijo Discovery za nepovezane naprave.

Kdaj je ročni MQTT boljša izbira

Uporabite ročni MQTT, kadar potrebujete:

• imena entitet in enolične ID-je po meri;
• predloge JSON ali izračune po meri;
• samo izbran podnabor meritev;
• strukturo tem, ki si jo delijo aplikacije, ki niso Home Assistant;
• izrecen nadzor nad razredom naprave in razredom stanja;
• združljivost s sistemom, kjer je Home Assistant Discovery namerno onemogočen.

Povezani vodniki

• Ročna konfiguracija MQTT števca energije za Home Assistant
• Objavljanje podatkov IAMMETER na MQTT broker
• Primerjava vseh metod integracije IAMMETER–Home Assistant
• Nadgradnja na najnovejšo programsko opremo IAMMETER
• Dokumentacija Home Assistant MQTT

Posodobljeno: 19. julij 2026.