nl:: Weave:: Profiles:: SoftwareUpdate
מרחב השמות הזה כולל את כל הממשקים ב-Weave עבור פרופיל Weave Software Update, שכולל את הפרוטוקול התואם בעל אותו השם.
סיכום
ערכים של ספירה |
|
---|---|
@309{
|
טיפוסים בני מנייה (enum) סוגי הודעות של SoftwareUpdate. |
@310{
|
טיפוסים בני מנייה (enum) |
@311{
|
טיפוסים בני מנייה (enum) דגלי בקרה בשדה הבקרה של המסגרת ImageQuery. |
@312
|
טיפוסים בני מנייה (enum) Bitmasks לשדה אפשרויות העדכון האופציונלי של ImageQueryResponse. |
@313
|
טיפוסים בני מנייה (enum) Shift לשינויי היסט עבור השדה האופציונלי של אפשרויות העדכון של ImageQueryResponse. |
@314{
|
טיפוסים בני מנייה (enum) |
@315
|
טיפוסים בני מנייה (enum) אורכים בבייטים למפרט התקינות של מחרוזות בייטים. |
@316{
|
טיפוסים בני מנייה (enum) |
@317
|
טיפוסים בני מנייה (enum) תגים של רכיבי נתונים לפרופיל SoftwareUpdate. |
UpdateCondition{
|
טיפוסים בני מנייה (enum) התנאים שקובעים את מדיניות העדכונים. |
UpdatePriority{
|
טיפוסים בני מנייה (enum) מעדכנים את סדר העדיפויות. |
פונקציות |
|
---|---|
integrityLength(uint8_t aType)
|
int
שיטת תמיכה שממפה את הערכים של IntegrityTypes לאורכי הגיבובים מסוג זה.
|
שיעורים |
|
---|---|
nl:: |
ממשק למקבל הגישה ל-WeaveImageAnnounceServer. |
nl:: |
כיתה שמתארת את ההודעה ImageAnnounce. |
nl:: |
מחלקה לתמיכה ביצירה ובפענוח של הודעות שאילתת תמונה. |
nl:: |
כיתה לתמיכה ביצירה ובפענוח של הודעות תשובה לשאילתות תמונה. |
nl:: |
מחלקה עזר שמכילה את סוג התקינות ואת הגיבוב בפועל של תמונת עדכון התוכנה. |
nl:: |
מחלקה עזר שמכילה רשימה של סוגי תקינות כחלק משאילתת התמונה. |
nl:: |
סיווג עזר שמייצג מפרט מוצר. |
nl:: |
מחלקה עזר שמכילה רשימה של סכמות עדכון כחלק משאילתת התמונה. |
nl:: |
שרת שמאזין להודעות תמונה של 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. |
@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 ישמש כפרוטוקול ההורדה. |
UpdateCondition
UpdateCondition
התנאים שקובעים את מדיניות העדכונים.
מאפיינים | |
---|---|
IfLater
|
מורידים ומתקינים את התמונה אם מפרט הגרסה במסגרת התגובה מאוחר יותר מגרסת התוכנה שמותקנת כרגע. |
IfUnmatched
|
מורידים ומתקינים את התמונה אם מפרט הגרסה במסגרת התגובה לא תואם לגרסת התוכנה שמותקנת כרגע. |
OnOptIn
|
להוריד ולהתקין את התמונה בטריגר כלשהו שסופק על ידי משתמש באתר. |
Unconditionally
|
מורידים ומתקינים את התמונה ללא קשר לגרסת התוכנה הנוכחית. |
UpdatePriority
UpdatePriority
פונקציות
integrityLength
int integrityLength( uint8_t aType )
שיטת תמיכה שממפה את הערכים של IntegrityTypes לאורכי הגיבובים מסוג זה.
פרטים | |||
---|---|---|---|
פרמטרים |
|
||
החזרות |
אורך הגיבוב של סוג הגיבוב שסופק.
|