PA Curve Conversions#

Modules#

RAIL_TxPowerCurveSegment_t

RAIL_TxPowerCurves_t

RAIL_TxPowerCurvesConfig_t

RAIL_TxPowerCurveAlt_t

RAIL_PowerConversion_t

RAIL_PaDescriptor_t

RAIL_TxPowerCurvesConfigAlt_t

Enumerations#

enum
RAIL_PA_ALGORITHM_PIECEWISE_LINEAR
RAIL_PA_ALGORITHM_MAPPING_TABLE
RAIL_PA_ALGORITHM_DBM_POWERSETTING_MAPPING_TABLE
}

PA conversion algorithms types for converting between dBm and power levels.

Variables#

The curves to be used when battery voltage powers transmission.

The curves to be used when the DC-DC converter powers transmission.

Functions#

RAIL_InitTxPowerCurves(const RAIL_TxPowerCurvesConfig_t *config)

Initialize TxPower curves.

RAIL_InitTxPowerCurvesAlt(const RAIL_TxPowerCurvesConfigAlt_t *config)

Initialize TxPower curves.

RAIL_GetTxPowerCurve(RAIL_TxPowerMode_t mode)

Gets the curve that should be used for conversion functions based on the current PA configuration.

RAIL_GetTxPowerCurveLimits(RAIL_Handle_t railHandle, RAIL_TxPowerMode_t mode, RAIL_TxPower_t *maxpower, RAIL_TxPower_t *increment)

Gets the maximum power in deci-dBm that should be used for calculating the segments and to find right curve segment to convert Dbm to raw power level for a specific PA.

void

Initialize PA TX Curves.

Get a pointer to the TX Power Config 2.4 GHz structure.

Get a pointer to the TX Power Config Sub-GHz structure.

Get a pointer to the TX Power Config OFDM structure.

void
sl_rail_util_pa_on_channel_config_change(RAIL_Handle_t rail_handle, const RAIL_ChannelConfigEntry_t *entry)

Provide a channel config change callback capable of configuring the PA correctly.

Enumeration Documentation#

RAIL_PaConversionAlgorithm_t#

RAIL_PaConversionAlgorithm_t

PA conversion algorithms types for converting between dBm and power levels.

Enumerator
RAIL_PA_ALGORITHM_PIECEWISE_LINEAR

Piecewise linear fit.

RAIL_PA_ALGORITHM_MAPPING_TABLE

Mapping table between quantities.

RAIL_PA_ALGORITHM_DBM_POWERSETTING_MAPPING_TABLE

Mapping table between pa power settings and dBm values.


Definition at line 148 of file plugin/pa-conversions/pa_curve_types_efr32.h

Variable Documentation#

RAIL_TxPowerCurvesVbat#

const RAIL_TxPowerCurvesConfigAlt_t RAIL_TxPowerCurvesVbat

The curves to be used when battery voltage powers transmission.


Definition at line 83 of file plugin/pa-conversions/pa_conversions_efr32.h

RAIL_TxPowerCurvesDcdc#

const RAIL_TxPowerCurvesConfigAlt_t RAIL_TxPowerCurvesDcdc

The curves to be used when the DC-DC converter powers transmission.


Definition at line 86 of file plugin/pa-conversions/pa_conversions_efr32.h

Function Documentation#

RAIL_InitTxPowerCurves#

RAIL_Status_t RAIL_InitTxPowerCurves (const RAIL_TxPowerCurvesConfig_t *config)

Initialize TxPower curves.

Parameters
[in]config

A pointer to the custom TX power curves.

Returns

  • Status code indicating success of the function call.

Deprecatedfunction is no longer supported. Must use RAIL_InitTxPowerCurvesAlt() instead.


Definition at line 97 of file plugin/pa-conversions/pa_conversions_efr32.h

RAIL_InitTxPowerCurvesAlt#

RAIL_Status_t RAIL_InitTxPowerCurvesAlt (const RAIL_TxPowerCurvesConfigAlt_t *config)

Initialize TxPower curves.

Parameters
[in]config

A pointer to the custom TX power curves.

Returns

  • RAIL_Status_t indicating success or an error.


Definition at line 105 of file plugin/pa-conversions/pa_conversions_efr32.h

RAIL_GetTxPowerCurve#

RAIL_TxPowerCurves_t const * RAIL_GetTxPowerCurve (RAIL_TxPowerMode_t mode)

Gets the curve that should be used for conversion functions based on the current PA configuration.

Parameters
[in]mode

PA mode whose curves are needed.

Returns

Note

  • : If the mode is not supported by the the chip, then NULL will be returned.


Definition at line 117 of file plugin/pa-conversions/pa_conversions_efr32.h

RAIL_GetTxPowerCurveLimits#

RAIL_Status_t RAIL_GetTxPowerCurveLimits (RAIL_Handle_t railHandle, RAIL_TxPowerMode_t mode, RAIL_TxPower_t *maxpower, RAIL_TxPower_t *increment)

Gets the maximum power in deci-dBm that should be used for calculating the segments and to find right curve segment to convert Dbm to raw power level for a specific PA.

Parameters
[in]railHandle

A RAIL instance handle.

[in]mode

PA mode whose curves are needed.

[out]maxpower

A non-NULL pointer to memory allocated to hold the max power in deci-dBm used in calculation of curve segments.

[out]increment

A non-NULL pointer to memory allocated to hold the increment in deci-dBm used in calculation of curve segments.

For the PAs with RAIL_PaConversionAlgorithm_tRAIL_PA_ALGORITHM_PIECEWISE_LINEAR, if the curves are generated with maxPower and increment other than RAIL_TX_POWER_CURVE_DEFAULT_MAX and RAIL_TX_POWER_CURVE_DEFAULT_INCREMENT respectively, then the first RAIL_TxPowerCurveSegment_t has its maxPowerLevel equal to RAIL_TX_POWER_LEVEL_INVALID and its slope and intercept stores the maxPower and increment in deci-dBm respectively.

Returns

  • Status code indicating success of the function call.


Definition at line 139 of file plugin/pa-conversions/pa_conversions_efr32.h

sl_rail_util_pa_init#

void sl_rail_util_pa_init (void)

Initialize PA TX Curves.

Parameters
N/A

Definition at line 147 of file plugin/pa-conversions/pa_conversions_efr32.h

sl_rail_util_pa_get_tx_power_config_2p4ghz#

RAIL_TxPowerConfig_t * sl_rail_util_pa_get_tx_power_config_2p4ghz (void)

Get a pointer to the TX Power Config 2.4 GHz structure.

Parameters
N/A

Returns

  • A pointer to the TX Power Config stucture.


Definition at line 154 of file plugin/pa-conversions/pa_conversions_efr32.h

sl_rail_util_pa_get_tx_power_config_subghz#

RAIL_TxPowerConfig_t * sl_rail_util_pa_get_tx_power_config_subghz (void)

Get a pointer to the TX Power Config Sub-GHz structure.

Parameters
N/A

Returns

  • A pointer to the TX Power Config stucture.


Definition at line 161 of file plugin/pa-conversions/pa_conversions_efr32.h

sl_rail_util_pa_get_tx_power_config_ofdm#

RAIL_TxPowerConfig_t * sl_rail_util_pa_get_tx_power_config_ofdm (void)

Get a pointer to the TX Power Config OFDM structure.

Parameters
N/A

Returns

  • A pointer to the TX Power Config stucture.


Definition at line 168 of file plugin/pa-conversions/pa_conversions_efr32.h

sl_rail_util_pa_on_channel_config_change#

void sl_rail_util_pa_on_channel_config_change (RAIL_Handle_t rail_handle, const RAIL_ChannelConfigEntry_t *entry)

Provide a channel config change callback capable of configuring the PA correctly.

Parameters
[in]rail_handle

The RAIL handle being passed into this callback.

[in]entry

A pointer to the channel config entry being switched to by hardware.


Definition at line 178 of file plugin/pa-conversions/pa_conversions_efr32.h