摘要：本文主要介紹基於OpenHarmony 3.0版本來對接華為雲IoT設備接入IoTDA，以小熊派BearPi-HM_Nano開發板為例，使用huaweicloud_iot_link SDK對接華為雲物聯網平臺的簡單流程。 本文分享自華為雲社區《OpenHarmony3.0如何輕鬆連接華為雲Io ...
摘要：本文主要介紹基於OpenHarmony 3.0版本來對接華為雲IoT設備接入IoTDA，以小熊派BearPi-HM_Nano開發板為例，使用huaweicloud_iot_link SDK對接華為雲物聯網平臺的簡單流程。
本文分享自華為雲社區《OpenHarmony3.0如何輕鬆連接華為雲IoT設備接入平臺》，作者：華為IoT雲服務 。
萬物互聯的全場景、全智能時代，使得人均持有設備量不斷攀升，設備和場景的多樣性，使應用開發變得更加複雜、應用入口更加豐富。當下依托OpenHarmony框架，搭建萬物智聯底座，重構物聯網格局，是當下熱門的物聯網開發方式之一，那OpenHarmony3.0如何連接an class="nolink">華為雲IoT設備接入平臺呢？註意事項又有哪些呢？
本文主要介紹基於OpenHarmony 3.0版本來對接華為雲IoT設備接入IoTDA，以小熊派BearPi-HM_Nano開發板為例，使用huaweicloud_iot_link SDK對接華為雲物聯網平臺的簡單流程。
前提條件
- 已註冊華為雲官方帳號。未註冊可單擊註冊頁面完成註冊。
- 已完成實名制認證。未完成可在華為雲上單擊實名認證完成認證，否則無法使用設備接入功能。
- 已開通設備接入服務。未開通則訪問設備接入服務，單擊“管理控制台”後開通該服務。
硬體環境準備
BearPi-HM_Nano開發板、Type-C數據線、PC。
軟體環境準備
參考鏈接單擊這裡。
圖1 軟體環境創建步驟
說明：
（1）如使用DevEco Device Tool參與調試的需要安裝Windows環境。
（2）獲取源碼：如果不使用Docker方式，強烈建議採用獲取方式一。
（3）在安裝開發板中的環境的安裝gcc_riscv32步驟時，強烈建議直接下載gcc_riscv32鏡像，否則可能出現某些插件下載或安裝失敗，具體操作如下圖2所示。
須知：
開源代碼量較大，下載時間可能較長，需預留好充足時間。
圖2 直接下載gcc_riscv32鏡像
一、創建產品
1.登錄管理控制台，單擊左側導航欄“產品”，單擊頁面右上角的“創建產品”。
2.根據頁面提示填寫參數，然後單擊“確認”，完成產品的創建。
圖3 創建產品
二、開發產品模型
- 找到新增的產品，單擊“產品”進入產品界面。
- 在產品詳情“模型定義”頁面，直接上傳模型文件BearPi_Agriculture.zip。
說明：
在產品列表中，單擊對應的產品，進入產品詳情頁。您可以查看產品ID、產品名稱、設備類型、數據格式、廠商名稱、所屬資源空間、協議類型等產品基本信息。其中產品ID（product Id）是物聯網平臺自動生成的，其餘信息均是由用戶創建產品時自定義。
產品創建成功後，您可以單擊“刪除”刪除不再使用的產品。刪除產品後，該產品下的產品模型、編解碼插件等資源將被清空，請謹慎操作。
三、註冊設備
- 訪問設備接入服務，單擊“管理控制台”進入設備接入控制台。
- 在左側導航欄選擇“ 設備 > 所有設備”，單擊右上角“註冊設備”，按照如下表格填寫參數後，單擊“確定”。
圖4 註冊單個設備
圖5 獲取設備密鑰
說明：
設備註冊成功後，請妥善保管好設備ID和密鑰，用於設備接入平臺認證。
若密鑰丟失，只能通過重置密鑰生成新的密鑰，無法找回註冊設備時生成的密鑰。
用戶可在設備列表刪除不再使用的設備。刪除設備不支持撤回，請謹慎操作。
四、Huaweicloud_iotlink SDK使用
- 下載源碼：oh3.0_hwcloud_iotlink-master.zip。
- 將上述源碼直接拷貝到OpenHarmony源碼的third-party文件目錄下，此處需要註意的是OpenHarmony和Huaweicloud_iotlink SDK共同具備的三方庫直接使用OpenHarmony的庫文件，如CJSON和mbedtls。
- 在OpenHarmony 3.0源碼device\bearpi\bearpi_hm_nano\app\BUILD.gn中添加如下代碼，根據#是否註釋來決定具體編譯demo的選擇。
# "//third_party/hwcloud_iotlink/demos/test_iotlink:test_iotlink", "//third_party/hwcloud_iotlink/demos/mqtt_tiny_v5_agriculture_demo:mqtt_tiny_v5_agriculture_demo",
圖6 demo的選擇
步驟說明：
- 圖6中1為單元測試代碼，可以根據修改test_main.c文件中最後一行代碼中，APP_FEATURE_INIT()中的入口函數，來進行不同的測試用例的執行，分別測試OSAL層不同的組件適配，包括任務、互斥鎖、信號量、隊列、以及SDK本身隊列等一系列驗證，部分內容可以對比BearPi-HM_Nano開發板的官方樣例代碼進行對比驗證程式結果的正確性，具體如圖7。
- 圖6中2為使用MQTT對接華為雲的demo，看一下該demo的BUILD.gn文件，具體如圖8所示，其中A區域包含開發板硬體和wifi相關的庫文件，B區域包括MQTT對接華為雲必須的一些庫文件，如cJson，mqtt相關、osal相關以及配置庫文件，C區域表示編譯該文件時需要編譯hwcloud_iotlink庫，編譯是會按照指定路徑找到該文件所必要的庫以及C文件進行編譯。
圖7 單元測試
圖8 代碼編譯文件
圖9 demo的主函數文件
步驟說明：
圖9中A區域表示MQTT對接華為雲所必須的一些庫文件以及dtls的庫文件，入口函數IoTMainTaskEntry()中務必先調用link_main_task_entry()函數，來確保osal的安裝以及其他配置的初始化。
- 設置參數。
圖10 參數修改
註意：
如果需要對接上雲需要根據自己的設備修改配網信息，wifi熱點賬號以及密碼以及自己在雲端註冊的設備ID和設備秘鑰，設備僅支持2.4G頻段的wifi。
五、設備接入平臺
代碼燒錄到設備後重啟設備（首次使用需重啟兩次，第一次燒錄時可能需要配置一下內部信息），第二次設備重啟之後可以正常對接華為雲。
登錄平臺可以看見數據上報的具體信息，也可以進行命令下發等操作控制設備，具體如下圖11-13。
圖11 數據上報
圖12 命令下發
圖13 日誌信息
總結：
傳統的終端操作系統主要是面向單端，基於 OpenHarmony 開源項目開發的系統似乎天生是面向萬物互聯的，可以運行在大大小小的各種智能終端上。熟悉使用OpenHarmony和華為雲IoT平臺結合是物聯網開發者的必經之路。
