Обновляем ZBDongle‑E в браузере: шаги и диагностика

Прошить SONOFF ZBDongle‑E через браузер можно за 5–10 минут: откройте веб‑прошивальщик в Chrome/Edge, подключитесь к COM/Serial‑порту и запустите Flash. Если донгл не определяется, почти всегда виноваты драйвер (CH9102/CP2102), занятый порт или неверный режим (нужен bootloader).

Перед прошивкой: 2 минуты подготовки

1. Освободите порт: остановите Zigbee2MQTT/ZHA, закройте терминалы и любые “Serial monitor”.
2. Подключите донгл напрямую: без хабов/удлинителей, с нормальным data‑кабелем (не “только зарядка”).
3. Браузер: нужен Chromium (Chrome/Edge). В Firefox/Safari Web Serial обычно не работает.
4. Проверьте драйвер USB‑UART (часто в Windows/macOS):

• у ZBDongle‑E встречаются CH9102 или CP2102;
• если драйвер не тот, порт может не появляться или “отваливаться”.

Способ 1: официальный SONOFF Dongle Flasher (Web Serial)

Откройте в Chrome/Edge:

https://dongle.sonoff.tech/sonoff-dongle-flasher/

Шаги:

1. Нажмите Connect → выберите порт (COMx в Windows или /dev/tty* в Linux/macOS).
2. Выберите тип прошивки:
   • Coordinator — если донгл будет координатором (Zigbee2MQTT/ZHA).
   • Router — если делаете ретранслятор Zigbee (тогда координатор должен быть другим).
3. Нажмите Flash и дождитесь завершения.
4. Переподключите донгл (вытащить/вставить) и только потом запускайте Zigbee2MQTT/ZHA.

Способ 2: веб‑флешер с загрузкой своего .gbl

Этот вариант нужен, если вы точно знаете, какой файл .gbl хотите поставить (конкретная версия, сборка, настройки).

Пример страницы веб‑флешера:

https://darkxst.github.io/silabs-firmware-builder/

Шаги (общая логика):

1. Скачайте нужный .gbl на компьютер.
2. Откройте страницу, нажмите CONNECT и выберите порт.
3. Выберите установку локального файла (.gbl) → INSTALL/FLASH.
4. После прошивки сделайте переподключение донгла.

Как войти в bootloader (если не подключается)

Bootloader помогает, когда веб‑флешер пишет вроде “running firmware could not be detected” или постоянно “Connection failed”.

Универсальная схема:

1. Отключите донгл от USB.
2. Зажмите кнопку BOOT.
3. Подключите донгл обратно к USB (или нажмите Reset, если он есть).
4. Подержите BOOT 3–5 секунд, отпустите.
5. Снова нажмите Connect в веб‑флешере.

Типичные проблемы подключения и решения

Порт не появляется в выборе (ничего не видно)

Проверьте по порядку:

• другой USB‑порт (часто стабильнее USB 2.0);
• другой кабель (обязательно с передачей данных);
• убрать хаб/удлинитель;
• установить правильный драйвер CH9102 или CP2102;
• открыть именно Chrome/Edge.

Connection failed / устройство не определяется

Почти всегда помогает:

1. остановить Zigbee2MQTT/ZHA и закрыть все serial‑программы;
2. переподключить донгл (питание на 5–10 секунд);
3. перевести донгл в bootloader и повторить подключение.

Port busy / permission denied (Linux, HAOS, Docker)

• убедитесь, что никакой сервис не держит /dev/ttyUSB* или /dev/ttyACM*;
• проверьте права на устройство (часто нужно членство в группе наподобие dialout и перелогин);
• в контейнерах/Docker проверьте проброс устройства и что оно не занято другим контейнером.

Прошивка “висит” на 0% или кнопка Flash “ничего не делает”

• попробуйте режим инкогнито и отключите расширения;
• перезапустите браузер;
• подключите донгл напрямую в другой порт;
• в Windows иногда помогает запуск браузера от имени администратора (если политика ограничивает доступ к serial).

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

• Прошивка при запущенном Zigbee2MQTT/ZHA → порт занят, ошибки доступа.
• Прошивка через Firefox/Safari → Web Serial не даёт выбрать порт.
• Неправильный драйвер (CH9102 vs CP2102) → порт не появляется или нестабилен.
• Прошивка через хаб/плохой кабель → обрывы, зависания, “0%”.
• Не сделали переподключение после Flash → система “держит” старое состояние порта.

FAQ

Нужно ли прошивать ZBDongle‑E “из коробки”?
Желательно: обновление часто решает несовместимости и снижает число проблем со стабильностью.

Что выбрать: Coordinator или Router?
Coordinator — для основной Zigbee‑сети (Zigbee2MQTT/ZHA). Router — чтобы усилить сеть как ретранслятор, но он не заменяет координатор.

Прошивка сотрёт Zigbee‑сеть?
Иногда сеть переживает обновление, но рассчитывайте на худший сценарий: заранее сделайте резервную копию (если ваш стек/система это поддерживает) или будьте готовы переподключить часть устройств.