הפעלת רדיו

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

סיכום

פונקציות
otPlatDiagRadioReceiveDone(otInstance *aInstance, otRadioFrame *aFrame, otError aError)	void מנהל הרדיו מפעיל את השיטה הזו כדי להודיע למודול האבחון של OpenThread של פריים שהתקבל.
otPlatDiagRadioTransmitDone(otInstance *aInstance, otRadioFrame *aFrame, otError aError)	void מנהל הרדיו מפעיל את השיטה הזו כדי להודיע למודול האבחון של OpenThread שההעברה הושלמה.
otPlatRadioAddCalibratedPower(otInstance *aInstance, uint8_t aChannel, int16_t aActualPower, const uint8_t *aRawPowerSetting, uint16_t aRawPowerSettingLength)	otError צריך להוסיף עוצמה מכוילת של הערוץ שצוין לטבלת כיול החשמל.
otPlatRadioAddSrcMatchExtEntry(otInstance *aInstance, const otExtAddress *aExtAddress)	otError להוסיף כתובת מורחבת לטבלת ההתאמות של כתובת המקור.
otPlatRadioAddSrcMatchShortEntry(otInstance *aInstance, otShortAddress aShortAddress)	otError מוסיפים כתובת קצרה לטבלת ההתאמות של כתובת המקור.
otPlatRadioClearCalibratedPowers(otInstance *aInstance)	otError הסרת כל הכוחות המכויילים מטבלת הכיולות של החשמל.
otPlatRadioClearSrcMatchExtEntries(otInstance *aInstance)	void ניקוי כל הכתובות המורחבות/הארוכות מטבלת ההתאמות של כתובות המקור.
otPlatRadioClearSrcMatchExtEntry(otInstance *aInstance, const otExtAddress *aExtAddress)	otError צריך להסיר כתובת מורחבת מטבלת ההתאמות של כתובת המקור.
otPlatRadioClearSrcMatchShortEntries(otInstance *aInstance)	void יש לנקות את כל הכתובות הקצרות מטבלת ההתאמות של כתובות המקור.
otPlatRadioClearSrcMatchShortEntry(otInstance *aInstance, otShortAddress aShortAddress)	otError צריך להסיר כתובת קצרה מטבלת ההתאמות של כתובות המקור.
otPlatRadioConfigureEnhAckProbing(otInstance *aInstance, otLinkMetrics aLinkMetrics, otShortAddress aShortAddress, const otExtAddress *aExtAddress)	otError הפעלה/השבתה או עדכון של התכונה 'בדיקת מעקב מבוסס-ACK משופרת' ברדיו ליוזם ספציפי.
otPlatRadioDisable(otInstance *aInstance)	otError השבתת הרדיו.
otPlatRadioEnable(otInstance *aInstance)	otError הפעלת הרדיו.
otPlatRadioEnableCsl(otInstance *aInstance, uint32_t aCslPeriod, otShortAddress aShortAddr, const otExtAddress *aExtAddr)	otError הפעלה או השבתה של מקלט CSL.
otPlatRadioEnableSrcMatch(otInstance *aInstance, bool aEnable)	void הפעלה/השבתה של תכונת ההתאמה לכתובת המקור.
otPlatRadioEnergyScan(otInstance *aInstance, uint8_t aScanChannel, uint16_t aScanDuration)	otError מתחילים את רצף סריקת האנרגיה ברדיו.
otPlatRadioEnergyScanDone(otInstance *aInstance, int8_t aEnergyScanMaxRssi)	void מנהל הרדיו מבצע קריאה לשיטה הזו כדי להודיע ל-OpenThread שסריקת האנרגיה הושלמה.
otPlatRadioGetCoexMetrics(otInstance *aInstance, otRadioCoexMetrics *aCoexMetrics)	otError קבלת המדדים של דו-קיום ברדיו.
otPlatRadioGetCslAccuracy(otInstance *aInstance)	uint8_t קבל את הדיוק המשוער הנוכחי של המקרים הגרועים ביותר (מקסימום ± סטייה מהתדר הנומינלי) של שעון הרדיו המקומי ביחידות של PPM.
otPlatRadioGetCslUncertainty(otInstance *aInstance)	uint8_t אי-הוודאות הקבועה (כלומר
otPlatRadioGetPreferredChannelMask(otInstance *aInstance)	uint32_t הפונקציה מקבלת את מסכת הערוצים המועדפת לרדיו שהמכשיר מעדיף ליצור עליה.
otPlatRadioGetRawPowerSetting(otInstance *aInstance, uint8_t aChannel, uint8_t *aRawPowerSetting, uint16_t *aRawPowerSettingLength)	otError קבלת הגדרת העוצמה הגולמית של הערוץ הנתון.
otPlatRadioGetRegion(otInstance *aInstance, uint16_t *aRegionCode)	otError מקבלים את קוד האזור.
otPlatRadioGetRssi(otInstance *aInstance)	int8_t קבלת מדידת ה-RSSI העדכנית ביותר.
otPlatRadioGetState(otInstance *aInstance)	otRadioState קבלת המצב הנוכחי של הרדיו.
otPlatRadioGetSupportedChannelMask(otInstance *aInstance)	uint32_t צריך לקבל את מסכת הערוצים עם תמיכה ברדיו שהמכשיר מורשה לפעול בה.
otPlatRadioGetTransmitBuffer(otInstance *aInstance)	otRadioFrame * קבל את האחסון הזמני של מסגרת שידור הרדיו.
otPlatRadioIsCoexEnabled(otInstance *aInstance)	bool בודקים אם רדיו coex מופעל או לא.
otPlatRadioIsEnabled(otInstance *aInstance)	bool בדוק אם הרדיו מופעל או לא.
otPlatRadioReceive(otInstance *aInstance, uint8_t aChannel)	otError העברת הרדיו ממצב שינה למצב קבלה (הפעלת הרדיו).
otPlatRadioReceiveAt(otInstance *aInstance, uint8_t aChannel, uint32_t aStart, uint32_t aDuration)	otError תזמן חלון קליטת רדיו בשעה ובמשך זמן ספציפיים.
otPlatRadioReceiveDone(otInstance *aInstance, otRadioFrame *aFrame, otError aError)	void מנהל הרדיו קורא לשיטה הזו כדי להודיע ל-OpenThread על פריים שהתקבל.
otPlatRadioSetChannelMaxTransmitPower(otInstance *aInstance, uint8_t aChannel, int8_t aMaxPower)	otError הגדרת הספק השידור המקסימלי לערוץ ספציפי.
otPlatRadioSetChannelTargetPower(otInstance *aInstance, uint8_t aChannel, int16_t aTargetPower)	otError הגדרה של כוח היעד לערוץ הנתון.
otPlatRadioSetCoexEnabled(otInstance *aInstance, bool aEnabled)	otError הפעלת שיתוף הרדיו.
otPlatRadioSetRegion(otInstance *aInstance, uint16_t aRegionCode)	otError מגדירים את קוד האזור.
otPlatRadioSleep(otInstance *aInstance)	otError העברת הרדיו ממצב 'קבלה' למצב שינה (כיבוי הרדיו).
otPlatRadioTransmit(otInstance *aInstance, otRadioFrame *aFrame)	otError התחלת רצף השידור ברדיו.
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 במנהל הרדיו.

פונקציות

otPlatDiagRadioReceiveDone

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 כשלא ניתן היה לקבל מסגרת עקב חוסר מקום למאגר אחסון זמני rx.

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 השידור בוטל מסיבות אחרות.

otPlatRadioAddCalibratedPower

otError otPlatRadioAddCalibratedPower(
  otInstance *aInstance,
  uint8_t aChannel,
  int16_t aActualPower,
  const uint8_t *aRawPowerSetting,
  uint16_t aRawPowerSettingLength
)

צריך להוסיף עוצמה מכוילת של הערוץ שצוין לטבלת כיול החשמל.

הערה: ה-API הזה הוא ממשק API אופציונלי לפלטפורמת הרדיו. ההחלטה להטמיע אותו תלויה בשכבת הפלטפורמה.

הערך aActualPower הוא מתח הפלט שנמדד בפועל כאשר הפרמטרים של המודולים של חומרת הרדיו מוגדרים ל-aRawPowerSetting.

הגדרת העוצמה הגולמית היא מערך בייטים אטומים. OpenThread לא מגדיר את הפורמט של הגדרות העוצמה הגולמיות. הפורמט שלה קשור לחומרת רדיו, והמפתחים צריכים להגדיר אותו במנהל הרדיו של הפלטפורמה. לדוגמה, אם חומרת הרדיו מכילה גם שבב רדיו וגם שבב FEM, הגדרת העוצמה הגולמית יכולה להיות שילוב של רישום כוח הרדיו וערך השיפור של FEM.

פרטים
פרמטרים	[in] aInstance מבנה המכונה של OpenThread. [in] aChannel ערוץ הרדיו. [in] aActualPower ההספק בפועל ב-0.01dBm. [in] aRawPowerSetting מצביעה למערך הבייטים של הגדרת העוצמה הגולמית. [in] aRawPowerSettingLength האורך של aRawPowerSetting.
ערכים מוחזרים	OT_ERROR_NONE העוצמה המכויילת נוספה בהצלחה לטבלת כיול החשמל. OT_ERROR_NO_BUFS אין רשומה זמינה בטבלת כיול החשמל. OT_ERROR_INVALID_ARGS הערכים aChannel, aActualPower או aRawPowerSetting לא חוקיים או שה-aActualPower כבר קיים בטבלת כיול החשמל. OT_ERROR_NOT_IMPLEMENTED התכונה הזו לא מוטמעת.

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 אין ערך זמין בטבלת ההתאמות של המקור.

otPlatRadioClearCalibratedPowers

otError otPlatRadioClearCalibratedPowers(
  otInstance *aInstance
)

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

הערה: ה-API הזה הוא ממשק API אופציונלי לפלטפורמת הרדיו. ההחלטה להטמיע אותו תלויה בשכבת הפלטפורמה.

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

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 הכתובת המקוצרת לא נמצאת בטבלת ההתאמות של כתובות המקור.

otPlatRadioConfigureEnhAckProbing

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

הפעלה/השבתה או עדכון של התכונה 'בדיקת מעקב מבוסס-ACK משופרת' ברדיו ליוזם ספציפי.

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

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

otPlatRadioDisable

otError otPlatRadioDisable(
  otInstance *aInstance
)

השבתת הרדיו.

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

otPlatRadioEnable

otError otPlatRadioEnable(
  otInstance *aInstance
)

הפעלת הרדיו.

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

otPlatRadioEnableCsl

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

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

הערה: פלטפורמות צריכות להשתמש בכתובות דומות ב-CSL כדי לכלול CSL IE ביצירת Acks משופר.

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

otPlatRadioEnableSrcMatch

void otPlatRadioEnableSrcMatch(
  otInstance *aInstance,
  bool aEnable
)

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

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

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

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

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

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

otPlatRadioEnergyScan

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

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

נעשה שימוש כאשר הרדיו מספק יכולת OT_Radio_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_Radio_CAPS_ENERGY_SCAN.

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

otPlatRadioGetCoexMetrics

otError otPlatRadioGetCoexMetrics(
  otInstance *aInstance,
  otRadioCoexMetrics *aCoexMetrics
)

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

בשימוש כאשר התכונה OPENthread_CONFIG_PLATFORM_ALERT_COEX_ENABLE מופעלת.

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

otPlatRadioGetCslAccuracy

uint8_t otPlatRadioGetCslAccuracy(
  otInstance *aInstance
)

קבל את הדיוק המשוער הנוכחי של המקרים הגרועים ביותר (מקסימום ± סטייה מהתדר הנומינלי) של שעון הרדיו המקומי ביחידות של PPM.

זה השעון שמשמש לתזמון פעולות CSL.

הערה: ייתכן שהטמעות יוכלו להעריך את הערך הזה על סמך תנאי ההפעלה הנוכחיים (למשל, טמפרטורה).

אם ההטמעה לא מבצעת הערכה של הערך הנוכחי אבל מחזירה ערך קבוע, הערך הזה חייב להיות הדיוק במקרה הגרוע ביותר בכל תנאי ההפעלה הצפויים (טמפרטורה, לחץ וכו') של ההטמעה.

פרטים
פרמטרים	[in] aInstance מצביע למופע של OpenThread.
החזרות	סחף התזמון הנוכחי של CSL rx/tx, ב-PPM.

otPlatRadioGetCslUncertainty

uint8_t otPlatRadioGetCslUncertainty(
  otInstance *aInstance
)

אי-הוודאות הקבועה (כלומר

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

המדד הזה מציין את הסטייה החיובית או השלילית הקבועה במקרה הגרוע ביותר מזמן ההגעה בפועל של השידור מזמן השידור המחושב ביחס לשעון הרדיו המקומי, ללא קשר לזמן שחלף. בנוסף לאי-הוודאות המצטברת עם הזמן שחלף, יש להרחיב את דגימת ערוצי ה-CSL ("חלון RX") פי שניים, כך מובטח ששידור בפועל יזוהה על ידי המקלט המקומי בנוכחות רעידות זמן הגעה אקראיות.

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

otPlatRadioGetPreferredChannelMask

uint32_t otPlatRadioGetPreferredChannelMask(
  otInstance *aInstance
)

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

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

otPlatRadioGetRawPowerSetting

otError otPlatRadioGetRawPowerSetting(
  otInstance *aInstance,
  uint8_t aChannel,
  uint8_t *aRawPowerSetting,
  uint16_t *aRawPowerSettingLength
)

קבלת הגדרת העוצמה הגולמית של הערוץ הנתון.

הערה: ב-OpenThread src/core/utils מוטמע יישום ברירת מחדל של ה-API otPlatRadioAddCalibratedPower(), otPlatRadioClearCalibratedPowers() ו-otPlatRadioSetChannelTargetPower(). ה-API הזה מסופק על ידי יישום ברירת המחדל כדי לקבל את הגדרת העוצמה הגולמית עבור הערוץ הנתון. אם הפלטפורמה לא משתמשת בהטמעת ברירת המחדל, אפשר להתעלם מה-API הזה.

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

פרטים
פרמטרים	[in] aInstance מבנה המכונה של OpenThread. [in] aChannel ערוץ הרדיו. [out] aRawPowerSetting מצביעה למערך הבייטים של הגדרת העוצמה הגולמית. [in,out] aRawPowerSettingLength בקלט, מצביע על גודל של aRawPowerSetting. בפלט, מצביע על אורך הנתונים הגולמיים של הגדרת העוצמה.
ערכים מוחזרים	OT_ERROR_NONE כוח היעד הגיע בהצלחה. OT_ERROR_INVALID_ARGS הערך aChannel לא חוקי, הערך aRawPowerSetting או aRawPowerSettingLength הוא NULL או שהוא קצר מדי. OT_ERROR_NOT_FOUND לא נמצאה הגדרת ההפעלה הגולמית של aChannel.

otPlatRadioGetRegion

otError otPlatRadioGetRegion(
  otInstance *aInstance,
  uint16_t *aRegionCode
)

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

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

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

otPlatRadioGetRssi

int8_t otPlatRadioGetRssi(
  otInstance *aInstance
)

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

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

otPlatRadioGetState

otRadioState otPlatRadioGetState(
  otInstance *aInstance
)

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

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

הערה: יכול להיות שהפונקציה הזו לא מוטמעת. מצב זה לא משפיע על 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
)

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

בשימוש כאשר התכונה OPENthread_CONFIG_PLATFORM_ALERT_COEX_ENABLE מופעלת.

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

otPlatRadioIsEnabled

bool otPlatRadioIsEnabled(
  otInstance *aInstance
)

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

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

otPlatRadioReceive

otError otPlatRadioReceive(
  otInstance *aInstance,
  uint8_t aChannel
)

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

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

otPlatRadioReceiveAt

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

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

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

otPlatRadioReceiveDone

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 כשלא ניתן היה לקבל מסגרת עקב חוסר מקום למאגר אחסון זמני rx.

otPlatRadioSetChannelMaxTransmitPower

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

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

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

otPlatRadioSetChannelTargetPower

otError otPlatRadioSetChannelTargetPower(
  otInstance *aInstance,
  uint8_t aChannel,
  int16_t aTargetPower
)

הגדרה של כוח היעד לערוץ הנתון.

הערה: ה-API הזה הוא ממשק API אופציונלי לפלטפורמת הרדיו. ההחלטה להטמיע אותו תלויה בשכבת הפלטפורמה. אם ה-API הזה מוטמע, צריך להשבית את הפונקציה otPlatRadioSetTransmitPower().

מנהל ההתקן של הרדיו צריך להגדיר את ההספק בפועל להספק קטן או שווה להספק היעד, וקרוב ככל האפשר להספק היעד.

פרטים
פרמטרים	[in] aInstance מבנה המכונה של OpenThread. [in] aChannel ערוץ הרדיו. [in] aTargetPower כוח היעד ב- 0.01dBm. מעבר של INT16_MAX ישבית את הערוץ הזה לשימוש במתח היעד.
ערכים מוחזרים	OT_ERROR_NONE עוצמת היעד הוגדרה בהצלחה. OT_ERROR_INVALID_ARGS הערכים aChannel או aTargetPower לא חוקיים. OT_ERROR_NOT_IMPLEMENTED התכונה לא מוטמעת.

otPlatRadioSetCoexEnabled

otError otPlatRadioSetCoexEnabled(
  otInstance *aInstance,
  bool aEnabled
)

הפעלת שיתוף הרדיו.

בשימוש כאשר התכונה OPENthread_CONFIG_PLATFORM_ALERT_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 alpha-2.

פרטים
פרמטרים	[in] aInstance מבנה המכונה של OpenThread. [in] aRegionCode קוד האזור של הרדיו. aRegionCode >> 8 הוא צ'אר ASCII הראשון ו-aRegionCode & 0xff הוא צ'אר ASCII השני.
ערכים מוחזרים	OT_ERROR_FAILED שגיאות אחרות שספציפיות לפלטפורמה. OT_ERROR_NONE קוד האזור הוגדר בהצלחה. OT_ERROR_NOT_IMPLEMENTED התכונה לא מוטמעת.

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_Radio_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. אם לא התקבל ACK, הערך NULL. [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 שהשידור החל.

הערה: צריך לקרוא לפונקציה הזו באמצעות אותו שרשור שמריץ את כל קוד OpenThread האחר. היא לא אמורה להיקרא על ידי ISR או כל משימה אחרת.

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

otPlatRadioUpdateCslSampleTime

void otPlatRadioUpdateCslSampleTime(
  otInstance *aInstance,
  uint32_t aCslSampleTime
)

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

זמן הדגימה מאוחסן במנהל התקן הרדיו כעותק לחישוב השלב בעת שליחת ACK באמצעות CSL IE. דגימת ה-CSL (החלון) של מקלט ה-CSL נמשכת לפני ואחרי זמן הדגימה. זמן דגימת ה-CSL מסמן חותמת זמן בחלון של דגימת ה-CSL, שבה צריך לקבל פריים ב'תנאים אידיאליים' אם לא קיים אי דיוק או סטייה בשעון.

פרטים
פרמטרים	[in] aInstance מבנה המכונה של OpenThread. [in] aCslSampleTime שעת הדגימה הבאה, במיליוניות השנייה. זוהי השעה שבה צפוי הסמל הראשון של ה-MHR של המסגרת.

מקורות מידע

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