הפעלת רדיו
מודול זה כולל את ההפשטה של פלטפורמות רדיו.
סיכום
פונקציות |
|
---|---|
otPlatDiagRadioReceiveDone(otInstance *aInstance, otRadioFrame *aFrame, otError aError)
|
void
נהג הרדיו קורא לשיטה הזו כדי ליידע את מודול האבחון של OpenThread לגבי מסגרת שהתקבלה.
|
otPlatDiagRadioTransmitDone(otInstance *aInstance, otRadioFrame *aFrame, otError aError)
|
void
נהג הרדיו קורא לשיטה הזו כדי להודיע למודול האבחון של OpenThread שההעברה הסתיימה.
|
otPlatRadioAddSrcMatchExtEntry(otInstance *aInstance, const otExtAddress *aExtAddress)
|
מוסיפים כתובת מורחבת לטבלת ההתאמות של כתובות המקור.
|
otPlatRadioAddSrcMatchShortEntry(otInstance *aInstance, otShortAddress aShortAddress)
|
מוסיפים כתובת קצרה לטבלת ההתאמה של כתובות המקור.
|
otPlatRadioClearSrcMatchExtEntries(otInstance *aInstance)
|
void
ניקוי כל הכתובות המורחבות/הארוכות מטבלת ההתאמה של כתובת המקור.
|
otPlatRadioClearSrcMatchExtEntry(otInstance *aInstance, const otExtAddress *aExtAddress)
|
מסירים כתובת מורחבת מטבלת ההתאמה של כתובת המקור.
|
otPlatRadioClearSrcMatchShortEntries(otInstance *aInstance)
|
void
ניקוי כל הכתובות הקצרות מטבלת ההתאמה של כתובת המקור.
|
otPlatRadioClearSrcMatchShortEntry(otInstance *aInstance, otShortAddress aShortAddress)
|
הסרת כתובת קצרה מטבלת ההתאמה של כתובת המקור.
|
otPlatRadioConfigureEnhAckProbing(otInstance *aInstance, otLinkMetrics aLinkMetrics, otShortAddress aShortAddress, const otExtAddress *aExtAddress)
|
הפעלה/השבתה או עדכון של בדיקה מבוססת-AC ברדיו עבור מאתחל ספציפי.
|
otPlatRadioDisable(otInstance *aInstance)
|
להשבית את הרדיו.
|
otPlatRadioEnable(otInstance *aInstance)
|
מפעילים את הרדיו.
|
otPlatRadioEnableCsl(otInstance *aInstance, uint32_t aCslPeriod, otShortAddress aShortAddr, const otExtAddress *aExtAddr)
|
הפעלה או השבתה של מקלט CSL.
|
otPlatRadioEnableSrcMatch(otInstance *aInstance, bool aEnable)
|
void
הפעלה/השבתה של תכונת התאמה של כתובת מקור.
|
otPlatRadioEnergyScan(otInstance *aInstance, uint8_t aScanChannel, uint16_t aScanDuration)
|
התחלת הרצף של סריקת האנרגיה ברדיו.
|
otPlatRadioEnergyScanDone(otInstance *aInstance, int8_t aEnergyScanMaxRssi)
|
void
נהג הרדיו קורא לשיטה הזו כדי להודיע ל-OpenThread שסריקת האנרגיה הושלמה.
|
otPlatRadioGetCoexMetrics(otInstance *aInstance, otRadioCoexMetrics *aCoexMetrics)
|
קבלת המדדים של דו-קרב ברדיו.
|
otPlatRadioGetCslAccuracy(otInstance *aInstance)
|
uint8_t
רמת הדיוק הנוכחית ביחידות של ± ppm של השעון המשמש לתזמון פעולות CSL.
|
otPlatRadioGetCslUncertainty(otInstance *aInstance)
|
uint8_t
אי-הוודאות הקבועה של המכשיר במקרה של שידורי CSL ביחידות של 10 מיקרו שניות.
|
otPlatRadioGetPreferredChannelMask(otInstance *aInstance)
|
uint32_t
יש לקבל את מסיכת הרדיו המועדפת על המכשיר שהמכשיר רוצה ליצור בה.
|
otPlatRadioGetRegion(otInstance *aInstance, uint16_t *aRegionCode)
|
קבלת קוד האזור.
|
otPlatRadioGetRssi(otInstance *aInstance)
|
int8_t
קבלת מדידת RSSI העדכנית ביותר.
|
otPlatRadioGetState(otInstance *aInstance)
|
קבלת המצב הנוכחי של הרדיו.
|
otPlatRadioGetSupportedChannelMask(otInstance *aInstance)
|
uint32_t
יש לקבל את מסיכת הערוץ הנתמכת ברדיו שבה מותר למכשיר לפעול.
|
otPlatRadioGetTransmitBuffer(otInstance *aInstance)
|
קבלת מאגר הנתונים של מסגרת השידור.
|
otPlatRadioIsCoexEnabled(otInstance *aInstance)
|
bool
בודקים אם מכשיר ה-Core Coex מופעל או לא.
|
otPlatRadioIsEnabled(otInstance *aInstance)
|
bool
בודקים אם הרדיו מופעל או לא.
|
otPlatRadioReceive(otInstance *aInstance, uint8_t aChannel)
|
העברת הרדיו מ'שינה' ל'קבלה' (הפעלה של הרדיו).
|
otPlatRadioReceiveAt(otInstance *aInstance, uint8_t aChannel, uint32_t aStart, uint32_t aDuration)
|
תזמון חלון קליטת רדיו בשעה ובמשך ספציפיים.
|
otPlatRadioReceiveDone(otInstance *aInstance, otRadioFrame *aFrame, otError aError)
|
void
נהג הרדיו קורא לשיטה הזו כדי ליידע את Openthread של פריים שהתקבלו.
|
otPlatRadioSetChannelMaxTransmitPower(otInstance *aInstance, uint8_t aChannel, int8_t aMaxPower)
|
הגדרת עוצמת שידור מקסימלית לערוץ ספציפי.
|
otPlatRadioSetCoexEnabled(otInstance *aInstance, bool aEnabled)
|
יש להפעיל את נתיב הרדיו.
|
otPlatRadioSetRegion(otInstance *aInstance, uint16_t aRegionCode)
|
מגדירים את קידומת האזור.
|
otPlatRadioSleep(otInstance *aInstance)
|
העברת הרדיו מ'קבלה' ל'שינה' (כיבוי הרדיו).
|
otPlatRadioTransmit(otInstance *aInstance, otRadioFrame *aFrame)
|
התחלת רצף השידור ברדיו.
|
otPlatRadioTxDone(otInstance *aInstance, otRadioFrame *aFrame, otRadioFrame *aAckFrame, otError aError)
|
void
נהג הרדיו קורא לפונקציה הזו כדי להודיע ל-OpenThread שפעולת השידור הושלמה, ומספקת גם את המסגרת המשודרת וגם את מסגרת ack שהתקבלה, אם רלוונטי.
|
otPlatRadioTxStarted(otInstance *aInstance, otRadioFrame *aFrame)
|
void
נהג הרדיו קורא לשיטה הזו כדי להודיע ל-OpenThread שהשידור התחיל.
|
otPlatRadioUpdateCslSampleTime(otInstance *aInstance, uint32_t aCslSampleTime)
|
void
עדכון זמן הדגימה של CSL בנהג רדיו.
|
פונקציות
otPlatDiagRadioGetDone
void otPlatDiagRadioReceiveDone( otInstance *aInstance, otRadioFrame *aFrame, otError aError )
נהג הרדיו קורא לשיטה הזו כדי ליידע את מודול האבחון של OpenThread לגבי מסגרת שהתקבלה.
הפונקציה הזו מופעלת כשהאבחון מופעל.
פרטים | |||||||
---|---|---|---|---|---|---|---|
פרמטרים |
|
otPlatDiagRadioTransmitDone
void otPlatDiagRadioTransmitDone( otInstance *aInstance, otRadioFrame *aFrame, otError aError )
נהג הרדיו קורא לשיטה הזו כדי להודיע למודול האבחון של OpenThread שההעברה הסתיימה.
הפונקציה הזו מופעלת כשהאבחון מופעל.
פרטים | |||||||
---|---|---|---|---|---|---|---|
פרמטרים |
|
otPlatRadioAddSrcMATCHExtEntry
otError otPlatRadioAddSrcMatchExtEntry( otInstance *aInstance, const otExtAddress *aExtAddress )
מוסיפים כתובת מורחבת לטבלת ההתאמות של כתובות המקור.
פרטים | |||||
---|---|---|---|---|---|
פרמטרים |
|
||||
ערכי החזרה |
|
otPlatRadioAddSrcMATCHShortEntry
otError otPlatRadioAddSrcMatchShortEntry( otInstance *aInstance, otShortAddress aShortAddress )
מוסיפים כתובת קצרה לטבלת ההתאמה של כתובות המקור.
פרטים | |||||
---|---|---|---|---|---|
פרמטרים |
|
||||
ערכי החזרה |
|
otPlatRadioClearSrcMATCHExtEntries
void otPlatRadioClearSrcMatchExtEntries( otInstance *aInstance )
ניקוי כל הכתובות המורחבות/הארוכות מטבלת ההתאמה של כתובת המקור.
פרטים | |||
---|---|---|---|
פרמטרים |
|
otPlatRadioClearSrcMATCHExtEntry
otError otPlatRadioClearSrcMatchExtEntry( otInstance *aInstance, const otExtAddress *aExtAddress )
מסירים כתובת מורחבת מטבלת ההתאמה של כתובת המקור.
פרטים | |||||
---|---|---|---|---|---|
פרמטרים |
|
||||
ערכי החזרה |
|
otPlatRadioClearSrcMATCHShortEntries
void otPlatRadioClearSrcMatchShortEntries( otInstance *aInstance )
ניקוי כל הכתובות הקצרות מטבלת ההתאמה של כתובת המקור.
פרטים | |||
---|---|---|---|
פרמטרים |
|
otPlatRadioClearSrcMATCHShortEntry
otError otPlatRadioClearSrcMatchShortEntry( otInstance *aInstance, otShortAddress aShortAddress )
הסרת כתובת קצרה מטבלת ההתאמה של כתובת המקור.
פרטים | |||||
---|---|---|---|---|---|
פרמטרים |
|
||||
ערכי החזרה |
|
otPlatRadioConfigEnhAckProbing
otError otPlatRadioConfigureEnhAckProbing( otInstance *aInstance, otLinkMetrics aLinkMetrics, otShortAddress aShortAddress, const otExtAddress *aExtAddress )
הפעלה/השבתה או עדכון של בדיקה מבוססת-AC ברדיו עבור מאתחל ספציפי.
אחרי שכלי הבדיקה מבוססי השיפור ב-ACK מוגדרים על ידי מאתחל ספציפי של ניתוח אירועים, ה-enhanced-ACK שיישלח לצומת הזה צריך לכלול נתוני IE ספציפיים לספק שמכילים נתונים של מדדי קישור. שיטה זו מיידעת את הרדיו להתחיל/להפסיק לאסוף נתונים של מדדי קישור ולכלול IE ספציפי של ספק שמכיל את הנתונים ב-enhanced-ACK שנשלח לאותו מאתחל.
פרטים | |||||||||
---|---|---|---|---|---|---|---|---|---|
פרמטרים |
|
||||||||
ערכי החזרה |
|
השבתה של otPlatRadio
otError otPlatRadioDisable( otInstance *aInstance )
להשבית את הרדיו.
פרטים | |||||
---|---|---|---|---|---|
פרמטרים |
|
||||
ערכי החזרה |
|
otPlatRadioEnabled
otError otPlatRadioEnable( otInstance *aInstance )
מפעילים את הרדיו.
פרטים | |||||
---|---|---|---|---|---|
פרמטרים |
|
||||
ערכי החזרה |
|
otPlatRadioEnabledCsl
otError otPlatRadioEnableCsl( otInstance *aInstance, uint32_t aCslPeriod, otShortAddress aShortAddr, const otExtAddress *aExtAddr )
הפעלה או השבתה של מקלט CSL.
פרטים | |||||||||
---|---|---|---|---|---|---|---|---|---|
פרמטרים |
|
||||||||
ערכי החזרה |
|
otPlatRadioEnableSrcMATCH
void otPlatRadioEnableSrcMatch( otInstance *aInstance, bool aEnable )
הפעלה/השבתה של תכונת התאמה של כתובת מקור.
תכונת ההתאמה של כתובת המקור קובעת איך שכבת הרדיו קובעת את הביטים "frame בהמתנה" עבור חבילות שנשלחו בתגובה לפקודות של בקשת נתונים מילדים.
אם האפשרות מושבתת, שכבת הרדיו חייבת להגדיר את ה- "frame בהמתנה" בכל החבילות של פקודות לבקשת נתונים.
אם האפשרות מופעלת, שכבת הרדיו משתמשת בטבלת ההתאמה של כתובת המקור כדי לקבוע אם להגדיר או לנקות את הביטים &"מסגרת" בפקודה של פקודת בקשת נתונים.
בטבלת ההתאמות של כתובות המקור יש רשימה של ילדים שיש עבורם מסגרת בהמתנה. ניתן להוסיף כתובת קצרה או כתובת מורחבת/ארוכה לטבלת ההתאמה של כתובת המקור.
פרטים | |||||
---|---|---|---|---|---|
פרמטרים |
|
OTPlatRadioEnergyScan
otError otPlatRadioEnergyScan( otInstance *aInstance, uint8_t aScanChannel, uint16_t aScanDuration )
התחלת הרצף של סריקת האנרגיה ברדיו.
הפונקציה הזו משמשת כשרדיו מספק OT_ רדיו_CAPS_ENERGY_SCAN.
פרטים | |||||||
---|---|---|---|---|---|---|---|
פרמטרים |
|
||||||
ערכי החזרה |
|
OTPlatRadioEnergyScanDone
void otPlatRadioEnergyScanDone( otInstance *aInstance, int8_t aEnergyScanMaxRssi )
נהג הרדיו קורא לשיטה הזו כדי להודיע ל-OpenThread שסריקת האנרגיה הושלמה.
הפונקציה הזו משמשת כשרדיו מספק OT_ רדיו_CAPS_ENERGY_SCAN.
פרטים | |||||
---|---|---|---|---|---|
פרמטרים |
|
otPlatRadioGetCoexMetrics
otError otPlatRadioGetCoexMetrics( otInstance *aInstance, otRadioCoexMetrics *aCoexMetrics )
קבלת המדדים של דו-קרב ברדיו.
הפונקציה הזו מופעלת כאשר התכונה Openthread_CONFIG_PLATFORM_Radio_COEX_ENABLE מופעלת.
פרטים | |||||
---|---|---|---|---|---|
פרמטרים |
|
||||
ערכי החזרה |
|
otPlatRadioGetCslAccuracy
uint8_t otPlatRadioGetCslAccuracy( otInstance *aInstance )
רמת הדיוק הנוכחית ביחידות של ± ppm של השעון המשמש לתזמון פעולות CSL.
פרטים | |||
---|---|---|---|
פרמטרים |
|
||
החזרות |
דריפט לוח הזמנים הנוכחי מסוג CSL rx/tx, ביחידות של ± ppm.
|
otPlatRadioGetCslUn ודאy
uint8_t otPlatRadioGetCslUncertainty( otInstance *aInstance )
אי-הוודאות הקבועה של המכשיר במקרה של שידורי CSL ביחידות של 10 מיקרו שניות.
פרטים | |||
---|---|---|---|
פרמטרים |
|
||
החזרות |
אי הוודאות של CSL ביחידות של 10 אנשים.
|
otPlatRadioGetPreferredChannelMask
uint32_t otPlatRadioGetPreferredChannelMask( otInstance *aInstance )
יש לקבל את מסיכת הרדיו המועדפת על המכשיר שהמכשיר רוצה ליצור בה.
פרטים | |||
---|---|---|---|
פרמטרים |
|
||
החזרות |
מסכת הרדיו המועדפת על הערוץ.
|
אזור OTPlatRadioGetRegion
otError otPlatRadioGetRegion( otInstance *aInstance, uint16_t *aRegionCode )
קבלת קוד האזור.
הפורמט של אזור הרדיו הוא ייצוג ASCII מסוג 2 בייט של קוד ISO 3166 אלפא-2.
פרטים | |||||||
---|---|---|---|---|---|---|---|
פרמטרים |
|
||||||
ערכי החזרה |
|
otPlatRadioGetRssi
int8_t otPlatRadioGetRssi( otInstance *aInstance )
קבלת מדידת RSSI העדכנית ביותר.
פרטים | |||
---|---|---|---|
פרמטרים |
|
||
החזרות |
ה-RSSI ב-dBm תקף. 127 כאשר RSSI לא חוקי.
|
OTPlatRadioGetState
otRadioState otPlatRadioGetState( otInstance *aInstance )
קבלת המצב הנוכחי של הרדיו.
הפונקציה הזו לא נדרשת על ידי OpenThread. הוא עשוי לשמש לניפוי באגים ו/או למטרות ספציפיות לאפליקציה.
פרטים | |||
---|---|---|---|
פרמטרים |
|
||
החזרות |
מצב הרדיו הנוכחי.
|
otPlatRadioGetSupportedChannelMask
uint32_t otPlatRadioGetSupportedChannelMask( otInstance *aInstance )
יש לקבל את מסיכת הערוץ הנתמכת ברדיו שבה מותר למכשיר לפעול.
פרטים | |||
---|---|---|---|
פרמטרים |
|
||
החזרות |
מסיכת ערוץ נתמכת לרדיו.
|
otPlatRadioGetTransmitBuffer
otRadioFrame * otPlatRadioGetTransmitBuffer( otInstance *aInstance )
קבלת מאגר הנתונים של מסגרת השידור.
OpenThread יוצר את מסגרת IEEE 802.15.4 במאגר הנתונים הזה ומתקשר אל otPlatRadioTransmit()
כדי לבקש הפצה.
פרטים | |||
---|---|---|---|
פרמטרים |
|
||
החזרות |
מצביע אל מאגר הנתונים של מסגרת השידור.
|
otPlatRadioIsCoexEnabled
bool otPlatRadioIsCoexEnabled( otInstance *aInstance )
בודקים אם מכשיר ה-Core Coex מופעל או לא.
הפונקציה הזו מופעלת כאשר התכונה Openthread_CONFIG_PLATFORM_Radio_COEX_ENABLE מופעלת.
פרטים | |||
---|---|---|---|
פרמטרים |
|
||
החזרות |
TRUE אם קוקס רדיו מופעל, FALSE אם לא.
|
otPlatRadioIsEnabled
bool otPlatRadioIsEnabled( otInstance *aInstance )
בודקים אם הרדיו מופעל או לא.
פרטים | |||
---|---|---|---|
פרמטרים |
|
||
החזרות |
TRUE אם הרדיו מופעל, FALSE אם לא.
|
otPlatRadioGet
otError otPlatRadioReceive( otInstance *aInstance, uint8_t aChannel )
העברת הרדיו מ'שינה' ל'קבלה' (הפעלה של הרדיו).
פרטים | |||||
---|---|---|---|---|---|
פרמטרים |
|
||||
ערכי החזרה |
|
otPlatRadioGetAt
otError otPlatRadioReceiveAt( otInstance *aInstance, uint8_t aChannel, uint32_t aStart, uint32_t aDuration )
תזמון חלון קליטת רדיו בשעה ובמשך ספציפיים.
פרטים | |||||||
---|---|---|---|---|---|---|---|
פרמטרים |
|
||||||
ערכי החזרה |
|
otPlatRadioGetDone
void otPlatRadioReceiveDone( otInstance *aInstance, otRadioFrame *aFrame, otError aError )
נהג הרדיו קורא לשיטה הזו כדי ליידע את Openthread של פריים שהתקבלו.
פרטים | |||||||
---|---|---|---|---|---|---|---|
פרמטרים |
|
otPlatRadioSetChannelMaxTransmitPower
otError otPlatRadioSetChannelMaxTransmitPower( otInstance *aInstance, uint8_t aChannel, int8_t aMaxPower )
הגדרת עוצמת שידור מקסימלית לערוץ ספציפי.
פרטים | |||||||||
---|---|---|---|---|---|---|---|---|---|
פרמטרים |
|
||||||||
ערכי החזרה |
|
otPlatRadioSetCoexEnabled
otError otPlatRadioSetCoexEnabled( otInstance *aInstance, bool aEnabled )
יש להפעיל את נתיב הרדיו.
הפונקציה הזו מופעלת כאשר התכונה Openthread_CONFIG_PLATFORM_Radio_COEX_ENABLE מופעלת.
פרטים | |||||
---|---|---|---|---|---|
פרמטרים |
|
||||
ערכי החזרה |
|
אזור OTPlatRadioSetRegion
otError otPlatRadioSetRegion( otInstance *aInstance, uint16_t aRegionCode )
מגדירים את קידומת האזור.
הפורמט של אזור הרדיו הוא ייצוג ASCII מסוג 2 בייט של קוד ISO 3166 אלפא-2.
פרטים | |||||
---|---|---|---|---|---|
פרמטרים |
|
||||
ערכי החזרה |
|
otPlatRadioSleep
otError otPlatRadioSleep( otInstance *aInstance )
העברת הרדיו מ'קבלה' ל'שינה' (כיבוי הרדיו).
פרטים | |||||||
---|---|---|---|---|---|---|---|
פרמטרים |
|
||||||
ערכי החזרה |
|
OTPlatRadioTransmit
otError otPlatRadioTransmit( otInstance *aInstance, otRadioFrame *aFrame )
התחלת רצף השידור ברדיו.
המתקשר חייב ליצור את מסגרת ה-IEEE 802.15.4 במאגר של הנתונים הזמניים על ידי otPlatRadioGetTransmitBuffer()
, לפני שליחת הבקשה. הערוץ ועוצמת השידור כלולים גם במבנה otRadioFrame.
רצף השידור מורכב מהפרטים הבאים:
- העברת הרדיו לשידור באחת מהמדינות הבאות:
- קבלה אם RX פועל כשהמכשיר לא פעיל או שאין תמיכה ב-OT_Radio_CAPS_SLEEP_TO_TX
- מעבר למצב שינה אם RX כבוי כשהמכשיר לא פעיל וכשיש תמיכה ב-OT_ רדיו_CAPS_SLEEP_TO_TX.
- מעביר את ה-PSdu בערוץ הנתון ובעוצמת השידור הנתונה.
פרטים | |||||
---|---|---|---|---|---|
פרמטרים |
|
||||
ערכי החזרה |
|
OTPlatRadioTxDone
void otPlatRadioTxDone( otInstance *aInstance, otRadioFrame *aFrame, otRadioFrame *aAckFrame, otError aError )
נהג הרדיו קורא לפונקציה הזו כדי להודיע ל-OpenThread שפעולת השידור הושלמה, ומספקת גם את המסגרת המשודרת וגם את מסגרת ack שהתקבלה, אם רלוונטי.
כשרדיו מספק יכולת OT_RADIO_CAPS_TRANSMIT_SEC
, שכבת פלטפורמת הרדיו מעדכנת את aFrame
עם המונה של מסגרת האבטחה ועם ערכי האינדקס העיקריים שנשמרו על ידי הרדיו.
פרטים | |||||||||
---|---|---|---|---|---|---|---|---|---|
פרמטרים |
|
otPlatRadioTxStarted
void otPlatRadioTxStarted( otInstance *aInstance, otRadioFrame *aFrame )
נהג הרדיו קורא לשיטה הזו כדי להודיע ל-OpenThread שהשידור התחיל.
פרטים | |||||
---|---|---|---|---|---|
פרמטרים |
|
otPlatRadioUpdateCslSampleTime
void otPlatRadioUpdateCslSampleTime( otInstance *aInstance, uint32_t aCslSampleTime )
עדכון זמן הדגימה של CSL בנהג רדיו.
זמן הדגימה נשמר במנהל ההתקן כעותק כדי לחשב את השלב בעת שליחת ACK עם CSL IE.
פרטים | |||||
---|---|---|---|---|---|
פרמטרים |
|
משאבים
נושאי עזר של OpenThread API מגיעים מקוד המקור, שזמין ב-GitHub. למידע נוסף או כדי להוסיף מידע למסמכים שלנו, יש לעיין במשאבים.