Интеграция ZONT с Home Assistant MQTT: различия между версиями

Материал из Библиотека 

Микро Лайн
Нет описания правки
Нет описания правки
 
(не показано 5 промежуточных версий этого же участника)
Строка 1: Строка 1:
<span>
<span id="BackToTop"></span>
<div class="noprint" style="background-color:#0a488b; text-decoration: #ffffff; border-radius: 10px; position:fixed; bottom:3%; left:2%; padding:2px 20px; margin:0;">
[[#top|<font color="white"><big>Наверх</big></font>]]
</div>
===Установка Zigbee2MQTT для ZONT===
===Установка Zigbee2MQTT для ZONT===
Программа '''Zigbee2MQTT''' позволяет подключить '''Zigbee-устройства''' (датчики, розетки, лампы, реле) к личному кабинету '''ZONT'''.
Программа '''Zigbee2MQTT''' позволяет подключить '''Zigbee-устройства''' (датчики, розетки, лампы, реле) к личному кабинету '''ZONT'''.
Строка 23: Строка 29:


*Компьютер с 64-разрядной Windows 10 или новее.
*Компьютер с 64-разрядной Windows 10 или новее.
*Zigbee-стик, вставленный в USB-порт (рекомендуем стик Zigbee 3.0 на базе TICC2652P).
*Zigbee-стик*, вставленный в USB-порт (рекомендуем стик Zigbee 3.0 на базе TICC2652P).
*Логин и пароль от личного кабинета ZONT.
*Логин и пароль от личного кабинета ZONT.
*Прибор типа «Home Assistant», заранее добавленный в приложении ZONT. Если такого прибора нет, установщик остановится и сообщит об этом.
*Прибор типа «Home Assistant», заранее добавленный в приложении ZONT. Если такого прибора нет, установщик остановится и сообщит об этом.
Строка 106: Строка 112:


====Как отключить фоновый режим====
====Как отключить фоновый режим====
Щёлкните по файлу <span style="background-color: #D3D3D3;">Uninstall-Zigbee2MQTT-Service.bat</span> правой кнопкой мыши и выберите «'''Запуск от имени администратора'''». Программа перестанетзапускаться сама, а её настройки и список Zigbee-устройств останутся на месте.
Щёлкните по файлу <span style="background-color: #D3D3D3;">Uninstall-Zigbee2MQTT-Service.bat</span> правой кнопкой мыши и выберите «'''Запуск от имени администратора'''». Программа перестанет запускаться сама, а её настройки и список Zigbee-устройств останутся на месте.


<hr>
<hr>
Строка 125: Строка 131:


Прибор Home Assistant в личном кабинете ZONT удаление не затрагивает — если он больше не нужен, удалите его в приложении ZONT.
Прибор Home Assistant в личном кабинете ZONT удаление не затрагивает — если он больше не нужен, удалите его в приложении ZONT.
<hr>


===Если что-то пошло не так===
===Если что-то пошло не так===
Строка 135: Строка 143:
Приложите нужный файл к обращению в техническую поддержку ZONT — по нему причина видна почти всегда.
Приложите нужный файл к обращению в техническую поддержку ZONT — по нему причина видна почти всегда.


Если Zigbee2MQTT работает в фоне, поддержка может попросить ещё и журнал самой программы. Он лежит в папке '''%LOCALAPPDATA%\Zigbee2MQTT\logs''': скопируйтеэтот адрес в адресную строку проводника и нажмите Enter.
Если Zigbee2MQTT работает в фоне, поддержка может попросить ещё и журнал самой программы. Он лежит в папке '''%LOCALAPPDATA%\Zigbee2MQTT\logs''': скопируйте этот адрес в адресную строку проводника и нажмите Enter.


'''Частые случаи и что делать:'''
'''Частые случаи и что делать:'''
Строка 143: Строка 151:
!Что это значит
!Что это значит
|-
|-
|«'''Установка требует правадминистратора'''»
|«'''Установка требует прав администратора'''»
|Файл запущен обычным двойным щелчком.  
|Файл запущен обычным двойным щелчком.  
Закройте окно и запустите правой кнопкой мыши через «'''Запуск от имени администратора'''».
Закройте окно и запустите правой кнопкой мыши через «'''Запуск от имени администратора'''».
Строка 150: Строка 158:
|Проверьте данные на сайте ZONT. После трёх неудачных попыток установка прервётся.
|Проверьте данные на сайте ZONT. После трёх неудачных попыток установка прервётся.
|-
|-
|«'''В аккаунте нет ни одногоприбора Home Assistant'''»
|«'''В аккаунте нет ни одного прибора Home Assistant'''»
|Сначала добавьте прибор в приложении ZONT, затем запустите установку заново.
|Сначала добавьте прибор в приложении ZONT, затем запустите установку заново.
|-
|-
Строка 187: Строка 195:
При входе на <span style="background-color: #D3D3D3;"><nowiki>http://localhost:3097</nowiki></span> интерфейс по умолчанию на английском языке. Нажмите на кнопку '''en''', чтобы открыть меню выбора доступных языков
При входе на <span style="background-color: #D3D3D3;"><nowiki>http://localhost:3097</nowiki></span> интерфейс по умолчанию на английском языке. Нажмите на кнопку '''en''', чтобы открыть меню выбора доступных языков


[[Файл:1 start.png|877x877пкс]]
[[Файл:1 start.png|972x972px]]


Выберите из списка <span style="background-color: #D3D3D3;">Русский</span>.
Выберите из списка <span style="background-color: #D3D3D3;">Русский</span>.


[[Файл:2 lang.png]]
[[Файл:2 lang.png|972x972пкс]]


Перейдите во вкладку <span style="background-color: #D3D3D3;">Устройства</span> и нажмите кнопку <span style="background-color: #D3D3D3;">Разрешить подключение</span>.
Перейдите во вкладку <span style="background-color: #D3D3D3;">Устройства</span> и нажмите кнопку <span style="background-color: #D3D3D3;">Разрешить подключение</span>.


[[Файл:3 search.png]]
[[Файл:3 search.png|971x971пкс]]


Чтобы перевести Zigbee устройство в режим поиска следуйте инструкции производителя (возможные варианты: зажатие кнопки или её тройное нажатие, зажатие скрытого переключателя в отверстии для скрепки). После этого световой индикатор начнет мигать, и устройство появится в веб-интерфейсе Zigbee2MQTT. После этого можно вручную отключить присоединение устройств нажав на <span style="background-color: #D3D3D3;">Запретить присоединение</span>.
Чтобы перевести Zigbee устройство в режим поиска следуйте инструкции производителя (возможные варианты: зажатие кнопки или её тройное нажатие, зажатие скрытого переключателя в отверстии для скрепки). После этого световой индикатор начнет мигать, и устройство появится в веб-интерфейсе Zigbee2MQTT. После этого можно вручную отключить присоединение устройств нажав на <span style="background-color: #D3D3D3;">Запретить присоединение</span>.


[[Файл:4 joined.png|877x877пкс]]
[[Файл:4 joined.png|972x972px]]


Программа автоматически направит всю информацию о датчике на сервера ZONT. После обновления главного экрана дома с устройством Home Assistant, в приложении ZONT появятся доступные компоненты добавленного датчика.
Программа автоматически направит всю информацию о датчике на сервера ZONT. После обновления главного экрана дома с устройством Home Assistant, в приложении ZONT появятся доступные компоненты добавленного датчика.
Строка 216: Строка 224:


[[Файл:8 final.png]]
[[Файл:8 final.png]]
<hr>


===Техническим специалистам===
===Техническим специалистам===
Раздел описывает обмен по протоколу MQTT в сервисе ZONT.
<hr>
====Брокер====
1. Поддерживаются протоколы MQTT 3.1.1 и 5.0.
2. Подключены аутентификация и авторизация. Регистрация в брокере доступна через новое приложение ZONT.
3. Публикация сообщений MQTT 3.1.1 в топики, на которые клиент не авторизован, не приводит к разрыву соединения — такие сообщения игнорируются.
4. Передача от клиентов — не чаще 1 сообщения в секунду и не более 1 МБ.
5. Глубина топика — не более 15 элементов (не более 14 символов  <span style="background-color: #D3D3D3;">/</span>  ).
6. Хранение сессий отключено: сообщения, не доставленные получателю, в очередях брокера не остаются.
7. Retain-сообщения отключены — флаг игнорируется на уровне брокера. Само сообщение доставляется всем получателям, которые находятся на связи.
<hr>
====Полезная нагрузка====
Формат соответствует [https://www.home-assistant.io/integrations/mqtt/ интеграциям Home Assistant MQTT]. На 19.08.2026 поддерживаются:
{| class="wikitable"
|+
!Интеграция
!Что описывает
|-
|<span style="background-color: #D3D3D3;">binary_sensor</span>
|дискретные датчики
|-
|<span style="background-color: #D3D3D3;">button</span>
|кнопки
|-
|<span style="background-color: #D3D3D3;">climate</span>
|контуры отопления и их режимы
|-
|<span style="background-color: #D3D3D3;">light</span>
|освещение
|-
|<span style="background-color: #D3D3D3;">lock</span>
|замки
|-
|<span style="background-color: #D3D3D3;">number</span>
|регуляторы
|-
|<span style="background-color: #D3D3D3;">select</span>
|селекторы и многопозиционные переключатели
|-
|<span style="background-color: #D3D3D3;">sensor</span>
|измерительные датчики
|-
|<span style="background-color: #D3D3D3;">switch</span>
|переключатели
|}
<hr>
====MQTT Discovery====
Сообщения MQTT Discovery сообщают серверу информацию об устройстве и правилах взаимодействия с ним. Топик должен начинаться с префикса <span style="background-color: #D3D3D3;">ZONT/<user_id>/<device_id>/</span> и заканчиваться суффиксом <span style="background-color: #D3D3D3;">/config</span> :
<span style="background-color: #D3D3D3;">ZONT/102645/469742/sensor/9FF5B6BCEC40/8207/config</span>
*поля <span style="background-color: #D3D3D3;">availability</span> игнорируются: устройство считается вышедшим на связь после успешной аутентификации клиента в брокере;
*в <span style="background-color: #D3D3D3;">value_template</span> из соображений безопасности поддерживаются только простейшие значения — извлечение ключей JSON, например <span style="background-color: #D3D3D3;"><nowiki>{{value_json.temperature }}</nowiki></span>. Любые преобразования и сценарии недоступны;
*<span style="background-color: #D3D3D3;">message_expiry_interval</span> игнорируется: все способы персистентного хранения сообщений в брокере отключены.

Текущая версия от 11:15, 24 сентября 2026

Наверх

Установка Zigbee2MQTT для ZONT

Программа Zigbee2MQTT позволяет подключить Zigbee-устройства (датчики, розетки, лампы, реле) к личному кабинету ZONT.

Windows

Установочный скрипт для Windows делает всё сам: ставит драйверы адаптера, саму программу и настраивает подключение к облаку ZONT по вашему логину и паролю. Вводить адреса серверов и пароли брокера вручную не нужно.

Linux и macOS

На Linux и macOS ставьте Zigbee2MQTT по официальной инструкции — запуск в Docker.

Учётные данные для подключения к облачному брокеру можно скопировать из настроек прибора «Home Assistant» (раздел Данные для подключения) в приложении ZONT.

Creds.png

Дополнительная информация в разделе «Техническим специалистам».

Что понадобится

  • Компьютер с 64-разрядной Windows 10 или новее.
  • Zigbee-стик*, вставленный в USB-порт (рекомендуем стик Zigbee 3.0 на базе TICC2652P).
  • Логин и пароль от личного кабинета ZONT.
  • Прибор типа «Home Assistant», заранее добавленный в приложении ZONT. Если такого прибора нет, установщик остановится и сообщит об этом.
  • Права администратора на компьютере.
  • Подключение к интернету.
  • Скачать скрипты установки для Windows.

* Пример стика: Zigbee RF-DG-52PAS CC2652P USB

Как установить

  1. Вставьте Zigbee-стик в USB-порт компьютера.
  2. Извлеките файлы из скачанного архива z2m-setup.zip
  3. Щёлкните по файлу Install-Zigbee2MQTT.bat правой кнопкой мыши и выберите «Запуск от имени администратора».
  4. Дождитесь окончания. Установка идёт в одном окне и занимает от 5 до 20 минут в зависимости от скорости интернета.
  5. В случае каких-либо ошибок вам будет выведено их описание и наиболее вероятные способы исправления.
  6. Скрипт установки можно перезапускать повторно.

Что попросит установщик

За всю установку вас спросят только о трёх вещах, и все три — в самом начале.

Логин и пароль от личного кабинета ZONT. Пароль при вводе не отображается — это нормально, просто наберите его и нажмите Enter. Если в вашем аккаунте включена двухфакторная аутентификация, установщик дополнительно попросит код.

Прибор. Если в аккаунте один прибор Home Assistant, он выберется автоматически. Если несколько — появится список, введите номер строки:

В аккаунте несколько приборов Home Assistant. Выберите тот, к которому подключается Zigbee2MQTT:

1) Дом

2) Дача

Введите номер прибора из списка:

Zigbee-стик. Если адаптер в компьютере один, он определится сам. Если портов несколько — выберите из списка тот, в который вставлен адаптер.

Дальше вмешательство не потребуется: остальные этапы пройдут без вопросов.

После установки

При первом запуске Windows может спросить, разрешить ли Zigbee2MQTT доступ к сети. Нажмите «Разрешить доступ» — без этого не откроется веб-интерфейс.

Firewall.png

В конце установки в окне побегут строки — это Zigbee2MQTT запускается. Когда он заработает, внизу появится сообщение «ZIGBEE2MQTT ЗАПУЩЕН ИРАБОТАЕТ» с адресом веб-интерфейса:

http://localhost:3097

Cmd.png

Дальше в этом окне появляются только сообщения об ошибках, если они будут.

Откройте адрес в браузере: в веб-интерфейсе добавляют Zigbee-устройства в сеть и смотрят их состояние. Устройства, добавленные в Zigbee2MQTT, появляются в приложении ZONT автоматически.

Как запускать Zigbee2MQTT в фоне

Пока Zigbee2MQTT запущен из окна установки, он работает только с открытым окном: закрыли окно — связь с Zigbee-устройствами прекратилась. Чтобы программа работала сама по себе и включалась вместе с компьютером, щёлкните по файлу Install-Zigbee2MQTT-Service.bat правой кнопкой мыши и выберите «Запуск от имени администратора».

После этого:

  • программа запускается при включении компьютера, ещё до входа в Windows;
  • окно держать открытым не нужно, веб-интерфейс работает как обычно;
  • если программа даст сбой, Windows запустит её заново сама.

Запускать этот файл нужно уже после основной установки: пока Zigbee2MQTT не установлен, запускать в фоне нечего.

Окно с запущенным Zigbee2MQTT скрипт закроет сам: Zigbee-стик может использовать только одна копия программы.

Если Zigbee2MQTT перестал отвечать

Щёлкните по файлу Install-Zigbee2MQTT-Service.bat правой кнопкой мыши и выберите «Запуск от имени администратора» ещё раз. Повторный запуск безопасен: он перезапустит программу и ничего не сотрёт.

Как отключить фоновый режим

Щёлкните по файлу Uninstall-Zigbee2MQTT-Service.bat правой кнопкой мыши и выберите «Запуск от имени администратора». Программа перестанет запускаться сама, а её настройки и список Zigbee-устройств останутся на месте.

Как изменить настройки позже

Запустите Install-Zigbee2MQTT.bat ещё раз тем же способом. Уже установленные компоненты повторно не скачиваются — установщик сразу перейдёт к выбору прибора и адаптера. Прошлый выбор будет предложен по умолчанию: чтобы оставить его, достаточно нажать Enter.

Как удалить Zigbee2MQTT

Щёлкните по файлу Uninstall-Zigbee2MQTT.bat правой кнопкой мыши и выберите «Запуск от имени администратора».

Скрипт снимет службу Windows (если был включён фоновый режим), остановит программу и удалит её вместе с настройками. Про Node.js он спросит отдельно: им могут пользоваться другие программы на компьютере, поэтому по умолчанию Node.js остаётся. Чтобы удалить и его, ответьте «да».

Драйверы USB-адаптеров остаются в системе всегда: их используют не только Zigbee-стики, но и платы Arduino, программаторы и переходники USB-COM.

Вместе с программой стирается база Zigbee-сети: после повторной установки все Zigbee-устройства придётся подключать заново.

Прибор Home Assistant в личном кабинете ZONT удаление не затрагивает — если он больше не нужен, удалите его в приложении ZONT.

Если что-то пошло не так

В самом начале каждый файл показывает свою версию (например, версия 2026.9.1) — назовите её при обращении в поддержку, она же записана в журнале.

Рядом с файлом Install-Zigbee2MQTT.bat установщик создаёт файл log.txt c подробностями последнего запуска, а удаление пишет log-uninstall.txt.

Настройка фонового режима пишет log-service.txt, отключение — log-service-uninstall.txt.

Приложите нужный файл к обращению в техническую поддержку ZONT — по нему причина видна почти всегда.

Если Zigbee2MQTT работает в фоне, поддержка может попросить ещё и журнал самой программы. Он лежит в папке %LOCALAPPDATA%\Zigbee2MQTT\logs: скопируйте этот адрес в адресную строку проводника и нажмите Enter.

Частые случаи и что делать:

Что на экране Что это значит
«Установка требует прав администратора» Файл запущен обычным двойным щелчком.

Закройте окно и запустите правой кнопкой мыши через «Запуск от имени администратора».

«Неверный логин или пароль» Проверьте данные на сайте ZONT. После трёх неудачных попыток установка прервётся.
«В аккаунте нет ни одного прибора Home Assistant» Сначала добавьте прибор в приложении ZONT, затем запустите установку заново.
«Сервер ZONT не отвечает» Подключение блокирует антивирус, брандмауэр или провайдер.

Проверьте, открывается ли сайт ZONT в браузере на этом компьютере.

«Zigbee2MQTT запустился в фоне и сразу остановился» Чаще всего Zigbee-стик занят или выбран не тот COM-порт.

Порядок действий — в разделе «Если адаптер занят» ниже.

«В системе уже есть служба Zigbee2MQTT» Службу с таким именем создала другая программа. Скрипт её не трогает, чтобы ничего не сломать.
«Адаптер на порту COM…чем-то занят» Установщик пробует освободить адаптер сам.

Если не помогло — порядок действий в разделе «Если адаптер занят» ниже.

Если адаптер занят

Zigbee-стик может использовать только одна программа за раз. Если в окне написано, что адаптер занят, выполняйте по порядку и после каждого шага запускайте файл заново (правой кнопкой мыши — «Запуск от имени администратора»):

1. Извлеките адаптер из USB и вставьте его заново. Помогает чаще всего: Windows заново подключает устройство и отпускает его.

2. Подключите адаптер к другому USB-порту компьютера.

3. Закройте программы, которые могут работать с адаптером — другую копию Zigbee2MQTT, программы настройки Zigbee-стика, монитор COM-порта.

4. Перезагрузите компьютер.

Базовая информация по добавлению устройств Zigbee

При входе на http://localhost:3097 интерфейс по умолчанию на английском языке. Нажмите на кнопку en, чтобы открыть меню выбора доступных языков

1 start.png

Выберите из списка Русский.

2 lang.png

Перейдите во вкладку Устройства и нажмите кнопку Разрешить подключение.

3 search.png

Чтобы перевести Zigbee устройство в режим поиска следуйте инструкции производителя (возможные варианты: зажатие кнопки или её тройное нажатие, зажатие скрытого переключателя в отверстии для скрепки). После этого световой индикатор начнет мигать, и устройство появится в веб-интерфейсе Zigbee2MQTT. После этого можно вручную отключить присоединение устройств нажав на Запретить присоединение.

4 joined.png

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

5 result.png

Имя плитки по умолчанию максимально наполняется данными, чтобы была понятна принадлежность компонента к устройству. Переименование доступно в настройках устройства Home Assistant, разделы Управление, Оборудование, Отопление.

6 rename.png

Ненужные плитки можно скрыть в настройках дома, раздел Главный экран.

7 visible.png

Итоговый вид на главном экране дома.

8 final.png

Техническим специалистам

Раздел описывает обмен по протоколу MQTT в сервисе ZONT.

Брокер

1. Поддерживаются протоколы MQTT 3.1.1 и 5.0.

2. Подключены аутентификация и авторизация. Регистрация в брокере доступна через новое приложение ZONT.

3. Публикация сообщений MQTT 3.1.1 в топики, на которые клиент не авторизован, не приводит к разрыву соединения — такие сообщения игнорируются.

4. Передача от клиентов — не чаще 1 сообщения в секунду и не более 1 МБ.

5. Глубина топика — не более 15 элементов (не более 14 символов / ).

6. Хранение сессий отключено: сообщения, не доставленные получателю, в очередях брокера не остаются.

7. Retain-сообщения отключены — флаг игнорируется на уровне брокера. Само сообщение доставляется всем получателям, которые находятся на связи.

Полезная нагрузка

Формат соответствует интеграциям Home Assistant MQTT. На 19.08.2026 поддерживаются:

Интеграция Что описывает
binary_sensor дискретные датчики
button кнопки
climate контуры отопления и их режимы
light освещение
lock замки
number регуляторы
select селекторы и многопозиционные переключатели
sensor измерительные датчики
switch переключатели

MQTT Discovery

Сообщения MQTT Discovery сообщают серверу информацию об устройстве и правилах взаимодействия с ним. Топик должен начинаться с префикса ZONT/<user_id>/<device_id>/ и заканчиваться суффиксом /config :

ZONT/102645/469742/sensor/9FF5B6BCEC40/8207/config

  • поля availability игнорируются: устройство считается вышедшим на связь после успешной аутентификации клиента в брокере;
  • в value_template из соображений безопасности поддерживаются только простейшие значения — извлечение ключей JSON, например {{value_json.temperature }}. Любые преобразования и сценарии недоступны;
  • message_expiry_interval игнорируется: все способы персистентного хранения сообщений в брокере отключены.
Источник — http://support.microline.ru/index.php?title=Интеграция_ZONT_с_Home_Assistant_MQTT&oldid=13115