《某照明物联网解决方案(DOC 37页)》由会员分享，可在线阅读，更多相关《某照明物联网解决方案(DOC 37页)（37页珍藏版）》请在金锄头文库上搜索。
1、华为照明物联网解决方案业务应用开发指南文档版本发布日期华为技术有限公司31 / 37版权所有 华为技术有限公司 。 保留一切权利。非经本公司书面许可，任何单位和个人不得擅自摘抄、复制本文档内容的部分或全部，并不得以任何形式传播。商标声明和其他华为商标均为华为技术有限公司的商标。本文档提及的其他所有商标或注册商标，由各自的所有人拥有。注意您购买的产品、服务或特性等应受华为公司商业合同和条款的约束，本文档中描述的全部或部分产品、服务或特性可能不在您的购买或使用范围之内。除非合同另有约定，华为公司对本文档内容不做任何明示或暗示的声明或保证。由于产品版本升级或其他原因，本文档内容会不定期进行更新。除非
2、另有约定，本文档仅作为使用指导，本文档中的所有陈述、信息和建议不构成任何明示或暗示的担保。华为技术有限公司地址：深圳市龙岗区坂田华为总部办公楼 邮编：网址：.前 言读者对象本文档（本指南）主要适用于以下工程师：l 二次开发工程师符号约定在本文中可能出现下列标志，它们所代表的含义如下。符号说明用于警示紧急的危险情形，若不避免，将会导致人员死亡或严重的人身伤害。用于警示潜在的危险情形，若不避免，可能会导致人员死亡或严重的人身伤害。用于警示潜在的危险情形，若不避免，可能会导致中度或轻微的人身伤害。用于传递设备或环境安全警示信息，若不避免，可能会导致设备损坏、数据丢失、设备性能降低或其它不可预知的结果
3、。“注意”不涉及人身伤害。用于突出重要关键信息、最佳实践和小窍门等。“说明”不是安全警示信息，不涉及人身、设备及环境伤害信息。修改记录修改记录累积了每次文档更新的说明。最新版本的文档包含以前所有文档版本的更新内容。文档版本 ()版本拟制修订责任人拟制修订日期修订内容及理由批准人罗振辉新拟制薄会健 吴英德新增接口描述薄会健 罗振辉苏本胜增加“远程、策略控制、告警”接口薄会健 鲍利亚修改版本号薄会健 目 录 标题 ,标题 ,标题 ,标题 前 言 概述 目的 概述 术语 整体架构 架构图 接口说明 业务应用开发 设备安装 原理说明 接口说明 加载证书 获得证书并进行转换 对转换后的证书进行加载 白名
4、单配置接口 白名单授权加网接口 未知设备上线接口 设备建档接口 注意事项 远程访问 原理 接口说明 接口示例(读取调光等级) 接口示例（设置调光等级） 接口示例（设备自检） 接口示例（组播设置开关状态） 接口示例（批量设置多个设备的开关状态） 注意事项 计划控制 原理 三层计划关系 对时 计划创建过程 接口说明 计划创建接口（采集计划） 网关计划创建接口（控制计划） 网关计划执行结果上报接口 路灯控制器计划执行模式设置接口 路灯控制器计划创建接口 路灯控制器计划管理接口 注意事项 策略控制 原理 接口说明 策略创建接口（策略） 路灯控制器策略执行模式设置接口 路灯控制器策略创建接口 路灯控制器
5、策略管理接口 注意事项 告警 原理 接口说明 设备上下线 设备过压过流 电量计量不匹配 电量超出计量范畴 注意事项 参考资料 调测指南1 概述1.1 目的本指南旨在指导客户基于华为平台开发自己的业务系统，基于场景描述。1.2 概述适用于华为照明物联网解决方案所有的合作厂商、集成厂商进行业务系统构建参考。1.3 术语名称定义路灯管理系统物联网能效管理平台路灯控制器路灯的控制设备，可支持调光、计量、开关等功能。网关路由器设备，通过连接路灯控制器，通过、以太网、连接。设备通篇统一：网关：，路灯控制器：，单控设备：，设备域：2 整体架构2.1 架构图图2-1 架构图整个解决方案包括四个部分构成，主要是
6、路灯控制器、华为物联网网关、平台、（业务系统），各部分功能描述如下。l 路灯控制器：控制路灯调光、开光，支持计量功能，可采集电压、电流、功率、电量、频率数据。l 物联网网关：连接路灯控制器，获取通过方式进行上行与平台进行通信。l 平台：连接物联网网关，提供上行、接口给第三方应用进行二次开发，可实现对路灯进行远程开关、调光等功能，也支持编制计划和策略控制。l ：客户基于平台开发的业务应用系统。2.2 接口说明表2-1 接口说明模块接口类型描述备注路灯控制器物联网网关无线通信技术，支持物联网网关以太网上行通信技术，协议通信接口，采用模型描述，用于下发远程控制命令、本地计划创建、策略创建等功能。接口
7、，用于上报即时消息，如设备上线、下线，设备告警等。2.3 业务应用开发客户可以根据提供的接口进行业务应用开发，接口文档可参考华为物联网平台接口文档。后续章节会根据各类场景描述整个方案原理以及实用接口说明。的使用和的使用请参阅 参考资料章节应用开发前网关需要先配置连接到，配置方法参考下面的附件：3 设备安装3.1 原理说明图3-1 设备安装流程设备安装主要包括以下几个步骤；配置白名单：设备白名单给物联网网关，旨在告知物联网网关那些设备可入网。白名单授权加网：开启网络加网权限，设备可搜索网络，并加入到网络中，白名单之外设备当作非法设备处理，不可加入到网络中。设备上线：设备加网到网络之后，上报上线消
8、息，通过接口告知，当前设备还处于未知设备状态。建档：设备上线之后，当前设备还处于未知设备状态，可调用接口进行建档，建档之后，设备才可正常操作，为可识别设备。在整个过程中，设备的状态变化，如下图所示；图3-2 设备状态图3.2 接口说明1 本文档示例中使用到的网关和传感器需要根据真实环境更改为正确的设备。2 本文档示例中使用的平台的地址是，在真实环境中需要将地址改为平台的地址。3 本文档示例中使用的平台的端口号是，这是基于协议访问平台的缺省缺口号（如果使用协议，缺省的端口号为）。3.3 加载证书3.3.1 获得证书并进行转换从路径下获得和两个证书。前置条件：由于使用的是 格式的证书，所以，必须使
9、用提供的工具箱，因此，执行下面指令的电脑必须安装了( )，最好是配置了环境变量。.转换为: 参数说明：: 源证书路径。: 目标证书存储路径。第一个: 更改条目的密钥口令。第二个: 更改密钥库的存储口令。: 证书的别名,不指定,则默认为。说明：该指令是将可信任的证书转换为 格式的证书。如果指定的不存在这个文件，则自动生成一个文件（注：目录不会自动产生，只会在指定目录下生成文件），如果已经存在了文件，则在该文件中追加该证书。.转换为:参数说明：: 源证书路径。: 目标证书存储路径。第一个: 更改条目的密钥口令。第二个: 更改密钥库的存储口令。: 证书的别名,不指定,则默认为。说明：该指令是将的证书
10、转换为 格式的证书。如果指定的不存在这个文件，则自动生成一个文件（注：目录不会自动产生，只会在指定目录下生成文件），如果已经存在了文件，则在该文件中追加该证书。3.3.2 对转换后的证书进行加载加载证书样例： ( ) (); (); () (); (); (); ; ()()() (, , )(); ()()(); (); ( ) (); () ; () (, )(, )(); ( ) (); 说明：和为中转换后的证书所存放的位置，()方法只需要调用一次即可，()方法中的内容可用对应接口内容进行替换。3.4 白名单配置接口数据项名称: 白名单设备增加例子：为的网关下连接了四个分别为、和的设备，将这四个设备添加到白名单。接口：:： : , , , : () (, ) (, ) ( : , , , ) ();: : , : , : , : , : : , : , : , : : , , , $()( () (););: : , : , : , : , : : , : , : , : , : : , , , $()( () (););3.5 白名单授权加网接口白名单加网例子：为的网关允许加网秒。接口:： : () (, ) (, ) ( ) ();: : , : , : , : , : : ,: , : , : $()( ()
