文章分享

開放、平等、協(xié)作、快速、分享

當(dāng)前位置:首頁>文章分享

SDK獲取及使用說明

摘錄:HCTech 無錫和控電子   時(shí)間:2020-08-07   訪問量:3826

點(diǎn)擊登錄控制臺(tái)打開SDK定制頁面,根據(jù)產(chǎn)品需要進(jìn)行相應(yīng)SDK功能選擇,點(diǎn)擊按鈕 “開始生成” 下載SDK,如下圖所示:文檔與工具說明 :

SDK功能列表

目前SDK支持的功能如下表所示:

功能模塊功能說明
MQTT連云設(shè)備可以通過MQTT連接阿里云物聯(lián)網(wǎng)平臺(tái),并使用MQTT Topic進(jìn)行設(shè)備與云端之間的數(shù)據(jù)收發(fā)
HTTP連云設(shè)備可以通過HTTP連接阿里云物聯(lián)網(wǎng)平臺(tái),并上傳設(shè)備數(shù)據(jù)。注意:本種協(xié)議連接方式不支持物聯(lián)網(wǎng)平臺(tái)主動(dòng)向設(shè)備發(fā)送數(shù)據(jù)。
設(shè)備認(rèn)證
  • 支持通過設(shè)備預(yù)置密鑰的方式對(duì)設(shè)備進(jìn)行認(rèn)證,并支持動(dòng)態(tài)注冊(cè)

  • 支持通過ID2對(duì)設(shè)備進(jìn)行認(rèn)證

  • 支持X.509對(duì)設(shè)備進(jìn)行認(rèn)證

OS適配

包含對(duì)以下OS的適配:

  1. Linux

  2. FreeRTOS

  3. POSIX機(jī)制兼容的OS

  4. FreeRTOS

若設(shè)備使用的OS不支持上述OS,開發(fā)者需要對(duì)OS進(jìn)行適配

物模型使用屬性、事件、服務(wù)來對(duì)設(shè)備進(jìn)行建模,云端APP開發(fā)時(shí)基于物模型對(duì)設(shè)備進(jìn)行管理,而無需關(guān)心設(shè)備與物聯(lián)網(wǎng)平臺(tái)之間的數(shù)據(jù)交互格式
OTA設(shè)備固件升級(jí)。 SDK只進(jìn)行固件的獲取,開發(fā)者需要實(shí)現(xiàn)將固件寫入Flash/ROM中讓固件生效
時(shí)間同步讓設(shè)備通過SDK獲取當(dāng)前物聯(lián)網(wǎng)平臺(tái)的時(shí)間
RRPC支持云端應(yīng)用對(duì)設(shè)備的遠(yuǎn)程同步調(diào)用
設(shè)備連接異常告警當(dāng)連接延時(shí)較大、或者丟包時(shí)進(jìn)行報(bào)警
日志上報(bào)提供日志實(shí)時(shí)上傳功能
設(shè)備引導(dǎo)服務(wù)設(shè)備啟動(dòng)時(shí)動(dòng)態(tài)決定連接服務(wù)站點(diǎn)的能力,設(shè)備全球化部署時(shí)使用

SDK編譯說明

SDK以源文件方式進(jìn)行輸出,客戶可以使用自己喜歡的方式編譯SDK,比如:
  • 客戶可以通過編寫makefile通過GNU Make來編譯代碼

  • 客戶也可以通過編寫cmake來編譯SDK

  • 對(duì)于集成IDE開發(fā)環(huán)境(比如Eclipse),客戶可以將SDK的代碼文件添加到IDE中進(jìn)行編譯

當(dāng)用戶從阿里云物聯(lián)網(wǎng)平臺(tái)下載SDK之后,SDK的目錄結(jié)構(gòu)如下所示:
$ ls -l total 20 -rwxrwxrwx 1 root root 1067  4月 26 14:14 ChangeLog.md drwxrwxrwx 1 root root 4096  4月 26 14:14 components drwxrwxrwx 1 root root 4096  4月 26 14:14 core drwxrwxrwx 1 root root 4096  4月 26 14:14 demos drwxrwxrwx 1 root root    0  4月 26 14:38 external -rwxrwxrwx 1 root root 1026  4月 26 14:14 Makefile drwxrwxrwx 1 root root    0  4月 26 14:14 portfiles
其中:
  • ChangeLog.md

    其中包含SDK中各個(gè)功能模塊的更新時(shí)間

  • components

    根據(jù)客戶的選擇,在該目錄下會(huì)出現(xiàn)各種子模塊的目錄

  • core

    SDK的核心代碼文件

  • demos

    存放各種功能的示例代碼

  • external

    當(dāng)需要使用TLS功能時(shí),SDK使用了第三方的mbedtls,客戶可以使用其它的TLS庫(kù)來替換mbedtls

  • portfiles

    SDK運(yùn)行時(shí)與TCP/IP協(xié)議棧、與TLS庫(kù)的集成實(shí)現(xiàn)

客戶在移植SDK的時(shí)候,demos目錄可以不用加入編譯系統(tǒng),將其它目錄下面的代碼文件加入編譯系統(tǒng)進(jìn)行編譯即可。

若SDK并未提供對(duì)指定系統(tǒng)下TCP/IP協(xié)議棧、TLS庫(kù)的移植,客戶需要自行實(shí)現(xiàn)portfiles下相關(guān)函數(shù)的移植。

SDK頭文件包含

用戶對(duì)SDK進(jìn)行初始化的可以參見LinkSDK/demos下面的示例文件,總的來說,用戶的程序首先需要包含頭文件:
#include "aiot_state_api.h" #include "aiot_sysdep_api.h"

然后再根據(jù)選擇的功能查看相應(yīng)模塊編程手冊(cè)中指定包含的頭文件即可。比如如果設(shè)備使用MQTT協(xié)議與物聯(lián)網(wǎng)平臺(tái)通信,那么可以打開文檔“MQTT接入與數(shù)據(jù)通信”,該文檔中會(huì)明確說明需要包含頭文件aiot_mqtt_api.h,用戶在程序中加入相應(yīng)的頭文件包含即可。


上一篇:Paho-MQTT C接入示例(阿里云)

下一篇:SSL與TLS有什么區(qū)別(最全面的知識(shí)點(diǎn)都在這)

在線咨詢

點(diǎn)擊這里給我發(fā)消息 售前咨詢專員

點(diǎn)擊這里給我發(fā)消息 售后服務(wù)專員

在線咨詢

免費(fèi)通話

24小時(shí)免費(fèi)咨詢

請(qǐng)輸入您的聯(lián)系電話,座機(jī)請(qǐng)加區(qū)號(hào)

免費(fèi)通話

微信掃一掃

微信聯(lián)系
返回頂部