סוגי רדיו

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

סיכום

ספירות

anonymous enum{
  OT_RADIO_FRAME_MAX_SIZE = 127,
  OT_RADIO_FRAME_MIN_SIZE = 3,
  OT_RADIO_SYMBOLS_PER_OCTET = 2,
  OT_RADIO_BIT_RATE = 250000,
  OT_RADIO_BITS_PER_OCTET = 8,
  OT_RADIO_SYMBOL_RATE = 62500,
  OT_RADIO_SYMBOL_TIME = 1000000 * 1 / OT_RADIO_SYMBOL_RATE,
  OT_RADIO_TEN_SYMBOLS_TIME = 10 * OT_RADIO_SYMBOL_TIME,
  OT_RADIO_LQI_NONE = 0,
  OT_RADIO_RSSI_INVALID = 127,
  OT_RADIO_POWER_INVALID = 127
}
טיפוסים בני מנייה (enum)
anonymous enum{
  OT_RADIO_CHANNEL_PAGE_0 = 0,
  OT_RADIO_CHANNEL_PAGE_0_MASK = (1U << OT_RADIO_CHANNEL_PAGE_0),
  OT_RADIO_CHANNEL_PAGE_2 = 2,
  OT_RADIO_CHANNEL_PAGE_2_MASK = (1U << OT_RADIO_CHANNEL_PAGE_2)
}
טיפוסים בני מנייה (enum)
מגדיר את דף הערוץ.
anonymous enum{
  OT_RADIO_915MHZ_OQPSK_CHANNEL_MIN = 1,
  OT_RADIO_915MHZ_OQPSK_CHANNEL_MAX = 10,
  OT_RADIO_915MHZ_OQPSK_CHANNEL_MASK = 0x3ff << OT_RADIO_915MHZ_OQPSK_CHANNEL_MIN,
  OT_RADIO_2P4GHZ_OQPSK_CHANNEL_MIN = 11,
  OT_RADIO_2P4GHZ_OQPSK_CHANNEL_MAX = 26,
  OT_RADIO_2P4GHZ_OQPSK_CHANNEL_MASK = 0xffff << OT_RADIO_2P4GHZ_OQPSK_CHANNEL_MIN
}
טיפוסים בני מנייה (enum)
מגדירה את טווח הערוצים של תחום התדרים.
anonymous enum{
  OT_RADIO_CAPS_NONE = 0,
  OT_RADIO_CAPS_ACK_TIMEOUT = 1 << 0,
  OT_RADIO_CAPS_ENERGY_SCAN = 1 << 1,
  OT_RADIO_CAPS_TRANSMIT_RETRIES = 1 << 2,
  OT_RADIO_CAPS_CSMA_BACKOFF = 1 << 3,
  OT_RADIO_CAPS_SLEEP_TO_TX = 1 << 4,
  OT_RADIO_CAPS_TRANSMIT_SEC = 1 << 5,
  OT_RADIO_CAPS_TRANSMIT_TIMING = 1 << 6,
  OT_RADIO_CAPS_RECEIVE_TIMING = 1 << 7,
  OT_RADIO_CAPS_RX_ON_WHEN_IDLE = 1 << 8
}
טיפוסים בני מנייה (enum)
הגדרת קבועים שמשמשים לציון יכולות רדיו שונות.
anonymous enum{
  OT_IE_HEADER_SIZE = 2,
  OT_CSL_IE_SIZE = 4,
  OT_ACK_IE_MAX_SIZE = 16,
  OT_ENH_PROBING_IE_DATA_MAX_SIZE = 2
}
טיפוסים בני מנייה (enum)
מגדירה קבועים לגבי גודל הכותרת IE ב-ACK.
otRadioKeyType{
  OT_KEY_TYPE_LITERAL_KEY = 0,
  OT_KEY_TYPE_KEY_REF = 1
}
טיפוסים בני מנייה (enum)
הגדרת קבועים לגבי סוגי מפתחות.
otRadioState טיפוסים בני מנייה (enum)
מייצג את מצב הרדיו.

ערכי דף

otExtAddress typedef
struct otExtAddress
מייצג את הכתובת המורחבת של IEEE 802.15.4.
otLinkMetrics typedef
struct otLinkMetrics
מייצג את המדדים שצוינו בשאילתה.
otMacKey typedef
struct otMacKey
מייצג מפתח MAC.
otMacKeyMaterial typedef
otMacKeyRef typedef
מייצג Ref של מפתח MAC שמשמש את PSA.
otPanId typedef
uint16_t
מייצג את מזהה ה-PAN של IEEE 802.15.4.
otRadioCaps typedef
uint16_t
מייצג יכולות רדיו.
otRadioCoexMetrics typedef
אלה הם העברות חוקיות של מצבי רדיו:
otRadioFrame typedef
struct otRadioFrame
מייצגת מסגרת רדיו IEEE 802.15.4.
otRadioIeInfo typedef
struct otRadioIeInfo
מייצג את המידע הקשור ל-IEEE 802.15.4 IE (רכיב מידע) של מסגרת רדיו.
otRadioState typedef
מייצג את מצב הרדיו.
otShortAddress typedef
uint16_t
מייצג את הכתובת המקוצרת של IEEE 802.15.4.

משתנים

OT_TOOL_PACKED_END

מבנים

otExtAddress

מייצג את הכתובת המורחבת של IEEE 802.15.4.

otLinkMetrics

מייצג את המדדים שצוינו בשאילתה.

otMacKey

מייצג מפתח MAC.

otMacKeyMaterial

מייצג מפתח MAC.

otRadioCoexMetrics

אלה הם העברות חוקיות של מצבי רדיו:

otRadioFrame

מייצגת מסגרת רדיו IEEE 802.15.4.

otRadioIeInfo

מייצג את המידע הקשור ל-IEEE 802.15.4 IE (רכיב מידע) של מסגרת רדיו.

ספירות

טיפוסים אנונימיים

 anonymous enum
תכונות
OT_RADIO_BITS_PER_OCTET

מספר הסיביות לכל 8 תווים.

OT_RADIO_BIT_RATE

2.4 GHz IEEE 802.15.4 (ביט לשנייה)

OT_RADIO_FRAME_MAX_SIZE

aMaxPHYPacketSize (IEEE 802.15.4-2006)

OT_RADIO_FRAME_MIN_SIZE

גודל מינימלי של המסגרת FCS + Control.

OT_RADIO_LQI_NONE

אין תמיכה במדידת LQI.

OT_RADIO_POWER_INVALID

ערך אספקת החשמל לא חוקי או לא ידוע.

OT_RADIO_RSSI_INVALID

ערך RSSI לא חוקי או לא ידוע.

OT_RADIO_SYMBOLS_PER_OCTET

2.4 GHz IEEE 802.15.4-2006

OT_RADIO_SYMBOL_RATE

קצב צלילי ה-O-QPSK PHY בהפעלה בתדרים 780MHz, 915MHz, 2,380MHz, 2,450MHz.

OT_RADIO_SYMBOL_TIME

משך הזמן של סמל ביחידה של מיליוניות השנייה.

OT_RADIO_TEN_SYMBOLS_TIME

זמן של 10 סמלים ביחידה של מיליוניות השנייה.

טיפוסים אנונימיים

 anonymous enum

מגדיר את דף הערוץ.

תכונות
OT_RADIO_CHANNEL_PAGE_0

2.4 GHz IEEE 802.15.4-2006

OT_RADIO_CHANNEL_PAGE_0_MASK

2.4 GHz IEEE 802.15.4-2006

OT_RADIO_CHANNEL_PAGE_2

915 מגה-הרץ IEEE 802.15.4-2006

OT_RADIO_CHANNEL_PAGE_2_MASK

915 מגה-הרץ IEEE 802.15.4-2006

טיפוסים אנונימיים

 anonymous enum

מגדירה את טווח הערוצים של תחום התדרים.

תכונות
OT_RADIO_2P4GHZ_OQPSK_CHANNEL_MASK

2.4 GHz IEEE 802.15.4-2006

OT_RADIO_2P4GHZ_OQPSK_CHANNEL_MAX

2.4 GHz IEEE 802.15.4-2006

OT_RADIO_2P4GHZ_OQPSK_CHANNEL_MIN

2.4 GHz IEEE 802.15.4-2006

OT_RADIO_915MHZ_OQPSK_CHANNEL_MASK

915 מגה-הרץ IEEE 802.15.4-2006

OT_RADIO_915MHZ_OQPSK_CHANNEL_MAX

915 מגה-הרץ IEEE 802.15.4-2006

OT_RADIO_915MHZ_OQPSK_CHANNEL_MIN

915 מגה-הרץ IEEE 802.15.4-2006

טיפוסים אנונימיים

 anonymous enum

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

otRadioCaps.

תכונות
OT_RADIO_CAPS_ACK_TIMEOUT

הרדיו תומך באירוע AckTime.

OT_RADIO_CAPS_CSMA_BACKOFF

הרדיו תומך בהשהייה של CSMA בהעברת פריימים (אבל אין ניסיון חוזר).

OT_RADIO_CAPS_ENERGY_SCAN

הרדיו תומך בסריקות אנרגיה.

OT_RADIO_CAPS_NONE

הרדיו לא תומך בשום יכולת.

OT_RADIO_CAPS_RECEIVE_TIMING

הרדיו תומך ב-rx בזמן מסוים.

OT_RADIO_CAPS_RX_ON_WHEN_IDLE

הרדיו תומך בטיפול ב-RxOnWhenIdle.

OT_RADIO_CAPS_SLEEP_TO_TX

הרדיו תומך במעבר ישיר משינה ל-TX עם CSMA.

OT_RADIO_CAPS_TRANSMIT_RETRIES

הרדיו תומך בלוגיקת ניסיון חוזר מסוג tx עם מניעת התנגשות (CSMA).

OT_RADIO_CAPS_TRANSMIT_SEC

הרדיו תומך באבטחת tx.

OT_RADIO_CAPS_TRANSMIT_TIMING

הרדיו תומך ב-tx בזמן מסוים.

טיפוסים אנונימיים

 anonymous enum

מגדירה קבועים לגבי גודל הכותרת IE ב-ACK.

תכונות
OT_ACK_IE_MAX_SIZE

אורך מקסימלי לכותרת IE ב-ACK.

OT_CSL_IE_SIZE

גודל התוכן של CSL IE בבייטים.

OT_ENH_PROBING_IE_DATA_MAX_SIZE

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

OT_IE_HEADER_SIZE

גודל הכותרת של IE בבייטים.

otRadioKeyType

 otRadioKeyType

הגדרת קבועים לגבי סוגי מפתחות.

תכונות
OT_KEY_TYPE_KEY_REF

שימוש בהפניה למפתח.

OT_KEY_TYPE_LITERAL_KEY

שימוש במקשים מילוליים.

otRadioState

 otRadioState

מייצג את מצב הרדיו.

בהתחלה, הרדיו נמצא במצב 'מושבת'.

ערכי דף

otExtAddress

struct otExtAddress otExtAddress

מייצג את הכתובת המורחבת של IEEE 802.15.4.

otLinkMetrics

struct otLinkMetrics otLinkMetrics

מייצג את המדדים שצוינו בשאילתה.

otMacKey

struct otMacKey otMacKey

מייצג מפתח MAC.

otMacKeyMaterial

struct otMacKeyMaterial otMacKeyMaterial

otMacKeyRef

otCryptoKeyRef otMacKeyRef

מייצג Ref של מפתח MAC שמשמש את PSA.

otPanId

uint16_t otPanId

מייצג את מזהה ה-PAN של IEEE 802.15.4.

otRadioCaps

uint16_t otRadioCaps

מייצג יכולות רדיו.

הערך הוא שדה סיבית שמציין את היכולות שנתמכות על ידי הרדיו. הצגת OT_RADIO_CAPS_* הגדרות.

otRadioCoexMetrics

struct otRadioCoexMetrics otRadioCoexMetrics

אלה הם העברות חוקיות של מצבי רדיו:

(רדיו כבוי) +----+ אפשר() +-+ קבלה() +---+ Transmit() +----+ | |----->| |----->| |-------->| | | מושבת | | שינה | | קבלה | | שידור | | |<-----| |<| |<--------| | +-----קבלה +-+ Sleep() +---+יש להשבית +-+ Sleep() +---+

במהלך פקודת בקשת הנתונים של IEEE 802.15.4, ניתן לקצר את המעבר Sleep->Receive->Transmit (שידור) למצב שינה כדי לעבור מ'שינה' ל'שידור', אם הפלטפורמה תומכת ביכולת OT_Radio_CAPS_SLEEP_TO_TX. מייצג מדדים של דו-קיום ברדיו.

otRadioFrame

struct otRadioFrame otRadioFrame

מייצגת מסגרת רדיו IEEE 802.15.4.

otRadioIeInfo

struct otRadioIeInfo otRadioIeInfo

מייצג את המידע הקשור ל-IEEE 802.15.4 IE (רכיב מידע) של מסגרת רדיו.

otRadioState

enum otRadioState otRadioState

מייצג את מצב הרדיו.

בהתחלה, הרדיו נמצא במצב 'מושבת'.

otShortAddress

uint16_t otShortAddress

מייצג את הכתובת המקוצרת של IEEE 802.15.4.

משתנים

OT_TOOL_PACKED_END

OT_TOOL_PACKED_BEGIN struct otExtAddress OT_TOOL_PACKED_END

פקודות מאקרו

CSL_IE_HEADER_BYTES_HI

 CSL_IE_HEADER_BYTES_HI 0x0d

בית שני של כותרת CSL IE תוקן.

CSL_IE_HEADER_BYTES_LO

 CSL_IE_HEADER_BYTES_LO 0x04

תוקנה כותרת CSL IE בבייט ראשון.

OT_EXT_ADDRESS_SIZE

 OT_EXT_ADDRESS_SIZE 8

גודל של כתובת מורחבת של IEEE 802.15.4 (בייטים)

OT_MAC_KEY_SIZE

 OT_MAC_KEY_SIZE 16

הגודל של מפתח MAC בבייטים.

OT_PANID_BROADCAST

 OT_PANID_BROADCAST 0xffff

מזהה IEEE 802.15.4 של מספר חשבון קבוע לשידור.

OT_TOOL_PACKED_END

 OT_TOOL_PACKED_END

אינדיקציה ספציפית למהדר (Compiler) בסוף מחלקה או בניין דחוסים בבייטים.

מקורות מידע

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