mpsl_fem_tx_power_split()

int8_t mpsl_fem_tx_power_split	(	const mpsl_tx_power_t	power,
		mpsl_tx_power_split_t *const	p_tx_power_split,
		uint16_t	freq_mhz,
		bool	tx_power_ceiling
	)

#include <mpsl/fem/include/protocol/mpsl_fem_protocol_api.h>

Splits transmit power value into components to be applied on each stage on transmit path.

Note

If the exact value of power cannot be achieved, this function attempts to either use available level lower than the requested level to not exceed constraint, or use the lowest available level greater than the requested level, depending on tx_power_ceiling.

Parameters

[in]	power	TX power requested for transmission on air.
[out]	p_tx_power_split	Components of tx_power to be applied for stages on transmit path. If requested power is too high, the split will be set to a value representing maximum achievable power. If the requested power is too low, the split will be set to a value representing minimum achievable power.
[in]	freq_mhz	Frequency in MHz to calculate the split for.
[in]	tx_power_ceiling	Flag to get ceiling or floor of requested transmit power level.

Returns

The power in dBm that will be achieved if values returned through p_tx_power_split are applied.