TREL - حزمة Thread

تحدّد هذه الوحدة واجهات برمجة تطبيقات Radio Encapsulation Link (TREL) للبنية الأساسية عبر سلسلة محادثات.

ملخّص

تتطلب الدوال في هذه الوحدة تفعيل OPENTHREAD_CONFIG_RADIO_LINK_TREL_ENABLE.

أنواع المحددات
otTrelPeer typedef
struct otTrelPeer
تمثيل نظير TEL
otTrelPeerIterator typedef
uint16_t
يمثل مكرّرًا وتكرارًا عبر إدخالات جدول TREL المشابهة.

الدوال
otTrelGetNextPeer(otInstance *aInstance, otTrelPeerIterator *aIterator)
const otTrelPeer *
تتكرَّر هذه الإدخالات على إدخالات جدول التطبيقات المشابهة وتحصل على الإدخال التالي من الجدول.
otTrelInitPeerIterator(otInstance *aInstance, otTrelPeerIterator *aIterator)
void
يؤدي هذا الإعداد إلى إعداد مكرّر الجدول في جدول التطبيقات المشابهة.
otTrelIsEnabled(otInstance *aInstance)
bool
تشير إلى ما إذا كانت عملية TREL مفعَّلة أم لا.
otTrelIsFilterEnabled(otInstance *aInstance)
bool
يشير إلى ما إذا كان قد تم تفعيل وضع الفلتر أم لا.
otTrelSetEnabled(otInstance *aInstance, bool aEnable)
void
لتفعيل عملية TREL أو إيقافها
otTrelSetFilterEnabled(otInstance *aInstance, bool aEnable)
void
لضبط وضع الفلتر (يؤدي إلى تفعيل/إيقاف الفلترة).

هياكل
otTrelPeer

تمثيل نظير TEL

أنواع المحددات

OtTrelPeer

struct otTrelPeer otTrelPeer

تمثيل نظير TEL

برنامج otTrelPeerIterator

uint16_t otTrelPeerIterator

يمثل مكرّرًا وتكرارًا عبر إدخالات جدول TREL المشابهة.

الدوال

otTrelGetNextPeer

const otTrelPeer * otTrelGetNextPeer(
  otInstance *aInstance,
  otTrelPeerIterator *aIterator
)

تتكرَّر هذه الإدخالات على إدخالات جدول التطبيقات المشابهة وتحصل على الإدخال التالي من الجدول.

التفاصيل
المَعلمات
[in] aInstance
مثيل OpenThread.
[in] aIterator
المكرّر يجب إعدادها.
المرتجعات
يشير إلى إدخال otTrelPeer التالي أو NULL إذا لم يكن هناك المزيد من الإدخالات في الجدول.

برنامج otTrelInitPeerIterator

void otTrelInitPeerIterator(
  otInstance *aInstance,
  otTrelPeerIterator *aIterator
)

يؤدي هذا الإعداد إلى إعداد مكرّر الجدول في جدول التطبيقات المشابهة.

التفاصيل
المَعلمات
[in] aInstance
مثيل OpenThread.
[in] aIterator
لإعداد التكرار

otTrelIsEnabled

bool otTrelIsEnabled(
  otInstance *aInstance
)

تشير إلى ما إذا كانت عملية TREL مفعَّلة أم لا.

التفاصيل
المَعلمات
[in] aInstance
مثيل OpenThread.
قيم الإرجاع
TRUE
إذا تم تفعيل عملية TREL
FALSE
إذا تم إيقاف عملية TREL

otTrelIsfilterEnabled

bool otTrelIsFilterEnabled(
  otInstance *aInstance
)

يشير إلى ما إذا كان قد تم تفعيل وضع الفلتر أم لا.

التفاصيل
المَعلمات
[in] aInstance
مثيل OpenThread.
قيم الإرجاع
TRUE
في حال تفعيل وضع فلتر TREL
FALSE
في حال إيقاف وضع فلتر TREL

otTrelSetEnabled

void otTrelSetEnabled(
  otInstance *aInstance,
  bool aEnable
)

لتفعيل عملية TREL أو إيقافها

إذا تم ضبط aEnable على "صحيح"، تبدأ هذه الدالة عملية تصفّح جارية على نظام أسماء النطاقات (DNS-SD) على اسم الخدمة "_trel._udp" ضمن نطاق التصفّح المحلي لاكتشاف الأجهزة الأخرى التي تدعم TREL. ويسجّل الجهاز أيضًا خدمة جديدة ليتم الإعلان عنها باستخدام DNS-SD، بحيث يكون اسم الخدمة هو "_trel__udp". ويُشير ذلك إلى إتاحة استخدام TREL. بعد ذلك، يكون الجهاز جاهزًا لتلقّي رسائل TREL من الزملاء.

إذا تم ضبط السياسة aEnable على "خطأ"، تتوقّف هذه الدالة عن التصفُّح الذي يعرض نظام أسماء النطاقات (SD-SD) على اسم الخدمة "_trel._udp"، وتتوقف عن الإعلان عن خدمة TREL DNS-SD، وتمحو جدول TREL المشابهة.

التفاصيل
المَعلمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aEnable
قيمة منطقية لتفعيل/إيقاف عملية TREL

otTrelSetfilterEnabled

void otTrelSetFilterEnabled(
  otInstance *aInstance,
  bool aEnable
)

لضبط وضع الفلتر (يؤدي إلى تفعيل/إيقاف الفلترة).

عند تفعيل وضع الفلتر، يتم إسقاط أي زيارات Rx وtx من خلال واجهة TREL بشكل غير ملحوظ. يُقصد بذلك في المقام الأول الاستخدام أثناء الاختبار.

وعلى عكس otTrel{Enable/Disable}() التي تبدأ/توقف عملية TREL بالكامل، عندما يكون وضع الفلتر مفعّلاً، تظل واجهة TREL مفعّلة.

التفاصيل
المَعلمات
[in] aInstance
مثيل OpenThread.
[in] aFiltered
اضغط على "صحيح" لتفعيل وضع الفلتر، وعلى "خطأ" لإيقاف وضع الفلتر.

الموارد

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