華為照明物聯(lián)網(wǎng)解決方案業(yè)務(wù)應(yīng)用開(kāi)發(fā)指南

1、華為照明物聯(lián)網(wǎng)解決方案業(yè)務(wù)應(yīng)用開(kāi)發(fā)指南文檔版本01發(fā)布日期2016-06-01華為技術(shù)有限公司版權(quán)所有? 華為技術(shù)有限公司2016。 保留一切權(quán)利。非經(jīng)本公司書(shū)面許可，任何單位和個(gè)人不得擅自摘抄、復(fù)制本文檔內(nèi)容的部分或全部，并不得以任何形式傳播。商標(biāo)聲明和其他華為商標(biāo)均為華為技術(shù)有限公司的商標(biāo)。本文檔提及的其他所有商標(biāo)或注冊(cè)商標(biāo)，由各自的所有人擁有。注意您購(gòu)買(mǎi)的產(chǎn)品、服務(wù)或特性等應(yīng)受華為公司商業(yè)合同和條款的約束，本文檔中描述的全部或部分產(chǎn)品、服務(wù)或特性可能不在您的購(gòu)買(mǎi)或使用范圍之內(nèi)。除非合同另有約定，華為公司對(duì)本文檔內(nèi)容不做任何明示或暗示的聲明或保證。由于產(chǎn)品版本升級(jí)或其他原因，本文檔內(nèi)容會(huì)不

2、定期進(jìn)行更新。除非另有約定，本文檔僅作為使用指導(dǎo)，本文檔中的所有陳述、信息和建議不構(gòu)成任何明示或暗示的擔(dān)保。華為技術(shù)有限公司地址：深圳市龍崗區(qū)坂田華為總部辦公樓郵編： 518129網(wǎng)址：前言讀者對(duì)象本文檔（本指南）主要適用于以下工程師：二次開(kāi)發(fā)工程師符號(hào)約定在本文中可能出現(xiàn)下列標(biāo)志，它們所代表的含義如下。符號(hào)說(shuō)明用于警示緊急的危險(xiǎn)情形，若不避免，將會(huì)導(dǎo)致人員死亡或嚴(yán)重的人身傷害。用于警示潛在的危險(xiǎn)情形，若不避免，可能會(huì)導(dǎo)致人員死亡或嚴(yán)重的人身傷害。用于警示潛在的危險(xiǎn)情形，若不避免，可能會(huì)導(dǎo)致中度或輕微的人身傷害。用于傳遞設(shè)備或環(huán)境安全警示信息，若不避免，可能會(huì)導(dǎo)致設(shè)備損壞、數(shù)據(jù)丟失、設(shè)備性能降

3、低或其它不可預(yù)知的結(jié)果?！白⒁狻辈簧婕叭松韨ΑＳ糜谕怀鲋匾?關(guān)鍵信息、最佳實(shí)踐和小竅門(mén)等?！罢f(shuō)明” 不是安全警示信息， 不涉及人身、 設(shè)備及環(huán)境傷害信息。修改記錄修改記錄累積了每次文檔更新的說(shuō)明。 最新版本的文檔包含以前所有文檔版本的更新內(nèi)容。文檔版本01 (2016-06-01)版本擬制 / 修訂責(zé)任人擬制 / 修訂日期V01.00羅振輝 /001997442016/3/8V01.01吳英德 /001970742016/3/9V01.02羅振輝 /001997442016/5/23蘇本勝 /00202181V01.03鮑利亞 /003463662017/6/28修訂內(nèi)容及理由新擬制新增接口

4、描述增加“遠(yuǎn)程、策略控制、告警”API 接口修改版本號(hào)批準(zhǔn)人薄會(huì)健00330119薄會(huì)健00330119薄會(huì)健00330119薄會(huì)健00330119目錄前言 .ii1 概述 .11.1目的 .11.2概述 .11.3術(shù)語(yǔ) .12 整體架構(gòu) .22.1架構(gòu)圖 .22.2接口說(shuō)明 .32.3業(yè)務(wù)應(yīng)用開(kāi)發(fā) .33 設(shè)備安裝 .43.1原理說(shuō)明 .43.2接口說(shuō)明 .53.3 Java 加載證書(shū) .63.3.1獲得證書(shū)并進(jìn)行轉(zhuǎn)換 .63.3.2對(duì)轉(zhuǎn)換后的證書(shū)進(jìn)行加載.63.4白名單配置接口 .73.5白名單授權(quán)加網(wǎng)接口 .93.6未知設(shè)備上線(xiàn)接口 .103.7設(shè)備建檔接口 .103.8注意事項(xiàng) .12

5、4 遠(yuǎn)程訪問(wèn) .134.1原理 .134.2接口說(shuō)明 .134.2.1GET 接口示例 (讀取調(diào)光等級(jí) ) .134.2.2SET 接口示例（設(shè)置調(diào)光等級(jí)）.144.2.3ACTION接口示例（設(shè)備自檢） .154.2.4ACTION接口示例（組播設(shè)置開(kāi)關(guān)狀態(tài)）.164.2.5ACTION接口示例（批量設(shè)置多個(gè)設(shè)備的開(kāi)關(guān)狀態(tài)）.174.3注意事項(xiàng) .185 計(jì)劃控制 .205.1 原理 .205.1.1三層計(jì)劃關(guān)系 .205.1.2對(duì)時(shí) .205.1.3計(jì)劃創(chuàng)建過(guò)程 .215.2 接口說(shuō)明 .225.2.1 EEM 計(jì)劃創(chuàng)建接口（采集計(jì)劃）.225.2.2網(wǎng)關(guān)計(jì)劃創(chuàng)建接口（控制計(jì)劃）.235.

6、2.3網(wǎng)關(guān)計(jì)劃執(zhí)行結(jié)果上報(bào)接口.255.2.4路燈控制器計(jì)劃執(zhí)行模式設(shè)置接口.265.2.5路燈控制器計(jì)劃創(chuàng)建接口.275.2.6路燈控制器計(jì)劃管理接口.285.3 注意事項(xiàng) .296 策略控制 .306.1原理 .306.2接口說(shuō)明 .306.2.1 EEM 策略創(chuàng)建接口（ EEM 策略） .306.2.2路燈控制器策略執(zhí)行模式設(shè)置接口.326.2.3路燈控制器策略創(chuàng)建接口.336.2.4路燈控制器策略管理接口.346.3注意事項(xiàng) .357 告警 .367.1原理 .367.2接口說(shuō)明 .367.2.1設(shè)備上下線(xiàn) .367.2.2設(shè)備過(guò)壓過(guò)流 .377.2.3電量計(jì)量不匹配 .387.2.4

7、電量超出計(jì)量范疇 .387.3注意事項(xiàng) .388 參考資料 .398.1 EEM V200R009C00 調(diào)測(cè)指南 .391 概述1.1 目的本指南旨在指導(dǎo)客戶(hù)基于華為EEM 平臺(tái)開(kāi)發(fā)自己的業(yè)務(wù)系統(tǒng)，基于場(chǎng)景描述。1.2 概述適用于華為照明物聯(lián)網(wǎng)解決方案所有的合作廠商、集成廠商進(jìn)行業(yè)務(wù)系統(tǒng)構(gòu)建參考。1.3 術(shù)語(yǔ)名稱(chēng)定義SMS路燈管理系統(tǒng)EEM物聯(lián)網(wǎng)能效管理平臺(tái)路燈控制器路燈的控制設(shè)備，可支持調(diào)光、計(jì)量、開(kāi)關(guān)等功能。網(wǎng)關(guān)路由器設(shè)備，通過(guò)zigbee 連接路燈控制器，通過(guò)3G、以太網(wǎng)、 LTE 連接 EEM 。設(shè)備通篇統(tǒng)一：網(wǎng)關(guān)：000D6F00055CCF08 ，路燈控制器：2E00216EFC

8、000222 ，單控設(shè)備： 2E00216EFC000222 ，設(shè)備域： root2 整體架構(gòu)2.1 架構(gòu)圖圖2-1 架構(gòu)圖整個(gè)解決方案包括四個(gè)部分構(gòu)成，主要是路燈控制器、華為物聯(lián)網(wǎng)網(wǎng)關(guān)、EEM 平臺(tái)、APP（業(yè)務(wù)系統(tǒng)），各部分功能描述如下。路燈控制器：控制路燈調(diào)光、開(kāi)光，支持計(jì)量功能，可采集電壓、電流、功率、電量、頻率數(shù)據(jù)。物聯(lián)網(wǎng)網(wǎng)關(guān)： 連接路燈控制器， 獲取通過(guò) 3G/LTE方式進(jìn)行上行與 EEM平臺(tái)進(jìn)行通信。EEM平臺(tái)：連接物聯(lián)網(wǎng)網(wǎng)關(guān)，提供上行 RESTCONF、WebSocket接口給第三方應(yīng)用進(jìn)行二次開(kāi)發(fā)，可實(shí)現(xiàn)對(duì)路燈進(jìn)行遠(yuǎn)程開(kāi)關(guān)、 調(diào)光等功能， 也支持編制計(jì)劃和策略控制。APP：客

9、戶(hù)基于 EEM平臺(tái)開(kāi)發(fā)的業(yè)務(wù)應(yīng)用系統(tǒng)。2.2 接口說(shuō)明表2-1 接口說(shuō)明模塊接口類(lèi)型路燈控制器 <-> 物聯(lián)網(wǎng)網(wǎng)關(guān)Zigbee物聯(lián)網(wǎng)網(wǎng)關(guān) <->EEM3G/LTE/以太網(wǎng)EEM<->APPRESTCONF描述備注無(wú)線(xiàn)通信技術(shù)，支持MESH上行通信技術(shù)， TCP/IP 協(xié)議通信Restful 接口，采用 YANG 模型描述，用于下發(fā)遠(yuǎn)程控制命令、本地計(jì)劃創(chuàng)建、策略創(chuàng)建等功能。EEM<->APPWEBSOWebSocket 接口，用于上報(bào)即CKET時(shí)消息，如設(shè)備上線(xiàn)、下線(xiàn)，設(shè)備告警等。2.3 業(yè)務(wù)應(yīng)用開(kāi)發(fā)客戶(hù)可以根據(jù) EEM 提供的接口進(jìn)行業(yè)務(wù)應(yīng)用開(kāi)

10、發(fā)， 接口文檔可參考華為物聯(lián)網(wǎng) EEM 平臺(tái)接口文檔。后續(xù)章節(jié)會(huì)根據(jù)各類(lèi)場(chǎng)景描述整個(gè)方案原理以及實(shí)用接口說(shuō)明。Restful 的使用和 Websocket 的使用請(qǐng)參閱8 參考資料章節(jié)應(yīng)用開(kāi)發(fā)前網(wǎng)關(guān)需要先配置連接到EEM ，配置方法參考下面的附件：EEM與AR502之間的組網(wǎng)步驟 .docx3 設(shè)備安裝3.1 原理說(shuō)明圖3-1 設(shè)備安裝流程sd 調(diào)用流程APPEEM物聯(lián)網(wǎng)網(wǎng)關(guān)路燈控制器alt Step1 ：配置白名單選擇網(wǎng)關(guān) ID()調(diào)用 EEM 配置白名單接口 ()封裝 EEM 配置白名單協(xié)議并下發(fā)給網(wǎng)關(guān)()RESTCONF 接口解析白名單并配置 ()alt Step2：白名單授權(quán)加網(wǎng)調(diào)用

11、EEM 白名單授權(quán)加網(wǎng)接口()封裝 EEM 白名單授權(quán)加網(wǎng)協(xié)議并下發(fā)給網(wǎng)關(guān)()RESTCONF 接口開(kāi)啟加網(wǎng)權(quán)限 ()alt Step3：設(shè)備上線(xiàn)設(shè)備自動(dòng)搜索網(wǎng)絡(luò) ()加入網(wǎng)絡(luò)，并上報(bào)上線(xiàn)消息()WEBSOCKET 接口上報(bào)設(shè)備上線(xiàn)消息 ()上報(bào)未知設(shè)備上線(xiàn)()alt Step4:建檔調(diào)用 EEM 設(shè)備建檔接口 ()RESTCONF 接口設(shè)備安裝主要包括以下幾個(gè)步驟；配置白名單：設(shè)備白名單給物聯(lián)網(wǎng)網(wǎng)關(guān)，旨在告知物聯(lián)網(wǎng)網(wǎng)關(guān)那些設(shè)備可入網(wǎng)。白名單授權(quán)加網(wǎng)：開(kāi)啟Zigbee 網(wǎng)絡(luò)加網(wǎng)權(quán)限，設(shè)備可搜索網(wǎng)絡(luò)，并加入到Zigbee網(wǎng)絡(luò)中，白名單之外設(shè)備當(dāng)作非法設(shè)備處理，不可加入到Zigbee 網(wǎng)絡(luò)中。設(shè)備

12、上線(xiàn)： 設(shè)備加網(wǎng)到 Zigbee 網(wǎng)絡(luò)之后， 上報(bào)上線(xiàn)消息， EEM 通過(guò) WEBSOCKET 接口告知 APP，當(dāng)前設(shè)備還處于未知設(shè)備狀態(tài)。建檔：設(shè)備上線(xiàn)之后， 當(dāng)前設(shè)備還處于未知設(shè)備狀態(tài)， APP 可調(diào)用 EEM 接口進(jìn)行建檔，建檔之后，設(shè)備才可正常操作，為可識(shí)別設(shè)備。在整個(gè)過(guò)程中，設(shè)備的狀態(tài)變化，如下圖所示；圖3-2 設(shè)備狀態(tài)圖s tm 狀態(tài)圖白名單授權(quán)加網(wǎng) 入網(wǎng)設(shè)備上線(xiàn) 指定設(shè)備退網(wǎng) 未知設(shè)備未入網(wǎng)設(shè)備建檔 指定設(shè)備退網(wǎng) 可識(shí)別設(shè)備3.2 接口說(shuō)明1 本文檔示例中使用到的網(wǎng)關(guān)ID 和傳感器 ID 需要根據(jù)真實(shí)環(huán)境更改為正確的設(shè)備ID 。2本文檔示例中使用的址改為 EEM 平臺(tái)的EEM

13、平臺(tái)的 IP 地址。IP地址是，在真實(shí)環(huán)境中需要將IP地3 本文檔示例中使用的 EEM 平臺(tái)的 IP 端口號(hào)是 18443，這是基于 https 協(xié)議訪問(wèn) EEM 平臺(tái)的缺省缺口號(hào)（如果使用 http 協(xié)議，缺省的端口號(hào)為 8181）。3.3 Java 加載證書(shū)3.3.1 獲得證書(shū)并進(jìn)行轉(zhuǎn)換從路徑 /opt/controller/naas/naas-karaf-1.0.1-SNAPSHOT/configuration/ssl下獲得iotdmClient.p12 和 server.crt 兩個(gè)證書(shū)。前置條件：由于使用的是Java Key Store 格式的證書(shū)， 所以，必須使用

14、Java 提供的 keytool工具箱，因此，執(zhí)行下面指令的電腦必須安裝了配置了環(huán)境變量。JDK(Java SE Development Kit) ，最好是1.轉(zhuǎn)換 server.crt 為 trustcer.jks:keytool import alias iotdmServer -file server.crt -keystore jks/trustcer.jks -keypassChangeme_123 -storepass Changeme_123 -trustcacerts noprompt 參數(shù)說(shuō)明：server.crt: 源證書(shū)路徑。jks/trustcer.jks:目標(biāo)證書(shū)存儲(chǔ)

15、路徑。第一個(gè) Changeme_123: 更改條目的密鑰口令。第二個(gè) Changeme_123: 更改密鑰庫(kù)的存儲(chǔ)口令。iotdmServer:證書(shū)的別名,不指定 ,則默認(rèn)為mykey 。說(shuō)明：該指令是將可信任的證書(shū)轉(zhuǎn)換為Java Key Store 格式的證書(shū)。如果指定的targetJKSPath 不存在這個(gè)jks 文件， 則自動(dòng)生成一個(gè)jks 文件（注：目錄不會(huì)自動(dòng)產(chǎn)生，只會(huì)在指定目錄下生成jks 文件），如果已經(jīng)存在了jks 文件，則在該jks 文件中追加該證書(shū)。2.轉(zhuǎn)換 iotdmClient.p12 為 keystore.jks:keytool -v -importkeystore

16、-srckeystore iotdmClient.p12 -srcstoretype PKCS12 -destkeystorejks/ keystore.jks -deststoretype JKS -srcstorepass Changeme_123 -deststorepass Changeme_123 -noprompt -changealias -destalias iotdmalias -alias iotdmclient參數(shù)說(shuō)明：iotdmClient.p12:源證書(shū)路徑。jks/ keystore.jks: 目標(biāo)證書(shū)存儲(chǔ)路徑。第一個(gè) Changeme_123: 更改條目的密鑰口令

17、。第二個(gè) Changeme_123: 更改密鑰庫(kù)的存儲(chǔ)口令。iotdmclient:證書(shū)的別名,不指定,則默認(rèn)為mykey 。說(shuō)明：該指令是將 p12 的證書(shū)轉(zhuǎn)換為 Java Key Store targetJKSPath 不存在這個(gè) jks 文件， 則自動(dòng)生成一個(gè)只會(huì)在指定目錄下生成 jks 文件），如果已經(jīng)存在了格式的證書(shū)。如果指定的jks 文件（注：目錄不會(huì)自動(dòng)產(chǎn)生，jks 文件，則在該jks 文件中追加該證書(shū)。3.3.2 對(duì)轉(zhuǎn)換后的證書(shū)進(jìn)行加載加載證書(shū)樣例：public class Testpublic static void main(String args)Cert.loadJKS

18、Cert();Cert.setInterface();public static void loadJKSCert()char password = "Changeme_123".toCharArray();File keystore = new File("keystore.jks");File trustFile = new File("trustcer.jks");SSLContext sslcontext;trysslcontext =SSLContexts.custom().useProtocol("TLSv1.2

19、").loadTrustMaterial(trustFile).loadKeyMaterial(keystore, password, password).build();HttpClient httpClient =HttpClients.custom().setSSLContext(sslcontext).build();Unirest.setHttpClient(httpClient);catch (KeyManagementException | UnrecoverableKeyException |NoSuchAlgorithmException | KeyStoreExc

20、eption| CertificateException | IOException e)e.printStackTrace();public static void setInterface()HttpResponse<JsonNode> response;tryresponse =Unirest.post("50:18443/iotdm/nb/v1/system/action/urn:huawei:iotdm:devmgr/get").header("content-type","applica

21、tion/json").queryString("domain", "H1").asJson();catch (UnirestException e)e.printStackTrace();說(shuō)明： keystore.jks要調(diào)用一次即可，和 trustcer.jks setInterface()為 3.3.1 中轉(zhuǎn)換后的證書(shū)所存放的位置，方法中的內(nèi)容可用對(duì)應(yīng)接口內(nèi)容進(jìn)行替換。loadJKSCert()方法只需3.4 白名單配置接口數(shù)據(jù)項(xiàng)名稱(chēng) : 白名單設(shè)備增加white-list-device-add例子：ID 為 000D6F00055CCF

22、08 的網(wǎng)關(guān)下連接了四個(gè)ID 分別為 2E00B136CB000515 、2E0012F111000178、2E00B136CB000594 和 2E0012F111000181 的設(shè)備，將這四個(gè)設(shè)備添加到白名單。接口：URL::18443/iotdm/nb/v1/device/action/000D6F00055CCF08/urn:huawei:iotdm:device/huawei-iotdm-device-common:white-list-device-addMethod:POSTBody ："devices":"2E00B

23、136CB000515","2E0012F111000178","2E00B136CB000594","2E0012F111000181"Result:OKJava:HttpResponse<String> response =Unirest.post(":18443/iotdm/nb/v1/device/action/000D6F00055CCF08/urn:huawei:iotdm:device/huawei-iotdm-device-common:white-lis

24、t-device-add").header("content-type", "application/json").header("cache-control", "no-cache").body("n"devices":nn"2E00B136CB000515",n"2E0012F111000178",n"2E00B136CB000594",n"2E0012F111000181"nn")

25、.asString();Javascript:var settings = "async": true,"crossDomain": true,"url":":18443/iotdm/nb/v1/device/action/000D6F00055CCF08/urn:huawei:iotd m:device/huawei-iotdm-device-common:white-list-device-add","method": "POST",&qu

26、ot;headers": "content-type": "application/json","cache-control": "no-cache","processData": false,"data": "n"devices":n"2E0012F111000178",n"2E0012F111000181"nn"n "2E00B136CB000515",n "2E00B136CB000594",n$.ajax(settings).done(function (response) console.log(res