Hình ảnh cập nhật chương trình cơ sở qua mạng (OTA) phải tuân thủ định dạng tệp Matter OTA Hình ảnh phần mềm, bao gồm:
- Giá trị nhận dạng tệp giúp xác định duy nhất tệp đó là tệp Matter cập nhật chương trình cơ sở
- Kích thước của tệp
- Kích thước tiêu đề
- Tiêu đề được mã hoá theo định dạng Tag-length-value (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
- Tải trọng
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.
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 bộ 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:
Mở dự án, sau đó mở thiết bị.
Chuyển đến Matter > OTA.
Nhấp vào Manage OTA (Quản lý OTA) bên cạnh thiết bị trong danh sách Integrations (Tích hợp).
Trên thẻ Manage (Quản lý), hãy nhấp vào Add OTA Image (Thêm hình ảnh OTA).
Nhấp vào Upload (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 Upload.
Hình ảnh OTA sẽ có thể phân phối ngay sau khi bạn tải lên.
Thêm hoặc sửa đổi nội dung mô tả hình ảnh OTA
Chuyển đến Matter > OTA.
Trên thẻ Manage (Quản lý), hãy nhấp vào Open (Mở) bên cạnh hình ảnh bạn muốn sửa đổi.
Trong hộp thoại OTA image details (Thông tin chi tiết về hình ảnh OTA), bạn có thể thay đổi nội dung mô tả hình ảnh.
Nhấp vào Cancel (Huỷ) hoặc Save (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:
Chuyển đến Matter > OTA.
Trên thẻ Manage, hãy nhấp vào trình đơn "khác" bên cạnh hình ảnh OTA rồi chọn Delete.