全部產品
Search

搜尋本產品

    ：SDK擷取

    文件中心

    ：SDK擷取

    更新時間：Jun 30, 2024

    C語言Link SDK適用於使用C語言開發業務處理邏輯的裝置，由於C語言運行速度快、需要的運行記憶體較少，目前大多數的IoT裝置使用C語言進行產品開發。

    SDK擷取

    SDK 3.X

    當前最新版本：v3.2.0，您可以通過歷史版本清單下載SDK。

    說明

    • 使用v3.0.1和v3.1.0開發產品的客戶，如果用不到新增功能可不用升級SDK。

    • 使用者如果正在使用SDK2.3.0開發產品，並且想升級到SDK3.0.1，可以查看版本變動記錄 。

    SDK使用說明

    SDK提供了API供裝置廠商調用，用於實現與阿里雲IoT平台通訊以及一些其它的協助工具功能，例如WiFi配網、本地控制等。

    另外，C語言版本的SDK被設計為可以在不同的作業系統上運行，例如Linux、FreeRTOS、Windows，因此SDK需要OS或者硬體支援的操作被定義為一些HAL函數，裝置廠商在使用SDK開發產品時需要將這些HAL函數進行實現。

    產品的商務邏輯、SDK、HAL的關係如下圖所示：image

    其中產品商務邏輯和HAL需要裝置廠商實現，SDK的目錄wrappers\os下提供了針對Linux、FreeRTOS的部分HAL參考實現供參考。

    對於初次接觸阿里雲IoT的使用者，請單擊快速體驗瞭解如何在Ubuntu上將一個類比裝置接入阿里雲IoT，從而理解一些基本的概念。

    SDK功能列表

    下面的表格列出了目前最新版本C Link SDK的功能：

    功能模組

    功能點

    裝置連雲

    • MQTT連雲，裝置可通過MQTT與阿里雲IoT物聯網平台通訊

    • CoAP連雲，裝置可通過CoAP與阿里雲IoT物聯網平台通訊，用於裝置主動上報資訊的情境

    • HTTPS連雲，裝置可通過HTTPS與阿里雲IoT物聯網平台通訊，用於裝置主動上報資訊的情境

    裝置身份認證

    • 一機一密

    • 一型一密

    物模型

    使用屬性、服務、事件對裝置進行描述以及實現，包括：

    • 屬性上報、設定

    • 服務調用

    • 事件上報

    雲端region設定

    • 廠商指定region，告知裝置串連到阿里雲的具體的雲端網站，例如中國上海、新加坡、美國、法國

    • 動態連雲，裝置自動連接到距離裝置延時最短的雲端網站

    OTA

    裝置韌體升級

    遠程配置

    裝置設定檔擷取

    子裝置管理

    用於讓網關裝置添加、刪除子裝置，以及對子裝置進行控制

    WiFi配網

    將WiFi熱點的SSID/密碼傳輸給WiFi裝置，包括：

    • 一鍵配網

    • 手機熱點配網

    • 裝置熱點配網

    • 零配

    裝置本地控制

    區域網路內，通過CoAP協議對裝置進行控制，包括：ALCS Server，被控端實現ALCS Client，控制端實現，通常被希望通過本地控制裝置的網關使用。

    裝置綁定支援

    裝置綁定token維護，裝置通過WiFI、乙太網路接入，並且通過阿里雲開放智能生活平台管理時使用。

    裝置影子

    在雲端存放裝置指定資訊供APP查詢，避免總是從裝置擷取資訊引入的延時。

    Reset支援

    當裝置執行Factory Reset時，通知雲端清除記錄。例如清除裝置與使用者的綁定關係，清除網關與子裝置的關聯關係等。

    時間擷取

    從阿里雲物聯網平台擷取當前的時間。

    檔案上傳

    通過HTTP方式上傳檔案。

    歷史版本清單

    版本號碼

    發布日期

    下載方式

    更新內容

    3.2.0

    2020/03/03

    git clone https://github.com/aliyun/iotkit-embedded.git -b v3.2.0

    • OTA支援軟體模組升級

    • TLS支援SNI

    • 提供裝置影子的API

    3.1.0

    2019/10/18

    git clone https://github.com/aliyun/iotkit-embedded.git -b v3.1.0

    • 對關鍵過程增加狀態代碼機制

    • WiFi配網增強，解決AP Isolation、移除路由器配網方案、新增Linux平台的配網HAL函數參考代碼

    • 增加對X.509的支援

    • OTA新增斷點續傳

    • 子裝置管理新增子裝置/網關多對多拓撲關係

    • 系統topic訂閱最佳化，縮短訂閱時間

    3.0.1

    2019/03/15

    git clone https://github.com/aliyun/iotkit-embedded.git -b v3.0.1

    • 新增對非同步/通知式的底層TCP/IP協議棧的支援

    • 支援將選中功能對應的代碼抽取出來，方便快速將SDK放入客戶的編譯環境進行編譯

    • 代碼抽取時自動產生客戶HAL適配檔案

    • 新增http2檔案上傳功能

    • 配網增加裝置熱度配網方案

    2.3.0

    2018/11/19

    git clone https://github.com/aliyun/iotkit-embedded.git -b v2.3.0

    • 新增一套物模型編程介面：風格為IOT_Linkkit_XXX(), 舊版介面linkkit_xxx()仍然保留

    • 新增圖形化配置方式支援

    • WiFi配網的四種模式可以分離

    2.2.1

    2018/09/03

    git clone https://github.com/aliyun/iotkit-embedded.git -b v2.2.1

    • 新增一型一密/動態註冊功能

    • 新增OTA使用iTLS下載韌體功能

    • WiFi配網功能開源發布

    • 本地控制功能開源發布

    2.2.0

    2018/08/06

    git clone https://github.com/aliyun/iotkit-embedded.git-b v2.2.0

    • 離線reset支援

    • 簡化版TSL支援

    • 裝置禁用/使能支援

    • TSL數組支援object類型

    • MQTT海外多網站串連支援

    • itls支援

    2.1.0

    2018/03/20

    git clone https://github.com/aliyun/iotkit-embedded.git -b RELEASED_V2_1_20180320

    • 新增cmake編譯系統

    • 增加物模型支援

    2.0.3

    2018/01/31

    git clone https://github.com/aliyun/iotkit-embedded.git -b RELEASED_V2.03

    • 子裝置管理支援

    • 最佳化tls，修複記憶體泄露

    • 升級MQTT通道，支援更長的topic、支援更多的訂閱請求、MQTT支援多線程

    2.0.2

    2017/11/30

    git clone https://github.com/aliyun/iotkit-embedded.git -b RELEASED_V2_02_20171130

    • 新增mbedtls支援，目前適配Linux和Windows系統

    • 最佳化HTTP介面，支援發送報文時不斷開TLS串連

    • 新增OpenSSL適配

    • 支援用mingw32編譯Win7的庫和常式

    • make reconfig可彈出和選擇已適配平台

    2.0.1

    2017/10/10

    git clone https://github.com/aliyun/iotkit-embedded.git -b RELEASED_V2_01_20171010

    • 新增基於CoAP通知方式的OTA

    • 增加HTTP+TLS的雲端串連通道

    • 細化OTA狀態

    • 修正SDK在armcc編譯器編譯時間出現的報錯

    2.0.0

    2017/08/21

    git clone https://github.com/aliyun/iotkit-embedded.git -b RELEASED_V2_00_20170818

    • 新增MQTT直連

    • 新增CoAP通道

    • 增加OTA功能

    • 升級構建系統