Быстрая настройка Sonoff ZBDongle‑E (EFR32) для ZHA

Да — Sonoff ZBDongle‑E на EFR32MG21 работает с ZHA. В двух словах: в ZHA выберите radio type = ezsp, укажите стабильный путь /dev/serial/by-id/… и скорость 115200; перед прошивкой сделайте бэкап и убедитесь, что у вас не мульти‑PAN прошивка (EZSP v16), несовместимая с ZHA.

Подготовка и подключение

  1. Вставьте донгл в USB‑порт сервера Home Assistant (Raspberry Pi, NUC или VM с USB‑passthrough).
  2. На хосте проверьте видимые устройства:
    • ls -l /dev/serial/by-id
    • dmesg | tail -n 50 Используйте путь из /dev/serial/by-id — он стабилен при перезагрузках и удобен в HA.
  3. В виртуалках настройте USB‑passthrough; в контейнерах/HAOS убедитесь, что порт доступен гостевой системе.

Всегда предпочитайте /dev/serial/by-id вместо /dev/ttyUSB0 — при смене портов путь по id остаётся постоянным.

Настройка ZHA в Home Assistant

  1. Откройте Settings → Devices & Services → Add Integration → Zigbee Home Automation (ZHA).
  2. Если интеграция не нашла координатор — выберите "Enter manually" и вставьте путь /dev/serial/by-id/your‑dongle.
  3. Radio Type: выберите ezsp (Silicon Labs EmberZNet). Это ключевой параметр для EFR32.
  4. Serial Device Path: /dev/serial/by-id/…; Baud rate: 115200; Flow control: выключено.
  5. При первом запуске создайте новую сеть ("Erase and create a new network") или восстановите из бэкапа, если переносите существующие устройства.
  6. После инициализации добавляйте устройства через Devices → ZHA → Add Device или выполняйте сервис zha.permit.

Прошивка, бэкап и MultiPAN

  • Бэкап: перед прошивкой обязательно экспортируйте network backup — это сохранит ключи и таблицы роутинга. Без бэкапа придётся заново подключать все устройства.
  • Прошивка через хост: воспользуйтесь flasher‑инструментом, когда порт свободен (остановите ZHA и Zigbee2MQTT). Проверяйте совместимость версии EZSP.
  • MultiPAN/Multiprotocol: прошивки с MultiPAN могут использовать EZSP v16 (мультирежим) и быть несовместимы с ZHA, который ожидает EZSP v14. Если ZHA не стартует после прошивки — верните совместимую EZSP‑NCP прошивку.

Не прошивайте донгл без бэкапа: смена прошивки часто меняет IEEE‑адрес и ключи — это приведёт к потере связи со всеми устройствами.

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

  • Dongle не виден: проверьте dmesg и ls -l /dev/serial/by-id; возможно, нужен USB‑passthrough в VM.
  • Порт занят: остановите Zigbee2MQTT, flasher или другие службы, использующие порт.
  • ZHA падает после прошивки: вероятно залита MultiPAN (EZSP v16). Прошейте обратно EZSP v14.
  • Плохой приём у устройств: добавьте роутеры‑репитеры (розетки), поменяйте Zigbee‑канал (обычно 15/20/25), уберите USB‑удлинители плохого качества.

FAQ

  • Как узнать текущую версию EZSP?
    Через логи ZHA при инициализации или через инструменты flasher — смотрите строку с версией EZSP/EmberZNet.
  • Какая скорость порта нужна?
    115200 — стандарт для большинства EFR32 прошивок в ZHA.
  • Можно ли использовать MultiPAN и ZHA одновременно?
    Нет: MultiPAN ориентирован на мультипротокол и часто использует EZSP v16, что несовместимо с ZHA; для ZHA нужен EZSP v14.

Команды для быстрой диагностики:

  • ls -l /dev/serial/by-id
  • dmesg | tail -n 50

Если хотите, подготовлю точные команды по вашему выводу ls -l /dev/serial/by-id и dmesg — пришлите выводы, и я скажу, какой путь и какие шаги делать дальше.