nl::Weave::الملفات الشخصية::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 تعداد
Bitmasks لحقل خيارات التحديث الاختياري في 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::الملفات الشخصية::SoftwareUpdate::IWeaveImageAnnounceServerDelegate

واجهة لمفوض WeaveImageAnnounceServer.

nl::Weave::الملفات الشخصية::SoftwareUpdate::ImageAnnounce

فئة تصف رسالة ImageAnnounce.

nl::Weave::الملفات الشخصية::SoftwareUpdate::ImageQuery

فئة لدعم إنشاء رسائل طلبات بحث الصور وفك تشفيرها.

nl::Weave::الملفات الشخصية::SoftwareUpdate::ImageQueryResponse

فئة لدعم إنشاء رسائل الرد على طلب البحث عن الصورة وفك ترميزها.

nl::Weave::الملفات الشخصية::SoftwareUpdate::IntegritySpec

فئة مساعدة تحمل نوع السلامة والتجزئة الفعلية لصورة تحديث البرنامج.

nl::Weave::الملفات الشخصية::SoftwareUpdate::IntegrityTypeList

فئة مساعدة لإضافة قائمة بأنواع السلامة كجزء من طلب البحث عن الصورة.

nl::Weave::الملفات الشخصية::SoftwareUpdate::ProductSpec

فئة إضافية تمثّل مواصفات المنتج

nl::Weave::الملفات الشخصية::SoftwareUpdate::UpdateSchemeList

فئة مساعدة لإضافة قائمة بمخططات التحديث كجزء من طلب البحث عن الصورة.

nl::Weave::الملفات الشخصية::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

يشير الخادم إلى client.t; يشير العميل إلى أنّ العميل يجب أن يتوقف عن التشغيل لأنّ الخادم خرج من الخيارات.

kStatus_DownloadFailed

يشير إلى العميل إلى أن محاولة التنزيل قد تعذّرت.

kStatus_IntegrityCheckFailed

يشير العميل ".

kStatus_InvalidInstructions

يشير العميل regexgt؛ الخادم إلى أن العميل لم يتمكّن من تنزيل صورة لأن تعليمات التنزيل الواردة في ImageQueryResponse، أي

عنوان URL أو مخطط التحديث أو حالة التحديث أو تنسيقه سيئًا أو غير متسق.

kStatus_NoUpdateAvailable

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

kStatus_Retry

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

kStatus_UpdateFailed

يشير إلى العميل، أن الخادم يشير إلى تعذُّر محاولة تثبيت صورة يحددها الخادم.

@311

 @311

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

أماكن إقامة
kFlag_LocaleSpecPresent

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

kFlag_PackageSpecPresent

مواصفات الحزمة موجودة في ImageQuery.

kFlag_TargetNodeIdPresent

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

@312

 @312

Bitmasks لحقل خيارات التحديث الاختياري في 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

أنظمة التحديث التي يدعمها الملف الشخصي لـ SokwreUpdate.

وبالمثل مع أنواع السلامة المعتمدة، يحتوي طلب البحث على الصور على معلومات حول مخططات التحديث، كبروتوكولات التنزيل، وبرنامج الدعم، وتحتوي الاستجابة على قيمة تشير إلى مخطط التحديث لاستخدامه في تنزيل الصور. المخطَّطات المتوافقة هي:

أماكن إقامة
kUpdateScheme_BDX

ويجب استخدام نقل البيانات المجمّع كبروتوكول التنزيل.

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
المرتجعات
طول علامة التجزئة لنوع التجزئة الذي تم تقديمه.