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:
前往 Matter > OTA。
在「裝置」清單中,按一下裝置旁邊的「管理」。
在「OTA 設定」頁面中,按一下「圖片」分頁標籤。
按一下「New Image」。
為圖片命名,然後按一下「附加圖片」,選取並上傳圖片檔案。
圖片驗證成功後,請按一下「儲存」。
出現確認對話方塊時,按一下「Save」(儲存) 即可將映像檔提供給裝置,按一下「Cancel」則可取消提交。
上傳 OTA 映像檔後不久即可發布。