Sonoff Zigbee 3.0 USB Dongle Plus в Home Assistant: настройка ZHA и Zigbee2MQTT

Когда умный дом перерастает стадию «одна Wi-Fi розетка и лампочка», рано или поздно встаёт вопрос: как объединить десятки устройств в единую систему, которая не зависит от облака и интернета? Wi-Fi устройства плодятся, роутер задыхается, а каждая китайская розетка норовит утащить данные в свой дата-центр. Решение — Zigbee. И сегодня я расскажу, как подружить популярный USB-координатор Sonoff Zigbee 3.0 USB Dongle Plus с Home Assistant через две самые популярные интеграции: ZHA и Zigbee2MQTT.

Зачем вообще нужен Zigbee-координатор?

Zigbee — это mesh-сеть, где каждое устройство может быть ретранслятором для соседей. В отличие от Wi-Fi, Zigbee работает на частоте 2.4 ГГц, но с меньшей скоростью и гораздо меньшим энергопотреблением. Датчики на батарейках живут месяцами, а сеть остаётся стабильной даже при десятках устройств.

Координатор — это «мозг» сети. Он принимает сигналы от всех устройств и передаёт их в Home Assistant. Sonoff Zigbee 3.0 USB Dongle Plus — один из самых популярных вариантов: он построен на чипе Silicon Labs EFR32MG21, поддерживает Zigbee 3.0 и стоит вполне адекватных денег. По сути, это эталонный выбор для домашней автоматизации.

Важный момент: этот донгл существует в двух версиях — с антенной и без. Версия с антенной (Plus) имеет лучший радиус действия, но и стоит чуть дороже. Для квартиры хватит и без неё, для дома побольше — лучше брать с антенной.

Что выбираем: ZHA или Zigbee2MQTT?

Это извечный вопрос, как «Android или iOS». Оба варианта рабочие, но с разными философиями.

ZHA (Zigbee Home Automation) — встроенная интеграция Home Assistant. Не требует дополнительных сервисов, настраивается за пару кликов, поддерживает большинство устройств. Минус — если ваше устройство не поддерживается, придётся ждать обновления или писать кастомный код.

Zigbee2MQTT — отдельный сервис, который работает через MQTT-брокер. Поддерживает огромное количество устройств, включая редкие китайские розетки и датчики. Даёт больше контроля: можно смотреть сырые данные, править конфиги, использовать кастомные возможности. Минус — нужно ставить MQTT-брокер и сам сервис, что добавляет сложности.

Мой совет: если у вас типовые устройства (розетки, лампочки, датчики температуры) — берите ZHA. Если у вас есть что-то экзотическое или вы любите копаться в настройках — Zigbee2MQTT. Впрочем, ничто не мешает попробовать оба варианта и выбрать тот, что по душе.

Подготовка: что понадобится

Перед началом убедитесь, что у вас есть:

• Home Assistant (я предполагаю, что он уже установлен — если нет, посмотрите руководство по установке на Orange Pi Zero 3 или полное руководство для Raspberry Pi)
• Sonoff Zigbee 3.0 USB Dongle Plus
• USB-кабель (лучше короткий и качественный — длинные кабели могут давать помехи)
• Несколько Zigbee-устройств для теста (розетка, датчик, лампочка)

Настройка ZHA: быстро и просто

ZHA — это самый быстрый путь. Всё, что нужно — вставить донгл в USB-порт и добавить интеграцию.

Шаг 1: Вставляем донгл

Подключите Sonoff Zigbee 3.0 USB Dongle Plus к вашему устройству с Home Assistant. Если у вас Raspberry Pi или Orange Pi — вставляйте напрямую в USB-порт. Если используете виртуальную машину или Docker — пробросьте USB-устройство в контейнер.

Проверить, что донгл определился, можно через SSH:

lsusb

Ищите строку с Silicon Labs или 10c4:ea60 (это VID:PID чипа). Если видите — всё в порядке.

Шаг 2: Добавляем интеграцию

Зайдите в Настройки → Устройства и службы → Добавить интеграцию и найдите Zigbee Home Automation.

Мастер предложит выбрать устройство. Должен появиться /dev/ttyUSB0 или /dev/ttyAMA0 (зависит от системы). Выбирайте его.

Если устройство не появилось — проверьте права доступа:

sudo chmod 666 /dev/ttyUSB0

Но лучше один раз настроить правильно через udev-правила, чтобы не повторять это после каждой перезагрузки:

sudo nano /etc/udev/rules.d/99-sonoff-zigbee.rules

Вставьте:

SUBSYSTEM=="tty", ATTRS{idVendor}=="10c4", ATTRS{idProduct}=="ea60", MODE="0666", SYMLINK+="zigbee"

Перезагрузите правила:

sudo udevadm control --reload-rules
sudo udevadm trigger

Теперь донгл будет доступен как /dev/zigbee — это удобнее, чем гадать, какой ttyUSB он получил.

Шаг 3: Добавляем устройства

После добавления интеграции откройте Настройки → Устройства и службы → ZHA. Нажмите Добавить устройство — Home Assistant перейдёт в режим поиска.

Теперь переведите ваше Zigbee-устройство в режим сопряжения. Обычно это делается долгим нажатием на кнопку (5-10 секунд) или перезагрузкой устройства. У разных производителей по-разному — смотрите инструкцию.

Как только устройство найдено, оно появится в списке. Дайте ему имя и выберите комнату.

Типичные ошибки при работе с ZHA

1. Устройство не находится. Проверьте, что донгл не занят другим процессом. Если у вас установлен Zigbee2MQTT — он может конфликтовать. Остановите его перед настройкой ZHA.

2. Устройство находится, но не работает. Попробуйте удалить его и добавить заново. Иногда помогает перезагрузка Home Assistant.

3. Сеть нестабильна. Убедитесь, что донгл подключён напрямую к USB-порту, а не через хаб. Хабы часто дают помехи.

Настройка Zigbee2MQTT: больше контроля

Zigbee2MQTT требует установки MQTT-брокера. Если у вас его нет — поставим Mosquitto.

Шаг 1: Устанавливаем Mosquitto

В Home Assistant OS или Supervised это делается через аддон:

Настройки → Аддоны → Магазин аддонов → найдите Mosquitto broker и установите.

После установки настройте логин и пароль для MQTT (вкладка «Конфигурация»):

logins:
  - username: mqtt_user
    password: ваш_надёжный_пароль

Включите аддон и проверьте, что он запустился.

Шаг 2: Устанавливаем Zigbee2MQTT

Если у вас Home Assistant OS — ищите аддон Zigbee2MQTT в магазине аддонов. Если у вас Docker — используйте контейнер:

docker run -d 
  --name zigbee2mqtt 
  --restart=unless-stopped 
  --device=/dev/ttyUSB0:/dev/ttyUSB0 
  -v /path/to/zigbee2mqtt-dаta:/app/data 
  -e TZ=Europe/Moscow 
  koenkk/zigbee2mqtt

Обратите внимание на --device=/dev/ttyUSB0 — это проброс USB-устройства в контейнер. Если у вас другой порт — замените.

Шаг 3: Настраиваем конфигурацию

Откройте файл конфигурации Zigbee2MQTT. В аддоне Home Assistant OS он доступен через вкладку «Конфигурация». В Docker — в папке данных:

# /path/to/zigbee2mqtt-data/configuration.yaml
homeassistant:
  enabled: true

permit_join: false

mqtt:
  base_topic: zigbee2mqtt
  server: mqtt://localhost:1883
  user: mqtt_user
  password: ваш_надёжный_пароль

serial:
  port: /dev/ttyUSB0

advanced:
  network_key: [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16]
  pan_id: 0x1a62
  channel: 15

device_options:
  legacy: false

Разберём ключевые параметры:

• permit_join: false — запрещает добавление новых устройств. Включайте только когда добавляете устройство, потом выключайте. Это защита от несанкционированного подключения.
• network_key — ключ шифрования сети. Сгенерируйте свой и сохраните в надёжном месте. Если потеряете — придётся переподключать все устройства.
• pan_id — идентификатор сети. Можно оставить как есть.
• channel — радиоканал. По умолчанию 15, но если у вас много Wi-Fi сетей — попробуйте 20 или 25, там меньше помех.
• legacy: false — отключает устаревший формат сообщений. Рекомендую включить, чтобы получать чистые данные.

Шаг 4: Подключаем Zigbee2MQTT к Home Assistant

Если вы используете аддон — интеграция появится автоматически. Если Docker — добавьте интеграцию MQTT в Home Assistant:

Настройки → Устройства и службы → Добавить интеграцию → MQTT

Укажите адрес брокера, логин и пароль. После этого Home Assistant автоматически обнаружит устройства Zigbee2MQTT.

Шаг 5: Добавляем устройства

Включите permit_join: true в конфигурации и перезапустите Zigbee2MQTT. Теперь переведите устройство в режим сопряжения. В логах Zigbee2MQTT вы увидите сообщение о новом устройстве.

Когда устройство добавлено — выключите permit_join обратно:

permit_join: false

Типичные ошибки при работе с Zigbee2MQTT

1. Устройство не подключается. Проверьте, что permit_join: true и что устройство в режиме сопряжения. Некоторые устройства требуют сброса перед подключением — зажмите кнопку на 10-15 секунд.

2. Устройство подключается, но не отображается в Home Assistant. Проверьте, что MQTT-интеграция настроена правильно и что в логах Zigbee2MQTT нет ошибок. Иногда помогает перезагрузка Home Assistant.

3. Потеря связи с устройствами. Проверьте канал — если он совпадает с загруженным Wi-Fi каналом, возможны помехи. Смените канал в конфигурации и перезапустите Zigbee2MQTT. Учтите: при смене канала все устройства переподключатся автоматически, но это может занять время.

Сравнение ZHA и Zigbee2MQTT: что выбрать?

Я пользуюсь обоими вариантами в разных проектах. Вот мои наблюдения:

Если у вас стандартный набор устройств и вы не хотите заморачиваться — ZHA. Если вы любите экспериментировать и у вас есть редкие устройства — Zigbee2MQTT.

Кстати, если вы ещё не решили, какие устройства покупать — почитайте сравнение Zigbee и Wi-Fi розеток. Это поможет избежать ошибок при выборе.

Проверка результата

После настройки любого из вариантов нужно убедиться, что всё работает корректно.

Проверка ZHA

1. Откройте Настройки → Устройства и службы → ZHA.
2. Убедитесь, что все устройства отображаются со статусом «Доступно».
3. Попробуйте управлять устройством: включите розетку, проверьте показания датчика температуры.
4. Проверьте задержку — она должна быть менее секунды.

Проверка Zigbee2MQTT

1. Откройте веб-интерфейс Zigbee2MQTT (обычно порт 8080).
2. В разделе «Устройства» проверьте, что все устройства онлайн.
3. Посмотрите логи — не должно быть ошибок вида No converter available for....
4. В Home Assistant проверьте, что устройства появились в Настройки → Устройства и службы → MQTT.

Тест на стабильность

Оставьте систему на сутки. Утром проверьте:

• Все ли устройства на связи?
• Нет ли ошибок в логах?
• Работают ли автоматизации?

Если что-то отвалилось — проверьте питание донгла. Слабый USB-порт или длинный кабель могут вызывать нестабильность. Лучше использовать качественный короткий кабель и, если возможно, USB-порт с питанием 5В/1А.

Что дальше?

Теперь, когда Zigbee-сеть работает, можно развивать умный дом дальше:

• Настройте автоматизации для управления освещением и климатом
• Добавьте Node-RED для визуальных сценариев
• Установите HACS и добавьте полезные интеграции

И помните: Zigbee-сеть — это не «поставил и забыл». Иногда устройства теряют связь, особенно после перезагрузки координатора. Не пугайтесь — это нормально. Просто подождите пару минут, mesh-сеть восстановится сама.

Заключение

Sonoff Zigbee 3.0 USB Dongle Plus — отличный выбор для Home Assistant. Он недорогой, надёжный и поддерживает все современные Zigbee-устройства. А выбор между ZHA и Zigbee2MQTT — это вопрос вкуса и потребностей.

Лично я предпочитаю Zigbee2MQTT за гибкость и подробные логи. Но если вы только начинаете — начните с ZHA. Он проще, а встроенной поддержки хватает для большинства сценариев.

Главное — не бойтесь экспериментировать. Умный дом — это живая система, и её всегда можно донастроить под себя. А если что-то пойдёт не так — вы всегда можете переключиться с ZHA на Zigbee2MQTT или обратно. Устройства от этого не пострадают, просто переподключите их к новой сети.

Удачной автоматизации!