walthowd/husbzb-firmware

husbzb-firmware 镜像说明

镜像概述

该Docker镜像提供环境用于更新Nortek GoControl HUSBZB-1（Zigbee & Z-Wave USB适配器）、Telegesis ETRX357USB适配器及其他基于Silicon Labs EM358x/EM3581、ETRX35x/ETRX357、EFR32MGxx MCU芯片的Zigbee适配器固件。可将基础版本（如5.4.1-194）升级至Silicon Labs最新公开的EmberZNet NCP固件（如6.7.8），支持EZSP v8协议，兼容Home Assistant（ZHA集成）、OpenHAB等家庭自动化软件。

注意：Silabs EmberZNet 6.x.x及以上版本要求Home Assistant 0.115或更高版本。

核心功能

1. 检测适配器端口、固件版本及设备类型；
2. 升级固件至指定版本；
3. 支持协调器配置备份与迁移；
4. 提供固件恢复指南（应对刷写失败）。

使用场景

• 升级Zigbee适配器固件以适配最新家庭自动化软件；
• 迁移协调器配置至新适配器，避免设备重新配对；
• 修复固件兼容性故障。

配置说明

Docker运行步骤

1. 启动容器（替换/dev/ttyUSB1为适配器Zigbee端口）：

   bash
   docker run --rm --device=/dev/ttyUSB1:/dev/ttyUSB1 -it walthowd/husbzb-firmware bash
   

   确保无其他应用占用该端口（如Home Assistant）。

2. 扫描适配器信息：

   bash
   ./ncp.py scan
   

   示例输出：

   {"ports": [{"stackVersion": "5.4.1-194", "deviceType": "zigbee", "pid": "8A2A", "port": "/dev/ttyUSB1", "vid": "10C4"}]}
   Found zigbee port at /dev/ttyUSB1 running 5.4.1-194
   

固件刷写

1. 选择固件文件：

   适配器型号	推荐固件
   HUSBZB-1	ncp-uart-sw-6.7.8.ebl
   ETRX357USB	em357-v678-ncp-uart-sw.ebl
   高级用户可选HUSBZB-1的**bps固件：ncp-uart-sw-6.7.8-115k.ebl*

2. 执行刷写：

   bash
   ./ncp.py flash -p /dev/ttyUSB1 -f ncp-uart-sw-6.7.8.ebl
   

协调器迁移

1. 备份配置：

   bash
   docker run --rm --device=/dev/ttyUSB1:/dev/ttyUSB1 -v `pwd`:/data -e EZSP_DEVICE='/dev/ttyUSB1' -e LANG='C.UTF-8' -it walthowd/husbzb-firmware bash
   bellows info
   bellows backup > /data/bellows-backup.txt
   exit
   

2. 恢复到新适配器：

   bash
   docker run --rm --device=/dev/ttyUSB1:/dev/ttyUSB1 -v `pwd`:/data -e EZSP_DEVICE='/dev/ttyUSB1' -e LANG='C.UTF-8' -it walthowd/husbzb-firmware bash
   bellows info
   bellows restore --i-understand-i-can-update-eui64-only-once-and-i-still-want-to-do-it -B /data/bellows-backup.txt
   bellows info
   

致谢

感谢Gary提供固件文件：https://github.com/grobasoz/zigbee-firmware