若升級包中升級包是否需要平台驗證選擇了是,則在批量升級前,需使用測試裝置對升級包進行驗證。只有測試裝置全部升級成功後,升級包才可用於裝置OTA升級。本文介紹如何在物聯網平台控制台驗證升級包。
前提條件
已建立需要驗證的升級包。具體操作,請參見添加升級包。操作步驟
登入物聯網平台控制台。
在執行個體概覽頁簽的全部環境下,找到對應的執行個體,單擊執行個體卡片。
- 在左側導覽列,選擇 。說明 為提供更好的服務,物聯網平台改版了原OTA升級,新增了升級包版本統計功能。首次進入改版後的OTA升級頁面時,您需要手動將之前上傳的升級包與產品進行關聯。升級包與產品一一對應,一個升級包只能關聯一個產品。詳情請參見控制台指引。
- 在升級包列表中,單擊升級包對應的驗證,配置參數後,單擊確認,在一個或多個裝置上進行升級包驗證。
參數 描述 待升級版本號碼 - 整包升級時,該參數為非必選配置。
下拉式清單中,展示當前產品下所有裝置的除升級目標版本號碼外的其他版本號碼,您可以選擇一個或者多個待升級的版本。選擇後,相應的裝置將作為待驗證裝置列表中的備選裝置。
如不選擇,表示對備選待驗證裝置的OTA模組目前的版本不做限制。
- 差分升級時,該參數預設為已在添加升級包時配置的待升級版本號碼。
待驗證裝置 選擇用於此次測試的裝置。 雲端主動推送升級包 選擇物聯網平台是否主動向裝置推送升級任務。 - 是(預設):批次任務建立完成後,物聯網平台主動將OTA升級任務,直接推送給升級範圍內的線上裝置。
此模式下,裝置仍可主動向物聯網平台發起請求,來擷取OTA升級任務資訊。
- 否:裝置必須通過向物聯網平台發起請求,來擷取OTA升級任務資訊。
App確認升級 如需自主控制裝置OTA升級時,可以配置此參數,通過手機App來控制,裝置是否可進行OTA升級。手機App需您自行開發。 - 是:裝置無法擷取OTA升級任務,需App側確認裝置可進行OTA升級(即通過ConfirmOTATask介面,批量確認待確認狀態的裝置升級作業)後,才能按照雲端主動推送升級包設定,擷取OTA升級任務資訊。
- 否(預設):直接按照雲端主動推送升級包設定,擷取OTA升級任務資訊。
升級包下載協議 可選協議:HTTPS或MQTT。裝置端收到物聯網平台推送的升級包下載資訊後,通過此處設定的協議下載升級包。 重要 使用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。