ETH dongle 固件升级
本页升级的是 ETH dongle 上的 ESP32 主机固件，不是协调器芯片上的 Zigbee / Thread 固件。USB dongle（ZBT-1P、ZBM-MG21、ZBM-MG24）请走 USB dongle 固件烧录。
ETH-52P / ETH-52P7 的网页还能打开时，优先在网关 Tools → Firmware 升级 ESP32 与 CC2652，不必拆 USB，见 ETH-52P / ETH-52P7 web本地升级ESP32 / Zigbee。本页是网页进不去、或需要用电脑 USB 写主机时的流程。
USB-C 接墙插 5V 1A 供电，网口接到路由器。内置过压保护，可用快充头供电：
开始前
用 Chrome 或 Edge 打开 工具，进入 ETH dongle 在线升级。
接着确认这几件事：
- 用 USB 数据线把 ETH dongle 接到这台电脑（不要只插网口或只供电）
- 关闭占用串口的程序：Home Assistant 中的 ZHA / Zigbee2MQTT、串口助手，以及已经打开本页的其他浏览器标签
- 选对型号后再烧录。52P 与 52P7、MG21 与 MG24、普通款与 POE 不能混刷
Windows 或 macOS 若看不到串口，先安装 USB 驱动再重新插拔。截图设备的 USB ID 为 1a86:55d4（WCH CH9102 一类），Windows 用 CH9102，macOS 用 CH34X。
当前工具支持的型号：
| 型号 | 芯片 | 主机 |
|---|---|---|
| ETH-52P | TI CC2652P | ESP32 |
| ETH-52P7 | TI CC2652P7 | ESP32 |
| ETH-MG21 | EFR32MG21 | ESP32 |
| ETH-MG24 | EFR32MG24 | ESP32 |
| ETH-MG21 POE | EFR32MG21 | ESP32 |
| ETH-MG24 POE | EFR32MG24 | ESP32 |
不在上表中的型号请勿使用本流程。
连接设备
以下以 ETH-MG24 为例。其它 ETH 型号步骤相同，只是串口名称和最后确认的型号不同。
打开 ETH dongle 在线升级，点 连接设备。
浏览器会弹出串口列表。选中这台 ETH dongle（名称里通常带型号和 COMx / ttyUSB / ttyACM），允许连接。列表里也可能出现 USB dongle 或其它串口，请选对当前这台 ETH 主机，不要选成 USB dongle。
确认型号
工具会尽量自动识别型号。识别不到时会出现黄色提示，需要你从列表里点对应型号。点错会导致主机固件异常，POE 与非 POE、MG21 与 MG24、52P 与 52P7 都要分开选。
已识别到型号时，可跳过这一步，直接安装。
安装固件
确认型号无误后点 Install firmware。工具会写入当前发布的主机固件，请等待结束，不要拔线或关闭页面。
完成后出现 Install complete，点 Done。建议拔掉再插上，再回到 Home Assistant 或网关网页。
常见问题
串口列表是空的，或系统认不出设备。 先装驱动，换口或换数据线后再试。确认 ZHA / Zigbee2MQTT 已停止。Linux 用户需有串口权限（常见是加入 dialout 组）。
烧录失败、中途卡住，或烧完工作异常。 关闭占用串口的程序后重试，并核对型号是否选对。仍失败时，在烧录窗口打开 Serial console，把日志发给 inswift888@gmail.com，并写明具体型号（含是否 POE）。
控制台里可以看到主机固件版本、以太网是否起来、以及分配到的 IP。也可点 Download logs 保存后再发送。
刷完进不了 ZHA / Z2M，或网口没地址。 先重新插拔 USB 和网线。本页只动 ESP32 主机；Zigbee adapter（zstack / ezsp / ember）仍按协调器芯片来。协议不匹配时见 常见问题 FAQ。