準備 OTA 映像檔

OTA 韌體更新映像檔必須符合 Matter OTA 軟體映像檔格式,包括:

  • 檔案 ID,用於識別檔案是否為 Matter 韌體更新檔案
  • 檔案大小
  • 標頭大小
  • 標記長度值 (TLV) 編碼的標頭,其中包含更新資訊,包括:
    • VID
    • PID
    • 軟體版本
  • 酬載

Matter SDK 提供工具,可用來建立及檢查 Matter OTA 映像檔 (ota_image_tool.py)。部分建構系統可自動建立 Matter OTA 映像檔,因此請查看 SoC 說明文件。

建立 OTA 映像檔

使用 ota_image_tool.py 建立圖片:

$ ./ota_image_tool.py create \
  -v hexVendorId \
  -p hexProductId \
  -vn versionNumber \
  -vs "versionString" \
  -da "hash-function \
  path_to_binary \
  path_to_ota_file

如要驗證中繼資料集和檔案標頭,請使用 show 指令執行指令碼:

$ ./ota_image_tool.py show path_to_ota_file

輸出內容範例:

Magic: 1beef11e
Total Size: 90
Header Size: 62
Header TLV:
  [0] Vendor Id: XXXX (0xXX)
  [1] Product Id: XXX (0xXX)
  [2] Version: 101 (0x65)
  [3] Version String: 1.0.1
  [4] Payload Size: 12 (0xc)
  [8] Digest Type: 1 (0x1)
  [9] Digest: a948904f2f0f429b8f8197694b30184b0d2ed1c3cd2a1ec0fb85d299a193a447

上傳 OTA 映像檔

如何將圖片上傳至 Google Home Developer Console

前往開發人員控制台

  1. 依序前往「Matter」>「OTA」

  2. 在「裝置」清單中,按一下裝置旁邊的「管理」

  3. 在「OTA 設定」頁面中,按一下「圖片」分頁標籤。

  4. 按一下「New Image」

Matter OTA 圖片上傳對話方塊

  1. 為圖片命名,然後按一下「附加圖片」,選取並上傳圖片檔案。

  2. 圖片驗證成功後,請按一下「儲存」

  3. 確認對話方塊出現時,請按一下「儲存」,讓裝置可使用圖片,或按一下「取消」取消提交。

OTA 映像檔會在上傳後不久提供供發布。