nl::編織::設定檔::軟體更新

這個命名空間包含 Weave 中的 Weave 軟體更新設定檔中的所有介面,其中包括對應的名稱相同的通訊協定。

總結

列舉

@309{
  kMsgType_ImageAnnounce = 0,
  kMsgType_ImageQuery = 1,
  kMsgType_ImageQueryResponse = 2,
  kMsgType_DownloadNotify = 3,
  kMsgType_NotifyResponse = 4,
  kMsgType_UpdateNotify = 5,
  kMsgType_ImageQueryStatus = 6
}
列舉
SoftwareUpdate 訊息類型。
@310{
  kStatus_NoUpdateAvailable = 0x0001,
  kStatus_UpdateFailed = 0x0010,
  kStatus_InvalidInstructions = 0x0050,
  kStatus_DownloadFailed = 0x0051,
  kStatus_IntegrityCheckFailed = 0x0052,
  kStatus_Abort = 0x0053,
  kStatus_Retry = 0x0091
}
列舉
@311{
  kFlag_PackageSpecPresent = 1,
  kFlag_LocaleSpecPresent = 2,
  kFlag_TargetNodeIdPresent = 4
}
列舉
ImageQuery 頁框控制項欄位的控制標記。
@312 列舉
ImageQueryResponse 的選擇性更新選項欄位的位元遮罩。
@313 列舉
ImageQueryResponse 的選用更新選項欄位位移。
@314{
  kIntegrityType_SHA160 = 0,
  kIntegrityType_SHA256 = 1,
  kIntegrityType_SHA512 = 2,
  kIntegrityType_Last = 3
}
列舉
@315 列舉
完整性規格位元組字串的長度 (以位元組為單位)。
@316{
  kUpdateScheme_HTTP = 0,
  kUpdateScheme_HTTPS = 1,
  kUpdateScheme_SFTP = 2,
  kUpdateScheme_BDX = 3,
  kUpdateScheme_Last = 4
}
列舉
@317 列舉
SoftwareUpdate 設定檔的資料元素標記。
UpdateCondition{
  IfUnmatched,
  IfLater,
  Unconditionally,
  OnOptIn
}
列舉
更新政策所規範的條件。
UpdatePriority{
  Normal,
  Critical
}
列舉
更新優先順序。

函式

integrityLength(uint8_t aType)
int
支援將 IntegrityTypes 值對應至該類型雜湊長度的方法。

類別

nl::Weave::Profiles::SoftwareUpdate::IWeaveImageAnnounceServerDelegate

WeaveImageAnnounceServer 委派介面的介面。

nl::Weave::Profiles::SoftwareUpdate::ImageAnununce

說明 ImageAnnounce 訊息的類別。

nl::Weave::Profiles::SoftwareUpdate::ImageQuery

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

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

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

nl::Weave::Profiles::SoftwareUpdate:: IntegritySpec

包含軟體更新圖片完整性類型和軟體雜湊的輔助類別。

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

包含完整性類別清單的補充類別,做為圖片查詢的一部分。

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

代表產品規格的輔助類別。

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

包含更新配置清單的輔助類別,做為圖片查詢的一部分。

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

用於監聽 Weave 圖片公告的伺服器。

列舉

@309

 @309

SoftwareUpdate 訊息類型。

屬性
kMsgType_DownloadNotify

用戶端傳送給伺服器的選擇性訊息,用於通知伺服器關於下載狀態的資訊。

其酬載是 nl::Weave::Profiles::StatusReporting::StatusReport,其中包含從 SoftwareUpdateStatusCodes 擷取的其他狀態資訊。

kMsgType_ImageAnnounce

不請自來的不雅訊息,會由伺服器發出軟體更新通知。

訊息沒有酬載。

kMsgType_ImageQuery

用戶端傳送至伺服器的查詢訊息。

其格式是使用 ImageQuery 類別定義。

kMsgType_ImageQueryResponse

為成功成功的圖片查詢訊息而產生的訊息。

其格式是由 ImageQueryResponse 類別定義。

kMsgType_ImageQueryStatus

為回應失敗的圖片查詢訊息而產生的訊息。

其酬載是 nl::Weave::Profiles::StatusReporting::StatusReport,其中包含從 SoftwareUpdateStatusCodes 擷取的其他狀態資訊。

kMsgType_NotifyResponse

為回應下載通知訊息而產生的訊息。

其酬載是 nl::Weave::Profiles::StatusReporting::StatusReport,其中包含從 SoftwareUpdateStatusCodes 擷取的其他狀態資訊。

kMsgType_UpdateNotify

用戶端傳送給伺服器的選用訊息,用於傳達更新的最終狀態。

其酬載是 nl::Weave::Profiles::StatusReporting::StatusReport,其中包含從 SoftwareUpdateStatusCodes 擷取的其他狀態資訊。由於郵件預計會在實際更新後產生,因此會在新的 ExchangeContext 上傳送,而會視為伺服器上的來路不明的郵件。

@310

 @310

SoftwareUpdate 設定檔的特定狀態碼。

屬性
kStatus_Abort

server margingt; client,表示用戶端已無法連線,因此用戶端應該放棄。

kStatus_DownloadFailed

用戶端 margingt; 伺服器代表嘗試下載失敗。

kStatus_IntegrityCheckFailed

用戶端 ↓gt; 伺服器,表示已下載圖片,但後續的完整性檢查失敗。

kStatus_InvalidInstructions

用戶端 ↓gt; 伺服器,代表用戶端無法下載圖片,因為 ImageQueryResponse 中的下載指示 (例如

URI、更新配置、更新條件、格式不正確或不一致。

kStatus_NoUpdateAvailable

伺服器 margingt; 用戶端,代表已收到並理解圖片查詢,且伺服器目前無法對用戶端進行更新。

kStatus_Retry

server margingt; client 表示用戶端應提交其他圖片查詢,然後重新啟動/繼續更新。

kStatus_UpdateFailed

用戶端 margingt; 伺服器,表示嘗試安裝伺服器指定的映像檔失敗。

@311

 @311

ImageQuery 頁框控制項欄位的控制標記。

屬性
kFlag_LocaleSpecPresent

Locale 規格位於 ImageQuery

kFlag_PackageSpecPresent

您可以在 ImageQuery 中找到套件規格。

kFlag_TargetNodeIdPresent

目標節點 ID 存在於 ImageQuery

@312

 @312

ImageQueryResponse 的選擇性更新選項欄位的位元遮罩。

@313

 @313

ImageQueryResponse 的選用更新選項欄位位移。

@314

 @314

SoftwareUpdate 設定檔支援的完整性類型。

圖片查詢框架包含用戶端支援的完整性資訊,而圖片查詢回應包含完整性類型和值,而用戶端指示系統下載和安裝圖片。系統支援的類型如下:

屬性
kIntegrityType_Last

列舉中的有效元素數量。

kIntegrityType_SHA160

需要 160 位元安全雜湊 (SHA-1)。

kIntegrityType_SHA256

256 位元安全雜湊 (SHA-2)。

kIntegrityType_SHA512

512 位元、安全雜湊 (SHA-2)。

@315

 @315

完整性規格位元組字串的長度 (以位元組為單位)。

@316

 @316

由 SofwareUpdate 設定檔支援的更新配置。

與支援的完整性類型類似,圖片查詢內含更新機制的相關資訊,例如下載通訊協定、用戶端支援的,以及回應中包含用來下載更新配置值的值。支援的配置如下:

屬性
kUpdateScheme_BDX

您可以使用「大量資料傳輸」做為下載通訊協定。

kUpdateScheme_HTTP

使用 HTTP 做為下載通訊協定。

kUpdateScheme_HTTPS

將 HTTPS 用做下載通訊協定。

kUpdateScheme_Last

列舉中的有效元素數量。

kUpdateScheme_SFTP

應使用 SFTP 做為下載通訊協定。

@317

 @317

SoftwareUpdate 設定檔的資料元素標記。

UpdateCondition

 UpdateCondition

更新政策所規範的條件。

屬性
IfLater

如果回應框中的版本規格晚於目前安裝的軟體版本,請下載並安裝映像檔。

IfUnmatched

如果回應框中的版本規格與目前安裝的軟體版本不符,請下載並安裝圖片。

OnOptIn

在網站使用者提供的某些觸發條件上下載和安裝映像檔。

Unconditionally

無論目前執行的軟體版本為何,請下載並安裝映像檔。

更新優先順序

 UpdatePriority

更新優先順序。

屬性
Critical

必須立即執行更新。

Normal

可由客戶自行決定是否更新。

函式

完整性長度

int integrityLength(
  uint8_t aType
)

支援將 IntegrityTypes 值對應至該類型雜湊長度的方法。

詳細資料
參數
[in] aType
傳回
所提供雜湊類型的雜湊長度。