Modules#
Radio Types#
This module includes the platform abstraction for a radio frame.
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#
@12#
@12
| 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. |
@13#
@13
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 |
@14#
@14
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 |
@15#
@15
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. |
@16#
@16
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. |
otRadioKeyType#
otRadioKeyType
Defines constants about key types.
| Enumerator | |
|---|---|
| OT_KEY_TYPE_LITERAL_KEY | Use Literal Keys. |
| OT_KEY_TYPE_KEY_REF | Use Reference to Key. |
otRadioState#
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 | |
Typedef Documentation#
otRadioCaps#
typedef uint8_t otRadioCaps
Represents radio capabilities.
The value is a bit-field indicating the capabilities supported by the radio. See OT_RADIO_CAPS_* definitions.
otExtAddress#
typedef struct otExtAddress otExtAddress
Represents the IEEE 802.15.4 Extended Address.
otRadioIeInfo#
typedef struct otRadioIeInfo otRadioIeInfo
Represents the IEEE 802.15.4 Header IE (Information Element) related information of a radio frame.
otRadioState#
typedef enum otRadioState otRadioState
Represents the state of a radio.
Initially, a radio is in the Disabled state.
otRadioCoexMetrics#
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.
otLinkMetrics#
typedef struct otLinkMetrics otLinkMetrics
Represents what metrics are specified to query.