Sonoff ZBDongle‑P (CC2652P) — как быстро подключить и настроить

Коротко: вставьте донгл в USB, укажите путь к порту и выберите интеграцию — ZHA для простоты или Zigbee2MQTT для гибкости. Ниже — конкретные команды, конфиги и рекомендации по прошивке и улучшению покрытия.

Подключение и выбор интеграции

  1. Вставьте донгл в USB‑порт хоста Home Assistant.
  2. Найдите порт:
ls -l /dev/serial/by-id
dmesg | grep -i usb
  1. Выбор интеграции:
  • ZHA: Settings → Devices & Services → Add Integration → Zigbee Home Automation. Если автоматом не определяет — выберите Radio Type = znp (Texas Instruments) и укажите путь к serial.
  • Zigbee2MQTT: в конфиге указать serial.port и adapter. Пример:
serial:
  port: /dev/serial/by-id/usb-Itead_Sonoff_Zigbee_3.0_USB_Dongle_Plus_XXXXXXXX-if00-port0
  adapter: zstack
  baudrate: 115200

Важно: один донгл не может одновременно работать в двух интеграциях.

Если планируете полный контроль, выбирайте Zigbee2MQTT. Для быстрого и стабильного старта — ZHA.

Прошивка: зачем и как безопасно обновить

Зачем прошивать: исправления стабильности, поддержка новых устройств, hardware flow control, регулировка TX power. Перед прошивкой остановите ZHA/Zigbee2MQTT, чтобы порт был свободен.

Практическая последовательность:

  • Сделайте бэкап текущей сетевой конфигурации (если мигрируете).
  • Используйте официальный flasher или community‑инструменты для CC2652P. Для ручной прошивки применяют скрипты типа cc2538‑bsl.py и .hex прошивки.
  • После прошивки проверьте права доступа к /dev/tty* и перезапустите HA.

Неправильная прошивка может привести к неработоспособности координатора — внимательно следуйте инструкциям и не прерывайте процесс.

Оптимизация радиосети и практические советы

  • Выберите Zigbee‑канал, минимально пересекающийся с Wi‑Fi (часто 15, 20 или 25). В Zigbee2MQTT:
advanced:
  channel: 20
  • Выносите донгл от корпуса/USB3.0 портов при помощи USB‑удлинителя — это снижает помехи.
  • Добавьте роутеры (умные розетки, стационарные выключатели) для расширения mesh.
  • При необходимости настройте tx_power в конфигурации znp (ZHA → zigpy_config → znp_config → tx_power), но не превышайте допустимые значения.

Частые ошибки

  • Донгл виден, но интеграция не подключается: проверьте, что порт не занят другим процессом; перезапустите HA и остановите add‑on.
  • Неправильный adapter в Zigbee2MQTT: для ZBDongle‑P обычно adapter = zstack.
  • Проблемы с определением устройства в /dev/serial/by-id: ориентируйтесь на VID:PID и физическую маркировку донгла.
  • Устройства работают в одной интеграции, но не в другой: это из‑за различий стеков и конвертеров — попробуйте обновить интеграцию или добавить пользовательские конвертеры.

FAQ

  • Могу ли я параллельно использовать ZHA и Zigbee2MQTT с одним донглом?
    Нет — только одна интеграция может держать порт. Для параллели нужен второй координатор.
  • Нужна ли прошивка сразу?
    Не обязательно, но рекомендуется обновить до последней стабильной версии для совместимости и исправлений.
  • Как вернуть старую сеть при миграции?
    Экспортируйте network backup на старом координаторе и используйте опции восстановления в ZHA/Zigbee2MQTT.

Если нужно, подготовлю пошаговый план миграции с конкретного координатора (ConBee, CC2531 и т. п.) и адаптированный конфиг для вашей среды (HA OS / Supervised / Container). Напишите модель хоста и список ключевых устройств сети.