JN5169 ZigBee 3.0 协议栈之 ZigBee 网络参数

本章列出并描述了可以使用 JN5169 ZigBee 3.0 协议栈之 ZPS 配置编辑器 中描述的ZPS配置编辑器来设置的 ZigBee 网络参数。

一、基本参数

参数名称	描述	默认值	范围
Default Extended Pan ID	将新设备添加到无线网络时的默认扩展 PAN ID (EPID)。扩展的 PAN ID 是网络的全球唯一 64 位标识符。此标识符用于避免不同网络之间的 PAN ID 冲突，并且在给定区域中重叠 ping 的网络之间必须是唯一的。如果协调器上的值为零，则设备将使用其自己的 IEEE/MAC 地址作为 EPID。路由器/终端设备上的零值意味着该设备在加入网络时不会查找特定 EPID。请注意，此值是在 ZPS 配置编辑器中添加设备时使用的默认 EPID。用于单个设备的实际 EPID 可以通过参数 APS 使用扩展 PAN ID 进行设置	0	64位
Default Security Enabled	将新设备添加到无线网络时启用安全的默认设置。	true	true / false
Maximum Number of Nodes	无线网络的最大节点数。此设置在向网络添加新设备时控制表的大小，以确保有足够的资源可用于正确操作指定大小的网络。	20

根据其应用领域，其余网络参数将在以下各节中详细说明。

二、配置文件定义参数

参数名称	描述	默认值	范围
Profile Id	应用程序配置文件标识符。 这是由 ZigBee 联盟分配的公共配置文件。		16 位（值为 0 为 ZDP 保留，0xFFFF 为通配符配置文件）
Name	配置文件的文本名称。 这用作 zps_gen.h 中生成的宏定义的前缀。		有效的 C 标识符。（“ZDP”是为 ZigBee 设备配置文件保留的）

三、集群定义参数

参数名称	描述	默认值	范围
Profile Id	集群标识符。 这可以由 ZigBee 联盟为公共集群定义，也可以是制造商特定的。集群被指定为简单描述符中的输入或输出，用于创建绑定表。		16 位
Name	集群的文本名称。 这用作 zps_gen.h 中生成的宏定义的前缀。		有效的 C 标识符

四、协调器参数

参数名称	描述	默认值	范围
其他协调器参数
Name	节点的文本名称。 在 zps_gen.h 中生成宏定义时用作前缀。		有效的 C 标识符
Permit Joining Time	启用允许加入的默认秒数。 • 255 表示永久开启 • 0 表示永久关闭	255	0-255
Security Enabled	指定协调器是否将保护与网络中其他设备的通信。	true	true / false
Initial Security Key	启用安全性时将使用的初始密钥。 这些是从信任中心可用的密钥中选择的。	None

五、路由器参数

参数名称	描述	默认值	范围
其他路由器参数
Name	节点的文本名称。 在 zps_gen.h 中生成宏定义时用作前缀。		有效的 C 标识符
Permit Joining Time	启用允许加入的默认秒数。 • 255 表示永久开启 • 0 表示永久关闭	255	0-255
Scan Duration Time	搜索要加入的网络时扫描选定射频信道的时间长度。 扫描每个通道所花费的时间为：[aBaseSuperframeDuration x (2n + 1)] 个符号。 其中 n 是扫描持续时间参数的值。	3	0-14
Security Enabled	指定路由器是否将保护与网络中其他设备的通信。	true	true / false
Initial Security Key	启用安全时将使用的初始密钥。 这些是从信任中心可用的密钥中选择的。	None

六、终端设备参数

参数名称	描述	默认值	范围
其他终端设备参数
Name	节点的文本名称。 在 zps_gen.h 中生成宏定义时用作前缀。		有效的 C 标识符
Scan Duration Time	搜索要加入的网络时扫描选定射频信道的时间长度。 扫描每个通道所花费的时间为：[aBaseSuperframeDuration x (2n + 1)] 个符号。 其中 n 是扫描持续时间参数的值。	3	0-14
Security Enabled	指定终端设备是否将保护与网络中其他设备的通信。	true	true / false
Initial Security Key	启用安全时将使用的初始密钥。 这些是从信任中心可用的密钥中选择的。	None
Sleeping	指示设备是否将关闭其接收器并进入低功耗模式。 终端设备的父设备将缓冲任何传入的数据，直到设备返回其正常操作状态并发出轮询请求。	false	true / false
Number of Poll Failures Before Rejoin	此参数控制从设备返回到其正常操作状态时开始的连续轮询失败次数，然后再尝试通过启动网络重新加入来找到新的父节点。	5	0 将禁用此行为

七、高级设备参数

参数名称	描述	默认值	范围
AF 参数
-
AIB 参数
APS Designated Coordinator（只读）	表示在启动时节点应承担网络内的协调器角色。	协调器为 true，路由器/终端设备为 false	true / false
APS Use Extended PAN ID	表示设备将使用的扩展 PAN ID (EPID)。 这是网络的全球唯一 64 位标识符。 此标识符用于避免不同网络之间的 PAN ID 冲突，并且在给定区域中重叠的网络之间必须是唯一的。 如果协调器上的值为零，则设备将使用其自己的 IEEE/MAC 地址作为 EPID。 路由器/终端设备上的零值意味着该设备在加入网络时不会查找特定的 EPID。	默认 Extended PAN ID	64 位
APS Inter-frame Delay	APS 数据帧之间的毫秒数。 在传输每个数据块之后，APS 启动一个计时器。 如果在当前传输窗口中有更多未确认的块要发送，则在 apsInterframeDelay 毫秒延迟后，下一个块将传递给 NWK 数据服务。 否则，计时器设置为 apscAckWaitDuration 秒。	10	10-255
APS Max Window Size	APS 碎片化数据窗口大小。 分片是一种发送比单个 NPDU 的有效负载更长的消息 (APDU) 的方式。 ASDU 被分段并拆分为多个 NPDU，然后在目的地重新组装。 APS 最大窗口大小定义了在预期确认之前发送了多少片段。 例如，如果 APS 最大窗口大小设置为 4，并且消息被拆分为 16 个片段，则在发送片段 1-4 后需要确认。 直到收到此确认后才开始发送片段 5-8。	8	1-8
APS Non-member Radius	多播非成员半径大小。 定义可以接收多播传输的核心多播成员的跳数。	2	0-7
APS Security Timeout Period	节点加入网络的身份验证超时时间（以毫秒为单位）。 如果发起方或响应方等待预期传入消息的时间大于 APS 安全超时周期，则会生成超时错误。	1000（建议使用 6000）
APS Use Insecure Join	控制安全网络重新加入失败时的操作。 如果为 true，则在安全重新加入失败时执行使用 MAC 层关联过程的加入。	true	true / false
APS 层配置参数
APS Duplicate Table Size	APS 层重复拒绝表的大小。 这将删除重复的 APS 数据包。	1	1 或更高
APS Persistence Time	在接收到完整消息后，将保留与传入分段消息关联的资源的时间（以毫秒为单位）。	100	1-255
Maximum Number of Simultaneous Data Requests	没有 APS 确认的同时 APSDE 数据请求的最大数量。 应设置为一次绑定传输中的最大目标节点数。	1	1 或更高
Maximum Number of Simultaneous Data Requests with Acks	具有 APS 确认的同时 APSDE 数据请求的最大数量。 应设置为一次绑定传输中的最大目标节点数。 请注意，APDU 实例的最大数量必须设置为该值的三倍。	3	1 或更高
Inter PAN	如果启用了 PAN 间功能，则为 true	false	true / false
APS Poll Period	处于休眠状态的终端设备收集任何类型数据（接收到的消息、接收到的分段消息和所有传输确认）的轮询周期（以毫秒为单位）。	100	25 或更高
Maximum Number of Received Simultaneous Fragmented Messages	同时分段的 APSDE 传入数据请求的最大数量。 设置为非零值以启用碎片消息的接收（请注意，这会增加堆栈大小）。	0	1 或更高
Maximum Number of Transmitted Simultaneous Fragmented Messages	同时分段的 APSDE 传出数据请求的最大数量。 设置为非零值以启用分段消息的传输（请注意，这会增加堆栈大小）。	0	1 或更高
协调器和路由器的网络层配置参数
Active Neighbour Table Size	活动邻居表的大小。 每个路由节点（协调器或路由器）都有一个邻居表，该表必须足够大，以容纳节点的直接子节点、它自己的父节点以及在网状网络中与节点具有直接无线电的所有对等路由器的条目 沟通。	26	1 或更高
Child Table Size	活动邻居表的持久化子表的大小。 该子表包含节点的父节点和直接子节点的条目。 因此，该值确定允许节点拥有的子节点数 - 它比允许的子节点数大 1，例如 默认值为 5，最多允许 4 个孩子。 此值不得大于 Active Neighbor Table Size 值的三分之二。	5	1 或更高
Address Map Table Size	地址映射的大小，将 64 位 IEEE 地址映射到 16 位网络（短）地址。 应设置为网络中的节点数。	10	1 或更高
Broadcast Transaction Table Size	广播事务处理表的大小。 广播事务表存储广播事务记录，广播事务记录是节点接收到的广播消息的记录。	9	1 或更高
Discovery Neighbour Table Size	发现邻居表的大小。 该表保留与节点关联的相邻设备的列表。	8	8-16
Route Discovery Table Size	路由发现表的大小。 节点使用该表来存储路由发现期间使用的临时信息。 路由发现表条目的持续时间仅与单个路由发现操作的持续时间一样长。	2	1 或更高
Route Record Table Size	路由记录表的大小。 每条路由记录包含目的网络地址、到达目的节点的中继节点数以及中继节点的网络地址列表。	1	1 或更高
Routing Table Size	路由表的大小。 该表存储节点参与消息包路由所需的信息。 每个表条目包含目的地地址、路由状态、各种标志和到达目的地的下一跳的网络地址。 当节点发起新路由或通过节点路由时，会生成路由表条目。 该条目存储在路由表中，并在使用该路由时读取； 仅当路由不再有效时才会删除条目。 如果路由表中有空闲条目，则称该节点具有路由容量。	70	1 或更高
Security Material Sets	支持的网络密钥数。	2	1 或更高
终端设备的网络层配置参数
Active Neighbour Table Size	活动邻居表的大小。 设置为一（对于父级）。	2	1
Address Map Table Size	地址映射的大小，将 64 位 IEEE 地址映射到 16 位网络（短）地址。 应设置为终端设备应用程序需要与之通信的节点数加一（对于父节点）。	10	1 或更高
Broadcast Transaction Table Size	广播事务处理表的大小。 广播事务表存储广播事务记录，广播事务记录是节点接收到的广播消息的记录。	9	1 或更高
Discovery Neighbour Table Size	发现邻居表的大小。 该表保留与节点关联的相邻设备的列表。	8	8-16
Route Discovery Table Size	不适用 - 设置为 1。	2	1
Route Record Table Size	不适用 - 设置为 1。	1	1
Routing Table Size	不适用 - 设置为 1。	70	1
Security Material Sets	支持的网络密钥数。	2	1 或更高
Stack Profile	ZigBee 堆栈配置文件定义了支持的堆栈功能。 ZigBee 设置为 1，ZigBee PRO 设置为 2 或私有堆栈配置文件的任何其他值。	2	0-15

1、Endpoint

参数名称	描述	默认值	范围
Application Device Id	端点的设备ID
Application Device Version	设备的版本号
Enabled	端点是启用还是禁用	true	true / false
End Point Id	端点号（在网络中必须是唯一的）		1-240
Name	端点的文本名称。 在生成宏定义时用作前缀。		有效的C标识符
Profile	端点的应用程序配置文件。 这是指向配置文件定义的链接。

Input Cluster

参数名称	描述	默认值	范围
Cluster	指向将在端点上接收的输入集群的链接。
Receive APDU	将缓冲任何传入消息的 APDU 的链接。
Discoverable	定义输入集群是否出现在用于服务发现的端点简单描述符中。	true	true / false

Output Cluster

参数名称	描述	默认值	范围
Cluster	指向将在端点上传输的输出集群的链接。
Transmit APDUs	将用于传输集群的 APDU 列表
Discoverable	定义输入集群是否将出现在用于服务发现的端点简单描述符中。	true	true / false

2、Bound Addressing Table

指定设备应包含绑定表。 绑定是可选的。 如果使用绑定表，它们位于作为绑定源的任何节点上，但 ZigBee 协调器代表网络中的所有设备处理终端设备绑定请求。 使用绑定表的节点应该分配足够的绑定表条目来处理它们自己的通信需求。

参数名称	描述	默认值	范围
Size	绑定表的大小。 每个绑定表条目包含： • 绑定源的节点地址和端点号 • 绑定目的地的节点地址和端点号 • 绑定的集群 ID 如果绑定是一对多的，那么每个目的地都需要一个表条目。

3、PDU Manager

协议数据单元管理器 (PDUM) 配置是强制性的，必须始终存在。

参数名称	描述	默认值	范围
Number of NPDUs	ZigBee 堆栈可用的 NPDU 数量。 这些是堆栈内部的。	16	8 或更高

APDU

指定一个缓冲区来包含集群的实例。

参数名称	描述	默认值	范围
Instances	此 APDU 的最大实例数。 请注意，此值必须设置为参数“带确认的同时数据请求的最大数量”的值的三倍。
Name	APDU 的名称。 这是应在应用程序 C 代码中用于引用 APDU 的标识符。		有效的 C 标识符
Size	APDU 的最大大小。

4、Group Addressing Table

参数名称	描述	默认值	范围
Size	Group 表的大小。 当前设备上端点的组成员资格通过在组表中添加和删除条目来控制。

5、RF Channels

参数名称	描述	默认值	范围
Channel x (x=11-26)	通道 x 的控制 – 设置为 true 包括能量扫描中的通道。 默认情况下，仅包括通道 15。	x=15 时为真，所有其他值时为假	true / false

6、MAC Interface

指定此设备上存在的接口数。 必须设置一个接口。

参数名称	描述	默认值	范围
Channel List size（如果只有2.4g需要设置为1）	通道掩码数	1	无值范围
Enabled	接口是否启用/禁用	true	true / false
Index	条目索引	0	0 到频道列表大小
Radio Type	2.4G 或 SubGig	RT2400MHz	RT2400MHz / RT868MHz / RT915MHz
Routers Allowed	此接口上是否允许路由器	false	true / false

7、Node Descriptor

参数名称	描述	默认值	范围
描述符可用性参数
Complex Descriptor Available	不支持复杂描述符。 不可编辑。	false	false
User Descriptor Available	指示是否存在用户描述符。 不可编辑。	false	true / false
描述符功能参数
Extended Active Endpoint List Available	指示扩展的活动端点列表是否可用。 不可编辑。	false	false
Extended Simple Descriptor List Available	指示扩展的简单描述符列表是否可用。 不可编辑。	false	false
MAC 功能标志
Allocate Address	指示设备是否将分配短（网络）地址。 不可编辑。		true / false
Alternate PAN Coordinator	指示设备是否将充当备用 PAN 协调器。 不可编辑。		true / false
Device type	指示设备是全功能设备 (FFD) 还是缩减功能设备 (RFD)。 不可编辑。		true / false
Power source	指示设备是否由电源供电。 不可编辑。		true / false
Rx On When Idle	指示设备是否在设备空闲时启用其接收器。 不可编辑。		true / false
Security	指示设备是使用高安全性还是标准安全性。 仅支持标准安全性。 不可编辑。	false	true / false
其他参数
APS flags	不可编辑	0	0
Frequency Band	无线电频段。 JN516x/7x 硬件仅支持 2.4 GHz。 不可编辑。	2.4GHz	2.4GHz
Logical Type	设备类型（即协调器、路由器或终端设备）。 不可编辑。		ZC/ZR/ZED
Manufacturer Code	制造商 ID 代码。这些代码由 ZigBee 联盟分配。		0-65535
Maximum buffer size	最大缓冲区大小。 不可编辑。	127
Maximum incoming transfer size	设备支持的最大传入传输大小。 这是根据输入集群的 APDU 大小计算得出的。 不可编辑。
Maximum outgoing transfer size	设备支持的最大传入传输大小。 这是根据输出集群的 APDU 大小计算得出的。 不可编辑。
系统服务器功能参数
Backup binding table cache	指示节点是否可以充当备份绑定表缓存。 不支持且不可编辑。	false	true / false
Backup discovery cache	指示节点是否可以充当备份发现缓存。 不支持且不可编辑。	false	true / false
Backup trust center	指示节点是否可以充当备份信任中心。 不支持且不可编辑。	false	true / false
Network manager	指示节点是否可以充当网络管理器。 不可编辑。	false	true / false
Primary binding table cache	指示节点是否可以充当主绑定表缓存。 不支持且不可编辑。	false	true / false
Primary discovery cache	指示节点是否可以充当主要发现缓存。 不支持且不可编辑。	false	true / false
Primary trust center	指示节点是否可以充当信托中心。 不可编辑。	false	true / false

8、Node Power Descriptor

参数名称	描述	默认值	范围
可用电源参数
Constant power	指示是否有恒定电源可用。	false	true / false
Disposable Battery	指示是否有一次性电池电源可用。	false	true / false
Rechargable Battery	指示可充电电池电源是否可用。	false	true / false
其他参数
Default power mode	设备的默认电源模式。	与 Rx On When Idle 同步	与 Rx On When Idle / Periodic / Constant Power 同步
Default power source	设备的默认电源。	Constant / rechargeable / disposable	Constant

9、APS Key Table

参数名称	描述	默认值	范围
Size	密钥描述符表的大小		1 或更高

Preconfigured Key

参数名称	描述	默认值	范围
IEEE address	与密钥一起使用的 IEEE 地址。		64 位
Key	预配置密钥的值		128 位

10、Trust Center

必须在每个节点的密钥描述符表中预先设置信任中心链接密钥。

参数名称	描述	默认值	范围
Device Table Size	信托中心设备表的大小。	ZigBee PRO 无线网络的最大节点数设置	1 或更高

11、ZDO Configuration

指定设备上存在哪些 ZigBee 设备对象 (ZDO) 服务器。 其中大部分对于 ZCP 是强制性的。

Default Server

强制性的。 回复任何未实现的服务器请求。

参数名称	描述	默认值	范围
Output APDU	回复未实现的服务器请求消息时使用的 APDU。	apduZDP

ZDO Client

强制性的。处理ZDO客户端消息。

参数名称	描述	默认值	范围
Output APDU	回复 ZDO 客户端消息时使用的 APDU。	apduZDP

Device Annce Server

强制性的。处理设备公告。

参数名称	描述	默认值	范围
Output APDU	在回复设备通知消息时要使用的APDU。	apduZDP

Active Ep Server

强制性的。处理活动的端点请求。

参数名称	描述	默认值	范围
Output APDU	在响应活动的端点请求消息时要使用的APDU。	apduZDP

Nwk Addr Server

强制性的。处理网络地址发现请求。

参数名称	描述	默认值	范围
Output APDU	回复网络地址发现请求消息时使用的 APDU。	apduZDP

IEEE Address Server

强制性的。处理IEEE地址发现请求。

参数名称	描述	默认值	范围
Output APDU	在回复IEEE地址发现请求消息时使用的APDU。	apduZDP

System Server Discovery Server

强制性的。处理系统服务器发现请求。

参数名称	描述	默认值	范围
Output APDU	在响应系统服务器发现请求消息时使用的APDU。	apduZDP

Permit Joining Server

强制性的。处理“允许加入”请求。

参数名称	描述	默认值	范围
Output APDU	在响应允许加入请求消息时使用的APDU。	apduZDP

Node Descriptor Server

强制性的。处理节点描述符请求。

参数名称	描述	默认值	范围
Output APDU	在响应节点描述符请求消息时要使用的APDU。	apduZDP

Power Descriptor Server

强制性的。处理节点电源描述符请求。

参数名称	描述	默认值	范围
Output APDU	在响应电源描述符请求消息时要使用的APDU。	apduZDP

Match Descriptor Server

强制性的。处理与之相匹配的描述符请求。

参数名称	描述	默认值	范围
Output APDU	在响应匹配描述符请求消息时要使用的APDU。	apduZDP

Simple Descriptor Server

强制性的。处理简单的描述符请求。

参数名称	描述	默认值	范围
Output APDU	在响应简单描述符请求消息时要使用的APDU。	apduZDP

Mgmt Lqi Server

强制的。 处理管理 LQI 请求。

参数名称	描述	默认值	范围
Output APDU	在响应链接质量指示器(LQI)请求消息时要使用的APDU。	apduZDP

Mgmt Rtg Server

强制性的。处理管理路由请求。

参数名称	描述	默认值	范围
Output APDU	在响应管理路由请求消息时要使用的APDU。	apduZDP

Mgmt Leave Server

强制性的。处理管理离开请求。

参数名称	描述	默认值	范围
Output APDU	回复管理离开请求消息时使用的 APDU。	apduZDP

Mgmt NWK Update Server

强制性的。处理管理网络更新请求。

参数名称	描述	默认值	范围
Output APDU	在响应管理网络更新请求消息时要使用的APDU。	apduZDP

Bind Unbind Server

强制的。 处理绑定和取消绑定请求。

参数名称	描述	默认值	范围
Output APDU	在响应绑定和解除绑定请求消息时使用的APDU。	apduZDP

Extended Active Ep Server

强制性的。处理扩展的活动端点发现请求。

参数名称	描述	默认值	范围
Output APDU	在响应扩展的活动端点发现请求消息时要使用的APDU。	apduZDP

Extended Simple Descriptor Server

强制性的。处理扩展的简单描述符发现请求。

参数名称	描述	默认值	范围
Output APDU	在响应扩展的简单描述符发现请求消息时要使用的APDU。	apduZDP

End Device Bind Server

强制性（仅限协调员）。 处理终端设备绑定请求。

参数名称	描述	默认值	范围
Output APDU	回复终端设备绑定请求消息时使用的 APDU。	apduZDP
Timeout	终端设备绑定请求超时之前的秒数。	5	1 更高
Bind Num Retries	如果绑定请求（zdo_bind_req 或 end_device_bind_req）失败，则尝试绑定重试的次数。

Parent Announcement Server

在协调器和路由器设备上是必需的。

参数名称	描述	默认值	范围
Output APDU	回复父公告广播消息时使用的 APDU。

Management Enhanced Network Update Server

Sub Gig 是强制性的； 2.4G可选。

参数名称	描述	默认值	范围
Output APDU	回复管理增强型网络更新请求消息时使用的 APDU。	apduZDP

MIB IEEE List Server

Sub Gig 中的路由器是必需的； 2.4G 可选。

参数名称	描述	默认值	范围
Output APDU	回复 MIB IEEE 请求消息时使用的 APDU。	apduZDP