Вы купили Sonoff ZBDongle-E, установили Home Assistant (в виде Home Assistant OS, Supervised или Container), и теперь хотите, чтобы ваши датчики движения, выключатели и розетки работали без облака и привязки к производителю.

Эта статья — не про теорию, а про то, как заставить всё это работать здесь и сейчас. Без лишних слов. Только шаги, команды и проверенные решения.

Что нам понадобится

Компонент	Примечание
Home Assistant	Версия 2023.10 или новее (рекомендуется последняя)
Sonoff ZBDongle-E	USB-адаптер на базе EFR32MG13 (Simplicity Studio)
USB-порт	На хосте (Raspberry Pi, NUC, сервер)
Zigbee-устройства	Например, Aqara D1, IKEA TRÅDFRI, Tuya
Доступ к HA CLI	Через SSH, Terminal или Portainer

💡 Убедитесь, что ваш хост не блокирует доступ к USB-устройству. На Raspberry Pi с HassOS это работает «из коробки».

Шаг 1: Подключаем адаптер

1. Вставьте ZBDongle-E в USB-порт.
2. Дождитесь, пока система его распознает.

Чтобы проверить:

ls /dev/ttyUSB*

Если увидите /dev/ttyUSB0 — значит, устройство определилось.

⚠️ Если нет — переподключите, попробуйте другой порт, проверьте кабель.

Шаг 2: Устанавливаем Zigbee-интеграцию

Home Assistant не работает с Zigbee «напрямую» — нужен драйвер и слой управления. Лучший выбор — Zigbee Home Automation (ZHA).

Вариант A: через интерфейс (проще)

1. Откройте Home Assistant → Настройки → Интеграции
2. Нажмите + Добавить интеграция
3. Найдите: Zigbee Home Automation (ZHA)
4. Нажмите Настроить

Вариант B: через консоль (если ZHA не отображается)

Убедитесь, что пакет zigpy установлен. Для этого:

1. Установите Terminal & SSH (если ещё не установлен)
2. Выполните:

   pip install zigpy-znp

✅ В официальных образах (HassOS, Supervised) zigpy-znp уже встроен.

Шаг 3: Настраиваем ZHA с ZBDongle-E

После запуска ZHA:

1. Выберите тип контроллера: Zigbee radio type → znp
2. Укажите путь к устройству:
   → /dev/ttyUSB0
   (Если другой — проверьте через dmesg | grep tty)
3. Скорость передачи: 115200
4. Нажмите Готово

🔄 ZHA создаст внутреннюю сеть Zigbee. Это займёт 10–20 секунд.

Шаг 4: Пара устройств — как добавить датчик или выключатель

Пример: добавляем Aqara Door/Window Sensor (MCCGQ11LM).

1. Зайдите в ZHA → Добавить устройство
2. Переведите датчик в режим спаривания:
   • Удерживайте кнопку 5 секунд, пока не начнёт мигать светодиод
3. Ждите уведомления: «Устройство найдено»
4. Назначьте имя: например, Датчик входной двери

✅ Готово. Теперь он в системе как binary_sensor.door_window_sensor.

А что с Tuya, IKEA, Philips Hue?

Никаких проблем. ZHA поддерживает большинство устройств «из коробки»:

Производитель	Работает?	Особенности
Aqara	✅ Да	Все датчики, выключатели D1
IKEA TRÅDFRI	✅ Да	Выключатели, лампы, реле
Tuya Zigbee	✅ Да	Только устройства с чипом TUYA (не Wi-Fi!)
Philips Hue	✅ Да	Лампы, датчики движения
Lidl Silvercrest	✅ Да	Через ZHA
Xiaomi Mi Jia	⚠️ Частично	Некоторые датчики теряют связь — нужен репитер

💡 Совет: используйте выключатели IKEA или розетки Sonoff ZBMini как репитеры — они усиливают сеть.

Шаг 5: Проверка статуса сети

Хочется видеть, как живёт ваша Zigbee-сеть?

1. Установите Zigbee2MQTT Assistant (через HACS) или просто MQTT Explorer
2. Или используйте встроенный просмотр:
   → В ZHA → Network → Topology
3. Вы увидите:
   • Карту сети (узлы и связи)
   • Уровень сигнала (RSSI)
   • LQI (Link Quality Indicator)

📉 RSSI < -90 dBm — плохая связь. Нужен репитер.

Распространённые проблемы и как их решить

Проблема	Причина	Решение
Не видит /dev/ttyUSB0	Права доступа	Добавьте пользователя в группу dialout: sudo usermod -a -G dialout $USER
Устройство не парится	Не в режиме спаривания	Перезапустите процесс (удерживайте кнопку 5–10 сек)
Потерял связь с датчиком	Слабый сигнал	Добавьте репитер (лампу, розетку)
Ошибки в логах: Failed to back up network state	Проблема с правами на запись	Проверьте, что /config/zigbee.db доступен для записи
После ребута — потеря сети	Неправильный путь к устройству	Используйте стабильный путь, например, через by-id: /dev/serial/by-id/usb-ITead_Sonoff_Zigbee_3.0_USB_Dongle_Plus_xxxxxx-if00-port0

Безопасность и резервная копия

Zigbee-сеть — это данные. Её нужно бэкапить.

1. В ZHA → Настройки → Резервное копирование
2. Экспортируйте:
   • zigbee.db — главная база устройств и ключей
   • Сохраните в надёжное место

⚠️ Без zigbee.db после переустановки все устройства придётся парам заново.

Альтернатива: Z2M vs ZHA?

Многие спрашивают: Zigbee2MQTT (Z2M) или ZHA?

Критерий	ZHA	Zigbee2MQTT
Установка	Встроена в HA	Требует Docker/MQTT
Поддержка устройств	Хорошая	Отличная (больше кастомизации)
Обновление прошивок	❌ Нет	✅ Есть
Производительность	Лёгкая нагрузка	Требует MQTT-брокер
Работа с Tuya	✅ Да	✅ Да, но сложнее

🟢 ZHA — для большинства.
🟡 Z2M — если нужны OTA-обновления или экзотические устройства.

Полезные советы

• Не перегружайте сеть: более 30 устройств — риск потерь
• Размещайте репитеры равномерно: лампы, розетки, выключатели
• Обновляйте прошивку ZBDongle-E (через Simplicity Commander, если есть необходимость)
• Используйте описание каналов в Lovelace, чтобы не путаться

Что дальше?

• Создайте автоматизацию: «Если дверь открыта ночью — включи свет»
• Интегрируйте с Google Home или Яндекс.Алиса
• Настройте энергомониторинг, если используете умные розетки