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:
依序前往「案件」>「OTA」。
在 [裝置] 清單中,按一下裝置旁的 [管理]。
在「OTA Configuration」頁面中,點選「Images」分頁標籤。
按一下「新增圖片」。
為映像檔命名,然後按一下「Attach Image」,即可選取並上傳圖片檔。
成功驗證圖片後,按一下「儲存」。
出現確認對話方塊時,按一下「Save」(儲存) 即可在裝置上使用圖片,或按一下「Cancel」(取消) 取消提交。
OTA 圖片可在上傳後立即發布。