ETH-52P / ETH-52P7 web本地升级ESP32 / Zigbee
ETH-52P / ETH-52P7 上有两套固件:ESP32 主机(网页与网口 / Wi-Fi / USB 桥)和 TI CC2652 芯片(Zigbee 或 Thread)。网页能打开时,在设备 Tools → Firmware 升级即可。
固件只从 inswift-eth Releases、esp32-ETH-52P、ti-cc2652 获取。Wiki:ETH Firmware Upgrade Operation Guide。
开始前
- 浏览器打开
http://dongle.local/或网关 IP,能登录网页 - 优先网线;Wi-Fi 中途掉线可能停在半包
- 52P 与 52P7 的 CC2652 镜像不能互换;协调器、路由、Thread 也不能混刷
- 先记下 Status 页上的主机版本和 Zigbee 版本
打开 Tools → Firmware
登录后:左侧 Tools(中文 工具)→ 顶栏 Firmware(固件)。语言在左下角切换。
四张卡片:
| 卡片(英文 / 中文) | 作用 |
|---|---|
| ESP32 / ESP32 在线升级 | 从 GitHub 装 ota.bin:Install latest / 安装最新版本,或 Show available... / 显示可用固件 |
| ESP32 manual flashing / ESP32 本地升级 | 上传本机 fs.bin 或 ota.bin |
| Zigbee update / Zigbee 本地升级 | 上传本机 CC2652 .bin / .hex |
| Zigbee / 更新CC2652固件 | 从 GitHub 清单选 CC2652 版本 |

ESP32 本地升级
从 Releases 下载同一日期的 inswift_YYYYMMDD.fs.bin 与 inswift_YYYYMMDD.ota.bin。不要把 full.bin 丢进网页本地升级。
fs.bin 是网页界面,ota.bin 是 ESP32 应用。两者都要升时:先 fs.bin,再 ota.bin,每次等重启完成。
- 在 ESP32 本地升级 点 选择文件... / Select firmware file...,选
fs.bin或ota.bin - 点 Install(安装)
- 弹窗提示将断开全部连接,确认 I'm sure / 确定
- 等到 Update complete / 更新完成,等网页重新打开后再升下一个文件




升 ota.bin 时只换文件,步骤相同:

ESP32 在线升级
网关能访问 GitHub 时,用左侧 ESP32 卡片只升 ota.bin(fs.bin 只能本地上传)。
- Tools → Firmware → ESP32
- Install latest / 安装最新版本,或 Show available... / 显示可用固件 选历史版本
- 确认断开连接,等待完成并重启





Zigbee 本地升级
先停 Z2M / ZHA。刷错芯片或刷成 Router / Thread 后,协调器 tcp://…:6638 会失效。
从 ti-cc2652 取文件:
- ETH-52P:
coordinator/下含CC2652P与launchpad的协调器镜像,例如CC1352P2_CC2652P_launchpad_coordinator_20250321.bin - ETH-52P7:
CC1352P7_coordinator_….bin - 路由:同一芯片的
*_router_*.bin - Thread:
thread/下对应芯片的*ot_rcp*/ RCP(刷完串口常见 460800)
文件名需含 coordinator、router,或 thread / rcp,网关才会设角色和波特率(协调器 / 路由常见 115200)。不要用其它板型文件。
- 同一 Firmware 页打开 Zigbee update(中文 Zigbee 本地升级)
- 选择文件...,选上面的
.bin或.hex - 核对 Current chip model / 当前芯片型号(52P ≠ 52P7)
- 点 Install,确认断开连接,等待完成并重启

Zigbee 在线升级
网关能访问 GitHub 时,用右下 Zigbee(中文 更新CC2652固件)。清单按当前芯片过滤,仍要自己选 协调器,不要误选路由或 Thread。
- 点 Show available... / 显示可用固件
- 安装协调器版本
- 确认断开连接,等待进度结束
刷完协调器后,Z2M 仍用 adapter: zstack、tcp://dongle.local:6638;ZHA 用 socket://dongle.local:6638。Thread 镜像改走 OpenThread,不能再当 Zigbee 协调器。迁网免重新入网见 ETH-52P / ETH-52P7修改IEEE(协调器迁移)。
常见问题
弹窗写 disconnect ALL socket connections / 将断开所有接口连接。 先停 Z2M / ZHA,再点确定。
进度停住或网页再也打不开。 等两分钟后断电再上电。仍无网页则走 ETH dongle USB 刷主机。
Zigbee 刷完 Z2M 报 ping 超时。 核对芯片与文件名;确认是 coordinator 而不是 router / RCP;波特率是否仍是 115200。见 FAQ:ping 超时。
网页 IEEE 看起来没变。 TI 主地址本来就不会改。迁网请走 ETH-52P / ETH-52P7修改IEEE(协调器迁移)。
相关:ETH-52P / ETH-52P7 · Zigbee2MQTT 配置 · ZHA · ETH dongle USB 刷主机 · 常见问题 FAQ