定 ACLSecurityMaterialLength 整型 0~26 ACLSecurityMaterial中包含的字节数 特定关键要素，用于保护字节ACLSecurityMaterial 可变 串 MAC层和连接空字节串 21 ACLExtendedAddress指定的设备之间的帧 安全方案的唯一标识符保护MAC层与连接由0x00 ACLSecuritySuite 整型 0x00~0x07 ACLExtendedAddress所指定的设备之间通信
2.9.3 网络层 2.9.3.1 网络层常量
常量 有效值范围 在初始化时设定 描述 布尔标记，表明设备是否具有成为zigbee协调器的能力。其中0x00表明设备不具有这样的能力；0x01表明设备具有成为zigbee的协调器能力 nwkcDefaultSecurityLevel nwkcDiscoveryRetryLimit nwkcMaxDepth ENC-MIC-64 0x03 0x07 使用的缺省安全级别 路由发现重试的最大次数 一台设备拥有的最大深度（离zigbee协调器的最小逻辑跳数） nwkcMaxFrameOverhead 0x0d 由网络层加到载荷中的最大字节数（不考虑安全性）。如果帧考虑安全性，安全处理可能使得帧长度超过此值 nwkcMaxPayloadSize aMaxMACFrameSize-nwkcMaxFrameOverhead nwkcProtocolVersion nwkcRepairThreshold nwkcRouteDiscoveryTime nwkcMaxBroadcastJitter nwkcInitialRREQRetries nwkcRREQRetries 0x01 0x03 0x2710 0x40 0x03 0x02 设备中zigbee网络层协议的版本 路由维护机制初始化后，所能允许的最大通信错误数 直到路由发现终止，所需的持续时间（毫秒） 最大的广播不稳定时间（毫秒） 路由请求命令帧的第一个广播传输的重试次数 中间zigbee路由器或协调器路，中继路由请求命令帧广播重传的次数 nwkcRREQRetryInterval nwkcMinRREQJitter 0xfe 0x01 广播路由请求命令帧重传的间隔毫秒 路由请求命令帧广播重传的最小不稳定（2毫秒时隙） nwkcMaxRREQJitter 0x40 路由请求命令帧广播重传的最大不稳定（同上） 在网络层帧载荷域中所能传输的最大字节数 nwkcCoordinatorCapable
第 36 页 共 107 页
2.9.3.2 网络层信息库(NWK PIB) 属性 代码 类型 整型 nwkBCSN 0x81 有效值范围 0x00~0xff 描述 加到传输广播帧上的序列号 缺省 范围内的随机 nwkPassiveAckTimeout 0x82 整型 0x00~0x0a 父设备与所有子设备重传广播信息的最长持续时间（单位秒，被动确认超时） nwkMaxBroadcastRetries nwkMaxChildren nwkMaxDepth 0x83 0x84 0x85 整型 整型 整型 0x00~0x5 0x00~0xff 0x00~nwkMaxDepth nwkMaxRouters 0x86 整型 0x01~0xff 设备所能接入的路由器数。网络中所有设备的值都有zigbee的协调者来决定 nwkNeighborTable 0x87 设置 可变 设备中现有的邻居表 未设置 nwkNetworkBroadcastDeliveryTime 0x88 整型 （nwkPassiveAckTimeout×nwkBroadcastReries）~0xff 广播信息漫布整个网络的持续时间（单位，秒） nwkPassiveAckTimeout×nwkBroadcastReries nwkReportConstantCost 0x89 整型 0x00~0x01 如果设为0，则网络层将使用MAC层所报告的LQI值计算所有邻居节点链路成本。否则他将报告一个常量值 nwkRouteDiscoveryRetriesPermitted 0x8a 整型 0x00~0x03 在失败的路由请求之后允许重试的次数 nwkcDiscoveryRetryLimit nwkRouteTable 0x8b 设置 可变 设备的现有路由表 未设置 nwkSecureAllFranes 0x8c 整型 0x00~0x01 表明是否对进出的帧进行安全保护。如果设为0x01则保护进程应用到除以拥有帧控制安全子域为0的现有设备为目标的数据帧外的其他帧中。如果属性值为0x01的网络层将不能中继帧控制安全子域值为0的帧。NLDE-DATA.request原语的安全参数应超过此属性的设置 nwkSecurityLevel 0x8d 整型 可变 现有的安全级别设置 nwkDefaultSecurityLevel 0x00 0x00 0x05 广播传输出错后最大重试次数 现有网络上所能拥有的最大子设备数 设备拥有的深度 0x03 0x07 0x05 0x03 第 37 页 共 107 页
nwkSymLink 0x8e 布尔型 TRUEFALSE 或现有的路由对称设置TRUE，表示路由器默认由对称链路组成。路由发现期间建立了前向和后向路由，并且二者是相同的。FALSE表示路由不是有对称链路组成。在路由发现期间只有前向路由被保护 nwkCapabilityInformation 0x8f 比特组 见另一表 包含网络连接期间建立的设备能力信息 0x00 错误
2.10 ZigBee重要结构及表解释
各表中的元素结构：
1、组表的元素结构 aps_Group_t; typedef struct {
uint16 ID; // 组ID
uint8 name[APS_GROUP_NAME_LEN]; // 组名称 } aps_Group_t;
2、组列表的元素结构 typedef struct apsGroupItem {
struct apsGroupItem *next; //指向下一个组表条目 uint8 endpoint; //此终端接收发送给组的信息 aps_Group_t group; //组ID和组名 } apsGroupItem_t;
3、路由表的元素结构 rtgEntry_t; typedef struct {
uint16 dstAddress; //目标地址 uint16 nextHopAddress; //单跳地址 byte expiryTime; //有效时间 byte status; //状态 } rtgEntry_t;
4、绑定表的元素结构 BindingEntry_t; typedef struct {
uint8 srcEP; // 没有源地址自从源地址一直是本地设备 uint8 dstGroupMode; // 目标地址类型; 0 –正常地址, 1 – 组地址 uint16 dstIdx; //在两种模式中 (组或非组) 保存到 NV 和RAM // dstGroupMode = 0 - Address Manager index // dstGroupMode = 1 – 组地址 uint8 dstEP; //目标地址 uint8 numClusterIds; //簇个数
uint16 clusterIdList[MAX_BINDING_CLUSTER_IDS];
第 38 页 共 107 页
// Don't use MAX_BINDING_CLUSTERS_ID when // using the clusterIdList field. Use // gMAX_BINDING_CLUSTER_IDS } BindingEntry_t;
5、相邻表的元素结构 neighborEntry_t; typedef struct {
uint16 neighborAddress; //相邻地址
uint16 panId; //所属的PAN网络ID
linkInfo_t linkInfo; //连接信息（包括发送/接收和安全帧计数） } neighborEntry_t;
6、路由发现表的元素结构 rtDiscEntry_t; typedef struct {
byte rreqId; //接收请求ID uint16 srcAddress; //源地址
uint16 previousNode; //上次模式 byte forwardCost; //发送成本 byte residualCost; //剩余成本 byte expiryTime; //有效时间 } rtDiscEntry_t;
7、广播表的元素结构 bcastEntry_t; typedef struct {
uint16 srcAddr; //源地址 uint8 bdt; // 广播传递时间 uint8 pat; // 被动应答超时
uint8 mbr; // 最大广播重试次数 uint8 handle;
// 计数非睡眠邻居和路由器子节点. uint8 ackCnt; //应答次数 uint8 id; //广播ID } bcastEntry_t;
8、回调表的元素结构 MTZDO_ConversionItem_t; typedef struct {
uint16 clusterID; //请求命令
uint32 subCBID; // 回调回应参数 uint16 mtID; // SPI 消息ID
pfnMtZdoRspProc pFn; //回调函数 } MTZDO_ConversionItem_t; 9、电源功率表
macRadioDefsTxPowerTable
10、全局常量表元素结构（即NV区中的项） zgItem_t;
第 39 页 共 107 页
typedef struct zgItem {
uint16 id; //项目类? uint16 len; //占用空间 void *buf; //要写入的数据 } zgItem_t;
11、任务表元素结构 *pTaskEventHandlerFn; ( unsigned char task_id, unsigned short event ); 12、mac回调函数事件表 zmacCBEventTable; 13、数据结构大小查找表 zmacCBSizeTable; 必须以mac回调事件顺序相匹配；
14、ZDP处理请求消息表的元素结构 zdpMsgProcItem_t; typedef struct {
uint16 clusterID; //--簇ID(请求消息) pfnZDPMsgProcessor pFn; //要执行的函数 } zdpMsgProcItem_t;
15、PAN网络描述列表的元素结构 networkDesc_t; typedef struct {
uint16 panId; //PAN ID
byte logicalChannel; //逻辑信道 byte beaconOrder; //信标指令 byte superFrameOrder; //超级帧指令 byte routerCapacity; //路由能力 byte deviceCapacity; //设备能力 byte version; //版本
byte stackProfile; //profilestack //byte securityLevel;
uint16 chosenRouter; //所选择的路由器
uint8 chosenRouterLinkQuality; //所选择路由器的链路质量 byte chosenRouterDepth; //所选择路由器的深度
uint8 extendedPANID[Z_EXTADDR_LEN]; //PAN ID的扩展地址 void *nextDesc; //指向下一个的PAN } networkDesc_t;
16、端点表元素结构 endPointDesc_t; typedef struct {
byte endPoint; //终端号
byte *task_id; // Pointer to location of the Application task ID. //–指向本地应用任务,ID的一个指针
SimpleDescriptionFormat_t *simpleDesc; //指向简单描述符
afNetworkLatencyReq_t latencyReq; //这个字段必须为nolatencyreqs } endPointDesc_t;
第 40 页 共 107 页