nl::Weave::โปรไฟล์::SoftwareUpdate

เนมสเปซนี้ประกอบด้วยอินเทอร์เฟซทั้งหมดภายใน Weave สําหรับโปรไฟล์ Weave Software Update ซึ่งมีโปรโตคอลที่เกี่ยวข้องของชื่อเดียวกัน

สรุป

การแจกแจง

@309{
  kMsgType_ImageAnnounce = 0,
  kMsgType_ImageQuery = 1,
  kMsgType_ImageQueryResponse = 2,
  kMsgType_DownloadNotify = 3,
  kMsgType_NotifyResponse = 4,
  kMsgType_UpdateNotify = 5,
  kMsgType_ImageQueryStatus = 6
}
enum
ประเภทข้อความ 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
ควบคุมธงสําหรับช่องควบคุมของเฟรม ImageQuery
@312 enum
Bitmasks สําหรับช่องตัวเลือกการอัปเดตที่ไม่บังคับของ ImageQueryResponse
@313 enum
เปลี่ยนออฟเซ็ตสําหรับช่องตัวเลือกการอัปเดตของ ImageQueryResponse ที่ไม่บังคับ
@314{
  kIntegrityType_SHA160 = 0,
  kIntegrityType_SHA256 = 1,
  kIntegrityType_SHA512 = 2,
  kIntegrityType_Last = 3
}
enum
@315 enum
ความยาวเป็นไบต์สําหรับสตริงความสมบูรณ์ของข้อกําหนดไบต์
@316{
  kUpdateScheme_HTTP = 0,
  kUpdateScheme_HTTPS = 1,
  kUpdateScheme_SFTP = 2,
  kUpdateScheme_BDX = 3,
  kUpdateScheme_Last = 4
}
enum
@317 enum
แท็กองค์ประกอบข้อมูลสําหรับโปรไฟล์ SoftwareUpdate
UpdateCondition{
  IfUnmatched,
  IfLater,
  Unconditionally,
  OnOptIn
}
enum
เงื่อนไขที่ควบคุมนโยบายการอัปเดต
UpdatePriority{
  Normal,
  Critical
}
enum
อัปเดตลําดับความสําคัญ

ฟังก์ชัน

integrityLength(uint8_t aType)
int
วิธีการสนับสนุนที่แมปค่า IntegrityTypes กับความยาวของแฮชประเภทนั้น

ชั้นเรียน

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

อินเทอร์เฟซสําหรับการมอบสิทธิ์ WeaveImageAnnounceServer

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

ชั้นเรียนที่อธิบายข้อความ 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

gclidg เซิร์ฟเวอร์: ไคลเอ็นต์ระบุว่าไคลเอ็นต์ควรยกเลิกเนื่องจากเซิร์ฟเวอร์ไม่มีตัวเลือก

kStatus_DownloadFailed

จะใช้ไคลเอ็นต์ gclidgt เซิร์ฟเวอร์ ระบุว่าการดาวน์โหลดล้มเหลว

kStatus_IntegrityCheckFailed

client gclidgt; เซิร์ฟเวอร์ระบุว่ามีการดาวน์โหลดรูปภาพแล้ว แต่ทําการตรวจสอบความสมบูรณ์หลังจากนั้นไม่สําเร็จ

kStatus_InvalidInstructions

gclid ของไคลเอ็นต์ เซิร์ฟเวอร์ระบุว่าไคลเอ็นต์ไม่สามารถดาวน์โหลดรูปภาพได้ เนื่องจากวิธีการดาวน์โหลดที่อยู่ใน ImageQueryResponse คือ

URI, Scheme ของการอัปเดต เงื่อนไขการอัปเดต มีรูปแบบที่ไม่ถูกต้องหรือไม่สอดคล้องกัน

kStatus_NoUpdateAvailable

gclidg เซิร์ฟเวอร์: ไคลเอ็นต์ บ่งบอกว่าได้รับคําค้นหาและเข้าใจรูปภาพแล้ว และเซิร์ฟเวอร์ไม่มีการอัปเดตสําหรับไคลเอ็นต์ในขณะนี้

kStatus_Retry

gclid ของเซิร์ฟเวอร์; ไคลเอ็นต์ ระบุว่าไคลเอ็นต์ควรส่งคําค้นหารูปภาพอื่นและรีสตาร์ท/อัปเดตต่อ

kStatus_UpdateFailed

defaultgt; server ระบุว่าความพยายามติดตั้งรูปภาพที่ระบุโดยเซิร์ฟเวอร์ล้มเหลว

311

 @311

ควบคุมธงสําหรับช่องควบคุมของเฟรม ImageQuery

พร็อพเพอร์ตี้
kFlag_LocaleSpecPresent

ข้อมูลจําเพาะของ Locale จะอยู่ใน ImageQuery

kFlag_PackageSpecPresent

ข้อกําหนดเกี่ยวกับแพ็กเกจแสดงอยู่ใน ImageQuery

kFlag_TargetNodeIdPresent

มีรหัสโหนดเป้าหมายใน ImageQuery

312

 @312

Bitmasks สําหรับช่องตัวเลือกการอัปเดตที่ไม่บังคับของ 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

ใช้การโอนข้อมูลเป็นกลุ่ม Wea เป็นโปรโตคอลการดาวน์โหลด

kUpdateScheme_HTTP

ระบบจะใช้ HTTP เป็นโปรโตคอลการดาวน์โหลด

kUpdateScheme_HTTPS

ใช้ HTTPS เป็นโปรโตคอลการดาวน์โหลด

kUpdateScheme_Last

จํานวนองค์ประกอบที่ถูกต้องในการแจงนับ

kUpdateScheme_SFTP

และใช้ SFTP เป็นโปรโตคอลการดาวน์โหลด

317

 @317

แท็กองค์ประกอบข้อมูลสําหรับโปรไฟล์ SoftwareUpdate

อัปเดตเงื่อนไข

 UpdateCondition

เงื่อนไขที่ควบคุมนโยบายการอัปเดต

พร็อพเพอร์ตี้
IfLater

ดาวน์โหลดและติดตั้งรูปภาพหากข้อกําหนดเวอร์ชันในเฟรมการตอบกลับต่ํากว่าเวอร์ชันซอฟต์แวร์ที่กําลังติดตั้ง

IfUnmatched

ดาวน์โหลดและติดตั้งรูปภาพหากข้อกําหนดเวอร์ชันในเฟรมการตอบกลับไม่ตรงกับเวอร์ชันซอฟต์แวร์ที่ติดตั้งอยู่ในปัจจุบัน

OnOptIn

ดาวน์โหลดและติดตั้งรูปภาพบนทริกเกอร์บางรายการที่ผู้ใช้บนเว็บไซต์ระบุไว้

Unconditionally

ดาวน์โหลดและติดตั้งรูปภาพโดยไม่คํานึงถึงซอฟต์แวร์เวอร์ชันที่กําลังใช้งาน

อัปเดตลําดับความสําคัญ

 UpdatePriority

อัปเดตลําดับความสําคัญ

พร็อพเพอร์ตี้
Critical

ต้องอัปเดต

Normal

การอัปเดตอาจดําเนินการตามที่เห็นสมควร

ฟังก์ชัน

ความยาวของความสมบูรณ์

int integrityLength(
  uint8_t aType
)

วิธีการสนับสนุนที่แมปค่า IntegrityTypes กับความยาวของแฮชประเภทนั้น

รายละเอียด
พารามิเตอร์
[in] aType
ค่า IntegrityTypes
การคืนสินค้า
ความยาวของแฮชของประเภทแฮชที่ระบุ