Trang này được dịch bởi Cloud Translation API.

nl::Weave::Hồ sơ::Cập nhật phần mềm

Vùng chứa tên này bao gồm tất cả giao diện trong Weave cho hồ sơ Cập nhật phần mềm Weave, bao gồm giao thức tương ứng có cùng tên.

Tóm tắt

Bảng liệt kê
`@309{ kMsgType_ImageAnnounce = 0, kMsgType_ImageQuery = 1, kMsgType_ImageQueryResponse = 2, kMsgType_DownloadNotify = 3, kMsgType_NotifyResponse = 4, kMsgType_UpdateNotify = 5, kMsgType_ImageQueryStatus = 6 }`	enum SoftwareUpdate Các loại thông báo.
`@310{ kStatus_NoUpdateAvailable = 0x0001, kStatus_UpdateFailed = 0x0010, kStatus_InvalidInstructions = 0x0050, kStatus_DownloadFailed = 0x0051, kStatus_IntegrityCheckFailed = 0x0052, kStatus_Abort = 0x0053, kStatus_Retry = 0x0091 }`	enum
`@311{ kFlag_PackageSpecPresent = 1, kFlag_LocaleSpecPresent = 2, kFlag_TargetNodeIdPresent = 4 }`	enum Cờ kiểm soát cho trường kiểm soát của khung ImageQuery.
`@312`	enum Yêu cầu cho trường các tùy chọn cập nhật không bắt buộc của ImageQueryResponse.
`@313`	enum Shift bù trừ cho trường tùy chọn cập nhật của ImageQueryResponse.
`@314{ kIntegrityType_SHA160 = 0, kIntegrityType_SHA256 = 1, kIntegrityType_SHA512 = 2, kIntegrityType_Last = 3 }`	enum
`@315`	enum Độ dài, tính bằng byte, cho chuỗi byte của đặc tả tính toàn vẹn.
`@316{ kUpdateScheme_HTTP = 0, kUpdateScheme_HTTPS = 1, kUpdateScheme_SFTP = 2, kUpdateScheme_BDX = 3, kUpdateScheme_Last = 4 }`	enum
`@317`	enum Thẻ Phần tử dữ liệu cho Cấu hình SoftwareUpdate.
`UpdateCondition{ IfUnmatched, IfLater, Unconditionally, OnOptIn }`	enum Các điều kiện điều chỉnh chính sách cập nhật.
`UpdatePriority{ Normal, Critical }`	enum Cập nhật mức độ ưu tiên.

Hàm
`integrityLength(uint8_t aType)`	`int` Một phương thức hỗ trợ liên kết các giá trị IntegrityTypes vào độ dài của các hàm băm thuộc loại đó.

Lớp
nl::Weave::Profiles::SoftwareUpdate::IWeaveImageAnnounceServerDelegate	Giao diện của đại biểu WeaveImageNotificationsServer.
nl::Weave::Profiles::SoftwareUpdate::ImageAnnounce	Lớp học mô tả thông báo ImageAnnounce.
nl::Weave::Profiles::SoftwareUpdate::ImageQuery	Một lớp hỗ trợ việc tạo và giải mã thông báo truy vấn hình ảnh.
nl::Weave::Profiles::SoftwareUpdate::ImageQueryResponse	Một lớp hỗ trợ việc tạo và giải mã thông báo phản hồi truy vấn hình ảnh.
nl::Weave::Hồ sơ::SoftwareUpdate::IntegritySpec	Một lớp phụ lưu giữ loại tính toàn vẹn và hàm băm thực tế của hình ảnh cập nhật phần mềm.
nl::Weave::Profiles::SoftwareUpdate::IntegrityTypeList	Một lớp phụ lưu giữ danh sách các loại toàn vẹn trong truy vấn hình ảnh.
nl::Weave::Hồ sơ::SoftwareUpdate::ProductSpec	Lớp phụ trợ cho một quy cách sản phẩm.
nl::Weave::Profiles::SoftwareUpdate::UpdateSchemeList	Một lớp bổ sung để lưu giữ danh sách các lược đồ cập nhật như một phần của truy vấn hình ảnh.
nl::Weave::Profiles::SoftwareUpdate::WeaveImageAnnounceServer	Máy chủ lắng nghe thông báo về hình ảnh Weave.

Bảng liệt kê

@309

 @309

SoftwareUpdate Các loại thông báo.

Thuộc tính
`kMsgType_DownloadNotify`	Một thông báo tùy chọn từ máy khách đến máy chủ được dùng để thông báo cho máy chủ về trạng thái tải xuống. Phần tải dữ liệu này là một nl::Weave::Profiles::StatusReport::StatusReport có thông tin trạng thái bổ sung được lấy từ SoftwareUpdateStatusCodes.
`kMsgType_ImageAnnounce`	Sự lộn xộn không mong muốn là sự cố do máy chủ sử dụng để thông báo về khả năng cung cấp bản cập nhật phần mềm. Thư không có trọng tải.
`kMsgType_ImageQuery`	Thông báo truy vấn do ứng dụng gửi đến máy chủ. Định dạng của lớp đó được xác định bằng lớp ImageQuery.
`kMsgType_ImageQueryResponse`	Thông báo được tạo để phản hồi một thông báo truy vấn hình ảnh thành công. Định dạng của lớp do lớp ImageQueryResponse xác định.
`kMsgType_ImageQueryStatus`	Thông báo được tạo để phản hồi thông báo truy vấn hình ảnh không thành công. Phần tải dữ liệu này là một nl::Weave::Profiles::StatusReport::StatusReport có thông tin trạng thái bổ sung được lấy từ SoftwareUpdateStatusCodes.
`kMsgType_NotifyResponse`	Một thông báo được tạo để phản hồi thông báo tải xuống thông báo. Phần tải dữ liệu này là một nl::Weave::Profiles::StatusReport::StatusReport có thông tin trạng thái bổ sung được lấy từ SoftwareUpdateStatusCodes.
`kMsgType_UpdateNotify`	Một thông báo tùy chọn từ ứng dụng đến máy chủ được dùng để thông báo trạng thái cuối cùng của bản cập nhật. Phần tải dữ liệu này là một nl::Weave::Profiles::StatusReport::StatusReport có thông tin trạng thái bổ sung được lấy từ SoftwareUpdateStatusCodes. Vì thông báo dự kiến sẽ được tạo sau khi cập nhật thực tế, nên thông báo sẽ được gửi trên ExchangeContext mới và được coi là thông báo không mong muốn trên máy chủ.

@310

 @310

SoftwareUpdate mã trạng thái dành riêng cho hồ sơ.

Thuộc tính
`kStatus_Abort`	máy chủ => client, cho biết rằng máy chủ cần phải từ bỏ vì máy chủ không có tùy chọn.
`kStatus_DownloadFailed`	client => server, cho biết rằng không thể tải xuống được.
`kStatus_IntegrityCheckFailed`	client => server, cho biết hình ảnh đã được tải xuống nhưng không thể kiểm tra tính toàn vẹn sau đó.
`kStatus_InvalidInstructions`	client => server cho biết ứng dụng không thể tải hình ảnh xuống vì hướng dẫn tải xuống có trong ImageQueryResponse, tức là URI, lược đồ cập nhật, điều kiện cập nhật, có định dạng kém hoặc không nhất quán.
`kStatus_NoUpdateAvailable`	máy chủ => client, cho biết rằng đã nhận và hiểu được một truy vấn hình ảnh và máy chủ không có bản cập nhật cho ứng dụng này vào lúc này.
`kStatus_Retry`	máy chủ => client, cho biết ứng dụng phải gửi truy vấn hình ảnh khác và khởi động lại/tiếp tục quá trình cập nhật
`kStatus_UpdateFailed`	client => server, cho biết rằng không cố gắng cài đặt hình ảnh do máy chủ chỉ định.

@311

 @311

Cờ kiểm soát cho trường kiểm soát của khung ImageQuery.

Thuộc tính
`kFlag_LocaleSpecPresent`	Có thông số Locale trong ImageQuery.
`kFlag_PackageSpecPresent`	Thông số kỹ thuật về gói có trong ImageQuery.
`kFlag_TargetNodeIdPresent`	Mã nút mục tiêu hiển thị trong ImageQuery.

@312

 @312

Yêu cầu cho trường các tùy chọn cập nhật không bắt buộc của ImageQueryResponse.

@313

 @313

Shift bù trừ cho trường tùy chọn cập nhật của ImageQueryResponse.

@314

 @314

Các loại tính toàn vẹn được hỗ trợ trong cấu hình SoftwareUpdate.

Khung truy vấn hình ảnh chứa thông tin về quá trình kiểm tra tính toàn vẹn mà ứng dụng hỗ trợ và phản hồi truy vấn hình ảnh chứa loại tính toàn vẹn và giá trị cho hình ảnh mà ứng dụng đang được hướng dẫn tải xuống và cài đặt. Các loại kết quả được hỗ trợ là:

Thuộc tính
`kIntegrityType_Last`	Số phần tử hợp lệ trong bảng liệt kê.
`kIntegrityType_SHA160`	Hàm băm 160 bit an toàn (SHA-1), bắt buộc.
`kIntegrityType_SHA256`	Hàm băm bảo mật 256 bit (SHA-2).
`kIntegrityType_SHA512`	512 bit, Hàm băm bảo mật (SHA-2).

@315

 @315

Độ dài, tính bằng byte, cho chuỗi byte của đặc tả tính toàn vẹn.

@316

 @316

Lược đồ cập nhật được cấu hình SofwareUpdate hỗ trợ.

Tương tự như các loại tính toàn vẹn được hỗ trợ, truy vấn hình ảnh chứa thông tin về các lược đồ cập nhật, tức là giao thức tải xuống, ứng dụng được hỗ trợ và phản hồi chứa giá trị để cho biết lược đồ cập nhật dùng để tải hình ảnh xuống. Lược đồ được hỗ trợ là:

Thuộc tính
`kUpdateScheme_BDX`	Chuyển dữ liệu Weave sẽ được sử dụng làm giao thức tải xuống.
`kUpdateScheme_HTTP`	HTTP sẽ được sử dụng làm giao thức tải xuống.
`kUpdateScheme_HTTPS`	HTTPS sẽ được sử dụng làm giao thức tải xuống.
`kUpdateScheme_Last`	Số phần tử hợp lệ trong bảng liệt kê.
`kUpdateScheme_SFTP`	SFTP sẽ được sử dụng làm giao thức tải xuống.

@317

 @317

Thẻ Phần tử dữ liệu cho Cấu hình SoftwareUpdate.

UpdateCondition

 UpdateCondition

Các điều kiện điều chỉnh chính sách cập nhật.

Thuộc tính
`IfLater`	Tải xuống và cài đặt hình ảnh nếu bản đặc tả phiên bản trong khung phản hồi mới hơn phiên bản phần mềm hiện đã cài đặt.
`IfUnmatched`	Tải xuống và cài đặt hình ảnh nếu bản đặc tả phiên bản trong khung phản hồi không khớp với phiên bản phần mềm hiện được cài đặt.
`OnOptIn`	tải xuống và cài đặt hình ảnh trên một số trình kích hoạt do người dùng trên trang web cung cấp.
`Unconditionally`	Tải xuống và cài đặt hình ảnh bất kể phiên bản phần mềm hiện đang chạy.

Mức độ ưu tiên của bản cập nhật

 UpdatePriority

Cập nhật mức độ ưu tiên.

Thuộc tính
`Critical`	Quá trình cập nhật phải được thực thi ngay lập tức.
`Normal`	Quá trình cập nhật có thể được thực hiện theo quyết định của khách hàng.

Hàm

tính toàn vẹn

int integrityLength(
  uint8_t aType
)

Một phương thức hỗ trợ liên kết các giá trị IntegrityTypes vào độ dài của các hàm băm thuộc loại đó.

Thông tin chi tiết

Các thông số

[in] aType

Giá trị IntegrityTypes

Trả về

Độ dài của hàm băm của loại hàm băm được cung cấp.

nl::Weave::Hồ sơ::Cập nhật phần mềm

Tóm tắt

Bảng liệt kê

Hàm

Lớp

Bảng liệt kê

@309

@310

@311

@312

@313

@314

@315

@316

@317

UpdateCondition

Mức độ ưu tiên của bản cập nhật

Hàm

tính toàn vẹn