1.1.3.4.34 DRV_RF215_PIB_ATTRIBUTE Enum
C
typedef enum
{
/* RF device identifier (read-only). 16 bits */
RF215_PIB_DEVICE_ID = 0x0000,
/* RF PHY layer firmware version number (read-only).
* 6 bytes (see DRV_RF215_FW_VERSION) */
RF215_PIB_FW_VERSION = 0x0001,
/* RF device reset (write-only). 8 bits */
RF215_PIB_DEVICE_RESET = 0x0002,
/* RF transceiver reset (write-only). 8 bits */
RF215_PIB_TRX_RESET = 0x0080,
/* RF transceiver sleep. 8 bits */
RF215_PIB_TRX_SLEEP = 0x0081,
/* RF PHY configuration. 19 bytes (see DRV_RF215_PHY_CFG_OBJ) */
RF215_PIB_PHY_CONFIG = 0x0100,
/* RF PHY band and operating mode. 16 bits (see DRV_RF215_PHY_BAND_OPM) */
RF215_PIB_PHY_BAND_OPERATING_MODE = 0x0101,
/* RF channel number used for transmission and reception. 16 bits */
RF215_PIB_PHY_CHANNEL_NUM = 0x0120,
/* RF frequency in Hz used for transmit and receive (read-only). 32 bits */
RF215_PIB_PHY_CHANNEL_FREQ_HZ = 0x0121,
/* Duration in us of Energy Detection for CCA. 16 bits */
RF215_PIB_PHY_CCA_ED_DURATION_US = 0x0141,
/* Threshold in dBm for CCA with Energy Detection. 8 bits */
RF215_PIB_PHY_CCA_ED_THRESHOLD_DBM = 0x0142,
/* Duration in symbols of Energy Detection for CCA. 16 bits */
RF215_PIB_PHY_CCA_ED_DURATION_SYMBOLS = 0x0143,
/* Threshold in dB above sensitivity for CCA with Energy Detection. 8 bits */
RF215_PIB_PHY_CCA_ED_THRESHOLD_SENSITIVITY = 0x0144,
/* Sensitivity in dBm (according to 802.15.4). 8 bits */
RF215_PIB_PHY_SENSITIVITY = 0x0150,
/* Maximum TX power in dBm. 8 bits */
RF215_PIB_PHY_MAX_TX_POWER = 0x0151,
/* Turnaround time in us (aTurnaroundTime in IEEE 802.15.4).
* 16 bits (read-only) */
RF215_PIB_PHY_TURNAROUND_TIME = 0x0160,
/* Number of payload symbols in last transmitted message (read-only).
* 16 bits */
RF215_PIB_PHY_TX_PAY_SYMBOLS = 0x0180,
/* Number of payload symbols in last received message (read-only).
* 16 bits */
RF215_PIB_PHY_RX_PAY_SYMBOLS = 0x0181,
/* Successfully transmitted messages count (read-only). 32 bits */
RF215_PIB_PHY_TX_TOTAL = 0x01A0,
/* Successfully transmitted bytes count (read-only). 32 bits */
RF215_PIB_PHY_TX_TOTAL_BYTES = 0x01A1,
/* Transmission errors count (read-only). 32 bits */
RF215_PIB_PHY_TX_ERR_TOTAL = 0x01A2,
/* Transmission errors count due to already in transmission (read-only).
* 32 bits */
RF215_PIB_PHY_TX_ERR_BUSY_TX = 0x01A3,
/* Transmission errors count due to already in reception (read-only).
* 32 bits */
RF215_PIB_PHY_TX_ERR_BUSY_RX = 0x01A4,
/* Transmission errors count due to busy channel (read-only). 32 bits */
RF215_PIB_PHY_TX_ERR_BUSY_CHN = 0x01A5,
/* Transmission errors count due to bad message length (read-only).
* 32 bits */
RF215_PIB_PHY_TX_ERR_BAD_LEN = 0x01A6,
/* Transmission errors count due to bad format (read-only). 32 bits */
RF215_PIB_PHY_TX_ERR_BAD_FORMAT = 0x01A7,
/* Transmission errors count due to timeout (read-only). 32 bits */
RF215_PIB_PHY_TX_ERR_TIMEOUT = 0x01A8,
/* Transmission aborted count (read-only). 32 bits */
RF215_PIB_PHY_TX_ERR_ABORTED = 0x01A9,
/* Transmission confirms not handled by upper layer count (read-only).
* 32 bits */
RF215_PIB_PHY_TX_CFM_NOT_HANDLED = 0x01AA,
/* Successfully received messages count (read-only). 32 bits */
RF215_PIB_PHY_RX_TOTAL = 0x01B0,
/* Successfully received bytes count (read-only). 32 bits */
RF215_PIB_PHY_RX_TOTAL_BYTES = 0x01B1,
/* Reception errors count (read-only). 32 bits */
RF215_PIB_PHY_RX_ERR_TOTAL = 0x01B2,
/* Reception false positive count (read-only). 32 bits */
RF215_PIB_PHY_RX_ERR_FALSE_POSITIVE = 0x01B3,
/* Reception errors count due to bad message length (read-only). 32 bits */
RF215_PIB_PHY_RX_ERR_BAD_LEN = 0x01B4,
/* Reception errors count due to bad format or bad FCS in header
* (read-only). 32 bits */
RF215_PIB_PHY_RX_ERR_BAD_FORMAT = 0x01B5,
/* Reception errors count due to bad FCS in payload (read-only). 32 bits */
RF215_PIB_PHY_RX_ERR_BAD_FCS_PAY = 0x01B6,
/* Reception aborted count (read-only). 32 bits */
RF215_PIB_PHY_RX_ERR_ABORTED = 0x01B7,
/* Reception override (another message with higher signal level) count
* (read-only). 32 bits */
RF215_PIB_PHY_RX_OVERRIDE = 0x01B8,
/* Reception indications not handled by upper layer count (read-only).
* 32 bits */
RF215_PIB_PHY_RX_IND_NOT_HANDLED = 0x01B9,
/* Reset PHY Statistics (write-only) */
RF215_PIB_PHY_STATS_RESET = 0x01C0,
/* Continuous LO Carrier Tx Mode. 8 bits */
RF215_PIB_PHY_TX_CONTINUOUS = 0x01C1,
/* Back-off period unit in us (aUnitBackoffPeriod in IEEE 802.15.4) used for
* CSMA-CA . 16 bits (read-only) */
RF215_PIB_MAC_UNIT_BACKOFF_PERIOD = 0x0200,
} DRV_RF215_PIB_ATTRIBUTE;Summary
Defines the list of PIB attributes.
Description
This data type defines the list of available PIB attributes in RF215 driver. PIB values can be read by DRV_RF215_GetPib and written by DRV_RF215_SetPib. DRV_RF215_GetPibSize can be used to know the size of each PIB.
The following table describes each PIB attribute.
| PIB Attribute | Access | Type | Default | Range | Description |
|---|---|---|---|---|---|
| RF215_PIB_DEVICE_ID | Get | uint16_t | 0x0215 | 0x0215 | RF device identifier |
| RF215_PIB_FW_VERSION | Get | DRV_RF215_FW_VERSION | NA | NA | RF215 driver firmware version |
| RF215_PIB_DEVICE_RESET | Set | uint8_t | NA | 0 - 255 | Writting any value performs a RF215 device reset (using reset pin) |
| RF215_PIB_TRX_RESET | Set | uint8_t | NA | 0 - 255 | Writting any value performs a RF215 transceiver reset (using reset command). If dual-band is used, only one transceiver is reset. |
| RF215_PIB_TRX_SLEEP | Get/Set | bool | false | true/false | RF215 transceiver sleep (true) / wake-up (false). If dual-band is used, only one transceiver is slept / woken-up. |
| RF215_PIB_PHY_CONFIG | Get/Set | DRV_RF215_PHY_CFG_OBJ | Depends on MCC configuration | NA | RF PHY configuration. It includes PHY type (FSK/OFDM), frequency configuration and CCA configuration. |
| RF215_PIB_PHY_BAND_OPERATING_MODE | Get/Set | DRV_RF215_PHY_BAND_OPM | Depends on MCC configuration | See DRV_RF215_PHY_BAND_OPM | RF PHY band and operating mode. It is similar to RF215_PIB_PHY_CONFIG, but it allows to configure easily the PHY configuration corresponding to standard band and operating modes defined in IEEE 802.15.4-2020. |
| RF215_PIB_PHY_CHANNEL_NUM | Get/Set | uint16_t | Depends on MCC configuration | Depends on PHY configuration (RF215_PIB_PHY_CONFIG / RF215_PIB_PHY_BAND_OPERATING_MODE) | RF channel number used for reception and transmission. The actual frequency of the channel (RF215_PIB_PHY_CHANNEL_FREQ_HZ) will depend on channel center frequency and channel spacing (RF215_PIB_PHY_CONFIG / RF215_PIB_PHY_BAND_OPERATING_MODE). If frequency hopping support is enabled in MCC, the channel number used for transmission is provided in DRV_RF215_TxRequest and the channel number used for reception can also be changed with DRV_RF215_SetChannelRequest. |
| RF215_PIB_PHY_CHANNEL_FREQ_HZ | Get | uint32_t | Depends on MCC configuration | 389500000 - 510000000, 779000000 - 1020000000, 2400000000 - 2483500000 | RF frequency in Hz used for reception and transmission. It depends on PHY configuration (RF215_PIB_PHY_CONFIG / RF215_PIB_PHY_BAND_OPERATING_MODE) and channel number (RF215_PIB_PHY_CHANNEL_NUM). If frequency hopping support is enabled in MCC, it is only the frequency used for reception. |
| RF215_PIB_PHY_CCA_ED_DURATION_US | Get/Set | uint16_t | Depends on MCC configuration | 10 - 65535 | Duration in us of Energy Detection for CCA. This is also included in PHY configuration (RF215_PIB_PHY_CONFIG / RF215_PIB_PHY_BAND_OPERATING_MODE). |
| RF215_PIB_PHY_CCA_ED_THRESHOLD_DBM | Get/Set | int8_t | Depends on MCC configuration | -128 - 127 | Threshold in dBm for CCA with Energy Detection. This is also included in PHY configuration (RF215_PIB_PHY_CONFIG / RF215_PIB_PHY_BAND_OPERATING_MODE). |
| RF215_PIB_PHY_CCA_ED_DURATION_SYMBOLS | Get/Set | uint16_t | Depends on MCC configuration | 1 - 26214 | Duration in symbols of Energy Detection for CCA. This is also included in PHY configuration (RF215_PIB_PHY_CONFIG / RF215_PIB_PHY_BAND_OPERATING_MODE). |
| RF215_PIB_PHY_CCA_ED_THRESHOLD_SENSITIVITY | Get/Set | int8_t | Depends on MCC configuration | -34 - 127 | Threshold in dB above sensitivity for CCA with Energy Detection. This is also included in PHY configuration (RF215_PIB_PHY_CONFIG / RF215_PIB_PHY_BAND_OPERATING_MODE). |
| RF215_PIB_PHY_SENSITIVITY | Get | int8_t | Depends on MCC configuration | -94 - -82 | Sensitivity in dBm (according to 802.15.4). |
| RF215_PIB_PHY_MAX_TX_POWER | Get | int8_t | Depends on MCC configuration | 14 | Maximum TX power in dBm. |
| RF215_PIB_PHY_TURNAROUND_TIME | Get | uint16_t | Depends on MCC configuration | 1000 (FSK), 1080 (OFDM) | Turnaround time in us (aTurnaroundTime in IEEE 802.15.4). It depends on PHY type (FSK/OFDM) |
| RF215_PIB_PHY_TX_PAY_SYMBOLS | Get | uint16_t | 0 | 1 - 32768 | Number of payload symbols in the last transmitted message |
| RF215_PIB_PHY_RX_PAY_SYMBOLS | Get | uint16_t | 0 | 1 - 32768 | Number of payload symbols in the last received message |
| RF215_PIB_PHY_TX_TOTAL | Get | uint32_t | 0 | 0 - 4294967295 | Counter of successfully transmitted messages |
| RF215_PIB_PHY_TX_TOTAL_BYTES | Get | uint32_t | 0 | 0 - 4294967295 | Counter of successfully transmitted bytes |
| RF215_PIB_PHY_TX_ERR_TOTAL | Get | uint32_t | 0 | 0 - 4294967295 | Counter of transmission errors |
| RF215_PIB_PHY_TX_ERR_BUSY_TX | Get | uint32_t | 0 | 0 - 4294967295 | Counter of transmission errors due to already in transmission |
| RF215_PIB_PHY_TX_ERR_BUSY_RX | Get | uint32_t | 0 | 0 - 4294967295 | Counter of transmission errors because a message is being received |
| RF215_PIB_PHY_TX_ERR_BUSY_CHN | Get | uint32_t | 0 | 0 - 4294967295 | Counter of transmission errors due to busy channel (Energy Detection) |
| RF215_PIB_PHY_TX_ERR_BAD_LEN | Get | uint32_t | 0 | 0 - 4294967295 | Counter of transmission errors due to invalid message length |
| RF215_PIB_PHY_TX_ERR_BAD_FORMAT | Get | uint32_t | 0 | 0 - 4294967295 | Counter of transmission errors due to invalid parameters |
| RF215_PIB_PHY_TX_ERR_TIMEOUT | Get | uint32_t | 0 | 0 - 4294967295 | Counter of transmission errors due to timeout |
| RF215_PIB_PHY_TX_ERR_ABORTED | Get | uint32_t | 0 | 0 - 4294967295 | Counter of aborted transmissions |
| RF215_PIB_PHY_TX_CFM_NOT_HANDLED | Get | uint32_t | 0 | 0 - 4294967295 | Counter of transmission confirms not handled by upper layer |
| RF215_PIB_PHY_RX_TOTAL | Get | uint32_t | 0 | 0 - 4294967295 | Counter of successfully received messages |
| RF215_PIB_PHY_RX_TOTAL_BYTES | Get | uint32_t | 0 | 0 - 4294967295 | Counter of successfully received bytes |
| RF215_PIB_PHY_RX_ERR_TOTAL | Get | uint32_t | 0 | 0 - 4294967295 | Counter of reception errors |
| RF215_PIB_PHY_RX_ERR_FALSE_POSITIVE | Get | uint32_t | 0 | 0 - 4294967295 | Counter of reception false positives (preamble detection) |
| RF215_PIB_PHY_RX_ERR_BAD_LEN | Get | uint32_t | 0 | 0 - 4294967295 | Counter of reception errors due to invalid message length |
| RF215_PIB_PHY_RX_ERR_BAD_FORMAT | Get | uint32_t | 0 | 0 - 4294967295 | Counter of reception errors due to invalid format or invalid FCS in header |
| RF215_PIB_PHY_RX_ERR_BAD_FCS_PAY | Get | uint32_t | 0 | 0 - 4294967295 | Counter of reception errors due to invalid FCS in payload |
| RF215_PIB_PHY_RX_ERR_ABORTED | Get | uint32_t | 0 | 0 - 4294967295 | Counter of aborted receptions |
| RF215_PIB_PHY_RX_OVERRIDE | Get | uint32_t | 0 | 0 - 4294967295 | Counter of reception overrides (another message with higher signal level) |
| RF215_PIB_PHY_RX_IND_NOT_HANDLED | Get | uint32_t | 0 | 0 - 4294967295 | Counter of reception indications not handled by upper layer |
| RF215_PIB_PHY_STATS_RESET | Set | uint8_t | NA | 0 - 255 | Writting any value sets all statistics (RF215_PIB_PHY_TX_TOTAL to RF215_PIB_PHY_RX_IND_NOT_HANDLED) to 0 |
| RF215_PIB_PHY_TX_CONTINUOUS | Get/Set | bool | false | true/false | Enables (true) / disables (false) continuous LO Carrier transmission. It can be used to measure RF frequency tolerance. |
| RF215_PIB_MAC_UNIT_BACKOFF_PERIOD | Get | uint16_t | Depends on MCC configuration | 1000 - 65535 | Back-off period unit in us (aUnitBackoffPeriod in IEEE 802.15.4) used for CSMA-CA . It is the sum of RF215_PIB_PHY_TURNAROUND_TIME and RF215_PIB_PHY_CCA_ED_DURATION. |
Remarks
If dual-band is used, the PIB values are different for each transceiver.
