ارتباط دادن

این ماژول شامل توابعی است که پیکربندی لایه پیوند را کنترل می کند.

خلاصه

شمارش ها

otMacFilterAddressMode {
OT_MAC_FILTER_ADDRESS_MODE_DISABLED ,
OT_MAC_FILTER_ADDRESS_MODE_ALLOWLIST ,
OT_MAC_FILTER_ADDRESS_MODE_DENYLIST
}		 enum
حالت آدرس فیلتر مک را تعریف می کند.

Typedefs

otActiveScanResult typedef
نشان دهنده یک Beacon دریافت شده IEEE 802.15.4 است.
otEnergyScanResult typedef
یک نتیجه اسکن انرژی را نشان می دهد.
otHandleActiveScanResult )(otActiveScanResult *aResult, void *aContext) typedef
void(*
هنگامی که یک Beacon 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
شمارنده های لایه MAC را نشان می دهد.
otMacFilterAddressMode typedef
حالت آدرس فیلتر مک را تعریف می کند.
otMacFilterEntry typedef
یک ورودی فیلتر مک را نشان می دهد.
otMacFilterIterator typedef
uint8_t
برای تکرار از طریق ورودی های فیلتر مک استفاده می شود.
otThreadLinkInfo typedef
اطلاعات مربوط به پیوند را برای پیام های دریافتی از رادیو Thread نشان می دهد.

کارکرد

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)
یک آدرس Extended به فیلتر MAC اضافه می کند.
otLinkFilterAddRssIn ( otInstance *aInstance, const otExtAddress *aExtAddress, int8_t aRss)
آدرس Extended مشخص شده را به لیست RssIn اضافه می کند (یا آدرس موجود را در لیست RssIn تغییر می دهد) و ورودی سیگنال دریافتی (در dBm) را برای پیام های آن آدرس تنظیم می کند.
otLinkFilterClearAddresses ( otInstance *aInstance)
void
تمام آدرس های Extended را از فیلتر 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
یک آدرس Extended را از فیلتر MAC حذف می کند.
otLinkFilterRemoveRssIn ( otInstance *aInstance, const otExtAddress *aExtAddress)
void
آدرس Extended مشخص شده را از لیست RssIn حذف می کند.
otLinkFilterSetAddressMode ( otInstance *aInstance, otMacFilterAddressMode aMode)
void
حالت آدرس فیلتر MAC را تنظیم می کند.
otLinkFilterSetDefaultRssIn ( otInstance *aInstance, int8_t aRss)
void
قدرت سیگنال دریافتی پیش‌فرض (بر حسب dBm) را روی فیلتر MAC تنظیم می‌کند.
otLinkGetCcaFailureRate ( otInstance *aInstance)
uint16_t
نرخ خرابی فعلی CCA (ارزیابی کانال پاک) را برمی‌گرداند.
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 را دریافت می کند.
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 Extended Address را تنظیم می کند.
otLinkSetMaxFrameRetriesDirect ( otInstance *aInstance, uint8_t aMaxFrameRetriesDirect)
void
حداکثر تعداد دفعات مجدد فریم را در حین ارسال مستقیم تنظیم می کند.
otLinkSetMaxFrameRetriesIndirect ( otInstance *aInstance, uint8_t aMaxFrameRetriesIndirect)
void
حداکثر تعداد دفعات مجدد فریم را در حین ارسال غیرمستقیم تنظیم می کند.
otLinkSetPanId ( otInstance *aInstance, otPanId aPanId)
IEEE 802.15.4 PAN ID را تنظیم کنید.
otLinkSetPcapCallback ( otInstance *aInstance, otLinkPcapCallback aPcapCallback, void *aCallbackContext)
void
برای ارائه فریم های خام دریافتی IEEE 802.15.4، یک تماس برگشتی را ثبت می کند.
otLinkSetPollPeriod ( otInstance *aInstance, uint32_t aPollPeriod)
تنظیم/پاک کردن دوره نظرسنجی داده های خارجی/مشخص شده توسط کاربر برای دستگاه پایان خواب آلود.
otLinkSetPromiscuous ( otInstance *aInstance, bool aPromiscuous)
حالت غیرفعال لایه پیوند را فعال یا غیرفعال می کند.
otLinkSetRadioFilterEnabled ( otInstance *aInstance, bool aFilterEnabled)
void
حالت فیلتر رادیویی IEEE 802.15.4 را فعال/غیرفعال می کند.
otLinkSetRegion ( otInstance *aInstance, uint16_t aRegionCode)
کد منطقه را تنظیم می کند.
otLinkSetSupportedChannelMask ( otInstance *aInstance, uint32_t aChannelMask)
ماسک کانال پشتیبانی شده لایه MAC را تنظیم کنید.

سازه ها

otActiveScanResult

نشان دهنده یک Beacon دریافت شده IEEE 802.15.4 است.

otEnergyScanResult

یک نتیجه اسکن انرژی را نشان می دهد.

otMacCounters

شمارنده های لایه MAC را نشان می دهد.

otMacFilterEntry

یک ورودی فیلتر مک را نشان می دهد.

otThreadLinkInfo

اطلاعات مربوط به پیوند را برای پیام های دریافتی از رادیو Thread نشان می دهد.

شمارش ها

otMacFilterAddressMode

 otMacFilterAddressMode

حالت آدرس فیلتر مک را تعریف می کند.

خواص
OT_MAC_FILTER_ADDRESS_MODE_ALLOWLIST

حالت فیلتر آدرس لیست مجاز فعال است.

OT_MAC_FILTER_ADDRESS_MODE_DENYLIST

حالت فیلتر آدرس فهرست انکار فعال است.

OT_MAC_FILTER_ADDRESS_MODE_DISABLED

فیلتر آدرس غیرفعال است.

Typedefs

otActiveScanResult

struct otActiveScanResult otActiveScanResult

نشان دهنده یک Beacon دریافت شده IEEE 802.15.4 است.

otEnergyScanResult

struct otEnergyScanResult otEnergyScanResult

یک نتیجه اسکن انرژی را نشان می دهد.

otHandleActiveScanResult

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

هنگامی که یک Beacon 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

حالت آدرس فیلتر مک را تعریف می کند.

otMacFilterEntry

struct otMacFilterEntry otMacFilterEntry

یک ورودی فیلتر مک را نشان می دهد.

otMacFilterIterator

uint8_t otMacFilterIterator

برای تکرار از طریق ورودی های فیلتر مک استفاده می شود.

otThreadLinkInfo

struct otThreadLinkInfo otThreadLinkInfo

اطلاعات مربوط به پیوند را برای پیام های دریافتی از رادیو Thread نشان می دهد.

کارکرد

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
مقدار LinkQuality باید در محدوده [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
)

یک آدرس Extended به فیلتر 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
)

آدرس Extended مشخص شده را به لیست RssIn اضافه می کند (یا آدرس موجود را در لیست RssIn تغییر می دهد) و ورودی سیگنال دریافتی (در dBm) را برای پیام های آن آدرس تنظیم می کند.

برای تنظیم rss لزوماً نباید آدرس Extended Address در فیلتر address allowlist/denylist باشد.

زمانی در دسترس است که پیکربندی OPENTHREAD_CONFIG_MAC_FILTER_ENABLE فعال باشد.

جزئیات
مولفه های
[in] aInstance
اشاره گر به یک نمونه OpenThread.
[in] aExtAddress
اشاره گر به IEEE 802.15.4 Extended Address. نباید خالی باشد.
[in] aRss
قدرت سیگنال دریافتی (بر حسب dBm).
ارزش های بازگشتی
OT_ERROR_NONE
یک ورودی برای aExtAddress و aRss با موفقیت اضافه شد.
OT_ERROR_NO_BUFS
هیچ ورودی موجودی وجود ندارد.

otLinkFilterClearAddresses

void otLinkFilterClearAddresses(
  otInstance *aInstance
)

تمام آدرس های Extended را از فیلتر 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 تنظیم کنید. نباید خالی باشد.
[out] aEntry
اشاره گر به جایی که اطلاعات در آن قرار می گیرد. نباید خالی باشد.
ارزش های بازگشتی
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. نباید خالی باشد. برای دریافت اولین ورودی، باید روی 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
)

یک آدرس Extended را از فیلتر MAC حذف می کند.

زمانی در دسترس است که پیکربندی OPENTHREAD_CONFIG_MAC_FILTER_ENABLE فعال باشد.

اگر هیچ ورودی موجود در فیلتر مطابق با آدرس گسترده داده شده وجود نداشته باشد، هیچ اقدامی انجام نمی شود.

جزئیات
مولفه های
[in] aInstance
اشاره گر به یک نمونه OpenThread.
[in] aExtAddress
اشاره گر به آدرس توسعه یافته (نباید NULL باشد).

otLinkFilterRemoveRssIn

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

آدرس Extended مشخص شده را از لیست RssIn حذف می کند.

پس از حذف از لیست RssIn ، این آدرس MAC در عوض از تنظیمات پیش‌فرض rss و lqi استفاده می‌کند، با این فرض که پیش‌فرض‌ها تنظیم شده‌اند. (اگر هیچ پیش فرضی تنظیم نشده باشد، از سیگنال هوا استفاده می شود.)

زمانی در دسترس است که پیکربندی OPENTHREAD_CONFIG_MAC_FILTER_ENABLE فعال باشد.

اگر هیچ ورودی موجود در لیست RssIn مطابق با آدرس Extended مشخص شده وجود نداشته باشد، هیچ اقدامی انجام نمی شود.

جزئیات
مولفه های
[in] aInstance
اشاره گر به یک نمونه OpenThread.
[in] aExtAddress
اشاره گر به IEEE 802.15.4 Extended Address. نباید خالی باشد.

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 (ارزیابی کانال پاک) را برمی‌گرداند.

نرخ در یک پنجره (تقریبا) آخرین 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 را دریافت می کند.

جزئیات
مولفه های
[in] aInstance
اشاره گر به یک نمونه OpenThread.
برمی گرداند
اشاره گر به IEEE 802.15.4 Extended Address.

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 بایتی اسکی کد ISO 3166 آلفا-2 است.

جزئیات
مولفه های
[in] aInstance
ساختار نمونه OpenThread.
[out] aRegionCode
کد منطقه رادیویی aRegionCode >> 8 اول ascii char است و aRegionCode & 0xff دومین علامت ascii است.
ارزش های بازگشتی
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.
برمی گرداند
درست است اگر اسکن فعال IEEE 802.15.4 در حال انجام باشد، در غیر این صورت نادرست است.

otLinkIsCslEnabled

bool otLinkIsCslEnabled(
  otInstance *aInstance
)

نشان می دهد که آیا CSL فعال است یا خیر.

جزئیات
مولفه های
[in] aInstance
اشاره گر به یک نمونه OpenThread.
ارزش های بازگشتی
TRUE
لایه پیوند CSL فعال است.
FALSE
لایه پیوند CSL فعال نیست.

otLinkIsCsl پشتیبانی می شود

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.
برمی گرداند
درست است اگر اسکن انرژی IEEE 802.15.4 در حال انجام باشد، در غیر این صورت نادرست است.

otLinkIsInTransmitState

bool otLinkIsInTransmitState(
  otInstance *aInstance
)

نشان می دهد که آیا یک MAC IEEE 802.15.4 در حالت انتقال است یا خیر.

ماژول MAC در حین فرآیند CSMA/CA، CCA، Data، Beacon یا ارسال فریم درخواست داده و دریافت ACK یک فریم ارسالی، در حالت انتقال است. ماژول MAC در هنگام ارسال یک قاب ACK یا یک فریم Beacon Request در حالت انتقال نیست.

جزئیات
مولفه های
[in] aInstance
اشاره گر به یک نمونه OpenThread.
برمی گرداند
درست است اگر یک MAC IEEE 802.15.4 در حالت انتقال باشد، در غیر این صورت نادرست است.

otLinkIsPromiscuous

bool otLinkIsPromiscuous(
  otInstance *aInstance
)

نشان می دهد که آیا حالت promiscuous در لایه پیوند فعال است یا خیر.

جزئیات
مولفه های
[in] aInstance
اشاره گر به یک نمونه OpenThread.
ارزش های بازگشتی
TRUE
حالت غیرقانونی فعال است.
FALSE
حالت غیرقانونی فعال نیست.

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-off-when-idle نیست.
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-When-Idle نیست.
OT_ERROR_NO_BUFS
بافرهای پیام کافی موجود نیست.

otLinkSetChannel

otError otLinkSetChannel(
  otInstance *aInstance,
  uint8_t aChannel
)

کانال IEEE 802.15.4 را تنظیم کنید.

فقط زمانی موفق می شود که پروتکل های Thread غیرفعال باشند. فراخوانی موفقیت آمیز این تابع، مجموعه داده های عملیاتی فعال و معلق را در حافظه غیر فرار باطل می کند.

جزئیات
مولفه های
[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 نامشخص) یا در محدوده [1، 10] (در صورت پشتیبانی از 915 مگاهرتز) و 11، 26 باشد.
ارزش های بازگشتی
OT_ERROR_NONE
پارامترهای CSL با موفقیت تنظیم شد.
OT_ERROR_INVALID_ARGS
aChannel نامعتبر است.

otLinkSetCslPeriod

otError otLinkSetCslPeriod(
  otInstance *aInstance,
  uint32_t aPeriod
)

دوره CSL را بر حسب میکروثانیه تنظیم می کند.

با تنظیم این پارامتر روی 0 ، CSL را غیرفعال کنید.

دوره 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
true برای فعال کردن لایه پیوند یا false در غیر این صورت.
ارزش های بازگشتی
OT_ERROR_NONE
لایه پیوند با موفقیت فعال / غیرفعال شد.
OT_ERROR_INVALID_STATE
نمی‌توان لایه پیوند را غیرفعال کرد زیرا رابط Thread فعال است.

otLinkSetExtendedAddress

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

IEEE 802.15.4 Extended Address را تنظیم می کند.

جزئیات
مولفه های
[in] aInstance
اشاره گر به یک نمونه OpenThread.
[in] aExtAddress
اشاره گر به IEEE 802.15.4 Extended Address.
ارزش های بازگشتی
OT_ERROR_NONE
IEEE 802.15.4 Extended Address را با موفقیت تنظیم کرد.
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
)

IEEE 802.15.4 PAN ID را تنظیم کنید.

فقط زمانی موفق می شود که پروتکل های Thread غیرفعال باشند. فراخوانی موفقیت آمیز این تابع مجموعه داده های عملیاتی فعال و معلق را در حافظه غیر فرار نیز بی اعتبار می کند.

جزئیات
مولفه های
[in] aInstance
اشاره گر به یک نمونه OpenThread.
[in] aPanId
شناسه PAN IEEE 802.15.4.
ارزش های بازگشتی
OT_ERROR_NONE
PAN ID با موفقیت تنظیم شد.
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، یک تماس برگشتی را ثبت می کند.

جزئیات
مولفه های
[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
)

حالت غیرفعال لایه پیوند را فعال یا غیرفعال می کند.

جزئیات
مولفه های
[in] aInstance
اشاره گر به یک نمونه OpenThread.
[in] aPromiscuous
درست برای فعال کردن حالت بی‌وقفه یا false در غیر این صورت.
ارزش های بازگشتی
OT_ERROR_NONE
حالت بیجا با موفقیت فعال شد.
OT_ERROR_INVALID_STATE
نمی‌توان حالت بی‌وقفه را فعال کرد زیرا رابط Thread فعال است.

otLinkSetRadioFilterEnabled

void otLinkSetRadioFilterEnabled(
  otInstance *aInstance,
  bool aFilterEnabled
)

حالت فیلتر رادیویی IEEE 802.15.4 را فعال/غیرفعال می کند.

زمانی در دسترس است که پیکربندی OPENTHREAD_CONFIG_MAC_FILTER_ENABLE فعال باشد.

فیلتر رادیویی عمدتاً برای آزمایش در نظر گرفته شده است. می توان از آن برای مسدود کردن موقت تمام tx/rx در رادیو 802.15.4 استفاده کرد. هنگامی که فیلتر رادیویی فعال است، رادیو به جای دریافت به حالت Sleep قرار می گیرد (برای اطمینان از اینکه دستگاه هیچ فریمی دریافت نمی کند و/یا به طور بالقوه اکی ارسال نمی کند). همچنین درخواست‌های ارسال فریم بلافاصله بدون ارسال فریم از طریق هوا برمی‌گردد (در صورت درخواست ack، خطای "بدون تایید" را برگردانید، در غیر این صورت با موفقیت باز می‌گردید).

جزئیات
مولفه های
[in] aInstance
اشاره گر به یک نمونه OpenThread.
[in] aFilterEnabled
TRUE برای فعال کردن فیلتر رادیویی، FALSE برای غیرفعال کردن

otLinkSetRegion

otError otLinkSetRegion(
  otInstance *aInstance,
  uint16_t aRegionCode
)

کد منطقه را تنظیم می کند.

فرمت منطقه رادیویی نمایش 2 بایتی اسکی کد ISO 3166 آلفا-2 است.

جزئیات
مولفه های
[in] aInstance
ساختار نمونه OpenThread.
[in] aRegionCode
کد منطقه رادیویی aRegionCode >> 8 اول ascii char است و aRegionCode & 0xff دومین علامت ascii است.
ارزش های بازگشتی
OT_ERROR_FAILED
سایر خطاهای خاص پلت فرم.
OT_ERROR_NONE
کد منطقه با موفقیت تنظیم شد.
OT_ERROR_NOT_IMPLEMENTED
ویژگی اجرا نشده است.

otLinkSetSupportedChannelMask

otError otLinkSetSupportedChannelMask(
  otInstance *aInstance,
  uint32_t aChannelMask
)

ماسک کانال پشتیبانی شده لایه MAC را تنظیم کنید.

فقط زمانی موفق می شود که پروتکل های Thread غیرفعال باشند.

جزئیات
مولفه های
[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)

نشان دهنده دوره 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 نماد در واحد میکروثانیه.

منابع

موضوعات مرجع OpenThread API از کد منبع موجود در GitHub سرچشمه می گیرند. برای اطلاعات بیشتر، یا مشارکت در اسناد ما، به منابع مراجعه کنید.