ZigBee学习之18—ZCL解读

#1楼主：【原创】ZigBee学习之18——ZCL解读文章发表于：2010-02-0816:29ZigbeeClusterLibrary(ZCL)（Zigbee簇群库）[Z-StackZCLAPI_F8W-2006-0020_.pdf]ZCL是Zigbee1.1（Zigbee2006）协议版本中增加的一个重要的部分。在Zigbee中，一个簇群就是一个容器，在容器中以命令结构体包含了一个或多个属于某个应用剖面的属性/消息，不管应用剖面如何，相同的设备（比如开关）拥有相同的定义和功能。属性是设备的变量或特性，能够设置或获得。比如设置自动调温器的加热点。ZCL提供了一种机制，利用这种机制设备能够将变化异步地报告给属性（attribute），比如当空气变热时自动控温器服务器就将室温改变报告给他的客户端，这个过程不需要客户端发起请求。ZCL采用客户端/服务器模块的模式，一般储存簇属性的作为服务器，影响或操作属性的作为客户端。然而如果需要，属性也可以呈现在客户端上。例如，设备通过读写属性的命令来操作属性，这些命令从客户端设备发送到服务器设备；对这些命令的应答从服务器设备发送到客户端设备；但是报告属性命令是从服务器发送到客户端。clusterID是每个簇的标志，由剖面分配，在内部使用的是逻辑簇ID，所以还有一个ClusterID转换表。typedefstruct{uint16attrId;//AttributeIDuint8dataType;//DataType-definedinAF.huint8accessControl;//Read/write-bitfieldvoid*dataPtr;//Pointertodatafield}zclAttribute_t;typedefstruct{uint16clusterID;//RealclusterIDzclAttribute_tattr;}zclAttrRec_t;typedefstruct{zclGCB_BasicReset_tpfnBasicReset;//BasicResetzclGCB_Identify_tpfnIdentify;//IdentifyResponsezclGCB_IdentifyQueryRsp_tpfnIdentifyQueryRsp;//IdentifyQueryRspzclGCB_OnOff_tpfnOnOff;//On/OffclusterzclGCB_LevelControlMoveToLevel_tpfnLevelControlMoveToLevel;//MoveToLevelzclGCB_LevelControlMove_tpfnLevelControlMove;//MovezclGCB_LevelControlStep_tpfnLevelControlStep;//StepzclGCB_LevelControlStop_tpfnLevelControlStop;//StopzclGCB_GroupRsp_tpfnGroupRsp;//GroupResponsezclGCB_SceneStoreReq_tpfnSceneStoreReq;//SceneStoreRequestzclGCB_SceneRecallReq_tpfnSceneRecallReq;//SceneRecallRequestzclGCB_SceneRsp_tpfnSceneRsp;//SceneResponsezclGCB_Alarm_tpfnAlarm;//AlarmReq&RspzclGCB_Location_tpfnLocation;//RSSILocationzclGCB_LocationRsp_tpfnLocationRsp;//RSSILocationRsp}zclGeneral_AppCallbacks_t;创建一个ZCL应用至少需要创建4个模块：·zcl_appname.h应用的定义,应用的终端也定义在此·zcl_appname_data.c数据定义和声明，包含以下内容：应用支持的所有簇属性；属性表中每个属性包含一个zclAttrRec_t类型的入口；分别包含应用指定的输入和输出clusterID的输入clusterID表和输出clusterID表，这些表将和简单描述表一起使用；SimpleDescriptionFormat_t[AF.h]类型的简单描述表。·zcl_appname.cendPointDesc_t[AF.h]类型的应用终端表声明；创建用以处理来自ZCL簇的命令的命令回调函数，这些函数和命令回调表一起使用；ZCL功能域（functionaldomains）的应用命令回调表声明。通用功能域的表类型为：zclGeneral_AppCallbacks_t[zcl_general.h]；为应用任务创建应用初始化函数voidzclAppName_Init(bytetask_id)；此函数应该注册：1、相应功能域的命令回调表，zclGeneral_RegisterCmdCallbacks()[zcl_general.c]用来注册通用簇命令回调；2、用zcl_registerAttrList()[zcl.c]注册应用属性列表；3、用afRegister()[AF.h]注册应用终端；4、用RegisteRForKeys()[OnBoard.c]注册所有处理按键事件的应用任务；5、用zclHA_Init()[zcl_ha.c]注册HA剖面层的应用简单描述。创建用于接收和处理消息以及应用任务队列中关键事件的函数uint16zclAppName_event_loop(uint8task_id,uint16events)。·OSAL_AppName.c此模块应该包含voidosalAddTasks(void)函数，此函数包含添加到任务列表中的应用所需的任务和应用任务本身。使用osalTaskAdd()[OSAL_Tasks.c]来完成任务的添加。在此展示一个最小的任务列表，他们的添加顺序是一个简单ZCL应用所需的：1.HAL2.MAC3.Network4.APS5.ZDApplication6.ZCL7.ZCLApplication功能层功能层提供了操作属性和其他一般任务的一般命令：?Readattributes?Readattributesresponse?Writeattributes?Writeattributesundivided?Writeattributesresponse?Writeattributesnoresponse?Configurereporting?Configurereportingresponse?Readreportingconfiguration?Readreportingconfigurationresponse?Reportattributes?Defaultresponse?Discoverattributes?Discoverattributesresponse通用功能域包含以下簇：?Basic?PowerConfiguration?DeviceTemperatureConfiguration?Identity?Groups?Scenes?On/Off?On/OffSwitchConfiguration?LevelControl?Alarms?Time?RSSIIndication在文档的最后给出了ZCL的编译选项，也就是控制使用哪些ZCL功能的预编译项。