华为照明物联网解决方案业务应用开发指南文档版本01发布日期2016-06-01华为技术有限公司在清洗液中硅表面为负电位有些颗粒也为负电位，由于两者的电的排斥力作用可防止粒子向晶片表面吸附，但也有部分粒子表面是正电位，由于两者电的吸引力作用，粒子易向晶片表面吸附。版权所有 华为技术有限公司 2016。 保留一切权利。非经本公司书面许可，任何单位和个人不得擅自摘抄、复制本文档内容的部分或全部，并不得以任何形式传播。商标声明和其他华为商标均为华为技术有限公司的商标。本文档提及的其他所有商标或注册商标，由各自的所有人拥有。注意您购买的产品、服务或特性等应受华为公司商业合同和条款的约束，本文档中描述的全部或部分产品、服务或特性可能不在您的购买或使用范围之内。除非合同另有约定，华为公司对本文档内容不做任何明示或暗示的声明或保证。由于产品版本升级或其他原因，本文档内容会不定期进行更新。除非另有约定，本文档仅作为使用指导，本文档中的所有陈述、信息和建议不构成任何明示或暗示的担保。华为技术有限公司地址：深圳市龙岗区坂田华为总部办公楼 邮编：网址：https:/e.huawei.com文档版本01 (2016-06-01)华为专有和保密信息版权所有 华为技术有限公司v业务应用开发指南前 言前 言读者对象本文档（本指南）主要适用于以下工程师：l 二次开发工程师符号约定在本文中可能出现下列标志，它们所代表的含义如下。符号说明用于警示紧急的危险情形，若不避免，将会导致人员死亡或严重的人身伤害。用于警示潜在的危险情形，若不避免，可能会导致人员死亡或严重的人身伤害。用于警示潜在的危险情形，若不避免，可能会导致中度或轻微的人身伤害。用于传递设备或环境安全警示信息，若不避免，可能会导致设备损坏、数据丢失、设备性能降低或其它不可预知的结果。“注意”不涉及人身伤害。用于突出重要/关键信息、最佳实践和小窍门等。“说明”不是安全警示信息，不涉及人身、设备及环境伤害信息。修改记录修改记录累积了每次文档更新的说明。最新版本的文档包含以前所有文档版本的更新内容。文档版本 01 (2016-06-01)版本拟制/修订责任人拟制/修订日期修订内容及理由批准人V01.00罗振辉/2016/3/8新拟制薄会健 V01.01吴英德/2016/3/9新增接口描述薄会健 V01.02罗振辉/苏本胜/2016/5/23增加“远程、策略控制、告警”API接口薄会健 V01.03鲍利亚/2017/6/28修改版本号薄会健 业务应用开发指南目 录目 录前 言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 原理134.2 接口说明134.2.1 GET接口示例(读取调光等级)134.2.2 SET接口示例（设置调光等级）144.2.3 ACTION接口示例（设备自检）154.2.4 ACTION接口示例（组播设置开关状态）164.2.5 ACTION接口示例（批量设置多个设备的开关状态）174.3 注意事项185 计划控制205.1 原理205.1.1 三层计划关系205.1.2 对时205.1.3 计划创建过程215.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 注意事项357 告警367.1 原理367.2 接口说明367.2.1 设备上下线367.2.2 设备过压过流377.2.3 电量计量不匹配387.2.4 电量超出计量范畴387.3 注意事项388 参考资料398.1 EEM V200R009C00调测指南39业务应用开发指南8 参考资料1 概述1.1 目的本指南旨在指导客户基于华为EEM平台开发自己的业务系统，基于场景描述。1.2 概述适用于华为照明物联网解决方案所有的合作厂商、集成厂商进行业务系统构建参考。1.3 术语名称定义SMS路灯管理系统EEM物联网能效管理平台路灯控制器路灯的控制设备，可支持调光、计量、开关等功能。网关路由器设备，通过zigbee连接路灯控制器，通过3G、以太网、LTE连接EEM。设备通篇统一：网关：000D6F00055CCF08，路灯控制器：2E00216EFC，单控设备：2E00216EFC，设备域：root文档版本01 (2016-06-01)华为专有和保密信息版权所有 华为技术有限公司392 整体架构2.1 架构图图2-1 架构图整个解决方案包括四个部分构成，主要是路灯控制器、华为物联网网关、EEM平台、APP（业务系统），各部分功能描述如下。l 路灯控制器：控制路灯调光、开光，支持计量功能，可采集电压、电流、功率、电量、频率数据。l 物联网网关：连接路灯控制器，获取通过3G/LTE方式进行上行与EEM平台进行通信。l EEM平台：连接物联网网关，提供上行RESTCONF、WebSocket接口给第三方应用进行二次开发，可实现对路灯进行远程开关、调光等功能，也支持编制计划和策略控制。l APP：客户基于EEM平台开发的业务应用系统。2.2 接口说明表2-1 接口说明模块接口类型描述备注路灯控制器物联网网关Zigbee无线通信技术，支持MESH物联网网关EEM3G/LTE/以太网上行通信技术，TCP/IP协议通信EEMAPPRESTCONFRestful接口，采用YANG模型描述，用于下发远程控制命令、本地计划创建、策略创建等功能。EEMAPPWEBSOCKETWebSocket接口，用于上报即时消息，如设备上线、下线，设备告警等。2.3 业务应用开发客户可以根据EEM提供的接口进行业务应用开发，接口文档可参考华为物联网EEM平台接口文档。后续章节会根据各类场景描述整个方案原理以及实用接口说明。Restful的使用和Websocket的使用请参阅Error! Reference source not found.Error! Reference source not found.章节应用开发前网关需要先配置连接到EEM，配置方法参考下面的附件：3 设备安装3.1 原理说明图3-1 设备安装流程设备安装主要包括以下几个步骤；配置白名单：设备白名单给物联网网关，旨在告知物联网网关那些设备可入网。白名单授权加网：开启Zigbee网络加网权限，设备可搜索网络，并加入到Zigbee网络中，白名单之外设备当作非法设备处理，不可加入到Zigbee网络中。设备上线：设备加网到Zigbee网络之后，上报上线消息，EEM通过WEBSOCKET接口告知APP，当前设备还处于未知设备状态。建档：设备上线之后，当前设备还处于未知设备状态，APP可调用EEM接口进行建档，建档之后，设备才可正常操作，为可识别设备。在整个过程中，设备的状态变化，如下图所示；图3-2 设备状态图3.2 接口说明1 本文档示例中使用到的网关ID和传感器ID需要根据真实环境更改为正确的设备ID。2 本文档示例中使用的EEM平台的IP地址是127.0.0.1，在真实环境中需要将IP地址改为EEM平台的IP地址。3 本文档示例中使用的EEM平台的IP端口号是18443，这是基于https协议访问EEM平台的缺省缺口号（如果使用http协议，缺省的端口号为8181）。3.3 Java加载证书3.3.1 获得证书并进行转换从路径/opt/controller/naas/naas-karaf-1.0.1-SNAPSHOT/configuration/ssl下获得iotdmClient.p12和server.crt两个证书。前置条件：由于使用的是Java Key Store格式的证书，所以，必须使用Java提供的keytool工具箱，因此，执行下面指令的电脑必须安装了JDK(Java SE Development Kit)，最好是配置了环境变量。1.转换server.crt为trustcer.jks:keytool import alias iotdmServer -file server.crt -keystore jks/trustcer.jks -keypass Changeme_123 -storepass Changeme_123 -trustcacerts noprompt参数说明：server.crt: 源证书路径。jks/trustcer.jks: 目标证书存储路径。第一个Changeme_123: 更改条目的密钥口令。第二个Changeme_123: 更改密钥库的存储口令。iotdmServer: 证书的别名,不指定,则默认为mykey。说明：该指令是将可信任的证书转换为Java Key Store格式的证书。如果指定的targetJKSPath不存在这个jks文件，则自动生成一个jks文件（注：目录不会自动产生，只会在指定目录下生成jks文件），如果已经存在了jks文件，则在该jks文件中追加该证书。2.转换iotdmClient.p12为keystore.jks:keytool -v -importkeystore -srckeystore iotdmClient.p12 -srcstoretype PKCS12 -destkeystore jks/keystore.jks -deststoretype JKS -srcstorepass Changeme_123 -deststorepass Changeme_123 -noprompt -changealias -destalias iotdmalias -alias iotdmclient参数说明