Modules#

RAIL_TxPowerConfig_t

EFR32#

Types specific to the EFR32 for dealing with the on-chip PAs.

Enumerations#

enum
RAIL_TX_POWER_MODE_2P4GIG_HP
RAIL_TX_POWER_MODE_2P4GIG_LP
RAIL_TX_POWER_MODE_SUBGIG
RAIL_TX_POWER_MODE_NONE
}

An enumeration of the EFR32 power modes.

Typedefs#

typedef uint8_t

Raw power levels used directly by the RAIL_Get/SetTxPower API where a higher numerical value corresponds to a higher output power.

typedef uint32_t

PA power setting used directly by the RAIL_GetPaPowerSetting() and RAIL_SetPaPowerSetting() APIs which is decoded to the actual hardware register value(s).

Macros#

#define

Returned by RAIL_SetPaPowerSetting when the current PA does not support the dBm to power setting mapping table.

#define

The maximum valid value for the RAIL_TxPowerLevel_t when in RAIL_TX_POWER_MODE_2P4_LP mode.

#define

The maximum valid value for the RAIL_TxPowerLevel_t when in RAIL_TX_POWER_MODE_2P4_HP mode.

#define

The maximum valid value for the RAIL_TxPowerLevel_t when in RAIL_TX_POWER_MODE_SUBGIG mode.

#define

The minimum valid value for the RAIL_TxPowerLevel_t when in RAIL_TX_POWER_MODE_2P4_LP mode.

#define

The minimum valid value for the RAIL_TxPowerLevel_t when in RAIL_TX_POWER_MODE_2P4_HP mode.

#define

The minimum valid value for the RAIL_TxPowerLevel_t when in RAIL_TX_POWER_MODE_SUBGIG mode.

#define

Invalid RAIL_TxPowerLevel_t value returned when an error occurs with RAIL_GetTxPower.

#define

Sentinel value that can be passed to RAIL_SetTxPower to set the highest power level available on the current PA, regardless of which one is selected.

#define
RAIL_TX_POWER_LEVEL_LP_MAX RAIL_TX_POWER_LEVEL_2P4_LP_MAX

Backwards compatibility define.

#define
RAIL_TX_POWER_LEVEL_HP_MAX RAIL_TX_POWER_LEVEL_2P4_HP_MAX

Backwards compatibility define.

#define
RAIL_TX_POWER_LEVEL_SUBGIG_MAX RAIL_TX_POWER_LEVEL_SUBGIG_HP_MAX

Backwards compatibility define.

#define
RAIL_TX_POWER_LEVEL_LP_MIN RAIL_TX_POWER_LEVEL_2P4_LP_MIN

Backwards compatibility define.

#define
RAIL_TX_POWER_LEVEL_HP_MIN RAIL_TX_POWER_LEVEL_2P4_HP_MIN

Backwards compatibility define.

#define
RAIL_TX_POWER_LEVEL_SUBGIG_MIN RAIL_TX_POWER_LEVEL_SUBGIG_HP_MIN

Backwards compatibility define.

#define
RAIL_TX_POWER_MODE_2P4_HP RAIL_TX_POWER_MODE_2P4GIG_HP
#define
RAIL_TX_POWER_MODE_2P4_LP RAIL_TX_POWER_MODE_2P4GIG_LP
#define

The number of PA's on this chip.

#define

The names of the TX power modes.

Enumeration Documentation#

RAIL_TxPowerMode_t#

RAIL_TxPowerMode_t

An enumeration of the EFR32 power modes.

The power modes on the EFR32 correspond to the different on-chip PAs that are available. For more information about the power and performance characteristics of a given amplifier, see the data sheet.

Enumerator
RAIL_TX_POWER_MODE_2P4GIG_HP

High-power amplifier, up to 20 dBm, raw values: 0-252.

RAIL_TX_POWER_MODE_2P4GIG_LP

Low-power amplifier, up to 0 dBm, raw values: 1-7.

RAIL_TX_POWER_MODE_SUBGIG

SubGig amplifier, up to 20 dBm, raw values: 0-248.

RAIL_TX_POWER_MODE_NONE

Invalid amplifier Selection.


Definition at line 799 of file chip/efr32/efr32xg1x/rail_chip_specific.h

Typedef Documentation#

RAIL_TxPowerLevel_t#

typedef uint8_t RAIL_TxPowerLevel_t

Raw power levels used directly by the RAIL_Get/SetTxPower API where a higher numerical value corresponds to a higher output power.

These are referred to as 'raw (values/units)'. On EFR32, they can range from one of RAIL_TX_POWER_LEVEL_2P4_LP_MIN, RAIL_TX_POWER_LEVEL_2P4_HP_MIN, or RAIL_TX_POWER_LEVEL_SUBGIG_HP_MIN to one of RAIL_TX_POWER_LEVEL_2P4_LP_MAX, RAIL_TX_POWER_LEVEL_2P4_HP_MAX, and RAIL_TX_POWER_LEVEL_SUBGIG_HP_MAX, respectively, depending on the selected RAIL_TxPowerMode_t.


Definition at line 721 of file chip/efr32/efr32xg1x/rail_chip_specific.h

RAIL_PaPowerSetting_t#

typedef uint32_t RAIL_PaPowerSetting_t

PA power setting used directly by the RAIL_GetPaPowerSetting() and RAIL_SetPaPowerSetting() APIs which is decoded to the actual hardware register value(s).


Definition at line 728 of file chip/efr32/efr32xg1x/rail_chip_specific.h

Macro Definition Documentation#

RAIL_TX_PA_POWER_SETTING_UNSUPPORTED#

#define RAIL_TX_PA_POWER_SETTING_UNSUPPORTED
Value:
(0U)

Returned by RAIL_SetPaPowerSetting when the current PA does not support the dBm to power setting mapping table.


Definition at line 734 of file chip/efr32/efr32xg1x/rail_chip_specific.h

RAIL_TX_POWER_LEVEL_2P4_LP_MAX#

#define RAIL_TX_POWER_LEVEL_2P4_LP_MAX
Value:
(7U)

The maximum valid value for the RAIL_TxPowerLevel_t when in RAIL_TX_POWER_MODE_2P4_LP mode.


Definition at line 740 of file chip/efr32/efr32xg1x/rail_chip_specific.h

RAIL_TX_POWER_LEVEL_2P4_HP_MAX#

#define RAIL_TX_POWER_LEVEL_2P4_HP_MAX
Value:
(252U)

The maximum valid value for the RAIL_TxPowerLevel_t when in RAIL_TX_POWER_MODE_2P4_HP mode.


Definition at line 745 of file chip/efr32/efr32xg1x/rail_chip_specific.h

RAIL_TX_POWER_LEVEL_SUBGIG_HP_MAX#

#define RAIL_TX_POWER_LEVEL_SUBGIG_HP_MAX
Value:
(248U)

The maximum valid value for the RAIL_TxPowerLevel_t when in RAIL_TX_POWER_MODE_SUBGIG mode.


Definition at line 750 of file chip/efr32/efr32xg1x/rail_chip_specific.h

RAIL_TX_POWER_LEVEL_2P4_LP_MIN#

#define RAIL_TX_POWER_LEVEL_2P4_LP_MIN
Value:
(1U)

The minimum valid value for the RAIL_TxPowerLevel_t when in RAIL_TX_POWER_MODE_2P4_LP mode.


Definition at line 755 of file chip/efr32/efr32xg1x/rail_chip_specific.h

RAIL_TX_POWER_LEVEL_2P4_HP_MIN#

#define RAIL_TX_POWER_LEVEL_2P4_HP_MIN
Value:
(0U)

The minimum valid value for the RAIL_TxPowerLevel_t when in RAIL_TX_POWER_MODE_2P4_HP mode.


Definition at line 760 of file chip/efr32/efr32xg1x/rail_chip_specific.h

RAIL_TX_POWER_LEVEL_SUBGIG_HP_MIN#

#define RAIL_TX_POWER_LEVEL_SUBGIG_HP_MIN
Value:
(0U)

The minimum valid value for the RAIL_TxPowerLevel_t when in RAIL_TX_POWER_MODE_SUBGIG mode.


Definition at line 765 of file chip/efr32/efr32xg1x/rail_chip_specific.h

RAIL_TX_POWER_LEVEL_INVALID#

#define RAIL_TX_POWER_LEVEL_INVALID
Value:
(255U)

Invalid RAIL_TxPowerLevel_t value returned when an error occurs with RAIL_GetTxPower.


Definition at line 770 of file chip/efr32/efr32xg1x/rail_chip_specific.h

RAIL_TX_POWER_LEVEL_MAX#

#define RAIL_TX_POWER_LEVEL_MAX
Value:
(254U)

Sentinel value that can be passed to RAIL_SetTxPower to set the highest power level available on the current PA, regardless of which one is selected.


Definition at line 776 of file chip/efr32/efr32xg1x/rail_chip_specific.h

RAIL_TX_POWER_LEVEL_LP_MAX#

#define RAIL_TX_POWER_LEVEL_LP_MAX
Value:
RAIL_TX_POWER_LEVEL_2P4_LP_MAX

Backwards compatibility define.


Definition at line 779 of file chip/efr32/efr32xg1x/rail_chip_specific.h

RAIL_TX_POWER_LEVEL_HP_MAX#

#define RAIL_TX_POWER_LEVEL_HP_MAX
Value:
RAIL_TX_POWER_LEVEL_2P4_HP_MAX

Backwards compatibility define.


Definition at line 781 of file chip/efr32/efr32xg1x/rail_chip_specific.h

RAIL_TX_POWER_LEVEL_SUBGIG_MAX#

#define RAIL_TX_POWER_LEVEL_SUBGIG_MAX
Value:
RAIL_TX_POWER_LEVEL_SUBGIG_HP_MAX

Backwards compatibility define.


Definition at line 783 of file chip/efr32/efr32xg1x/rail_chip_specific.h

RAIL_TX_POWER_LEVEL_LP_MIN#

#define RAIL_TX_POWER_LEVEL_LP_MIN
Value:
RAIL_TX_POWER_LEVEL_2P4_LP_MIN

Backwards compatibility define.


Definition at line 785 of file chip/efr32/efr32xg1x/rail_chip_specific.h

RAIL_TX_POWER_LEVEL_HP_MIN#

#define RAIL_TX_POWER_LEVEL_HP_MIN
Value:
RAIL_TX_POWER_LEVEL_2P4_HP_MIN

Backwards compatibility define.


Definition at line 787 of file chip/efr32/efr32xg1x/rail_chip_specific.h

RAIL_TX_POWER_LEVEL_SUBGIG_MIN#

#define RAIL_TX_POWER_LEVEL_SUBGIG_MIN
Value:
RAIL_TX_POWER_LEVEL_SUBGIG_HP_MIN

Backwards compatibility define.


Definition at line 789 of file chip/efr32/efr32xg1x/rail_chip_specific.h

RAIL_TX_POWER_MODE_2P4_HP#

#define RAIL_TX_POWER_MODE_2P4_HP
Value:
RAIL_TX_POWER_MODE_2P4GIG_HP

DeprecatedPlease use RAIL_TX_POWER_MODE_2P4GIG_HP instead.


Definition at line 811 of file chip/efr32/efr32xg1x/rail_chip_specific.h

RAIL_TX_POWER_MODE_2P4_LP#

#define RAIL_TX_POWER_MODE_2P4_LP
Value:
RAIL_TX_POWER_MODE_2P4GIG_LP

DeprecatedPlease use RAIL_TX_POWER_MODE_2P4GIG_LP instead.


Definition at line 813 of file chip/efr32/efr32xg1x/rail_chip_specific.h

RAIL_NUM_PA#

#define RAIL_NUM_PA
Value:
(3U)

The number of PA's on this chip.

(Including Virtual PAs)


Definition at line 818 of file chip/efr32/efr32xg1x/rail_chip_specific.h

RAIL_TX_POWER_MODE_NAMES#

#define RAIL_TX_POWER_MODE_NAMES
Value:
{ \
"RAIL_TX_POWER_MODE_2P4GIG_HP", \
"RAIL_TX_POWER_MODE_2P4GIG_LP", \
"RAIL_TX_POWER_MODE_SUBGIG", \
"RAIL_TX_POWER_MODE_NONE" \
}

The names of the TX power modes.

A list of the names for the TX power modes on the EFR32 series 1 parts. This macro is useful for test applications and debugging output.


Definition at line 835 of file chip/efr32/efr32xg1x/rail_chip_specific.h