全部產品
Search
文件中心

IoT Platform:添加升級包

更新時間:Jun 30, 2024

物聯網裝置進行OTA升級,需先在阿里雲物聯網平台為對應產品添加升級包。本文介紹添加升級包的具體操作步驟。

前提條件

裝置端已支援OTA升級功能。具體內容,請參見裝置端Link SDK的OTA升級

若添加包含多個檔案的OTA升級包,裝置端必須支援使用多個升級包檔案發起的升級任務,進行OTA升級。具體內容,請參見多個檔案的OTA升級

重要

目前,僅C語言的裝置端Link SDK支援開發多個檔案的OTA升級功能。

背景資訊

OTA升級的使用說明,請參見OTA升級概述。裝置端進行OTA升級的流程,請參見裝置端OTA升級

操作步驟

  1. 登入物聯網平台控制台

  2. 執行個體概覽頁簽的全部環境下,找到對應的執行個體,單擊執行個體卡片。

  3. 在左側導覽列,選擇監控營運 > OTA升級

    說明

    為提供更好的服務,物聯網平台改版了原OTA升級,新增了升級包版本統計功能。首次進入改版後的OTA升級頁面時,您需要手動將之前上傳的升級包與產品進行關聯。升級包與產品一一對應,一個升級包只能關聯一個產品。詳情請參見控制台指引。

  4. (可選)若您的裝置搭載了AliOS Things晶片,可以開啟安全升級功能。

    安全升級是保證升級包完整性、機密性的一種方式,建議開啟。使用安全升級功能,裝置端需配合對升級包和升級包的簽名進行驗證。具體操作,請參見AliOS Things技術文檔

    1. OTA升級頁面,單擊安全升級

    2. 在對話方塊中,設定待升級產品對應的安全升級按鈕為

      當安全升級功能為時,可單擊對應的複製按鈕,複製公開金鑰,用於裝置端驗證簽名。

  5. (可選)自訂OTA模組。

    OTA模組是同產品下裝置的不同可升級模組,例如韌體、軟體、驅動等。預設(default)模組表示整個裝置的韌體,支援自訂其他OTA模組。

    模組列表頁簽,單擊添加模組,配置模組資訊,單擊確認

    參數

    說明

    所屬產品

    選擇模組所屬產品。

    模組名稱

    設定模組名稱。模組名稱需要在產品下唯一,建立後不可修改。支援英文字母、數字、半形句號(.)、短劃線(-)和底線(_),長度限制為1~64個字元。

    模組別名

    設定模組別名。支援英文字母、數字、半形句號(.)、短劃線(-)和底線(_),長度限制為4~64個字元。

    模組描述

    可描述該模組的用途等資訊。描述長度不超過100個字元,一個中文計為一個字元。

  6. OTA升級頁面,單擊升級包列表頁簽,單擊添加升級包

  7. 配置升級包資訊,上傳升級包檔案,單擊確認

    參數

    描述

    升級包類型

    • 整包:您上傳的升級包檔案是完整的升級包檔案,會推送整包升級包給裝置進行升級。

    • 差分:您上傳的升級包檔案僅包含新版本升級包與之前版本的差異部分,僅推送差異部分至裝置,裝置進行差分還原,還原為完整升級包。差分升級可有效減少升級對裝置資源的佔用,和減少下發升級包的流量消耗。

    升級包名稱

    設定升級包名稱,需在阿里雲帳號下唯一,建立後不可修改。支援中文、英文字母、日文、數字、短劃線(-)、底線(_)和半形圓括弧(()),必須以中文、英文、日文或數字開頭,長度限制為1~40個字元。

    添加升級包成功後,可在升級包詳情頁面的升級包資訊頁簽,單擊編輯,修改升級包名稱

    所屬產品

    選擇升級包所屬產品。

    升級包模組

    選擇升級包所屬OTA模組。

    您可以單擊添加模組,在彈出的對話方塊中新增一個模組。

    升級包版本號碼

    設定該升級包的版本號碼。版本號碼支援英文字母、數字、半形句號(.)、短劃線(-)和底線(_),長度限制為1~64個字元。

    升級包類型選擇為整包時,需設定的參數。

    待升級版本號碼

    輸入或選擇待升級裝置的OTA模組版本號碼。下拉式清單中,會展示當前產品下所有裝置的OTA模組版本號碼,選擇一個待升級的版本。

    升級包類型選擇為差分時,需設定的參數。

    升級後版本號碼

    設定該升級包的版本號碼。

    升級包類型選擇為差分時,需設定的參數。

    簽名演算法

    支援MD5和SHA256演算法。

    當裝置使用阿里雲提供的Android SDK,且升級包類型選擇為差分時,請選擇MD5演算法。

    上傳升級包

    上傳升級包檔案。最多支援上傳20個檔案,總檔案大小不能超過1,000 MB。檔案格式

    上傳多個升級包檔案時,需注意:

    • 檔案名稱不能重複,單個檔案名稱長度不能超過32個字元。

    • 物聯網平台會校正多個檔案的簽名是否一致,若檔案簽名一致,則視其為重複的檔案。

    升級包是否需要平台驗證

    選擇是否在批量升級前,使用少量測試裝置對升級包進行驗證。

    • :必須進行驗證,驗證通過後,才能進行批量升級。

    • :無需驗證,直接進行批量升級。

    升級包描述

    可描述該升級包的功能等資訊。描述長度不超過1024個字元,一個中文計為一個字元。

    添加升級包成功後,可在升級包詳情頁面的升級包資訊頁簽,單擊編輯,修改升級包描述

    推送給裝置的自訂資訊

    添加該升級包完成,並建立升級任務後,物聯網平台向裝置推送升級通知時,會下發該自訂資訊給裝置。

    自訂資訊的長度不超過4096個字元,內容和格式沒有限制。

    添加升級包成功後,可在升級包詳情頁面的升級包資訊頁簽,單擊編輯,修改推送給裝置的自訂資訊

執行結果

升級包添加完成後,可在升級包列表查看,如圖所示。

升級包列表

後續操作

若升級包中升級包是否需要平台驗證選擇了,需先驗證升級包。具體操作,請參見(可選)驗證升級包

否則,可直接向裝置發起批量升級。具體操作,請參見發起升級批次任務

可選:刪除升級包

警告

OTA升級包被刪除後,升級包對應的檔案立即無法下載,會導致相關業務中斷。請謹慎操作。

  1. 升級包列表頁簽,單擊升級包對應操作列的刪除

  2. 單擊確認

相關API

API

描述

GenerateOTAUploadURL

產生升級包檔案上傳到OSS的URL及詳細資料。

CreateOTAFirmware

添加升級包。

CreateOTAModule

建立產品的OTA模組。

UpdateOTAModule

修改OTA模組別名、描述。

DeleteOTAModule

刪除自訂OTA模組。

ListOTAModuleByProduct

查詢產品下的OTA模組列表。

DeleteOTAFirmware

刪除指定升級包。

ListOTAFirmware

查詢升級包列表。

OTA相關API的更多資訊,請參見OTA升級API