物聯網裝置進行OTA升級,需先在阿里雲物聯網平台為對應產品添加升級包。本文介紹添加升級包的具體操作步驟。
前提條件
裝置端已支援OTA升級功能。具體內容,請參見裝置端Link SDK的OTA升級。
若添加包含多個檔案的OTA升級包,裝置端必須支援使用多個升級包檔案發起的升級任務,進行OTA升級。具體內容,請參見多個檔案的OTA升級。
目前,僅C語言的裝置端Link SDK支援開發多個檔案的OTA升級功能。
背景資訊
操作步驟
登入物聯網平台控制台。
在執行個體概覽頁簽的全部環境下,找到對應的執行個體,單擊執行個體卡片。
在左側導覽列,選擇 。
說明為提供更好的服務,物聯網平台改版了原OTA升級,新增了升級包版本統計功能。首次進入改版後的OTA升級頁面時,您需要手動將之前上傳的升級包與產品進行關聯。升級包與產品一一對應,一個升級包只能關聯一個產品。詳情請參見控制台指引。
(可選)若您的裝置搭載了AliOS Things晶片,可以開啟安全升級功能。
安全升級是保證升級包完整性、機密性的一種方式,建議開啟。使用安全升級功能,裝置端需配合對升級包和升級包的簽名進行驗證。具體操作,請參見AliOS Things技術文檔。
在OTA升級頁面,單擊安全升級。
在對話方塊中,設定待升級產品對應的安全升級按鈕為開。
當安全升級功能為開時,可單擊對應的複製按鈕,複製公開金鑰,用於裝置端驗證簽名。
(可選)自訂OTA模組。
OTA模組是同產品下裝置的不同可升級模組,例如韌體、軟體、驅動等。預設(default)模組表示整個裝置的韌體,支援自訂其他OTA模組。
在模組列表頁簽,單擊添加模組,配置模組資訊,單擊確認。
參數
說明
所屬產品
選擇模組所屬產品。
模組名稱
設定模組名稱。模組名稱需要在產品下唯一,建立後不可修改。支援英文字母、數字、半形句號(.)、短劃線(-)和底線(_),長度限制為1~64個字元。
模組別名
設定模組別名。支援英文字母、數字、半形句號(.)、短劃線(-)和底線(_),長度限制為4~64個字元。
模組描述
可描述該模組的用途等資訊。描述長度不超過100個字元,一個中文計為一個字元。
在OTA升級頁面,單擊升級包列表頁簽,單擊添加升級包。
配置升級包資訊,上傳升級包檔案,單擊確認。
參數
描述
升級包類型
整包:您上傳的升級包檔案是完整的升級包檔案,會推送整包升級包給裝置進行升級。
差分:您上傳的升級包檔案僅包含新版本升級包與之前版本的差異部分,僅推送差異部分至裝置,裝置進行差分還原,還原為完整升級包。差分升級可有效減少升級對裝置資源的佔用,和減少下發升級包的流量消耗。
升級包名稱
設定升級包名稱,需在阿里雲帳號下唯一,建立後不可修改。支援中文、英文字母、日文、數字、短劃線(-)、底線(_)和半形圓括弧(()),必須以中文、英文、日文或數字開頭,長度限制為1~40個字元。
添加升級包成功後,可在升級包詳情頁面的升級包資訊頁簽,單擊編輯,修改升級包名稱。
所屬產品
選擇升級包所屬產品。
升級包模組
選擇升級包所屬OTA模組。
您可以單擊添加模組,在彈出的對話方塊中新增一個模組。
升級包版本號碼
設定該升級包的版本號碼。版本號碼支援英文字母、數字、半形句號(.)、短劃線(-)和底線(_),長度限制為1~64個字元。
升級包類型選擇為整包時,需設定的參數。
待升級版本號碼
輸入或選擇待升級裝置的OTA模組版本號碼。下拉式清單中,會展示當前產品下所有裝置的OTA模組版本號碼,選擇一個待升級的版本。
升級包類型選擇為差分時,需設定的參數。
升級後版本號碼
設定該升級包的版本號碼。
升級包類型選擇為差分時,需設定的參數。
簽名演算法
支援MD5和SHA256演算法。
當裝置使用阿里雲提供的Android SDK,且升級包類型選擇為差分時,請選擇MD5演算法。
上傳升級包
上傳升級包檔案。最多支援上傳20個檔案,總檔案大小不能超過1,000 MB。檔案格式。
上傳多個升級包檔案時,需注意:
檔案名稱不能重複,單個檔案名稱長度不能超過32個字元。
物聯網平台會校正多個檔案的簽名是否一致,若檔案簽名一致,則視其為重複的檔案。
升級包是否需要平台驗證
選擇是否在批量升級前,使用少量測試裝置對升級包進行驗證。
是:必須進行驗證,驗證通過後,才能進行批量升級。
否:無需驗證,直接進行批量升級。
升級包描述
可描述該升級包的功能等資訊。描述長度不超過1024個字元,一個中文計為一個字元。
添加升級包成功後,可在升級包詳情頁面的升級包資訊頁簽,單擊編輯,修改升級包描述。
推送給裝置的自訂資訊
添加該升級包完成,並建立升級任務後,物聯網平台向裝置推送升級通知時,會下發該自訂資訊給裝置。
自訂資訊的長度不超過4096個字元,內容和格式沒有限制。
添加升級包成功後,可在升級包詳情頁面的升級包資訊頁簽,單擊編輯,修改推送給裝置的自訂資訊。
執行結果
升級包添加完成後,可在升級包列表查看,如圖所示。
後續操作
若升級包中升級包是否需要平台驗證選擇了是,需先驗證升級包。具體操作,請參見(可選)驗證升級包。
否則,可直接向裝置發起批量升級。具體操作,請參見發起升級批次任務。
可選:刪除升級包
OTA升級包被刪除後,升級包對應的檔案立即無法下載,會導致相關業務中斷。請謹慎操作。
在升級包列表頁簽,單擊升級包對應操作列的刪除。
單擊確認。
相關API
API | 描述 |
產生升級包檔案上傳到OSS的URL及詳細資料。 | |
添加升級包。 | |
建立產品的OTA模組。 | |
修改OTA模組別名、描述。 | |
刪除自訂OTA模組。 | |
查詢產品下的OTA模組列表。 | |
刪除指定升級包。 | |
查詢升級包列表。 |
OTA相關API的更多資訊,請參見OTA升級API。