הגדרת רדיו

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

סיכום

פונקציות
otPlatRadioGetBusSpeed(otInstance *aInstance)	uint32_t מדידת מהירות האוטובוס לפי מספר הביטים לשנייה בין המארח לצ'יפ הרדיו.
otPlatRadioGetCaps(otInstance *aInstance)	otRadioCaps קבל את יכולות הרדיו.
otPlatRadioGetCcaEnergyDetectThreshold(otInstance *aInstance, int8_t *aThreshold)	otError קביעת סף CCA ED של הרדיו ב-dBm, הנמדדת במחבר האנטנה בהתאם לסעיף 10.1.4 של IEEE 802.15.4 - 2015.
otPlatRadioGetFemLnaGain(otInstance *aInstance, int8_t *aGain)	otError מקבל את תוספת ה-Rx LNA של ה-FEM החיצוני ב-dBm.
otPlatRadioGetIeeeEui64(otInstance *aInstance, uint8_t *aIeeeEui64)	void מקבל את IEEE EUI-64 שהוקצה על-ידי היצרן לממשק זה.
otPlatRadioGetNow(otInstance *aInstance)	uint64_t קבלת השעה הנוכחית במיליוניות השנייה שמוזכרת בשעון רדיו מקומי מונוטוני רציף (ברוחב 64 סיביות).
otPlatRadioGetPromiscuous(otInstance *aInstance)	bool קבלת הסטטוס של מצב פרוץ.
otPlatRadioGetReceiveSensitivity(otInstance *aInstance)	int8_t צריך להשיג את ערך הרגישות של הרדיו.
otPlatRadioGetTransmitPower(otInstance *aInstance, int8_t *aPower)	otError עוצמת השידור של הרדיו נמצאת ב-dBm.
otPlatRadioGetVersionString(otInstance *aInstance)	const char * מקבלים את המחרוזת של גרסת הרדיו.
otPlatRadioSetCcaEnergyDetectThreshold(otInstance *aInstance, int8_t aThreshold)	otError מגדירים את סף ה-CCA ED של הרדיו ב-dBm שנמדד במחבר אנטנה לפי סעיף 10.1.4 של IEEE 802.15.4-2015.
otPlatRadioSetExtendedAddress(otInstance *aInstance, const otExtAddress *aExtAddress)	void הגדרת 'כתובת מורחבת' לסינון כתובות.
otPlatRadioSetFemLnaGain(otInstance *aInstance, int8_t aGain)	otError מגדיר את הגברת ה-Rx LNA של ה-FEM החיצוני ב-dBm.
otPlatRadioSetMacFrameCounter(otInstance *aInstance, uint32_t aMacFrameCounter)	void מגדיר את הערך הנוכחי של מונה המסגרות של MAC.
otPlatRadioSetMacFrameCounterIfLarger(otInstance *aInstance, uint32_t aMacFrameCounter)	void מגדירה את הערך הנוכחי של מונה המסגרות של MAC רק אם הערך הנתון החדש גדול מהערך הנוכחי.
otPlatRadioSetMacKey(otInstance *aInstance, uint8_t aKeyIdMode, uint8_t aKeyId, const otMacKeyMaterial *aPrevKey, const otMacKeyMaterial *aCurrKey, const otMacKeyMaterial *aNextKey, otRadioKeyType aKeyType)	void עדכון מפתחות MAC ואינדקס מפתחות.
otPlatRadioSetPanId(otInstance *aInstance, otPanId aPanId)	void מגדירים את מזהה ה-PAN (מספר חשבון קבוע) לסינון כתובות.
otPlatRadioSetPromiscuous(otInstance *aInstance, bool aEnable)	void הפעלה או השבתה של מצב פרוץ.
otPlatRadioSetRxOnWhenIdle(otInstance *aInstance, bool aEnable)	void מגדיר את מצב 'חוסר פעילות' לפלטפורמת הרדיו.
otPlatRadioSetShortAddress(otInstance *aInstance, otShortAddress aShortAddress)	void מגדירים את הכתובת המקוצרת לסינון כתובות.
otPlatRadioSetTransmitPower(otInstance *aInstance, int8_t aPower)	otError מגדירים את עוצמת השידור של הרדיו ב-dBm.

פונקציות

otPlatRadioGetBusSpeed

uint32_t otPlatRadioGetBusSpeed(
  otInstance *aInstance
)

מדידת מהירות האוטובוס לפי מספר הביטים לשנייה בין המארח לצ'יפ הרדיו.

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

otPlatRadioGetCaps

otRadioCaps otPlatRadioGetCaps(
  otInstance *aInstance
)

קבל את יכולות הרדיו.

פרטים
פרמטרים	[in] aInstance מבנה המכונה של OpenThread.
החזרות	וקטור הביט של יכולת הרדיו (יש לעיין בהגדרות של OT_RADIO_CAP_*).

otPlatRadioGetCcaEnergyDetectThreshold

otError otPlatRadioGetCcaEnergyDetectThreshold(
  otInstance *aInstance,
  int8_t *aThreshold
)

קביעת סף CCA ED של הרדיו ב-dBm, הנמדדת במחבר האנטנה בהתאם לסעיף 10.1.4 של IEEE 802.15.4 - 2015.

פרטים
פרמטרים	[in] aInstance מבנה המכונה של OpenThread. [out] aThreshold סף CCA ED ב-dBm.
ערכים מוחזרים	OT_ERROR_NONE אחזור הסף של CCA ED בוצע בהצלחה. OT_ERROR_INVALID_ARGS הערך של aThreshold היה NULL. OT_ERROR_NOT_IMPLEMENTED הגדרת סף CCA ED דרך dBm לא מוטמעת.

otPlatRadioGetFemLnaGain

otError otPlatRadioGetFemLnaGain(
  otInstance *aInstance,
  int8_t *aGain
)

מקבל את תוספת ה-Rx LNA של ה-FEM החיצוני ב-dBm.

פרטים
פרמטרים	[in] aInstance מבנה המכונה של OpenThread. [out] aGain רווח Rx LNA של ה-FEM החיצוני ב-dBm.
ערכים מוחזרים	OT_ERROR_NONE אחזור ה-LNA של ה-FEM החיצוני בוצע בהצלחה. OT_ERROR_INVALID_ARGS הערך של aGain היה NULL. OT_ERROR_NOT_IMPLEMENTED הגדרת LNA של FEM חיצוני לא מיושמת.

otPlatRadioGetIeeeEui64

void otPlatRadioGetIeeeEui64(
  otInstance *aInstance,
  uint8_t *aIeeeEui64
)

מקבל את IEEE EUI-64 שהוקצה על-ידי היצרן לממשק זה.

פרטים
פרמטרים	[in] aInstance מבנה המכונה של OpenThread. [out] aIeeeEui64 הפניה ל-IEEE EUI-64 שהוקצה על ידי היצרן.

otPlatRadioGetNow

uint64_t otPlatRadioGetNow(
  otInstance *aInstance
)

קבלת השעה הנוכחית במיליוניות השנייה שמוזכרת בשעון רדיו מקומי מונוטוני רציף (ברוחב 64 סיביות).

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

יכול להיות שההטמעות יבחרו לכוונן את שעון הרדיו ולפצות על זמני השינה בכל אמצעי כלשהו (למשל, על ידי שילוב RTC עם דיוק גבוה/צריכת חשמל נמוכה עם מונה ברזולוציה גבוהה), כל עוד השעון המשולב החשוף מספק סימונים רציפים ברזולוציה של מיקרו שניות, במסגרת מגבלות הדיוק שנקבעו על ידי otPlatRadioGetCslAccuracy.

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

otPlatRadioGetPromiscuous

bool otPlatRadioGetPromiscuous(
  otInstance *aInstance
)

קבלת הסטטוס של מצב פרוץ.

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

otPlatRadioGetReceiveSensitivity

int8_t otPlatRadioGetReceiveSensitivity(
  otInstance *aInstance
)

צריך להשיג את ערך הרגישות של הרדיו.

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

otPlatRadioGetTransmitPower

otError otPlatRadioGetTransmitPower(
  otInstance *aInstance,
  int8_t *aPower
)

עוצמת השידור של הרדיו נמצאת ב-dBm.

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

פרטים
פרמטרים	[in] aInstance מבנה המכונה של OpenThread. [out] aPower עוצמת השידור ב-dBm.
ערכים מוחזרים	OT_ERROR_NONE עוצמת השידור נשלפה בהצלחה. OT_ERROR_INVALID_ARGS הערך של aPower היה NULL. OT_ERROR_NOT_IMPLEMENTED שידור הגדרות חשמל דרך dBm לא מיושם.

otPlatRadioGetVersionString

const char * otPlatRadioGetVersionString(
  otInstance *aInstance
)

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

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

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

למידע נוסף:
otGetVersionString()).

otPlatRadioSetCcaEnergyDetectThreshold

otError otPlatRadioSetCcaEnergyDetectThreshold(
  otInstance *aInstance,
  int8_t aThreshold
)

מגדירים את סף ה-CCA ED של הרדיו ב-dBm שנמדד במחבר אנטנה לפי סעיף 10.1.4 של IEEE 802.15.4-2015.

פרטים
פרמטרים	[in] aInstance מבנה המכונה של OpenThread. [in] aThreshold סף CCA ED ב-dBm.
ערכים מוחזרים	OT_ERROR_NONE עוצמת השידור הוגדרה בהצלחה. OT_ERROR_INVALID_ARGS הסף הנתון נמצא מחוץ לטווח. OT_ERROR_NOT_IMPLEMENTED הגדרת סף CCA ED דרך dBm לא מוטמעת.

otPlatRadioSetExtendedAddress

void otPlatRadioSetExtendedAddress(
  otInstance *aInstance,
  const otExtAddress *aExtAddress
)

הגדרת 'כתובת מורחבת' לסינון כתובות.

פרטים
פרמטרים	[in] aInstance מבנה המכונה של OpenThread. [in] aExtAddress הפניה לכתובת מורחבת של IEEE 802.15.4 המאוחסנת בסדר בייטים קטנים.

otPlatRadioSetFemLnaGain

otError otPlatRadioSetFemLnaGain(
  otInstance *aInstance,
  int8_t aGain
)

מגדיר את הגברת ה-Rx LNA של ה-FEM החיצוני ב-dBm.

פרטים
פרמטרים	[in] aInstance מבנה המכונה של OpenThread. [in] aGain רווח Rx LNA של ה-FEM החיצוני ב-dBm.
ערכים מוחזרים	OT_ERROR_NONE הוגדר בהצלחה רווח LNA של FEM החיצוני. OT_ERROR_NOT_IMPLEMENTED ההגדרה 'רווח LNA' של FEM חיצוני לא מיושמת.

otPlatRadioSetMacFrameCounter

void otPlatRadioSetMacFrameCounter(
  otInstance *aInstance,
  uint32_t aMacFrameCounter
)

מגדיר את הערך הנוכחי של מונה המסגרות של MAC.

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

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

otPlatRadioSetMacFrameCounterIfLarger

void otPlatRadioSetMacFrameCounterIfLarger(
  otInstance *aInstance,
  uint32_t aMacFrameCounter
)

מגדירה את הערך הנוכחי של מונה המסגרות של MAC רק אם הערך הנתון החדש גדול מהערך הנוכחי.

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

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

otPlatRadioSetMacKey

void otPlatRadioSetMacKey(
  otInstance *aInstance,
  uint8_t aKeyIdMode,
  uint8_t aKeyId,
  const otMacKeyMaterial *aPrevKey,
  const otMacKeyMaterial *aCurrKey,
  const otMacKeyMaterial *aNextKey,
  otRadioKeyType aKeyType
)

עדכון מפתחות MAC ואינדקס מפתחות.

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

פרטים
פרמטרים	[in] aInstance מצביע למופע של OpenThread. [in] aKeyIdMode המצב של מזהה המפתח. [in] aKeyId אינדקס מפתח MAC נוכחי. [in] aPrevKey מצביע על מפתח ה-MAC הקודם. [in] aCurrKey מצביע על מפתח ה-MAC הנוכחי. [in] aNextKey מצביע על מקש ה-MAC הבא. [in] aKeyType נעשה שימוש בסוג המפתח.

otPlatRadioSetPanId

void otPlatRadioSetPanId(
  otInstance *aInstance,
  otPanId aPanId
)

מגדירים את מזהה ה-PAN (מספר חשבון קבוע) לסינון כתובות.

פרטים
פרמטרים	[in] aInstance מבנה המכונה של OpenThread. [in] aPanId מזהה IEEE 802.15.4 PAN.

otPlatRadioSetPromiscuous

void otPlatRadioSetPromiscuous(
  otInstance *aInstance,
  bool aEnable
)

הפעלה או השבתה של מצב פרוץ.

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

otPlatRadioSetRxOnWhenIdle

void otPlatRadioSetRxOnWhenIdle(
  otInstance *aInstance,
  bool aEnable
)

מגדיר את מצב 'חוסר פעילות' לפלטפורמת הרדיו.

יש מספר מצבים שבהם הרדיו יכול לעבור למצב שינה אם המכשיר נמצא במצב 'חוסר פעילות', אבל קשה ויקר ל-SubMac לזהות מצבים אלה ולהורות לרדיו לעבור למצב שינה:

• השלמת משימה רגילה של קבלת מסגרות, בתנאי ש:
  • הפריים מתקבל ללא שגיאות ועובר את הסינון וזה לא ACK מלאכותי.
  • אין בקשה ל-ACK או שאין אפשרות להעביר ACK עקב תנאים פנימיים.
• השלמת שידור של מסגרת או תמסורת של מסגרת ACK, כאשר אין בקשה ל-ACK במסגרת המשודרת.
• השלמת פעולת הקבלה של ACK מבוקש עקב:
  • תפוגת הזמן הקצוב ל-ACK.
  • קבלה של ACK לא חוקי או לא מסגרת ACK.
  • הקבלה של ה-ACK הנכון, אלא אם המסגרת ששודרה הייתה פקודת בקשת נתונים והביט בהמתנה ב-ACK שהתקבל מוגדר כ-true. במקרה הזה, ההטמעה של פלטפורמת הרדיו אמורה להשאיר את המקלט מופעל עד לסיום הזמן הקצוב לתפוגה שמפעיל את פרק הזמן ללא פעילות.OPENTHREAD_CONFIG_MAC_DATA_POLL_TIMEOUT יכול לשמש כהפניה לכך.
• השלמת משימה עצמאית של CCA.
• השלמת פעולת CCA עם תוצאה עמוסה במהלך הליך CSMA/CA.
• השלמת משימה של זיהוי אנרגיה.
• השלמת החלון של קליטת רדיו תוזמן עם otPlatRadioReceiveAt.

אם פלטפורמה תומכת ב-OT_RADIO_CAPS_RX_ON_WHEN_IDLE, היא צריכה גם לתמוך ב-OT_RADIO_CAPS_CSMA_BACKOFF ולטפל בתקופות של חוסר פעילות אחרי CCA, כפי שמתואר למעלה.

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

otPlatRadioSetShortAddress

void otPlatRadioSetShortAddress(
  otInstance *aInstance,
  otShortAddress aShortAddress
)

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

פרטים
פרמטרים	[in] aInstance מבנה המכונה של OpenThread. [in] aShortAddress הכתובת המקוצרת של IEEE 802.15.4.

otPlatRadioSetTransmitPower

otError otPlatRadioSetTransmitPower(
  otInstance *aInstance,
  int8_t aPower
)

מגדירים את עוצמת השידור של הרדיו ב-dBm.

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

פרטים
פרמטרים	[in] aInstance מבנה המכונה של OpenThread. [in] aPower עוצמת השידור ב-dBm.
ערכים מוחזרים	OT_ERROR_NONE עוצמת השידור הוגדרה בהצלחה. OT_ERROR_NOT_IMPLEMENTED שידור הגדרות חשמל דרך dBm לא מיושם.

מקורות מידע

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