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:
Mở dự án, sau đó mở thiết bị.
Chuyển đến Matter > OTA.
Nhấp vào Quản lý OTA bên cạnh thiết bị trong danh sách 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 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
Chuyển đến Matter > OTA.
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.
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.
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:
Chuyển đến Matter > OTA.
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á.