The Atmel transceivers provide a variety of additional hardware features features that are not reflected in the IEEE 802.15.4 standard.

These features are for eg .Reading battery voltage, Continuous wave transmission etc .

Macros
#define	SUPPLY_VOLTAGE_ABOVE_UPPER_LIMIT (0xFFFF)
	Supply voltage above upper limit. More...

#define	SUPPLY_VOLTAGE_BELOW_LOWER_LIMIT (0)
	Supply voltage below lower limit. More...

#define	TFA_PIB_RX_SENS_DEF (RSSI_BASE_VAL_BPSK_600_DBM)
	Default value of TFA PIB attribute to reduce the Rx sensitivity. More...

Typedefs
typedef enum continuous_tx_mode_tag	continuous_tx_mode_t
	Continuous Transmission modes. More...

typedef enum tfa_pib_t	tfa_pib_t
	Transceiver commands. More...

Enumerations
enum	continuous_tx_mode_tag { CW_MODE = 0, PRBS_MODE = 1, CW_MODE_2 = 2, CW_ALL_ZEROS_MODE = 3 }
	Continuous Transmission modes. More...

enum	tfa_pib_t { TFA_PIB_RX_SENS = 0 }
	Transceiver commands. More...

Functions
static void	init_tfa_pib (void)
	Initialize the TFA PIB. More...

retval_t	tfa_batmon_irq_init (FUNC_PTR(batmon_irq_cb), uint16_t vth)
	Setups the battery monitor interrupt. More...

phy_enum_t	tfa_cca_perform (void)
	Perform a CCA. More...

void	tfa_continuous_tx_start (continuous_tx_mode_t tx_mode, bool random_content)
	Starts continuous transmission on current channel. More...

void	tfa_continuous_tx_stop (void)
	Stops CW transmission. More...

uint8_t	tfa_ed_sample (void)
	Perform a single ED measurement. More...

uint16_t	tfa_get_batmon_voltage (void)
	Gets the transceiver's supply voltage. More...

double	tfa_get_temperature (void)
	Get the temperature value from the integrated sensor. More...

retval_t	tfa_init (void)
	Initializes the TFA. More...

retval_t	tfa_pib_get (tfa_pib_t tfa_pib_attribute, void *value)
	Gets a TFA PIB attribute. More...

retval_t	tfa_pib_set (tfa_pib_t tfa_pib_attribute, void *value)
	Sets a TFA PIB attribute. More...

void	tfa_reset (bool set_default_pib)
	Reset the TFA. More...

static void	write_all_tfa_pibs_to_trx (void)
	Write all shadow PIB variables to the transceiver. More...

#define SUPPLY_VOLTAGE_ABOVE_UPPER_LIMIT (0xFFFF)

Supply voltage above upper limit.

Referenced by tfa_get_batmon_voltage().

#define SUPPLY_VOLTAGE_BELOW_LOWER_LIMIT (0)

Supply voltage below lower limit.

Referenced by tfa_get_batmon_voltage().

#define TFA_PIB_RX_SENS_DEF (RSSI_BASE_VAL_BPSK_600_DBM)

Default value of TFA PIB attribute to reduce the Rx sensitivity.

By default, reduced sensitivity is disabled.

Referenced by init_tfa_pib().

typedef enum continuous_tx_mode_tag continuous_tx_mode_t

Continuous Transmission modes.

typedef enum tfa_pib_t tfa_pib_t

Transceiver commands.

enum continuous_tx_mode_tag

Continuous Transmission modes.

Enumerator
CW_MODE
PRBS_MODE
CW_MODE_2
CW_ALL_ZEROS_MODE

enum tfa_pib_t

Transceiver commands.

Enumerator
TFA_PIB_RX_SENS

static void init_tfa_pib ( void )

static

Initialize the TFA PIB.

This function initializes the TFA information base attributes to their default values.

References tfa_pib_rx_sens, and TFA_PIB_RX_SENS_DEF.

Referenced by tfa_init(), and tfa_reset().

retval_t tfa_batmon_irq_init	(	FUNC_PTR(batmon_irq_cb)	,
		uint16_t	vth
	)

Setups the battery monitor interrupt.

Parameters

batmon_irq_cb	Callback function for the batmon interrupt
vth	Threshold value in millivolt

Returns: MAC_SUCCESS if provided voltage is within range, else MAC_INVALID_PARAMETER

phy_enum_t tfa_cca_perform ( void )

Perform a CCA.

This function performs a CCA request.

Returns: phy_enum_t PHY_IDLE or PHY_BUSY

References CCA_CH_IDLE, CCA_COMPLETED, CCA_DURATION_SYM, CCA_START, CMD_RX_ON, CMD_TRX_OFF, pal_timer_delay, PHY_BUSY, PHY_IDLE, RX_DISABLE, RX_ENABLE, RX_ON, set_trx_state(), SR_CCA_DONE, SR_CCA_REQUEST, SR_CCA_STATUS, SR_RX_PDT_DIS, TAL_CONVERT_SYMBOLS_TO_US, trx_bit_read(), trx_bit_write(), and TRX_OFF.

void tfa_continuous_tx_start	(	continuous_tx_mode_t	tx_mode,
		bool	random_content
	)

Starts continuous transmission on current channel.

Parameters

trx_id	Identifier of the transceiver
tx_mode	Transmission mode
random_content	Use random content if true

References CMD_PLL_ON, CMD_TRX_OFF, CW_MODE, RG_PART_NUM, RG_TRX_CTRL_2, RG_TRX_STATE, set_trx_state(), tal_pib, trx_frame_write(), trx_reg_write(), TRX_SLP_TR_HIGH, and TRX_SLP_TR_LOW.

Referenced by pulse_cw_transmission(), and start_cw_transmission().

void tfa_continuous_tx_stop ( void )

Stops CW transmission.

References tal_reset().

Referenced by stop_cw_transmission(), and stop_pulse_cb().

uint8_t tfa_ed_sample ( void )

Perform a single ED measurement.

Returns: ed_value Result of the measurement (transceiver's register value) If the build switch TRX_REG_RAW_VALUE is defined, the transceiver's register value is returned.

References CLIP_VALUE_REG, CMD_RX_ON, CMD_TRX_OFF, ED_SAMPLE_DURATION_SYM, pal_timer_delay, RG_IRQ_STATUS, RG_PHY_ED_LEVEL, RX_DISABLE, RX_ENABLE, RX_ON, set_trx_state(), SR_RX_PDT_DIS, TAL_CONVERT_SYMBOLS_TO_US, trx_bit_write(), TRX_IRQ_4_CCA_ED_DONE, trx_reg_read(), and trx_reg_write().

uint16_t tfa_get_batmon_voltage ( void )

Gets the transceiver's supply voltage.

Returns: mv Milli Volt; 0 if below threshold, 0xFFFF if above threshold

References BATMON_HR_HIGH, BATMON_HR_LOW, BATMON_NOT_VALID, BATMON_VALID, CMD_SLEEP, CMD_TRX_OFF, HIGH, LOW, pal_timer_delay, pal_trx_irq_dis, pal_trx_irq_en, RG_IRQ_STATUS, set_trx_state(), SR_BATMON_HR, SR_BATMON_OK, SR_BATMON_VTH, SUPPLY_VOLTAGE_ABOVE_UPPER_LIMIT, SUPPLY_VOLTAGE_BELOW_LOWER_LIMIT, tal_trx_status, trx_bit_read(), trx_bit_write(), trx_reg_read(), and TRX_SLEEP.

Referenced by get_sensor_data().

double tfa_get_temperature ( void )

Get the temperature value from the integrated sensor.

Returns: temperature value in degree Celsius

Referenced by get_sensor_data().

retval_t tfa_init ( void )

Initializes the TFA.

This function is called to initialize the TFA.

Returns: MAC_SUCCESS if everything went correct; FAILURE otherwise

References init_tfa_pib(), MAC_SUCCESS, and write_all_tfa_pibs_to_trx().

Referenced by tal_init().

retval_t tfa_pib_get	(	tfa_pib_t	tfa_pib_attribute,
		void *	value
	)

Gets a TFA PIB attribute.

This function is called to retrieve the transceiver information base attributes.

Parameters

[in]	tfa_pib_attribute	TAL infobase attribute ID
[out]	value	TFA infobase attribute value

Returns: MAC_UNSUPPORTED_ATTRIBUTE if the TFA infobase attribute is not found MAC_SUCCESS otherwise

References MAC_SUCCESS, MAC_UNSUPPORTED_ATTRIBUTE, TFA_PIB_RX_SENS, and tfa_pib_rx_sens.

retval_t tfa_pib_set	(	tfa_pib_t	tfa_pib_attribute,
		void *	value
	)

Sets a TFA PIB attribute.

This function is called to set the transceiver information base attributes.

Parameters

[in]	tfa_pib_attribute	TFA infobase attribute ID
[in]	value	TFA infobase attribute value to be set

Returns: MAC_UNSUPPORTED_ATTRIBUTE if the TFA info base attribute is not found TAL_BUSY if the TAL is not in TAL_IDLE state. MAC_SUCCESS if the attempt to set the PIB attribute was successful

References MAC_SUCCESS, MAC_UNSUPPORTED_ATTRIBUTE, RSSI_BASE_VAL_BPSK_300_DBM, RSSI_BASE_VAL_BPSK_600_DBM, RSSI_BASE_VAL_OQPSK_1000_RC_DBM, RSSI_BASE_VAL_OQPSK_1000_SIN_DBM, RSSI_BASE_VAL_OQPSK_400_SIN_RC_DBM, SR_RX_PDT_LEVEL, tal_pib, TFA_PIB_RX_SENS, tfa_pib_rx_sens, and trx_bit_write().