nl::Weave::Profiles::SoftwareUpdate

Không gian tên này bao gồm tất cả giao diện trong cấu hình Weave cho Weave Software Update, trong đó có giao thức tương ứng có cùng tên.

Tóm tắt

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
Loại thông báo SoftwareUpdate.
@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ờ điều khiển cho trường điều khiển của khung ImageQuery.
@312 enum
Bitmasks cho trường các tuỳ chọn cập nhật không bắt buộc của ImageQueryResponse.
@313 enum
Độ lệch dịch chuyển cho trường tuỳ chọn cập nhật không bắt buộc 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 các chuỗi byte thông số kỹ thuật về 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 Hồ sơ SoftwareUpdate.
UpdateCondition{
  IfUnmatched,
  IfLater,
  Unconditionally,
  OnOptIn
} 		enum
Các điều kiện chi phối chính sách cập nhật.
UpdatePriority{
  Normal,
  Critical
} 		enum
Cập nhật các ưu tiên.

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

Lớp
nl::Weave::Profiles::SoftwareUpdate::IWeaveImageAnnounceServerDelegate

Giao diện để uỷ quyền WeaveImageAnnounceServer.

nl::Weave::Profiles::SoftwareUpdate::ImageAnnounce

Lớp 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::Profiles::SoftwareUpdate::IntegritySpec

Một lớp phụ trợ lưu giữ loại tính toàn vẹn và hàm băm thực tế của hình ảnh bản cập nhật phần mềm.

nl::Weave::Profiles::SoftwareUpdate::IntegrityTypeList

Một lớp phụ trợ để lưu giữ danh sách các loại tính toàn vẹn trong truy vấn hình ảnh.

nl::Weave::Profiles::SoftwareUpdate::ProductSpec

Một lớp phụ trợ đại diện cho một quy cách sản phẩm.

nl::Weave::Profiles::SoftwareUpdate::UpdateSchemeList

Một lớp phụ trợ lưu giữ danh sách giao thức cập nhật trong truy vấn hình ảnh.

nl::Weave::Profiles::SoftwareUpdate::WeaveImageAnnounceServer

Máy chủ theo dõi thông báo về hình ảnh của Weave.

Liệt kê

@309

 @309

Loại thông báo SoftwareUpdate.

Thuộc tính
kMsgType_DownloadNotify

Một thông báo không bắt buộc từ ứng dụng đến máy chủ, dùng để thông báo cho máy chủ về trạng thái tải xuống.

Tải trọng của lớp này là nl::Weave::Profiles::StatusReporting::StatusReport với thông tin trạng thái bổ sung được rút ra từ SoftwareUpdateStatusCodes.

kMsgType_ImageAnnounce

Một tin nhắn không bắt buộc, được máy chủ sử dụng để thông báo về việc có bản cập nhật phần mềm.

Tin nhắn này không có trọng tải.

kMsgType_ImageQuery

Một thông báo truy vấn do máy khách gửi tới máy chủ.

Định dạng của thư viện này được xác định bằng lớp ImageQuery.

kMsgType_ImageQueryResponse

Một 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 này được xác định bằng lớp ImageQueryResponse.

kMsgType_ImageQueryStatus

Một thông báo được tạo để phản hồi một thông báo không truy vấn được hình ảnh.

Tải trọng của lớp này là nl::Weave::Profiles::StatusReporting::StatusReport với thông tin trạng thái bổ sung được rút ra từ SoftwareUpdateStatusCodes.

kMsgType_NotifyResponse

Một nội dung được tạo để phản hồi thông báo về nội dung tải xuống.

Tải trọng của lớp này là nl::Weave::Profiles::StatusReporting::StatusReport với thông tin trạng thái bổ sung được rút ra từ SoftwareUpdateStatusCodes.

kMsgType_UpdateNotify

Một thông báo không bắt buộc từ máy khách đến máy chủ, dùng để thông báo trạng thái cuối cùng của bản cập nhật.

Tải trọng của lớp này là nl::Weave::Profiles::StatusReporting::StatusReport với thông tin trạng thái bổ sung được rút ra 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 này được gửi trên một ExchangeContext mới và được coi là thông báo không mong muốn trên máy chủ.

@310

 @310

Mã trạng thái riêng của cấu hình SoftwareUpdate.

Thuộc tính
kStatus_Abort

máy chủ => máy khách, cho biết máy khách nên từ bỏ vì máy chủ không có lựa chọn.

kStatus_DownloadFailed

khách hàng => máy chủ, cho biết rằng không thể tải xuống được.

kStatus_IntegrityCheckFailed

khách hàng => máy chủ, cho biết rằng hình ảnh đã được tải xuống nhưng không vượt qua được quy trình kiểm tra tính toàn vẹn tiếp theo.

kStatus_InvalidInstructions

khách hàng => máy chủ, 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 không hợp lệ hoặc không nhất quán.

kStatus_NoUpdateAvailable

máy chủ => máy khách, cho biết rằng một truy vấn hình ảnh đã được nhận và hiểu, đồng thời máy chủ chưa có bản cập nhật nào cho máy khách tại thời điểm này.

kStatus_Retry

máy chủ => khách hàng, cho biết rằng ứng dụng cần gửi một 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

khách hàng => máy chủ, cho biết rằng nỗ lực cài đặt hình ảnh được máy chủ chỉ định đã không thành công.

@311

 @311

Cờ điều khiển cho trường điều khiển của khung ImageQuery.

Thuộc tính
kFlag_LocaleSpecPresent

Thông số kỹ thuật Locale (Ngôn ngữ) có trong ImageQuery.

kFlag_PackageSpecPresent

Thông số kỹ thuật của gói có trong ImageQuery.

kFlag_TargetNodeIdPresent

ID nút mục tiêu có trong ImageQuery.

@312

 @312

Bitmasks cho trường các tuỳ chọn cập nhật không bắt buộc của ImageQueryResponse.

@313

 @313

Độ lệch dịch chuyển cho trường tuỳ chọn cập nhật không bắt buộc của ImageQueryResponse.

@314

 @314

Các loại tính toàn vẹn được hồ sơ SoftwareUpdate hỗ trợ.

Khung truy vấn hình ảnh chứa thông tin về các loại tính năng kiểm tra tính toàn vẹn mà ứng dụng hỗ trợ, đồng thời phản hồi truy vấn hình ảnh chứa loại và giá trị về tính toàn vẹn 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 được hỗ trợ là:

Thuộc tính
kIntegrityType_Last

Số phần tử hợp lệ trong bản liệt kê.

kIntegrityType_SHA160

Hàm băm bảo mật 160 bit (SHA-1) là bắt buộc.

kIntegrityType_SHA256

Hàm băm bảo mật 256 bit (SHA-2).

kIntegrityType_SHA512

Hàm băm bảo mật (SHA-2) 512 bit.

@315

 @315

Độ dài (tính bằng byte) cho các chuỗi byte thông số kỹ thuật về tính toàn vẹn.

@316

 @316

Cập nhật các giao thức mà hồ sơ 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ề lược đồ cập nhật (tức là giao thức tải xuống, ứng dụng hỗ trợ) và phản hồi chứa giá trị để cho biết lược đồ cập nhật sẽ dùng khi tải hình ảnh xuống. Các lược đồ được hỗ trợ là:

Thuộc tính
kUpdateScheme_BDX

Truyền dữ liệu hàng loạt 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ản 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 Hồ sơ SoftwareUpdate.

UpdateCondition

 UpdateCondition

Các điều kiện chi phối 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 thông số phiên bản trong khung phản hồi cao hơn phiên bản phần mềm hiện được cài đặt.

IfUnmatched

Tải xuống và cài đặt hình ảnh nếu thông số 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 tại 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.

UpdatePriority

 UpdatePriority

Cập nhật các ưu tiên.

Thuộc tính
Critical

Bản cập nhật phải được thực thi ngay lập tức.

Normal

Nội dung cập nhật có thể được thực thi theo quyết định của khách hàng.

Hàm

integrityLength

int integrityLength(
  uint8_t aType
)

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

Thông tin chi tiết
Tham số
[in] aType
Giá trị IntegrityTypes
Trả về
Độ dài hàm băm của loại hàm băm đã cung cấp.