Как подключить ConBee II к ZHA — быстрое руководство

Коротко: ConBee II работает с ZHA через драйвер deCONZ (zigpy-deconz), но считается legacy-решением — использовать можно, если прошивка актуальна и deCONZ остановлен; для новых сетей лучше выбирать современные EZSP/CC26x2 или ConBee III. Ниже — конкретные шаги, проверка прошивки и советы по миграции.

Что такое ConBee II и ZHA

ConBee II — USB Zigbee‑координатор от производителя, который традиционно используется с deCONZ/Phoscon. ZHA (Zigbee Home Automation) — встроенная интеграция Home Assistant, работающая через zigpy и поддерживающая разные радиостеки: для ConBee II это адаптер deCONZ (zigpy-deconz). ConBee II совместим, но имеет ограничения по поддержке новых стеков и по рекомендациям сообщества считается устаревающим по сравнению с ConBee III и EZSP‑адаптерами.

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

1. Подготовка

   • Остановите и отключите deCONZ/Phoscon (если запущены). Один адаптер не может одновременно управляться двумя интеграциями.
   • Подключите ConBee II к USB-порту через короткий USB‑удлинитель/антенный удлинитель для лучшего приёма и меньших помех.

2. Проверка и обновление прошивки

   • Перед миграцией проверьте версию прошивки в Phoscon/deCONZ и обновите, если доступна стабильная версия. При проблемах используйте аварийное восстановление через инструменты производителя.

3. Добавление в Home Assistant (ZHA)

   • В UI Home Assistant: Settings → Devices & Services → Add integration → ZHA.
   • Если автоматический поиск не сработал: Advanced setup → Radio type: deCONZ → укажите путь к serial (/dev/serial/by-id/... или /dev/ttyACM0).
   • При миграции выберите опцию сохранения сетевых настроек (Keep adapter network settings), если доступно.

4. После подключения

   • Дайте сети 30–60 минут для восстановления маршрутизации; powered‑устройства обычно появятся быстрее, батарейные — могут требовать повторного сопряжения.

Миграция из deCONZ в ZHA — чеклист и советы

• Сделайте полный backup конфигурации deCONZ/Phoscon и снимок текущей прошивки.
• Остановите deCONZ и удалите интеграцию deCONZ из Home Assistant.
• Подключите ConBee II в ZHA через deCONZ‑radio и выберите перенос сетевых настроек.
• По завершении: проверьте список устройств, пронумеруйте критичные маршрутизаторы (powered devices) и при необходимости перезапустите их по одному, чтобы восстановить mesh.
• Ожидайте восстановления: некоторые батарейные устройства нужно повторно ввести в режим сопряжения.

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

• ZHA не видит ConBee II: обычно deCONZ остался запущен или указан неправильный serial‑порт. Решение: полностью остановите deCONZ, проверьте /dev/serial/by-id и права доступа.
• Устройства офлайн после миграции: запустите перезагрузку powered‑устройств по очереди; батарейные девайсы часто требуют повторного сопряжения.
• Проблемы после прошивки: если после обновления появились массовые потери пакетов — откатите прошивку или выполните повторную прошивку через официальный инструмент.
• Некорректная работа некоторых моделей: для ряда энерго‑хозяйственных или фирменных устройств функциональность может быть лучше в deCONZ или через альтернативы (zigbee2mqtt).

FAQ

• Нужно ли обновлять прошивку перед переключением на ZHA?
  • Да. Обновление повышает совместимость; перед обновлением сделайте бэкап.
• Сохранится ли сеть при миграции из deCONZ в ZHA?
  • При выборе переноса сетевых настроек большинство маршрутов и устройств сохраняются, но часть батарейных устройств может потребовать повторного сопряжения.
• Что лучше для новой сети — ConBee II или другой адаптер?
  • Для новой сети лучше выбирать ConBee III или EZSP/CC26x2 донглы — они рекомендованы и стабильнее в ZHA.

Если нужно, подготовлю точную пошаговую инструкцию под вашу установку Home Assistant (OS / Container / VM / Proxmox) или помогу разобрать логи — пришлите конфигурацию/фрагменты логов.