סוגי רדיו

מודול זה כולל הפשטת פלטפורמה עבור מסגרת רדיו.

סיכום

הדמיות

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_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
}
טיפוסים בני מנייה (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
סוג זה מייצג רישומי מפתח MAC המשמשים PSA.
otPanId typedef
uint16_t
סוג זה מייצג את מזהה ה-PAN של IEEE 802.15.4.
otRadioCaps typedef
uint8_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

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

OT_RADIO_BIT_RATE

2.4 GHz IEEE 802.15.4 (bits per second)

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

אנום אנונימי

 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 MHz IEEE 802.15.4-2006

OT_RADIO_CHANNEL_PAGE_2_MASK

915 MHz 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 MHz IEEE 802.15.4-2006

OT_RADIO_915MHZ_OQPSK_CHANNEL_MAX

915 MHz IEEE 802.15.4-2006

OT_RADIO_915MHZ_OQPSK_CHANNEL_MIN

915 MHz 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_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

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

OT_IE_HEADER_SIZE

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

otRadioKeyType

 otRadioKeyType

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

מאפיינים
OT_KEY_TYPE_KEY_REF

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

OT_KEY_TYPE_LITERAL_KEY

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

OTRadioState

 otRadioState

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

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

סוג מגן

כתובת OTExt

struct otExtAddress otExtAddress

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

otLinkMetrics

struct otLinkMetrics otLinkMetrics

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

OTMacKey

struct otMacKey otMacKey

המבנה הזה מייצג מפתח MAC.

חומר otMacKeymaterial

struct otMacKeyMaterial otMacKeyMaterial

otMacKeyRef

otCryptoKeyRef otMacKeyRef

סוג זה מייצג רישומי מפתח MAC המשמשים PSA.

OTPanId

uint16_t otPanId

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

OTRadioCaps

uint8_t otRadioCaps

סוג זה מייצג יכולות רדיו.

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

otRadioCoexMetrics

struct otRadioCoexMetrics otRadioCoexMetrics

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

(רדיו פועל) +---+ הפעל()--+ קבלה() +---+ שידור() +----+ | |---->> |---->> |-------->| | | מושבת | | שינה | | קבלה | | תקשורת | | |----| |----| |<--------| | +----+ השבתה()--+ שינה[+---+ 'קבלה' +----+ (רדיו כבוי) או 'אות שידור' בוצע

במהלך פקודת בקשת IEEE 802.15.4, ניתן לקצר את הפקודה 'Sleep->Accept->Ttransmit' כדי לעבור ישירות מ'שינה' ל'שידור' אם הפלטפורמה תומכת ביכולת 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

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

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

כתובת מקוצרת

uint16_t otShortAddress

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

משתנים

OT_TOOL_PACKED_END

OT_TOOL_PACKED_BEGIN struct otExtAddress OT_TOOL_PACKED_END

פקודות מאקרו

CSL_IE_ARROW_BYTES_HI

 CSL_IE_HEADER_BYTES_HI 0x0d

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

CSL_IE_ARROW_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_BFIELDCAST

 OT_PANID_BROADCAST 0xffff

מזהה PAN של שידור IEEE 802.15.4.

OT_TOOL_PACKED_END

 OT_TOOL_PACKED_END

אינדיקציה של מהדר בסוף מארז ארוז או מבנה.

מקורות מידע

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