TREL - پشته نخ

این ماژول APIهای Thread Radio Encapsulation Link (TREL) را برای Thread Over Infrastructure تعریف می کند.

خلاصه

عملکردهای این ماژول نیاز به فعال کردن OPENTHREAD_CONFIG_RADIO_LINK_TREL_ENABLE دارند.

Typedefs

otTrelPeer typedef
struct otTrelPeer
نشان دهنده یک همتای TREL است.
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

نشان دهنده یک همتای TREL است.

Typedefs

otTrelPeer

struct otTrelPeer otTrelPeer

نشان دهنده یک همتای TREL است.

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 نادرست است، این تابع مرور DNS-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
TRUE برای فعال کردن حالت فیلتر، FALSE برای غیرفعال کردن حالت فیلتر.

منابع

موضوعات مرجع OpenThread API از کد منبع موجود در GitHub سرچشمه می گیرند. برای اطلاعات بیشتر، یا مشارکت در اسناد ما، به منابع مراجعه کنید.