nl :: Dệt :: Hồ sơ :: Cập nhật phần mềm:: ImageQueryResponse
#include <src/lib/profiles/software-update/SoftwareUpdateProfile.h>
Một lớp để hỗ trợ tạo và giải mã các thông báo phản hồi truy vấn hình ảnh.
Tóm lược
Thông báo phản hồi truy vấn hình ảnh có dạng:
Chiều dài | Tên trường |
Biến đổi | URI |
Biến đổi | Đặc tả phiên bản |
Biến đổi | Đặc điểm kỹ thuật toàn vẹn |
1 byte | Cập nhật chương trình |
1 byte | Cập nhật các tùy chọn |
Bit | Ý nghĩa |
0..2 | Cập nhật mức độ ưu tiên |
3..4 | Cập nhật tình trạng |
5 | Báo cáo tình trạng. Khi được đặt, ứng dụng khách được yêu cầu tạo các thông báo DownloadNotify và UpdateNotify tùy chọn. |
5..7 | Kín đáo |
Người xây dựng và Người phá hủy | |
---|---|
ImageQueryResponse () Hàm tạo mặc định cho ImageQueryResponse . |
Thuộc tính công cộng | |
---|---|
integritySpec | Một trường chứa thông tin toàn vẹn (kiểu toàn vẹn và mã băm) cho hình ảnh cập nhật phần mềm. |
reportStatus | bool Yêu cầu thông báo cho máy chủ về tiến độ cập nhật phần mềm thông qua các thông báo DownloadNotify và UpdateNotify tùy chọn. |
updateCondition | Hướng dẫn về các điều kiện để tiến hành cập nhật phần mềm. |
updatePriority | Hướng dẫn chỉ dẫn thiết bị khi nào thực hiện cập nhật phần mềm. |
updateScheme | uint8_t Lược đồ cập nhật sẽ được sử dụng để tải xuống hình ảnh cập nhật phần mềm. |
uri | Chuỗi UTF-8 có độ dài thay đổi chứa vị trí của hình ảnh phần mềm. |
versionSpec | Chuỗi UTF-8 có độ dài thay đổi chứa nhận dạng phiên bản phần mềm dành riêng cho nhà cung cấp. |
Chức năng công cộng | |
---|---|
init ( ReferencedString &, ReferencedString &, IntegritySpec &, uint8_t, UpdatePriority , UpdateCondition , bool) | Khởi tạo rõ ràng đối tượng ImageQueryResponse với các giá trị được cung cấp. |
operator== (const ImageQueryResponse &) const | bool Một toán tử bình đẳng. |
pack (PacketBuffer *) | Tuần tự ImageQueryResponse vào PacketBuffer được cung cấp. |
print (void) | void |
Chức năng tĩnh công khai | |
---|---|
parse (PacketBuffer *, ImageQueryResponse &) | Hủy chuẩn hóa thông báo phản hồi truy vấn hình ảnh được cung cấp trong Bộ đệm gói thành một ImageQueryResponse được cung cấp. |
Thuộc tính công cộng
toàn vẹnSpec
IntegritySpec integritySpec
Một trường chứa thông tin toàn vẹn (kiểu toàn vẹn và mã băm) cho hình ảnh cập nhật phần mềm.
báo cáo tình trạng
bool reportStatus
Yêu cầu thông báo cho máy chủ về tiến độ cập nhật phần mềm thông qua các thông báo DownloadNotify và UpdateNotify tùy chọn.
updateCondition
UpdateCondition updateCondition
Hướng dẫn về các điều kiện để tiến hành cập nhật phần mềm.
updateScheme
uint8_t updateScheme
Lược đồ cập nhật sẽ được sử dụng để tải xuống hình ảnh cập nhật phần mềm.
Giá trị của nó được rút ra từ UpdateSchemes .
đi tiểu
ReferencedString uri
Chuỗi UTF-8 có độ dài thay đổi chứa vị trí của hình ảnh phần mềm.
Nội dung của chuỗi này phải tuân theo đặc điểm kỹ thuật RFC 3986. Đối với các lược đồ cập nhật tương ứng với Giao thức Internet được xác định rõ ràng (HTTP, HTTPS, SFTP), phần tử lược đồ của URI PHẢI tuân theo mã hóa URL chuẩn cho lược đồ giao thức đó. Độ dài chuỗi không được vượt quá 65565 và chuỗi phải vừa với một thông báo Weave, có thể phải tuân theo các giới hạn của MTU.
versionSpec
ReferencedString versionSpec
Chuỗi UTF-8 có độ dài thay đổi chứa nhận dạng phiên bản phần mềm dành riêng cho nhà cung cấp.
Độ dài chuỗi không được vượt quá 256 byte.
Chức năng công cộng
ImageQueryResponse
ImageQueryResponse()
Hàm tạo mặc định cho ImageQueryResponse .
ImageQueryResponse có thể được điền bằng phương thức init () hoặc bằng cách giải mã hóa đối tượng từ một thông báo.
trong đó
WEAVE_ERROR init( ReferencedString &, ReferencedString &, IntegritySpec &, uint8_t, UpdatePriority, UpdateCondition, bool )
Khởi tạo rõ ràng đối tượng ImageQueryResponse với các giá trị được cung cấp.
Chi tiết | |||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Thông số |
| ||||||||||||||
Lợi nhuận | WEAVE_NO_ERROR Vô điều kiện. |
toán tử ==
bool operator==( const ImageQueryResponse & ) const
Một toán tử bình đẳng.
Chi tiết | |||
---|---|---|---|
Thông số |
| ||
Lợi nhuận | true nếu tất cả các trường trong cả hai đối tượng đều bằng nhau, ngược lại là false |
đóng gói
WEAVE_ERROR pack( PacketBuffer * )
Nối tiếp ImageQueryResponse vào PacketBuffer được cung cấp.
Chi tiết | |||||
---|---|---|---|---|---|
Thông số |
| ||||
Giá trị trả lại |
|
in
void print( void )
Chức năng tĩnh công khai
phân tích cú pháp
WEAVE_ERROR parse( PacketBuffer *, ImageQueryResponse & )
Hủy chuẩn hóa thông báo phản hồi truy vấn hình ảnh được cung cấp trong Bộ đệm gói thành một ImageQueryResponse được cung cấp.
Chi tiết | |||||
---|---|---|---|---|---|
Thông số |
| ||||
Lợi nhuận | WEAVE_NO_ERROR Về thành công | ||||
Lợi nhuận | WEAVE_ERROR_BUFFER_TOO_SMALL Nếu thư quá nhỏ để chứa tất cả các trường của ImageQuery | ||||
Lợi nhuận | WEAVE_ERROR_INVALID_INTEGRITY_TYPE Nếu loại toàn vẹn được cung cấp không phải là một trong những giá trị được chỉ định trong IntegrityTypes |