TREL - กลุ่มชุดข้อความ

โมดูลนี้ระบุ API ของ Thread Radio Encapsulation Link (TREL) สำหรับโครงสร้างพื้นฐานของเทรด

สรุป

ฟังก์ชันในโมดูลนี้จำเป็นต้องเปิดใช้ OPENTHREAD_CONFIG_RADIO_LINK_TREL_ENABLE

Typedef

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

Typedef

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 จะหายไปโดยไม่มีการแจ้งเตือน วัตถุประสงค์หลักนี้มีไว้สำหรับใช้ระหว่างการทดสอบ

เมื่อเปิดใช้โหมดตัวกรอง อินเทอร์เฟซ TREL จะยังคงเปิดใช้งานต่อไป ซึ่งต่างจาก otTrel{Enable/Disable}() ที่เริ่มต้น/หยุดการดำเนินการ TREL อย่างสมบูรณ์

รายละเอียด
พารามิเตอร์
[in] aInstance
อินสแตนซ์ OpenThread
[in] aFiltered
TRUE เพื่อเปิดใช้โหมดตัวกรอง FALSE เพื่อปิดใช้โหมดตัวกรอง

แหล่งข้อมูล

หัวข้ออ้างอิง API ของ OpenThread จะมาจากซอร์สโค้ดซึ่งพร้อมใช้งานใน GitHub ดูข้อมูลเพิ่มเติมหรือมีส่วนร่วมในเอกสารประกอบของเราได้ที่แหล่งข้อมูล