MQTT Discovery на Home Assistant за електромер

MQTT Discovery на Home Assistant за електромер

MQTT Discovery на Home Assistant позволява на електромера автоматично да създаде своето устройство и сензорни обекти. След като електромерът и Home Assistant се свържат към един и същ MQTT брокер, Home Assistant може да открие електромера без ръчен YAML за MQTT сензори.

IAMMETER поддържа MQTT Discovery на всички актуални електромери. В зависимост от модела Home Assistant създава обекти за напрежение, ток, активна мощност, внесена енергия, изнесена енергия и други налични измервания по фази или канали.

Използвайте този метод, когато искате:

• локален MQTT мониторинг на енергията;
• автоматично създаване на устройство и обекти;
• по-бързи обновявания от HTTP интеграциите;
• обекти за внесена/изнесена енергия, съвместими с Energy Dashboard;
• минимална конфигурация на Home Assistant.

Ако ви трябва пълен контрол върху темите, шаблоните, имената на обектите и метаданните, използвайте вместо това Ръководството за ръчен MQTT електромер.

MQTT Discovery срещу ръчен MQTT

И двата метода изискват MQTT брокер, но само Discovery създава автоматично обекти в Home Assistant.

Не активирайте Discovery и не дефинирайте ръчно същите измервания едновременно, освен ако умишлено не искате два отделни набора от обекти.

Изисквания

Нужни са ви:

• електромер IAMMETER с фърмуер i.76.058.8 или по-нов;
• MQTT брокер, достъпен от електромера и от Home Assistant;
• адрес, порт, потребителско име и парола на брокера;
• Home Assistant с активирана MQTT Integration.

Фърмуер i.76.058.8 е стабилната базова версия за MQTT Discovery. По-ранният образ i.76.02 беше тестов фърмуер и вече не трябва да се инсталира или да се посочва като препоръчана версия.

За актуалните поправки и най-новите MQTT опции надградете до най-новия фърмуер на IAMMETER.

Стъпка 1: Свързване на Home Assistant към MQTT брокера

Ако Home Assistant още не е свързан към брокера:

1. Отворете Settings → Devices & services.
2. Изберете Add integration.
3. Потърсете MQTT.
4. Въведете адреса, порта, потребителското име и паролата на брокера.
5. Потвърдете, че MQTT Integration се свързва успешно.

Ако Home Assistant вече използва желания брокер, запазете съществуващата MQTT Integration. Не създавайте втора връзка към брокера за устройството IAMMETER.

MQTT Discovery е активиран по подразбиране при нормална MQTT настройка на Home Assistant. Ако discovery е бил изключен или се използва префикс за discovery, различен от стандартния, уверете се, че електромерът и Home Assistant използват съвместими настройки.

Стъпка 2: Конфигуриране на MQTT Discovery в WebUI на електромера

Отворете локалния WebUI на електромера и отидете в Settings. Конфигурирайте:

Запазете настройките и оставете електромера да се рестартира или да се свърже отново.

Най-новият фърмуер показва необходимите настройки в WebUI. Няма нужда да се извиква историческият endpoint /api/mqttha?x=1.

Опцията HA MQTT Discovery е специално за автоматичното откриване от Home Assistant. За общ брокер, персонализирана система, Node-RED flow или ръчна MQTT конфигурация я оставете изключена и използвайте стандартния формат за MQTT публикуване на електромера.

Стъпка 3: Потвърждаване, че Home Assistant открива електромера

След като електромерът се свърже към брокера:

1. Отворете Settings → Devices & services → MQTT.
2. Потърсете новооткрито устройство IAMMETER.
3. Отворете устройството и прегледайте обектите.
4. Потвърдете, че стойностите за напрежение, ток, мощност и енергия са правдоподобни.
5. Проверете дали присъства очакваният брой фази или измервателни канали.

Конфигурацията за discovery и състоянието на измерванията се изпращат през различни MQTT теми. Home Assistant използва конфигурацията за discovery, за да създаде обектите, а след това обновява стойностите им, когато пристигнат съобщения за състояние.

Ако устройството не се появи, рестартирайте само след като проверите връзката с брокера и темите. Рестартирането на Home Assistant не може да поправи грешен адрес на брокера или отхвърлени MQTT идентификационни данни.

Поддръжка на Energy Dashboard

Актуалните MQTT Discovery payload-и на IAMMETER включват необходимите метаданни за обектите за внесена и изнесена енергия:

unit_of_measurement: kWh
device_class: energy
state_class: total_increasing

IAMMETER използва компактните MQTT Discovery ключове, съответстващи на тези полета, включително:

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

След като обектите получат валидни данни:

1. отидете в Settings → Dashboards → Energy;
2. изберете обекта за внесена енергия за потребление от мрежата;
3. изберете обекта за изнесена енергия за връщане към мрежата;
4. запазете конфигурацията на Energy Dashboard.

Не избирайте обект за моментна активна мощност във ватове за поле за енергия. Energy Dashboard изисква кумулативна kWh.

Еднофазните и трифазните модели създават различни енергийни обекти. Изберете обектите, които съответстват на окабеляването на електромера и на начина, по който инсталацията измерва вноса/износа към мрежата.

Избор на интервал за MQTT обновяване

Най-новият фърмуер на IAMMETER поддържа MQTT обновявания до 2 секунди. По-краткият интервал дава на Home Assistant по-актуални стойности за мощността, но създава и повече трафик към брокера, обновявания на обектите и данни в recorder.

Предложени начални стойности:

Използвайте най-краткия интервал само когато автоматизацията има полза от него. Обобщените стойности в Energy Dashboard обикновено не изискват обновяване на две секунди.

Съвместимост с IAMMETER Cloud

MQTT Discovery променя Run Mode на електромера на MQTT. Електромерът изпраща измерванията си към конфигурирания брокер и не ги качва едновременно в IAMMETER Cloud.

Ако ви трябват едновременно Home Assistant и IAMMETER Cloud от един и същ електромер, изберете вместо това локална HTTP или Modbus TCP интеграция. Тези методи четат електромера локално, докато нормалното му качване в Cloud продължава.

Сравнете опциите в Преглед на интеграциите на електромер с Home Assistant.

Поддържани модели IAMMETER

Всички актуални електромери IAMMETER поддържат MQTT Discovery. Основната разлика е броят на фазите/каналите и следователно броят на създадените обекти.

WEM3046T и WEM3046TE измерват вторичния изход 5 A на външни токови трансформатори. Трябва да се приложи правилното съотношение на CT, за да се получат ток, мощност и енергия от първичната страна. Това е изискване на измервателната система, а не ограничение на Home Assistant или MQTT Discovery.

Спреният от производство WEM3162 не е включен в текущия обхват на съвместимост.

Отстраняване на проблеми с MQTT Discovery

Home Assistant не открива електромера

• Потвърдете, че електромерът и Home Assistant използват един и същ брокер.
• Проверете адреса, порта, потребителското име и паролата на брокера.
• Потвърдете, че HA MQTT Discovery е активиран в WebUI на електромера.
• Проверете логовете на брокера за отказани връзки или грешки при оторизация.
• Уверете се, че MQTT Integration на Home Assistant е свързана.
• Абонирайте се за префикса за discovery на Home Assistant в брокера с MQTT клиент и проверете дали има конфигурационни съобщения.

Устройството се появява, но обектите са недостъпни

• Потвърдете, че електромерът продължава да публикува съобщения за състояние след конфигурацията за discovery.
• Проверете дали защитна стена, VLAN или ACL на брокера позволява както темите за discovery, така и темите за състояние.
• Уверете се, че електромерът не е преминал към друг брокер.
• Надградете до най-новия фърмуер и се свържете отново.

Внесената/изнесената енергия не може да се избере в Energy Dashboard

• Потвърдете, че обектът е получил валидна числова стойност в kWh.
• Отворете Developer tools → States и прегледайте мерната единица, device class и state class.
• Премахнете остарелите обекти, създадени от ранния тестов фърмуер, преди да оценявате текущия discovery payload.
• Потвърдете, че избирате енергиен обект, а не обект за активна мощност.

Появяват се дублиращи се MQTT обекти

Дубликати обикновено се появяват, когато:

• ръчният MQTT YAML и MQTT Discovery са активни едновременно;
• серийният номер на електромера или уникалният ID за discovery се е променил;
• ранен фърмуер е публикувал различна конфигурация за discovery;
• в брокера са останали retained теми за discovery от стара конфигурация.

Изберете или ръчен MQTT, или MQTT Discovery за същите измервания, след което премахнете остарялата конфигурация.

Премахване на стари retained Discovery обекти

Конфигурационните съобщения на MQTT Discovery обикновено се запазват (retained) от брокера, за да може Home Assistant да пресъздаде обектите след рестарт. Ако стара конфигурационна тема остане, изтриването на устройството само в интерфейса на Home Assistant може да не е достатъчно — обектът може да се върне, когато запазената конфигурация бъде получена отново.

Безопасна процедура за изчистване:

1. Изключете HA MQTT Discovery на електромера или го изключете временно от мрежата, за да не публикува веднага отново старата конфигурация.
2. Използвайте MQTT клиент, за да прегледате префикса за discovery на Home Assistant, обикновено homeassistant/#.
3. Идентифицирайте само конфигурационните теми, принадлежащи на засегнатия сериен номер/устройство IAMMETER.
4. Публикувайте празен retained payload към всяка остаряла конфигурационна тема.
5. Премахнете остарялото устройство/обекти от Home Assistant, ако останат.
6. Активирайте отново Discovery на актуалния фърмуер.
7. Потвърдете, че се създават едно устройство и очакваните актуални обекти.

Не изтривайте цялото дърво от retained теми homeassistant/# на споделен брокер. Това може да премахне конфигурацията за discovery на несвързани устройства.

Кога ръчният MQTT е по-добрият избор

Използвайте ръчен MQTT вместо това, когато ви трябват:

• персонализирани имена на обекти и уникални ID;
• персонализирани JSON шаблони или изчисления;
• само избран поднабор от измервания;
• структура на темите, споделена с приложения извън Home Assistant;
• явен контрол върху device class и state class;
• съвместимост със система, в която Home Assistant Discovery е умишлено изключен.

Свързани ръководства

• Ръчна MQTT конфигурация на електромер за Home Assistant
• Публикуване на данни от IAMMETER към MQTT брокер
• Сравнение на всички методи за интеграция IAMMETER–Home Assistant
• Надграждане до най-новия фърмуер на IAMMETER
• Документация на Home Assistant за MQTT

Актуализирано: 19 юли 2026 г.