MQTT enerģijas skaitītājs Home Assistant: manuāla YAML iestatīšana

Manuāla MQTT enerģijas skaitītāja konfigurēšana programmā Home Assistant

MQTT enerģijas skaitītājs var publicēt spriegumu, strāvu, aktīvo jaudu un importēto/eksportēto enerģiju brokerī jūsu lokālajā tīklā. Home Assistant abonē šos datus un pārvērš JSON vērtības sensora elementos, kurus var izmantot paneļos, automatizācijās un Enerģijas panelī.

Šajā rokasgrāmatā ir aprakstīta manuālā MQTT metode IAMMETER enerģijas skaitītājiem:

1. konfigurējiet MQTT brokeri skaitītāja WebUI;
2. savienojiet Home Assistant ar to pašu brokeri;
3. definējiet nepieciešamos MQTT sensorus YAML;
4. pievienojiet importēto un eksportēto enerģiju Enerģijas panelim.

Manuālais MQTT dod jums pilnīgu kontroli pār elementu nosaukumiem, tēmām, veidnēm un metadatiem. Ja vēlaties, lai Home Assistant ierīci un elementus izveidotu automātiski, izmantojiet MQTT Discovery.

Manuālais MQTT un MQTT Discovery ir atšķirīgas metodes

Abas metodes izmanto MQTT brokeri, bet Home Assistant iestatīšana atšķiras.

Šajā rokasgrāmatā skaitītāja WebUI atstājiet HA MQTT Discovery izslēgtu. Šis slēdzis ir nepieciešams tikai tad, ja vēlaties Home Assistant automātisko atklāšanu.

Kas jums nepieciešams

• IAMMETER enerģijas skaitītājs ar aktuālo programmaparatūru;
• MQTT brokeris, kas ir pieejams gan skaitītājam, gan Home Assistant;
• brokera adrese, ports, lietotājvārds un parole;
• skaitītāja sērijas numurs;
• piekļuve Home Assistant YAML konfigurācijai.

Brokeris var darboties tajā pašā iekārtā kā Home Assistant, Mosquitto brokera papildinājumā, citā LAN serverī vai attālā resursdatorā. Izmantojiet lokālo brokeri, ja vēlaties, lai viss datu ceļš paliktu LAN iekšienē.

Visi pašreizējie IAMMETER skaitītāji atbalsta manuālo MQTT. Vienfāzes, divkanālu un trīsfāžu modeļi publicē dažādas JSON masīvu struktūras, tāpēc vērtību veidnēm jāatbilst faktiskajam datu apjomam.

1. darbība: konfigurējiet MQTT brokeri 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 atkārtoti savienoties.

Pašreizējās programmaparatūras WebUI tieši atbalsta šos brokera iestatījumus. Lietotājvārds un parole nav jākonfigurē, izmantojot agrāko lokālās API procedūru.

Pilnīgu skaitītāja puses konfigurāciju un vecākas programmaparatūras instrukcijas skatiet sadaļā publicēt IAMMETER datus MQTT brokerī.

MQTT režīms un IAMMETER Cloud

Kad skaitītāja darba režīms tiek mainīts uz MQTT, tas publicē mērījumus jūsu brokerī, nevis augšupielādē tos IAMMETER Cloud. Tāpēc manuālais MQTT un IAMMETER Cloud nedarbojas vienlaikus no viena un tā paša skaitītāja.

Ja jums vienlaikus ir nepieciešami Home Assistant un IAMMETER Cloud, izmantojiet lokālo HTTP vai Modbus TCP integrāciju. Salīdziniet pieejamās metodes Home Assistant enerģijas skaitītāja integrācijas rokasgrāmatā.

2. darbība: pārbaudiet MQTT tēmu un datu apjomu

IAMMETER publicē reāllaika mērījumus šādā tēmā:

device/{SN}/realtime

Aizstājiet {SN} ar skaitītāja sērijas numuru. Piemēram:

device/80123456/realtime

Pirms Home Assistant sensoru konfigurēšanas abonējiet šo tēmu ar MQTT klientu un pārliecinieties, ka ziņojumi pienāk. Tādējādi YAML problēmu novēršana netiks sajaukta ar brokera, akreditācijas, ugunsmūra vai tēmas problēmām.

Vienfāzes JSON

Vienfāzes skaitītājs izmanto Data masīvu. Pirmās piecas vērtības ir:

Piemērs:

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

Daudzkanālu un trīsfāžu JSON

Daudzkanālu un trīsfāžu skaitītāji izmanto Datas masīvu. Katrs ligzdotais masīvs apzīmē fāzi vai mērījumu kanālu:

Datas[0] → phase/channel A
Datas[1] → phase/channel B
Datas[2] → phase/channel C, when present

Katrā fāzes/kanāla masīvā izplatītākās pozīcijas ir:

Pirms veidņu kopēšanas vienmēr pārbaudiet faktisko MQTT ziņojumu no sava modeļa un programmaparatūras. Skatiet pilnu IAMMETER JSON datu definīciju.

3. darbība: savienojiet Home Assistant ar brokeri

Programmā Home Assistant:

1. Dodieties uz Iestatījumi → Ierīces un pakalpojumi.
2. Atlasiet Pievienot integrāciju.
3. Meklējiet MQTT.
4. Ievadiet to pašu brokera adresi, portu, lietotājvārdu un paroli, ko izmanto skaitītājs.
5. Pārliecinieties, ka MQTT integrācija veiksmīgi savienojas.

Ja Home Assistant jau izmanto šo brokeri, nepievienojiet dublētu MQTT integrāciju. Manuāli definētie sensori izmantos esošo brokera savienojumu.

4. darbība: pievienojiet manuālā MQTT sensorus YAML

Zemāk esošie piemēri izmanto Home Assistant pašreizējo mqtt: sensor: konfigurācijas struktūru. Aizstājiet sērijas numuru katrā state_topic.

Vienfāzes enerģijas skaitītāja 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 ļauj Home Assistant pārvaldīt elementu iestatījumus saskarnē. Saglabājiet katru ID unikālu un stabilu. Nemainiet to tikai tāpēc, lai pārdēvētu parādīto elementu.

Trīsfāžu enerģijas skaitītāja YAML

Šis piemērs izveido A fāzes elementus. Dublējiet bloku B un C fāzēm, nomainot Datas[0] uz Datas[1] un Datas[2], un izmantojiet atšķirīgus nosaukumus un unikālus ID.

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

WEM2067 un citiem daudzkanālu modeļiem izveidojiet tik kanālu bloku, cik ir faktiskajā Datas datu apjomā.

Izvairieties no diviem augšējā līmeņa mqtt: blokiem

Ja configuration.yaml jau satur mqtt: sadaļu, pievienojiet sensorus esošajai sadaļai. YAML nevar droši saturēt divas neatkarīgas augšējā līmeņa atslēgas ar vienu un to pašu nosaukumu.

Lielai konfigurācijai varat glabāt MQTT sensorus iekļautā failā, taču ievērojiet Home Assistant iekļaušanas struktūras un atkāpju noteikumus.

5. darbība: pārbaudiet konfigurāciju un ielādējiet sensorus

Pēc YAML saglabāšanas:

1. palaidiet Home Assistant konfigurācijas pārbaudi;
2. izlabojiet visas YAML, atkāpju vai veidņu kļūdas;
3. restartējiet Home Assistant, ja nepieciešams;
4. atveriet Izstrādātāja rīki → Stāvokļi;
5. pārliecinieties, ka katram MQTT elementam ir ticama vērtība, mērvienība, ierīces klase un stāvokļa klase.

Elementa vērtībai jāmainās pēc jauna ziņojuma saņemšanas tēmā device/{SN}/realtime.

6. darbība: pievienojiet importēto un eksportēto enerģiju Enerģijas panelim

Home Assistant Enerģijas panelim ir nepieciešami kumulatīvi enerģijas elementi. YAML piemēros tiek izmantots:

unit_of_measurement: "kWh"
device_class: energy
state_class: total_increasing

Dodieties uz Iestatījumi → Paneļi → Enerģija un atlasiet:

• IAMMETER Imported Energy (importētā enerģija) tīkla patēriņam;
• IAMMETER Exported Energy (eksportētā enerģija) atgriešanai tīklā.

Trīsfāžu skaitītājam izvēlieties elementu struktūru, kas atbilst instalācijai un Home Assistant paneļa dizainam. Varat parādīt fāžu enerģiju atsevišķi vai izveidot atbilstošu kopējo elementu, taču nesaskaitiet vērtības kopā, nepārliecinoties, kā skaitītājs ziņo fāžu un neto enerģiju izvēlētajā pieslēguma režīmā.

Neatlasiet aktīvās jaudas elementu, kas mērīts vatos, Enerģijas paneļa enerģijas laukā. Jauda ir momentāns lielums; panelim ir nepieciešami kumulatīvi kWh.

Izvēlieties MQTT publicēšanas intervālu

Pašreizējā IAMMETER programmaparatūra atbalsta MQTT publicēšanas intervālu līdz pat 2 sekundēm. Īsākais intervāls ne vienmēr ir labākais iestatījums.

Ieteicamie sākumpunkti:

Ņemiet vērā brokera jaudu, Home Assistant ierakstītāja pieaugumu, tīkla uzticamību un elementu skaitu. Ziņojums, kas satur daudzas fāžu vērtības, var atjaunināt vairākus Home Assistant sensorus vienlaikus.

Atbalstītie IAMMETER modeļi

Visi pašreizējie IAMMETER enerģijas skaitītāji atbalsta manuālo MQTT. To galvenā atšķirība Home Assistant ir datu apjoma struktūra un mērījumu kanālu skaits.

WEM3046T un WEM3046TE mēra ārējo CT 5 A sekundāro izeju. Lai iegūtu primārās puses vērtības, piemērojiet pareizo CT koeficientu. Tā ir mērīšanas sistēmas īpašība, nevis MQTT vai Home Assistant ierobežojums.

Problēmu novēršana

MQTT ziņojumi nenāk

• Pārbaudiet brokera adresi un portu skaitītāja WebUI.
• Pārliecinieties par lietotājvārdu un paroli.
• Pārbaudiet brokera žurnālus attiecībā uz autentifikācijas vai savienojuma kļūdām.
• Pārliecinieties, ka skaitītājs var sasniegt brokeri, izejot cauri ugunsmūra vai VLAN noteikumiem.
• Abonējiet device/{SN}/realtime ar neatkarīgu MQTT klientu.

Ziņojumi pienāk, bet Home Assistant elementi nav pieejami

• Pārliecinieties, ka Home Assistant ir savienots ar to pašu brokeri.
• Pārbaudiet precīzu tēmu un sērijas numuru.
• Salīdziniet Data un Datas ar faktisko datu apjomu.
• Pārbaudiet YAML atkāpes un veidnes.
• Pēc pārlādēšanas vai restartēšanas pārbaudiet Home Assistant žurnālus.

Daži elementi rāda nulli vai nepareizu mērījumu

• Nepārkopējiet vienfāzes Data veidni Datas datu apjomam.
• Pārbaudiet masīva pozīciju saskaņā ar JSON definīciju.
• Pārliecinieties par fāzes/kanāla indeksu.
• WEM3046T/WEM3046TE gadījumā pārliecinieties par ārējā CT koeficientu.

Enerģijas elementi trūkst Enerģijas panelī

Pārliecinieties par visiem trim laukiem:

unit_of_measurement: "kWh"
device_class: energy
state_class: total_increasing

Tāpat pārliecinieties, ka elements ir saņēmis derīgus skaitliskus datus un parādās Izstrādātāja rīki → Stāvokļi.

Parādās dublētas ierīces vai sensori

Manuālais MQTT un MQTT Discovery var izveidot atsevišķus elementus no viena un tā paša skaitītāja. Ja izmantojat YAML metodi, turiet HA MQTT Discovery izslēgtu, ja vien apzināti nevēlaties abus komplektus un neesat izplānojis unikālus elementu nosaukumus.

Saistītās rokasgrāmatas

• Publicēt IAMMETER datus savā MQTT brokerī
• Izmantot MQTT Discovery YAML vietā
• Salīdzināt visas IAMMETER–Home Assistant integrācijas metodes
• IAMMETER JSON datu definīcija
• Atjaunināt IAMMETER programmaparatūru

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