批量升級提交後,物聯網平台根據您的設定向裝置推送升級通知,您可在物聯網平台控制台查看目標裝置的升級狀態、升級包資訊等。
前提條件
已向裝置提交升級任務。具體操作,請參見發起升級批次任務。操作步驟
登入物聯網平台控制台。
在執行個體概覽頁簽的全部環境下,找到對應的執行個體,單擊執行個體卡片。
- 在左側導覽列,選擇 。說明 為提供更好的服務,物聯網平台改版了原OTA升級,新增了升級包版本統計功能。首次進入改版後的OTA升級頁面時,您需要手動將之前上傳的升級包與產品進行關聯。升級包與產品一一對應,一個升級包只能關聯一個產品。詳情請參見控制台指引。
- 在升級包列表中,單擊目標升級包對應的查看,單擊以下頁簽:
- 批次管理
- 查看升級批次類型:驗證升級包、批量升級。
- 單擊升級批次對應的查看,在批次詳情頁的裝置列表頁簽下,查看該升級批次下不同升級狀態的裝置列表。
狀態 說明 待確認 還未在手機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。