TREL - מקבץ שרשורים

המודול הזה מגדיר ממשקי API של Thread Radio Encapsulation Link (TREL) עבור Thread Over Infrastructure.

סיכום

כדי להשתמש בפונקציות במודול הזה צריך להפעיל את OPENTHREAD_CONFIG_RADIO_LINK_TREL_ENABLE.

ערכי דף
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.

ערכי דף

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 הוא TRUE, הפונקציה הזו מפעילה עיון מתמשך של DNS-SD בשם השירות " _trel._udp" שבדומיין הגלישה המקומי, כדי לגלות מכשירים אחרים שתומכים ב-TREL. המכשיר גם רושם שירות חדש לפרסום באמצעות DNS-SD, ושם השירות הוא "_trel._udp" שמעיד על תמיכה ב-TREL. לאחר מכן המכשיר מוכן לקבלת הודעות TREL מעמיתים.

כשהערך של aEnable הוא False, הפונקציה הזו מפסיקה את הגלישה 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. אפשר לקרוא מידע נוסף או לתרום למסמכי התיעוד שלנו בדף מקורות מידע.