Интеграция ZONT с Home Assistant MQTT
Материал из Библиотека
Микро Лайн
Установка 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 игнорируется: все способы персистентного хранения сообщений в брокере отключены.
