📡 Zigbee Home Automation

Конфигурация ZHA

Полное руководство по настройке и использованию ZHA (Zigbee Home Automation) в HomeAssistant. Подключение устройств, настройка координатора и устранение неполадок.

🎯 Что такое ZHA?

ZHA (Zigbee Home Automation) - это встроенная интеграция HomeAssistant для работы с устройствами Zigbee. Она позволяет подключать и управлять различными Zigbee-устройствами без необходимости использования дополнительных bridging-решений. ZHA поддерживает большинство координаторов Zigbee и обеспечивает стабильную работу сети.

Предварительные требования

🔧

Zigbee Координатор

USB координатор (Sonoff Zigbee 3.0 USB Dongle, ConBee II, SkyConnect) или встроенный радио-модуль

⚡

HomeAssistant

Установленный HomeAssistant (OS или Supervised) с доступом к USB портам

📡

Zigbee Устройства

Совместимые Zigbee устройства (датчики, выключатели, лампы и т.д.)

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

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

Первым шагом необходимо физически подключить Zigbee координатор к системе HomeAssistant:

Подключите USB координатор в порт USB компьютера или сервера
Если используете Docker/HASSOS, настройте проброс USB устройства
Убедитесь, что система обнаружила устройство (проверьте /dev/ttyUSB* или /dev/ttyACM*)
Для встроенных модулей (например, на CC2531) убедитесь в правильности подключения

⚠️ Важно

При использовании HomeAssistant OS убедитесь, что USB устройство доступно в настройках системы. Проверьте раздел "Система" → "Аппаратное обеспечение"

Установка интеграции ZHA

После подключения координатора установите интеграцию ZHA:

Откройте HomeAssistant и перейдите в "Настройки" → "Устройства и службы"
Нажмите "Добавить интеграцию" и введите в поиске "ZHA"
Выберите "Zigbee Home Automation" из списка
Нажмите "Отправить" для начала установки

Настройка последовательного порта

Выберите правильный последовательный порт для вашего координатора:

В диалоговом окне установки выберите порт (обычно /dev/ttyUSB0 или /dev/ttyACM0)
Выберите тип радиомодуля (для большинства USB dongles это "ezsp" или "znp")
Если вы не уверены, оставьте автоматическое определение
Нажмите "Отправить" для завершения настройки

                        Примеры путей к устройствам:
/dev/ttyUSB0 - Sonoff Zigbee Dongle
/dev/ttyACM0 - ConBee II
/dev/serial/by-id/usb-ITead_Sonoff_Zigbee_3.0_USB_Dongle_Plus...
                    

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

После успешной установки ZHA вы можете добавлять устройства в сеть:

Перейдите в "Настройки" → "Устройства и службы" → "ZHA"
Нажмите "Добавить устройство" в правом верхнем углу
Переведите Zigbee устройство в режим сопряжения (обычно долгое нажатие кнопки)
Устройство появится в списке обнаруженных устройств
Нажмите на устройство для завершения настройки

💡 Совет

Большинство Zigbee устройств входят в режим сопряжения при долгом нажатии (3-5 секунд) главной кнопки. Для сенсорных выключателей это может быть быстрая последовательность нажатий.

Расширенная настройка

🌐 Управление сетью Zigbee

ZHA предоставляет мощные инструменты для управления сетью:

Просмотр топологии сети: Визуализация всех подключенных устройств и маршрутизаторов
Управление каналами: Изменение радиоканала для оптимизации работы
Перестроение сети: Пересоздание таблицы маршрутизации для улучшения связи
Удаление устройств: Безопасное удаление устройств из сети

🔧 Конфигурация Quirks

Quirks - это настройки для специфических устройств:

Некоторые устройства требуют специальных настроек для корректной работы
ZHA автоматически применяет большинство quirks
Для продвинутых пользователей доступны пользовательские quirks
Quirks настраиваются через конфигурационные файлы в /config/zha_quirks/

Устранение неполадок

🔍

Устройство не обнаруживается

Проверьте режим сопряжения, попробуйте перезапустить интеграцию ZHA или перезагрузить координатор

📡

Слабый сигнал

Используйте маршрутизируемые устройства (розетки, выключатели) для расширения сети Zigbee

⚠️

Устройство offline

Проверьте батарею в датчике, расстояние до маршрутизатора или выполните удаление и повторное добавление

🔄

Статус "Неизвестно"

Попробуйте перенастроить устройство или проверить совместимость с ZHA

⚠️ Распространенные проблемы

1. Устройства часто теряют связь: Проверьте топологию сети и добавьте больше маршрутизаторов между координатором и конечными устройствами.

2. Медленный отклик: Проверьте загруженность канала WiFi в регионе 2.4GHz, рассмотрите переключение канала Zigbee.

3. Ошибка инициализации координатора: Убедитесь, что устройство не занято другим процессом (например, Zigbee2MQTT)

4. Конфликты устройств: Не используйте ZHA и Zigbee2MQTT одновременно с одним координатором.

Поддерживаемые координаторы

🔌

Sonoff Zigbee 3.0

USB Dongle Plus / Pro

🔌

ConBee II

Dresden Elektronik

🔌

SkyConnect

Nabu Casa

🔌

Tube's Zigbee

CC2531 based

📡

Ember

EZSP radios

📡

TI CC253X

ZNP radios

Полезные ресурсы

Дополнительная информация

Для более глубокого изучения ZHA рекомендуем ознакомиться со следующими ресурсами: