全部產品
Search
文件中心

IoT Platform:(可選)驗證升級包

更新時間:Jun 30, 2024

若升級包中升級包是否需要平台驗證選擇了,則在批量升級前,需使用測試裝置對升級包進行驗證。只有測試裝置全部升級成功後,升級包才可用於裝置OTA升級。本文介紹如何在物聯網平台控制台驗證升級包。

前提條件

已建立需要驗證的升級包。具體操作,請參見添加升級包

操作步驟

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

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

  3. 在左側導覽列,選擇監控營運 > OTA升級
    說明 為提供更好的服務,物聯網平台改版了原OTA升級,新增了升級包版本統計功能。首次進入改版後的OTA升級頁面時,您需要手動將之前上傳的升級包與產品進行關聯。升級包與產品一一對應,一個升級包只能關聯一個產品。詳情請參見控制台指引。
  4. 在升級包列表中,單擊升級包對應的驗證,配置參數後,單擊確認,在一個或多個裝置上進行升級包驗證。
    參數描述
    待升級版本號碼
    • 整包升級時,該參數為非必選配置。

      下拉式清單中,展示當前產品下所有裝置的除升級目標版本號碼外的其他版本號碼,您可以選擇一個或者多個待升級的版本。選擇後,相應的裝置將作為待驗證裝置列表中的備選裝置。

      如不選擇,表示對備選待驗證裝置的OTA模組目前的版本不做限制。

    • 差分升級時,該參數預設為已在添加升級包時配置的待升級版本號碼。
    待驗證裝置選擇用於此次測試的裝置。
    雲端主動推送升級包選擇物聯網平台是否主動向裝置推送升級任務。
    • (預設):批次任務建立完成後,物聯網平台主動將OTA升級任務,直接推送給升級範圍內的線上裝置。

      此模式下,裝置仍可主動向物聯網平台發起請求,來擷取OTA升級任務資訊。

    • :裝置必須通過向物聯網平台發起請求,來擷取OTA升級任務資訊。
    App確認升級如需自主控制裝置OTA升級時,可以配置此參數,通過手機App來控制,裝置是否可進行OTA升級。手機App需您自行開發。
    • :裝置無法擷取OTA升級任務,需App側確認裝置可進行OTA升級(即通過ConfirmOTATask介面,批量確認待確認狀態的裝置升級作業)後,才能按照雲端主動推送升級包設定,擷取OTA升級任務資訊。
    • (預設):直接按照雲端主動推送升級包設定,擷取OTA升級任務資訊。
    升級包下載協議可選協議:HTTPSMQTT。裝置端收到物聯網平台推送的升級包下載資訊後,通過此處設定的協議下載升級包。
    重要 使用MQTT協議下載升級包,必須符合以下條件:
    • 支援的地區:僅中國的華東2(上海)、華北2(北京)和華南1(深圳)。
    • OTA升級包:僅包含一個檔案,且檔案大小不超過16 MB。
    • 裝置端SDK:必須使用物聯網平台提供的C語言Link SDK最新版本的軟體包,開發OTA升級和MQTT下載檔案的能力。詳細內容,請參見使用MQTT協議下載升級包的OTA升級程式碼範例
    裝置升級逾時時間設定單個裝置的升級逾時時間,即多長時間後,裝置升級未完成則為逾時。可選值範圍:1分鐘~1,440分鐘。

    升級包第一次發起OTA升級時,建議將該參數設定為最大值,以提高裝置升級成功率。控制台會根據升級記錄,推薦逾時時間長度。

    說明
    • 從裝置第一次上報升級進度開始計算升級時間。

      升級期間若裝置多次上下線,觸發雲端多次推送升級包,都始終以裝置最開始的第一次上報升級進度時間作為開始時間。

    • 裝置升級成功後,請第一時間上報升級成功後的目標版本,避免因升級逾時,導致升級失敗。

    例如,將該參數設定為60分鐘,裝置10:00第一次上報升級進度,11:00之前若未上報升級成功後的目標版本,則升級失敗(逾時)。

    批次標籤

    單擊新增標籤,在顯示的輸入框中,輸入標籤的標籤Key標籤Value

    升級批次任務建立完成後,如果升級批次狀態為升級中,支援修改和新增標籤。具體操作,請參見批次管理

    批次標籤將在向裝置推送升級通知時下發給裝置。

    標籤配置規則,可單擊協助表徵圖協助查看。

執行結果

頁面彈出驗證升級包對話方塊,單擊關閉

升級包列表頁簽,找到狀態為驗證中升級包,單擊對應的查看按鈕。單擊升級包資訊頁簽,可查看驗證進度

驗證進度

後續操作

測試裝置全部升級成功後,升級包狀態顯示為已驗證,才能進行下一步批量升級。具體操作,請參見發起升級批次任務

相關API

API描述
CreateOTAVerifyJob建立升級包驗證批次。
QueryOTAFirmware查詢指定升級包的詳細資料。

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