华为照明物联解决方案.docx

1、华为照明物联网解决方案业务应用开发指南文档版本 01发布日期 2016-06-01华 为 技 术 有 限 公 司文档版本 01 (2016-06-01) 华为专有和保密信息版权所有 华为技术有限公司i版 权 所 有 华 为 技 术 有 限 公 司 2016。 保 留 一 切 权 利 。非经本公司书面许可，任何单位和个人不得擅自摘抄、复制本文档内容的部分或全部，并不得以任何形式传播。商 标 声 明和其他华为商标均为华为技术有限公司的商标。本文档提及的其他所有商标或注册商标，由各自的所有人拥有。注 意您购买的产品、服务或特性等应受华为公司商业合同和条款的约束，本文档中描述的全部或部分产品、服务或特

2、性可能不在您的购买或使用范围之内。除非合同另有约定，华为公司对本文档内容不做任何明示或暗示的声明或保证。由于产品版本升级或其他原因，本文档内容会不定期进行更新。除非另有约定，本文档仅作为使用指导，本文档中的所有陈述、信息和建议不构成任何明示或暗示的担保。华为技术有限公司地址： 深圳市龙岗区坂田华为总部办公楼 邮编：518129网址： https:/业务应用开发指南 前 言文档版本 01 (2016-06-01) 华为专有和保密信息版权所有 华为技术有限公司ii前 言读者对象本文档（本指南）主要适用于以下工程师： 二次开发工程师符号约定在本文中可能出现下列标志，它们所代表的含义如下。符号 说明用

3、于警示紧急的危险情形，若不避免，将会导致人员死亡或严重的人身伤害。用于警示潜在的危险情形，若不避免，可能会导致人员死亡或严重的人身伤害。用于警示潜在的危险情形，若不避免，可能会导致中度或轻微的人身伤害。用于传递设备或环境安全警示信息，若不避免，可能会导致设备损坏、数据丢失、设备性能降低或其它不可预知的结果。“注意”不涉及人身伤害。用于突出重要/关键信息、最佳实践和小窍门等。“说明”不是安全警示信息，不涉及人身、设备及环境伤害信息。修改记录修改记录累积了每次文档更新的说明。最新版本的文档包含以前所有文档版本的更新内容。业务应用开发指南 前 言文档版本 01 (2016-06-01) 华为专有和保

4、密信息版权所有 华为技术有限公司iii文档版本 01 (2016-06-01)版本 拟制/ 修订责任人 拟制/ 修订日期 修订内容及理由 批准人V01.00 罗振辉/00199744 2016/3/8 新拟制 薄会健 00330119V01.01 吴英德/00197074 2016/3/9 新增接口描述 薄会健 00330119V01.02 罗振辉/00199744苏本胜/002021812016/5/23 增加“远程、策略控制、告警”API 接口薄会健 00330119V01.03 鲍利亚/00346366 2017/6/28 修改版本号 薄会健 00330119业务应用开发指南 目 录文档

5、版本 01 (2016-06-01) 华为专有和保密信息版权所有 华为技术有限公司iv目 录前 言 .ii1 概述 .11.1 目的 .11.2 概述 .11.3 术语 .12 整体架构 .22.1 架构图 .22.2 接口说明 .32.3 业务应用开发 .33 设备安装 .43.1 原理说明 .43.2 接口说明 .53.3 Java 加载证书 .63.3.1 获得证书并进行转换 .63.3.2 对转换后的证书进行加载 .63.4 白名单配置接口 .73.5 白名单授权加网接口 .93.6 未知设备上线接口 .103.7 设备建档接口 .103.8 注意事项 .124 远程访问 .134.1

6、 原理 .134.2 接口说明 .134.2.1 GET 接口示例( 读取调光等级) .134.2.2 SET 接口示例（设置调光等级） .144.2.3 ACTION 接口示例（设备自检） .154.2.4 ACTION 接口示例（组播设置开关状态） .164.2.5 ACTION 接口示例（批量设置多个设备的开关状态） .174.3 注意事项 .18业务应用开发指南 目 录文档版本 01 (2016-06-01) 华为专有和保密信息版权所有 华为技术有限公司v5 计划控制 .205.1 原理 .205.1.1 三层计划关系 .205.1.2 对时 .205.1.3 计划创建过程 .215.

7、2 接口说明 .225.2.1 EEM 计划创建接口（采集计划） .225.2.2 网关计划创建接口（控制计划） .235.2.3 网关计划执行结果上报接口 .255.2.4 路灯控制器计划执行模式设置接口 .265.2.5 路灯控制器计划创建接口 .275.2.6 路灯控制器计划管理接口 .285.3 注意事项 .296 策略控制 .306.1 原理 .306.2 接口说明 .306.2.1 EEM 策略创建接口（EEM 策略） .306.2.2 路灯控制器策略执行模式设置接口 .326.2.3 路灯控制器策略创建接口 .336.2.4 路灯控制器策略管理接口 .346.3 注意事项 .35

8、7 告警 .367.1 原理 .367.2 接口说明 .367.2.1 设备上下线 .367.2.2 设备过压过流 .377.2.3 电量计量不匹配 .387.2.4 电量超出计量范畴 .387.3 注意事项 .388 参考资料 .398.1 EEM V200R009C00 调测指南 .39业务应用开发指南 1 概述文档版本 01 (2016-06-01) 华为专有和保密信息版权所有 华为技术有限公司11 概述1.1 目的本指南旨在指导客户基于华为 EEM 平台开发自己的业务系统，基于场景描述。1.2 概述适用于华为照明物联网解决方案所有的合作厂商、集成厂商进行业务系统构建参考 。1.3 术语

9、名称 定义SMS 路灯管理系统EEM 物联网能效管理平台路灯控制器 路灯的控制设备，可支持调光、计量、开关等功能。网关 路由器设备，通过 zigbee 连接路灯控制器，通过 3G、以太网、LTE 连接 EEM。设备 通篇统一：网关：000D6F00055CCF08，路灯控制器：2E00216EFC000222，单控设备： 2E00216EFC000222，设备域：root业务应用开发指南 2 整体架构文档版本 01 (2016-06-01) 华为专有和保密信息版权所有 华为技术有限公司22 整体架构2.1 架构图图 2-1 架 构 图整个解决方案包括四个部分构成，主要是路灯控制器、华为物联网网

10、关、EEM 平台、APP（业务系统） ，各部分功能描述如下。 路灯控制器：控制路灯调光、开光，支持计量功能，可采集电压、电流、功率、电量、频率数据。业务应用开发指南 2 整体架构文档版本 01 (2016-06-01) 华为专有和保密信息版权所有 华为技术有限公司3 物联网网关：连接路灯控制器，获取通过3G/LTE方式进行上行与EEM平台进行通信。 EEM平台：连接物联网网关，提供上行RESTCONF、WebSocket接口给第三方应用进行二次开发，可实现对路灯进行远程开关、调光等功能，也支持编制计划和策略控制。 APP：客户基于EEM平台开发的业务应用系统。2.2 接口说明表 2-1 接 口

11、 说 明模块 接口类型描述 备注路灯控制器物联网网关 Zigbee 无线通信技术，支持 MESH物联网网关EEM 3G/LTE/以太网上行通信技术，TCP/IP 协议通信EEMAPP RESTCONFRestful 接口，采用 YANG 模型描述，用于下发远程控制命令、本地计划创建、策略创建等功能。EEMAPP WEBSOCKETWebSocket 接口，用于上报即时消息，如设备上线、下线，设备告警等。2.3 业务应用开发客户可以根据 EEM 提供的接口进行业务应用开发，接口文档可参考华为物联网 EEM平台接口文档。后续章节会根据各类场景描述整个方案原理以及实用接口说明。Restful 的使用和 Websocket 的使用请参阅 8 参考资料章节应用开发前网关需要先配置连接到 EEM，配置方法参考下面的附件：EEM与 AR502之 间 的组 网 步 骤 .docx业务应用开发指南 3 设备安装文档版本 01 (2016-06-01) 华为专有和保密信息版权所有 华为技术有限公司43 设备安装3.1 原理说明图 3-1 设 备 安 装 流 程