Chuẩn bị hình ảnh OTA

Hình ảnh cập nhật chương trình cơ sở qua OTA phải tuân thủ định dạng tệp Hình ảnh phần mềm OTA Matter, bao gồm:

  • Giá trị nhận dạng tệp giúp xác định duy nhất tệp đó là tệp bản cập nhật chương trình cơ sở của Matter
  • Kích thước tệp
  • Kích thước tiêu đề
  • Tiêu đề được mã hoá theo giá trị độ dài thẻ (TLV) chứa thông tin về bản cập nhật, bao gồm:
    • VID
    • PID
    • phiên bản phần mềm
  • Phần dữ liệu thực tế

SDK Matter cung cấp một công cụ để tạo và kiểm tra hình ảnh OTA Matter (ota_image_tool.py). Một số hệ thống xây dựng có thể tự động tạo hình ảnh OTA Matter, vì vậy, hãy kiểm tra tài liệu về SoC của bạn.

Tạo hình ảnh OTA

Sử dụng ota_image_tool.py để tạo hình ảnh:

$ ./ota_image_tool.py create \
  -v hexVendorId \
  -p hexProductId \
  -vn versionNumber \
  -vs "versionString" \
  -da "hash-function \
  path_to_binary \
  path_to_ota_file

Để xác minh tập hợp siêu dữ liệu và tiêu đề của tệp, hãy chạy tập lệnh bằng lệnh show:

$ ./ota_image_tool.py show path_to_ota_file

Ví dụ về đầu ra:

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

Tải hình ảnh OTA lên

Cách tải hình ảnh lên Google Home Developer Console:

Chuyển đến Developer Console

  1. Mở dự án, sau đó mở thiết bị.

  2. Chuyển đến Matter > OTA.

  3. Nhấp vào Quản lý OTA bên cạnh thiết bị trong danh sách Tích hợp.

  4. Trên thẻ Manage (Quản lý), hãy nhấp vào Add OTA Image (Thêm hình ảnh OTA).

Hộp thoại tải hình ảnh OTA của Matter lên

  1. Nhấp vào Tải lên để chọn và tải tệp hình ảnh lên.

    Sau khi hình ảnh được xác thực thành công, tên tệp của hình ảnh sẽ xuất hiện bên dưới nút Tải lên.

Hình ảnh OTA sẽ được phân phối ngay sau khi tải lên.

Thêm hoặc sửa đổi nội dung mô tả hình ảnh OTA

  1. Chuyển đến Matter > OTA.

  2. Trên thẻ Quản lý, hãy nhấp vào Mở bên cạnh hình ảnh bạn muốn sửa đổi.

  3. Trong hộp thoại OTA image details (Chi tiết hình ảnh OTA), bạn có thể thay đổi nội dung mô tả hình ảnh.

  4. Nhấp vào Huỷ hoặc Lưu.

Xoá hình ảnh OTA

Bạn không thể xoá hình ảnh OTA ở trạng thái Đã phát hành, bạn chỉ có thể xoá hình ảnh ở trạng thái Sẵn sàng. Cách xoá hình ảnh OTA ở trạng thái Sẵn sàng:

  1. Chuyển đến Matter > OTA.

  2. Trên thẻ Quản lý, hãy nhấp vào trình đơn "thêm" bên cạnh hình ảnh OTA rồi chọn Xoá.