ZBDongle‑E: как посмотреть версию прошивки и выбрать правильный .gbl/.hex
Текущую версию прошивки ZBDongle‑E проще всего увидеть через веб‑прошивальщик SONOFF, а для обновления почти всегда нужен файл .gbl (формат загрузчика Silicon Labs). .hex обычно предназначен для прошивки через программатор и часто не подходит для “веб‑заливки”.
Оглавление
Как узнать текущую версию прошивки
-
Самый универсальный способ (подходит и для ZHA, и для Zigbee2MQTT):
- Остановите сервис, который держит донгл (ZHA/Zigbee2MQTT/OTBR), чтобы освободить порт.
- Откройте веб‑прошивальщик и подключитесь к устройству: https://dongle.sonoff.tech/sonoff-dongle-flasher/
- После Connect обычно отображаются тип прошивки и версия (например Zigbee/EZSP).
-
Если уже используете Zigbee2MQTT:
- В Web UI проверьте раздел About/О системе или посмотрите логи запуска — там обычно есть строка с firmware/revision координатора.
Если “версия не показывается” в ZHA — это нормально. Быстрее всего на минуту остановить ZHA и проверить через веб‑прошивальщик.
Что выбирать: .gbl или .hex
ZBDongle‑E построен на Silicon Labs EFR32MG21, и для него типичный файл обновления — .gbl:
- .gbl — образ для Gecko Bootloader (то, что чаще всего шьётся через веб‑прошивальщики/серийный загрузчик).
- .hex — Intel HEX, обычно для прошивки через SWD/программатор; в “обычном” сценарии обновления ZBDongle‑E через USB часто не используется.
Если вы пытаетесь залить .hex через веб‑прошивальщик/bootloader и получаете ошибки — почти всегда проблема в формате: для ZBDongle‑E нужен .gbl.
Как подобрать тип прошивки под задачу
Сначала определите роль донгла — от этого зависит, какой файл искать (и почему “вдруг перестало работать”).
Быстрый выбор прошивки для ZBDongle‑E
| Задача | Что прошивать | Что получится |
|---|---|---|
| ZHA или Zigbee2MQTT как координатор | **Zigbee NCP / Coordinator (EZSP/Ember)**, обычно .gbl | Координатор Zigbee-сети |
| Усилить сеть (репитер) | **Zigbee Router**, .gbl | Роутер Zigbee (не координатор) |
| Thread (Matter/Thread) отдельным донглом | **OpenThread RCP**, .gbl | Радиомодуль Thread для OTBR/Thread-стека |
| Zigbee + Thread на одном донгле | **MultiPAN RCP**, .gbl | Мультипротокол, сложнее в настройке/диагностике |
Порт, скорость и flow control: быстрые настройки
Для координатора Zigbee (ZHA/Zigbee2MQTT) чаще всего работают такие базовые параметры:
- baudrate: обычно 115200
- hardware flow control (RTS/CTS): обычно выключен
- Zigbee2MQTT: как правило,
adapter: emberиrtscts: false
Если в названии файла прошивки встречается 115200 / 460800 или hw_flow / no_flow — это не “декор”, а важные параметры. Несовпадение скорости/flow control часто выглядит как “донгл не отвечает”, “таймауты”, “мусор в логе”.
Частые ошибки
- Прошили Router вместо Coordinator. В результате ZHA/Zigbee2MQTT не видит координатор — потому что его больше нет (донгл стал роутером).
- Выбрали не тот формат файла. Для ZBDongle‑E в большинстве случаев нужен .gbl, а не .hex.
- Порт занят. Прошивальщик не подключается, потому что ZHA/Zigbee2MQTT/другая служба держит
/dev/ttyACM*(или COM‑порт). - Несовпали скорость/flow control. Включили RTS/CTS в конфиге, а прошивка/железо этого не ждёт (или наоборот).
FAQ
Прошивка сотрёт Zigbee‑сеть?
Иногда обновление проходит “поверх” и сеть сохраняется, но гарантировать нельзя. Перед любыми действиями сделайте бэкап (в Zigbee2MQTT — через интерфейс/файлы бэкапа).
Почему после обновления Zigbee2MQTT ругается на EZSP/protocol version?
Обычно это признак несовместимости (слишком старая/не та прошивка). Нужна актуальная Zigbee NCP (EZSP/Ember) под ZBDongle‑E и корректные параметры порта.
Как понять, что файл точно для ZBDongle‑E?
Ориентируйтесь на упоминание ZBDongle‑E / EFR32MG21 и роль (NCP/Coordinator, Router, RCP). Если файл “для координатора”, но без привязки к MG21, есть риск, что он для другого донгла.