Home Assistant MQTT Discovery enerģijas skaitītājam

Home Assistant MQTT Discovery enerģijas skaitītājam

Home Assistant MQTT Discovery ļauj enerģijas skaitītājam automātiski izveidot savas ierīces un sensoru entītijas. Pēc tam, kad skaitītājs un Home Assistant ir savienoti ar vienu un to pašu MQTT brokeri, Home Assistant var atklāt skaitītāju bez manuālas MQTT sensoru YAML konfigurācijas.

IAMMETER atbalsta MQTT Discovery visos pašreizējos enerģijas skaitītājos. Atkarībā no modeļa Home Assistant izveido entītijas spriegumam, strāvai, aktīvajai jaudai, ievestajai enerģijai, eksportētajai enerģijai un citiem pieejamajiem fāžu vai kanālu mērījumiem.

Izmantojiet šo metodi, ja vēlaties:

• lokālu MQTT enerģijas monitoringu;
• automātisku ierīču un entītiju izveidi;
• ātrākus atjauninājumus nekā HTTP integrācijās;
• ar enerģijas paneli saderīgas ievestās/eksportētās enerģijas entītijas;
• minimālu Home Assistant konfigurāciju.

Ja nepieciešama pilnīga kontrole pār tematiem, veidnēm, entītiju nosaukumiem un metadatiem, tā vietā izmantojiet Manuālā MQTT enerģijas skaitītāja ceļvedi.

MQTT Discovery salīdzinājumā ar manuālo MQTT

Abām metodēm ir nepieciešams MQTT brokeris, taču tikai Discovery automātiski izveido Home Assistant entītijas.

Neespējojiet Discovery un nedefinējiet vienus un tos pašus mērījumus manuāli, ja vien apzināti nevēlaties divas atsevišķas entītiju kopas.

Prasības

Jums ir nepieciešams:

• IAMMETER enerģijas skaitītājs ar programmaparatūru i.76.058.8 vai jaunāku;
• MQTT brokeris, kas sasniedzams skaitītājam un Home Assistant;
• brokera adrese, ports, lietotājvārds un parole;
• Home Assistant ar iespējotu MQTT integrāciju.

Programmaparatūra i.76.058.8 ir stabilās versijas bāzes līmenis MQTT Discovery. Agrākā i.76.02 versija bija testa programmaparatūra, un to vairs nevajadzētu instalēt vai norādīt kā ieteicamo versiju.

Aktuālajiem labojumiem un jaunākajām MQTT opcijām jauniniet uz jaunāko IAMMETER programmaparatūru.

1. darbība: Home Assistant savienošana ar MQTT brokeri

Ja Home Assistant vēl nav savienots ar brokeri:

1. Atveriet Iestatījumi → Ierīces un pakalpojumi.
2. Izvēlieties Pievienot integrāciju.
3. Meklējiet MQTT.
4. Ievadiet brokera adresi, portu, lietotājvārdu un paroli.
5. Pārliecinieties, ka MQTT integrācija savienojas veiksmīgi.

Ja Home Assistant jau izmanto paredzēto brokeri, saglabājiet esošo MQTT integrāciju. Neveidojiet otru brokera savienojumu IAMMETER ierīcei.

MQTT Discovery parasti ir iespējots pēc noklusējuma standarta Home Assistant MQTT iestatījumos. Ja atklāšana ir atspējota vai tiek izmantots nestandarta atklāšanas prefikss, pārliecinieties, ka skaitītājs un Home Assistant izmanto saderīgus iestatījumus.

2. darbība: MQTT Discovery konfigurēšana skaitītāja WebUI

Atveriet skaitītāja lokālo WebUI un dodieties uz Iestatījumi. Konfigurējiet:

Saglabājiet iestatījumus un ļaujiet skaitītājam restartēties vai atkārtoti savienoties.

Jaunākā programmaparatūra piedāvā nepieciešamos iestatījumus WebUI. Nav nepieciešams izsaukt vēsturisko /api/mqttha?x=1 galapunktu.

Opcija HA MQTT Discovery ir paredzēta tieši Home Assistant automātiskajai atklāšanai. Vispārīgam brokerim, pielāgotai sistēmai, Node-RED plūsmai vai manuālai MQTT konfigurācijai atstājiet to atspējotu un izmantojiet skaitītāja standarta MQTT publicēšanas formātu.

3. darbība: pārliecinieties, ka Home Assistant atklāj skaitītāju

Pēc tam, kad skaitītājs savienojas ar brokeri:

1. Atveriet Iestatījumi → Ierīces un pakalpojumi → MQTT.
2. Meklējiet nesen atklātu IAMMETER ierīci.
3. Atveriet ierīci un pārskatiet entītijas.
4. Pārliecinieties, ka sprieguma, strāvas, jaudas un enerģijas vērtības ir ticamas.
5. Pārbaudiet, vai ir pieejams paredzamais fāžu vai mērījumu kanālu skaits.

Atklāšanas konfigurācija un mērījumu stāvoklis tiek nosūtīti pa dažādiem MQTT tematiem. Home Assistant izmanto atklāšanas konfigurāciju, lai izveidotu entītijas, un pēc tam atjaunina to vērtības, kad pienāk stāvokļa ziņojumi.

Ja ierīce neparādās, restartējiet tikai pēc brokera savienojuma un tematu pārbaudes. Home Assistant restartēšana nevar labot nepareizu brokera adresi vai noraidītus MQTT akreditācijas datus.

Enerģijas paneļa atbalsts

Pašreizējie IAMMETER MQTT Discovery dati ietver nepieciešamos metadatus ievestās un eksportētās enerģijas entītijām:

unit_of_measurement: kWh
device_class: energy
state_class: total_increasing

IAMMETER izmanto kompaktos MQTT Discovery taustiņus, kas atbilst šiem laukiem, tostarp:

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

Kad entītijas ir saņēmušas derīgus datus:

1. dodieties uz Iestatījumi → Informācijas paneļi → Enerģija;
2. tīkla patēriņam izvēlieties ievestās enerģijas entītiju;
3. atgriešanai tīklā izvēlieties eksportētās enerģijas entītiju;
4. saglabājiet enerģijas paneļa konfigurāciju.

Neizvēlieties momentānās aktīvās jaudas entītiju vatos kā enerģijas lauku. Enerģijas panelim ir nepieciešama kumulatīvā enerģija kWh.

Vienfāzes un trīsfāžu modeļi izveido dažādas enerģijas entītijas. Izvēlieties entītijas, kas atbilst skaitītāja pieslēgumam un tam, kā instalācija mēra tīkla ievedumu/izvedumu.

MQTT atjaunināšanas intervāla izvēle

Jaunākā IAMMETER programmaparatūra atbalsta MQTT atjauninājumus jau ar 2 sekunžu intervālu. Īsāks intervāls sniedz Home Assistant svaigākus jaudas rādījumus, bet rada arī lielāku brokera trafiku, vairāk entītiju atjauninājumu un vairāk ierakstītāja datu.

Ieteicamie sākumpunkti:

Īsāko intervālu izmantojiet tikai tad, ja automatizācija no tā gūst labumu. Enerģijas paneļa kopsummas parasti neprasa divu sekunžu atjauninājumus.

Saderība ar IAMMETER Cloud

MQTT Discovery maina skaitītāja darbības režīmu uz MQTT. Skaitītājs nosūta savus mērījumus konfigurētajam brokerim un vienlaikus neaugšupielādē tos IAMMETER Cloud.

Ja no viena skaitītāja nepieciešami gan Home Assistant, gan IAMMETER Cloud, tā vietā izvēlieties lokālo HTTP vai Modbus TCP integrāciju. Šīs metodes nolasa skaitītāju lokāli, kamēr turpinās tā parastā Cloud augšupielāde.

Salīdziniet iespējas Home Assistant enerģijas skaitītāja integrāciju pārskatā.

Atbalstītie IAMMETER modeļi

Visi pašreizējie IAMMETER enerģijas skaitītāji atbalsta MQTT Discovery. Galvenā atšķirība ir fāžu/kanālu skaits un līdz ar to izveidoto entītiju skaits.

WEM3046T un WEM3046TE mēra ārējo strāvas transformatoru 5 A sekundāro izeju. Lai iegūtu primārās puses strāvu, jaudu un enerģiju, jāpiemēro pareiza CT attiecība. Tā ir mērīšanas sistēmas prasība, nevis Home Assistant vai MQTT Discovery ierobežojums.

Pārtrauktais WEM3162 nav iekļauts pašreizējā saderības klāstā.

MQTT Discovery problēmu novēršana

Home Assistant neatklāj skaitītāju

• Pārliecinieties, ka skaitītājs un Home Assistant izmanto vienu un to pašu brokeri.
• Pārbaudiet brokera adresi, portu, lietotājvārdu un paroli.
• Pārliecinieties, ka skaitītāja WebUI ir iespējota opcija HA MQTT Discovery.
• Pārbaudiet brokera žurnālus, vai nav noraidītu savienojumu vai autorizācijas kļūdu.
• Pārbaudiet, vai Home Assistant MQTT integrācija ir savienota.
• Abonējiet brokera Home Assistant atklāšanas prefiksu ar MQTT klientu un pārbaudiet, vai ir konfigurācijas ziņojumi.

Ierīce parādās, bet entītijas nav pieejamas

• Pārliecinieties, ka skaitītājs turpina publicēt stāvokļa ziņojumus pēc atklāšanas konfigurācijas.
• Pārbaudiet, vai ugunsmūris, VLAN vai brokera ACL ļauj gan atklāšanas, gan stāvokļa tematus.
• Pārbaudiet, vai skaitītājs nav pārslēdzies uz citu brokeri.
• Jauniniet uz jaunāko programmaparatūru un savienojiet vēlreiz.

Ievestā/eksportētā enerģija nav izvēlama enerģijas panelī

• Pārliecinieties, ka entītija ir saņēmusi derīgu skaitlisku vērtību kWh.
• Atveriet Izstrādātāja rīki → Stāvokļi un pārbaudiet tās mērvienību, ierīču klasi un stāvokļa klasi.
• Pirms pašreizējās atklāšanas datu izvērtēšanas noņemiet novecojušās entītijas, ko izveidojusi agrīnā testa programmaparatūra.
• Pārliecinieties, ka izvēlaties enerģijas entītiju, nevis aktīvās jaudas entītiju.

Parādās dublētas MQTT entītijas

Dublikāti parasti rodas, ja:

• vienlaikus ir aktīvi gan manuālais MQTT YAML, gan MQTT Discovery;
• ir mainīts skaitītāja sērijas numurs vai atklāšanas unikālais ID;
• agrīnā programmaparatūra publicēja citu atklāšanas konfigurāciju;
• brokerī ir saglabāti vecas konfigurācijas saglabātie atklāšanas temati.

Izvēlieties vieniem un tiem pašiem mērījumiem vai nu manuālo MQTT, vai MQTT Discovery, un pēc tam noņemiet novecojušo konfigurāciju.

Veco saglabāto Discovery entītiju noņemšana

MQTT Discovery konfigurācijas ziņojumus brokeris parasti saglabā (retain), lai Home Assistant pēc restartēšanas varētu atkārtoti izveidot entītijas. Ja paliek vecs konfigurācijas temats, ar ierīces dzēšanu tikai Home Assistant saskarnē var nepietikt — entītija var atgriezties, kad atkal tiek saņemta saglabātā konfigurācija.

Droša tīrīšanas procedūra:

1. Atspējojiet HA MQTT Discovery skaitītājā vai īslaicīgi atvienojiet to, lai tas nekavējoties nepublicētu vēlreiz veco konfigurāciju.
2. Izmantojiet MQTT klientu, lai apskatītu Home Assistant atklāšanas prefiksu, parasti homeassistant/#.
3. Identificējiet tikai tos konfigurācijas tematus, kas pieder attiecīgajam IAMMETER sērijas numuram/ierīcei.
4. Publicējiet tukšu saglabātu datu kopu katram novecojušajam konfigurācijas tematam.
5. Noņemiet novecojušo ierīci/entītijas no Home Assistant, ja tās joprojām pastāv.
6. Atkal iespējojiet Discovery pašreizējā programmaparatūrā.
7. Pārliecinieties, ka ir izveidota viena ierīce un paredzamās pašreizējās entītijas.

Koplietotā brokerī neizdzēsiet visu homeassistant/# saglabāto tematu koku. Tas var noņemt atklāšanas konfigurāciju nesaistītām ierīcēm.

Kad manuālais MQTT ir labāka izvēle

Tā vietā izmantojiet Manuālo MQTT, ja nepieciešams:

• pielāgoti entītiju nosaukumi un unikālie ID;
• pielāgotas JSON veidnes vai aprēķini;
• tikai izvēlēta mērījumu apakškopa;
• tematu struktūra, ko izmanto arī citas lietojumprogrammas, kas nav Home Assistant;
• skaidra kontrole pār ierīču klasi un stāvokļa klasi;
• saderība ar sistēmu, kurā Home Assistant Discovery ir apzināti atspējota.

Saistītie ceļveži

• Manuālā MQTT enerģijas skaitītāja konfigurācija Home Assistant
• IAMMETER datu publicēšana MQTT brokerī
• Visu IAMMETER–Home Assistant integrācijas metožu salīdzinājums
• Jauniniet uz jaunāko IAMMETER programmaparatūru
• Home Assistant MQTT dokumentācija

Atjaunināts: 2026. gada 19. jūlijā.