tal_helper.c File Reference

#include "pal.h"
#include "return_val.h"
#include "tal.h"
#include "tal_internal.h"
#include "ieee_const.h"
#include "tal_helper.h"

Functions
uint8_t	convert_phyTransmitPower_to_reg_value (uint8_t phyTransmitPower_value)
	Converts a phyTransmitPower value to a register value. More...
	FLASH_EXTERN (int8_t tx_pwr_table[16])
	Support and FAQ: visit Atmel Support More...
retval_t	tal_ant_div_config (bool div_ctrl, uint8_t ant_ctrl)
retval_t	tal_calculate_frequency (uint8_t cc_band, uint8_t cc_number, float *freq)
retval_t	tal_convert_reg_value_to_dBm (uint8_t reg_value, int8_t *dbm_value)
retval_t	tal_dump_registers (uint16_t start_addr, uint16_t end_addr, uint8_t *value)
retval_t	tal_ext_pa_ctrl (bool pa_ext_sw_ctrl)
	Enable/Disable the external RF front end control. More...
retval_t	tal_get_curr_trx_config (param_type parameter, uint8_t *param_value)
int8_t	tal_get_rssi_base_val (void)
tal_trx_status_t	tal_get_trx_status (void)
retval_t	tal_rpc_mode_config (uint8_t rpc_mode_sel)
retval_t	tal_rxaack_prom_mode_ctrl (bool prom_ctrl)
retval_t	tal_rxsafe_mode_ctrl (bool safe_mode_ctrl)
	Enable/Disable the rx safe mode. More...
retval_t	tal_set_frequency (float frequency)
	Enable/Disable the external RF front end control. More...
retval_t	tal_set_frequency_regs (uint8_t cc_band, uint8_t cc_number)
	to set the frequency based on CC_BAND and CC_NUMBER Registers More...
retval_t	tal_set_rx_sensitivity_level (uint8_t pdt_level)
retval_t	tal_set_tx_pwr (bool type, int8_t pwr_value)
	Enable/Disable the external RF front end control. More...
retval_t	tal_trx_reg_read (uint16_t reg_addr, uint8_t *data)
retval_t	tal_trx_reg_write (uint16_t reg_addr, uint8_t value)

FLASH_EXTERN

(

int8_t

tx_pwr_table[16]

)

Support and FAQ: visit Atmel Support

retval_t tal_ant_div_config	(	bool	div_ctrl,
		uint8_t	ant_ctrl
	)

References ANT_CTRL_0, ANT_CTRL_1, ANT_CTRL_2, ANT_CTRL_3, ANT_DIV_DISABLE, ANT_DIV_ENABLE, ANT_EXT_SW_DISABLE, ANT_EXT_SW_ENABLE, FAILURE, MAC_INVALID_PARAMETER, MAC_SUCCESS, SR_ANT_CTRL, SR_ANT_DIV_EN, SR_ANT_EXT_SW_EN, SR_PDT_THRES, THRES_ANT_DIV_DISABLE, THRES_ANT_DIV_ENABLE, trx_bit_read(), and trx_bit_write().

retval_t tal_calculate_frequency	(	uint8_t	cc_band,
		uint8_t	cc_number,
		float *	freq
	)

References BASE_ISM_FREQUENCY_MHZ, CC_1_START_FREQUENCY, CC_2_START_FREQUENCY, CC_3_START_FREQUENCY, CC_4_START_FREQUENCY, CC_5_START_FREQUENCY, CC_6_START_FREQUENCY, CC_BAND_8, CC_BAND_9, MAC_INVALID_PARAMETER, MAC_SUCCESS, MAX_CC_BAND, MID_ISM_FREQUENCY_MHZ, MIN_CC_BAND_4_OFFSET, MIN_CC_BAND_5_OFFSET, MIN_CC_BAND_8_OFFSET, and MIN_CC_BAND_9_OFFSET.

retval_t tal_convert_reg_value_to_dBm	(	uint8_t	reg_value,
		int8_t *	dbm_value
	)

References FAILURE, MAC_SUCCESS, and PGM_READ_BYTE.

Referenced by tal_set_tx_pwr().

retval_t tal_dump_registers	(	uint16_t	start_addr,
		uint16_t	end_addr,
		uint8_t *	value
	)

References MAC_INVALID_PARAMETER, MAC_SUCCESS, MAX_REG_ADDR_VALUE, and trx_reg_read().

retval_t tal_ext_pa_ctrl

(

bool

pa_ext_sw_ctrl

)

Enable/Disable the external RF front end control.

Parameters

pa_ext_sw_ctrl

true if external rf front end control has to be enabled

Returns

MAC_SUCCESS if PA_EXT_EN bit is configured correctly FAILURE otherwise

References FAILURE, MAC_SUCCESS, SR_PA_EXT_EN, trx_bit_read(), and trx_bit_write().

retval_t tal_get_curr_trx_config	(	param_type	parameter,
		uint8_t *	param_value
	)

References CC_BAND, CC_NUMBER, MAC_INVALID_PARAMETER, MAC_SUCCESS, RG_CC_CTRL_0, SR_AACK_PROM_MODE, SR_ANT_CTRL, SR_ANT_DIV_EN, SR_ANT_SEL, SR_CC_BAND, SR_TX_PWR, trx_bit_read(), trx_reg_read(), and TX_PWR.

int8_t tal_get_rssi_base_val

(

void

)

References RSSI_BASE_VAL_DBM, and tal_pib.

tal_trx_status_t tal_get_trx_status

(

void

)

References SR_TRX_STATUS, and trx_bit_read().

retval_t tal_rpc_mode_config

(

uint8_t

rpc_mode_sel

)

References FAILURE, MAC_SUCCESS, RG_TRX_RPC, trx_reg_read(), and trx_reg_write().

retval_t tal_rxaack_prom_mode_ctrl

(

bool

prom_ctrl

)

References FAILURE, MAC_SUCCESS, SR_AACK_PROM_MODE, trx_bit_read(), and trx_bit_write().

retval_t tal_rxsafe_mode_ctrl

(

bool

safe_mode_ctrl

)

Enable/Disable the rx safe mode.

Parameters

safe_mode_ctrl

true if rx safe mode has to be enabled

Returns

MAC_SUCCESS if rx_safe_mode bit is configured correctly FAILURE otherwise

References FAILURE, MAC_SUCCESS, SR_RX_SAFE_MODE, trx_bit_read(), and trx_bit_write().

retval_t tal_set_frequency

(

float

frequency

)

Enable/Disable the external RF front end control.

Parameters

pa_ext_sw_ctrl

true if external rf front end control has to be enabled

Returns

MAC_SUCCESS if PA_EXT_EN bit is configured correctly FAILURE otherwise

References BASE_ISM_FREQUENCY_MHZ, CC_1_END_FREQUENCY, CC_1_START_FREQUENCY, CC_2_END_FREQUENCY, CC_2_START_FREQUENCY, CC_3_END_FREQUENCY, CC_3_START_FREQUENCY, CC_4_END_FREQUENCY, CC_4_START_FREQUENCY, CC_5_END_FREQUENCY, CC_5_START_FREQUENCY, CC_6_END_FREQUENCY, CC_6_START_FREQUENCY, CC_BAND_1, CC_BAND_2, CC_BAND_3, CC_BAND_4, CC_BAND_5, CC_BAND_6, CC_BAND_8, CC_BAND_9, CMD_RX_AACK_ON, CMD_TRX_OFF, FAILURE, MAC_INVALID_PARAMETER, MAC_SUCCESS, MAX_ISM_FREQUENCY_MHZ, MID_ISM_FREQUENCY_MHZ, MIN_ISM_FREQUENCY_MHZ, RG_CC_CTRL_0, RX_AACK_ON, set_trx_state(), SR_CC_BAND, tal_trx_status, trx_bit_read(), trx_bit_write(), TRX_OFF, trx_reg_read(), and trx_reg_write().

retval_t tal_set_frequency_regs	(	uint8_t	cc_band,
		uint8_t	cc_number
	)

to set the frequency based on CC_BAND and CC_NUMBER Registers

Parameters

cc_band	band to be selected in cc_band register bits
cc_number	offset frequency to be selected in cc_number register bits

Returns

MAC_SUCCESS if frequency is configured correctly MAC_INVALID_PARAMETER if out of range or incorrect values are given FAILURE if frequency registers are not configured properly

References CC_BAND_4, CC_BAND_5, CC_BAND_8, CC_BAND_9, CMD_RX_AACK_ON, CMD_TRX_OFF, FAILURE, MAC_INVALID_PARAMETER, MAC_SUCCESS, MAX_CC_BAND, MIN_CC_BAND_4_OFFSET, MIN_CC_BAND_5_OFFSET, MIN_CC_BAND_8_OFFSET, MIN_CC_BAND_9_OFFSET, RG_CC_CTRL_0, RX_AACK_ON, set_trx_state(), SR_CC_BAND, tal_trx_status, trx_bit_read(), trx_bit_write(), TRX_OFF, trx_reg_read(), and trx_reg_write().

retval_t tal_set_rx_sensitivity_level

(

uint8_t

pdt_level

)

References FAILURE, MAC_INVALID_PARAMETER, MAC_SUCCESS, MAX_PDT_LEVEL, SR_RX_PDT_LEVEL, trx_bit_read(), and trx_bit_write().

retval_t tal_set_tx_pwr	(	bool	type,
		int8_t	pwr_value
	)

Enable/Disable the external RF front end control.

Parameters

pa_ext_sw_ctrl

true if external rf front end control has to be enabled

Returns

MAC_SUCCESS if PA_EXT_EN bit is configured correctly FAILURE otherwise

References CONV_DBM_TO_phyTransmitPower, convert_phyTransmitPower_to_reg_value(), FAILURE, MAC_INVALID_PARAMETER, MAC_SUCCESS, phyTransmitPower, SR_TX_PWR, tal_convert_reg_value_to_dBm(), tal_pib, tal_pib_set(), trx_bit_read(), and trx_bit_write().

retval_t tal_trx_reg_read	(	uint16_t	reg_addr,
		uint8_t *	data
	)

References MAC_INVALID_PARAMETER, MAC_SUCCESS, MAX_REG_ADDR_VALUE, and trx_reg_read().

retval_t tal_trx_reg_write	(	uint16_t	reg_addr,
		uint8_t	value
	)

References MAC_INVALID_PARAMETER, MAC_SUCCESS, MAX_REG_ADDR_VALUE, trx_reg_read(), and trx_reg_write().