קישור
המודול הזה כולל פונקציות ששולטות בתצורה של שכבות הקישור.
סיכום
מספור |
|
---|---|
otMacFilterAddressMode{
|
טיפוסים בני מנייה (enum) מגדיר את מצב הכתובת של מסנן mac. |
סוג Dedef |
|
---|---|
otActiveScanResult
|
Typedefstruct otActiveScanResult
המבנה הזה מייצג חיישן IEEE 802.15.4 שהתקבל. |
otEnergyScanResult
|
Typedefstruct otEnergyScanResult
מבנה זה מייצג תוצאה של סריקת אנרגיה. |
otHandleActiveScanResult)(otActiveScanResult *aResult, void *aContext)
|
Typedefvoid(*
מצביע הפונקציה הזה נקרא במהלך IEEE 802.15.4 לסריקה פעילה כאשר מתקבל חיישן IEEE 802.15.4 או כשהסריקה מסתיימת. |
otHandleEnergyScanResult)(otEnergyScanResult *aResult, void *aContext)
|
Typedefvoid(*
מצביע הפונקציה הזה נקרא במהלך סריקת אנרגיה של IEEE 802.15.4 כאשר התוצאה עבור הערוץ מוכנה או שהסריקה מסתיימת. |
otLinkPcapCallback)(const otRadioFrame *aFrame, bool aIsTx, void *aContext)
|
Typedefvoid(*
מצביע הפונקציה הזה נקרא כאשר מתקבלת מסגרת IEEE 802.15.4. |
otMacCounters
|
Typedefstruct otMacCounters
מבנה זה מייצג את המונים של שכבות ה-MAC. |
otMacFilterAddressMode
|
Typedef מגדיר את מצב הכתובת של מסנן mac. |
otMacFilterEntry
|
Typedefstruct otMacFilterEntry
מבנה זה מייצג ערך של מסנן Mac. |
otMacFilterIterator
|
Typedefuint8_t
משמש איטרציה באמצעות רשומות מסנן של mac. |
otThreadLinkInfo
|
Typedefstruct otThreadLinkInfo
המבנה הזה מייצג מידע ספציפי לקישור של הודעות שהתקבלו מרדיו 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
השיטה הזו ממירה את עוצמת האות המתקבלת לאיכות הקישור.
|
otLinkCslGetChannel(otInstance *aInstance)
|
uint8_t
פונקציה זו מקבלת את ערוץ CSL.
|
otLinkCslGetPeriod(otInstance *aInstance)
|
uint16_t
פונקציה זו מקבלת את התקופה של CSL.
|
otLinkCslGetTimeout(otInstance *aInstance)
|
uint32_t
פונקציה זו מקבלת את הזמן הקצוב לתפוגה של CSL.
|
otLinkCslSetChannel(otInstance *aInstance, uint8_t aChannel)
|
פונקציה זו מגדירה את ערוץ ה-CSL.
|
otLinkCslSetPeriod(otInstance *aInstance, uint16_t aPeriod)
|
פונקציה זו מגדירה את תקופת ה-CSL.
|
otLinkCslSetTimeout(otInstance *aInstance, uint32_t aTimeout)
|
פונקציה זו מגדירה את הזמן הקצוב לתפוגה של CSL.
|
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)
|
השיטה הזו מוסיפה חוזק אות קבוע (ב-dBm) של ההודעות מכתובת מורחבת נתונה במסנן ה-MAC.
|
otLinkFilterClearAddresses(otInstance *aInstance)
|
void
השיטה הזו מנקה את כל הכתובות המורחבות ממסנן ה-MAC.
|
otLinkFilterClearAllRssIn(otInstance *aInstance)
|
void
השיטה הזו מנקה את כל רשומות חוזק האות שהתקבלו (כולל ברירת מחדל עבור RSS-in) במסנן MAC.
|
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
השיטה הזו מסירה את הערך של מסנן MAC עבור הגדרת חוזק אות קבועה עבור כתובת מורחבת נתונה.
|
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.
|
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
קבלת פרק הזמן של סקר הנתונים לגבי מכשיר סיום ישנוני.
|
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 מתבצעת כעת.
|
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.
|
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
פונקציה זו רושמת קריאה חוזרת (callback) כדי לספק מסגרות RAW 802.15.4 גולמיות שהתקבלו.
|
otLinkSetPollPeriod(otInstance *aInstance, uint32_t aPollPeriod)
|
הגדרה/ניקוי של תקופת סקר נתונים שצוינה על ידי המשתמש/חיצוני במכשיר סיום ישנוני.
|
otLinkSetPromiscuous(otInstance *aInstance, bool aPromiscuous)
|
פונקציה זו מפעילה או משביתה את מצב החלום בשכבת הקישור.
|
otLinkSetRadioFilterEnabled(otInstance *aInstance, bool aFilterEnabled)
|
void
פונקציה זו מפעילה או משביתה את מצב מסנן הרדיו IEEE 802.15.4.
|
otLinkSetSupportedChannelMask(otInstance *aInstance, uint32_t aChannelMask)
|
יש להגדיר את מסיכת הערוץ הנתמכת של שכבת MAC.
|
מבנים |
|
---|---|
otActiveScanResult |
המבנה הזה מייצג חיישן IEEE 802.15.4 שהתקבל. |
otEnergyScanResult |
מבנה זה מייצג תוצאה של סריקת אנרגיה. |
otMacCounters |
מבנה זה מייצג את המונים של שכבות ה-MAC. |
otMacFiltersEntry |
מבנה זה מייצג ערך של מסנן Mac. |
otThreadLinkInfo |
המבנה הזה מייצג מידע ספציפי לקישור של הודעות שהתקבלו מרדיו Thread. |
מספור
מצב otMacFiltersAddressMode
otMacFilterAddressMode
מגדיר את מצב הכתובת של מסנן mac.
מאפיינים | |
---|---|
OT_MAC_FILTER_ADDRESS_MODE_ALLOWLIST
|
מצב סינון הכתובות של רשימת ההיתרים מופעל. |
OT_MAC_FILTER_ADDRESS_MODE_DENYLIST
|
מצב סינון הכתובות של רשימת הדחייה מופעל. |
OT_MAC_FILTER_ADDRESS_MODE_DISABLED
|
מסנן הכתובות מושבת. |
סוג Dedef
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 או כשהסריקה מסתיימת.
פרטים | |||||
---|---|---|---|---|---|
פרמטרים |
|
otHandleEnergyScanResult
void(* otHandleEnergyScanResult)(otEnergyScanResult *aResult, void *aContext)
מצביע הפונקציה הזה נקרא במהלך סריקת אנרגיה של IEEE 802.15.4 כאשר התוצאה עבור הערוץ מוכנה או שהסריקה מסתיימת.
פרטים | |||||
---|---|---|---|---|---|
פרמטרים |
|
otLinkPcapCallback
void(* otLinkPcapCallback)(const otRadioFrame *aFrame, bool aIsTx, void *aContext)
מצביע הפונקציה הזה נקרא כאשר מתקבלת מסגרת IEEE 802.15.4.
פרטים | |||||||
---|---|---|---|---|---|---|---|
פרמטרים |
|
מצב otMacFiltersAddressMode
enum otMacFilterAddressMode otMacFilterAddressMode
מגדיר את מצב הכתובת של מסנן mac.
otMacFiltersIterator
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.
פרטים | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
פרמטרים |
|
||||||||||
ערכי החזרה |
|
otLinkConvertLinkאיכותToRs
int8_t otLinkConvertLinkQualityToRss( otInstance *aInstance, uint8_t aLinkQuality )
השיטה הזו ממירה את איכות הקישור לחוזק אות רגיל שמתקבל.
פרטים | |||||
---|---|---|---|---|---|
פרמטרים |
|
||||
החזרות |
פלטפורמה אופיינית קיבלה מיפוי של חוזק אות ל-
aLinkQuality . |
otLinkConvertRssToLinkאיכות
uint8_t otLinkConvertRssToLinkQuality( otInstance *aInstance, int8_t aRss )
השיטה הזו ממירה את עוצמת האות המתקבלת לאיכות הקישור.
פרטים | |||||
---|---|---|---|---|---|
פרמטרים |
|
||||
החזרות |
קישור של מיפוי ערך האיכות אל
aRss . |
otLinkCslGetChannel
uint8_t otLinkCslGetChannel( otInstance *aInstance )
פונקציה זו מקבלת את ערוץ CSL.
פרטים | |||
---|---|---|---|
פרמטרים |
|
||
החזרות |
ערוץ CSL.
|
otLinkCslGetperiod
uint16_t otLinkCslGetPeriod( otInstance *aInstance )
פונקציה זו מקבלת את התקופה של CSL.
פרטים | |||
---|---|---|---|
פרמטרים |
|
||
החזרות |
תקופה של CSL ביחידות של 10 סמלים.
|
otLinkCslGetTimeout
uint32_t otLinkCslGetTimeout( otInstance *aInstance )
פונקציה זו מקבלת את הזמן הקצוב לתפוגה של CSL.
פרטים | |||
---|---|---|---|
פרמטרים |
|
||
החזרות |
הזמן הקצוב לתפוגה של CSL, בשניות.
|
otLinkCslSetChannel
otError otLinkCslSetChannel( otInstance *aInstance, uint8_t aChannel )
פונקציה זו מגדירה את ערוץ ה-CSL.
פרטים | |||||
---|---|---|---|---|---|
פרמטרים |
|
||||
ערכי החזרה |
|
otLinkCslSetperiod
otError otLinkCslSetPeriod( otInstance *aInstance, uint16_t aPeriod )
פונקציה זו מגדירה את תקופת ה-CSL.
פרטים | |||||
---|---|---|---|---|---|
פרמטרים |
|
||||
ערכי החזרה |
|
otLinkCslSetTimeout
otError otLinkCslSetTimeout( otInstance *aInstance, uint32_t aTimeout )
פונקציה זו מגדירה את הזמן הקצוב לתפוגה של CSL.
פרטים | |||||
---|---|---|---|---|---|
פרמטרים |
|
||||
ערכי החזרה |
|
otLinkEnergyScan
otError otLinkEnergyScan( otInstance *aInstance, uint32_t aScanChannels, uint16_t aScanDuration, otHandleEnergyScanResult aCallback, void *aCallbackContext )
פונקציה זו מתחילה בסריקת אנרגיה מסוג IEEE 802.15.4.
פרטים | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
פרמטרים |
|
||||||||||
ערכי החזרה |
|
otLinkFiltersAddAddress
otError otLinkFilterAddAddress( otInstance *aInstance, const otExtAddress *aExtAddress )
שיטה זו מוסיפה למסנן MAC כתובת מורחבת.
פונקציה זו זמינה כשההגדרה Openthread_CONFIG_MAC_FILTER_ENABLE מופעלת.
פרטים | |||||
---|---|---|---|---|---|
פרמטרים |
|
||||
ערכי החזרה |
|
otLinkמסנןAddRssIn
otError otLinkFilterAddRssIn( otInstance *aInstance, const otExtAddress *aExtAddress, int8_t aRss )
השיטה הזו מוסיפה חוזק אות קבוע (ב-dBm) של ההודעות מכתובת מורחבת נתונה במסנן ה-MAC.
פונקציה זו זמינה כשההגדרה Openthread_CONFIG_MAC_FILTER_ENABLE מופעלת.
פרטים | |||||||
---|---|---|---|---|---|---|---|
פרמטרים |
|
||||||
ערכי החזרה |
|
otLinkFilterClearUrls
void otLinkFilterClearAddresses( otInstance *aInstance )
השיטה הזו מנקה את כל הכתובות המורחבות ממסנן ה-MAC.
פונקציה זו זמינה כשההגדרה Openthread_CONFIG_MAC_FILTER_ENABLE מופעלת.
פרטים | |||
---|---|---|---|
פרמטרים |
|
otLinkFilterClearAllRssIn
void otLinkFilterClearAllRssIn( otInstance *aInstance )
השיטה הזו מנקה את כל רשומות חוזק האות שהתקבלו (כולל ברירת מחדל עבור RSS-in) במסנן MAC.
פונקציה זו זמינה כשההגדרה Openthread_CONFIG_MAC_FILTER_ENABLE מופעלת.
פרטים | |||
---|---|---|---|
פרמטרים |
|
otLinkFilterClearDefaultRssIn
void otLinkFilterClearDefaultRssIn( otInstance *aInstance )
השיטה הזו מנקה כל עוצמת אות שהוגדרה כברירת מחדל (ב-dBm) במסנן MAC.
פונקציה זו זמינה כשההגדרה Openthread_CONFIG_MAC_FILTER_ENABLE מופעלת.
פרטים | |||
---|---|---|---|
פרמטרים |
|
otLinkFilterGetAddressMode
otMacFilterAddressMode otLinkFilterGetAddressMode( otInstance *aInstance )
פונקציה זו מקבלת את מצב הכתובת של מסנן MAC.
פונקציה זו זמינה כשההגדרה Openthread_CONFIG_MAC_FILTER_ENABLE מופעלת.
פרטים | |||
---|---|---|---|
פרמטרים |
|
||
החזרות |
מצב הכתובת.
|
otLinkFiltersGetNextAddress
otError otLinkFilterGetNextAddress( otInstance *aInstance, otMacFilterIterator *aIterator, otMacFilterEntry *aEntry )
השיטה הזו מקבלת רשומה של מסנן כתובות בשימוש.
פונקציה זו זמינה כשההגדרה Openthread_CONFIG_MAC_FILTER_ENABLE מופעלת.
פרטים | |||||||
---|---|---|---|---|---|---|---|
פרמטרים |
|
||||||
ערכי החזרה |
|
otLinkFiltersGetNextRssIn
otError otLinkFilterGetNextRssIn( otInstance *aInstance, otMacFilterIterator *aIterator, otMacFilterEntry *aEntry )
השיטה הזו מקבלת ערך של מסנן RssIn שנמצא בשימוש.
פונקציה זו זמינה כשההגדרה Openthread_CONFIG_MAC_FILTER_ENABLE מופעלת.
פרטים | |||||||
---|---|---|---|---|---|---|---|
פרמטרים |
|
||||||
ערכי החזרה |
|
otLinkFiltersRemoveAddress
void otLinkFilterRemoveAddress( otInstance *aInstance, const otExtAddress *aExtAddress )
שיטה זו מסירה כתובת מורחבת ממסנן MAC.
פונקציה זו זמינה כשההגדרה Openthread_CONFIG_MAC_FILTER_ENABLE מופעלת.
לא תתבצע פעולה אם אין רשומה קיימת במסנן התואמות לכתובת המורחבת הנתונה.
פרטים | |||||
---|---|---|---|---|---|
פרמטרים |
|
otLinkמסנןRemoveRssIn
void otLinkFilterRemoveRssIn( otInstance *aInstance, const otExtAddress *aExtAddress )
השיטה הזו מסירה את הערך של מסנן MAC עבור הגדרת חוזק אות קבועה עבור כתובת מורחבת נתונה.
פונקציה זו זמינה כשההגדרה Openthread_CONFIG_MAC_FILTER_ENABLE מופעלת.
לא תתבצע פעולה אם אין רשומה קיימת במסנן התואמות לכתובת המורחבת הנתונה.
פרטים | |||||
---|---|---|---|---|---|
פרמטרים |
|
otLinkמסנןSetModeמצב
void otLinkFilterSetAddressMode( otInstance *aInstance, otMacFilterAddressMode aMode )
פונקציה זו מגדירה את מצב הכתובת של מסנן MAC.
פונקציה זו זמינה כשההגדרה Openthread_CONFIG_MAC_FILTER_ENABLE מופעלת.
פרטים | |||||
---|---|---|---|---|---|
פרמטרים |
|
otLinkFiltersSetDefaultRssIn
void otLinkFilterSetDefaultRssIn( otInstance *aInstance, int8_t aRss )
השיטה הזו מגדירה את עוצמת האות המוגדרת כברירת מחדל (ב-dBm) במסנן MAC.
פונקציה זו זמינה כשההגדרה Openthread_CONFIG_MAC_FILTER_ENABLE מופעלת.
ערך ה-RSS המוגדר כברירת מחדל משמש לכל המסגרות שהתקבלו מכתובות שאין בהן ערך RSS-in מפורש ברשימת הסינון (נוסף באמצעות otLinkFilterAddRssIn()
).
פרטים | |||||
---|---|---|---|---|---|
פרמטרים |
|
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.
פרטים | |||
---|---|---|---|
פרמטרים |
|
||
החזרות |
ערוץ IEEE 802.15.4.
|
otLinkSetChannel
otLinkGetCounters
const otMacCounters * otLinkGetCounters( otInstance *aInstance )
קבלת המונים של שכבות MAC.
פרטים | |||
---|---|---|---|
פרמטרים |
|
||
החזרות |
מצביעים למונים של שכבות MAC.
|
otLinkGetExtendedAddress
const otExtAddress * otLinkGetExtendedAddress( otInstance *aInstance )
קבלת הכתובת המורחבת של IEEE 802.15.4.
פרטים | |||
---|---|---|---|
פרמטרים |
|
||
החזרות |
מצביע לכתובת IEEE 802.15.4 המורחבת.
|
otLinkGetGetassignassigniIeeeEui64
void otLinkGetFactoryAssignedIeeeEui64( otInstance *aInstance, otExtAddress *aEui64 )
לקבלת ה-IEEE EUI-64 שהוקצה על ידי המפעל.
פרטים | |||||
---|---|---|---|---|---|
פרמטרים |
|
otLinkGetMaxFrameRetriesDirect
uint8_t otLinkGetMaxFrameRetriesDirect( otInstance *aInstance )
שיטה זו מחזירה את המספר המקסימלי של ניסיונות חוזרים של פריימים במהלך שידור ישיר.
פרטים | |||
---|---|---|---|
פרמטרים |
|
||
החזרות |
המספר המקסימלי של ניסיונות חוזרים במהלך שידור ישיר.
|
otLinkGetMaxFrameRetriesIndirect
uint8_t otLinkGetMaxFrameRetriesIndirect( otInstance *aInstance )
שיטה זו מחזירה את המספר המקסימלי של ניסיונות חוזרים של פריימים במהלך העברה עקיפה.
פרטים | |||
---|---|---|---|
פרמטרים |
|
||
החזרות |
המספר המקסימלי של ניסיונות חוזרים במהלך שידור עקיף.
|
otLinkGetPanId
otPanId otLinkGetPanId( otInstance *aInstance )
קבלת מזהה ה-PAN של IEEE 802.15.4.
פרטים | |||
---|---|---|---|
פרמטרים |
|
||
החזרות |
מזהה IPAN 802.15.4.
|
otLinkSetPanId
otLinkGetPollperiod
uint32_t otLinkGetPollPeriod( otInstance *aInstance )
קבלת פרק הזמן של סקר הנתונים לגבי מכשיר סיום ישנוני.
פרטים | |||
---|---|---|---|
פרמטרים |
|
||
החזרות |
משך הזמן של סקר נתוני מכשיר באלפיות שנייה של מכשיר סיום.
|
otLinkSetPollperiod
otLinkGetShortAddress
otShortAddress otLinkGetShortAddress( otInstance *aInstance )
קבלת הכתובת הקצרה של IEEE 802.15.4.
פרטים | |||
---|---|---|---|
פרמטרים |
|
||
החזרות |
מצביע אל הכתובת הקצרה של IEEE 802.15.4.
|
otLinkGetSupportChannelMask
uint32_t otLinkGetSupportedChannelMask( otInstance *aInstance )
ניתן לקבל את מסיכת הערוץ הנתמכת של שכבת MAC.
פרטים | |||
---|---|---|---|
פרמטרים |
|
||
החזרות |
מסיכת הערוץ הנתמכת בתור
uint32_t עם סיב 0 (lsb) ממופה לערוץ 0, ביט 1 לערוץ 1, וכן הלאה. |
otLinkGetTxDirectDirect successfulHistogram
const uint32_t * otLinkGetTxDirectRetrySuccessHistogram( otInstance *aInstance, uint8_t *aNumberOfEntries )
השיטה הזו מקבלת היסטוגרמה של ניסיון חוזר בחבילה ישירה אחת עד להצלחה.
פונקציה זו חוקית כאשר ההגדרה Openthread_CONFIG_MAC_RETRY_SUCCESS_HISTOGRAM_ENABLE מופעלת.
פרטים | |||||
---|---|---|---|---|---|
פרמטרים |
|
||||
החזרות |
מצביע על ההיסטוגרמה בניסיונות חוזרים (במערך.) הרכיב ה-n מראה שהחבילה נשלחה עם ניסיון חוזר מסוג n.
|
otLinkGetTxIndirectcontinueHiHistogram
const uint32_t * otLinkGetTxIndirectRetrySuccessHistogram( otInstance *aInstance, uint8_t *aNumberOfEntries )
השיטה הזו מקבלת היסטוגרמה של ניסיון חוזר בחבילה עקיפה אחת עד להצלחה.
פונקציה זו חוקית כאשר ההגדרה Openthread_CONFIG_MAC_RETRY_SUCCESS_HISTOGRAM_ENABLE מופעלת.
פרטים | |||||
---|---|---|---|---|---|
פרמטרים |
|
||||
החזרות |
מצביע על ההיסטוגרמה בניסיונות חוזרים (במערך.) הרכיב ה-n מראה שהחבילה נשלחה עם ניסיון חוזר מסוג n.
|
otLinkIsActiveScanInProgress
bool otLinkIsActiveScanInProgress( otInstance *aInstance )
פונקציה זו מציינת אם סריקה פעילה של IEEE 802.15.4 מתבצעת כעת.
פרטים | |||
---|---|---|---|
פרמטרים |
|
||
החזרות |
הערך True אם מתבצעת סריקה פעילה של IEEE 802.15.4, אחרת הערך יהיה false.
|
otLinkIsEnabled
bool otLinkIsEnabled( otInstance *aInstance )
פונקציה זו מציינת אם שכבת הקישור מופעלת.
פרטים | |||||
---|---|---|---|---|---|
פרמטרים |
|
||||
ערכי החזרה |
|
otLinkIsEnergyScanInProgress
bool otLinkIsEnergyScanInProgress( otInstance *aInstance )
פונקציה זו מציינת אם סריקת אנרגיה IEEE 802.15.4 מתבצעת כעת.
פרטים | |||
---|---|---|---|
פרמטרים |
|
||
החזרות |
הערך True אם מתבצעת סריקת אנרגיה IEEE 802.15.4, אחרת הערך False.
|
otLinkIsInTransmitState
bool otLinkIsInTransmitState( otInstance *aInstance )
פונקציה זו מציינת אם כתובת ה-MAC של IEEE 802.15.4 נמצאת במצב שידור.
מודול ה-MAC נמצא במצב שידור במהלך הליך CSMA/CA, CCA, Data, conacon או העברת נתונים ב'בקשת נתונים' וקבלת ACK של מסגרת משודרת. מודול ה-MAC לא נמצא במצב שידור במהלך העברה של מסגרת ACK או מסגרת של בקשת חיישן.
פרטים | |||
---|---|---|---|
פרמטרים |
|
||
החזרות |
הערך True אם כתובת ה-MAC של IEEE 802.15.4 היא במצב שידור, אחרת הערך false.
|
otLinkIsPromiuous
bool otLinkIsPromiscuous( otInstance *aInstance )
פונקציה זו מציינת אם מצב הקישור מופעל בשכבת הקישור.
פרטים | |||||
---|---|---|---|---|---|
פרמטרים |
|
||||
ערכי החזרה |
|
otLinkIsRadioFiltersEnabled
bool otLinkIsRadioFilterEnabled( otInstance *aInstance )
פונקציה זו מציינת אם מסנן הרדיו IEEE 802.15.4 מופעל או לא.
פונקציה זו זמינה כשההגדרה Openthread_CONFIG_MAC_FILTER_ENABLE מופעלת.
פרטים | |||||
---|---|---|---|---|---|
ערכי החזרה |
|
otLinkresetCounters
void otLinkResetCounters( otInstance *aInstance )
איפוס המונים של שכבות ה-MAC.
פרטים | |||
---|---|---|---|
פרמטרים |
|
otLinkresetTxTry successfulHistogram
void otLinkResetTxRetrySuccessHistogram( otInstance *aInstance )
שיטה זו מנקה את הנתונים הסטטיסטיים של ההיסטוגרמה עבור שידורים ישירים ועקיף.
פונקציה זו חוקית כאשר ההגדרה Openthread_CONFIG_MAC_RETRY_SUCCESS_HISTOGRAM_ENABLE מופעלת.
פרטים | |||
---|---|---|---|
פרמטרים |
|
otLinkSendDataRequest
otError otLinkSendDataRequest( otInstance *aInstance )
הפונקציה הזו מוסיפה הודעה IEEE 802.15.4 לבקשת הנתונים לגבי שידור.
פרטים | |||||||
---|---|---|---|---|---|---|---|
פרמטרים |
|
||||||
ערכי החזרה |
|
otLinkSendEmptyData
otError otLinkSendEmptyData( otInstance *aInstance )
פונקציה זו מורה למכשיר לשלוח מסגרת נתונים ריקה של IEEE 802.15.4.
הפונקציה הזו נתמכת רק במכשיר Rx-Off-Id-Idle כדי לשלוח מסגרת נתונים ריקה להורה. הערה: זמינה רק כשהמדיניות OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE
מופעלת.
פרטים | |||||||
---|---|---|---|---|---|---|---|
פרמטרים |
|
||||||
ערכי החזרה |
|
otLinkSetChannel
otError otLinkSetChannel( otInstance *aInstance, uint8_t aChannel )
מגדירים את הערוץ IEEE 802.15.4.
הפונקציה הזו פועלת רק כאשר הפרוטוקולים מושבתים. קריאה מוצלחת לפונקציה הזו מבטלת את התוקף של מערכי הנתונים התפעוליים הפעילים והבהמתנה בזיכרון שאינו תנודתי.
פרטים | |||||||
---|---|---|---|---|---|---|---|
פרמטרים |
|
||||||
ערכי החזרה |
|
otLinkGetChannel
otLinkSetEnabled
otError otLinkSetEnabled( otInstance *aInstance, bool aEnable )
פונקציה זו מפעילה או משביתה את שכבת הקישור.
פרטים | |||||
---|---|---|---|---|---|
פרמטרים |
|
||||
ערכי החזרה |
|
otLinkSetExtendedAddress
otError otLinkSetExtendedAddress( otInstance *aInstance, const otExtAddress *aExtAddress )
פונקציה זו מגדירה את הכתובת המורחבת של IEEE 802.15.4.
הפונקציה הזו פועלת רק כאשר הפרוטוקולים מושבתים.
פרטים | |||||||
---|---|---|---|---|---|---|---|
פרמטרים |
|
||||||
ערכי החזרה |
|
otLinkSetMaxFrameRetriesDirect
void otLinkSetMaxFrameRetriesDirect( otInstance *aInstance, uint8_t aMaxFrameRetriesDirect )
בשיטה הזו מוגדר המספר המקסימלי של ניסיונות חוזרים של פריימים במהלך שידור ישיר.
פרטים | |||||
---|---|---|---|---|---|
פרמטרים |
|
otLinkSetMaxFrameRetriesIndirect
void otLinkSetMaxFrameRetriesIndirect( otInstance *aInstance, uint8_t aMaxFrameRetriesIndirect )
בשיטה זו מוגדר המספר המקסימלי של ניסיונות חוזרים של פריימים במהלך העברה עקיפה.
פרטים | |||||
---|---|---|---|---|---|
פרמטרים |
|
otLinkSetPanId
otError otLinkSetPanId( otInstance *aInstance, otPanId aPanId )
יש להגדיר את מזהה ה-PAN של IEEE 802.15.4.
הפונקציה הזו פועלת רק כאשר הפרוטוקולים מושבתים. קריאה מוצלחת לפונקציה הזו מבטלת גם את התוקף של מערכי הנתונים התפעוליים הפעילים והבהמתנה בזיכרון שאינו תנודתי.
פרטים | |||||||
---|---|---|---|---|---|---|---|
פרמטרים |
|
||||||
ערכי החזרה |
|
otLinkGetPanId
otLinkSetPcapCallback
void otLinkSetPcapCallback( otInstance *aInstance, otLinkPcapCallback aPcapCallback, void *aCallbackContext )
פונקציה זו רושמת קריאה חוזרת (callback) כדי לספק מסגרות RAW 802.15.4 גולמיות שהתקבלו.
פרטים | |||||||
---|---|---|---|---|---|---|---|
פרמטרים |
|
otLinkSetPollperiod
otError otLinkSetPollPeriod( otInstance *aInstance, uint32_t aPollPeriod )
הגדרה/ניקוי של תקופת סקר נתונים שצוינה על ידי המשתמש/חיצוני במכשיר סיום ישנוני.
פרטים | |||||
---|---|---|---|---|---|
פרמטרים |
|
||||
ערכי החזרה |
|
otLinkGetPollperiod
otLinkSetPromiuous
otError otLinkSetPromiscuous( otInstance *aInstance, bool aPromiscuous )
פונקציה זו מפעילה או משביתה את מצב החלום בשכבת הקישור.
פרטים | |||||
---|---|---|---|---|---|
פרמטרים |
|
||||
ערכי החזרה |
|
otLinkSetRadioFiltersמופעל
void otLinkSetRadioFilterEnabled( otInstance *aInstance, bool aFilterEnabled )
פונקציה זו מפעילה או משביתה את מצב מסנן הרדיו IEEE 802.15.4.
פונקציה זו זמינה כשההגדרה Openthread_CONFIG_MAC_FILTER_ENABLE מופעלת.
מסנן הרדיו מיועד בעיקר לבדיקה. ניתן להשתמש בו כדי לחסום באופן זמני את כל ה-tx/rx ברדיו 802.15.4. כשמסנן הרדיו מופעל, הרדיו מועבר למצב שינה במקום לקבל (כדי לוודא שהמכשיר לא מקבל פריימים ו/או יכול לשלוח שק). בנוסף, בקשות שידור המסגרת חוזרות מיד מבלי לשלוח את הפריים מעל האוויר (return "no ack" שגיאה אם מתבקשים לקבל שקית, אחרת מוחזרות הצלחה).
פרטים | |||||
---|---|---|---|---|---|
פרמטרים |
|
otLinkSetChannelChannelMask
otError otLinkSetSupportedChannelMask( otInstance *aInstance, uint32_t aChannelMask )
יש להגדיר את מסיכת הערוץ הנתמכת של שכבת MAC.
הפונקציה הזו פועלת רק כאשר הפרוטוקולים מושבתים.
פרטים | |||||
---|---|---|---|---|---|
פרמטרים |
|
||||
ערכי החזרה |
|
פקודות מאקרו
OT_MAC_FILTER_FIXED_RSS_DISABLED
OT_MAC_FILTER_FIXED_RSS_DISABLED 127
משמש לציין שלא הוגדרה חוזק אות קבוע.
OT_MAC_FILTER_ITERATOR_INIT
OT_MAC_FILTER_ITERATOR_INIT 0
אתחול עבור otMacFiltersIterator.
OT_US_PER_TEN_SYMBOLS
OT_US_PER_TEN_SYMBOLS 160
המיקרו-שניות לכל 10 סמלים.
משאבים
נושאי עזר של OpenThread API מגיעים מקוד המקור, שזמין ב-GitHub. למידע נוסף או כדי להוסיף מידע למסמכים שלנו, יש לעיין במשאבים.