مقاييس الربط

تشتمل هذه الوحدة على وظائف تتحكم في بروتوكول مقاييس الرابط.

ملخّص

عمليات التعداد
otLinkMetricsEnhAckFlags{
  OT_LINK_METRICS_ENH_ACK_CLEAR = 0,
  OT_LINK_METRICS_ENH_ACK_REGISTER = 1
} 		تعداد
علامات الإقرار المحسَّنة.
otLinkMetricsStatus تعداد
قيم حالة مقاييس الربط

تحديدات النوع
otLinkMetricsEnhAckFlags typedef
علامات الإقرار المحسَّنة.
otLinkMetricsEnhAckProbingIeReportCallback)(otShortAddress aShortAddress, const otExtAddress *aExtAddress, const otLinkMetricsValues *aMetricsValues, void *aContext) typedef
void(*
يتم استدعاء المؤشر عند استلام Enh-ACK Probing IE.
otLinkMetricsMgmtResponseCallback)(const otIp6Address *aSource, otLinkMetricsStatus aStatus, void *aContext) typedef
void(*
يتم استدعاء المؤشر عند تلقّي استجابة إدارة مقاييس الرابط.
otLinkMetricsReportCallback)(const otIp6Address *aSource, const otLinkMetricsValues *aMetricsValues, otLinkMetricsStatus aStatus, void *aContext) typedef
void(*
يتم استدعاء المؤشر عند تلقّي تقرير "مقاييس الروابط".
otLinkMetricsSeriesFlags typedef
تُمثِّل هذه السمة الإطارات التي يتم احتسابها ضمن سلسلة تتبُّع إعادة توجيه.
otLinkMetricsStatus typedef
قيم حالة مقاييس الربط
otLinkMetricsValues typedef
تمثل النتيجة (القيمة) لطلب بحث "مقاييس الرابط".

الدوال
otLinkMetricsConfigEnhAckProbing(otInstance *aInstance, const otIp6Address *aDestination, otLinkMetricsEnhAckFlags aEnhAckFlags, const otLinkMetrics *aLinkMetricsFlags, otLinkMetricsMgmtResponseCallback aCallback, void *aCallbackContext, otLinkMetricsEnhAckProbingIeReportCallback aEnhAckCallback, void *aEnhAckCallbackContext)
يؤدي إلى إرسال طلب إدارة مقاييس رابط MLE لإعداد/محو فحص محسّن استنادًا إلى ACK.
otLinkMetricsConfigForwardTrackingSeries(otInstance *aInstance, const otIp6Address *aDestination, uint8_t aSeriesId, otLinkMetricsSeriesFlags aSeriesFlags, const otLinkMetrics *aLinkMetricsFlags, otLinkMetricsMgmtResponseCallback aCallback, void *aCallbackContext)
يؤدي هذا الخيار إلى إرسال طلب إدارة مقاييس رابط MLE لإعداد سلسلة تتبّع إعادة توجيه أو محوها.
otLinkMetricsManagerGetMetricsValueByExtAddr(otInstance *aInstance, const otExtAddress *aExtAddress, otLinkMetricsValues *aLinkMetricsValues)
الحصول على بيانات "مقاييس الرابط" لإحدى المواقع المجاورة باستخدام عنوانها الموسّع
otLinkMetricsManagerSetEnabled(otInstance *aInstance, bool aEnable)
void
تفعيل أو إيقاف "مدير مقاييس الرابط"
otLinkMetricsQuery(otInstance *aInstance, const otIp6Address *aDestination, uint8_t aSeriesId, const otLinkMetrics *aLinkMetricsFlags, otLinkMetricsReportCallback aCallback, void *aCallbackContext)
يؤدي هذا الخيار إلى إرسال طلب بيانات MLE لطلب بيانات "مقاييس الرابط".
otLinkMetricsSendLinkProbe(otInstance *aInstance, const otIp6Address *aDestination, uint8_t aSeriesId, uint8_t aLength)
يتم إرسال رسالة فحص رابط MLE.

الهياكل
otLinkMetricsSeriesFlags

تُمثِّل هذه السمة الإطارات التي يتم احتسابها ضمن سلسلة تتبُّع إعادة توجيه.

otLinkMetricsValues

تمثل النتيجة (القيمة) لطلب بحث "مقاييس الرابط".

عمليات التعداد

otLinkMetricsEnhAckFlags

 otLinkMetricsEnhAckFlags

علامات الإقرار المحسَّنة.

وتُستخدَم هذه النتائج في التحقيق المستنِد إلى ACK للإشارة إلى ما إذا كان يجب تسجيل الفحص أو محوه.

أماكن إقامة
OT_LINK_METRICS_ENH_ACK_CLEAR

واضحة.

OT_LINK_METRICS_ENH_ACK_REGISTER

تسجيل.

otLinkMetricsStatus

 otLinkMetricsStatus

قيم حالة مقاييس الربط

تحديدات النوع

otLinkMetricsEnhAckFlags

enum otLinkMetricsEnhAckFlags otLinkMetricsEnhAckFlags

علامات الإقرار المحسَّنة.

وتُستخدَم هذه النتائج في التحقيق المستنِد إلى ACK للإشارة إلى ما إذا كان يجب تسجيل الفحص أو محوه.

otLinkMetricsEnhAckProbingIeReportCallback

void(* otLinkMetricsEnhAckProbingIeReportCallback)(otShortAddress aShortAddress, const otExtAddress *aExtAddress, const otLinkMetricsValues *aMetricsValues, void *aContext)

يتم استدعاء المؤشر عند استلام Enh-ACK Probing IE.

التفاصيل
المَعلمات
[in] aShortAddress
هو العنوان القصير لـ Mac الخاص بالموضوع الاستقصائي.
[in] aExtAddress
مؤشر يشير إلى عنوان Mac الموسّع لموضوع التحقيق.
[in] aMetricsValues
مؤشر لقيم "مقاييس الرابط" التي تم الحصول عليها من IE.
[in] aContext
مؤشر إلى السياق الخاص بالتطبيق.

otLinkMetricsMgmtResponseCallback

void(* otLinkMetricsMgmtResponseCallback)(const otIp6Address *aSource, otLinkMetricsStatus aStatus, void *aContext)

يتم استدعاء المؤشر عند تلقّي استجابة إدارة مقاييس الرابط.

التفاصيل
المَعلمات
[in] aSource
مؤشر يشير إلى عنوان المصدر.
[in] aStatus
رمز الحالة في الرد.
[in] aContext
مؤشر إلى السياق الخاص بالتطبيق.

otLinkMetricsReportCallback

void(* otLinkMetricsReportCallback)(const otIp6Address *aSource, const otLinkMetricsValues *aMetricsValues, otLinkMetricsStatus aStatus, void *aContext)

يتم استدعاء المؤشر عند تلقّي تقرير "مقاييس الروابط".

التفاصيل
المَعلمات
[in] aSource
مؤشر يشير إلى عنوان المصدر.
[in] aMetricsValues
مؤشر يشير إلى قيم "مقاييس الرابط" (نتيجة طلب البحث).
[in] aStatus
رمز الحالة في التقرير (يكون مفيدًا فقط عندما تكون قيمة aMetricsValues فارغة).
[in] aContext
مؤشر إلى السياق الخاص بالتطبيق.

otLinkMetricsSeriesFlags

struct otLinkMetricsSeriesFlags otLinkMetricsSeriesFlags

تُمثِّل هذه السمة الإطارات التي يتم احتسابها ضمن سلسلة تتبُّع إعادة توجيه.

otLinkMetricsStatus

enum otLinkMetricsStatus otLinkMetricsStatus

قيم حالة مقاييس الربط

otLinkMetricsValues

struct otLinkMetricsValues otLinkMetricsValues

تمثل النتيجة (القيمة) لطلب بحث "مقاييس الرابط".

الدوال

otLinkMetricsConfigEnhAckProbing

otError otLinkMetricsConfigEnhAckProbing(
  otInstance *aInstance,
  const otIp6Address *aDestination,
  otLinkMetricsEnhAckFlags aEnhAckFlags,
  const otLinkMetrics *aLinkMetricsFlags,
  otLinkMetricsMgmtResponseCallback aCallback,
  void *aCallbackContext,
  otLinkMetricsEnhAckProbingIeReportCallback aEnhAckCallback,
  void *aEnhAckCallbackContext
)

يؤدي إلى إرسال طلب إدارة مقاييس رابط MLE لإعداد/محو فحص محسّن استنادًا إلى ACK.

تتطلب هذه الوظيفة تمكين ميزة OT_LINK_METRICS_INITIATOR.

التفاصيل
المَعلمات
[in] aInstance
يشير هذا المصطلح إلى مؤشر لمثيل OpenThread.
[in] aDestination
مؤشر يشير إلى عنوان الوجهة.
[in] aEnhAckFlags
علامات Enh-ACK للإشارة إلى ما إذا كان يجب تسجيل الفحص أو محوه. 0 للمحو و1 للتسجيل. القيم الأخرى محجوزة.
[in] aLinkMetricsFlags
مؤشر للإشارة إلى المقاييس التي يجب طلب البحث عنها يجب أن تكون القيمة NULL عندما تكون قيمة aEnhAckFlags هي 0.
[in] aCallback
يشير هذا المصطلح إلى مؤشر يشير إلى دالة يتم استدعاؤها عند تلقّي إذن محسَّن مع مقاييس رابط.
[in] aCallbackContext
مؤشر إلى السياق الخاص بالتطبيق.
قيم الإرجاع
OT_ERROR_NONE
تم إرسال رسالة طلب إدارة مقاييس الرابط بنجاح.
OT_ERROR_NO_BUFS
المخازن المؤقتة غير كافية لإنشاء رسالة طلب إدارة مقاييس رابط MLE.
OT_ERROR_INVALID_ARGS
القيمة "aEnhAckFlags" غير صالحة أو أنّ القيمة aLinkMetricsFlags غير صحيحة.
OT_ERROR_UNKNOWN_NEIGHBOR
القيمة aDestination غير متوافقة مع رابط محلي أو لم يتم العثور على الجوار.
OT_ERROR_NOT_CAPABLE
الجهاز المجاور ليس جهازًا Thread 1.2 ولا يتوافق مع "مقاييس الروابط".

otLinkMetricsConfigForwardTrackingSeries

otError otLinkMetricsConfigForwardTrackingSeries(
  otInstance *aInstance,
  const otIp6Address *aDestination,
  uint8_t aSeriesId,
  otLinkMetricsSeriesFlags aSeriesFlags,
  const otLinkMetrics *aLinkMetricsFlags,
  otLinkMetricsMgmtResponseCallback aCallback,
  void *aCallbackContext
)

يؤدي هذا الخيار إلى إرسال طلب إدارة مقاييس رابط MLE لإعداد سلسلة تتبّع إعادة توجيه أو محوها.

التفاصيل
المَعلمات
[in] aInstance
يشير هذا المصطلح إلى مؤشر لمثيل OpenThread.
[in] aDestination
مؤشر يشير إلى عنوان الوجهة.
[in] aSeriesId
رقم تعريف السلسلة المطلوب العمل باستخدامه.
[in] aSeriesFlags
علامات السلسلة التي تحدِّد الإطارات التي يجب حسابها.
[in] aLinkMetricsFlags
مؤشر للإشارة إلى المقاييس التي يجب طلب البحث عنها يجب أن تكون القيمة NULL عندما تكون قيمة aSeriesFlags هي 0.
[in] aCallback
يشير هذا المصطلح إلى مؤشر يتم استدعاءه عند تلقّي استجابة إدارة مقاييس الرابط.
[in] aCallbackContext
مؤشر إلى السياق الخاص بالتطبيق.
قيم الإرجاع
OT_ERROR_NONE
تم إرسال رسالة طلب إدارة مقاييس الرابط بنجاح.
OT_ERROR_NO_BUFS
المخازن المؤقتة غير كافية لإنشاء رسالة طلب إدارة مقاييس رابط MLE.
OT_ERROR_INVALID_ARGS
القيمة "aSeriesId" ليست ضمن النطاق الصحيح.
OT_ERROR_UNKNOWN_NEIGHBOR
القيمة aDestination غير متوافقة مع رابط محلي أو لم يتم العثور على الجوار.
OT_ERROR_NOT_CAPABLE
الجهاز المجاور ليس جهازًا Thread 1.2 ولا يتوافق مع "مقاييس الروابط".

otLinkMetricsManagerGetMetricsValueByExtAddr

otError otLinkMetricsManagerGetMetricsValueByExtAddr(
  otInstance *aInstance,
  const otExtAddress *aExtAddress,
  otLinkMetricsValues *aLinkMetricsValues
)

الحصول على بيانات "مقاييس الرابط" لإحدى المواقع المجاورة باستخدام عنوانها الموسّع

التفاصيل
المَعلمات
[in] aInstance
يشير هذا المصطلح إلى مؤشر لمثيل OpenThread.
[in] aExtAddress
مؤشر يشير إلى عنوان Mac الموسّع لموضوع التحقيق.
[out] aLinkMetricsValues
مؤشر إلى قيم "مقاييس الروابط" للموضوع
قيم الإرجاع
OT_ERROR_NONE
تم الحصول على بيانات "مقاييس الرابط" بنجاح.
OT_ERROR_INVALID_ARGS
الوسيطات غير صالحة.
OT_ERROR_NOT_FOUND
لم يتم العثور على جار بالعنوان الموسع المحدد.

otLinkMetricsManagerSetEnabled

void otLinkMetricsManagerSetEnabled(
  otInstance *aInstance,
  bool aEnable
)

تفعيل أو إيقاف "مدير مقاييس الرابط"

التفاصيل
المَعلمات
[in] aInstance
يشير هذا المصطلح إلى مؤشر لمثيل OpenThread.
[in] aEnable
قيمة منطقية تشير إلى التفعيل أو الإيقاف.

otLinkMetricsQuery

otError otLinkMetricsQuery(
  otInstance *aInstance,
  const otIp6Address *aDestination,
  uint8_t aSeriesId,
  const otLinkMetrics *aLinkMetricsFlags,
  otLinkMetricsReportCallback aCallback,
  void *aCallbackContext
)

يؤدي هذا الخيار إلى إرسال طلب بيانات MLE لطلب بيانات "مقاييس الرابط".

يمكن أن يكون إما فحصًا واحدًا أو سلسلة تتبُّع للأمام.

التفاصيل
المَعلمات
[in] aInstance
يشير هذا المصطلح إلى مؤشر لمثيل OpenThread.
[in] aDestination
مؤشر يشير إلى عنوان الوجهة.
[in] aSeriesId
معرِّف السلسلة المطلوب الاستعلام عنه، 0 للفحص الفردي.
[in] aLinkMetricsFlags
مؤشر للإشارة إلى المقاييس التي يجب طلب البحث عنها
[in] aCallback
يشير هذا المصطلح إلى دالة يتم استدعاؤها عند تلقّي تقرير "مقاييس الرابط".
[in] aCallbackContext
مؤشر إلى السياق الخاص بالتطبيق.
قيم الإرجاع
OT_ERROR_NONE
تم إرسال رسالة طلب بحث حول "مقاييس الرابط" بنجاح.
OT_ERROR_NO_BUFS
المخازن المؤقتة غير كافية لإنشاء رسالة طلب بيانات MLE.
OT_ERROR_UNKNOWN_NEIGHBOR
القيمة aDestination غير متوافقة مع رابط محلي أو لم يتم العثور على الجوار.
OT_ERROR_NOT_CAPABLE
الجهاز المجاور ليس جهازًا Thread 1.2 ولا يتوافق مع "مقاييس الروابط".

otLinkMetricsSendLinkProbe

otError otLinkMetricsSendLinkProbe(
  otInstance *aInstance,
  const otIp6Address *aDestination,
  uint8_t aSeriesId,
  uint8_t aLength
)

يتم إرسال رسالة فحص رابط MLE.

التفاصيل
المَعلمات
[in] aInstance
يشير هذا المصطلح إلى مؤشر لمثيل OpenThread.
[in] aDestination
مؤشر يشير إلى عنوان الوجهة.
[in] aSeriesId
رقم تعريف السلسلة [1، 254] الذي تهدف إليه رسالة الفحص.
[in] aLength
طول حمولة البيانات في Link Probe TLV، 0، 64.
قيم الإرجاع
OT_ERROR_NONE
تم إرسال رسالة "التحقق من الرابط" بنجاح.
OT_ERROR_NO_BUFS
المخازن المؤقتة غير كافية لإنشاء رسالة فحص ارتباط MLE.
OT_ERROR_INVALID_ARGS
aSeriesId أو aLength ليس ضمن النطاق الصالح.
OT_ERROR_UNKNOWN_NEIGHBOR
القيمة aDestination غير متوافقة مع رابط محلي أو لم يتم العثور على الجوار.
OT_ERROR_NOT_CAPABLE
الجهاز المجاور ليس جهازًا Thread 1.2 ولا يتوافق مع "مقاييس الروابط".

المراجِع

تنشأ المواضيع المرجعية لواجهة برمجة تطبيقات OpenThread من رمز المصدر المتاح على GitHub. للحصول على مزيد من المعلومات أو للمساهمة في مستنداتنا، يمكنك الاطّلاع على المراجع.