準備 OTA 映像檔

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

  • 可明確識別為 Matter 韌體更新檔案的檔案 ID
  • 檔案的大小。
  • 標題大小
  • 包含更新相關資訊的標記長度/值 (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

前往 Play 管理中心

  1. 依序前往「案件」>「OTA」

  2. 在 [裝置] 清單中,按一下裝置旁的 [管理]。

  3. 在「OTA Configuration」頁面中,點選「Images」分頁標籤。

  4. 按一下「新增圖片」

Matter OTA 圖片上傳對話方塊

  1. 為映像檔命名,然後按一下「Attach Image」,即可選取並上傳圖片檔。

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

  3. 出現確認對話方塊時,按一下「Save」(儲存) 即可在裝置上使用圖片,或按一下「Cancel」(取消) 取消提交。

OTA 圖片可在上傳後立即發布。