Silicon Lab Ember Zigbee学习杂谈------zcl extension

本文将讲述Ember zigbee如何对cluster library进行扩展，添加自定义cluster、command。

（参考文档：UG102-AppFrameworkDevGuide --16 Extending the ZigBee Cluster Library (ZCL)）

Silicon Lab开发了一整套zigbee开发工具能够帮助开发者迅速开发产品，但是由于其底层代码并不开源，而且目前在中国技术支持力度不够并且价格相对比较昂贵，导致并没有被太多开发者所了解。本人也从事智能家居的开发使用的就是Silicon Lab的zigbee模块em3xx系列，一边学习，一边与大家分享，希望有了解的大神多多指教。

ember zigbee协议栈本身包含了丰富的cluster和相应的command，能满足大部分应用，而且是符合zigbee联盟制定的协议规范的，所以这部分是可以与其它符合zigbee标准协议的厂商直接对接使用的，但是针对不同公司，需要有自己的特色即产品差异化。那么就需要针对自己产品独特的cluster和command即custom cluster和custom command。ember提供很好的cluster扩展性，以下为步骤：

1、需要定义自己的xml文件，文件格式如下：（可在安装目录/tool/appbuilder找到sample-extensions.xml）

-<configurator>

-<cluster manufacturerCode="0x1002">

<name>Sample Mfg Specific Cluster</name>

<domain>Ember</domain>

<description>This cluster provides an example of how the Application Framework can be extended to include manufacturer specific clusters. </description>

<define>SAMPLE_MFG_SPECIFIC_CLUSTER</define>

<attribute optional="true" default="0x00" writable="true" max="0xFF" min="0x00" type="INT8U" define="ATTRIBUTE_ONE" code="0x0000" side="server">ember sample attribute</attribute>

-<command name="CommandOne" optional="true" code="0x00" source="client">

<description> A sample manufacturer specific command within the sample manufacturer specific cluster. </description>

</command>

</cluster>

-<clusterExtension code="0x0006">

<!-- 选择要扩展的cluster ID，本例中扩展的是on-off（0x0006）-- >

<attribute manufacturerCode="0x1002" optional="true" default="0x0000" writable="true" max="0xFFFF" min="0x0000" type="INT16U" define="SAMPLE_MFG_SPECIFIC_TRANSITION_TIME" code="0x0000" side="server">Sample Mfg Specific - Transition Time</attribute>

-<command name="SampleMfgSpecificOffWithTransition" manufacturerCode="0x1002" optional="true" code="0x00" source="client">

<description>Client command that turns the device off with a transition given by the transition time in the Ember Sample transition time attribute.</description>

</command>

-<command name="SampleMfgSpecificOnWithTransition" manufacturerCode="0x1002" optional="true" code="0x01" source="client">

<description>Client command that turns the device on with a transition given by the transition time in the Ember Sample transition time attribute.</description>

</command>

-<command name="SampleMfgSpecificToggleWithTransition" manufacturerCode="0x1002" optional="true" code="0x02" source="client">

<description>Client command that toggles the device with a transition given by the transition time in the Ember Sample transition time attribute.</description>

</command>

</clusterExtension>

</configurator>

在上例中，定义了一个叫Ember的自定义cluster类，并自定义了名叫Sample Mfg Specific Cluster自定义cluster。该cluster下有一个叫ember sample attribute属性，与该属性相关的有一条CommandOne命令，该命令只有一个int8u的参数。同时扩展了on-off cluster，自定义了Sample MFG Specific Transition Time属性，并且定义了3条相关的指令SampleMfgSpecificOffWithTransition、SampleMfgSpecificOnWithTransition、SampleMfgSpecificToggleWithTransition。

2、将该文件导入到Appbuilder

打开ember desktop，选择file->preference打开preference选项卡，选择ZCL aplication，选择你正在使用的协议栈，图中选择的是5.6 GA EM35X,勾选Enable custom clusters，点击add按钮将你的xml文件添加进来，如下图所示。

完成以上两步后，再新建一个工程或打开一个工程会发现：

之后使用方法同普通cluster coammd一样，比如在client-command-macro.h中能找到你定义的命令填充macro：

/** @brief Client command that turns the device off with a transition given
        by the transition time in the Ember Sample transition time attribute.
*
* Cluster: On/off, Attributes and commands for switching devices between 'On' and 'Off' states.
* Command: SampleMfgSpecificOffWithTransition
*/
#define emberAfFillCommandOnOffClusterSampleMfgSpecificOffWithTransition() \
emberAfFillExternalManufacturerSpecificBuffer((ZCL_CLUSTER_SPECIFIC_COMMAND \
                                                 | ZCL_MANUFACTURER_SPECIFIC_MASK \
                                                 | ZCL_FRAME_CONTROL_CLIENT_TO_SERVER), \
                                                ZCL_ON_OFF_CLUSTER_ID, \
                                                0x1002, \
                                                ZCL_SAMPLE_MFG_SPECIFIC_OFF_WITH_TRANSITION_COMMAND_ID, \
                                                "");

/** @brief Client command that turns the device on with a transition given
        by the transition time in the Ember Sample transition time attribute.
*
* Cluster: On/off, Attributes and commands for switching devices between 'On' and 'Off' states.
* Command: SampleMfgSpecificOnWithTransition
*/
#define emberAfFillCommandOnOffClusterSampleMfgSpecificOnWithTransition() \
emberAfFillExternalManufacturerSpecificBuffer((ZCL_CLUSTER_SPECIFIC_COMMAND \
                                                 | ZCL_MANUFACTURER_SPECIFIC_MASK \
                                                 | ZCL_FRAME_CONTROL_CLIENT_TO_SERVER), \
                                                ZCL_ON_OFF_CLUSTER_ID, \
                                                0x1002, \
                                                ZCL_SAMPLE_MFG_SPECIFIC_ON_WITH_TRANSITION_COMMAND_ID, \
                                                "");

注：在EZSP架构中，方法相同，只需要在Host和end device扩展即可

Silicon Lab Ember Zigbee学习杂谈------zcl extension相关推荐

Silicon Lab Ember zigbee学习杂谈---zcl frame解析
这篇文章主要讲一下zcl命令的帧结构: 所有zcl桢都包含包头和有效负载两部分,如下图: 包头包括控制字节(frame control).制造商ID(manufacturer code).序列号(Tr ...
ZigBee学习----之ZCL（ZigBee Cluster Library）
1. ZCL简介: ZCL: ZigBee Cluster Library 可以理解为Zigbee在开发一些特性功能的cluster时所用的一些库.开发者在开发应用profile时需要用到对应ZCL ...
【ember zigbee】序章:协议栈相关文档学习笔记
原文地址:https://blog.csdn.net/tainjau/article/details/90648114 文章目录写在前面一.材料出处二.文档解析 2.1.EZSP Protoco ...
ZigBee Silicon Labs/Ember EFR32MG/EM357 1.1 总体框架
开启ZigBee新篇章,陆续更新,欢迎关注~ 第一章总体框架 (已发布 V1 20180201)ZigBee Silicon Labs/Ember EFR32MG/EM357 1.1 总体框架(&l ...
Zigbee学习（一）架构及入网
Zigbee学习(一)架构及入网文章目录 Zigbee学习(一)架构及入网前言一.zigbee是什么? 1.zigbee的特点 2.zigbee的重要概念二.zigbee架构 1.PHY物理层 ...
EFR32芯科zigbee学习文档资源总结
硬件相关 efr32mg21外设例程世强资源 [经验]如何将EFM32和EFR32的烧录引脚配置成GPIO? [经验]多协议无线 SOC EFR32MG实现ZigBee的OTA操作指南在rejoi ...
zigbee学习参考（1~42 ）
[原创]ZigBee学习之1--SPI&LCD - 小组 - EDN China [原创]ZigBee学习之2--SPI&LCD - 小组 - EDN China ZigBee学习之3 ...
第三章：zigbee学习笔记之物理层和mac层帧格式分析
本文原地址:https://blog.csdn.net/tainjau/article/details/81634681 IEEE802.15.4工作组致力于无线个人区域网络(wireless per ...
Zigbee学习笔记
作为一个硬件从业人员,虽然不是从事物理网行业的,但是多少得了解一些,以下是笔者最近学习Zigbee的笔记,包含了Zigbee基本知识,正确的学习方法. Zigbee无线传感网络先搞清楚IEEE802 ...

Silicon Lab Ember Zigbee学习杂谈------zcl extension

Silicon Lab Ember Zigbee学习杂谈------zcl extension相关推荐

最新文章

热门文章