Интеграция энергомонитора Home Assistant: MQTT, Modbus TCP и IAMMETER-Link

Интеграция энергомонитора Home Assistant: MQTT, Modbus TCP и IAMMETER-Link

Энергомониторы IAMMETER можно интегрировать с Home Assistant через локальный HTTP, Modbus TCP или MQTT. Лучший метод зависит от того, предпочитаете ли вы официальную интеграцию, настройку через интерфейс, быстрые локальные обновления, автоматическое обнаружение MQTT или продолжение использования IAMMETER Cloud.

В этом руководстве сравниваются доступные методы и даются ссылки на соответствующие инструкции по настройке. Оно охватывает все текущие энергомониторы IAMMETER. Снятый с производства WEM3162 не включён.

Какую интеграцию Home Assistant следует использовать?

Метод	Настройка на счётчике	Настройка Home Assistant	Типичный интервал обновления	Полностью локально	IAMMETER Cloud одновременно	Автообнаружение	Для кого подходит
Home Assistant Core	Обеспечьте доступ счётчика в локальной сети	Добавьте встроенную интеграцию IAMMETER в YAML	30 секунд	Да	Да	Нет	Пользователи, предпочитающие официальную встроенную интеграцию
Home Assistant Modbus	Обеспечьте доступ Modbus TCP в локальной сети	Настройте встроенную интеграцию Modbus и датчики в YAML	Настраивается; обычно 1–5 секунд	Да	Да	Нет	Быстрый мониторинг и автоматизация в реальном времени
MQTT Manual	Настройте MQTT-брокер в веб-интерфейсе счётчика	Включите интеграцию MQTT и определите датчики в YAML	Настраивается; последняя прошивка поддерживает до 2 секунд	Да, с локальным брокером	Нет	Нет	Пользователям, которым нужны собственные топики и датчики
HACS HTTP	Обеспечьте доступ счётчика в локальной сети	Установите IAMMETER HTTP через HACS и настройте в интерфейсе	60 секунд	Да	Да	SSDP-помощь	Настройка через UI без YAML
HACS Modbus	Обеспечьте доступ Modbus TCP в локальной сети	Установите IAMMETER Modbus через HACS и настройте в интерфейсе	Настраивается; по умолчанию 3 секунды	Да	Да	SSDP-помощь	Быстрые локальные обновления с настройкой через UI
MQTT Discovery	Настройте брокер и включите HA MQTT Discovery в веб-интерфейсе счётчика	Включите интеграцию MQTT; датчики создаются автоматически	Настраивается; последняя прошивка поддерживает до 2 секунд	Да, с локальным брокером	Нет	Да	Самая простая настройка MQTT

Краткие рекомендации:

• Выберите Home Assistant Core, если вы хотите официальную встроенную интеграцию и интервала обновления в 30 секунд достаточно.
• Выберите HACS HTTP, если вы предпочитаете настройку через UI и не нуждаетесь в быстрых обновлениях.
• Выберите HACS Modbus, если вы хотите настройку через UI с более быстрыми локальными данными для панелей мониторинга и автоматизации.
• Выберите Home Assistant Modbus, если вы уверенно работаете с YAML и хотите полный контроль над регистрами, датчиками и интервалами опроса.
• Выберите MQTT Discovery, если вы уже используете MQTT и хотите, чтобы Home Assistant автоматически создавал устройство и сущности.
• Выберите MQTT Manual, если вам нужен полный контроль над топиками MQTT, шаблонами и определениями сущностей.

MQTT Manual и MQTT Discovery меняют режим загрузки счётчика на MQTT. В этих режимах счётчик не отправляет измерения одновременно в IAMMETER Cloud. Локальные интеграции HTTP и Modbus TCP могут продолжать работать, пока счётчик загружает данные в IAMMETER Cloud.

1. Официальная интеграция Home Assistant Core

Официальная интеграция IAMMETER включена в Home Assistant и считывает данные через локальный HTTP API счётчика. Она не требует HACS или подключения к интернету между Home Assistant и счётчиком.

Основные характеристики:

• настраивается в configuration.yaml;
• локальный HTTP-опрос каждые 30 секунд;
• может использоваться вместе с IAMMETER Cloud;
• сущности импортированной и экспортированной энергии включают метаданные, необходимые для Energy Dashboard Home Assistant;
• автоматическое обнаружение устройств отсутствует.

Используйте этот метод, когда стабильность и официальная поддержка Home Assistant важнее высокой частоты обновления.

• Официальная интеграция IAMMETER в Home Assistant

2. Интеграция Home Assistant Modbus TCP

Встроенная интеграция Modbus Home Assistant считывает локальные регистры Modbus TCP счётчика. Она подходит для автоматизации на основе мощности, управления избытком солнечной энергии и других приложений, требующих более быстрых обновлений.

Основные характеристики:

• настраивается в YAML;
• настраиваемый scan_interval, обычно 1–5 секунд для автоматизации в реальном времени;
• полностью локальная и независимая от интернета;
• может использоваться вместе с IAMMETER Cloud;
• требует правильного адреса регистра, типа данных, масштаба и метаданных Energy Dashboard.

Используйте более длинный интервал опроса, если данные с точностью до секунды не требуются. Избегайте запуска нескольких высокочастотных Modbus-клиентов к одному счётчику.

• Руководство по энергомонитору Home Assistant Modbus TCP
• Карта регистров Modbus TCP IAMMETER

3. Интеграция HACS HTTP

Пользовательская интеграция IAMMETER HTTP предоставляет альтернативу официальной YAML-интеграции с настройкой через UI. Она считывает /monitorjson по локальной сети и создаёт соответствующие сущности Home Assistant.

Основные характеристики:

• устанавливается через HACS;
• настраивается через UI Home Assistant «Устройства и службы»;
• локальный HTTP-опрос каждые 60 секунд;
• SSDP может помогать в обнаружении устройств;
• совместима с IAMMETER Cloud и Energy Dashboard.

Используйте этот метод, если вы предпочитаете настройку через UI и интервала обновления в одну минуту достаточно.

• Интеграция IAMMETER HACS HTTP
• Руководство по настройке HACS HTTP

4. Интеграция HACS Modbus

Пользовательская интеграция IAMMETER Modbus сочетает локальный опрос Modbus TCP с настройкой через UI Home Assistant. Это наиболее удобный вариант для пользователей, которым нужны более быстрые обновления, но не требуется определять каждый регистр в YAML.

Основные характеристики:

• устанавливается через HACS и настраивается в UI;

• настраиваемый интервал сканирования, по умолчанию 3 секунды в обновлённой интеграции;

• локальная работа и совместимость с IAMMETER Cloud;

• создаёт сущности мощности и импортированной/экспортированной энергии с соответствующими метаданными Home Assistant;

• поддерживает все текущие счётчики IAMMETER с разным количеством сущностей для однофазных и трёхфазных моделей.

• Интеграция IAMMETER HACS Modbus

• Руководство по настройке HACS Modbus

5. Ручная интеграция MQTT

В режиме Manual MQTT счётчик публикует данные измерений в ваш MQTT-брокер, а вы определяете соответствующие датчики в Home Assistant.

Настройка на стороне счётчика и настройка Home Assistant выполняются отдельно:

1. Настройте адрес брокера, порт, имя пользователя и пароль в последнем веб-интерфейсе счётчика.
2. Включите интеграцию MQTT в Home Assistant.
3. Определите необходимые MQTT-датчики и JSON-шаблоны в YAML.

Этот метод полезен, когда несколько приложений должны подписываться на одни и те же измерения, или когда нужны собственные топики и определения сущностей.

• Настройка энергомонитора IAMMETER с MQTT-сервером
• Ручная настройка энергомонитора MQTT для Home Assistant

6. Home Assistant MQTT Discovery

MQTT Discovery предназначен для пользователей, которые хотят минимальной ручной настройки. После настройки брокера и включения HA MQTT Discovery в веб-интерфейсе счётчика Home Assistant автоматически создаёт устройство IAMMETER и его сущности.

Создаваемые сущности импортированной и экспортированной энергии включают:

• unit_of_measurement: kWh;
• device_class: energy;
• state_class: total_increasing.

Эти атрибуты предоставляют метаданные, необходимые для использования в Energy Dashboard Home Assistant.

MQTT Discovery поддерживается всеми текущими энергомониторами IAMMETER. Однофазные и трёхфазные модели создают разное количество сущностей в соответствии со своими измерительными каналами.

• Настройка Home Assistant MQTT Discovery
• Руководство по IAMMETER MQTT Discovery
• Обновление до последней прошивки IAMMETER

Поддерживаемые энергомониторы IAMMETER

Все текущие энергомониторы IAMMETER поддерживают описанные выше методы интеграции. Основное различие в Home Assistant — количество фаз или измерительных каналов и, соответственно, количество создаваемых сущностей.

Модель	Типичное применение	Поддержка Home Assistant	Важное примечание
WEM3080	Однофазный мониторинг энергии	Все методы	Однофазные сущности
WEM2067	Однофазный мониторинг домашней солнечной системы	Все методы	Два измерительных канала
WEM3080T	Трёхфазный мониторинг энергии	Все методы	Трёхфазные сущности
WEM3050T	Трёхфазный или разделённый мониторинг дома	Все методы	Три измерительных канала
WEM3080TD	Трёхфазные/трёхпроводные и специальные схемы подключения	Все методы	Интерпретация сущностей зависит от режима подключения
WEM3046T / WEM3046TE	Трёхфазные измерения с внешними ТТ 5 А	Все методы	Примените коэффициент внешнего ТТ для получения значений первичной стороны

WEM3046T и WEM3046TE измеряют вторичный выход 5 А внешних трансформаторов тока. Применение коэффициента ТТ является требованием данной схемы измерения, а не ограничением совместимости с Home Assistant.

Использование сущностей энергии IAMMETER в Energy Dashboard

Energy Dashboard Home Assistant требует накопленных сущностей импортированной и экспортированной энергии в кВт·ч, обычно с:

• device_class: energy;
• state_class: total_increasing.

Текущие интеграции Core, HACS HTTP, HACS Modbus и MQTT Discovery предоставляют необходимые метаданные для своих сущностей импортированной/экспортированной энергии. При ручной настройке Modbus или Manual MQTT вы должны сами добавить правильные единицу измерения, класс устройства и класс состояния.

Не используйте сущность мгновенной мощности в ваттах как замену накопленной энергии в кВт·ч.

Отправка существующих данных энергии Home Assistant в IAMMETER Cloud

Описанные выше методы передают данные счётчика IAMMETER в Home Assistant. IAMMETER-Link работает в обратном направлении: он загружает сущности энергии, которые уже существуют в Home Assistant, в виртуальный счётчик IAMMETER и IAMMETER Cloud.

Это полезно, когда инвертор или сторонний счётчик уже имеют интеграцию с Home Assistant, но вы также хотите использовать панели мониторинга, отчёты или мультисайтовый доступ IAMMETER Cloud.

IAMMETER-Link в настоящее время предоставляет:

• настройку через HACS и UI;

• однофазное и трёхфазное отображение виртуальных счётчиков;

• интервал загрузки 300 секунд с IAMMETER Basic;

• интервал загрузки 60 секунд с IAMMETER Pro.

• Подключение устройств энергии Home Assistant к IAMMETER Cloud

• Репозиторий IAMMETER-Link на GitHub

Примеры мониторинга энергии с Home Assistant

После интеграции счётчика его данные о мощности в реальном времени и накопленной энергии могут использоваться для:

• мониторинга солнечной генерации, потребления дома и импорта/экспорта из сети;
• управления реле в реальном времени через Modbus TCP;
• панелей мониторинга Home Assistant и Grafana;
• зарядки электромобиля от избытка солнечной энергии;
• нагрева воды от избытка солнечной энергии.

Нужна помощь?

Если у вас есть вопросы о прошивке, настройке сущностей, настройке Energy Dashboard или выборе метода интеграции, посетите форум сообщества IAMMETER.