概要

Host-NCP环境搭建好后，怎么测试验证zigbee功能，怎么将Host集成到自己的应用中，应该是大部分使用者关心的问题。芯科公司为此提供了一套基于Nodejs和ReactJS的Web应用例子“gateway-management-ui”来指引开发。如下图所示，通过web可视化界面，使用者可以简单、快捷地体验ZigBee的各种功能，主要包括：网络配置、网络开放、设备加入、设备信息查看、设备控制、设备属性读取、设备应用绑定等；大部分功能都是基于芯科ZigBee 插件应用实现的，稳定性和可用性都比较高，“久经考验”。

本人觉得使用“gateway-management-ui”，对使用者来说，有以下几点意义：

1.理解Host作为外部应用和ZigBee应用之间的一座桥梁，应当怎么为上层应用提供服务能力；（从整体架构设计的角度，理解Host的定位）

2.理解应用如何从依赖于callback回调的编程模式，转变为通过mqtt方式实现“订阅“-“发布”的编程模式；（移动互联网、云端应用的概念）

3.有助于使用者更加快速地将应用与各大物联网平台对接。（微信、阿里等）

软件架构

在《ug129-zigbee-gateway-ref-design-guide.pdf》文档中的第4章节，有具体的描述。

软件安装

1.gateway-management-ui最新版本可以在https://github.com/SiliconLabs/gateway-management-ui获取；

2.gateway-management-ui运行，需要nodejs、npm环境，而且对版本可能有一点要求（nodejs版本过高，可能运行失败）。

目前，在本人电脑上能正确运行的环境如下：

NodeJS: v10.15.0

npm:6.4.1

3.下载代码后，需要分别进入nodeserver目录、reactui目录进行依赖安装和应用部署（和大部分node应用一样），具体可以参考文档4.2.2章节，如下图所示

特别注意：npm 安装gulp时，需要带上版本号@3.9.0；因为现在gulp最新版本4.x为，在语法上和3.x有较大出入；reactui中用到的是3.x的语法，所以只能安装旧版gulp

备注：如果后续调整了reactui中的资源文件（页面、js或图片等），都要执行sudo npm run build命令，重新build一下reactui项目。

软件配置

几个重要的配置文件：

1.mqtt服务地址和端口配置：位于nodeserver\src\common\routes\GatewayInterface.js文件中，如下图所示

var mqttBrokerPort = 1883;
var mqttBrokerAddress = "127.0.0.1";

2.nodeserver与reactui间socket通讯的配置：位于nodeserver\src\common\routes\SocketInterface.js文件中，如下图所示

备注1：socket端口需要与reactui\src\js\Config.js文件中的端口保持一致，如下所示

备注2：socketio默认使用polling方式，如果需要支持微信小程序通讯，需要采用websocket方式，而且客户端需要使用支持微信小程序的socketio版本

var Config = {}Config.gatewayAddress = window.location.hostname + ':9010';module.exports = Config;

3.nodeserver\src\common\Constants.js配置了日志目录、ota文件存放目录、外部程序目录（包括installcode生成key的外部程序路径），如下图所示

ZigBee功能验证

1.网络配置

点击网络配置按钮

设置好网络参数（通道、PANID），accept后，可以看到新的网络生效。（界面显示先停止已有网络，然后新的网络生效）

在Z3GatewayHost的命令行面板可以到以下日志：

说明Host收到mqtt的命令后，转换为调用对应插件命令，在配置网络的操作中，主要的mqtt命令为

{"commands":[{"command":"plugin device-table clear"},{"command":"plugin command-relay clear","postDelayMs":100},{"command":"plugin ias-zone-client clear-all","postDelayMs":100},{"command":"plugin groups-server clear","postDelayMs":100},{"command":"plugin scenes clear","postDelayMs":100}]}{"commands":[{"command":"network leave","postDelayMs":1000},{"command":"plugin network-creator form 0x1 0x6D17 -2 0x14"}]}

2.设备入网

点击新增ZigBee设备按钮，打开网络。（界面提示设备180秒的入网倒计时）

让终端设备按正常进行加网请求，可以看到设备正常入网，Z3GatewayHost日志如下：

设备加入网络后的展示

在Z3GatewayHost 的命令行下，通过plugin device-tables print命令可以看到已经加入的设备

在抓包软件中可以看到整个入网流程日志

在设备入网的操作中，主要的mqtt命令为

{"commands":[{"command":"plugin network-creator-security open-network","postDelayMs":100}]}

3.设备属性读取

ZigBee一个优势是在传感器领域指定了一套规范，包括对设备属性的读写、对设备的控制等，从而能实现不同厂家设备间“互联互通、数据共享”（理论上）。而其中zcl是实现这些功能的最主要手段。

在gateway-management-ui中可以在“Home”标签页下面，看到相关设备的属性，例如下图所示的温度传感器显示的温度，终端的manufacturer name，这些属性都是通过标准的zcl方式进行读取。

无论你的模组是efr32的，还是cc2530的，或者其他厂家的；都能通过zcl进行设备控制。（后面专门写一篇cc2530和efr32在实现同一个zigbee功能中的差异性）

所以，这里应当作为重点来分析掌握一下。

流程分析：reactUI界面-》node server-》host-》ncp

关键代码分析如下：

1）reactUI界面：gateway-management-ui\reactui\src\js\actions\ServerActions.js中的requestNodeAttribute方法。

从方法的实现可以看到，它是通过socket方式（前面提到的9010端口），发送请求和参数给nodeserver（json格式的socket调用，socketIO）

2）nodeserver：reactUI发送的socket请求，会在gateway-management-ui\nodeserver\src\common\controller\DeviceController.js中的onSocketAction方法j进行处理。

找到requestattribute，可以看到是调用ServerActions.GatewayInterface.zigbeeRequestAttribute方法。

zigbeeRequestAttribute方法位于gateway-management-ui\nodeserver\src\common\actions\ServerActions.js中，打开可以看到，它的实现是将命令和参数转换为json格式，然后通过mqtt发布到对应的topic上。

重点：reactUI和nodeserver中的ServerAction.js都是重要的入口和处理文件，大部分逻辑和实现，都可以在这里找到。

3）host：因为host在ncp启动后，会通过mqtt方式订阅commands主题（具体的代码分析，在后一章esp32移植中再详细描述），这个可以从host启动的日志看到：

Subscribing to topic "gw/60A423FFFE068C75/commands" using QoS2
Subscribing to topic "gw/60A423FFFE068C75/publishstate" using QoS2
Subscribing to topic "gw/60A423FFFE068C75/updatesettings" using QoS2

所以上面nodeserver发布的命令，host会通过mqtt接收到，然后通过调用插件方式或者底层api方式，将zcl命令发送给ncp（通过ezsp协议），进行zigbee操作（具体的代码分析，在后一章esp32移植中再详细描述）。

4）ncp：ncp收到命令，处理完后，返回处理结果给host（这个过程可能是异步的？）；

那么，host怎么将结果通知给前端？答案，也是mqtt的“订阅”-“发布”

host通过mqtt方式，将处理ncp结果发布到zclresponse主题，所以只要是订阅了gw/60A423FFFE068C75/zclresponse的客户端（reactUI也好，VUE也好、微信小程序也好）都可以收到

如下图所示

在nodeserver后台，也可以看到对应的日志输出（nodeserver做了一些数据转换、格式化的工作）

在设备属性读取的操作中，主要的mqtt命令为

{"commands":[{"command" :"zcl global direction 0"},{"command":"zcl global read 1024 0"},{"command":"plugin device-table send {000B57FFFE097874} 1","postDelayMs":100}]}

调整的地方：

1）在调试中发现gateway-management-ui\nodeserver\src\common\actions\ServerActions.js中的publishCommandListThrottled方法，并没有真的把数据发送到mqtt，所以先调整为直接调用GatewayInterfaceSend.publishCommandList(commandlist);

2）当zclresponse返回属性的数据类型为String的时候，nodeserver处理不正确（例如：获取manufacturer name中的字符串值），先暂时改为调用自定义方法得到字符串

位于nodeserver中的DeviceController.js文件中的onAttributeUpdate方法

4.设备控制

设备控制主要指开、关这些常规的zcl操作，其实原理和上面设备属性读取一致，所以就不在这里详细描述了。

入口还是在reactUI的ServerAction.js中，它已经封装好比较细粒度的操作了，如下图所示。

在设备控制的操作中，主要的mqtt命令为：

 {"commands":[{"command":"zcl on-off on"},{"command":"plugin device-table send {00124B00213CCA01} 0x8"}]}

5.设备report参数配置

在设备report中，有几个地方要注意：

1.设备终端要打开report功能，具体而言：

对于efr32要在plugin勾选Reporting插件，如下图所示

对应cc2530，要配置BDB_REPORTING编译条件

2.先将网关和reporting 终端绑定：

mqtt命令如下：

{"commands":[{"command" :"zdo bind 0x434C 1 1 0x0400 {000B57FFFE097874} {0022A30000115EDA }"},{"command ":"plugin device-table send {000B57FFFE097874} 1","postDelayMs":100}]}

备注：以上这些zcl命令、zdo命令格式，都可以在《ug129-zigbee-gateway-ref-design-guide.pdf》的第4.3 Z3GatewayMqtt Application章节找到

简单记录一下自己用到的命令

#######light 终端##############
// 绑定终端
// zdo bind 终端短地址 终端endpoint 网关endpoint 终端clusterid 终端eui 网关eui
zdo bind 0x3CEE 8 1 0x0006 {60A423FFFE091C85} {60A423FFFE0B648E}// 设定终端属性上报配置
// zcl global send-me-a-report  终端clusterid 属性id 数据类型 最小上报周期 最大上报周期 变化值
zcl global send-me-a-report 0x0006 0x0000 0x10 0x0001 0x708 {00 01}
开关状态上报配置：最小上报时间1秒，最大上报时间1800秒 0x10代表ZCL_BOOLEAN_ATTRIBUTE_TYPE数据类型
plugin device-table send {60A423FFFE091C85} 8######switch 终端#################
zcl global send-me-a-report 0x0402 0x0000 0x29 0x0001 0x3c {00}
温度值上报配置：最小上报时间1秒，最大上报时间60秒   0x29代表ZCL_INT16S_ATTRIBUTE_TYPE数据类型
plugin device-table send {60A423FFFE0B6A52} 8查看设备绑定表
option binding-table print

相关抓包截图

6.设备OTA

需要了解efr32终端OTA的，可以参考以下文章（感谢相关文章作者的分享，在此借以引用参考，如有涉及版权问题，请及时联系我）；

https://blog.csdn.net/weixin_42160773/article/details/101284109

在Z3GatewayHost项目的build/exe目录下，会自动生成一个终端ota文件存放的目录ota-files

这个目录的配置是在芯科SDK中protocol\zigbee\app\framework\plugin\ota-storage-posix-filesystem\ota-storage-linux.c文件中，如下图所示。

只要把终端的ota文件保存到放在这里，然后设备入网后过一段时间即可自动进行ota；也可以通过cli命令方式，指定终端开始ota操作

这里，只记录一下ota相关的一些命令；

#终端
plugin ota-client start#host端
plugin ota-storage-common printImages
plugin ota-storage-common reload

后面esp32移植中再详细讲述怎么通过esp32到外网下载ota，存储在flash中，然后通知终端进行ota，并测试多终端一起ota的场景。

备注：

终端设备的bootloader类型需要选择“Local storage”，如果是默认配置，可能出现ota完后，设备不能自动重启的现象。

总结

通过使用gateway-management-ui，有助于了解整个Host-NCP架构；对于需要云端部署、对接互联网平台、对接第三方物联网平台的场景，有很好的参考价值；
在使用Host-NCP解决方案的时候应当遵循芯科的设计思想：优先使用“订阅”-“发布”的编程模式，减少对callback的依赖，要有面向云端和移动互联网的架构设计思想。专注于应用层面的使用，实现各层间的解耦和赋能。
芯科解决方案的优势，是它拥有很多“久经考验”的插件；我们在实现业务场景的时候应当尽量复用这些插件；而不是去大量调用底层的api（不要觉得自己写的代码比芯科的开发人员强）；
用好Host-NCP比将Host移植到不同平台更加重要。

补充

如果在安装gateway-management-ui时出现错误，无法正确安装，可以参考以下文章进行离线安装：

离线安装说明：https://download.csdn.net/download/lshddd/18994459

离线安装包下载地址：

链接：https://pan.baidu.com/s/14p33IZLNobnvbK59pcMy8g
提取码：sjv2

如有问题，请加入qq群：950801657 进行讨论

基于芯科Host-NCP解决方案的Zigbee 3.0 Gateway技术研究（二）-使用gateway-management-ui相关推荐

基于芯科Host-NCP解决方案的Zigbee 3.0 Gateway技术研究（-）-Z3GatewayHost应用
相关系列文章基于芯科Host-NCP解决方案的Zigbee 3.0 Gateway技术研究(-)-Z3GatewayHost应用搭建基于芯科Host-NCP解决方案的Zigbee 3.0 Gate ...
基于芯科Host-NCP解决方案的Zigbee 3.0 Gateway技术研究（三）-移植到ESP32平台（1）
相关系列文章基于芯科Host-NCP解决方案的Zigbee 3.0 Gateway技术研究(-)-Z3GatewayHost应用搭建基于芯科Host-NCP解决方案的Zigbee 3.0 Gate ...
ZigBee 3.0实战教程-Silicon Labs EFR32+EmberZnet-2-02：芯科的软件解决方案Gecko SDK
[ 源码. 文档. 软件. 硬件. 技术交流. 技术支持, 入口见文末] [所有相关 IDE. SDK和例程源码均可从群文件免费获取, 免安装, 解压即用] 持续更新中,欢迎关注! 虽然Sili ...
2018FME博客大赛-基于FME的不同比例尺线面要素一致性检测关键技术研究
编写:曹文涛武汉市测绘研究院二○一八年三月概述随着地理信息系统技术的不断发展和广泛应用,各省市国土测绘部门都纷纷建立起了各种比例尺的基础地理信息数据库,其提供的矢量地理数据为社会各行业 ...
国科金：共融机器人基础理论与关键技术研究重大研究计划
来源:学术头条国家自然科学基金委员会现发布共融机器人基础理论与关键技术研究重大研究计划 2022 年度项目指南,请申请人及依托单位按项目指南中所述的要求和注意事项申请. 国家自然科学基金委员会 20 ...
ZigBee 3.0实战教程-Silicon Labs EFR32+EmberZnet-2-01：芯科的硬件解决方案EFR32
[源码.文档.软件.硬件.技术交流.技术支持,入口见文末] [所有相关IDE.SDK和例程源码均可从群文件免费获取,免安装,解压即用] 持续更新中,欢迎关注! Silicon Labs提供可用作Zig ...
国内android应用商城中程序隐私泄露分析,基于数据生命周期的Android应用程序隐私泄露分析技术研究...
摘要: 目前,随着智能手机应用市场的发展与成熟,用户在方便地使用各类型应用的过程中亦会产生大量隐私数据,隐私泄露已成为智能手机平台的一个严重安全问题.由于Android平台的开放性,该问题更为突出,不 ...
【无标题】（论文阅读）基于蚁群算法的现代藏文字符轮廓提取技术研究-孙淑娟
一.摘要由于对字符提取骨架往往会失去受污损部位的重要信息,因此本文提出了一种基于蚁群算法的现代藏文字符轮廓提取算法‚旨在用字符的轮廓线代替骨架线来表征字符.本算法用于印刷体藏文轮廓提取‚取得了良好 ...
文献拜读小记：7.基于深度学习的图像与无线信号的融合定位关键技术研究
基于无线信号的室内定位技术具有计算复杂度低.可实现性强的优点,但存在多径.非视距干扰.特征空间区分度不够等缺点; 基于计算机视觉的室内定位技术具有能获得大量稳定的环境信息的优点,但存在计算复杂度高 ...

基于芯科Host-NCP解决方案的Zigbee 3.0 Gateway技术研究（二）-使用gateway-management-ui

概要