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

تتضمن هذه الوحدة دوالًا تتحكم في بروتوكول مقاييس الاتصال.

ملخّص

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

أنواع المحددات
otLinkMetricsEnhAckFlags typedef
علامات ACK المحسّنة
otLinkMetricsEnhAckProbingIeReportCallback)(otShortAddress aShortAddress, const otExtAddress *aExtAddress, const otLinkMetricsValues *aMetricsValues, void *aContext) typedef
void(*
يتم طلب المؤشر عند تلقّي أداة Enh-ACK Probing IE.
otLinkMetricsMgmtResponseCallback)(const otIp6Address *aSource, uint8_t aStatus, void *aContext) typedef
void(*
يتم استدعاء المؤشر عند تلقّي ردّ إدارة مقاييس الرابط.
otLinkMetricsReportCallback)(const otIp6Address *aSource, const otLinkMetricsValues *aMetricsValues, uint8_t 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 لضبط أو استكشاف طلب بحث مستنِد إلى حملات التطبيقات لجذب عمليات التثبيت.
otLinkMetricsConfigForwardTrackingSeries(otInstance *aInstance, const otIp6Address *aDestination, uint8_t aSeriesId, otLinkMetricsSeriesFlags aSeriesFlags, const otLinkMetrics *aLinkMetricsFlags, otLinkMetricsMgmtResponseCallback aCallback, void *aCallbackContext)
تُرسِل طلب إدارة مقاييس رابط MLE لإعداد سلسلة تتبُّع للأمام أو محوها.
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 Link Probe.

هياكل
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
تمثّل هذه السمة العنوان القصير لموضوع الفحص.
[in] aExtAddress
هي مؤشر إلى عنوان Mac الموسّع لموضوع الفحص.
[in] aMetricsValues
مؤشر لقيم مقاييس المقاييس التي يتم الحصول عليها من IE.
[in] aContext
مؤشر للسياق الخاص بالتطبيق.

otLinkMetricsMgmtResponseCallback

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

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

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

otLinkMetricsReportCallback

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

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

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

علامات otLinkMetricsSeries

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 لضبط أو استكشاف طلب بحث مستنِد إلى حملات التطبيقات لجذب عمليات التثبيت.

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

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

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
الجيران ليس جهاز سلسلة محادثات الإصدار 1.2 ولا يتوافق مع مقاييس الروابط.

otLinkMetricsSendLinkProbe

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

تُرسِل هذه الرسالة رسالة MLE Link Probe.

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

الموارد

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