nl::Weave::Profiles::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)
Shift לשינויי היסט עבור השדה האופציונלי של אפשרויות העדכון של 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

הודעה אופציונלית מהלקוח לשרת המשמשת כדי להודיע לשרת על סטטוס ההורדה.

המטען הייעודי (payload) שלו הוא nl::Weave::Profiles::StatusReporting::StatusReport עם פרטי הסטטוס הנוספים שנלקח מ-SoftwareUpdateStatusCodes.

kMsgType_ImageAnnounce

הודעה אופציונלית ללא אישור מצד השרת להכריז על זמינות של עדכון תוכנה.

ההודעה לא נושאת מטען ייעודי (payload).

kMsgType_ImageQuery

הודעת שאילתה שנשלחה על ידי הלקוח לשרת.

הפורמט של הקובץ מוגדר באמצעות המחלקה ImageQuery.

kMsgType_ImageQueryResponse

הודעה שנוצרה בתגובה להודעה מוצלחת של שאילתת תמונה.

הפורמט של הקובץ הזה מוגדר על ידי המחלקה ImageQueryResponse.

kMsgType_ImageQueryStatus

הודעה שנוצרה בתגובה להודעה של שאילתת התמונה שנכשלה.

המטען הייעודי (payload) שלו הוא nl::Weave::Profiles::StatusReporting::StatusReport עם פרטי הסטטוס הנוספים שנלקח מ-SoftwareUpdateStatusCodes.

kMsgType_NotifyResponse

הודעה שנוצרה בתגובה להודעת ההתראה על ההורדה.

המטען הייעודי (payload) שלו הוא nl::Weave::Profiles::StatusReporting::StatusReport עם פרטי הסטטוס הנוספים שנלקח מ-SoftwareUpdateStatusCodes.

kMsgType_UpdateNotify

הודעה אופציונלית מהלקוח לשרת המשמשת להעברת הסטטוס הסופי של העדכון.

המטען הייעודי (payload) שלו הוא nl::Weave::Profiles::StatusReporting::StatusReport עם פרטי הסטטוס הנוספים שנלקח מ-SoftwareUpdateStatusCodes. ההודעה צפויה להיווצר אחרי העדכון בפועל, לכן היא נשלחת ב-ExchangeContext חדש ומטופלת כהודעה לא רצויה בשרת.

@310

 @310

קודי סטטוס ספציפיים לפרופיל ל-SoftwareUpdate.

מאפיינים
kStatus_Abort

שרת => הלקוח, מציין שהלקוח צריך לוותר כי אין בשרת אפשרויות.

kStatus_DownloadFailed

לקוח => מציין שניסיון הורדה נכשל.

kStatus_IntegrityCheckFailed

לקוח => מציין שבוצעה הורדה של תמונה, אבל היא נכשלה בבדיקת התקינות שלאחר מכן.

kStatus_InvalidInstructions

לקוח => מציין שהלקוח לא הצליח להוריד תמונה בגלל ההוראות להורדה שכלולות ב-ImageQueryResponse, כלומר

URI, סכימת עדכון, עדכון תנאי, בפורמט לא תקין או לא עקבי.

kStatus_NoUpdateAvailable

שרת => הלקוח מציין שהתקבלה וההבנה של שאילתת תמונה, ושלשרת אין עדכון עבור הלקוח בשלב זה.

kStatus_Retry

שרת => מציין שהלקוח צריך לשלוח שאילתת תמונה נוספת ולהפעיל מחדש/להמשיך את העדכון

kStatus_UpdateFailed

לקוח => מציין שנכשל ניסיון להתקין תמונה שצוינה על ידי השרת.

@311

 @311

דגלי בקרה בשדה הבקרה של המסגרת ImageQuery.

מאפיינים
kFlag_LocaleSpecPresent

המפרט של Locale נמצא ב-ImageQuery.

kFlag_PackageSpecPresent

מפרט החבילה מופיע ב-ImageQuery.

kFlag_TargetNodeIdPresent

מזהה צומת היעד נמצא ב-ImageQuery.

@312

 @312

Bitmasks לשדה אפשרויות העדכון האופציונלי של ImageQueryResponse.

@313

 @313

Shift לשינויי היסט עבור השדה האופציונלי של אפשרויות העדכון של ImageQueryResponse.

@314

 @314

סוגי התקינות שנתמכים בפרופיל SoftwareUpdate.

המסגרת של שאילתת התמונה מכילה מידע לגבי התקינות של התמונה שהלקוח תומך בה, והתגובה של שאילתת התמונה מכילה את סוג התקינות והערך של התמונה שהלקוח מקבל הוראה להוריד ולהתקין אותה. הסוגים הנתמכים הם:

מאפיינים
kIntegrityType_Last

מספר הרכיבים החוקיים בספירה.

kIntegrityType_SHA160

גיבוב (hash) מאובטח ב-160 ביט, (SHA-1), נדרש.

kIntegrityType_SHA256

גיבוב (hash) מאובטח ב-256 ביט (SHA-2).

kIntegrityType_SHA512

512 ביט, גיבוב מאובטח (SHA-2).

@315

 @315

אורכים בבייטים למפרט התקינות של מחרוזות בייטים.

@316

 @316

עדכון סכמות שנתמכות על ידי פרופיל SofwareUpdate.

בדומה לסוגי התקינות הנתמכים, שאילתת התמונה מכילה מידע על סכמות העדכון, כלומר פרוטוקולים של הורדה שהלקוח תומך בהם, והתשובה מכילה ערך שמציין את סכמת העדכון לשימוש בהורדת התמונות. הסכימות הנתמכות הן:

מאפיינים
kUpdateScheme_BDX

העברת נתונים בכמות גדולה ב-Weave תשמש כפרוטוקול ההורדה.

kUpdateScheme_HTTP

HTTP ישמש כפרוטוקול ההורדה.

kUpdateScheme_HTTPS

HTTPS ישמש כפרוטוקול ההורדה.

kUpdateScheme_Last

מספר הרכיבים החוקיים בספירה.

kUpdateScheme_SFTP

SFTP ישמש כפרוטוקול ההורדה.

@317

 @317

תגים של רכיבי נתונים לפרופיל SoftwareUpdate.

UpdateCondition

 UpdateCondition

התנאים שקובעים את מדיניות העדכונים.

מאפיינים
IfLater

מורידים ומתקינים את התמונה אם מפרט הגרסה במסגרת התגובה מאוחר יותר מגרסת התוכנה שמותקנת כרגע.

IfUnmatched

מורידים ומתקינים את התמונה אם מפרט הגרסה במסגרת התגובה לא תואם לגרסת התוכנה שמותקנת כרגע.

OnOptIn

להוריד ולהתקין את התמונה בטריגר כלשהו שסופק על ידי משתמש באתר.

Unconditionally

מורידים ומתקינים את התמונה ללא קשר לגרסת התוכנה הנוכחית.

UpdatePriority

 UpdatePriority

מעדכנים את סדר העדיפויות.

מאפיינים
Critical

צריך לבצע את העדכון באופן מיידי.

Normal

העדכון עשוי להתבצע לפי שיקול דעת הלקוח.

פונקציות

integrityLength

int integrityLength(
  uint8_t aType
)

שיטת תמיכה שממפה את הערכים של IntegrityTypes לאורכי הגיבובים מסוג זה.

פרטים
פרמטרים
[in] aType
החזרות
אורך הגיבוב של סוג הגיבוב שסופק.