Zigbee Commissioning_综合

1. 概述

从事zigbee设备开发的人对commission这个词应该不陌生，可译为"使服役"，大概意思对了，但是不太明朗。在HA的规范文档中将其定义为：

to put a device in an operational state

意思是 使设备变成可操作状态（的行为）。这下清晰了，就是让设备从某个状态变成用户可使用状态的一些行为规范，这些行为大致可分为两阶段：一是创建网络或者加入网络，二是查找匹配和绑定。

本文将介绍在HA与zigbee3.0中的commissioning规范，HA中的规范较为简单，便于读者理解。zigbee3.0整合兼容了不同application profile（HA、ZLL、SE等）的不同规范，如touchlink、ez-mode。并且支持更加灵活的commissioning搭配，因此zigbee3.0中的commissioning规范更加复杂，但是咯，协议栈中都会实现大部分的，无需完全自己实现。

2. HA中的commissioning

HA中包含两种commissioning方式，ez-mode和Centralized commissioning。

2.1 ez-mode

ez-mode包含network steering和finding and binding两个流程。network steering流程中设备要完成入网和允许其他设备入网的操作，执行流程如图1。

Zigbee Commissioning

图1 ez-mode的network steering流程

finding and binding流程中完成查找网络中处于ez-mode状态的端点，并与这些端点的确认cluster是否匹配，是则进行绑定。这个过程中主动查找的端点称为initiator，被查找端点称为target，其执行流程分别见图2、图3。通常情况下，控制器属于initiator，对应被控制端点为target，如Doorlock controler属于initiator，Doorlock属于target，详见[1]：ez-mode commissioning章节。

Zigbee Commissioning

图2 initiator find and binding流程

Zigbee Commissioning

图3 target find and binding流程

2.2 Centralized commissioning

指通过网关或其他具有对设备进行配置能力的设备对设备进行配置，通常是人为配置。

3 zigbee3.0中的commissioning

zigbee3.0中最重要的内容就是增加了bdb（Base-Device-Behavior-Specification），描述了设备环境变量、commissioning、网络重置、安全、报告等内容。为了兼容不同application proflle（HA、ZLL、SE等）的commissioning规范，bdb中新增很多属性用于控制和表示commissioning的状态和结果，与commissioning相关属性如表1，commissioningStatus属性的值见表2。

zigbee3.0中的commissioning有以下Network steering、Network formation、Finding & binding 和 Touchlink四种方式。Network steering对所有节点都是必须的，Touchlink对所有节点都是可选的，剩余两者对于特定设备是必须的。 zigbee3.0引入top level commissioning流程用于所支持四种方式的管理。

表1 – bdb中与commissioning相关的属性

Attribute	Data type	Range	Default value	Used by
bdbCommissioningGroupID	Unsigned 16-bit	0x0001 – 0xffff	0xffff	Initiator nodes， per endpoint
bdbCommissioningMode	8-bit bitmap	0b0000 xxxx	0b0000 0000	All nodes, per endpoint
bdbCommissioningStatus	Enumeration	见表2	SUCCESS	All nodes, per endpoint
bdbNodeCommissioning-Capability	8-bit bitmap	0b0000 xxx1	0b0000 0001	All nodes
bdbNodeIsOnANetwork	Boolean	TRUE or FALSE	FALSE	All nodes
bdbPrimaryChannelSet	32-bit bitmap	0x00000800 – 0x07fff800	0x02108800	All nodes
bdbSecondaryChannelSet	32-bit bitmap	0x00000800 – 0x07fff800	0x07fff800 XOR bdbPrimary- ChannelSet	All nodes

表2 - bdbCommissioningStatus 属性值

值	描述
SUCCESS	The commissioning sub-procedure was successful. 子流程执行成功
IN_PROGRESS	One of the commissioning sub-procedures has started but is not yet complete. 某个子流程在执行中
NOT_AA_CAPABLE	The initiator is not address assignment capable during touchlink. touchlink期间发起者不具备地址分配能力
NO_NETWORK	A network has not been found during network steering or touchlink. network steering or touchlink期间没发现网络
TARGET_FAILURE	A node has not joined a network when requested during touchlink.
FORMATION_FAILURE	A network could not be formed during network formation. 创建网络失败
NO_IDENTIFY_QUERY_- RESPONSE	No response to an identify query command has been received during finding & binding. finding & binding期间没有收到identify query command响应
BINDING_TABLE_FULL	A binding table entry could not be created due to insufficient space in the binding table during finding & binding. finding & binding期间由于绑定表满失败
NO_SCAN_RESPONSE	No response to a scan request inter-PAN command has been received during touchlink.
NOT_PERMITTED	A touchlink (steal) attempt was made when a node is already connected to a centralized security network.
TCLK_EX_FAILURE	The Trust Center link key exchange procedure has failed attempting to join a centralized security network.