קישור

המודול הזה כולל פונקציות השולטות בתצורה של שכבת הקישור.

סיכום

ספירות
otMacFilterAddressMode{
  OT_MAC_FILTER_ADDRESS_MODE_DISABLED,
  OT_MAC_FILTER_ADDRESS_MODE_ALLOWLIST,
  OT_MAC_FILTER_ADDRESS_MODE_DENYLIST
} 		טיפוסים בני מנייה (enum)
הגדרת מצב הכתובת של מסנן Mac.

ערכי דף
otActiveScanResult typedef
מייצג משׂואת רשת (beacon) של 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
מייצג מידע ספציפי לקישור עבור הודעות שהתקבלו מרדיו 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)
הוספת כתובת מורחבת למסנן 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.
otLinkGetFactoryAssignedIeeeEui64(otInstance *aInstance, otExtAddress *aEui64)
void
צריך לקבל את מכשיר IEEE EUI-64 שהוקצה על ידי היצרן.
otLinkGetMaxFrameRetriesDirect(otInstance *aInstance)
uint8_t
מחזירה את המספר המקסימלי של ניסיונות חוזרים למסגרת במהלך שידור ישיר.
otLinkGetMaxFrameRetriesIndirect(otInstance *aInstance)
uint8_t
מחזירה את המספר המקסימלי של ניסיונות חוזרים למסגרת במהלך שידור עקיף.
otLinkGetPanId(otInstance *aInstance)
קבלת מזהה IEEE 802.15.4 PAN.
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
מציין אם מצב פרוץ מופעל או לא מופעל בשכבת הקישור.
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 גולמיות שהתקבלו.
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

מייצג ערך של מסנן Mac.

otThreadLinkInfo

מייצג מידע ספציפי לקישור עבור הודעות שהתקבלו מרדיו Thread.

ספירות

otMacFilterAddressMode

 otMacFilterAddressMode

הגדרת מצב הכתובת של מסנן Mac.

תכונות
OT_MAC_FILTER_ADDRESS_MODE_ALLOWLIST

מצב הסינון של כתובות ברשימת ההיתרים מופעל.

OT_MAC_FILTER_ADDRESS_MODE_DENYLIST

מצב המסנן של רשימת הישויות שנחסמו מופעל.

OT_MAC_FILTER_ADDRESS_MODE_DISABLED

מסנן הכתובות מושבת.

ערכי דף

otActiveScanResult

struct otActiveScanResult otActiveScanResult

מייצג משׂואת רשת (beacon) של 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
מצביע חוקי לפרטי איתות Bluetooth או 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

מייצג מידע ספציפי לקישור עבור הודעות שהתקבלו מרדיו 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
מצביע לפונקציה שנקראת לאחר קבלת איתות Bluetooth או השלמת הסריקה.
[in] aCallbackContext
הפניה להקשר ספציפי לאפליקציה.
ערכים מוחזרים
OT_ERROR_NONE
אישרת את בקשת Active Scan.
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, בהנחה שברירות המחדל כבר הוגדרו. (אם לא הוגדרו ברירות מחדל, ייעשה שימוש באות המשודר).

זמינה כאשר ההגדרה של 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.

פרטים
פרמטרים
[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
)

קבלת מזהה IEEE 802.15.4 PAN.

פרטים
פרמטרים
[in] aInstance
מצביע למופע של OpenThread.
החזרות
מזהה IEEE 802.15.4 PAN.
מקורות נוספים:
otLinkSetPanId

otLinkGetPollPeriod

uint32_t otLinkGetPollPeriod(
  otInstance *aInstance
)

קבלת נתונים על תקופת סקר הנתונים במכשיר קצה ישן.

פרטים
פרמטרים
[in] aInstance
מצביע למופע של OpenThread.
החזרות
משך הזמן של סקר הנתונים במכשיר ישן באלפיות השנייה.
מקורות נוספים:
otLinkSetPollPeriod

otLinkGetRegion

otError otLinkGetRegion(
  otInstance *aInstance,
  uint16_t *aRegionCode
)

מקבלים את קוד האזור.

הפורמט של אזור הרדיו הוא ייצוג ASCII של 2 בייטים של קוד ISO 3166 alpha-2.

פרטים
פרמטרים
[in] aInstance
מבנה המכונה של OpenThread.
[out] aRegionCode
קוד האזור של הרדיו. aRegionCode >> 8 הוא צ'אר ASCII הראשון ו-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-th מציין שהחבילה נשלחה עם ניסיון חוזר N.

otLinkGetTxIndirectRetrySuccessHistogram

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

מקבלת היסטוגרמה של ניסיונות חוזרים לחבילה עקיפה יחידה עד להצלחה.

חוקית כאשר התצורה OPENthread_CONFIG_MAC_RETRY_SUCCESS_HISTOGRAM_ENABLE מופעלת.

פרטים
פרמטרים
[in] aInstance
מצביע למופע של OpenThread.
[out] aNumberOfEntries
מצביע למקום שבו ממוקם הגודל של מערך ההיסטוגרמה שהוחזר.
החזרות
מצביע להיסטוגרמה של הניסיונות החוזרים (בצורת מערך). הרכיב n-th מציין שהחבילה נשלחה עם ניסיון חוזר N.

otLinkIsActiveScanInProgress

bool otLinkIsActiveScanInProgress(
  otInstance *aInstance
)

מציין אם מתבצעת כרגע סריקה פעילה של IEEE 802.15.4.

פרטים
פרמטרים
[in] aInstance
מצביע למופע של OpenThread.
החזרות
True אם מתבצעת סריקה פעילה לפי תקן IEEE 802.15.4. אחרת, הערך false.

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. אחרת, צריך לקבל את הערך false.

otLinkIsInTransmitState

bool otLinkIsInTransmitState(
  otInstance *aInstance
)

מציין אם כתובת MAC של IEEE 802.15.4 נמצאת במצב שידור.

מודול ה-MAC נמצא במצב השידור במהלך הליך CSMA/CA, CCA, נתונים, משׂואת רשת (beacon) או בקשת נתונים במסגרת שידור, וקבלת ACK של מסגרת ששודרה. מודול ה-MAC לא נמצא במצב השידור בזמן השידור של מסגרת ACK או מסגרת של בקשת Beacon.

פרטים
פרמטרים
[in] aInstance
מצביע למופע של OpenThread.
החזרות
True אם כתובת MAC של IEEE 802.15.4 נמצאת במצב שידור. אחרת, False.

otLinkIsPromiscuous

bool otLinkIsPromiscuous(
  otInstance *aInstance
)

מציין אם מצב פרוץ מופעל או לא מופעל בשכבת הקישור.

פרטים
פרמטרים
[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
המכשיר לא במצב 'ללא פעילות'.
OT_ERROR_NO_BUFS
אין מספיק מאגרי הודעות זמינים.

otLinkSendEmptyData

otError otLinkSendEmptyData(
  otInstance *aInstance
)

המדיניות מורה למכשיר לשלוח מסגרת נתונים ריקה מסוג IEEE 802.15.4.

יש תמיכה רק במכשירים שאינם פעילים באמצעות Rx-off-time כדי לשלוח מסגרת נתונים ריקה להורה שלו. הערה: הפרמטר הזה זמין רק כשהתכונה 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.

התכונה פועלת רק כאשר הפרוטוקולים של השרשורים מושבתים. קריאה מוצלחת לפונקציה הזו מבטלת את התוקף של מערכי הנתונים התפעוליים הפעילים והממתינים בזיכרון לא תנודתי.

פרטים
פרמטרים
[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-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
TRUE כדי להפעיל את שכבת הקישור, או FALSE אם לא.
ערכים מוחזרים
OT_ERROR_NONE
שכבת הקישור הופעלה / הושבתה בהצלחה.
OT_ERROR_INVALID_STATE
לא ניתן להשבית את שכבת הקישור כי ממשק ה-Thread מופעל.

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
מזהה IEEE 802.15.4 PAN.
ערכים מוחזרים
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 גולמיות שהתקבלו.

פרטים
פרמטרים
[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
TRUE כדי לאפשר מצב פרוץ. אחרת, 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. כשמסנן רדיו מופעל, הרדיו מועבר למצב שינה במקום 'קבלה' (כדי לוודא שהמכשיר לא מקבל מסגרות ו/או יכול לשלוח את הרדיו). כמו כן, הבקשות לשידור פריימים מוחזרות באופן מיידי בלי לשלוח את המסגרת בשידור (יש להחזיר שגיאת "no ack" אם התבקשה ack, אחרת ההחזרה בהצלחה).

פרטים
פרמטרים
[in] aInstance
מצביע למופע של OpenThread.
[in] aFilterEnabled
TRUE כדי להפעיל מסנן רדיו, FALSE כדי להשבית

otLinkSetRegion

otError otLinkSetRegion(
  otInstance *aInstance,
  uint16_t aRegionCode
)

מגדיר את קוד האזור.

הפורמט של אזור הרדיו הוא ייצוג ASCII של 2 בייטים של קוד ISO 3166 alpha-2.

פרטים
פרמטרים
[in] aInstance
מבנה המכונה של OpenThread.
[in] aRegionCode
קוד האזור של הרדיו. aRegionCode >> 8 הוא צ'אר ASCII הראשון ו-aRegionCode & 0xff הוא צ'אר ASCII השני.
ערכים מוחזרים
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)

מייצג את יחידת הסמלים של תקופת 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

מאתחל ל-otMacFilterIterator.

OT_US_PER_TEN_SYMBOLS

 OT_US_PER_TEN_SYMBOLS OT_RADIO_TEN_SYMBOLS_TIME

זמן ל-10 סמלים ביחידות של מיליוניות השנייה.

מקורות מידע

המקור של נושאי העזר של OpenThread API הוא קוד המקור, שזמין ב-GitHub. אפשר לקרוא מידע נוסף או לתרום למסמכי התיעוד שלנו בדף מקורות מידע.