Как настроить ZBDongle‑E для ZHA и не уходить в RCP

Перевод Sonoff ZBDongle‑E в режим RCP “для ZHA” в большинстве случаев не нужен и приводит к ошибкам запуска: ZHA ожидает координатор Silicon Labs в режиме EZSP/NCP, а RCP/MultiPAN — это другая архитектура (часто ещё и с другой версией EZSP), из‑за чего интеграция не поднимается или работает нестабильно.

Оглавление

Почему RCP не подходит для ZHA

RCP (Radio Co‑Processor) обычно используют там, где “мозги” протокола работают на хосте (например, Thread/OTBR), а донгл остаётся радиомодулем. ZHA же рассчитан на работу с Zigbee‑координатором по EZSP (NCP) — это другой режим взаимодействия.

Практическая причина, почему “не взлетает”: MultiPAN/RCP прошивки нередко собраны под более новую версию EZSP, чем та, с которой стабильно работает ZHA. В итоге вы видите типичные симптомы: “Failed to set up”, бесконечная инициализация, ошибки рукопожатия/версии протокола.

Если прошить MultiPAN RCP “ради ZHA”, чаще всего придётся откатываться обратно на прошивку Zigbee Coordinator (EZSP/NCP) и заново поднимать сеть.

Какая прошивка нужна для ZHA

Для Home Assistant + ZHA выбирайте прошивку, где донгл — именно Zigbee Coordinator / Zigbee NCP (EZSP).

Кратко по вариантам прошивок ZBDongle‑E:

Прошивка/режимЧто делает донглПодходит для ZHA
Zigbee Coordinator (NCP/EZSP)координатор ZigbeeДа
Zigbee Routerроутер/ретранслятор ZigbeeНет
OpenThread RCPрадиомодуль ThreadНет
MultiPAN RCPпопытка “Zigbee+Thread” на одном стикеОбычно нет (проблемы совместимости)

Если вам нужны и Zigbee, и Thread, самый предсказуемый вариант — два отдельных адаптера: один под ZHA (координатор), второй под Thread (RCP).

Как прошить ZBDongle‑E под ZHA (короткая инструкция)

Ниже — универсальные шаги, независимо от того, используете вы веб‑флешер или аддон/утилиту прошивки.

  1. Остановите сервисы, которые держат порт: ZHA, Zigbee2MQTT, любые “serial”/terminal‑аддоны.
  2. Подключите донгл напрямую или через качественный USB‑удлинитель (часто снижает помехи и отваливания).
  3. В инструменте прошивки выберите устройство и прошивку Zigbee Coordinator / Zigbee NCP (EZSP).
  4. Дождитесь завершения прошивки, переподключите донгл.
  5. В Home Assistant заново запустите интеграцию ZHA и проверьте инициализацию.

После экспериментов с MultiPAN у части пользователей меняется IEEE‑адрес (идентификатор) адаптера. Тогда старая Zigbee‑сеть может “не узнать” координатор, и устройства придётся переподключать.

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

  • ZHA не стартует после прошивки
    Почти всегда прошита не та роль: Router/RCP вместо Coordinator. Перепрошейте на Zigbee Coordinator (EZSP/NCP).

  • Прошивка не начинается или стоит на 0%
    Порт занят (ZHA/Z2M не остановлены) или нет доступа к USB/serial внутри вашей системы.

  • Сеть “пропала”, устройства не в сети
    Возможна смена IEEE‑адреса или создана новая сеть. Проверьте, не добавили ли вы ZHA как “новый” координатор, и будьте готовы к повторному спариванию.

FAQ

Можно ли всё-таки сделать RCP и ZHA вместе?
На практике — редко и нестабильно. ZHA ориентирован на EZSP/NCP‑координатор, а RCP/MultiPAN решает другие задачи.

Что выбрать, если цель — максимум совместимости и минимум проблем?
ZBDongle‑E в прошивке Zigbee Coordinator (EZSP/NCP) + ZHA. Для Thread — отдельный RCP‑адаптер.

Нужно ли после прошивки заново добавлять устройства?
Если координатор и его идентификаторы не изменились — часто нет. Если изменился IEEE‑адрес/сеть — да, переподключение может понадобиться.