หน้านี้ได้รับการแปลโดย Cloud Translation API

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 ดูข้อมูลเพิ่มเติมหรือมีส่วนร่วมในเอกสารประกอบของเราได้ที่แหล่งข้อมูล