透過集合功能整理內容 你可以依據偏好儲存及分類內容。

nl::Weave::Profiles::SoftwareUpdate::ImageQueryResponse

#include <src/lib/profiles/software-update/SoftwareUpdateProfile.h>

支援建立和解碼圖片查詢回應訊息的類別。

總結

圖片查詢回應訊息的格式如下:

長度 欄位名稱
變數 URI
變數 版本規格
變數 完整性規格
1 個位元組 更新配置
1 個位元組 更新選項
(選用) 更新選項欄位的格式如下:

鑽頭 意義
0.2 更新優先順序
5.4 升 更新條件
5 報告狀態。設定完成後,用戶端就會要求產生可選用的 DownloadNotifications 和 UpdateNotifications 訊息。
5..7 升 保留
只有在圖片查詢成功處理完畢並產生要下載的圖片時,才會傳送圖片查詢回應。這則訊息會列出提交查詢的節點的下載操作說明。請注意,如果伺服器無法處理圖片查詢,就會產生圖片查詢狀態。

建構函式和解構程式

ImageQueryResponse()
ImageQueryResponse 的預設建構函式。

公開屬性

integritySpec
包含軟體更新映像檔的完整性資訊 (完整性類型和雜湊) 的欄位。
reportStatus
bool
要求透過選擇性的 DownloadNotification 和 Update 通知 訊息,通知伺服器軟體更新進度。
updateCondition
指示進行軟體更新作業的條件。
updatePriority
指示裝置執行軟體更新的時機。
updateScheme
uint8_t
用來下載軟體更新映像檔的更新配置。
uri
變數長度 UTF-8 字串,內含軟體圖片的位置。
versionSpec
變數長度 UTF-8 字串,內含特定廠商的軟體版本識別資訊。

公開函式

init(ReferencedString &, ReferencedString &, IntegritySpec &, uint8_t, UpdatePriority, UpdateCondition, bool)
使用您提供的值明確初始化 ImageQueryResponse 物件。
operator==(const ImageQueryResponse &) const
bool
一個等號運算子。
pack(PacketBuffer *)
ImageQueryResponse 序列化為提供的 PacketBuffer。
print(void)
void

公開的靜態函式

parse(PacketBuffer *, ImageQueryResponse &)
將 PacketBuffer 中提供的圖片查詢回應訊息序列化為提供的 ImageQueryResponse

公開屬性

integritySpec

IntegritySpec integritySpec

包含軟體更新映像檔的完整性資訊 (完整性類型和雜湊) 的欄位。

報表狀態

bool reportStatus

要求透過選擇性的 DownloadNotification 和 Update 通知 訊息,通知伺服器軟體更新進度。

updateCondition

UpdateCondition updateCondition

指示進行軟體更新作業的條件。

updatePriority

UpdatePriority updatePriority

指示裝置執行軟體更新的時機。

updateScheme

uint8_t updateScheme

用來下載軟體更新映像檔的更新配置。

其值來自 UpdateSchemes

uri

ReferencedString uri

變數長度 UTF-8 字串,內含軟體圖片的位置。

此字串的內容必須符合 RFC 3986 規格。對於對應定義正確的網際網路通訊協定 (HTTP、HTTPS、SFTP) 的更新配置,URI 的配置元素「必須」符合該通訊協定架構的標準網址編碼。字串長度不得超過 65565 個字元,且字串必須符合單一 Weave 訊息,且必須遵守 MTU 的限制。

versionSpec

ReferencedString versionSpec

變數長度 UTF-8 字串,內含特定廠商的軟體版本識別資訊。

字串長度不得超過 256 個位元組。

公開函式

圖片查詢回應

 ImageQueryResponse()

ImageQueryResponse 的預設建構函式。

ImageQueryResponse 可透過 init() 方法填入,或者從訊息中序列化物件。

init

WEAVE_ERROR init(
  ReferencedString &,
  ReferencedString &,
  IntegritySpec &,
  uint8_t,
  UpdatePriority,
  UpdateCondition,
  bool
)

使用您提供的值明確初始化 ImageQueryResponse 物件。

詳細資料
參數
[in] aUri
要找到新韌體映像檔的 URI。
[in] aVersion
這張圖片的版本字串。
[in] aIntegrity
對應新圖片的完整性規格。
[in] aScheme
要在下載時使用的更新配置。
[in] aPriority
與本次更新相關的更新優先順序。
[in] aCondition
要更新的條件。
[in] aReportStatus
如為 true,則要求用戶端在下載及更新後進行回報,否則用戶端將不會回報。
傳回
WEAVE_NO_ERROR 無條件。

運算子 =

bool operator==(
  const ImageQueryResponse &
) const 

一個等號運算子。

詳細資料
參數
another
用來檢查這個 ImageQueryResponseImageQueryResponse
傳回
如果兩個物件中的所有欄位都相同,則傳回 true,否則為 false

WEAVE_ERROR pack(
  PacketBuffer *
)

ImageQueryResponse 序列化為提供的 PacketBuffer。

詳細資料
參數
[in] aBuffer
要封裝查詢回應的封包緩衝區
傳回值
WEAVE_NO_ERROR
成功。
WEAVE_ERROR_BUFFER_TOO_SMALL
如果 ImageQueryResponse 過大,無法納入提供的緩衝區中。

平面

void print(
  void
)

公開的靜態函式

parse

WEAVE_ERROR parse(
  PacketBuffer *,
  ImageQueryResponse &
)

將 PacketBuffer 中提供的圖片查詢回應訊息序列化為提供的 ImageQueryResponse

詳細資料
參數
[in] aBuffer
指向剖析封包查詢的封包指標
[in] aResponse
要放置結果的物件
傳回
WEAVE_NO_ERROR 成功
傳回
WEAVE_ERROR_BUFFER_TOO_SMALL 如果訊息太小而無法包含 ImageQuery 的所有欄位
傳回
WEAVE_ERROR_INVALID_INTEGRITY_TYPE 如果提供的完整性類型不是 IntegrityTypes 中指定的值