Inswift
本页目录

本页目录

进阶15 分钟

ETH-MG web修改 IEEE（协调器迁移）

对应产品 · ETH-MG21 / ETH-MG24 / ETH-MG21 POE / ETH-MG24 POE

换一个 ETH-MG21 / ETH-MG24（含 POE）时，只恢复 Zigbee2MQTT / ZHA 备份往往不够。部分终端按协调器的 IEEE（EUI-64） 找网关；芯片出厂地址不同，就会出现「能上报、控不了」，或入网一直失败。

ETH-MG 的网页在 ZHA & Z2M → Coordinator IEEE migration (EZSP) 里，可以把目标 EUI-64 先写入 Silicon Labs 芯片，成功后再在 ESP32 主机上保存一份覆盖值。配合 同一套 EmberZNet 网络备份，多数设备可以沿用原来的 PAN、网络密钥和绑定，不必整网重配。

适用： ETH-MG21、ETH-MG24、ETH-MG21 POE、ETH-MG24 POE。Zigbee 协调器（EmberZNet / EZSP）。旧设备也必须是芯科方案（例如另一台 ETH-MG、ZBT-1P、ZBM-MG21 / MG24）。

不适用： ETH-52P / ETH-52P7（TI / zstack，见 ETH-52P / ETH-52P7修改IEEE(协调器迁移)）；Router / Thread 固件；把 zstack 备份硬套到 Ember。

默认：网页 http://dongle.local/，Z2M tcp://dongle.local:6638，ZHA socket://dongle.local:6638。mDNS 不稳时改局域网 IP。

官方背景：Zigbee2MQTT：复制协调器 IEEE · 换适配器 · ZHA：迁移到新适配器。

开始前

  1. 先备份，再改 IEEE。没有备份又改了地址，主机侧的绑定与数据库会对不上，只能清库重配
  2. 记下旧协调器 IEEE，格式如 70:D0:7E:FF:FE:E4:85:4A（不要自己编）
  3. 新网关已是 Coordinator 固件，不是 Router / Thread
  4. 写入完成后把 旧协调器断电。同一信道上不能同时有两台相同 IEEE
  5. 芯科上改的是芯片正在使用的 EUI-64（不是 TI 的 secondary IEEE）。网页与 Z2M / ZHA 应以重启后读到的地址为准

备份网络并记下 IEEE

Zigbee2MQTT

  1. 网页 Settings → About → Coordinator IEEE Address
  2. 复制数据目录里的 coordinator_backup.json（EmberZNet 备份，含 PAN、扩展 PAN、信道、网络密钥）
  3. 需要时一并备份 database.db、configuration.yaml

ember 适配器要求备份来自 EZSP v12 及以上。过旧的 ezsp 备份可能无法直接恢复，见 EmberZNet 适配器说明。

ZHA

记下协调器 IEEE。Migrate adapter 会自动做一份备份；若你平时有导出，一并保存。

备份与 IEEE 必须成套

恢复时用的 IEEE，必须是 这份备份所属网络 的协调器地址。混用两套 backup / 两个 IEEE，Z2M 常报 adapter state does not match 或扩展 PAN 对不上。

在网页写入 IEEE

  1. 浏览器打开 http://dongle.local/ 或网关 IP
  2. 左侧 ZHA & Z2M
  3. 打开 Coordinator IEEE migration (EZSP)
  4. 在 Coordinator EUI-64 (radio & dongle) 填入旧协调器地址
  5. 勾选确认：将把该 EUI-64 写入芯片，并保存在 dongle 上
  6. 点 Save。芯片写入成功后，主机才会保存覆盖值
  7. 重启网关，让网页和 Z2M / ZHA 读到同一 IEEE

ETH-MG：Coordinator IEEE migration (EZSP)

只想清掉主机上保存的覆盖值、让下次启动尽量改回从芯片读取：把输入框留空，勾选确认后保存。这 不会擦除已经写进芯片的地址。

USB 场合也可以用 universal-silabs-flasher write-ieee。ETH-MG 能打开网页时，优先走本页，不必拆串口。

恢复备份

旧协调器保持断电。 新网关上不要同时跑两套 Z2M / ZHA。

Zigbee2MQTT

把旧的 coordinator_backup.json 放进 Z2M 数据目录（覆盖空的新备份），然后：

serial:
  port: tcp://dongle.local:6638
  # port: tcp://网关IP:6638
  adapter: ember
  # adapter: ezsp
socat:
  enabled: false

只启动这一套 Z2M。ember 与 ezsp 的选择见 Zigbee2MQTT 配置 Inswift 协调器。

若只改了 IEEE、没有恢复同一份备份：主机侧绑定会失效。网页黄条也写明，这时可能需要重置集成或数据库，再重新入网。

ZHA

Configure → Migrate adapter，新口填 socket://dongle.local:6638（或 IP）。提示 Permanently replace the radio IEEE address 时勾选。步骤见 Home Assistant ZHA：迁移到新适配器。

让设备回到网上

  1. 给家里的 Zigbee 路由断电 至少 15 秒（常电路灯、插座多时，拉一次总闸很常见）
  2. 在 Z2M / ZHA 里确认 Coordinator IEEE 已是旧地址，设备既能上报也能受控
  3. 旧网关若还要当 Router 用，先改成别的 IEEE，或保持断电

常见问题

现象原因处理
网页与 Z2M 的 IEEE 不一致写完没重启，或只清了主机覆盖值重启网关；以芯片当前 EUI 为准
能上报、不能控制IEEE 已改，网络密钥 / PAN 不是同一套恢复同一份 Ember 备份后再试
adapter state does not match备份和 IEEE 不是同一张网用该备份里的协调器 IEEE，不要混文件
写入时 TCP 掉线转发会暂停，属预期等保存完成并重启后再连 6638
从 TI 芯片迁过来协议栈不同不要走本页。见 FAQ：换新协调器 或 ETH-52P / ETH-52P7修改IEEE(协调器迁移)
芯片是 Router 固件没有协调器 EUI 迁移入口先刷 Coordinator，或走 ETH-MG Router CLI

相关

Zigbee2MQTT 配置 · ZHA 接入 · 常见问题 FAQ · ETH dongle USB 刷主机 · ETH-MG21 / ETH-MG24 · ETH-MG POE · ETH-52P / ETH-52P7修改IEEE(协调器迁移)