网络参数动态修改：信道与 PAN ID
学习提示
网络运行中想"改参数"有两种完全不同的改法：改信道（Channel）像换频道——全网平滑切换、不掉线；改 PAN ID 像换身份证——身份变了，节点必须重新入网。这一页讲清两种机制的原理、参数和代码路径。
一句话理解
信道可以"平滑搬家"（标准机制 Mgmt_NWK_UPDATE_REQ），PAN ID 只能"推倒重来"（改账本 → 写存储 → 复位 → 重入网）——两个参数，两种改法。
一. 先分清：两个"动态修改"不是一回事
| 改信道（Channel） | 改 PAN ID | |
|---|---|---|
| 本质 | 换频道（频率迁移） | 换身份证（网络身份变更） |
| 是否掉线 | 平滑切换，全网不掉线 | 必须重新入网（无平滑命令） |
| 路由/邻居 | 保留 | 重建 |
| 标准机制 | 有（Mgmt_NWK_UPDATE_REQ 0x0025） | 无（协议栈未定义平滑换 PAN 命令） |
二. 改信道：标准机制 Mgmt_NWK_UPDATE_REQ
ZigBee 3.0 在网络层定义了"网络更新"管理命令，用于运行中迁移信道——思路是"先体检、再搬家"：
网络管理器发"网络更新请求"
各节点按候选信道列表扫描，回报能量
协调器汇总扫描结果，挑最干净的信道
广播新信道 + 递增的更新编号
全网同时切到新信道，路由邻居保留
关键参数（zdoNetworkUpdateReq_t）：
| 参数 | 含义 | 说明 |
|---|---|---|
ScanChannels | 候选信道位图 | 0x0000_07FF 表示 11~26 信道全扫 |
ScanDuration | 每个信道扫多久 | 单位是 beacon 超帧间隔 |
ScanCount | 扫描轮数 | 多轮取平均更准 |
nwkUpdateId | 网络更新计数 | 必须递增，全网靠它识别"有新版本" |
NwkManagerAddr | 网络管理器短地址 | 通常填协调器地址 |
⚠️ 建网前想改默认信道，不用这条链路：直接
osal_nv_write(ZCD_NV_CHANLIST, ...)写 NV 存储，复位后新网络就建在目标信道上。
三. 改 PAN ID：改账本 → 写存储 → 复位 → 重入网
PAN ID 是网络的"身份证号"，一换节点就不认旧网络了，所以协议栈没有平滑命令，只能"改参数 + 重启重来"（Z-Stack 1.2.2a / 3.0.1 系）：
把新 PAN ID 写进网络信息库 NIB
持久化，掉电不丢
设备重启
协调器按新 PAN 建网，终端擦 NV 后重新报到
- 新 SDK（Z-Stack 3.30+ / SimpleLink）：
Zstackapi_sysConfigWriteReq()，参数has_panID/panID就是干这件事的； - 🔑 真隔离：ZigBee 3.0 里网络的真正身份 = EPID（64 位扩展 PAN ID）+ 网络密钥。两个网络即使 PAN ID 不同，只要 EPID 和密钥相同，设备仍可能"串门"。要做真隔离，必须连
ZCD_NV_EXTENDED_PAN_ID一起改。
四. 上位机集成建议
上位机管理方案里，下行命令可扩展两条：
| 命令 | 功能 | 携带参数 | 协调器收到后 |
|---|---|---|---|
CMD=0x10 | 改信道 | 候选信道位图 + 扫描参数 | 调 ZDP_NwkUpdateReq() |
CMD=0x11 | 改 PAN ID | 新 PAN ID + EPID | 改 NIB → 写 NV → 复位 |
执行结果（成功/失败/新参数）回传上位机，即完成"远程动态调参"。
小结
信道是换频道（平滑，Mgmt_NWK_UPDATE_REQ），PAN ID 是换身份证（重来，NV+复位）——别用同一种期待去改这两个参数。真正要隔离两个网络时，记得连 EPID 一起改。
本章自测
一、单项选择题（每题 10 分，共 50 分）
答完全部 5 题自动判分并计入学习档案（需登录后作答）
1 关于"改信道"与"改 PAN ID"，下列说法正确的是？
2 ZigBee 3.0 运行中全网平滑切换信道的标准机制是？
3 zdoNetworkUpdateReq_t 中 nwkUpdateId 字段的作用是？
4 Z-Stack 1.2.2a / 3.0.1 系修改 PAN ID 的正确步骤顺序是？
5 要让两个 ZigBee 3.0 网络真正隔离、设备不互相"串门"，除了 PAN ID 还必须改？
二、问答题（每题 25 分，共 50 分）
作答并提交后，参考答案要点才会展示（需登录，计入学习档案）