准备 OTA 映像

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,请执行以下操作:

前往 Play 管理中心

  1. 依次前往 Matter > OTA

  2. 设备列表中,点击相应设备旁边的管理

  3. OTA 配置页面中,点击 Images(映像)标签页。

  4. 点击新建映像

Matter OTA 映像上传对话框

  1. 为图片命名,然后点击附加图片以选择并上传图片文件。

  2. 图片成功验证后,点击保存

  3. 出现确认对话框时,点击 Save 以将映像提供给您的设备,或点击 Cancel 取消提交。

OTA 映像在上传后不久即可分发。