Подключение Zigbee-устройств к Home Assistant: обзор способов

Введение

Zigbee — один из самых популярных протоколов для умного дома. Он позволяет устройствам обмениваться данными напрямую без постоянного подключения к Wi‑Fi и без нагрузки на роутер. Zigbee надёжен, энергоэффективен и идеально подходит для датчиков, выключателей, ламп и других автономных устройств.

Home Assistant (HA) отлично работает с Zigbee, но у пользователей часто возникает вопрос: какой способ подключения выбрать — Zigbee2MQTT или ZHA? В этой статье разберёмся, как работает Zigbee в Home Assistant OS (HAOS), какие есть варианты интеграции и какую архитектуру выбрать для своего дома.

Как работает Zigbee

Zigbee — это ячеистая (mesh) сеть, состоящая из трёх типов устройств:

• Координатор (Coordinator) — главный узел сети. Управляет соединениями и хранит таблицу маршрутов. Обычно это USB‑свисток, подключённый к Home Assistant.
• Роутеры (Routers) — устройства, которые усиливают и передают сигнал (например, умные розетки или лампы, работающие от сети).
• Конечные устройства (End Devices) — датчики, выключатели, кнопки. Они экономят энергию и спят, просыпаясь только для обмена данными.

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

Популярные координаторы:

• Sonoff Dongle‑E / P
• Home Assistant SkyConnect / Connect ZBT-1
• ConBee II

Zigbee2MQTT

Zigbee2MQTT — это внешний сервис, который превращает Zigbee‑сеть в MQTT‑сообщения. MQTT (Message Queuing Telemetry Transport) — лёгкий протокол обмена сообщениями, который используется для передачи данных между устройствами в системах автоматизации. Zigbee2MQTT работает независимо от Home Assistant, но связывается с ним через MQTT‑брокер (например, Mosquitto).

Как это работает:

Устройство Zigbee ↔ Координатор ↔ Zigbee2MQTT ↔ MQTT Broker ↔ MQTT Integration ↔ Home Assistant (устройства и сенсоры)

• Zigbee2MQTT напрямую управляет координатором и публикует данные в топиках MQTT (например, zigbee2mqtt/device/state).
• Информация о Zigbee‑устройствах хранится в базе data/database.db в каталоге Zigbee2MQTT.
• Home Assistant получает эти данные через интеграцию MQTT и создаёт соответствующие сущности: сенсоры, переключатели, лампы, климат‑устройства и т. д.

Когда использовать Zigbee2MQTT:

• Если у вас много Zigbee‑устройств от разных производителей и нужна максимальная совместимость.
• Если вы готовы управлять MQTT‑брокером (например, Mosquitto) для большей гибкости.
• Если хотите расширенные настройки сети, логи и контроль состояния устройств.
• Подходит для продвинутых пользователей и тех, кто хочет максимальную кастомизацию.

ZHA (Zigbee Home Automation)

ZHA — встроенная интеграция Home Assistant, которая не требует внешних сервисов. Она использует библиотеку zigpy для общения с Zigbee‑координатором напрямую.

Как это работает:

Устройство Zigbee ↔ Координатор ↔ zigpy ↔ ZHA ↔ Home Assistant (устройства и сенсоры)

• ZHA обращается напрямую к координатору (USB или сетевому).
• Все данные о Zigbee‑устройствах хранятся в файле zigbee.db (SQLite) внутри Home Assistant.
• При добавлении устройства оно сразу появляется в Home Assistant как сущность (sensor, switch, light, и т. д.).

MQTT в этой схеме не используется вообще, потому что ZHA работает напрямую, минуя брокеры сообщений.

Когда использовать ZHA:

• Если вы хотите максимально простую интеграцию без настройки MQTT‑брокера.
• Если ваш адаптер хорошо поддерживается ZHA (например, Sonoff, SkyConnect, ConBee II).
• Если вам достаточно базового или среднего уровня автоматизации.
• Подходит для установки «из коробки», так как всё настраивается через интерфейс Home Assistant.

Где в этой схеме MQTT (Mosquitto)

Mosquitto — это MQTT‑брокер, посредник между Zigbee2MQTT и Home Assistant. Zigbee2MQTT отправляет все данные о Zigbee‑устройствах в брокер, а Home Assistant через интеграцию MQTT их читает. ZHA не использует MQTT, потому что общается напрямую с Zigbee‑координатором. Таким образом:

• Zigbee2MQTT → через брокер MQTT, гибче, но сложнее.
• ZHA → без брокера, прямая интеграция, проще.

Сравнение Zigbee2MQTT и ZHA

Оба варианта стабильны и активно развиваются. Главное различие — в уровне контроля и сложности установки. Если вам нужна простота и быстрый старт без лишних сервисов — подойдёт ZHA. Если вы хотите гибкость, расширенные настройки, визуальный контроль или используете особенное Zigbee‑оборудование, лучше выбрать Zigbee2MQTT.

⚠️ Важно: ZHA и Zigbee2MQTT не могут работать одновременно на одном Zigbee-адаптере. Нужно выбрать одну из интеграций для вашего координатора.

Топология решений

Ниже рассмотрены типовые варианты установки и настройки Zigbee в Home Assistant. В каждом из вариантов могут упоминаться установка компонентов, которые описаны подробно в отдельных статьях:

• Интеграция ZHA
• MQTT‑брокер (дополнение Mosquitto)
• Zigbee2MQTT (дополнение из HACS)
• MQTT‑интеграция

ZHA

Используйте, если Zigbee‑координатор подключён к Home Assistant OS (HAOS) и вы хотите простоту и стабильность без дополнительных сервисов.
Всё работает напрямую: Home Assistant ↔ Zigbee‑координатор.

Zigbee2MQTT (локально на HAOS)

Используйте, если Zigbee‑координатор также подключён к HAOS, но вы хотите гибкость, расширенные возможности или особенное оборудование, поддерживаемое только через Zigbee2MQTT. В этом случае нужно установить дополнения Mosquitto Broker, Zigbee2MQTT и выполнить настройку интеграции MQTT.

Zigbee2MQTT (внешний координатор)

Используйте, если Zigbee-координатор подключён к стороннему устройству, например Wiren Board, другому серверу или выделенному хосту, где уже запущены Zigbee2MQTT и MQTT-брокер. В этом случае Zigbee2MQTT работает вне Home Assistant, а в HAOS достаточно установить только интеграцию MQTT, чтобы получать данные от внешнего брокера.

Заключение

Zigbee — отличное решение для стабильного и автономного умного дома.
Home Assistant даёт возможность выбрать, какой путь подойдёт именно вам: ZHA для простоты или Zigbee2MQTT для гибкости. Обе системы надёжно работают и позволяют строить масштабируемые Zigbee‑сети без облачных сервисов. Главное — понимать архитектуру и выбрать подходящий инструмент под свои задачи.

Полезные ссылки

• MQTT — официальный сайт стандарта протокола. Официальный ресурс с описанием протокола MQTT, документацией и спецификациями.
• Zigbee2MQTT — официальный сайт и справочник поддерживаемого оборудования. Здесь можно проверить совместимость Zigbee‑устройств и найти инструкции по настройке Zigbee2MQTT.