nl::Weave::Profiles::SoftwareUpdate

تتضمن مساحة الاسم هذه جميع الواجهات الموجودة داخل 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 تعداد
أقنعة Bitmask لحقل خيارات التحديث الاختياري ImageQueryResponse.
@313 تعداد
إزاحة Shift لحقل خيارات التحديث الاختياري 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::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

الخادم => يشير إلى أن العميل يجب أن يتوقف بسبب عدم توفر خيارات الخادم.

kStatus_DownloadFailed

العميل => إلى حدوث فشل عملية تنزيل.

kStatus_IntegrityCheckFailed

العميل => إلى أنه تم تنزيل صورة ولكنها فشلت في التحقق اللاحق من السلامة.

kStatus_InvalidInstructions

العميل => إلى أن العميل لم يتمكن من تنزيل صورة بسبب تعليمات التنزيل المضمنة في ImageQueryResponse، أي

عنوان URI، مخطط التحديث، أو حالة التحديث، أو كان مكتوبًا بشكل غير صحيح أو غير متسق.

kStatus_NoUpdateAvailable

الخادم => العميل، إلى أن طلب بحث صورة قد تم استلامه وفهمه وأن الخادم ليس لديه أي تحديث للعميل في الوقت الحالي.

kStatus_Retry

الخادم => العميل، يشير إلى أنه على العميل إرسال طلب صورة آخر وإعادة تشغيل/مواصلة التحديث

kStatus_UpdateFailed

العميل => يشير إلى فشل محاولة تثبيت صورة حددها الخادم.

311@

 @311

علامات التحكّم في حقل التحكّم لإطار ImageQuery

أماكن إقامة
kFlag_LocaleSpecPresent

تتوفّر مواصفات اللغة في ImageQuery.

kFlag_PackageSpecPresent

تتوفّر مواصفات الحزمة في ImageQuery.

kFlag_TargetNodeIdPresent

يتوفّر رقم تعريف العقدة المستهدَفة في ImageQuery.

312@

 @312

أقنعة Bitmask لحقل خيارات التحديث الاختياري ImageQueryResponse.

313@

 @313

إزاحة Shift لحقل خيارات التحديث الاختياري 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
المرتجعات
طول قيمة التجزئة لنوع التجزئة المقدَّم.