TREL - थ्रेड स्टैक

यह मॉड्यूल, Thread ओवर इंफ़्रास्ट्रक्चर के लिए Thread Radio Encapsulation Link (TREL) API के बारे में जानकारी देता है.

खास जानकारी

इस मॉड्यूल में मौजूद फ़ंक्शन के लिए, 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 के सही होने पर, यह फ़ंक्शन लोकल ब्राउज़िंग डोमेन में सेवा नाम "_trel._udp" पर चल रहे डीएनएस-एसडी ब्राउज़ को शुरू करता है, ताकि TREL के साथ काम करने वाले अन्य डिवाइसों को खोजा जा सके. डिवाइस, डीएनएस-एसडी का इस्तेमाल करके विज्ञापन देने के लिए एक नई सेवा भी रजिस्टर करता है. इस सेवा का नाम "_trel._udp" है, जिससे पता चलता है कि यह सेवा TREL के साथ काम करती है. इसके बाद डिवाइस, अपने साथियों से TREL मैसेज पाने के लिए तैयार हो जाएगा.

aEnable के 'गलत है' पर सेट होने पर, यह फ़ंक्शन "_trel._udp" सेवा के नाम पर डीएनएस-एसडी ब्राउज़ को बंद कर देता है. साथ ही, TREL की डीएनएस-एसडी सेवा का विज्ञापन दिखाना बंद कर देता है और TREL पीयर टेबल को मिटा देता है.

ब्यौरा
पैरामीटर
[in] aInstance
OpenThread इंस्टेंस के लिए पॉइंटर.
[in] aEnable
TREL कार्रवाई को चालू/बंद करने के लिए बूलियन.

otTrelSetFilterEnabled

void otTrelSetFilterEnabled(
  otInstance *aInstance,
  bool aEnable
)

फ़िल्टर मोड सेट करता है (फ़िल्टर करने की सुविधा चालू/बंद करता है).

जब फ़िल्टर मोड चालू होता है, तब TREL इंटरफ़ेस से आने वाले rx और tx ट्रैफ़िक को बिना किसी सूचना के हटा दिया जाता है. यह मुख्य रूप से जांच के दौरान इस्तेमाल करने के लिए है.

TREL कार्रवाई को पूरी तरह से चालू/बंद करने वाले otTrel{Enable/Disable}() के उलट, फ़िल्टर मोड चालू होने पर TREL इंटरफ़ेस चालू रहता है.

ब्यौरा
पैरामीटर
[in] aInstance
OpenThread इंस्टेंस.
[in] aFiltered
फ़िल्टर मोड चालू करने के लिए 'सही' और फ़िल्टर मोड बंद करने के लिए FALSE.

संसाधन

OpenThread API के रेफ़रंस के विषय, सोर्स कोड से मिलते हैं. यह सोर्स GitHub पर उपलब्ध है. ज़्यादा जानकारी या हमारे दस्तावेज़ में योगदान देने के लिए, संसाधन देखें.