ลิงก์

โมดูลนี้มีฟังก์ชันที่ควบคุมการกำหนดค่าเลเยอร์ลิงก์

สรุป

การแจกแจง
otMacFilterAddressMode{
  OT_MAC_FILTER_ADDRESS_MODE_DISABLED,
  OT_MAC_FILTER_ADDRESS_MODE_ALLOWLIST,
  OT_MAC_FILTER_ADDRESS_MODE_DENYLIST
} 		enum
กำหนดโหมดที่อยู่ของตัวกรอง Mac

Typedef
otActiveScanResult typedef
แสดงบีคอน IEEE 802.15.4 ที่ได้รับ
otEnergyScanResult typedef
แสดงผลการสแกนพลังงาน
otHandleActiveScanResult)(otActiveScanResult *aResult, void *aContext) typedef
void(*
ระบบจะเรียกตัวชี้ในระหว่างการสแกนแบบแอ็กทีฟ IEEE 802.15.4 เมื่อได้รับบีคอน IEEE 802.15.4 หรือการสแกนเสร็จสมบูรณ์
otHandleEnergyScanResult)(otEnergyScanResult *aResult, void *aContext) typedef
void(*
ระบบจะเรียกใช้ตัวชี้ในระหว่างการสแกนพลังงาน IEEE 802.15.4 เมื่อผลลัพธ์สำหรับช่องพร้อมแล้วหรือการสแกนเสร็จสมบูรณ์
otLinkPcapCallback)(const otRadioFrame *aFrame, bool aIsTx, void *aContext) typedef
void(*
ระบบจะเรียกตัวชี้เมื่อได้รับเฟรม IEEE 802.15.4
otMacCounters typedef
struct otMacCounters
แสดงตัวนับเลเยอร์ MAC
otMacFilterAddressMode typedef
กำหนดโหมดที่อยู่ของตัวกรอง Mac
otMacFilterEntry typedef
แสดงรายการตัวกรองของ Mac
otMacFilterIterator typedef
uint8_t
ใช้ในการทำซ้ำผ่านรายการตัวกรอง Mac
otThreadLinkInfo typedef
แสดงข้อมูลเฉพาะของลิงก์สำหรับข้อความที่ได้รับจากวิทยุเทรด

ฟังก์ชัน
otLinkActiveScan(otInstance *aInstance, uint32_t aScanChannels, uint16_t aScanDuration, otHandleActiveScanResult aCallback, void *aCallbackContext)
เริ่มสแกน IEEE 802.15.4 แบบแอ็กทีฟ
otLinkConvertLinkQualityToRss(otInstance *aInstance, uint8_t aLinkQuality)
int8_t
แปลงคุณภาพของลิงก์เป็นความแรงของสัญญาณที่ได้รับโดยทั่วไป
otLinkConvertRssToLinkQuality(otInstance *aInstance, int8_t aRss)
uint8_t
แปลงความแรงของสัญญาณที่ได้รับเป็นคุณภาพลิงก์
otLinkEnergyScan(otInstance *aInstance, uint32_t aScanChannels, uint16_t aScanDuration, otHandleEnergyScanResult aCallback, void *aCallbackContext)
เริ่มการสแกนพลังงาน IEEE 802.15.4
otLinkFilterAddAddress(otInstance *aInstance, const otExtAddress *aExtAddress)
เพิ่มที่อยู่ที่ขยายลงในตัวกรอง MAC
otLinkFilterAddRssIn(otInstance *aInstance, const otExtAddress *aExtAddress, int8_t aRss)
เพิ่มที่อยู่ที่ขยายที่ระบุลงในรายการ RssIn (หรือแก้ไขที่อยู่ที่มีอยู่แล้วในรายการ RssIn) และตั้งค่าความแรงของสัญญาณที่ได้รับ (ใน dBm) สำหรับข้อความที่มาจากที่อยู่นั้น
otLinkFilterClearAddresses(otInstance *aInstance)
void
ล้างที่อยู่แบบขยายทั้งหมดออกจากตัวกรอง MAC
otLinkFilterClearAllRssIn(otInstance *aInstance)
void
ล้างความแรงของสัญญาณที่ได้รับทั้งหมด (rss) และรายการตัวบ่งชี้คุณภาพลิงก์ (lqi) (รวมถึงค่าเริ่มต้น) จากรายการ RssIn
otLinkFilterClearDefaultRssIn(otInstance *aInstance)
void
ล้างความแรงของสัญญาณที่ได้รับซึ่งเป็นค่าเริ่มต้นที่กำหนดไว้ก่อนหน้า (เป็น dBm) ในตัวกรอง MAC
otLinkFilterGetAddressMode(otInstance *aInstance)
รับโหมดที่อยู่ของตัวกรอง MAC
otLinkFilterGetNextAddress(otInstance *aInstance, otMacFilterIterator *aIterator, otMacFilterEntry *aEntry)
รับรายการตัวกรองที่อยู่ที่ใช้งานอยู่
otLinkFilterGetNextRssIn(otInstance *aInstance, otMacFilterIterator *aIterator, otMacFilterEntry *aEntry)
รับรายการตัวกรอง RssIn ที่ใช้งานอยู่
otLinkFilterRemoveAddress(otInstance *aInstance, const otExtAddress *aExtAddress)
void
นำที่อยู่แบบขยายออกจากตัวกรอง MAC
otLinkFilterRemoveRssIn(otInstance *aInstance, const otExtAddress *aExtAddress)
void
นำที่อยู่แบบขยายที่ระบุออกจากรายการ RssIn
otLinkFilterSetAddressMode(otInstance *aInstance, otMacFilterAddressMode aMode)
void
ตั้งค่าโหมดที่อยู่ของตัวกรอง MAC
otLinkFilterSetDefaultRssIn(otInstance *aInstance, int8_t aRss)
void
ตั้งค่าความแรงของสัญญาณที่ได้รับเริ่มต้น (เป็น dBm) ในตัวกรอง MAC
otLinkGetCcaFailureRate(otInstance *aInstance)
uint16_t
แสดงอัตราความล้มเหลวของ CCA (Clear Channel Assessment) ปัจจุบัน
otLinkGetChannel(otInstance *aInstance)
uint8_t
รับช่อง IEEE 802.15.4
otLinkGetCounters(otInstance *aInstance)
const otMacCounters *
รับตัวนับเลเยอร์ MAC
otLinkGetCslChannel(otInstance *aInstance)
uint8_t
รับช่อง CSL
otLinkGetCslPeriod(otInstance *aInstance)
uint32_t
รับคาบ CSL ในหน่วยไมโครวินาที
otLinkGetCslTimeout(otInstance *aInstance)
uint32_t
รับระยะหมดเวลา CSL
otLinkGetExtendedAddress(otInstance *aInstance)
const otExtAddress *
รับที่อยู่ IEEE 802.15.4 Extended
otLinkGetFactoryAssignedIeeeEui64(otInstance *aInstance, otExtAddress *aEui64)
void
รับ IEEE EUI-64 ที่กำหนดให้จากโรงงาน
otLinkGetMaxFrameRetriesDirect(otInstance *aInstance)
uint8_t
ส่งคืนจำนวนสูงสุดของการทำซ้ำเฟรมระหว่างการส่งโดยตรง
otLinkGetMaxFrameRetriesIndirect(otInstance *aInstance)
uint8_t
แสดงจำนวนการทำซ้ำเฟรมสูงสุดในระหว่างการส่งโดยอ้อม
otLinkGetPanId(otInstance *aInstance)
รับรหัส PAN ของ IEEE 802.15.4
otLinkGetPollPeriod(otInstance *aInstance)
uint32_t
รับข้อมูลระยะเวลาการสำรวจข้อมูลของอุปกรณ์สิ้นสุดโหมดสลีป
otLinkGetRegion(otInstance *aInstance, uint16_t *aRegionCode)
รับรหัสภูมิภาค
otLinkGetShortAddress(otInstance *aInstance)
รับที่อยู่แบบสั้น IEEE 802.15.4
otLinkGetSupportedChannelMask(otInstance *aInstance)
uint32_t
รับมาสก์ช่องทางที่รองรับของเลเยอร์ MAC
otLinkGetTxDirectRetrySuccessHistogram(otInstance *aInstance, uint8_t *aNumberOfEntries)
const uint32_t *
รับฮิสโตแกรมการลองใหม่ของแพ็กเก็ตโดยตรงเดี่ยวจนกว่าจะสำเร็จ
otLinkGetTxIndirectRetrySuccessHistogram(otInstance *aInstance, uint8_t *aNumberOfEntries)
const uint32_t *
รับฮิสโตแกรมของการพยายามซ้ำสำหรับแพ็คเก็ตโดยอ้อมหนึ่งๆ จนกว่าจะสำเร็จ
otLinkIsActiveScanInProgress(otInstance *aInstance)
bool
ระบุว่ากำลังอยู่ระหว่างการสแกน IEEE 802.15.4 หรือไม่
otLinkIsCslEnabled(otInstance *aInstance)
bool
ระบุว่าเปิดใช้ CSL หรือไม่
otLinkIsCslSupported(otInstance *aInstance)
bool
ระบุว่าอุปกรณ์เชื่อมต่ออยู่กับผู้ปกครองที่รองรับ CSL หรือไม่
otLinkIsEnabled(otInstance *aInstance)
bool
ระบุว่ามีการเปิดใช้เลเยอร์ลิงก์หรือไม่
otLinkIsEnergyScanInProgress(otInstance *aInstance)
bool
ระบุว่ากำลังมีการสแกนพลังงาน IEEE 802.15.4 หรือไม่
otLinkIsInTransmitState(otInstance *aInstance)
bool
ระบุว่า MAC ของ IEEE 802.15.4 อยู่ในสถานะการส่งหรือไม่
otLinkIsPromiscuous(otInstance *aInstance)
bool
ระบุว่ามีการเปิดใช้โหมด Promiscuous ที่เลเยอร์ลิงก์หรือไม่
otLinkIsRadioFilterEnabled(otInstance *aInstance)
bool
ระบุว่ามีการเปิดใช้งานตัวกรองวิทยุ IEEE 802.15.4 หรือไม่
otLinkResetCounters(otInstance *aInstance)
void
รีเซ็ตตัวนับเลเยอร์ MAC
otLinkResetTxRetrySuccessHistogram(otInstance *aInstance)
void
ล้างสถิติฮิสโตแกรมของการส่งข้อมูลทางตรงและทางอ้อม
otLinkSendDataRequest(otInstance *aInstance)
จัดคิวข้อความคำขอข้อมูล IEEE 802.15.4 สำหรับการส่งข้อมูล
otLinkSendEmptyData(otInstance *aInstance)
สั่งให้อุปกรณ์ส่งเฟรมข้อมูล IEEE 802.15.4 ที่ว่างเปล่า
otLinkSetChannel(otInstance *aInstance, uint8_t aChannel)
ตั้งค่าช่อง IEEE 802.15.4
otLinkSetCslChannel(otInstance *aInstance, uint8_t aChannel)
ตั้งค่าช่อง CSL
otLinkSetCslPeriod(otInstance *aInstance, uint32_t aPeriod)
ตั้งค่าระยะเวลา CSL เป็นไมโครวินาที
otLinkSetCslTimeout(otInstance *aInstance, uint32_t aTimeout)
ตั้งค่าระยะหมดเวลา CSL เป็นวินาที
otLinkSetEnabled(otInstance *aInstance, bool aEnable)
เปิดหรือปิดใช้เลเยอร์ลิงก์
otLinkSetExtendedAddress(otInstance *aInstance, const otExtAddress *aExtAddress)
ตั้งค่าที่อยู่แบบขยาย IEEE 802.15.4
otLinkSetMaxFrameRetriesDirect(otInstance *aInstance, uint8_t aMaxFrameRetriesDirect)
void
ตั้งค่าจำนวนการส่งเฟรมซ้ำสูงสุดระหว่างการส่งโดยตรง
otLinkSetMaxFrameRetriesIndirect(otInstance *aInstance, uint8_t aMaxFrameRetriesIndirect)
void
ตั้งค่าจำนวนการส่งเฟรมซ้ำสูงสุดในระหว่างการส่งโดยอ้อม
otLinkSetPanId(otInstance *aInstance, otPanId aPanId)
ตั้งค่ารหัส PAN ของ IEEE 802.15.4
otLinkSetPcapCallback(otInstance *aInstance, otLinkPcapCallback aPcapCallback, void *aCallbackContext)
void
ลงทะเบียนโค้ดเรียกกลับเพื่อรับเฟรม IEEE 802.15.4 แบบ Raw ที่ได้รับ
otLinkSetPollPeriod(otInstance *aInstance, uint32_t aPollPeriod)
ตั้งค่า/ล้างระยะเวลาการสำรวจข้อมูลที่ระบุผู้ใช้/ภายนอกสำหรับอุปกรณ์ปลายทางที่ง่วงนอน
otLinkSetPromiscuous(otInstance *aInstance, bool aPromiscuous)
เปิดหรือปิดใช้งานโหมด Promiscuous ของเลเยอร์ลิงก์
otLinkSetRadioFilterEnabled(otInstance *aInstance, bool aFilterEnabled)
void
เปิด/ปิดใช้งานโหมดตัวกรองวิทยุ IEEE 802.15.4
otLinkSetRegion(otInstance *aInstance, uint16_t aRegionCode)
ตั้งรหัสภูมิภาค
otLinkSetSupportedChannelMask(otInstance *aInstance, uint32_t aChannelMask)
ตั้งค่ามาสก์ช่องทางที่สนับสนุนของเลเยอร์ MAC

โครงสร้าง
otActiveScanResult

แสดงบีคอน IEEE 802.15.4 ที่ได้รับ

otEnergyScanResult

แสดงผลการสแกนพลังงาน

otMacCounters

แสดงตัวนับเลเยอร์ MAC

otMacFilterEntry

แสดงรายการตัวกรองของ Mac

otThreadLinkInfo

แสดงข้อมูลเฉพาะของลิงก์สำหรับข้อความที่ได้รับจากวิทยุเทรด

การแจกแจง

otMacFilterAddressMode

 otMacFilterAddressMode

กำหนดโหมดที่อยู่ของตัวกรอง Mac

พร็อพเพอร์ตี้
OT_MAC_FILTER_ADDRESS_MODE_ALLOWLIST

เปิดใช้โหมดตัวกรองที่อยู่ในรายการที่อนุญาตแล้ว

OT_MAC_FILTER_ADDRESS_MODE_DENYLIST

เปิดใช้โหมดตัวกรองที่อยู่รายการที่ปฏิเสธอยู่

OT_MAC_FILTER_ADDRESS_MODE_DISABLED

ปิดใช้ตัวกรองที่อยู่แล้ว

Typedef

otActiveScanResult

struct otActiveScanResult otActiveScanResult

แสดงบีคอน IEEE 802.15.4 ที่ได้รับ

otEnergyScanResult

struct otEnergyScanResult otEnergyScanResult

แสดงผลการสแกนพลังงาน

otHandleActiveScanResult

void(* otHandleActiveScanResult)(otActiveScanResult *aResult, void *aContext)

ระบบจะเรียกตัวชี้ในระหว่างการสแกนแบบแอ็กทีฟ IEEE 802.15.4 เมื่อได้รับบีคอน IEEE 802.15.4 หรือการสแกนเสร็จสมบูรณ์

รายละเอียด
พารามิเตอร์
[in] aResult
ตัวชี้ที่ถูกต้องไปยังข้อมูลบีคอนหรือ NULL เมื่อการสแกนที่ทำงานอยู่เสร็จสมบูรณ์
[in] aContext
ตัวชี้ไปยังบริบทเฉพาะแอปพลิเคชัน

otHandleEnergyScanResult

void(* otHandleEnergyScanResult)(otEnergyScanResult *aResult, void *aContext)

ระบบจะเรียกใช้ตัวชี้ในระหว่างการสแกนพลังงาน IEEE 802.15.4 เมื่อผลลัพธ์สำหรับช่องพร้อมแล้วหรือการสแกนเสร็จสมบูรณ์

รายละเอียด
พารามิเตอร์
[in] aResult
ตัวชี้ที่ถูกต้องไปยังข้อมูลผลการสแกนพลังงานหรือ NULL เมื่อการสแกนพลังงานเสร็จสมบูรณ์
[in] aContext
ตัวชี้ไปยังบริบทเฉพาะแอปพลิเคชัน

otLinkPcapCallback

void(* otLinkPcapCallback)(const otRadioFrame *aFrame, bool aIsTx, void *aContext)

ระบบจะเรียกตัวชี้เมื่อได้รับเฟรม IEEE 802.15.4

รายละเอียด
พารามิเตอร์
[in] aFrame
ตัวชี้ไปยังเฟรม IEEE 802.15.4 ที่ได้รับ
[in] aIsTx
เฟรมนี้มีการส่ง แต่ไม่ได้รับ
[in] aContext
ตัวชี้ไปยังบริบทเฉพาะแอปพลิเคชัน

otMacCounters

struct otMacCounters otMacCounters

แสดงตัวนับเลเยอร์ MAC

otMacFilterAddressMode

enum otMacFilterAddressMode otMacFilterAddressMode

กำหนดโหมดที่อยู่ของตัวกรอง Mac

otMacFilterEntry

struct otMacFilterEntry otMacFilterEntry

แสดงรายการตัวกรองของ Mac

otMacFilterIterator

uint8_t otMacFilterIterator

ใช้ในการทำซ้ำผ่านรายการตัวกรอง Mac

otThreadLinkInfo

struct otThreadLinkInfo otThreadLinkInfo

แสดงข้อมูลเฉพาะของลิงก์สำหรับข้อความที่ได้รับจากวิทยุเทรด

ฟังก์ชัน

otLinkActiveScan

otError otLinkActiveScan(
  otInstance *aInstance,
  uint32_t aScanChannels,
  uint16_t aScanDuration,
  otHandleActiveScanResult aCallback,
  void *aCallbackContext
)

เริ่มสแกน IEEE 802.15.4 แบบแอ็กทีฟ

รายละเอียด
พารามิเตอร์
[in] aInstance
ตัวชี้ไปยังอินสแตนซ์ OpenThread
[in] aScanChannels
เวกเตอร์เล็กน้อยที่ระบุช่องที่จะสแกน (เช่น OT_CHANNEL_11_MASK)
[in] aScanDuration
เวลาในหน่วยมิลลิวินาทีในการสแกนแต่ละช่อง
[in] aCallback
ตัวชี้ไปยังฟังก์ชันที่เรียกใช้การรับบีคอนหรือการสแกนเสร็จสมบูรณ์
[in] aCallbackContext
ตัวชี้ไปยังบริบทเฉพาะแอปพลิเคชัน
แสดงผลค่า
OT_ERROR_NONE
ยอมรับคำขอสแกนที่ทำงานอยู่
OT_ERROR_BUSY
ทำการสแกนที่ทำงานอยู่แล้ว

otLinkConvertLinkQualityToRss

int8_t otLinkConvertLinkQualityToRss(
  otInstance *aInstance,
  uint8_t aLinkQuality
)

แปลงคุณภาพของลิงก์เป็นความแรงของสัญญาณที่ได้รับโดยทั่วไป

รายละเอียด
พารามิเตอร์
[in] aInstance
ตัวชี้ไปยังอินสแตนซ์ OpenThread
[in] aLinkQuality
ค่า Link Quality ควรอยู่ในช่วง [0,3]
การส่งคืน
แพลตฟอร์มทั่วไปได้รับการแมปความแรงของสัญญาณกับ aLinkQuality

otLinkConvertRssToLinkQuality

uint8_t otLinkConvertRssToLinkQuality(
  otInstance *aInstance,
  int8_t aRss
)

แปลงความแรงของสัญญาณที่ได้รับเป็นคุณภาพลิงก์

รายละเอียด
พารามิเตอร์
[in] aInstance
ตัวชี้ไปยังอินสแตนซ์ OpenThread
[in] aRss
ค่าความแรงของสัญญาณที่ได้รับซึ่งจะถูกแปลง
การส่งคืน
ลิงก์การแมปค่าคุณภาพกับ aRss

otLinkEnergyScan

otError otLinkEnergyScan(
  otInstance *aInstance,
  uint32_t aScanChannels,
  uint16_t aScanDuration,
  otHandleEnergyScanResult aCallback,
  void *aCallbackContext
)

เริ่มการสแกนพลังงาน IEEE 802.15.4

รายละเอียด
พารามิเตอร์
[in] aInstance
ตัวชี้ไปยังอินสแตนซ์ OpenThread
[in] aScanChannels
เวกเตอร์เล็กๆ ที่แสดงช่องทางในการสแกนพลังงาน
[in] aScanDuration
เวลาในหน่วยมิลลิวินาทีในการสแกนแต่ละช่อง
[in] aCallback
ตัวชี้ไปยังฟังก์ชันที่เรียกให้ส่งผลการสแกนเมื่อระบุว่าการสแกนเสร็จสมบูรณ์
[in] aCallbackContext
ตัวชี้ไปยังบริบทเฉพาะแอปพลิเคชัน
แสดงผลค่า
OT_ERROR_NONE
ยอมรับคำขอสแกนพลังงานแล้ว
OT_ERROR_BUSY
เริ่มสแกนพลังงานไม่ได้

otLinkFilterAddAddress

otError otLinkFilterAddAddress(
  otInstance *aInstance,
  const otExtAddress *aExtAddress
)

เพิ่มที่อยู่ที่ขยายลงในตัวกรอง MAC

ใช้งานได้เมื่อเปิดใช้การกำหนดค่า OPENTHREAD_CONFIG_MAC_FILTER_ENABLE

รายละเอียด
พารามิเตอร์
[in] aInstance
ตัวชี้ไปยังอินสแตนซ์ OpenThread
[in] aExtAddress
ตัวชี้ไปยังที่อยู่แบบขยาย (ต้องไม่ใช่ NULL)
แสดงผลค่า
OT_ERROR_NONE
เพิ่ม aExtAddress ลงในตัวกรอง MAC เรียบร้อยแล้ว
OT_ERROR_NO_BUFS
ไม่มีรายการที่ใช้ได้

otLinkFilterAddRssIn

otError otLinkFilterAddRssIn(
  otInstance *aInstance,
  const otExtAddress *aExtAddress,
  int8_t aRss
)

เพิ่มที่อยู่ที่ขยายที่ระบุลงในรายการ RssIn (หรือแก้ไขที่อยู่ที่มีอยู่แล้วในรายการ RssIn) และตั้งค่าความแรงของสัญญาณที่ได้รับ (ใน dBm) สำหรับข้อความที่มาจากที่อยู่นั้น

ที่อยู่ที่ขยายไม่จำเป็นต้องอยู่ในตัวกรอง address allowlist/denylist เพื่อตั้งค่า rss

ใช้งานได้เมื่อเปิดใช้การกำหนดค่า OPENTHREAD_CONFIG_MAC_FILTER_ENABLE

รายละเอียด
พารามิเตอร์
[in] aInstance
ตัวชี้ไปยังอินสแตนซ์ OpenThread
[in] aExtAddress
ตัวชี้ไปยังที่อยู่ขยายของ IEEE 802.15.4 ต้องไม่ใช่ NULL
[in] aRss
ความแรงของสัญญาณที่ได้รับ (หน่วยเป็น dBm)
แสดงผลค่า
OT_ERROR_NONE
เพิ่มรายการสำหรับ aExtAddress และ aRss เรียบร้อยแล้ว
OT_ERROR_NO_BUFS
ไม่มีรายการที่ใช้ได้

otLinkFilterClearAddresses

void otLinkFilterClearAddresses(
  otInstance *aInstance
)

ล้างที่อยู่แบบขยายทั้งหมดออกจากตัวกรอง MAC

ใช้งานได้เมื่อเปิดใช้การกำหนดค่า OPENTHREAD_CONFIG_MAC_FILTER_ENABLE

รายละเอียด
พารามิเตอร์
[in] aInstance
ตัวชี้ไปยังอินสแตนซ์ OpenThread

otLinkFilterClearAllRssIn

void otLinkFilterClearAllRssIn(
  otInstance *aInstance
)

ล้างความแรงของสัญญาณที่ได้รับทั้งหมด (rss) และรายการตัวบ่งชี้คุณภาพลิงก์ (lqi) (รวมถึงค่าเริ่มต้น) จากรายการ RssIn

การดำเนินการนี้หมายความว่าที่อยู่แบบขยายทั้งหมดจะใช้สัญญาณออกอากาศ

ใช้งานได้เมื่อเปิดใช้การกำหนดค่า OPENTHREAD_CONFIG_MAC_FILTER_ENABLE

รายละเอียด
พารามิเตอร์
[in] aInstance
ตัวชี้ไปยังอินสแตนซ์ OpenThread

otLinkFilterClearDefaultRssIn

void otLinkFilterClearDefaultRssIn(
  otInstance *aInstance
)

ล้างความแรงของสัญญาณที่ได้รับซึ่งเป็นค่าเริ่มต้นที่กำหนดไว้ก่อนหน้า (เป็น dBm) ในตัวกรอง MAC

ใช้งานได้เมื่อเปิดใช้การกำหนดค่า OPENTHREAD_CONFIG_MAC_FILTER_ENABLE

รายละเอียด
พารามิเตอร์
[in] aInstance
ตัวชี้ไปยังอินสแตนซ์ OpenThread

otLinkFilterGetAddressMode

otMacFilterAddressMode otLinkFilterGetAddressMode(
  otInstance *aInstance
)

รับโหมดที่อยู่ของตัวกรอง MAC

ใช้งานได้เมื่อเปิดใช้การกำหนดค่า OPENTHREAD_CONFIG_MAC_FILTER_ENABLE

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

otLinkFilterGetNextAddress

otError otLinkFilterGetNextAddress(
  otInstance *aInstance,
  otMacFilterIterator *aIterator,
  otMacFilterEntry *aEntry
)

รับรายการตัวกรองที่อยู่ที่ใช้งานอยู่

ใช้งานได้เมื่อเปิดใช้การกำหนดค่า OPENTHREAD_CONFIG_MAC_FILTER_ENABLE

รายละเอียด
พารามิเตอร์
[in] aInstance
ตัวชี้ไปยังอินสแตนซ์ OpenThread
[in,out] aIterator
ตัวชี้ไปยังบริบทตัววนซ้ำตัวกรอง MAC หากต้องการดูรายการตัวกรองที่อยู่ที่ใช้งานครั้งแรก ควรตั้งค่าดังกล่าวเป็น OT_MAC_FILTER_ITERATOR_INIT ต้องไม่ใช่ NULL
[out] aEntry
ตัวชี้ที่ไปยังตำแหน่งที่วางข้อมูล ต้องไม่ใช่ NULL
แสดงผลค่า
OT_ERROR_NONE
เรียกข้อมูลรายการตัวกรองที่อยู่ที่ใช้งานอยู่เรียบร้อยแล้ว
OT_ERROR_NOT_FOUND
ไม่มีรายการที่ตามมา

otLinkFilterGetNextRssIn

otError otLinkFilterGetNextRssIn(
  otInstance *aInstance,
  otMacFilterIterator *aIterator,
  otMacFilterEntry *aEntry
)

รับรายการตัวกรอง RssIn ที่ใช้งานอยู่

ใช้งานได้เมื่อเปิดใช้การกำหนดค่า OPENTHREAD_CONFIG_MAC_FILTER_ENABLE

รายละเอียด
พารามิเตอร์
[in] aInstance
ตัวชี้ไปยังอินสแตนซ์ OpenThread
[in,out] aIterator
ตัวชี้ไปยังบริบทตัววนซ้ำตัวกรอง MAC ต้องไม่ใช่ NULL หากต้องการรายการแรก ควรตั้งค่าเป็น OT_MAC_FILTER_ITERATOR_INIT
[out] aEntry
ตัวชี้ที่ไปยังตำแหน่งที่วางข้อมูล รายการสุดท้ายจะมีที่อยู่แบบขยายเป็น 0xff ทั้งหมดเพื่อระบุความแรงของสัญญาณที่ได้รับตามค่าเริ่มต้นหากมีการตั้งค่า aEntry ต้องไม่ใช่ NULL
แสดงผลค่า
OT_ERROR_NONE
เรียกข้อมูลรายการถัดไปเรียบร้อยแล้ว
OT_ERROR_NOT_FOUND
ไม่มีรายการที่ตามมา

otLinkFilterRemoveAddress

void otLinkFilterRemoveAddress(
  otInstance *aInstance,
  const otExtAddress *aExtAddress
)

นำที่อยู่แบบขยายออกจากตัวกรอง MAC

ใช้งานได้เมื่อเปิดใช้การกำหนดค่า OPENTHREAD_CONFIG_MAC_FILTER_ENABLE

ระบบจะไม่ดำเนินการใดๆ หากไม่มีรายการที่มีอยู่ในตัวกรองที่ตรงกับที่อยู่แบบขยายที่ระบุ

รายละเอียด
พารามิเตอร์
[in] aInstance
ตัวชี้ไปยังอินสแตนซ์ OpenThread
[in] aExtAddress
ตัวชี้ไปยังที่อยู่แบบขยาย (ต้องไม่ใช่ NULL)

otLinkFilterRemoveRssIn

void otLinkFilterRemoveRssIn(
  otInstance *aInstance,
  const otExtAddress *aExtAddress
)

นำที่อยู่แบบขยายที่ระบุออกจากรายการ RssIn

เมื่อนำออกจากรายการ RssIn แล้ว ที่อยู่ MAC นี้จะใช้การตั้งค่า rss และ lqi เริ่มต้นแทนโดยมีสมมติฐานว่ามีการตั้งค่าเริ่มต้นแล้ว (หากไม่ได้กำหนดค่าเริ่มต้นไว้ ระบบจะใช้สัญญาณแบบผ่านอากาศ (OTA))

ใช้งานได้เมื่อเปิดใช้การกำหนดค่า OPENTHREAD_CONFIG_MAC_FILTER_ENABLE

จะไม่มีการดำเนินการใดๆ หากไม่มีข้อมูลใดในรายการ RssIn ที่ตรงกับที่อยู่แบบขยายที่ระบุไว้

รายละเอียด
พารามิเตอร์
[in] aInstance
ตัวชี้ไปยังอินสแตนซ์ OpenThread
[in] aExtAddress
ตัวชี้ไปยังที่อยู่ขยายของ IEEE 802.15.4 ต้องไม่ใช่ NULL

otLinkFilterSetAddressMode

void otLinkFilterSetAddressMode(
  otInstance *aInstance,
  otMacFilterAddressMode aMode
)

ตั้งค่าโหมดที่อยู่ของตัวกรอง MAC

ใช้งานได้เมื่อเปิดใช้การกำหนดค่า OPENTHREAD_CONFIG_MAC_FILTER_ENABLE

รายละเอียด
พารามิเตอร์
[in] aInstance
ตัวชี้ไปยังอินสแตนซ์ OpenThread
[in] aMode
โหมดที่อยู่ที่จะตั้งค่า

otLinkFilterSetDefaultRssIn

void otLinkFilterSetDefaultRssIn(
  otInstance *aInstance,
  int8_t aRss
)

ตั้งค่าความแรงของสัญญาณที่ได้รับเริ่มต้น (เป็น dBm) ในตัวกรอง MAC

ใช้งานได้เมื่อเปิดใช้การกำหนดค่า OPENTHREAD_CONFIG_MAC_FILTER_ENABLE

ค่า RSS เริ่มต้นจะใช้สำหรับเฟรมที่ได้รับทั้งหมดจากที่อยู่ซึ่งไม่มีรายการ RSS-IN ที่ชัดแจ้งในรายการตัวกรอง (เพิ่มโดยใช้ otLinkFilterAddRssIn())

รายละเอียด
พารามิเตอร์
[in] aInstance
ตัวชี้ไปยังอินสแตนซ์ OpenThread
[in] aRss
ความแรงของสัญญาณที่ได้รับเริ่มต้น (หน่วยเป็น dBm) เพื่อตั้งค่า

otLinkGetCcaFailureRate

uint16_t otLinkGetCcaFailureRate(
  otInstance *aInstance
)

แสดงอัตราความล้มเหลวของ CCA (Clear Channel Assessment) ปัจจุบัน

อัตรานี้จะรักษาไว้ในช่วงกรอบเวลาการส่ง OPENTHREAD_CONFIG_CCA_FAILURE_RATE_AVERAGING_WINDOW เฟรมที่ผ่านมา (โดยประมาณ)

รายละเอียด
การส่งคืน
อัตราความล้มเหลวของ CCA โดยมีค่าสูงสุด 0xffff ที่สอดคล้องกับอัตราความล้มเหลว 100%

otLinkGetChannel

uint8_t otLinkGetChannel(
  otInstance *aInstance
)

รับช่อง IEEE 802.15.4

รายละเอียด
พารามิเตอร์
[in] aInstance
ตัวชี้ไปยังอินสแตนซ์ OpenThread
การส่งคืน
ช่อง IEEE 802.15.4
ดูเพิ่มเติม:
otLinkSetChannel

otLinkGetCounters

const otMacCounters * otLinkGetCounters(
  otInstance *aInstance
)

รับตัวนับเลเยอร์ MAC

รายละเอียด
พารามิเตอร์
[in] aInstance
ตัวชี้ไปยังอินสแตนซ์ OpenThread
การส่งคืน
ตัวชี้ไปยังตัวนับเลเยอร์ MAC

otLinkGetCslChannel

uint8_t otLinkGetCslChannel(
  otInstance *aInstance
)

รับช่อง CSL

รายละเอียด
พารามิเตอร์
[in] aInstance
ตัวชี้ไปยังอินสแตนซ์ OpenThread
การส่งคืน
ช่อง CSL

otLinkGetCslPeriod

uint32_t otLinkGetCslPeriod(
  otInstance *aInstance
)

รับคาบ CSL ในหน่วยไมโครวินาที

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

otLinkGetCslTimeout

uint32_t otLinkGetCslTimeout(
  otInstance *aInstance
)

รับระยะหมดเวลา CSL

รายละเอียด
พารามิเตอร์
[in] aInstance
ตัวชี้ไปยังอินสแตนซ์ OpenThread
การส่งคืน
ระยะหมดเวลาของ CSL เป็นวินาที

otLinkGetExtendedAddress

const otExtAddress * otLinkGetExtendedAddress(
  otInstance *aInstance
)

รับที่อยู่ IEEE 802.15.4 Extended

รายละเอียด
พารามิเตอร์
[in] aInstance
ตัวชี้ไปยังอินสแตนซ์ OpenThread
การส่งคืน
ตัวชี้ไปยังที่อยู่ขยายของ IEEE 802.15.4

otLinkGetFactoryAssignedIeeeEui64

void otLinkGetFactoryAssignedIeeeEui64(
  otInstance *aInstance,
  otExtAddress *aEui64
)

รับ IEEE EUI-64 ที่กำหนดให้จากโรงงาน

รายละเอียด
พารามิเตอร์
[in] aInstance
ตัวชี้ไปยังอินสแตนซ์ OpenThread
[out] aEui64
ตัวชี้ไปยังตำแหน่งที่วาง IEEE EUI-64 ที่กำหนดให้จากโรงงาน

otLinkGetMaxFrameRetriesDirect

uint8_t otLinkGetMaxFrameRetriesDirect(
  otInstance *aInstance
)

ส่งคืนจำนวนสูงสุดของการทำซ้ำเฟรมระหว่างการส่งโดยตรง

รายละเอียด
พารามิเตอร์
[in] aInstance
ตัวชี้ไปยังอินสแตนซ์ OpenThread
การส่งคืน
จำนวนการดำเนินการซ้ำสูงสุดระหว่างการส่งโดยตรง

otLinkGetMaxFrameRetriesIndirect

uint8_t otLinkGetMaxFrameRetriesIndirect(
  otInstance *aInstance
)

แสดงจำนวนการทำซ้ำเฟรมสูงสุดในระหว่างการส่งโดยอ้อม

รายละเอียด
พารามิเตอร์
[in] aInstance
ตัวชี้ไปยังอินสแตนซ์ OpenThread
การส่งคืน
จำนวนการดำเนินการซ้ำสูงสุดระหว่างการส่งโดยอ้อม

otLinkGetPanId

otPanId otLinkGetPanId(
  otInstance *aInstance
)

รับรหัส PAN ของ IEEE 802.15.4

รายละเอียด
พารามิเตอร์
[in] aInstance
ตัวชี้ไปยังอินสแตนซ์ OpenThread
การส่งคืน
รหัส PAN ของ IEEE 802.15.4
ดูเพิ่มเติม:
otLinkSetPanId

otLinkGetPollPeriod

uint32_t otLinkGetPollPeriod(
  otInstance *aInstance
)

รับข้อมูลระยะเวลาการสำรวจข้อมูลของอุปกรณ์สิ้นสุดโหมดสลีป

รายละเอียด
พารามิเตอร์
[in] aInstance
ตัวชี้ไปยังอินสแตนซ์ OpenThread
การส่งคืน
ระยะเวลาการหยั่งสัญญาณข้อมูลของอุปกรณ์สิ้นสุดที่ง่วงนอน หน่วยเป็นมิลลิวินาที
ดูเพิ่มเติม:
otLinkSetPollPeriod

otLinkGetRegion

otError otLinkGetRegion(
  otInstance *aInstance,
  uint16_t *aRegionCode
)

รับรหัสภูมิภาค

รูปแบบภูมิภาคของวิทยุคือรูปแบบ 2 ไบต์ ascii ของรหัส ISO 3166 alpha-2

รายละเอียด
พารามิเตอร์
[in] aInstance
โครงสร้างอินสแตนซ์ OpenThread
[out] aRegionCode
รหัสภูมิภาคของวิทยุ aRegionCode >> 8 คืออักขระ ASCII ตัวแรกและ aRegionCode & 0xff คืออักขระ ASCII รายการที่ 2
แสดงผลค่า
OT_ERROR_INVALID_ARGS
aRegionCode มีค่าเป็น nullptr
OT_ERROR_FAILED
ข้อผิดพลาดเฉพาะแพลตฟอร์มอื่นๆ
OT_ERROR_NONE
รับรหัสภูมิภาคเรียบร้อยแล้ว
OT_ERROR_NOT_IMPLEMENTED
ไม่มีการใช้ฟีเจอร์นี้

otLinkGetShortAddress

otShortAddress otLinkGetShortAddress(
  otInstance *aInstance
)

รับที่อยู่แบบสั้น IEEE 802.15.4

รายละเอียด
พารามิเตอร์
[in] aInstance
ตัวชี้ไปยังอินสแตนซ์ OpenThread
การส่งคืน
ตัวชี้ไปยังที่อยู่แบบย่อ IEEE 802.15.4

otLinkGetSupportedChannelMask

uint32_t otLinkGetSupportedChannelMask(
  otInstance *aInstance
)

รับมาสก์ช่องทางที่รองรับของเลเยอร์ MAC

รายละเอียด
พารามิเตอร์
[in] aInstance
ตัวชี้ไปยังอินสแตนซ์ OpenThread
การส่งคืน
มาสก์แชแนลที่รองรับเป็น uint32_t ที่มีการแมปบิต 0 (lsb) เป็นช่อง 0 บิต 1 ถึงช่อง 1 เป็นต้น

otLinkGetTxDirectRetrySuccessHistogram

const uint32_t * otLinkGetTxDirectRetrySuccessHistogram(
  otInstance *aInstance,
  uint8_t *aNumberOfEntries
)

รับฮิสโตแกรมการลองใหม่ของแพ็กเก็ตโดยตรงเดี่ยวจนกว่าจะสำเร็จ

ใช้งานได้เมื่อเปิดใช้การกำหนดค่า OPENTHREAD_CONFIG_MAC_RETRY_SUCCESS_HISTOGRAM_ENABLE

รายละเอียด
พารามิเตอร์
[in] aInstance
ตัวชี้ไปยังอินสแตนซ์ OpenThread
[out] aNumberOfEntries
ตัวชี้ไปยังตำแหน่งที่วางขนาดของอาร์เรย์ฮิสโตแกรมที่แสดงผล
การส่งคืน
ตัวชี้ไปยังฮิสโตแกรมของการลองใหม่ (ในรูปแบบอาร์เรย์) องค์ประกอบที่ n ระบุว่ามีการส่งแพ็กเก็ตแล้วพร้อมกับการพยายามครั้งที่ n

otLinkGetTxIndirectRetrySuccessHistogram

const uint32_t * otLinkGetTxIndirectRetrySuccessHistogram(
  otInstance *aInstance,
  uint8_t *aNumberOfEntries
)

รับฮิสโตแกรมของการพยายามซ้ำสำหรับแพ็คเก็ตโดยอ้อมหนึ่งๆ จนกว่าจะสำเร็จ

ใช้งานได้เมื่อเปิดใช้การกำหนดค่า OPENTHREAD_CONFIG_MAC_RETRY_SUCCESS_HISTOGRAM_ENABLE

รายละเอียด
พารามิเตอร์
[in] aInstance
ตัวชี้ไปยังอินสแตนซ์ OpenThread
[out] aNumberOfEntries
ตัวชี้ไปยังตำแหน่งที่วางขนาดของอาร์เรย์ฮิสโตแกรมที่แสดงผล
การส่งคืน
ตัวชี้ไปยังฮิสโตแกรมของการลองใหม่ (ในรูปแบบอาร์เรย์) องค์ประกอบที่ n ระบุว่ามีการส่งแพ็กเก็ตแล้วพร้อมกับการพยายามครั้งที่ n

otLinkIsActiveScanInProgress

bool otLinkIsActiveScanInProgress(
  otInstance *aInstance
)

ระบุว่ากำลังอยู่ระหว่างการสแกน IEEE 802.15.4 หรือไม่

รายละเอียด
พารามิเตอร์
[in] aInstance
ตัวชี้ไปยังอินสแตนซ์ OpenThread
การส่งคืน
true ถ้าระบบกำลังดำเนินการสแกน IEEE 802.15.4 อยู่ จะเป็นเท็จ มิฉะนั้น

otLinkIsCslEnabled

bool otLinkIsCslEnabled(
  otInstance *aInstance
)

ระบุว่าเปิดใช้ CSL หรือไม่

รายละเอียด
พารามิเตอร์
[in] aInstance
ตัวชี้ไปยังอินสแตนซ์ OpenThread
แสดงผลค่า
TRUE
เปิดใช้เลเยอร์ลิงก์ CSL อยู่
FALSE
ไม่ได้เปิดใช้ CSL เลเยอร์ลิงก์

otLinkIsCslSupported

bool otLinkIsCslSupported(
  otInstance *aInstance
)

ระบุว่าอุปกรณ์เชื่อมต่ออยู่กับผู้ปกครองที่รองรับ CSL หรือไม่

รายละเอียด
แสดงผลค่า
TRUE
หากผู้เผยแพร่โฆษณาหลักรองรับ CSL
FALSE
หากผู้เผยแพร่โฆษณาหลักไม่รองรับ CSL

otLinkIsEnabled

bool otLinkIsEnabled(
  otInstance *aInstance
)

ระบุว่ามีการเปิดใช้เลเยอร์ลิงก์หรือไม่

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

otLinkIsEnergyScanInProgress

bool otLinkIsEnergyScanInProgress(
  otInstance *aInstance
)

ระบุว่ากำลังมีการสแกนพลังงาน IEEE 802.15.4 หรือไม่

รายละเอียด
พารามิเตอร์
[in] aInstance
ตัวชี้ไปยังอินสแตนซ์ OpenThread
การส่งคืน
true ถ้าระบบกำลังดำเนินการสแกนพลังงาน IEEE 802.15.4 อยู่ จะเป็นเท็จ

otLinkIsInTransmitState

bool otLinkIsInTransmitState(
  otInstance *aInstance
)

ระบุว่า MAC ของ IEEE 802.15.4 อยู่ในสถานะการส่งหรือไม่

โมดูล MAC จะอยู่ในสถานะการส่งระหว่างขั้นตอน CSMA/CA, การส่งเฟรม CCA, ข้อมูล, บีคอน หรือคำขอข้อมูล และได้รับข้อความ ACK ของเฟรมที่ส่ง โมดูล MAC ไม่อยู่ในสถานะการส่งระหว่างการส่งเฟรม ACK หรือเฟรมคำขอบีคอน

รายละเอียด
พารามิเตอร์
[in] aInstance
ตัวชี้ไปยังอินสแตนซ์ OpenThread
การส่งคืน
true ถ้า MAC ของ IEEE 802.15.4 อยู่ในสถานะการส่ง หากไม่เป็น false

otLinkIsPromiscuous

bool otLinkIsPromiscuous(
  otInstance *aInstance
)

ระบุว่ามีการเปิดใช้โหมด Promiscuous ที่เลเยอร์ลิงก์หรือไม่

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

otLinkIsRadioFilterEnabled

bool otLinkIsRadioFilterEnabled(
  otInstance *aInstance
)

ระบุว่ามีการเปิดใช้งานตัวกรองวิทยุ IEEE 802.15.4 หรือไม่

ใช้งานได้เมื่อเปิดใช้การกำหนดค่า OPENTHREAD_CONFIG_MAC_FILTER_ENABLE

รายละเอียด
แสดงผลค่า
TRUE
หากตัวกรองวิทยุเปิดใช้อยู่
FALSE
หากตัวกรองวิทยุปิดใช้อยู่

otLinkResetCounters

void otLinkResetCounters(
  otInstance *aInstance
)

รีเซ็ตตัวนับเลเยอร์ MAC

รายละเอียด
พารามิเตอร์
[in] aInstance
ตัวชี้ไปยังอินสแตนซ์ OpenThread

otLinkResetTxRetrySuccessHistogram

void otLinkResetTxRetrySuccessHistogram(
  otInstance *aInstance
)

ล้างสถิติฮิสโตแกรมของการส่งข้อมูลทางตรงและทางอ้อม

ใช้งานได้เมื่อเปิดใช้การกำหนดค่า OPENTHREAD_CONFIG_MAC_RETRY_SUCCESS_HISTOGRAM_ENABLE

รายละเอียด
พารามิเตอร์
[in] aInstance
ตัวชี้ไปยังอินสแตนซ์ OpenThread

otLinkSendDataRequest

otError otLinkSendDataRequest(
  otInstance *aInstance
)

จัดคิวข้อความคำขอข้อมูล IEEE 802.15.4 สำหรับการส่งข้อมูล

รายละเอียด
พารามิเตอร์
[in] aInstance
ตัวชี้ไปยังอินสแตนซ์ OpenThread
แสดงผลค่า
OT_ERROR_NONE
จัดคิวข้อความคำขอข้อมูล IEEE 802.15.4 สำเร็จแล้ว
OT_ERROR_INVALID_STATE
อุปกรณ์ไม่ได้อยู่ในโหมด RX-ปิดเมื่อไม่มีการใช้งาน
OT_ERROR_NO_BUFS
มีบัฟเฟอร์ข้อความไม่เพียงพอ

otLinkSendEmptyData

otError otLinkSendEmptyData(
  otInstance *aInstance
)

สั่งให้อุปกรณ์ส่งเฟรมข้อมูล IEEE 802.15.4 ที่ว่างเปล่า

รองรับเฉพาะในอุปกรณ์ Rx-Off-When-Idle ในการส่งเฟรมข้อมูลที่ว่างเปล่าไปยังองค์กรระดับบนสุด หมายเหตุ: ใช้ได้เฉพาะเมื่อเปิดใช้ OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE เท่านั้น

รายละเอียด
พารามิเตอร์
[in] aInstance
ตัวชี้ไปยังอินสแตนซ์ OpenThread
แสดงผลค่า
OT_ERROR_NONE
จัดคิวข้อความว่างเปล่าเรียบร้อยแล้ว
OT_ERROR_INVALID_STATE
อุปกรณ์ไม่ได้อยู่ในโหมด Rx-Off-เมื่อไม่มีการใช้งาน
OT_ERROR_NO_BUFS
มีบัฟเฟอร์ข้อความไม่เพียงพอ

otLinkSetChannel

otError otLinkSetChannel(
  otInstance *aInstance,
  uint8_t aChannel
)

ตั้งค่าช่อง IEEE 802.15.4

สำเร็จเมื่อปิดใช้โปรโตคอลเทรดเท่านั้น การเรียกใช้ฟังก์ชันนี้ที่สำเร็จจะทำให้ชุดข้อมูลการดำเนินการที่ใช้งานอยู่และรอดำเนินการในหน่วยความจำที่ไม่ผันผวนเป็นโมฆะ

รายละเอียด
พารามิเตอร์
[in] aInstance
ตัวชี้ไปยังอินสแตนซ์ OpenThread
[in] aChannel
ช่อง IEEE 802.15.4
แสดงผลค่า
OT_ERROR_NONE
ตั้งค่าช่องสำเร็จแล้ว
OT_ERROR_INVALID_ARGS
หาก aChannel ไม่อยู่ในช่วง [11, 26] หรือไม่อยู่ในมาสก์ของช่องที่รองรับ
OT_ERROR_INVALID_STATE
เปิดใช้โปรโตคอลเทรดแล้ว
ดูเพิ่มเติม:
otLinkGetChannel

otLinkSetCslChannel

otError otLinkSetCslChannel(
  otInstance *aInstance,
  uint8_t aChannel
)

ตั้งค่าช่อง CSL

รายละเอียด
พารามิเตอร์
[in] aInstance
ตัวชี้ไปยังอินสแตนซ์ OpenThread
[in] aChannel
แชแนลตัวอย่าง CSL ค่าช่องควรเป็น 0 (ไม่ระบุการตั้งค่า CSL Channel) หรืออยู่ในช่วง [1, 10] (หากรองรับ 915-MHz) และ 11, 26
แสดงผลค่า
OT_ERROR_NONE
ตั้งค่าพารามิเตอร์ CSL เรียบร้อยแล้ว
OT_ERROR_INVALID_ARGS
aChannel ไม่ถูกต้อง

otLinkSetCslPeriod

otError otLinkSetCslPeriod(
  otInstance *aInstance,
  uint32_t aPeriod
)

ตั้งค่าระยะเวลา CSL เป็นไมโครวินาที

ปิดใช้ CSL โดยตั้งค่าพารามิเตอร์นี้เป็น 0

ช่วงเวลา CSL ต้องเป็นจำนวนทวีคูณของ OT_LINK_CSL_PERIOD_TEN_SYMBOLS_UNIT_IN_USEC ไม่เช่นนั้นจะแสดงผล OT_ERROR_INVALID_ARGS

รายละเอียด
พารามิเตอร์
[in] aInstance
ตัวชี้ไปยังอินสแตนซ์ OpenThread
[in] aPeriod
ระยะเวลา CSL ในหน่วยไมโครวินาที
แสดงผลค่า
OT_ERROR_NONE
ตั้งค่าระยะเวลา CSL สำเร็จแล้ว
OT_ERROR_INVALID_ARGS
ระยะเวลา CSL ไม่ถูกต้อง

otLinkSetCslTimeout

otError otLinkSetCslTimeout(
  otInstance *aInstance,
  uint32_t aTimeout
)

ตั้งค่าระยะหมดเวลา CSL เป็นวินาที

รายละเอียด
พารามิเตอร์
[in] aInstance
ตัวชี้ไปยังอินสแตนซ์ OpenThread
[in] aTimeout
ระยะหมดเวลาของ CSL เป็นวินาที
แสดงผลค่า
OT_ERROR_NONE
ตั้งค่าระยะหมดเวลาของ CSL เรียบร้อยแล้ว
OT_ERROR_INVALID_ARGS
ระยะหมดเวลา CSL ไม่ถูกต้อง

otLinkSetEnabled

otError otLinkSetEnabled(
  otInstance *aInstance,
  bool aEnable
)

เปิดหรือปิดใช้เลเยอร์ลิงก์

รายละเอียด
พารามิเตอร์
[in] aInstance
ตัวชี้ไปยังอินสแตนซ์ OpenThread
[in] aEnable
"จริง" เพื่อเปิดใช้เลเยอร์ลิงก์ หรือไม่เช่นนั้นจะเป็น "เท็จ"
แสดงผลค่า
OT_ERROR_NONE
เปิด / ปิดใช้เลเยอร์ลิงก์เรียบร้อยแล้ว
OT_ERROR_INVALID_STATE
ปิดใช้เลเยอร์ลิงก์ไม่ได้เนื่องจากเปิดใช้อินเทอร์เฟซเทรดอยู่

otLinkSetExtendedAddress

otError otLinkSetExtendedAddress(
  otInstance *aInstance,
  const otExtAddress *aExtAddress
)

ตั้งค่าที่อยู่แบบขยาย IEEE 802.15.4

รายละเอียด
พารามิเตอร์
[in] aInstance
ตัวชี้ไปยังอินสแตนซ์ OpenThread
[in] aExtAddress
ตัวชี้ไปยังที่อยู่ขยายของ IEEE 802.15.4
แสดงผลค่า
OT_ERROR_NONE
ตั้งค่าที่อยู่แบบขยาย IEEE 802.15.4 สำเร็จแล้ว
OT_ERROR_INVALID_ARGS
aExtAddress มีค่าเป็น NULL
OT_ERROR_INVALID_STATE
เปิดใช้โปรโตคอลเทรดแล้ว

otLinkSetMaxFrameRetriesDirect

void otLinkSetMaxFrameRetriesDirect(
  otInstance *aInstance,
  uint8_t aMaxFrameRetriesDirect
)

ตั้งค่าจำนวนการส่งเฟรมซ้ำสูงสุดระหว่างการส่งโดยตรง

รายละเอียด
พารามิเตอร์
[in] aInstance
ตัวชี้ไปยังอินสแตนซ์ OpenThread
[in] aMaxFrameRetriesDirect
จำนวนการดำเนินการซ้ำสูงสุดระหว่างการส่งโดยตรง

otLinkSetMaxFrameRetriesIndirect

void otLinkSetMaxFrameRetriesIndirect(
  otInstance *aInstance,
  uint8_t aMaxFrameRetriesIndirect
)

ตั้งค่าจำนวนการส่งเฟรมซ้ำสูงสุดในระหว่างการส่งโดยอ้อม

รายละเอียด
พารามิเตอร์
[in] aInstance
ตัวชี้ไปยังอินสแตนซ์ OpenThread
[in] aMaxFrameRetriesIndirect
จำนวนการดำเนินการซ้ำสูงสุดระหว่างการส่งโดยอ้อม

otLinkSetPanId

otError otLinkSetPanId(
  otInstance *aInstance,
  otPanId aPanId
)

ตั้งค่ารหัส PAN ของ IEEE 802.15.4

สำเร็จเมื่อปิดใช้โปรโตคอลเทรดเท่านั้น การเรียกใช้ฟังก์ชันนี้ที่สำเร็จจะทำให้ชุดข้อมูลการดำเนินการที่ใช้งานอยู่และที่รอดำเนินการในหน่วยความจำที่ไม่ผันผวนเป็นโมฆะด้วย

รายละเอียด
พารามิเตอร์
[in] aInstance
ตัวชี้ไปยังอินสแตนซ์ OpenThread
[in] aPanId
รหัส PAN ของ IEEE 802.15.4
แสดงผลค่า
OT_ERROR_NONE
ตั้งค่ารหัส PAN เรียบร้อยแล้ว
OT_ERROR_INVALID_ARGS
หาก aPanId ไม่อยู่ในช่วง [0, 65534]
OT_ERROR_INVALID_STATE
เปิดใช้โปรโตคอลเทรดแล้ว
ดูเพิ่มเติม:
otLinkGetPanId

otLinkSetPcapCallback

void otLinkSetPcapCallback(
  otInstance *aInstance,
  otLinkPcapCallback aPcapCallback,
  void *aCallbackContext
)

ลงทะเบียนโค้ดเรียกกลับเพื่อรับเฟรม IEEE 802.15.4 แบบ Raw ที่ได้รับ

รายละเอียด
พารามิเตอร์
[in] aInstance
ตัวชี้ไปยังอินสแตนซ์ OpenThread
[in] aPcapCallback
ตัวชี้ไปยังฟังก์ชันที่เรียกใช้เมื่อได้รับเฟรมลิงก์ IEEE 802.15.4 หรือ NULL เพื่อปิดใช้โค้ดเรียกกลับ
[in] aCallbackContext
ตัวชี้ไปยังบริบทเฉพาะแอปพลิเคชัน

otLinkSetPollPeriod

otError otLinkSetPollPeriod(
  otInstance *aInstance,
  uint32_t aPollPeriod
)

ตั้งค่า/ล้างระยะเวลาการสำรวจข้อมูลที่ระบุผู้ใช้/ภายนอกสำหรับอุปกรณ์ปลายทางที่ง่วงนอน

รายละเอียด
พารามิเตอร์
[in] aInstance
ตัวชี้ไปยังอินสแตนซ์ OpenThread
[in] aPollPeriod
ระยะเวลาการหยั่งสัญญาณข้อมูลเป็นมิลลิวินาที
แสดงผลค่า
OT_ERROR_NONE
ตั้งค่า/ล้างระยะเวลาแบบสำรวจที่ผู้ใช้ระบุเรียบร้อยแล้ว
OT_ERROR_INVALID_ARGS
หาก aPollPeriod ไม่ถูกต้อง
ดูเพิ่มเติม:
otLinkGetPollPeriod

otLinkSetPromiscuous

otError otLinkSetPromiscuous(
  otInstance *aInstance,
  bool aPromiscuous
)

เปิดหรือปิดใช้งานโหมด Promiscuous ของเลเยอร์ลิงก์

รายละเอียด
พารามิเตอร์
[in] aInstance
ตัวชี้ไปยังอินสแตนซ์ OpenThread
[in] aPromiscuous
true เพื่อเปิดใช้งานโหมด Promiscuous หรือ false หรือไม่เช่นนั้น
แสดงผลค่า
OT_ERROR_NONE
เปิดใช้โหมด Promiscuous สำเร็จแล้ว
OT_ERROR_INVALID_STATE
เปิดใช้โหมด Promiscuous ไม่ได้เนื่องจากเปิดใช้งานอินเทอร์เฟซเทรดอยู่

otLinkSetRadioFilterEnabled

void otLinkSetRadioFilterEnabled(
  otInstance *aInstance,
  bool aFilterEnabled
)

เปิด/ปิดใช้งานโหมดตัวกรองวิทยุ IEEE 802.15.4

ใช้งานได้เมื่อเปิดใช้การกำหนดค่า OPENTHREAD_CONFIG_MAC_FILTER_ENABLE

ตัวกรองวิทยุมีไว้สําหรับการทดสอบเป็นหลัก แต่สามารถใช้เพื่อบล็อก tx/rx ทั้งหมดในวิทยุ 802.15.4 เป็นการชั่วคราวได้ เมื่อเปิดใช้ตัวกรองวิทยุ สัญญาณวิทยุจะถูกทำให้เข้าสู่โหมดสลีปแทนการรับ (เพื่อให้แน่ใจว่าอุปกรณ์จะไม่ได้รับเฟรมใดๆ และ/หรือมีการส่งการรับทราบ) นอกจากนี้ คำขอการส่งเฟรมจะส่งกลับทันทีโดยไม่ส่งเฟรมผ่านอากาศ (แสดงผลข้อผิดพลาด "ไม่รับทราบ" หากมีการร้องขอ ack มิฉะนั้นส่งคืนสำเร็จ)

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

otLinkSetRegion

otError otLinkSetRegion(
  otInstance *aInstance,
  uint16_t aRegionCode
)

ตั้งรหัสภูมิภาค

รูปแบบภูมิภาคของวิทยุคือรูปแบบ 2 ไบต์ ascii ของรหัส ISO 3166 alpha-2

รายละเอียด
พารามิเตอร์
[in] aInstance
โครงสร้างอินสแตนซ์ OpenThread
[in] aRegionCode
รหัสภูมิภาคของวิทยุ aRegionCode >> 8 คืออักขระ ASCII ตัวแรกและ aRegionCode & 0xff คืออักขระ ASCII รายการที่ 2
แสดงผลค่า
OT_ERROR_FAILED
ข้อผิดพลาดเฉพาะแพลตฟอร์มอื่นๆ
OT_ERROR_NONE
ตั้งค่ารหัสภูมิภาคเรียบร้อยแล้ว
OT_ERROR_NOT_IMPLEMENTED
ไม่มีการใช้ฟีเจอร์นี้

otLinkSetSupportedChannelMask

otError otLinkSetSupportedChannelMask(
  otInstance *aInstance,
  uint32_t aChannelMask
)

ตั้งค่ามาสก์ช่องทางที่สนับสนุนของเลเยอร์ MAC

สำเร็จเมื่อปิดใช้โปรโตคอลเทรดเท่านั้น

รายละเอียด
พารามิเตอร์
[in] aInstance
ตัวชี้ไปยังอินสแตนซ์ OpenThread
[in] aChannelMask
มาสก์แชแนลที่รองรับ (การแมปบิต 0 หรือ lsb กับแชแนล 0 เป็นต้น)
แสดงผลค่า
OT_ERROR_NONE
ตั้งค่ามาสก์ของช่องที่รองรับเรียบร้อยแล้ว
OT_ERROR_INVALID_STATE
เปิดใช้โปรโตคอลเทรดแล้ว

มาโคร

 OT_LINK_CSL_PERIOD_TEN_SYMBOLS_UNIT_IN_USEC (160)

แสดงหน่วยสัญลักษณ์ระยะเวลา 10 หน่วยของ CSL ในหน่วยไมโครวินาที

ช่วงเวลา CSL (ในหน่วยไมโครวินาที) ต้องเป็นจำนวนทวีคูณของค่านี้

OT_MAC_FILTER_FIXED_RSS_DISABLED

 OT_MAC_FILTER_FIXED_RSS_DISABLED 127

ใช้เพื่อระบุว่าไม่ได้ตั้งค่าความแรงของสัญญาณที่ได้รับแบบคงที่

OT_MAC_FILTER_ITERATOR_INIT

 OT_MAC_FILTER_ITERATOR_INIT 0

Initializer สำหรับ otMacFilterIterator

OT_US_PER_TEN_SYMBOLS

 OT_US_PER_TEN_SYMBOLS OT_RADIO_TEN_SYMBOLS_TIME

เวลาสำหรับสัญลักษณ์ 10 ตัวในหน่วยไมโครวินาที

แหล่งข้อมูล

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