阿里云提供的設備端C語言SDK可以直接運行于Linux系統,并通過MQTT協議接入物聯網平臺。本文以在Ubuntu x86_64系統上編譯設備端C語言SDK為例,介紹設備上云的配置和開發過程。

背景信息

有關設備端C語言SDK詳細信息,請參見概述

創建產品和設備

  1. 登錄物聯網平臺控制臺。
  2. 實例概覽頁面,找到對應的實例,單擊實例進入實例詳情頁面。
    重要 目前華東2(上海)、華北2(北京)、華南1(深圳)地域開通了企業版實例服務。其他地域,請跳過此步驟。
    實例概覽
  3. 在左側導航欄,選擇設備管理 > 產品,再單擊創建產品,創建一個產品。
    參數 說明
    產品名稱 自定義產品名稱。
    所屬品類 選擇自定義品類。
    節點類型 選擇直連設備。
    連網方式 選擇Wi-Fi。
    數據格式 選擇ICA標準數據格式(Alink JSON)。
    認證方式 選擇設備密鑰。
  4. 在左側導航欄,選擇設備,再單擊添加設備,在剛創建的產品下添加設備。
    設備創建成功后,獲取設備證書信息(ProductKey、DeviceName和DeviceSecret)。

定義產品物模型

物聯網平臺提供的設備端C SDK Demo包中,包含一個完整的物模型JSON文件。本示例中,導入該物模型文件,生成產品的物模型。

  1. 編輯物模型文件。
    1. 下載C SDK 3.2版本設備端SDK文件包。下載地址,請參見C SDK 3.2
    2. 解壓SDK壓縮包后,打開src/dev_model/examples目錄下的model_for_examples.json文件。
    3. 將物模型JSON文件中的productKey的值替換為您在物聯網平臺上創建產品的ProductKey值,然后保存文件。
      更改物模型中的productKey
  2. 在物聯網平臺控制臺對應實例產品頁,找到之前創建的產品,單擊對應的查看。
  3. 產品詳情頁面的功能定義頁簽下,單擊編輯草稿 > 快速導入。
  4. 在彈出的對話框中,選擇導入物模型,上傳已編輯好的物模型JSON文件,單擊確定。
    導入成功后,該文件定義的所有功能將顯示在自定義功能列表中。
  5. 單擊發布上線,將物模型發布為正式版。

配置SDK

將設備端SDK文件導入您的開發環境中,并修改配置文件中的信息為您的設備信息。

  1. 在SDK文件的wrappers/os/ubuntu目錄下HAL_OS_linux.c文件中,修改設備證書信息為您的設備證書信息。
    更改設備驗證信息
  2. 編譯SDK。在SDK根目錄中,執行make reconfig命令,選擇3,然后make。
    make reconfig
  3. 測試運行SDK。
    在SDK根目錄中,執行./output/release/bin/linkkit-example-solo命令。執行結果如下圖。運行C SDK
    SDK運行成功后,可在物聯網平臺控制臺對應實例下,進入設備對應的設備詳情頁面,查看設備狀態和設備上報的物模型數據。