全部產品
Search
文件中心

IoT Platform:查看升級情況

更新時間:Jun 30, 2024

批量升級提交後,物聯網平台根據您的設定向裝置推送升級通知,您可在物聯網平台控制台查看目標裝置的升級狀態、升級包資訊等。

前提條件

已向裝置提交升級任務。具體操作,請參見發起升級批次任務

操作步驟

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

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

  3. 在左側導覽列,選擇監控營運 > OTA升級
    說明 為提供更好的服務,物聯網平台改版了原OTA升級,新增了升級包版本統計功能。首次進入改版後的OTA升級頁面時,您需要手動將之前上傳的升級包與產品進行關聯。升級包與產品一一對應,一個升級包只能關聯一個產品。詳情請參見控制台指引。
  4. 在升級包列表中,單擊目標升級包對應的查看,單擊以下頁簽:
    • 批次管理
      • 查看升級批次類型:驗證升級包、批量升級。
      • 單擊升級批次對應的查看,在批次詳情頁的裝置列表頁簽下,查看該升級批次下不同升級狀態的裝置列表。
        狀態說明
        待確認還未在手機App確認,裝置可進行OTA升級。

        建立批次任務時,App確認升級選擇,升級任務才會進入該狀態。

        待推送還未向裝置推送OTA升級通知。

        待推送狀態原因有三種:裝置離線、定時推送或速率限制,狀態分別顯示為:

        • 待推送(裝置離線)
        • 待推送(定時:2020/XX/XX XX:XX:XX)
        • 待推送
        已推送已向裝置推送OTA升級通知,裝置尚未上報進度。
        升級中裝置已收到升級通知,並已上傳升級進度。
        升級成功裝置上報升級成功後的正確版本號碼。
        說明 裝置升級成功後,建議第一時間上報升級成功後的正確版本號碼,否則,可能會因為逾時,導致升級失敗。
        升級失敗以下原因可能造成裝置升級失敗。
        • 裝置未結束上一次升級任務,又發起新的批量升級,且選擇不覆蓋之前的升級任務,則後發起的升級任務會升級失敗。

          您可以:

          • 等裝置完成上一次升級後,再對裝置發起新的升級。
          • 在發起升級時,選擇覆蓋裝置之前的升級任務。
            說明 裝置處於升級中狀態的升級任務不會被覆蓋。
        • 裝置通過升級進度的Topic,向物聯網平台上報數值-1、-2、-3或-4,則認為升級失敗。數值含義如下:
          • -1:升級失敗。
          • -2:下載失敗。
          • -3:校正失敗。
          • -4:燒寫失敗。
        • 裝置升級時,從裝置第一次上報升級進度開始計算升級時間,在設定的逾時時間截止前,裝置沒有上報升級後的目標版本來完成升級,則認為升級失敗。
        • 裝置在升級中狀態下,上報了源版本和目標版本以外的版本資訊,則認為升級失敗。

        如果發起批量升級時,指定了待升級版本號碼,且選擇了升級失敗後重試,在以下情況下會進行自動重試升級。

        • 裝置在升級中狀態下,上報了源版本和目標版本以外的版本資訊導致的升級失敗。
        • 裝置通過上報升級進度的Topic,主動上報-1-2-3-4導致的升級失敗。

        自動重試時,裝置在物聯網平台的升級狀態顯示不變,即在已推送狀態下重試時,狀態仍然顯示為已推送;在升級中狀態下重試時,狀態仍然顯示為升級中

        說明

        物聯網平台不會觸發自動重試邏輯的情況:

        • 因升級逾時(失敗原因:timeout)而導致的升級失敗。
        • 您主動取消的升級。
        已取消已取消該裝置的升級。

        如果升級批次狀態為升級中,升級批次對應操作欄顯示編輯按鈕。您可單擊編輯,修改升級策略配置中的升級包推送速率(已配置的恒定速率值或可變速率值),或修改、新增標籤。配置說明,請參見發起升級批次任務

        您也可單擊批次資訊,查看該批次任務的基本資料。如下圖所示,如果升級批次狀態為升級中標籤資訊右側顯示編輯按鈕。您可單擊編輯,修改和新增標籤。

        編輯標籤
      • 單擊升級批次對應的取消
        • 對於靜態升級批次,預設取消批次以及批次下的所有升級任務(包括待確認、待推送、已推送、升級中4種狀態的任務)。
        • 對於動態升級批次,預設僅取消動態升級策略,可根據需要選擇是否取消所有進行中中的升級任務(包括待推送、已推送、升級中3種狀態的任務)。

        當裝置升級任務狀態是待確認待推送已推送時,支援批量取消對應狀態的全部升級任務。

    • 裝置列表

      查看升級包的目標裝置列表,包括裝置的升級狀態,以及升級成功、失敗和取消的統計。

      單擊目標裝置操作欄的查看,在批次詳情頁面,可單個或批量取消該裝置的升級任務。

    • 升級包資訊
      • 查看升級包的基本資料,例如升級包的ID、名稱、簽名、簽名演算法、版本號碼、狀態、模組等。
      • 單擊升級包簽名右側的下載,可擷取升級包檔案。

後續操作

查看升級包版本和成功率:裝置OTA升級任務完成後,可通過資料分析功能,查看升級包版本分布,及升級成功率統計,瞭解裝置OTA升級更多情況。

相關API

API描述
ListOTAJobByFirmware擷取升級包下的升級批次列表。
ListOTAJobByDevice擷取裝置所在的升級包升級批次列表。
ListOTATaskByJob查詢指定升級批次下的裝置升級作業列表。
QueryOTAJob查詢指定升級批次的詳情。

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