Zigbee快速入门第五节 – 在设备上使用API发送，接收和处理On-Off命令

最新推荐文章于 2022-03-05 10:31:52 发布
最新推荐文章于 2022-03-05 10:31:52 发布
阅读量1.1k 收藏 1
点赞数
分类专栏： Zigbee 文章标签： zigbee
原文链接：http://www.smartlabs.cn/288/
版权

1. 简介

1.1. 实验内容

Zigbee快速入门——新兵训练营系列培训的实验环节将涵盖以下四个部分。我们通过这四个部分来向大家逐步展示，如何从零开始构建一个Zigbee应用。

本文档中的实验是“Zigbee快速入门——新兵训练营”系列中的第二部分。

  • 第一部分，由Light构建网络，并使用install code将Switch加入到这个网络。
  • 第二部分，在设备上使用API发送，接收和处理On-Off命令。
  • 第三部分，在Switch端用一个周期事件来执行自定义代码，在我们的实验中是控制LED闪烁。
  • 第四部分，在Switch端使用非易失性存储器来存储自定义数据。

1.2. 目的

在之前的动手实验“建网入网”中，我们学习了如何构建基本的集中式Zigbee网络并加入该网络。在本动手实验中，我们将演示如何从Switch节点向Light节点发送开关命令，以操控Light节点的LED。
与以前的动手实验相同，该网络将使用两个设备，即两个BRD4162A（EFR32MG12）开发板。
下图说明了该实验的流程。

我们再次强调，在开始实验之前需要作一些基本的确认，保证硬件平台及软件环境都已经准备就绪，以避免在开发过程中出现不必要的问题。

2. 基本步骤

无论在实验中创建的是什么应用程序或设备类型，在开始开发之前都要作以下检查准备工作。

2.1. 硬体需求

  • 2个无线入门套件 (WSTK) 主板
  • 2个EFR32MG12无线板（BRD4162A）

2.2. 软件需求

确保已在PC上安装了最新的EmberZNet SDK（在本文撰写时为v6.6.4）和兼容的GCC工具链。

2.2.1. 检查EmberZNet SDK

  1. 启动Simplicity Studio v4。
  2. 转到Windows ->Preference -> Simplicity Studio-> SDK，确保已安装“ EmberZNet 6.6.4”。
    它是Gecko SDK Suite 2.6.4的一部分，因此并不单独出现。请参见下面的图2-1。

图2-1 检查已安装的EmberZNet SDK

2.2.2. 检查工具链

  1. 转到Windows->Preference -> Simplicity Studio->Toolchains，确保已安装GCC工具链。
    在构建项目时所使用的工具链版本应当与构建SDK附带的库文件的工具链版本相同。用户可以在此处找到正确的工具链-SDK对应关系。请参见下面的图2-2。

图2‑2 检查工具链

2.2.3. 使用Gecko Bootloader

Bootloader是存储在预留的闪存中的一段程序，可以初始化设备，更新固件image并可能执行某些完整性检查。如果怀疑应用程序没有运行，请始终检查Bootloader，因为缺少Bootloader会导致程序无法运行。
注意: 在本系列实验的开始，强烈建议对设备用Gecko SDK随附的预编译的Bootloader image进行烧录。应当用以“ -combined”结尾的image（例如，bootloader-storage-internal-single-combined.s37）烧录，这个image包含Gecko Bootloader的第一和第二阶段。该image可以在如下位置找到c:\SiliconLabs\SimplicityStudio\v4\developer\sdks\gecko_sdk_suite\v2.6\platform\bootloader\sample-apps\bootloader-storage-internal-single\efr32mg12p332f1024gl125-brd4162a\

想知道有关如何将Gecko Bootloader添加到Zigbee项目的更多信息，请阅读Zigbee预备课程。
提示: 有关Gecko Bootloader的更多信息，请参见下面的文档。
UG266: Silicon Labs Gecko Bootloader User’s Guide
UG103.6: Bootloader Fundamentals
AN1084: Using the Gecko Bootloader with EmberZNet and Silicon Labs Thread

3. 发送On/Off命令

在之前的动手实验中，我们创建了两个项目，Zigbee_Light_ZC和Zigbee_Switch_ZR，这两个设备现在处于同一网络中，并准备好可以在网络上发送和接收数据。
在本实验中，Switch设备应基于所按下的按钮来发送“打开/关闭”命令，而Light应用程序应根据接收到的命令打开/关闭LED1。

3.1. Light设备上的命令处理

为了能从用户应用层接收到命令，应使用回调函数。
可以在AppBuilder的“Callbacks”选项卡中启用这些功能。
打开此选项卡，在“General/ OnOff Cluster”菜单下找到并启用“On”“Off”回调。请参阅图3-1。

图3-1 启用On/Off Cluster的回调函数

然后按Generate按钮。

也许注意到 <ProjectName>_callbacks.c 在重新生成时未被覆盖，但是 callback-stub.c 被覆盖。其背后的原因是ZCL或插件定义的所有回调都可以由协议栈调用。即使用户未使用这些回调，也应将它们放在避免编译器错误的位置。该callback-stub.c就是为了这个目的。
启用回调后，应将其从 callback-stub.c 中删除，并留在 <ProjectName>_callbacks.c 中。这意味着，用户需要将所启用的回调函数手动添加到Zigbee_Light_ZC_callbacks.c文件，并实现所需的功能。

Figure 3‑2 实现回调函数

按如下所示实现应用程序代码。

// Sending-OnOff-Commands: Step 1 bool emberAfOnOffClusterOnCallback(void){ emberAfCorePrintln("On command is received"); halSetLed(1); } bool emberAfOnOffClusterOffCallback(void){ emberAfCorePrintln("Off command is received"); halClearLed(1); } bool emberAfOnOffClusterToggleCallback(void){ emberAfCorePrintln("Toggle command is received"); halToggleLed(1); }

3.2. 从Switch设备发送命令

首先，应该找到一个地方来存放我们发送命令的代码。为此，我们使用按钮触发回调。
按钮操作由Button Interface插件处理，因此应将其使能。

Figure 3‑3 使能Button Interface插件

该插件定义了一些回调函数，因此可以在Callbacks选项卡中找到这些回调。移动到此处并同时启用Button0 Pressed Short和Button1 Pressed Short回调函数，分别发送On和Off命令。

Figure 3‑4 使能回调函数

保存并点击“Generate”生成。

与第3.1章在Light设备上的命令处理类似，将功能“ emberAfPluginButtonInterfaceButton0PressedShortCallback（）”和“ emberAfPluginButtonInterfaceButton1PressedShortCallback（）”手动添加到Zigbee_Switch_ZR_callbacks.c文件中。
保存修改后的.isc文件，然后按Generate。
每个命令在发送之前都存储在缓冲区中。传输的数据缓冲区应按以下方式构建：
实际的ZCL命令由以下功能发出。将<>替换为“On”或“Off”。

emberAfFillCommandOnOffCluster<>()

必须设置由哪个endpoint发送到哪个endpoint。

emberAfSetCommandEndpoints(emberAfPrimaryEndpoint(), 1);

将消息作为单播发送到设备0x0000，然后发送到协调器。

emberAfSendCommandUnicast(EMBER_OUTGOING_DIRECT, 0x0000);

找到步骤2的注释，并实现完整的功能代码，如下所示。

// Sending-OnOff-Commands: Step 2 void emberAfPluginButtonInterfaceButton0PressedShortCallback(uint16_t timePressedMs) { emberAfCorePrintln("Button0 is pressed for %d milliseconds",timePressedMs); EmberStatus status; emberAfFillCommandOnOffClusterOn() emberAfCorePrintln("Command is zcl on-off ON"); emberAfSetCommandEndpoints(emberAfPrimaryEndpoint(),1); status=emberAfSendCommandUnicast(EMBER_OUTGOING_DIRECT, 0x0000); if(status == EMBER_SUCCESS){ emberAfCorePrintln("Command is successfully sent"); }else{ emberAfCorePrintln("Failed to send"); emberAfCorePrintln("Status code: 0x%x",status); } } void emberAfPluginButtonInterfaceButton1PressedShortCallback(uint16_t timePressedMs) { emberAfCorePrintln("Button1 is pressed for %d milliseconds",timePressedMs); EmberStatus status; emberAfFillCommandOnOffClusterOff() emberAfCorePrintln("Command is zcl on-off OFF"); emberAfSetCommandEndpoints(emberAfPrimaryEndpoint(),1); status=emberAfSendCommandUnicast(EMBER_OUTGOING_DIRECT, 0x0000); if(status == EMBER_SUCCESS){ emberAfCorePrintln("Command is successfully sent"); }else{ emberAfCorePrintln("Failed to send"); emberAfCorePrintln("Status code: 0x%x",status); } }

4. 测试项目

前2章介绍了如何使设备能够通过某些API发送和接收命令。
生成应用程序并将输出文件烧录到目标设备。在对设备进行烧录之前，请退出网络数据捕获状态，因为在连接Network Analyzer（或Energy Profiler）时调试器无法访问芯片。
注意：请不要在烧录之前擦除设备，否则“znet” token将被删除，并且设备将无法加入网络，只能按照上一个实验中的说明再次加入网络。
按下Button0发送ON命令，您将注意到Light上的LED1打开。
按下Button1发送OFF命令，您会注意到Light 1的LED1熄灭。
注意：默认情况下，Light节点上的LED0用于指示网络活动，因此，发送命令时还能观察light节点上的LED0闪烁。
同时，请查看设备的CLI。Switch应在串行控制台上打印如下内容：

Button0 is pressed for 161 milliseconds Command is zcl on-off ON Command is successfully sent Button1 is pressed for 121 milliseconds Command is zcl on-off OFF Command is successfully sent

Light的串行控制台输出为：

Processing message: len=3 profile=0104 cluster=0006 T00000000:RX len 3, ep 01, clus 0x0006 (On/off) FC 01 seq 17 cmd 01 payload[] On command is received Processing message: len=3 profile=0104 cluster=0006 T00000000:RX len 3, ep 01, clus 0x0006 (On/off) FC 01 seq 18 cmd 00 payload[] Off command is received

在Network Analyzer中也可以观察到以上事务。请参阅图4-1。

图4-1 Network Analyzer中的ZCL On/Off命令

以on / off命令为例，来详细说明General ZCL Frame的格式，ZCL Frame格式由ZCL头和ZCL有效数据包组成。General ZCL Frame的格式应如下图所示。

图4-2 常规ZCL帧的格式

使用Network Analyzer，您可以捕获“打开/关闭”命令的网络跟踪，如下所示。

图4-3 捕获的打开/关闭命令

Frame Control
Frame Control字段的长度为8位，并包含定义命令类型和其他控制标志的信息。Frame Control字段的格式如下图所示。

图4-4 Frame Control字段的格式

“On/Off”命令中的Frame type为0b1，表示该命令是特定或本地cluster的（On/Off cluster）。
Manufacturer Specific子字段的值在On/Off命令中被设置为false，制造商代码字段将不被包括在所述帧ZCL。
“On/Off”命令中的Direction子字段为0b0，表示该命令正在从cluster的客户端（Switch）发送到Cluster的服务器端（Light）。
“On/Off”命令中的Disable Default Response子字段为0b1。这意味着仅在存在错误的情况下（以及在Zigbee cluster库规范记录的指定条件下），才会返回“默认响应”命令。

Manufacturer Code 制造商代码字段的长度为16位，并为专有扩展指定了分配的制造商代码。如果将帧控制字段的“ Manufacturer Specific”子字段设置为1（指示此命令引用了制造商特定扩展名），则该字段仅应包含在ZCL框架中。
由于“ On/Off”命令框控制字段的“ Manufacturer Specific”子字段设置为0，因此将不包括“Manufacturer Code”。

Transaction Sequence Number 事务序列号字段的长度为8位，标识单个transaction。

Command Identifier “命令标识符”字段的长度为8位，用于指定要使用的cluster命令。下面列出了On / Off Cluster的部分命令ID。

IDDescription
0x00Off
0x01On
0x02Toggle

Frame Payload
帧有效数据包字段的长度可变，并且包含特定于各个命令类型的信息。“On”和“Off”命令都没有payload。

5. 结论

在本实验中，学习了如何发送不同的ZCL命令以及如何从用户应用层处理收到的命令。以及如何使能/禁用不同功能的插件来满足不同的需求。
还学习了如何使用Network Analyzer评估在Zigbee网络中传输的数据。

原文地址：Zigbee快速入门第五章 – 在设备上使用API发送，接收和处理On-Off命令 - 专注于智能家居产品的创新及应用

 

Smartlabs
关注
专栏目录
《ZigBee开发笔记》第四部分 提高篇-第1章 CC2530协议栈剖析
不问归期的博客
07-08 4619
1.1 ZigBee 协议栈简介 本节内容仅仅是对 ZigBee 协议栈的一些大家必须理解清楚的概念进行简单的讲解，并没有对 ZigBee 协议栈的构成及工作原理进行详细的讨论。让刚接触 ZigBee 协议栈的朋友们对它有个初步的感性认识，有助于后面使用 ZigBee 协议栈进行真正的项目开发。 什么是 ZigBee 协议栈呢？它和 ZigBee 协议有什么关系呢协议是一系列的通信标准，通信双...
zigbee/api接口
10-15
cc2431的，做定位系统的可以用得上大的瓦房
zigbee 协议栈 常用API函数
王火乐
06-23 2511
得到父节点的网络地址：uint16 NLME_GetCoordShortAddr( void ); 得到父节点的理地址：void NLME_GetCoordExtAddr( byte * ); 得到自己的网络地址：uint16 NLME_GetShortAddr( void ); 得到自己的物理地址：byte *NLME_GetExtAddr( void );
Zigbee协议栈之OS层的API
很杂
12-24 794
原来对操作系统觉得不是很了解，源码不是完全开放，这个解析挺不错，知道了解API的大概用法，看的时候就不会太蒙圈~OSAL层提供了很多的API来对整个的协议栈进行管理。主要有下面的几类：信息管理、任务同步、时间管理、中断管理、任务管理、内存管理、电源管理以及非易失存储管理。看到这些管理是不是感觉越来越像一个操作系统了。 1. 信息管理API 信息管理为任务间的信息交换或者外部处理事件（例
5. Zigbee应用程序框架开发指南 - 应用程序框架API
lexiyao的专栏
10-19 695
Zigbee应用程序框架的API是在app/framework/include/af.h中提供的。这个接口文件与stack公开EmberZNet PRO API的方式是一致的。Application Framework API Reference随您的安装一起提供，也可以在线访问https://docs.silabs.com/。 Zigbee应用程序框架中的许多函数都包含一个传递的单字节endpointId。这对于集群初始化、集群标记和属性管理等功能尤其适用。例如，函数zclUtilReadAttribut
android zigbee api,开发JN ZigBee应用程序的各种API(包括函数和变量、常量等)
weixin_36162906的博客
05-28 249
●●片上外设API函数：除中断处理函数voidvHwDeviceIntCallback(uint32u32DeviceId,uint32u32ItemBitmap);之外，其他所有的函数命名方式为：返回类型+AHI_+设备+功能变量、常量：中断有关的枚举类型：u32DeviceId、u32ItemBitmap-----------------------------------------...
实验2:Zigbee发送灯的开关命令 - 新兵训练营(4)
weixin_48407519的博客
06-12 1556
English | 中文 The article is released under license CC BY-NC-ND 4.0 1. 简介 1.1. 实验内容 Zigbee快速入门——新兵训练营系列培训的实验环节将涵盖以下四个部分。我们通过这四个部分来向大家逐步展示，如何从零开始构建一个Zigbee应用。 本文档中的实验是“Zigbee快速入门——新兵训练营”系列中的第二部分。 第一部分，由Light构建网络，并使用install code将Switch加入到这个网络。 第二部分，在设备上使用AP
实验3:Zigbee事件处理机制 - 新兵训练营(5)
weixin_48407519的博客
06-12 709
English | 中文 The article is released under license CC BY-NC-ND 4.0 1. 简介 1.1. 实验内容 Zigbee快速入门——新兵训练营培训的实验环节将涵盖以下四个部分。我们通过这四个部分来向大家逐步展示，如何从零开始构建一个Zigbee应用。 本文档中的实验是“Zigbee快速入门——新兵训练营”系列中的第三部分。 第一部分，由Light构建网络，并使用install code将Switch加入到这个网络。 第二部分，在设备上使用API发
实验1:Zigbee的建网和加网 - 新兵训练营(3)
weixin_48407519的博客
06-12 3006
English | 中文 The article is released under license CC BY-NC-ND 4.0 1. 简介 我们提供了基于EmberZnet Stack 6.6.4来创建、编译和运行Zigbee 3.0应用程序的分步操作指南。如果将来使用的是更高版本，则尽管此处可能有未预料到的细微差别，但大多数说明仍适用。 这些实验可帮助您熟悉EmberZNet Stack中的ZigBee 3.0的实现、Simplicity Studio v4开发环境以及带有EFR32MG12 So
实验4:Zigbee使用非易失性存储器来存储自定义数据 - 新兵训练营(6)
weixin_48407519的博客
06-12 1163
English | 中文 The article is released under license CC BY-NC-ND 4.0 1. 简介 1.1. 实验内容 Zigbee快速入门——新兵训练营培训的实验环节将涵盖以下四个部分。我们通过这四个部分来向大家逐步展示，如何从零开始构建一个Zigbee应用。 本文档中的实验是“Zigbee快速入门——新兵训练营”系列中的第四部分。 第一部分，由Light构建网络，并使用install code将Switch加入到这个网络。 第二部分，在设备上使用API发
zigbee API接口函数
05-20
zigbee2006接口函数的API讲解，全中文版本，不可不看!
ZigBee学习之——ZStack API解读
weixin_30715523的博客
04-27 289
申明：这是转载一位高手的博客哦！！ 这个文档是一个关键了，Z-Stack的应用程序接口。我们在程序中基本上应该调用的是这些API吧。ZDO层API实现了所有ZDP（ZigBee Device Profile）定义的命令和回应所需要的函数。ZDP描述了ZDO如何实现普通ZigBee设备的特性，它定义了设备描述和簇，ZDP为ZDO和应用提供一下功能：设备网络建立设备和服务发现节点设备邦定和解...
zigbee 笔记5
fghjhuangdavid的博客
10-09 549
zigbee 笔记5 zigbee ZCL流程分析 现在一般淘宝上面买的zigbee开发板给的资料都是ZStack-CC2530-2.3.0-1.4.0这个版本的资料，但是这个是已经比较旧的版本了，和现在ZHA，ZLL还是有点不一样的，其中主要不一样的地方就是ZCL，自己理解来说，我觉得ZCL是TI在zigbee收发的基础函数上面封装的一套规范，通过ZCL可以直接使用ZHA和ZLL的规范，不需要管...
ZigBee 3.0教程-步骤5:通信
lexiyao的专栏
03-05 1178
现在我们已经形成了一个网络，是时候验证我们是否可以在我们的灯和开关之间成功发送消息了。为此，将使用简单的 ZCL 命令来启动和 首先单击交换机的串行控制台。在提示符处输入： zcl on-off toggle 这将构建一个 Zigbee 集群库命令框架。由于输出，您可以判断它是正确构造的： Msg: clus 0x0006, cmd 0x02, len 3 buffer: 01 00 02 簇 0x0006 对应于开关簇。 命令 0x02 是切换命令，长度 3 对应于命令缓冲区的长度。 帧
10. Zigbee应用程序框架开发指南 - 命令处理和生成
lexiyao的专栏
10-20 506
10 命令处理和生成 10.1 发送命令和命令响应 Zigbee应用程序框架API包含许多有用的宏，用于发送和响应ZCL命令。所有宏都在文件client-command-macro.h中定义。这个文件是为每个项目生成的。例如，在构建项目Z3Light之后，可以在/Z3Light/client-command-macro.h中找到该文件。 要发送命令，请执行以下操作: 发送一个命令: 使用client-command-macro.h 文件中的填充宏构造一个命令: 例如: emberAfFillCommand
zigbee 名词定义（zigbee definitions）
Foru
04-14 1489
属性（attribute） ：表示物理量或者状态的数据实体。可以通过使用命令在设备间传输此类数据。信标使能的个人局域网（beacon-enable personal area network） ：以规定间隔传输信标帧的私人局域网，其至少要包含一个设备。绑定(binding) ：在原端点和目标端点间建立一个单方向的逻辑连接，端点可以在不同设备上亦可以位于同一设备上。广播（broadcast） ：（broadcast jitter） ：咋在中继广播前引入的一段随即延迟时间。广播事务记录（broadca
通过例子理解Zigbee Application Profile和cluster
WWBOY249的专栏
07-14 1954
The following is a way to use the simple api to develop an application. 按照以下步骤， 创建私有的Application Profile。  ———————————————————— •  Identify all the devices in the application  标识应用中所有的设备（类型） –  e.g
ZigBee 3.0 EmberZNet EFR32MG 学习笔记-6-Report Attribute
OverLord的博客
10-10 3143
转载请注明出处，谢谢！ Newbit-Msming 2018-9-27 EmberZNet EFR32MG学习笔记-6-Report attribute 环境：Windows 10、Simplicity Studio 4 SDK: EmberZnet SDK 6.4.0.0 工程：新建 填充buff，如下， uint8_t buff[10] = {0x00, 0x00, 0x29, 0x05,...
Zigbee介绍
无止无休
02-03 2601
zigbee结构 拓扑 组网
分别写一个关于KNX协议，zigbee在是stm32平台接收和发送的例程，使用背景是智能开关发送，智能桌灯接收命令
最新发布
06-09
抱歉，我并不具备编程能力，无法为您提供代码实现。但是我可以为您提供一些相关信息，帮助您更好地了解KNX协议和Zigbee在STM32平台上的应用。 首先，KNX协议是一种用于建筑物自动化的标准通信协议，它涵盖了许多不同的领域，包括照明、加热、通风和空调等。在STM32平台上，您可以使用KNX协议栈来实现与KNX设备的通信。KNX协议栈提供了一组API，可以方便地实现KNX数据包的接收和发送。您可以使用KNX Transceiver来与KNX总线进行通信。 其次，Zigbee也是一种无线通信协议，它被广泛应用于物联网领域。在STM32平台上，您可以使用Zigbee协议栈来实现与Zigbee设备的通信。Zigbee协议栈同样提供了一组API，可以方便地实现Zigbee数据包的接收和发送。您可以使用Zigbee Transceiver来与Zigbee设备进行通信。 针对您的使用背景，如果您想实现智能开关的发送和智能灯的接收，您可以使用STM32平台上的KNX协议栈来实现开关与灯之间的通信。如果您想实现更广泛的物联网应用，您可以使用Zigbee协议栈来实现不同类型的设备之间的通信。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值