nl::Weave::Profiles::SoftwareUpdate::ImageQueryResponse

#include <src/lib/profiles/software-update/SoftwareUpdateProfile.h>

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

ملخّص

تحتوي رسالة الردّ على طلب البحث عن الصورة على النموذج:

الطول اسم الحقل
متغير معرّف الموارد المنتظم (URI)
متغير مواصفات الإصدار
متغير مواصفات السلامة
‫1 بايت تعديل المخطّط
‫1 بايت خيارات التحديث
يكون تنسيق حقل خيارات التعديل (اختياري) كما يلي:

البت المعنى
2.0. تعديل الأولوية
4.3 تعديل الحالة
5 حالة التقرير وعند ضبط هذه السياسة، يُطلَب من العميل إنشاء رسالتَي DownloadNotification وUpdateNotification الاختياري.
7.5 تم الحجز
ولا يتم إرسال الردّ على طلب البحث عن الصور إلا في حال تمت معالجة طلب البحث عن الصورة بنجاح، وتم إنشاء صورة لتنزيلها. تشكل الرسالة إرشادات تنزيل للعقدة التي تم إرسال الاستعلام إليها. يُرجى العلم أنّه في الحالات التي يتعذّر فيها على الخادم معالجة طلب البحث عن الصور، سينشئ الخادم حالة طلب بحث عن الصورة.

الشركات المصنّعة والمُصنّعة
ImageQueryResponse()
هذه هي الدالة الإنشائية التلقائية لـ ImageQueryResponse.

السمات العامة
integritySpec
حقل يحتوي على معلومات السلامة (نوع السلامة وتجزئة) لصورة تحديث البرنامج.
reportStatus
bool
يمكنك طلب إبلاغ الخادم بمدى تقدم تحديث البرنامج من خلال الرسالتين الاختياريتين DownloadNotification وUpdateNotification.
updateCondition
إرشادات حول الشروط التي يتم بموجبها متابعة تحديث البرنامج.
updatePriority
تعليمات توجّه الجهاز إلى موعد إجراء تحديث البرنامج.
updateScheme
uint8_t
مخطط التحديث الذي سيتم استخدامه لتنزيل صورة تحديث البرنامج.
uri
سلسلة UTF-8 ذات طول متغير يحتوي على موقع صورة البرنامج
versionSpec
سلسلة UTF-8 ذات طول متغير يحتوي على معرّف إصدار برنامج خاص بالمورّد.

وظائف عامة
init(ReferencedString &, ReferencedString &, IntegritySpec &, uint8_t, UpdatePriority, UpdateCondition, bool)
يجب إعداد الكائن ImageQueryResponse بشكلٍ صريح باستخدام القيم المقدَّمة.
operator==(const ImageQueryResponse &) const
bool
يشير ذلك المصطلح إلى عامل مساواة.
pack(PacketBuffer *)
تسلسل ImageQueryResponse بشكلٍ متسلسل في PacketBuffer المقدَّم.
print(void)
void

الدوال الثابتة العامة
parse(PacketBuffer *, ImageQueryResponse &)
يمكنك تنفيذ الزحف إلى رسالة الرد على طلب البحث عن الصور المقدّمة في PacketBuffer في عنصر ImageQueryResponse المقدَّم.

السمات العامة

integritySpec

IntegritySpec integritySpec

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

reportStatus

bool reportStatus

يمكنك طلب إبلاغ الخادم بمدى تقدم تحديث البرنامج من خلال الرسالتين الاختياريتين DownloadNotification وUpdateNotification.

updateCondition

UpdateCondition updateCondition

إرشادات حول الشروط التي يتم بموجبها متابعة تحديث البرنامج.

updatePriority

UpdatePriority updatePriority

تعليمات توجّه الجهاز إلى موعد إجراء تحديث البرنامج.

updateScheme

uint8_t updateScheme

مخطط التحديث الذي سيتم استخدامه لتنزيل صورة تحديث البرنامج.

ويتم الحصول على قيمتها من UpdateSchemes.

معرّف موارد منتظم (URI)

ReferencedString uri

سلسلة UTF-8 ذات طول متغير يحتوي على موقع صورة البرنامج

يجب أن يتوافق محتوى هذه السلسلة مع مواصفات RFC 3986. بالنسبة إلى مخططات التحديث المقابلة لبروتوكول الإنترنت المحدد (HTTP أو HTTPS أو SFTP)، يجب أن يتوافق عنصر مخطط معرِّف الموارد المنتظم (URI) مع ترميز عنوان URL الأساسي لمخطط البروتوكول هذا. يجب ألا يتجاوز طول السلسلة 65565 ويجب أن تندرج السلسلة ضمن رسالة Weave واحدة، والتي قد تخضع لقيود MTU.

versionSpec

ReferencedString versionSpec

سلسلة UTF-8 ذات طول متغير يحتوي على معرّف إصدار برنامج خاص بالمورّد.

يجب ألا يتجاوز طول السلسلة 256 بايت.

وظائف عامة

ImageQueryResponse

 ImageQueryResponse()

هذه هي الدالة الإنشائية التلقائية لـ ImageQueryResponse.

يمكن ملء ImageQueryResponse عن طريق الإجراء init() أو إلغاء تسلسل الكائن من الرسالة.

إعداد

WEAVE_ERROR init(
  ReferencedString &,
  ReferencedString &,
  IntegritySpec &,
  uint8_t,
  UpdatePriority,
  UpdateCondition,
  bool
)

يجب إعداد الكائن ImageQueryResponse بشكلٍ صريح باستخدام القيم المقدَّمة.

التفاصيل
المعلمات
[in] aUri
معرّف الموارد المنتظم (URI) الذي تظهر فيه صورة البرامج الثابتة الجديدة
[in] aVersion
سلسلة الإصدار لهذه الصورة.
[in] aIntegrity
مواصفات السلامة المتوافقة مع الصورة الجديدة.
[in] aScheme
مخطط التحديث المراد استخدامه في التنزيل.
[in] aPriority
أولوية التحديث المرتبطة بهذا التحديث.
[in] aCondition
الحالة التي يتم التحديث بموجبها.
[in] aReportStatus
إذا طلب "صحيح" من العميل الإبلاغ بعد اكتمال عملية التنزيل والتحديث، لن يُبلغ العميل بذلك.
المرتجعات
WEAVE_NO_ERROR بدون شرط.

عامل التشغيل==

bool operator==(
  const ImageQueryResponse &
) const

يشير ذلك المصطلح إلى عامل مساواة.

التفاصيل
المعلمات
another
يجب استخدام ImageQueryResponse للتحقّق من ذلك في ImageQueryResponse.
المرتجعات
صحيح إذا كانت جميع الحقول في كلا العنصرين متساوية، وخطأ في الحالات الأخرى

حزمة

WEAVE_ERROR pack(
  PacketBuffer *
)

تسلسل ImageQueryResponse بشكلٍ متسلسل في PacketBuffer المقدَّم.

التفاصيل
المعلمات
[in] aBuffer
يشير هذا المصطلح إلى مخزن حزم للحِزم يمكن وضع استجابة طلب البحث فيه.
قيم الإرجاع
WEAVE_NO_ERROR
عند النجاح.
WEAVE_ERROR_BUFFER_TOO_SMALL
إذا كانت قيمة ImageQueryResponse كبيرة جدًا ولا يمكن احتواؤها في المخزن المؤقت المقدّم.

طباعة

void print(
  void
)

الدوال الثابتة العامة

تحليل

WEAVE_ERROR parse(
  PacketBuffer *,
  ImageQueryResponse &
)

يمكنك تنفيذ الزحف إلى رسالة الرد على طلب البحث عن الصور المقدّمة في PacketBuffer في عنصر ImageQueryResponse المقدَّم.

التفاصيل
المعلمات
[in] aBuffer
مؤشر إلى حزمة يمكن من خلالها تحليل طلب بحث الصورة
[in] aResponse
كائن لوضع النتيجة فيه
المرتجعات
WEAVE_NO_ERROR عند النجاح
المرتجعات
WEAVE_ERROR_BUFFER_TOO_SMALL إذا كانت الرسالة صغيرة جدًا بحيث لا يمكن أن تحتوي على جميع حقول ImageQuery
المرتجعات
WEAVE_ERROR_مرح_INTEGRITY_TYPE إذا لم يكن نوع السلامة المقدّم من القيم المحدّدة في IntegrityTypes.