發布時間： 2018-03-02 10:53:38
?整體結構
· 獲取IoT平臺資源，下載并激活SoftRadio軟件。 · 通過SP Portal在IoT平臺上創建北向應用，獲取appID/secret。 · 編寫設備Profile文件，并上傳至IoT平臺。 · 編寫編解碼插件，并上傳至IoT平臺。 · 編寫北向應用，調用鑒權接口。 · 編寫北向應用，調用注冊直連設備。 · 編寫北向應用，調用修改設備信息。 · 南向設備綁定上線。 · 調用北向應用其他接口完善功能，如消息訂閱、命令下發。 · 南向設備上報數據。 詳細參考 http://developer.huawei.com/ict/forum/thread-26163.html
準備資源 平臺資源申請OceanConnect平臺資源的方式有兩種： 1. 提交MAR合作電子流，通過審批后，在審批意見中會下發OceanConnect平臺資源的獲取方式。提交MAR合作電子流請參考：http://developer.huawei.com/ilink/esdk/download/HW_484292 2. 預約遠程實驗室。預約遠程實驗室操作可參考：http://developer.huawei.com/ict/cn/doc/IoT-Platform-North-HelloWorld/index.html/zh-cn_topic_0065817579SoftRadioSoftRadio模擬模組+基站+核心網，只能運行在PC端。 版本：V100R002C00SPC001。 中文版下載地址 http://developer.huawei.com/ict/cn/rescenter/CMDA_FIELD_NB_IOT?developlan=Other 下載安裝成功后，請根據軟件配套的《SoftRadio用戶指南》指引進行License申請，并加載激活。 Profile文件Demo MultiSensor_eSDK_v01.zip，請下載附件后上傳至OceanConnect平臺使用，無須修改。 編解碼插件Demo 與MultiSensor_eSDK_v01.zip配套的編解碼插件已由華為人員上傳至OceanConnect平臺，可直接使用 ，無須關注。 GUI Demo 模擬北向應用。下載地址：https://github.com/Huawei/IoT_OceanConnect_North_GUI_APPDemo 虛擬串口工具虛擬串口——VPSD，可自行百度下載。作用及使用方法參考：http://developer.huawei.com/ict/forum/thread-19237.html
上傳開發組件 上傳profile文件至OceanConnect平臺 https://117.78.47.187:8093/#/login 將已下載的profile文件MultiSensor_eSDK_v01.zip上傳至OceanConnect平臺。具體方法如下： Step 1 使用郵件中的“平臺Portal鏈接”和“登錄賬號/密碼”信息登錄OceanConnect平臺，選擇菜單“Profile開發 > 導入Profile”
Step 2 單擊右上角“導入”圖標，上傳文件時選中Profile資源文件 MultiSensor_eSDK_v01.zip，設備類型、廠家ID和設備型號無須修改，單擊“上傳”。
上傳編解碼插件至OceanConnect平臺與MultiSensor_eSDK_v01.zip配套的編解碼插件已上傳至IoT平臺，您可直接使用，無須重復上傳。 注意：在后續業務開發過程中，您需要根據業務需要開發自己的編解碼插件并上傳至OceanConnect平臺。 上線設備 注冊設備至OceanConnect平臺以下提供兩種注冊設備的方法，通過GUI Demo注冊的方法適合所有平臺，界面化注冊只適合開發者Portal平臺，請根據平臺資源情況擇其一參考。 方法一：通過OceanConnect平臺注冊設備 http://developer.huawei.com/ict/forum/thread-25749.html Step 1 登錄OceanConnect平臺，單擊“我的設備 > 注冊設備”，即可看到應用下所有已上傳的Profile，單擊選中需要注冊設備對應的Profile。
Step 2 在Profile詳情頁，填寫“設備名稱”和“設備標識碼”，單擊“注冊”按鈕注冊設備。 · 設備名稱：用于區分不同設備，名稱可自定義（如MultiSensor-01）。 · 設備標識碼：設備唯一標識。使用SoftRadio對接時，可自行定義“TEST$_XXXX”格式的注冊碼?！癟EST$_”之后可以是數字、字母和特殊符號或其組合（如TEST$_MS01）。
Step 3 單擊“我的設備”，查看對應設備是否注冊成功。如果注冊成功，可以看到設備處于“OFFLINE”狀態。
?
方法二：通過GUI Demo注冊設備
Step 1 解壓IoT_OceanConnect_North_GUI_APPDemo.zip（簡稱GUI Demo）壓縮包，打開application文件夾，直接雙擊運行Demo.jar文件。
Step 2 根據華為下發的OceanConnect平臺資源郵件內容填寫對應配置項后，單擊“Login”按鈕登錄。
Step 3 在“Module Choose”選項框中，“Solution”選擇“NB-IoT”，“Module”選擇“Device Manager”。
Step 4 在“Register Direct Device”框中填寫各參數。各參數含義及設置方法如下：
Node ID：設備唯一標識。使用SoftRadio對接時，可自行定義“TEST$_XXXX”格式的注冊碼?！癟EST$_”之后可以是數字、字母和特殊符號或其組合（如TEST$_MS01）。
Verify Code：與Node ID保持一致。（同為TEST$_MS01）。
Time out：設備注冊至平臺的過期時間，單位為秒。真實設備必須在設置的時間內上線，否則會因過期而被IoT平臺刪除。建議直接填寫“0”（設備不會過期）。
Step 5 單擊“Register”按鈕注冊設備至OcaenConnect平臺。
注冊成功后會返回deviceId。deviceId是OcaenConnect平臺對于設備的唯一標識，請妥善保存，以備調用后續接口時使用。
Step 6 在“Modify Device Info”框中，根據Profile文件中的信息，按照以下要求填寫各參數后，單擊“Modify”按鈕設置設備信息，并保存至IoT平臺。
Device ID：注冊直連設備時返回的deviceId。固定值。
Manufacturer Id：與Profile文件中的manufacturerId保持一致。填寫“eSDK”。
Manufacturer Name：與Profile文件中的manufacturerName保持一致。填寫“eSDK_Huawei”。
Device Type:與Profile文件中的deviceType保持一致。填寫“MultiSensor”
Model：設備型號 v01
Protocol Type：與Profile文件中的protocolType保持一致。NB-IoT方案統一填寫“CoAP”。
說明：如果修改設備信息成功，可以在OcaenConnect平臺中看到設備處于“OFFLINE”狀態。使用SoftRadio綁定、上線設備請參照《SoftRadio用戶指南》第8章完成各項配置，配置項信息從資源郵件中獲取。SoftRadio的具體使用方法還請參考文檔，下文只針對關鍵信息進行配置說明。
IoT平臺設置：請根據資源郵件中的“SoftRadio對接信息”項填寫IP地址和端口號。
設備管理：添加設備時，設備信息需要與步驟3.1中注冊設備時的信息保持一致，可以在Profile詳情頁查看。
- 終端注冊驗證碼：填寫注冊設備時的設備標識碼（TEST$_MS01）；
- 設備廠商：廠商ID，填寫“eSDK”；
- 設備類型：填寫“MultiSensor”;
- 型號：填寫“v01”；
- 通訊協議：取固定值“CoAP”。
提交后，“綁定狀態”顯示為“已注冊”。 點擊按鈕，即可與OceanConnect平臺中注冊的設備綁定在一起，“綁定狀態”顯示為“已激活”。此時，在OceanConnect平臺中可以看到剛注冊的設備由“OFFLINE”變為“ONLINE”狀態。
COM設置：
“COM編號”選擇與設備進行通信的虛擬串口對，其他選項保持默認。COM信息提交后，設備管理界面中的“串口狀態”由“未設置”變為“已激活”。 ?
虛擬串口技術應用(1) 何為虛擬串口
虛擬串口是用操作系統的虛擬驅動技術產生的串口（COM口），相對于計算機本身的硬件串口（COM1等）來說虛擬串口并不對應一個物理上的串口，但是計算機應用軟件可以像硬件串口一樣地使用虛擬串口，對于串口軟件來說虛擬串口和硬件串口并沒有區別。
(2) 虛擬串口的應用場景
在很多應用環境中，終端設備的管理、通信等接口普遍為串行接口方式，這些接口通常用于本地數據通信。隨著通信網絡建設的飛速發展和以太網技術的普及，更多跨網、跨地區的數據通信需求逐漸增加，傳統的串口通信方式已無法適應新的用戶需求和傳輸網絡環境，但是大量的工控設備、復式終端等仍然采用串口通信方式，并且會繼續使用很長時間，為了使這些基于串口的設備能夠適應新的網絡環境，一種有效的方式是采用虛擬串口以及串口-網絡轉換模塊配合，實現串口設備信息的網絡傳輸。這樣既能夠方便的解決串口終端設備的網絡通信問題，又極大程度的保護了用戶的原有投資。
(3) 虛擬串口的應用實例對比
可編程序控制器（PLC）是目前廣泛運用于工業自動化的器件，通常情況，將一條數據電纜連接于PLC和主機的串口（例如COM1）之間，編程軟件會通過串口找到下位設備（PLC），從而完成對PLC的程序寫入或運行監控。在這里，COM1是計算機的一個實際的串口；當PLC與電腦相隔甚遠（設備所在地與制造商之間的距離），我們將無法使用通常的方式來進行上述操作。為此，我們讓主機與PLC之間通過Intenet完成通訊，PLC端需要安裝一只無線遠程模塊，主機使用虛擬串口通過Intenet對遠程模塊收發數據；而PLC則使用遠程模塊通過Intenet對主機收發數據。下圖為以上兩種情況的對比。
虛擬串口的運用領域十分廣泛，不僅僅局限于PLC遠程通信，也可以用在運行狀態監控、故障分析處理、程序升級等環境中，通過虛擬串口，所有這一切只需要在辦公室即可完成。?
數據上報 SoftRadio中發送數據 在SoftRadio中，可以直接發送AT命令模擬設備上報數據，具體操作如下： Step 1 在“設備管理”頁面，單擊按鈕進入“信令跟蹤”頁面。 Step 2 在“發送AT命令”后的文本框中輸入“AT+NMGS=5,00012E1F63”，點擊“發送”按鈕。
發送成功后，可以在“信令跟蹤”窗口看到設備、SoftRadio與OceanConnect平臺之間的信令交互過程。?
如果編解碼插件中寫了OceanConnect平臺對上報數據的應答，則數據發送成功后會自動獲取到應答數據（如截圖中的“Payload：01”）。 上報數據的AT命令為：AT+NMGS=5,00012E1F63。具體解析如下： 1. AT+NMGS=N,XXXXXXXXXX未上報數據的AT命令格式，其中“N”表示一共上報幾個字節，后面為具體的上報字節內容，以十六進制字符串表示。這些需要提前在編解碼插件中寫好。 2. 本例中，一共上報5個字節，分別為“00”、“01”、“2E”、“1F”、“63”。其中，第一個字節“00”表示上報數據，第二個字節“01”表示上報數據對應的serviceId為Humidity（濕度），第三個字節“2E”表示HumidityCur（當前濕度），第四個字節“1F”表示HumidityMinToday（當天濕度最小值），第五個字節“63”表示HumidityMaxToday（當天濕度較大值）。這些內容與profile文件和編解碼插件是一一對應的。
Step 1 登錄OceanConnect平臺，點擊“我的設備”進入設備列表頁，根據deviceId選擇對應注冊的在線設備，單擊進入。 Step 2 在設備詳情頁，選擇”歷史數據”項，即可看到已經上報且被解析后的json數據。 在實際應用中，數據到達OceanConnect平臺后，可以通過兩種方式在北向應用服務器中接收數據： 1. 調用數據查詢類接口，查詢OceanConnect平臺中緩存的數據。 2. 調用訂閱接口，設置好推送地址，數據到達OceanConnect平臺后會按照既定的IP地址主動將數據推送至北向應用服務器。 命令下發 GUI Demo中下發命令 Step 1 登錄GUI Demo。? Step 2 在“Module Choose”選項框中，“Solution”選擇“NB-IoT”，“Module”選擇“Command Manager”。 在“Post Asyne Command”選項框中，輸入deviceId，單擊“Get Command”按鈕，獲取該deviceId對應設備所具備的服務和命令。?
說明：這些服務和命令是在profile中定義好的。
Step 3 設置具體參數，選擇需要下發的服務和命令后，單擊“Post Command“。各參數含義及設置方法如下：
Service：設備提供的服務ID，只能從下拉框中選擇。以“Temperature“為例。
Command：該服務所具備的命令，只能從下拉框中選擇。選定后會出現該命令可選的參數名（如Period或Value）。以“HIGH_TEMPERATURE_WARNING“為例，參數選擇”Value”。
Value：參數名對應的參數值。以設置“50“為例。
Expire Time：命令的超期時間，單位為秒。如果在設置時間內，命令還緩存在平臺沒有下發就會超期作廢。以設置“200“為例。
OceanConnect平臺中查看命令狀態
Step 1 登錄OceanConnect平臺，在設備詳情頁的“歷史命令“項中，可以看到剛下發的命令處于“等待”狀態。此時需要上報一條數據模擬激活設備，命令才能下發。?
Step 2 在SoftRadio中上報一條數據：AT+NMGS=5,00012E1F63。此時刷新歷史命令，可以看到命令狀態切換為“已送達”，表明命令已下發。?
在SoftRadio中同時能看到命令下發經編解碼插件編碼后的碼流（如截圖中的“Payload：0001013200”）。?
著手開發在利用Demo熟悉數據上報和命令下發流程，并理解業務后，可以著手進行自身業務的開發和集成。 主要需要開發的四大組件包括：profile，編解碼插件，南向設備，北向應用。具體開發方法和參考文檔、Demo請查閱：http://developer.huawei.com/ict/forum/thread-19827.html 在Demo體驗或實際開發過程中，遇到任何技術問題，建議通過以下兩種途徑尋求幫忙，都會有專業的華為技術人員幫您解答。 1. 在論壇發帖提問。 2. 至https://devcenter.huawei.com提單跟蹤。profilehttp://developer.huawei.com/ict/cn/doc/iot_devg_profile/index.html/zh-cn_topic_0036541424 設備的Profile文件是用來描述一款設備是什么、能做什么以及如何控制該設備的文件。該文件會被上傳到華為IoT平臺。
1. 設備能力 (Device Capability)： 描述一款設備的能力特征，包括設備類型、廠商、型號、協議類型名稱以及提供的服務類型。 如上圖：彩燈的制造廠商：aeotec（制造商ID為0086），型號(0203-0062), 協議類型(z-wave) 其服務包括：開關(Swtich), 亮度(Brigthness), 顏色(Color)，其中亮度為主服務(Master), 開關為必選服務(Mondatory)，顏色為可選服務(Optional). 設備能力描述json文件固定命名devicetype-capability.json， { "devices": [ { "manufacturerId": "eSDK", "manufacturerName": "eSDK_Huawei", "model": "v01", "protocolType": "CoAP", "deviceType": "MultiSensor", "serviceTypeCapabilities": [ { "serviceId": "Humidity", "serviceType": "Humidity", "option": "Master" }, { "serviceId": "Temperature", "serviceType": "Temperature", "option": "Master" }, { "serviceId": "Battery", "serviceType": "Battery", "option": "Master" } ] } ] } 2. 服務(Service)： 設備具有的某項服務（也可以理解為物理設備的功能模塊或者虛擬設備提供的服務，如一個系統提供的天氣預報服務），包括命令和屬性。 如上圖： 彩燈（Light Bulb）有三個服務（service），開關（Switch），亮度（Brightness），顏色（Color）； 插座（Socket）有一個服務，開關（Switch）； 其中，開關服務有SWITCH ON，OFF命令，有當前開關狀態status (ON, OFF)等。 服務能力描述json文件固定命名servicetype-capability.json； { "services": [ { "serviceType":"Temperature", "description": "Temperature", "commands": [ { "commandName": "SET_REPORT_PERIOD_TEMPERATURE", "paras": [ { "paraName": "Period", "dataType": "int", "required": true, "min": 0, "max": 200, "step": 1, "maxLength": 10, "unit": null, "enumList": null } ], "responses": [ { "responseName": "SET_REPORT_PERIOD_TEMPERATURE_RSP", "paras": [ { "paraName": "result", "dataType": "int", "required": true, "min": -1000000, "max": 1000000, "step": 1, "maxLength": 10, "unit": null, "enumList": null } ] } ] }, { "commandName": "HIGH_TEMPERATURE_WARNING", "paras": [ { "paraName": "Value", "dataType": "int", "required": true, "min": 0, "max": 200, "step": 1, "maxLength": 10, "unit": null, "enumList": null } ], "responses": [ { "responseName": "HIGH_TEMPERATURE_WARNING_RSP", "paras": [ { "paraName": "result", "dataType": "int", "required": true, "min": -1000000, "max": 1000000, "step": 1, "maxLength": 10, "unit": null, "enumList": null } ] } ] } ], "properties":[ { "propertyName": "TemperatureCur", "dataType": "int", "required":true, "min":0, "max":100, "step":1, "maxLength":null, "method":"R", "unit":"%", "enumList":null }, { "propertyName": "TemperatureMaxToday", "dataType": "int", "required":true, "min":0, "max":100, "step":1, "maxLength":null, "method":"R", "unit":"%", "enumList":null }, { "propertyName": "TemperatureMinToday", "dataType": "int", "required":true, "min":0, "max":100, "step":1, "maxLength":null, "method":"R", "unit":"%", "enumList":null } ] } ] } 注意：在一些profile樣例中您可能遇到命名為devicetype-display.json或servicetype-display.json的文件，這些文件是用于智慧家庭領域的一些場景中的，如果華為人員與您交流方案的時候沒有涉及到，您的profile中可以不包含這些文件。 編解碼插件 南向設備 北向應用
下一篇： {華為物聯網}華為物聯網開發能力
18922156670
