Настройка ZHA в Home Assistant

Введение

Для интеграции Zigbee-устройств в Home Assistant существует два основных подхода — ZHA (Zigbee Home Automation) и Zigbee2MQTT. Они позволяют подключать датчики, выключатели, лампы и другие устройства, но отличаются принципом работы и глубиной настройки. Подробнее о различиях между этими двумя подходами можно прочитать в материале Подключение Zigbee-устройств к Home Assistant: обзор способов. В этой статье рассматривается ZHA как один из вариантов настройки Zigbee в Home Assistant.

Что такое ZHA

ZHA (Zigbee Home Automation) — встроенная интеграция Home Assistant для работы с Zigbee-устройствами без необходимости устанавливать дополнительные сервисы вроде MQTT-брокера. ZHA использует библиотеку zigpy и поддерживает несколько реализаций радиомодулей, включая:

• Silicon Labs EFR32 / Sonoff Zigbee 3.0 USB Dongle Plus
• Texas Instruments CC2652 / CC2531 / CC1352
• ConBee II / RaspBee II (deCONZ)
• ZigStar и другие совместимые адаптеры

ZHA подходит для пользователей, которые хотят максимально простое решение без сложной настройки.

Установка и настройка ZHA

Подключение Zigbee-адаптера

Подключите USB-координатор к серверу Home Assistant. Проверьте, что система определила устройство: должен появиться порт вида /dev/ttyUSB0 или /dev/ttyACM0.

Добавление интеграции

• Откройте Настройки → Устройства и службы → Добавить интеграцию
• Введите Zigbee Home Automation (или ZHA)
• Выберите найденный порт адаптера
• Укажите тип радиомодуля, если требуется
• Дождитесь завершения настройки — появится панель ZHA

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

Добавление устройств Zigbee

• Переведите устройство в режим сопряжения (обычно удержание кнопки 5–10 секунд)
• В интерфейсе ZHA выберите «Добавить устройство»
• Дождитесь появления устройства в списке
• Дайте понятное имя и при необходимости назначьте комнату

ZHA автоматически определяет тип устройства и добавляет соответствующие сущности.

Работа и диагностика сети

В ZHA доступен инструмент визуализации Zigbee-сети (Network Visualization), который показывает координатор и все подключённые устройства. Для каждого устройства можно открыть карточку и увидеть информацию об устройстве.

Заключение

ZHA — простой и надёжный способ интеграции Zigbee-устройств в Home Assistant. Интеграция не требует MQTT, поддерживает популярные адаптеры и подходит для большинства домашних сценариев. При усложнении Zigbee-сети можно рассмотреть Zigbee2MQTT как более гибкое решение.