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)
מסכות סיביות לשדה אפשרויות העדכון האופציונליות ב-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

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

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

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 => client (שרת => לקוח), מציין שהלקוח צריך לוותר כי אין לשרת אפשרויות.

kStatus_DownloadFailed

client => שרת, מציין שניסיון הורדה נכשל.

kStatus_IntegrityCheckFailed

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

kStatus_InvalidInstructions

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

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

kStatus_NoUpdateAvailable

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

kStatus_Retry

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

kStatus_UpdateFailed

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

@311

 @311

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

תכונות
kFlag_LocaleSpecPresent

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

kFlag_PackageSpecPresent

מפרט החבילה נמצא ב-ImageQuery.

kFlag_TargetNodeIdPresent

מזהה צומת היעד נמצא ב-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

העברת נתונים בכמות גדולה ב-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
ערך של IntegrityTypes
החזרות
אורך הגיבוב של סוג הגיבוב שסופק.