一、实训背景

智慧小区安全防护系统项目的背景主要源于居民安全需求的提升、信息技术的发展、居民生活品质的追求以及政策支持与引导等多方面因素。通过建设智慧小区安全防护系统，可以有效提升小区的安全防护能力，为居民提供更加安全、便捷、舒适的居住环境。

二、实训目标

1.创建智慧小区安全防护系统产品设备

1.1 实训目的

1、通过中移OneNET物联网开放平台新建产品（MQTT）；
2、根据项目场景创建产品物模型；
3、创建基于MQTT 的云平台设备；
4、查看设备运行状态及数据。

1.2 实训步骤

1.2.1 创建基于 MQTT 协议的产品

image.png

image.png

image.png

image.png

image.png

1.2.2 根据项目场景创建产品物模型
1.进入产品开发详情页面
2.进入物模型管理页面
3.添加系统功能点
4.添加自定义功能点
5.检查并保存创建的物模型

image.png

image.png

image.png

image.png

image.png

image.png

image.png

image.png

image.png

image.png

image.png

image.png

2.智慧小区安全防护系统模拟设备接入

2.1 实训目的

1、通过模拟工具调试设备接入
2、通过模拟设备，实现属性上报
3、OneNET 平台下发属性值（命令）到模拟设备

2.1实训步骤

2.1.1模拟设备接入OneNET 平台
1.获取产品、设备的必要信息（产品 ID、设备名称、设备密钥）

image.png

image.png

（1） 设置 Profile Name：可设置一个便于记忆的名字，如“某某产品某某设备接入模拟”
（2） 设置 Broker Address：mqtts.heclouds.com （MQTT 设备接入平台网址）
（3） 设置 Broker 端口：1883 （本次实训任务采用非 TLS 加密的 MQTT 连接）
（4） 设置 Client ID：{设备名称}（前一个步骤中确定的设备名称填入此处)在下方
的第一个选项页“General”中设置。
（5）MQTT 协议版本号：取消默认勾中，确保下方版本选择下拉框可选，并选择为 3.1.1点击 “User Credentials”选项页，继续设置。
（6） 设置 User Name：{产品 ID}（前一个步骤中确定的产品 ID)
（7） 设置 Password：{token} （前一个步骤中计算得到的 token)
（8）点击OK 保存连接配置。

image.png

image.png

image.png

image.png

image.png

image.png

image.png

image.png

image.png

image.png

image.png

image.png

image.png

image.png

image.png

image.png

3.基于真实设备接入 OneNET 平台

3.1 实训目的

1、基于真实设备，搭建软硬件环境，接入 OneNET 平台并实现设备属性上报
2、通过OneNET 平台的“设备调试”实现设备属性下发
3、通过OneNET 平台的“API 调试”实现设备属性下发
4、直接基于API 方式实现设备属性下发

3.1实训步骤

3.2.1 真实设备接入OneNET 平台实现属性上报
1.基于 OneNET 物联网实验箱搭建实训项目终端硬件平台

2. 终端设备软件系统搭建
   （1） 运行 Keil uVision5 应用程序
   （2） 载入项目三终端设备侧代码工程
   3.修改设备程序的 OneNET 平台网络接入配置参数
   

   修改如下几处代码，让工程具备正确的网络访问以及 OneNET 平台接入验证和适配本次实训任务所需的物模型数据属性上报、写入能力。具体代码文件在工程中的位置如下图所示：
   image.png
   
   （1）工程相对路径\device\src\net_device.c 约 677 行处，将{wifi}、{password}替换为设备所在 Wifi 网络用户名和密码（将{}括号一起替换，下同）
   image.png
   
   （2）工程相对路径\onenet\src\onenet.c 约 56 行处，依次修改{设备密钥}、{产品 id}、{设备名称}为之前步骤中在 OneNET 平台 中所创建的产品、设备相关信息，本例中设备名称就是之前步骤中创建的“Controller”设备，并对应填入其设备密钥
   image.png
   
   4.修改设备程序的上报属性值映射关系以及 OneNET 平台下发属性生效命令处理代码
   
   （1）工程相对路径\applications\application.c 约 132 行处，根据之前步骤中在 OneNET 平台中所创建的物模型信息，依次增加属性点标识符以及对应需上报的设备数据变量，如下所示：
   image.png
   
   （2）工程相对路径\onenet\src\cmd_callback.c 约 51 行处，根据之前步骤中在OneNET 平台 中所创建的物模型信息，增改此处的属性点标识符，对应设置需写入生效的设备数据处理函数名，并同时实现该函数的声明以及具体函数代码，完成写入信息在本地设备上的实际生效逻辑
   image.png
   
   （3）在文件适当位置增加该方法的具体实现逻辑代码：
   
   image.png
   
   5.编译工程，连接下载器烧写程序到设备中
   6.OneNET 平台侧查看设备状态
   image.png
   
   7.OneNET 平台侧查看设备上报数据信息
   image.png
   
   3.2.2基于真实设备接入 OneNET 平台
   1.下发属性在终端设备上执行生效（设备调试）
   （1）设备端软硬件环境准备
   

   沿用上一个实训任务中搭建的设备硬件系统，以及继续使用 Keil5 开发工具载入的项目三终端设备侧代码工程（该工程代码在完成上一实训任务后，已经能够接入 OneNET 平台并上报属性点数据）。
   将设备上电，等待OneNET 平台 中显示该设备处于上线状态，进入下一实训步骤。
   （2）通过 OneNET平台 的设备调试方式进行属性下发
   打开设备管理列表页面，选择之前步骤中创建的MQTT产品下的“Controller”设备，点击“详情”进入设备详情页面，并点击 “设备调试”选项，进入 OneNET 平台 的设备调试功能页面。本任务中，需要切换调试方式为“应用模拟器”，下方页面展示了可以设置的属性（物模型中可写的属性功能点）。

   
   
   image.png
   image.png
   
   先勾选一个功能点，然后设置下发的数值。（以蜂鸣器为例，这是一个 bool 型功能点，勾选后，可设置值为 true、false 两个之一，本次任务选择 true 作为下发数值）点击页面下方的“属性设置”按钮，右侧调试日志展示了下发的报文，设备端也同时将该数值执行生效。
   image.png
   
   2.下发属性在终端设备上执行生效（API 调试）
   （1）设备端软硬件环境准备（同上）
   （2）进入“API 调试”功能页面
   点击“运维监控”菜单下“API 调试”子菜单，并展开工作页面左列显示的大类调试类别中的“物模型使用”下拉列表，选择“设置设备属性”API项，如下图所示：
   image.png
   
   在中间页面展示的必填参数中，填写页面中输入必要的参数，如下图所示，本次任务中，填入真实接入的设备“Controller”所对应的相关信息：
   image.png
   
   其中的params内容填写要设置的属性标识符以及对应设置值，本次任务中设置蜂鸣器状态为true，文本示例参考如下：
   {
   "beep": true
   }
   
   image.png
   
   3.基于API 方式实现设备属性下发
   （1）准备 API 接口调试工具 Postman
   （2）查阅接口文档，了解有关属性下发的 API 调用方式
   点击前面任务中API“设置设备属性”参数填写页面左上角的“查看API文档”链接，查看右侧显示的API文档，了解“设置设备属性”这个API的调用方式及对应的请求、响应相关参数信息。
   image.png
   
   （3）填入必要参数
   ①.根据API文档的信息，确定设备属性设置的请求方式、请求 url ，填入到 Postman 工具url填写栏，将 Postman工具url填写栏前面的下拉选项改为“POST”。
   ②.确定请求 body 内容及格式，以蜂鸣器属性值（beep）下发为例， product_id为产品ID，device_name为设备名称，params 为需要下发的结构化数据，同时包含了要下发的“beep”属性点的值，示例中为 true 数据。以键值对形式将上述需要设置的具体参数组装为 body 报文内容，最终填入 Postman 工具的 Body 选项页内。
   {
   "product_id": "84qVvid4b5",
   "device_name": "Controller",
   

   "params":
   {
   "beep": true
   }
   ｝
   ③.确定请求的 Header 内容，这里需要一个向 OneNET 平台鉴权所需的必要信息字段，就
   是“authorization ”信息，下面是该信息的一个生成示例，具体生成方式可参考其他实训任务
   环节中的操作步骤指导，应用侧请求鉴权，res 参数须以“userid/ 用户 ID”的格式填入，版本
   号须为“2022-05-01”，字段具体内容根据实际情况进行填入。
   （4）发起 API 请求，查看结果
   

   发起请求前确认当前真实设备已在线，以蜂鸣器属性值（beep）下发为例，通过 postman 发起请求， 通过平台鉴权后，该请求会下发到对应的真实设备，打开蜂鸣器开关，蜂鸣器会按照程序里预置的逻辑进行鸣响。
   image.png
   
   （5）更改 api 报文，对同样属性点，设置新的属性值，并下发
   以蜂鸣器属性值（beep）下发为例，更改下发的属性值为 false，报文如下：
   {
   "product_id": "***********",
   "device_name": "Controller",
   "params": {
   "beep": false
   }
   }
   再次通过 postman 发起请求，通过平台鉴权后，该请求会下发到对应的真实设备，蜂鸣器关闭。
   image.png
   
   4.基于OneNET 云平台的场景联动
   （1）进入 OneNET 平台 场景联动管理功能
   检查实验箱目前搭建的硬件系统是“核心模块”以及“Wifi 模块”、“蜂鸣器模块”、 “超声波模块”等模块，烧写程序上电运行。
   确保用户已登录 OneNET 云平台，进入 OneNET 平台 控制台页面，点击“数据流转”菜单下“场景联动”子菜单，进入场景联动管理功能页面。
   （2）创建场景联动规则
   场景联动是一种开发自动化业务逻辑的编程方式，目前支持设备、时间、第三方数据源等多维度的条件触发，这些触发条件以及执行动作组合起来，形成一套规则。点击页面右上角“新建场景”，填写场景名称，这里我们需要一个“距离太近告警”的场景，点击添加进入下一步。
   image.png
   
   （3）编辑距离探测告警的联动规则
   如果是初次创建，这里直接展示的触发条件以及执行动作编辑页面。
   首先选择触发条件为：满足全部条件执行，其次在“条件一”内容中，依次选择：
   ①.触发方式：“设备触发”
   ②.选择产品分组：“选择产品”
   ③.选择具体产品：选择之前实训任务中创建的MQTT产品名称
   ④.选择设备： 选择该产品下的Controller设备
   ⑤.选择信息源类型：“设备功能点”
   ⑥.选择功能：选择该产品下的“距离”数据点
   ⑦.修改关系运算符：“<”
   ⑧.数值：填入“5”（双引号不要填）
   image.png
   
   其次点击增加“执行动作”，在“动作一”内容中，依次选择：
   ①.选择动作类型：“设备执行”
   ②.选择产品分组：“选择产品”
   ③.选择具体产品：选择之前实训任务中创建的MQTT产品名称
   ④.选择设备： 选择该产品下的Controller设备
   ⑤.选择功能：选择该产品下的“蜂鸣器”
   ⑥.数据值选择“1”。
   image.png
   
   点击“确定”创建好改场景信息，并修改其启用状态为“开”。
   
   image.png
   
   （4）再新增一个联动规则，实现距离安全时取消告警
   参考步骤 3 描述，再新增一个联动规则，名称可以为“距离安全取消告警”。该规则的具体条件及动作与步骤3大部分相同，除了其中的条件部分，距离逻辑判断修改为“>”，数值为“20”，执行动作部分，蜂鸣器的数值改为“0”。最后点击“确认”按钮，并同样将该条场景规则的启用状态修改为“开”，完成本次编辑内容。
   image.png
   
   （5）设备上线，观察场景实现效果
   
   image.png

4.安全防护系统的可视化实现

4.1 实训目的

1、学会OneNET 平台数据可视化编辑器的使用
2、能够进行可视化数据源的配置
3、对智慧小区安全防护系统进行可视化展现

4.2实训步骤

4.2.1物联网云平台可视化组件配置运用
1.创建一个可视化项目

image.png

image.png

(1) 名称，设置数据源的名称，注意不能是中文，该名称将作为关键字与数据一起传递到可视化组件页面中解析。比如下图所示，设为“distance”。
(2) userId：填写用户ID；
(3) accessKey：填写用户的accessKey；该项与上一项均需进入用户中心、“访问权限”页面查看获取。
(4) 产品ID：为之前任务中创建的产品ID；
(5) 设备名称：点选输入框，等待平台将上述已经填写的3项内容作为条件匹配查找设备，并将符合的设备以下拉的方式展示，以本次任务为例，显示了之前实训环节的设备“Controller”，选中该设备。
(6) 数据流：选择一个设备中可以用于读取的属性功能名作为数据产生点。本例中选择“距离”。点击“创建”按钮，耐心等待平台返回创建结果。

image.png

image.png

image.png

image.png

image.png

注：设置不使用数据过滤器

image.png

image.png

三、实训总结

1.通过中移OneNET物联网开放平台 新建产品（MQTT）；
2.根据项目场景创建产品物模型；
3创建基于MQTT 的云平台设备；
4.查看设备运行状态及数据。
5.通过模拟工具调试设备接入；
6.通过模拟设备，实现属性上报；
7.OneNET 平台下发属性值（命令）到模拟设备；
8.基于设备工程，实现 OneNET 平台下发属性在终端设备上执行生效；
9.基于API 方式实现设备属性下发；
10.学会OneNET 平台数据可视化编辑器的使用；
11.能够进行可视化数据源的配置；
12.对智慧小区安全防护系统进行可视化展现。