הפעלת רדיו

מודול זה כולל את ההפשטה של פלטפורמות רדיו.

סיכום

פונקציות

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 לגבי מסגרת שהתקבלה.

הפונקציה הזו מופעלת כשהאבחון מופעל.

פרטים
פרמטרים
[in] aInstance
מבנה המופע של OpenThread.
[in] aFrame
מצביע למסגרת שהתקבלה או NULL אם פעולת הקבלה נכשלה.
[in] aError
OT_ERROR_NONE כאשר מתקבל בהצלחה פריים, OT_ERROR_ABORT כאשר הקבלה לא בוטלה ולא התקבלה מסגרת, OT_ERROR_NO_BUFS כאשר לא ניתן לקבל מסגרת עקב מחסור במקום אחסון במאגר נתונים.

otPlatDiagRadioTransmitDone

void otPlatDiagRadioTransmitDone(
  otInstance *aInstance,
  otRadioFrame *aFrame,
  otError aError
)

נהג הרדיו קורא לשיטה הזו כדי להודיע למודול האבחון של OpenThread שההעברה הסתיימה.

הפונקציה הזו מופעלת כשהאבחון מופעל.

פרטים
פרמטרים
[in] aInstance
מבנה המופע של OpenThread.
[in] aFrame
מצביע על המסגרת ששודרה.
[in] aError
OT_ERROR_NONE כאשר המסגרת הועברה, לא ניתן היה לבצע OT_ERROR_CHANNEL_ACCESS_FAILURE TX עקב הפעילות בערוץ, OT_ERROR_ABORT כאשר ההעברה בוטלה מסיבות אחרות.

otPlatRadioAddSrcMATCHExtEntry

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

מוסיפים כתובת מורחבת לטבלת ההתאמות של כתובות המקור.

פרטים
פרמטרים
[in] aInstance
מבנה המופע של OpenThread.
[in] aExtAddress
הכתובת המורחבת שיש להוסיף בסדר בייטים קטן.
ערכי החזרה
OT_ERROR_NONE
הכתובת המורחבת נוספה לטבלה של התאמת המקור.
OT_ERROR_NO_BUFS
אין ערכים זמינים בטבלת ההתאמה למקור.

otPlatRadioAddSrcMATCHShortEntry

otError otPlatRadioAddSrcMatchShortEntry(
  otInstance *aInstance,
  otShortAddress aShortAddress
)

מוסיפים כתובת קצרה לטבלת ההתאמה של כתובות המקור.

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

otPlatRadioClearSrcMATCHExtEntries

void otPlatRadioClearSrcMatchExtEntries(
  otInstance *aInstance
)

ניקוי כל הכתובות המורחבות/הארוכות מטבלת ההתאמה של כתובת המקור.

פרטים
פרמטרים
[in] aInstance
מבנה המופע של OpenThread.

otPlatRadioClearSrcMATCHExtEntry

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

מסירים כתובת מורחבת מטבלת ההתאמה של כתובת המקור.

פרטים
פרמטרים
[in] aInstance
מבנה המופע של OpenThread.
[in] aExtAddress
הכתובת המורחבת שיש להסיר בסדר קטן בבייטים.
ערכי החזרה
OT_ERROR_NONE
הכתובת המורחבת הוסרה מטבלת ההתאמה למקור.
OT_ERROR_NO_ADDRESS
הכתובת המורחבת לא מופיעה בטבלת ההתאמות של כתובות המקור.

otPlatRadioClearSrcMATCHShortEntries

void otPlatRadioClearSrcMatchShortEntries(
  otInstance *aInstance
)

ניקוי כל הכתובות הקצרות מטבלת ההתאמה של כתובת המקור.

פרטים
פרמטרים
[in] aInstance
מבנה המופע של OpenThread.

otPlatRadioClearSrcMATCHShortEntry

otError otPlatRadioClearSrcMatchShortEntry(
  otInstance *aInstance,
  otShortAddress aShortAddress
)

הסרת כתובת קצרה מטבלת ההתאמה של כתובת המקור.

פרטים
פרמטרים
[in] aInstance
מבנה המופע של OpenThread.
[in] aShortAddress
הכתובת הקצרה להסרה.
ערכי החזרה
OT_ERROR_NONE
הכתובת הקצרה הוסרה מטבלת ההתאמה המקורית.
OT_ERROR_NO_ADDRESS
הכתובת הקצרה לא נמצאת בטבלת ההתאמות של כתובות המקור.

otPlatRadioConfigEnhAckProbing

otError otPlatRadioConfigureEnhAckProbing(
  otInstance *aInstance,
  otLinkMetrics aLinkMetrics,
  otShortAddress aShortAddress,
  const otExtAddress *aExtAddress
)

הפעלה/השבתה או עדכון של בדיקה מבוססת-AC ברדיו עבור מאתחל ספציפי.

אחרי שכלי הבדיקה מבוססי השיפור ב-ACK מוגדרים על ידי מאתחל ספציפי של ניתוח אירועים, ה-enhanced-ACK שיישלח לצומת הזה צריך לכלול נתוני IE ספציפיים לספק שמכילים נתונים של מדדי קישור. שיטה זו מיידעת את הרדיו להתחיל/להפסיק לאסוף נתונים של מדדי קישור ולכלול IE ספציפי של ספק שמכיל את הנתונים ב-enhanced-ACK שנשלח לאותו מאתחל.

פרטים
פרמטרים
[in] aInstance
מבנה המופע של OpenThread.
[in] aLinkMetrics
הפרמטר הזה מציין אילו מדדים לשלוח שאילתות. לפי מפרט 4.11.3.4.4.6, אפשר לציין עד שני מדדים. אפשרות הבדיקה תושבת אם aLinkMetrics יהיה בערך 0.
[in] aShortAddress
הכתובת הקצרה של מפעיל ה-Probing.
[in] aExtAddress
כתובת המקור המורחבת של מאתחל האיתור. aExtAddr חייב להיות NULL.
ערכי החזרה
OT_ERROR_NONE
הבדיקה מבוססת-AC-AC הוגדרה בהצלחה.
OT_ERROR_INVALID_ARGS
aExtAddress היא NULL.
OT_ERROR_NOT_FOUND
המאתחל שצוין על ידי aShortAddress לא נמצא כשמנסים לנקות.
OT_ERROR_NO_BUFS
אין יותר תמיכה במי שיזם.

השבתה של otPlatRadio

otError otPlatRadioDisable(
  otInstance *aInstance
)

להשבית את הרדיו.

פרטים
פרמטרים
[in] aInstance
מבנה המופע של OpenThread.
ערכי החזרה
OT_ERROR_NONE
המעבר ל'מושבת' בוצע בהצלחה.
OT_ERROR_INVALID_STATE
הרדיו לא היה במצב שינה.

otPlatRadioEnabled

otError otPlatRadioEnable(
  otInstance *aInstance
)

מפעילים את הרדיו.

פרטים
פרמטרים
[in] aInstance
מבנה המופע של OpenThread.
ערכי החזרה
OT_ERROR_NONE
ההפעלה בוצעה בהצלחה.
OT_ERROR_FAILED
לא ניתן היה להפעיל את הרדיו.

otPlatRadioEnabledCsl

otError otPlatRadioEnableCsl(
  otInstance *aInstance,
  uint32_t aCslPeriod,
  otShortAddress aShortAddr,
  const otExtAddress *aExtAddr
)

הפעלה או השבתה של מקלט CSL.

פרטים
פרמטרים
[in] aInstance
מבנה המופע של OpenThread.
[in] aCslPeriod
מחזור CSL, 0 להשבתה של CSL.
[in] aShortAddr
כתובת המקור הקצרה של מקלט CSL של #39.
[in] aExtAddr
כתובת המקור המורחבת של ספק הסלולר CSL.
ערכי החזרה
kErrorNotImplemented
אין תמיכה ב-CSL בנהג רדיו.
kErrorFailed
שגיאות אחרות הקשורות לפלטפורמה.
kErrorNone
CSL הופעל או הושבת בהצלחה.

otPlatRadioEnableSrcMATCH

void otPlatRadioEnableSrcMatch(
  otInstance *aInstance,
  bool aEnable
)

הפעלה/השבתה של תכונת התאמה של כתובת מקור.

תכונת ההתאמה של כתובת המקור קובעת איך שכבת הרדיו קובעת את הביטים "frame בהמתנה" עבור חבילות שנשלחו בתגובה לפקודות של בקשת נתונים מילדים.

אם האפשרות מושבתת, שכבת הרדיו חייבת להגדיר את ה- "frame בהמתנה" בכל החבילות של פקודות לבקשת נתונים.

אם האפשרות מופעלת, שכבת הרדיו משתמשת בטבלת ההתאמה של כתובת המקור כדי לקבוע אם להגדיר או לנקות את הביטים &"מסגרת" בפקודה של פקודת בקשת נתונים.

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

פרטים
פרמטרים
[in] aInstance
מבנה המופע של OpenThread.
[in] aEnable
הפעלה/השבתה של התכונה 'התאמה לכתובת המקור'.

OTPlatRadioEnergyScan

otError otPlatRadioEnergyScan(
  otInstance *aInstance,
  uint8_t aScanChannel,
  uint16_t aScanDuration
)

התחלת הרצף של סריקת האנרגיה ברדיו.

הפונקציה הזו משמשת כשרדיו מספק OT_ רדיו_CAPS_ENERGY_SCAN.

פרטים
פרמטרים
[in] aInstance
מבנה המופע של OpenThread.
[in] aScanChannel
הערוץ לביצוע סריקת האנרגיה.
[in] aScanDuration
משך הזמן (באלפיות שנייה) של סריקת הערוץ.
ערכי החזרה
OT_ERROR_NONE
סריקת הערוץ התחילה בהצלחה.
OT_ERROR_BUSY
הרדיו מבצע סריקה מקיפה.
OT_ERROR_NOT_IMPLEMENTED
הרדיו אינו תומך בסריקת אנרגיה.

OTPlatRadioEnergyScanDone

void otPlatRadioEnergyScanDone(
  otInstance *aInstance,
  int8_t aEnergyScanMaxRssi
)

נהג הרדיו קורא לשיטה הזו כדי להודיע ל-OpenThread שסריקת האנרגיה הושלמה.

הפונקציה הזו משמשת כשרדיו מספק OT_ רדיו_CAPS_ENERGY_SCAN.

פרטים
פרמטרים
[in] aInstance
מבנה המופע של OpenThread.
[in] aEnergyScanMaxRssi
מספר ה-RSSI המקסימלי שהתקבל בערוץ הסרוק.

otPlatRadioGetCoexMetrics

otError otPlatRadioGetCoexMetrics(
  otInstance *aInstance,
  otRadioCoexMetrics *aCoexMetrics
)

קבלת המדדים של דו-קרב ברדיו.

הפונקציה הזו מופעלת כאשר התכונה Openthread_CONFIG_PLATFORM_Radio_COEX_ENABLE מופעלת.

פרטים
פרמטרים
[in] aInstance
מבנה המופע של OpenThread.
[out] aCoexMetrics
מצביע על המבנה של מדדי הדו-קיום.
ערכי החזרה
OT_ERROR_NONE
מדדי ה-Cox עברו בהצלחה.
OT_ERROR_INVALID_ARGS
הערך של aCoexMetrics היה NULL.

otPlatRadioGetCslAccuracy

uint8_t otPlatRadioGetCslAccuracy(
  otInstance *aInstance
)

רמת הדיוק הנוכחית ביחידות של ± ppm של השעון המשמש לתזמון פעולות CSL.

פרטים
פרמטרים
[in] aInstance
מצביע על מופע של OpenThread.
החזרות
דריפט לוח הזמנים הנוכחי מסוג CSL rx/tx, ביחידות של ± ppm.

otPlatRadioGetCslUn ודאy

uint8_t otPlatRadioGetCslUncertainty(
  otInstance *aInstance
)

אי-הוודאות הקבועה של המכשיר במקרה של שידורי CSL ביחידות של 10 מיקרו שניות.

פרטים
פרמטרים
[in] aInstance
מצביע על מופע של OpenThread.
החזרות
אי הוודאות של CSL ביחידות של 10 אנשים.

otPlatRadioGetPreferredChannelMask

uint32_t otPlatRadioGetPreferredChannelMask(
  otInstance *aInstance
)

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

פרטים
פרמטרים
[in] aInstance
מבנה המופע של OpenThread.
החזרות
מסכת הרדיו המועדפת על הערוץ.

אזור OTPlatRadioGetRegion

otError otPlatRadioGetRegion(
  otInstance *aInstance,
  uint16_t *aRegionCode
)

קבלת קוד האזור.

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

פרטים
פרמטרים
[in] aInstance
מבנה המופע של OpenThread.
[out] aRegionCode
אזור הרדיו.
ערכי החזרה
OT_ERROR_INVALID_ARGS
aRegionCode הוא nullptr.
OT_ERROR_FAILED
שגיאות אחרות הקשורות לפלטפורמה.
OT_ERROR_NONE
קוד האזור התקבל.

otPlatRadioGetRssi

int8_t otPlatRadioGetRssi(
  otInstance *aInstance
)

קבלת מדידת RSSI העדכנית ביותר.

פרטים
פרמטרים
[in] aInstance
מבנה המופע של OpenThread.
החזרות
ה-RSSI ב-dBm תקף. 127 כאשר RSSI לא חוקי.

OTPlatRadioGetState

otRadioState otPlatRadioGetState(
  otInstance *aInstance
)

קבלת המצב הנוכחי של הרדיו.

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

פרטים
פרמטרים
[in] aInstance
מבנה המופע של OpenThread.
החזרות
מצב הרדיו הנוכחי.

otPlatRadioGetSupportedChannelMask

uint32_t otPlatRadioGetSupportedChannelMask(
  otInstance *aInstance
)

יש לקבל את מסיכת הערוץ הנתמכת ברדיו שבה מותר למכשיר לפעול.

פרטים
פרמטרים
[in] aInstance
מבנה המופע של OpenThread.
החזרות
מסיכת ערוץ נתמכת לרדיו.

otPlatRadioGetTransmitBuffer

otRadioFrame * otPlatRadioGetTransmitBuffer(
  otInstance *aInstance
)

קבלת מאגר הנתונים של מסגרת השידור.

OpenThread יוצר את מסגרת IEEE 802.15.4 במאגר הנתונים הזה ומתקשר אל otPlatRadioTransmit() כדי לבקש הפצה.

פרטים
פרמטרים
[in] aInstance
מבנה המופע של OpenThread.
החזרות
מצביע אל מאגר הנתונים של מסגרת השידור.

otPlatRadioIsCoexEnabled

bool otPlatRadioIsCoexEnabled(
  otInstance *aInstance
)

בודקים אם מכשיר ה-Core Coex מופעל או לא.

הפונקציה הזו מופעלת כאשר התכונה Openthread_CONFIG_PLATFORM_Radio_COEX_ENABLE מופעלת.

פרטים
פרמטרים
[in] aInstance
מבנה המופע של OpenThread.
החזרות
TRUE אם קוקס רדיו מופעל, FALSE אם לא.

otPlatRadioIsEnabled

bool otPlatRadioIsEnabled(
  otInstance *aInstance
)

בודקים אם הרדיו מופעל או לא.

פרטים
פרמטרים
[in] aInstance
מבנה המופע של OpenThread.
החזרות
TRUE אם הרדיו מופעל, FALSE אם לא.

otPlatRadioGet

otError otPlatRadioReceive(
  otInstance *aInstance,
  uint8_t aChannel
)

העברת הרדיו מ'שינה' ל'קבלה' (הפעלה של הרדיו).

פרטים
פרמטרים
[in] aInstance
מבנה המופע של OpenThread.
[in] aChannel
הערוץ שישמש לקבלת סרטונים.
ערכי החזרה
OT_ERROR_NONE
'עבר' ל'קבלה' עבר בהצלחה.
OT_ERROR_INVALID_STATE
הרדיו הושבת או שודר.

otPlatRadioGetAt

otError otPlatRadioReceiveAt(
  otInstance *aInstance,
  uint8_t aChannel,
  uint32_t aStart,
  uint32_t aDuration
)

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

פרטים
פרמטרים
[in] aChannel
ערוץ הרדיו שבו רוצים לקבל את השידור.
[in] aStart
שעת ההתחלה של חלון הקבלה, במיקרו שניות.
[in] aDuration
משך הזמן של חלון הקבלה, במיקרו שניות
ערכי החזרה
OT_ERROR_NONE
חלון הקבלה תוזמן בהצלחה.
OT_ERROR_FAILED
לא ניתן היה לתזמן את חלון הקבלה.

otPlatRadioGetDone

void otPlatRadioReceiveDone(
  otInstance *aInstance,
  otRadioFrame *aFrame,
  otError aError
)

נהג הרדיו קורא לשיטה הזו כדי ליידע את Openthread של פריים שהתקבלו.

פרטים
פרמטרים
[in] aInstance
מבנה המופע של OpenThread.
[in] aFrame
מצביע למסגרת שהתקבלה או NULL אם פעולת הקבלה נכשלה.
[in] aError
OT_ERROR_NONE כאשר מתקבל בהצלחה פריים, OT_ERROR_ABORT כאשר הקבלה לא בוטלה ולא התקבלה מסגרת, OT_ERROR_NO_BUFS כאשר לא ניתן לקבל מסגרת עקב מחסור במקום אחסון במאגר נתונים.

otPlatRadioSetChannelMaxTransmitPower

otError otPlatRadioSetChannelMaxTransmitPower(
  otInstance *aInstance,
  uint8_t aChannel,
  int8_t aMaxPower
)

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

פרטים
פרמטרים
[in] aInstance
מבנה המופע של OpenThread.
[in] aChannel
ערוץ הרדיו.
[in] aMaxPower
הספק המרבי ב-dBm על ידי OT_ רדיו_RSSI_INVALID ישבית את הערוץ הזה.
ערכי החזרה
OT_ERROR_NOT_IMPLEMENTED
התכונה לא מיושמת
OT_ERROR_INVALID_ARGS
הערוץ שצוין אינו חוקי.
OT_ERROR_FAILED
שגיאות אחרות הקשורות לפלטפורמה.
OT_ERROR_NONE
ההגדרה של עוצמת שידור מקסימלית הוגדרה בהצלחה.

otPlatRadioSetCoexEnabled

otError otPlatRadioSetCoexEnabled(
  otInstance *aInstance,
  bool aEnabled
)

יש להפעיל את נתיב הרדיו.

הפונקציה הזו מופעלת כאשר התכונה Openthread_CONFIG_PLATFORM_Radio_COEX_ENABLE מופעלת.

פרטים
פרמטרים
[in] aInstance
מבנה המופע של OpenThread.
[in] aEnabled
TRUE כדי להפעיל את קוקס רדיו, FALSE אם לא.
ערכי החזרה
OT_ERROR_NONE
ההפעלה בוצעה בהצלחה.
OT_ERROR_FAILED
לא ניתן להפעיל את נתיב הרדיו.

אזור OTPlatRadioSetRegion

otError otPlatRadioSetRegion(
  otInstance *aInstance,
  uint16_t aRegionCode
)

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

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

פרטים
פרמטרים
[in] aInstance
מבנה המופע של OpenThread.
[in] aRegionCode
אזור הרדיו.
ערכי החזרה
OT_ERROR_FAILED
שגיאות אחרות הקשורות לפלטפורמה.
OT_ERROR_NONE
קוד האזור הוגדר בהצלחה.

otPlatRadioSleep

otError otPlatRadioSleep(
  otInstance *aInstance
)

העברת הרדיו מ'קבלה' ל'שינה' (כיבוי הרדיו).

פרטים
פרמטרים
[in] aInstance
מבנה המופע של OpenThread.
ערכי החזרה
OT_ERROR_NONE
ההעברה ל'שינה' הסתיימה.
OT_ERROR_BUSY
הרדיו שודר.
OT_ERROR_INVALID_STATE
הרדיו הושבת.

OTPlatRadioTransmit

otError otPlatRadioTransmit(
  otInstance *aInstance,
  otRadioFrame *aFrame
)

התחלת רצף השידור ברדיו.

המתקשר חייב ליצור את מסגרת ה-IEEE 802.15.4 במאגר של הנתונים הזמניים על ידי otPlatRadioGetTransmitBuffer(), לפני שליחת הבקשה. הערוץ ועוצמת השידור כלולים גם במבנה otRadioFrame.

רצף השידור מורכב מהפרטים הבאים:

  1. העברת הרדיו לשידור באחת מהמדינות הבאות:
    • קבלה אם RX פועל כשהמכשיר לא פעיל או שאין תמיכה ב-OT_Radio_CAPS_SLEEP_TO_TX
    • מעבר למצב שינה אם RX כבוי כשהמכשיר לא פעיל וכשיש תמיכה ב-OT_ רדיו_CAPS_SLEEP_TO_TX.
  2. מעביר את ה-PSdu בערוץ הנתון ובעוצמת השידור הנתונה.

פרטים
פרמטרים
[in] aInstance
מבנה המופע של OpenThread.
[in] aFrame
מצביע אל המסגרת שברצונך לשדר.
ערכי החזרה
OT_ERROR_NONE
ההעברה בוצעה בהצלחה.
OT_ERROR_INVALID_STATE
הרדיו לא היה במצב קבלה.

OTPlatRadioTxDone

void otPlatRadioTxDone(
  otInstance *aInstance,
  otRadioFrame *aFrame,
  otRadioFrame *aAckFrame,
  otError aError
)

נהג הרדיו קורא לפונקציה הזו כדי להודיע ל-OpenThread שפעולת השידור הושלמה, ומספקת גם את המסגרת המשודרת וגם את מסגרת ack שהתקבלה, אם רלוונטי.

כשרדיו מספק יכולת OT_RADIO_CAPS_TRANSMIT_SEC, שכבת פלטפורמת הרדיו מעדכנת את aFrame עם המונה של מסגרת האבטחה ועם ערכי האינדקס העיקריים שנשמרו על ידי הרדיו.

פרטים
פרמטרים
[in] aInstance
מבנה המופע של OpenThread.
[in] aFrame
מצביע על המסגרת ששודרה.
[in] aAckFrame
מצביע למסגרת ACK, NULL אם לא התקבל ACK.
[in] aError
OT_ERROR_NONE כשהמסגרת שודרה, OT_ERROR_NO_ACK כאשר המסגרת הועברה אך לא התקבלה ACK, OT_ERROR_CHANNEL_ACCESS_FAILURE TX לא היה יכול להתבצע עקב פעילות בערוץ, OT_ERROR_ABORT כאשר ההעברה בוטלה מסיבות אחרות.

otPlatRadioTxStarted

void otPlatRadioTxStarted(
  otInstance *aInstance,
  otRadioFrame *aFrame
)

נהג הרדיו קורא לשיטה הזו כדי להודיע ל-OpenThread שהשידור התחיל.

פרטים
פרמטרים
[in] aInstance
מצביע על מבנה המופע של OpenThread.
[in] aFrame
מצביע על המסגרת שמשודרת.

otPlatRadioUpdateCslSampleTime

void otPlatRadioUpdateCslSampleTime(
  otInstance *aInstance,
  uint32_t aCslSampleTime
)

עדכון זמן הדגימה של CSL בנהג רדיו.

זמן הדגימה נשמר במנהל ההתקן כעותק כדי לחשב את השלב בעת שליחת ACK עם CSL IE.

פרטים
פרמטרים
[in] aInstance
מבנה המופע של OpenThread.
[in] aCslSampleTime
זמן הדגימה האחרון.

משאבים

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