Интеграция ZONT с Home Assistant MQTT: различия между версиями
Материал из Библиотека
Микро Лайн
Admin (обсуждение | вклад) Нет описания правки |
Admin (обсуждение | вклад) Нет описания правки |
||
| (не показано 16 промежуточных версий этого же участника) | |||
| Строка 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'''. | ||
| Строка 16: | Строка 22: | ||
[[Файл:Creds.png]] | [[Файл:Creds.png]] | ||
Дополнительная информация в разделе | Дополнительная информация в разделе «[[Интеграция ZONT с Home Assistant MQTT#Техническим специалистам|Техническим специалистам]]». | ||
<hr> | <hr> | ||
| Строка 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. Если такого прибора нет, установщик остановится и сообщит об этом. | ||
| Строка 43: | Строка 49: | ||
#Скрипт установки можно перезапускать повторно. | #Скрипт установки можно перезапускать повторно. | ||
==== Что попросит установщик ==== | <hr> | ||
====Что попросит установщик==== | |||
За всю установку вас спросят только о трёх вещах, и все три — в самом начале. | За всю установку вас спросят только о трёх вещах, и все три — в самом начале. | ||
| Строка 49: | Строка 57: | ||
'''Прибор.''' Если в аккаунте один прибор Home Assistant, он выберется автоматически. Если несколько — появится список, введите номер строки: | '''Прибор.''' Если в аккаунте один прибор Home Assistant, он выберется автоматически. Если несколько — появится список, введите номер строки: | ||
{| class="wikitable" | |||
|+ | |||
|В аккаунте несколько приборов Home Assistant. Выберите тот, к которому подключается Zigbee2MQTT: | |||
1) Дом | 1) Дом | ||
| Строка 56: | Строка 65: | ||
2) Дача | 2) Дача | ||
Введите номер прибора из списка: | Введите номер прибора из списка: | ||
|} | |||
'''Zigbee-стик.''' Если адаптер в компьютере один, он определится сам. Если портов несколько — выберите из списка тот, в который вставлен адаптер. | '''Zigbee-стик.''' Если адаптер в компьютере один, он определится сам. Если портов несколько — выберите из списка тот, в который вставлен адаптер. | ||
Дальше вмешательство не потребуется: остальные этапы пройдут без вопросов. | Дальше вмешательство не потребуется: остальные этапы пройдут без вопросов. | ||
<hr> | |||
====После установки==== | |||
При первом запуске Windows может спросить, разрешить ли Zigbee2MQTT доступ к сети. Нажмите «'''Разрешить доступ'''» — без этого не откроется веб-интерфейс. | |||
[[Файл:Firewall.png|601x601пкс]] | |||
В конце установки в окне побегут строки — это '''Zigbee2MQTT''' запускается. Когда он заработает, внизу появится сообщение '''«ZIGBEE2MQTT ЗАПУЩЕН ИРАБОТАЕТ»''' с адресом веб-интерфейса: | |||
<span style="background-color: #D3D3D3;"><nowiki>http://localhost:3097</nowiki></span> | |||
[[Файл:Cmd.png]] | |||
Дальше в этом окне появляются только сообщения об ошибках, если они будут. | |||
Откройте адрес в браузере: в веб-интерфейсе добавляют Zigbee-устройства в сеть и смотрят их состояние. Устройства, добавленные в Zigbee2MQTT, появляются в приложении ZONT автоматически. | |||
<hr> | |||
===Как запускать Zigbee2MQTT в фоне=== | |||
Пока Zigbee2MQTT запущен из окна установки, он работает только с открытым окном: закрыли окно — связь с Zigbee-устройствами прекратилась. Чтобы программа работала сама по себе и включалась вместе с компьютером, щёлкните по файлу <span style="background-color: #D3D3D3;">Install-Zigbee2MQTT-Service.bat</span> правой кнопкой мыши и выберите «'''Запуск от имени администратора'''». | |||
После этого: | |||
*программа запускается при включении компьютера, ещё до входа в Windows; | |||
*окно держать открытым не нужно, веб-интерфейс работает как обычно; | |||
*если программа даст сбой, Windows запустит её заново сама. | |||
Запускать этот файл нужно уже после основной установки: пока Zigbee2MQTT не установлен, запускать в фоне нечего. | |||
Окно с запущенным Zigbee2MQTT скрипт закроет сам: Zigbee-стик может использовать только одна копия программы. | |||
<hr> | |||
====Если Zigbee2MQTT перестал отвечать==== | |||
Щёлкните по файлу <span style="background-color: #D3D3D3;">Install-Zigbee2MQTT-Service.bat</span> правой кнопкой мыши и выберите «'''Запуск от имени администратора'''» ещё раз. Повторный запуск безопасен: он перезапустит программу и ничего не сотрёт. | |||
<hr> | |||
====Как отключить фоновый режим==== | |||
Щёлкните по файлу <span style="background-color: #D3D3D3;">Uninstall-Zigbee2MQTT-Service.bat</span> правой кнопкой мыши и выберите «'''Запуск от имени администратора'''». Программа перестанет запускаться сама, а её настройки и список Zigbee-устройств останутся на месте. | |||
<hr> | |||
===Как изменить настройки позже=== | |||
Запустите <span style="background-color: #D3D3D3;">Install-Zigbee2MQTT.bat</span> ещё раз тем же способом. Уже установленные компоненты повторно не скачиваются — установщик сразу перейдёт к выбору прибора и адаптера. Прошлый выбор будет предложен по умолчанию: чтобы оставить его, достаточно нажать Enter. | |||
<hr> | |||
===Как удалить Zigbee2MQTT=== | |||
Щёлкните по файлу <span style="background-color: #D3D3D3;">Uninstall-Zigbee2MQTT.bat</span> правой кнопкой мыши и выберите «'''Запуск от имени администратора'''». | |||
Скрипт снимет службу Windows (если был включён фоновый режим), остановит программу и удалит её вместе с настройками. Про <span style="background-color: #D3D3D3;">Node.js</span> он спросит отдельно: им могут пользоваться другие программы на компьютере, поэтому по умолчанию <span style="background-color: #D3D3D3;">Node.js</span> остаётся. Чтобы удалить и его, ответьте «да». | |||
Драйверы USB-адаптеров остаются в системе всегда: их используют не только Zigbee-стики, но и платы Arduino, программаторы и переходники USB-COM. | |||
Вместе с программой стирается база Zigbee-сети: после повторной установки все Zigbee-устройства придётся подключать заново. | |||
Прибор Home Assistant в личном кабинете ZONT удаление не затрагивает — если он больше не нужен, удалите его в приложении ZONT. | |||
<hr> | |||
===Если что-то пошло не так=== | |||
В самом начале каждый файл показывает свою версию (например, версия 2026.9.1) — назовите её при обращении в поддержку, она же записана в журнале. | |||
Рядом с файлом <span style="background-color: #D3D3D3;">Install-Zigbee2MQTT.bat</span> установщик создаёт файл <span style="background-color: #D3D3D3;">log.txt</span> c подробностями последнего запуска, а удаление пишет <span style="background-color: #D3D3D3;">log-uninstall.txt</span>. | |||
Настройка фонового режима пишет <span style="background-color: #D3D3D3;">log-service.txt</span>, отключение — <span style="background-color: #D3D3D3;">log-service-uninstall.txt</span>. | |||
Приложите нужный файл к обращению в техническую поддержку ZONT — по нему причина видна почти всегда. | |||
Если Zigbee2MQTT работает в фоне, поддержка может попросить ещё и журнал самой программы. Он лежит в папке '''%LOCALAPPDATA%\Zigbee2MQTT\logs''': скопируйте этот адрес в адресную строку проводника и нажмите Enter. | |||
'''Частые случаи и что делать:''' | |||
{| class="wikitable" | |||
|+ | |||
!Что на экране | |||
!Что это значит | |||
|- | |||
|«'''Установка требует прав администратора'''» | |||
|Файл запущен обычным двойным щелчком. | |||
Закройте окно и запустите правой кнопкой мыши через «'''Запуск от имени администратора'''». | |||
|- | |||
|«'''Неверный логин или пароль'''» | |||
|Проверьте данные на сайте ZONT. После трёх неудачных попыток установка прервётся. | |||
|- | |||
|«'''В аккаунте нет ни одного прибора Home Assistant'''» | |||
|Сначала добавьте прибор в приложении ZONT, затем запустите установку заново. | |||
|- | |||
|«'''Сервер ZONT не отвечает'''» | |||
|Подключение блокирует антивирус, брандмауэр или провайдер. | |||
Проверьте, открывается ли сайт ZONT в браузере на этом компьютере. | |||
|- | |||
|«'''Zigbee2MQTT запустился в фоне и сразу остановился'''» | |||
|Чаще всего Zigbee-стик занят или выбран не тот COM-порт. | |||
Порядок действий — в разделе «[[Интеграция ZONT с Home Assistant MQTT#Если адаптер занят|Если адаптер занят]]» ниже. | |||
|- | |||
|«'''В системе уже есть служба Zigbee2MQTT'''» | |||
|Службу с таким именем создала другая программа. Скрипт её не трогает, чтобы ничего не сломать. | |||
|- | |||
|«'''Адаптер на порту COM…чем-то занят'''» | |||
|Установщик пробует освободить адаптер сам. | |||
Если не помогло — порядок действий в разделе «[[Интеграция ZONT с Home Assistant MQTT#Если адаптер занят|Если адаптер занят]]» ниже. | |||
|} | |||
<hr> | |||
====Если адаптер занят==== | |||
Zigbee-стик может использовать только одна программа за раз. Если в окне написано, что адаптер занят, выполняйте по порядку и после каждого шага запускайте файл заново (правой кнопкой мыши — «Запуск от имени администратора»): | |||
'''1.''' '''Извлеките адаптер из USB и вставьте его заново'''. Помогает чаще всего: Windows заново подключает устройство и отпускает его. | |||
'''2.''' '''Подключите адаптер к другому USB-порту компьютера'''. | |||
'''3.''' '''Закройте программы, которые могут работать с адаптером''' — другую копию Zigbee2MQTT, программы настройки Zigbee-стика, монитор COM-порта. | |||
'''4. Перезагрузите компьютер'''. | |||
<hr> | |||
===Базовая информация по добавлению устройств Zigbee=== | |||
При входе на <span style="background-color: #D3D3D3;"><nowiki>http://localhost:3097</nowiki></span> интерфейс по умолчанию на английском языке. Нажмите на кнопку '''en''', чтобы открыть меню выбора доступных языков | |||
[[Файл:1 start.png|972x972px]] | |||
Выберите из списка <span style="background-color: #D3D3D3;">Русский</span>. | |||
[[Файл:2 lang.png|972x972пкс]] | |||
Перейдите во вкладку <span style="background-color: #D3D3D3;">Устройства</span> и нажмите кнопку <span style="background-color: #D3D3D3;">Разрешить подключение</span>. | |||
[[Файл:3 search.png|971x971пкс]] | |||
Чтобы перевести Zigbee устройство в режим поиска следуйте инструкции производителя (возможные варианты: зажатие кнопки или её тройное нажатие, зажатие скрытого переключателя в отверстии для скрепки). После этого световой индикатор начнет мигать, и устройство появится в веб-интерфейсе Zigbee2MQTT. После этого можно вручную отключить присоединение устройств нажав на <span style="background-color: #D3D3D3;">Запретить присоединение</span>. | |||
[[Файл:4 joined.png|972x972px]] | |||
Программа автоматически направит всю информацию о датчике на сервера ZONT. После обновления главного экрана дома с устройством Home Assistant, в приложении ZONT появятся доступные компоненты добавленного датчика. | |||
[[Файл:5 result.png|852x852пкс]] | |||
Имя плитки по умолчанию максимально наполняется данными, чтобы была понятна принадлежность компонента к устройству. Переименование доступно в настройках устройства Home Assistant, разделы <span style="background-color: #D3D3D3;">Управление</span>, <span style="background-color: #D3D3D3;">Оборудование</span>, <span style="background-color: #D3D3D3;">Отопление</span>. | |||
[[Файл:6 rename.png|843x843пкс]] | |||
Ненужные плитки можно скрыть в настройках дома, раздел <span style="background-color: #D3D3D3;">Главный экран</span>. | |||
[[Файл:7 visible.png|845x845пкс]] | |||
Итоговый вид на главном экране дома. | |||
[[Файл: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.
Дополнительная информация в разделе «Техническим специалистам».
Что понадобится
- Компьютер с 64-разрядной Windows 10 или новее.
- Zigbee-стик*, вставленный в USB-порт (рекомендуем стик Zigbee 3.0 на базе TICC2652P).
- Логин и пароль от личного кабинета ZONT.
- Прибор типа «Home Assistant», заранее добавленный в приложении ZONT. Если такого прибора нет, установщик остановится и сообщит об этом.
- Права администратора на компьютере.
- Подключение к интернету.
- Скачать скрипты установки для Windows.
* Пример стика: Zigbee RF-DG-52PAS CC2652P USB
Как установить
- Вставьте Zigbee-стик в USB-порт компьютера.
- Извлеките файлы из скачанного архива z2m-setup.zip
- Щёлкните по файлу Install-Zigbee2MQTT.bat правой кнопкой мыши и выберите «Запуск от имени администратора».
- Дождитесь окончания. Установка идёт в одном окне и занимает от 5 до 20 минут в зависимости от скорости интернета.
- В случае каких-либо ошибок вам будет выведено их описание и наиболее вероятные способы исправления.
- Скрипт установки можно перезапускать повторно.
Что попросит установщик
За всю установку вас спросят только о трёх вещах, и все три — в самом начале.
Логин и пароль от личного кабинета ZONT. Пароль при вводе не отображается — это нормально, просто наберите его и нажмите Enter. Если в вашем аккаунте включена двухфакторная аутентификация, установщик дополнительно попросит код.
Прибор. Если в аккаунте один прибор Home Assistant, он выберется автоматически. Если несколько — появится список, введите номер строки:
| В аккаунте несколько приборов Home Assistant. Выберите тот, к которому подключается Zigbee2MQTT:
1) Дом 2) Дача Введите номер прибора из списка: |
Zigbee-стик. Если адаптер в компьютере один, он определится сам. Если портов несколько — выберите из списка тот, в который вставлен адаптер.
Дальше вмешательство не потребуется: остальные этапы пройдут без вопросов.
После установки
При первом запуске Windows может спросить, разрешить ли Zigbee2MQTT доступ к сети. Нажмите «Разрешить доступ» — без этого не откроется веб-интерфейс.
В конце установки в окне побегут строки — это Zigbee2MQTT запускается. Когда он заработает, внизу появится сообщение «ZIGBEE2MQTT ЗАПУЩЕН ИРАБОТАЕТ» с адресом веб-интерфейса:
http://localhost:3097
Дальше в этом окне появляются только сообщения об ошибках, если они будут.
Откройте адрес в браузере: в веб-интерфейсе добавляют 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, чтобы открыть меню выбора доступных языков
Выберите из списка Русский.
Перейдите во вкладку Устройства и нажмите кнопку Разрешить подключение.
Чтобы перевести Zigbee устройство в режим поиска следуйте инструкции производителя (возможные варианты: зажатие кнопки или её тройное нажатие, зажатие скрытого переключателя в отверстии для скрепки). После этого световой индикатор начнет мигать, и устройство появится в веб-интерфейсе Zigbee2MQTT. После этого можно вручную отключить присоединение устройств нажав на Запретить присоединение.
Программа автоматически направит всю информацию о датчике на сервера ZONT. После обновления главного экрана дома с устройством Home Assistant, в приложении ZONT появятся доступные компоненты добавленного датчика.
Имя плитки по умолчанию максимально наполняется данными, чтобы была понятна принадлежность компонента к устройству. Переименование доступно в настройках устройства Home Assistant, разделы Управление, Оборудование, Отопление.
Ненужные плитки можно скрыть в настройках дома, раздел Главный экран.
Итоговый вид на главном экране дома.
Техническим специалистам
Раздел описывает обмен по протоколу 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 игнорируется: все способы персистентного хранения сообщений в брокере отключены.
