Radio Types#
This module includes the platform abstraction for a radio frame.
Modules#
Enumerations#
Defines the channel page.
Defines the frequency band channel range.
Defines constants that are used to indicate different radio capabilities.
Defines constants about size of header IE in ACK.
Defines constants about key types.
Represents the state of a radio.
Typedefs#
Represents radio capabilities.
Represents the IEEE 802.15.4 PAN ID.
Represents the IEEE 802.15.4 Short Address.
Represents the IEEE 802.15.4 Extended Address.
Represents a MAC Key Ref used by PSA.
Represents the IEEE 802.15.4 Header IE (Information Element) related information of a radio frame.
Represents an IEEE 802.15.4 radio frame.
Represents the state of a radio.
The following are valid radio state transitions:
Represents what metrics are specified to query.
Variables#
Macros#
IEEE 802.15.4 Broadcast PAN ID.
Size of an IEEE 802.15.4 Extended Address (bytes)
Fixed CSL IE header first byte.
Fixed CSL IE header second byte.
Size of the MAC Key in bytes.
Compiler-specific indication at the end of a byte packed class or struct.
Enumeration Documentation#
@11#
@11
| Enumerator | |
|---|---|
| OT_RADIO_FRAME_MAX_SIZE | aMaxPHYPacketSize (IEEE 802.15.4-2006) |
| OT_RADIO_FRAME_MIN_SIZE | Minimal size of frame FCS + CONTROL. |
| OT_RADIO_SYMBOLS_PER_OCTET | 2.4 GHz IEEE 802.15.4-2006 |
| OT_RADIO_BIT_RATE | 2.4 GHz IEEE 802.15.4 (bits per second) |
| OT_RADIO_BITS_PER_OCTET | Number of bits per octet. |
| OT_RADIO_SYMBOL_RATE | The O-QPSK PHY symbol rate when operating in the 780MHz, 915MHz, 2380MHz, 2450MHz. |
| OT_RADIO_SYMBOL_TIME | Symbol duration time in unit of microseconds. |
| OT_RADIO_TEN_SYMBOLS_TIME | Time for 10 symbols in unit of microseconds. |
| OT_RADIO_LQI_NONE | LQI measurement not supported. |
| OT_RADIO_RSSI_INVALID | Invalid or unknown RSSI value. |
| OT_RADIO_POWER_INVALID | Invalid or unknown power value. |
66 of file include/openthread/platform/radio.h@12#
@12
Defines the channel page.
| Enumerator | |
|---|---|
| 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 |
90 of file include/openthread/platform/radio.h@13#
@13
Defines the frequency band channel range.
| Enumerator | |
|---|---|
| OT_RADIO_915MHZ_OQPSK_CHANNEL_MIN | 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_MASK | 915 MHz IEEE 802.15.4-2006 |
| OT_RADIO_2P4GHZ_OQPSK_CHANNEL_MIN | 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_MASK | 2.4 GHz IEEE 802.15.4-2006 |
101 of file include/openthread/platform/radio.h@14#
@14
Defines constants that are used to indicate different radio capabilities.
See otRadioCaps.
| Enumerator | |
|---|---|
| OT_RADIO_CAPS_NONE | Radio supports no capability. |
| OT_RADIO_CAPS_ACK_TIMEOUT | Radio supports AckTime event. |
| OT_RADIO_CAPS_ENERGY_SCAN | Radio supports Energy Scans. |
| OT_RADIO_CAPS_TRANSMIT_RETRIES | Radio supports tx retry logic with collision avoidance (CSMA). |
| OT_RADIO_CAPS_CSMA_BACKOFF | Radio supports CSMA backoff for frame transmission (but no retry). |
| OT_RADIO_CAPS_SLEEP_TO_TX | Radio supports direct transition from sleep to TX with CSMA. |
| OT_RADIO_CAPS_TRANSMIT_SEC | Radio supports tx security. |
| OT_RADIO_CAPS_TRANSMIT_TIMING | Radio supports tx at specific time. |
| OT_RADIO_CAPS_RECEIVE_TIMING | Radio supports rx at specific time. |
| OT_RADIO_CAPS_RX_ON_WHEN_IDLE | Radio supports RxOnWhenIdle handling. |
| OT_RADIO_CAPS_TRANSMIT_FRAME_POWER | Radio supports setting per-frame transmit power. |
121 of file include/openthread/platform/radio.h@15#
@15
Defines constants about size of header IE in ACK.
| Enumerator | |
|---|---|
| OT_IE_HEADER_SIZE | Size of IE header in bytes. |
| OT_CSL_IE_SIZE | Size of CSL IE content in bytes. |
| OT_ACK_IE_MAX_SIZE | Max length for header IE in ACK. |
| OT_ENH_PROBING_IE_DATA_MAX_SIZE | Max length of Link Metrics data in Vendor-Specific IE. |
153 of file include/openthread/platform/radio.hotRadioKeyType#
otRadioKeyType
Defines constants about key types.
| Enumerator | |
|---|---|
| OT_KEY_TYPE_LITERAL_KEY | Use Literal Keys. |
| OT_KEY_TYPE_KEY_REF | Use Reference to Key. |
220 of file include/openthread/platform/radio.hotRadioState#
otRadioState
Represents the state of a radio.
Initially, a radio is in the Disabled state.
| Enumerator | |
|---|---|
| OT_RADIO_STATE_DISABLED | |
| OT_RADIO_STATE_SLEEP | |
| OT_RADIO_STATE_RECEIVE | |
| OT_RADIO_STATE_TRANSMIT | |
| OT_RADIO_STATE_INVALID | |
381 of file include/openthread/platform/radio.hTypedef Documentation#
otRadioCaps#
typedef uint16_t otRadioCaps
Represents radio capabilities.
The value is a bit-field indicating the capabilities supported by the radio. See OT_RADIO_CAPS_* definitions.
116 of file include/openthread/platform/radio.hotPanId#
typedef uint16_t otPanId
Represents the IEEE 802.15.4 PAN ID.
141 of file include/openthread/platform/radio.hotShortAddress#
typedef uint16_t otShortAddress
Represents the IEEE 802.15.4 Short Address.
146 of file include/openthread/platform/radio.hotExtAddress#
typedef struct otExtAddress otExtAddress
Represents the IEEE 802.15.4 Extended Address.
178 of file include/openthread/platform/radio.hotMacKey#
typedef struct otMacKey otMacKey
Represents a MAC Key.
196 of file include/openthread/platform/radio.hotMacKeyRef#
typedef otCryptoKeyRef otMacKeyRef
Represents a MAC Key Ref used by PSA.
201 of file include/openthread/platform/radio.hotMacKeyMaterial#
typedef struct otMacKeyMaterial otMacKeyMaterial
215 of file include/openthread/platform/radio.hotRadioIeInfo#
typedef struct otRadioIeInfo otRadioIeInfo
Represents the IEEE 802.15.4 Header IE (Information Element) related information of a radio frame.
234 of file include/openthread/platform/radio.hotRadioFrame#
typedef struct otRadioFrame otRadioFrame
Represents an IEEE 802.15.4 radio frame.
375 of file include/openthread/platform/radio.hotRadioState#
typedef enum otRadioState otRadioState
Represents the state of a radio.
Initially, a radio is in the Disabled state.
388 of file include/openthread/platform/radio.hotRadioCoexMetrics#
typedef struct otRadioCoexMetrics otRadioCoexMetrics
The following are valid radio state transitions:
(Radio ON)
+-------—+ Enable() +----—+ Receive() +------—+ Transmit() +-------—+ | |--------—>| |--------—>| |-----------—>| | | Disabled | | Sleep | | Receive | | Transmit | | |<--------—| |<--------—| |<-----------—| | +-------—+ Disable() +----—+ Sleep() +------—+ Receive() +-------—+ (Radio OFF) or signal TransmitDone
During the IEEE 802.15.4 data request command the transition Sleep->Receive->Transmit can be shortened to direct transition from Sleep to Transmit if the platform supports the OT_RADIO_CAPS_SLEEP_TO_TX capability. Represents radio coexistence metrics.
431 of file include/openthread/platform/radio.hotLinkMetrics#
typedef struct otLinkMetrics otLinkMetrics
Represents what metrics are specified to query.
443 of file include/openthread/platform/radio.hVariable Documentation#
OT_TOOL_PACKED_END#
OT_TOOL_PACKED_BEGIN struct otMacKey OT_TOOL_PACKED_END
173 of file include/openthread/platform/radio.hMacro Definition Documentation#
OT_PANID_BROADCAST#
#define OT_PANID_BROADCASTValue:
0xffff
IEEE 802.15.4 Broadcast PAN ID.
136 of file include/openthread/platform/radio.hOT_EXT_ADDRESS_SIZE#
#define OT_EXT_ADDRESS_SIZEValue:
8
Size of an IEEE 802.15.4 Extended Address (bytes)
148 of file include/openthread/platform/radio.hCSL_IE_HEADER_BYTES_LO#
#define CSL_IE_HEADER_BYTES_LOValue:
0x04
Fixed CSL IE header first byte.
161 of file include/openthread/platform/radio.hCSL_IE_HEADER_BYTES_HI#
#define CSL_IE_HEADER_BYTES_HIValue:
0x0d
Fixed CSL IE header second byte.
162 of file include/openthread/platform/radio.hOT_MAC_KEY_SIZE#
#define OT_MAC_KEY_SIZEValue:
16
Size of the MAC Key in bytes.
180 of file include/openthread/platform/radio.hOT_TOOL_PACKED_END#
#define OT_TOOL_PACKED_END
Compiler-specific indication at the end of a byte packed class or struct.
172 of file include/openthread/platform/toolchain.h