OTA 固件更新映像必须符合 Matter OTA 软件映像文件格式,其中包括:
- 文件标识符,用于唯一标识文件为 Matter 固件更新文件
- 文件的大小
- 标题大小
- 标记-长度-值 (TLV) 编码的标头,其中包含有关更新的信息,包括:
- VID
- PID
- 软件版本
- 载荷
Matter SDK 提供了用于创建和检查 Matter OTA 映像 (ota_image_tool.py
) 的工具。某些 build 系统可以自动创建 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 配置页面中,点击 Images(映像)标签页。
点击新建映像。
为图片命名,然后点击附加图片以选择并上传图片文件。
图片成功验证后,点击保存。
当确认对话框出现时,点击保存以将图片提供给您的设备,或点击取消以取消提交。
OTA 映像在上传后不久即可分发。