Group_trx_access

This module includes api's and defenitions required for Devices with externally plugged transceivers(Non Soc's)

Macros
#define	ENTER_TRX_CRITICAL_REGION()
#define	IRQ_PINGET()   port_pin_get_input_level(AT86RFX_IRQ_PIN)
#define	LEAVE_TRX_CRITICAL_REGION()   cpu_irq_restore(flags); }
#define	READ_ACCESS_COMMAND   (0x80)
	Read access command to the tranceiver. More...
#define	RST_HIGH()
	Set TRX GPIO pins. More...
#define	RST_LOW()
#define	SLP_TR_HIGH()
#define	SLP_TR_LOW()
#define	TRX_CMD_FR   (0x20)
	Frame read command of transceiver. More...
#define	TRX_CMD_FW   (0x60)
	Frame write command of transceiver. More...
#define	TRX_CMD_SR   (0x00)
	SRAM read command of transceiver. More...
#define	TRX_CMD_SW   (0x40)
	SRAM write command of transceiver. More...
#define	trx_irq_flag_clr()   CLEAR_TRX_IRQ()
	Clears the transceiver main interrupt. More...
#define	TRX_IRQ_HIGH()   IRQ_PINGET()
	Macro to get the transceiver's main IRQ status. More...
#define	TRX_RST_HIGH()   RST_HIGH()
	Macro to set Reset pin to high. More...
#define	TRX_RST_LOW()   RST_LOW()
	Macro to set Reset pin to low. More...
#define	TRX_SLP_TR_HIGH()   SLP_TR_HIGH()
	Macro to set SLP_TR pin to high. More...
#define	TRX_SLP_TR_LOW()   SLP_TR_LOW()
	Macro to set SLP_TR pin to low. More...
#define	TRX_TRIG_DELAY()   {nop(); nop(); }
#define	U16_TO_TARGET(x)   ((((x) << 8) & 0xFF00) | (((x) >> 8) & 0x00FF))
	This macro is used for handling endianness among the different CPUs. More...
#define	WRITE_ACCESS_COMMAND   (0xC0)
	Write access command of the transceiver. More...

Typedefs
typedef void(*	irq_handler_t )(void)

Functions
void	PhyReset (void)
	Resets the TRX radio. More...
void	trx_aes_wrrd (uint8_t addr, uint8_t *idata, uint8_t length)
	Writes and reads data into/from SRAM of the transceiver. More...
uint8_t	trx_bit_read (uint8_t addr, uint8_t mask, uint8_t pos)
	Subregister read. More...
void	trx_bit_write (uint8_t reg_addr, uint8_t mask, uint8_t pos, uint8_t new_value)
	Subregister write. More...
void	trx_frame_read (uint8_t *data, uint8_t length)
	Reads frame buffer of the transceiver. More...
void	trx_frame_write (uint8_t *data, uint8_t length)
	Writes data into frame buffer of the transceiver. More...
void	trx_irq_init (FUNC_PTR trx_irq_cb)
uint8_t	trx_reg_read (uint8_t addr)
	Reads current value from a transceiver register. More...
void	trx_reg_write (uint8_t addr, uint8_t data)
	Writes data into a transceiver register. More...
void	trx_spi_disable (void)
	Disables the SPI interface for communication with the transceiver. More...
void	trx_spi_done_cb_init (void *spi_done_cb)
	SPI done callback initialization. More...
void	trx_spi_enable (void)
	enables the SPI interface for communication with the transceiver More...
void	trx_spi_init (void)
	Initializes the SPI interface for communication with the transceiver. More...
void	trx_sram_read (uint8_t addr, uint8_t *data, uint8_t length)
	Reads data from SRAM of the transceiver. More...
void	trx_sram_write (uint8_t addr, uint8_t *data, uint8_t length)
	Writes data into SRAM of the transceiver. More...

#define ENTER_TRX_CRITICAL_REGION

(

)

Value:

{uint8_t flags  \
                              = cpu_irq_save();

Referenced by trx_frame_read(), trx_frame_write(), trx_reg_read(), trx_reg_write(), trx_sram_read(), and trx_sram_write().

#define IRQ_PINGET

(

)

port_pin_get_input_level(AT86RFX_IRQ_PIN)

#define LEAVE_TRX_CRITICAL_REGION

(

)

cpu_irq_restore(flags); }

Referenced by trx_frame_read(), trx_frame_write(), trx_reg_read(), trx_reg_write(), trx_sram_read(), and trx_sram_write().

#define READ_ACCESS_COMMAND   (0x80)

Read access command to the tranceiver.

Referenced by trx_reg_read().

#define RST_HIGH

(

)

Value:

port_pin_set_output_level( \
        AT86RFX_RST_PIN, true)

Set TRX GPIO pins.

Referenced by PhyReset().

#define RST_LOW

(

)

Value:

port_pin_set_output_level( \
        AT86RFX_RST_PIN, false)

Referenced by PhyReset().

#define SLP_TR_HIGH

(

)

Value:

port_pin_set_output_level( \
        AT86RFX_SLP_PIN, true)

#define SLP_TR_LOW

(

)

Value:

port_pin_set_output_level( \
        AT86RFX_SLP_PIN, false)

Referenced by PhyReset().

#define TRX_CMD_FR   (0x20)

Frame read command of transceiver.

Referenced by trx_frame_read().

#define TRX_CMD_FW   (0x60)

Frame write command of transceiver.

Referenced by trx_frame_write().

#define TRX_CMD_SR   (0x00)

SRAM read command of transceiver.

Referenced by trx_sram_read().

#define TRX_CMD_SW   (0x40)

SRAM write command of transceiver.

Referenced by trx_aes_wrrd(), and trx_sram_write().

#define trx_irq_flag_clr

(

)

CLEAR_TRX_IRQ()

Clears the transceiver main interrupt.

#define TRX_IRQ_HIGH

(

)

IRQ_PINGET()

Macro to get the transceiver's main IRQ status.

Referenced by switch_pll_on().

#define TRX_RST_HIGH

(

)

RST_HIGH()

Macro to set Reset pin to high.

Referenced by trx_init(), and trx_reset().

#define TRX_RST_LOW

(

)

RST_LOW()

Macro to set Reset pin to low.

Referenced by trx_init(), and trx_reset().

#define TRX_SLP_TR_HIGH

(

)

SLP_TR_HIGH()

Macro to set SLP_TR pin to high.

Referenced by handle_tx_end_irq(), send_frame(), set_trx_state(), and tal_tx_beacon().

#define TRX_SLP_TR_LOW

(

)

SLP_TR_LOW()

Macro to set SLP_TR pin to low.

Referenced by handle_tx_end_irq(), send_frame(), set_trx_state(), tal_tx_beacon(), trx_init(), and trx_reset().

#define TRX_TRIG_DELAY

(

)

{nop(); nop(); }

#define U16_TO_TARGET

(

x

)

((((x) << 8) & 0xFF00) | (((x) >> 8) & 0x00FF))

This macro is used for handling endianness among the different CPUs.

#define WRITE_ACCESS_COMMAND   (0xC0)

Write access command of the transceiver.

Referenced by trx_reg_write().

typedef void(* irq_handler_t)(void)

void PhyReset

(

void

)

Resets the TRX radio.

References delay_us, RST_HIGH, RST_LOW, and SLP_TR_LOW.

void trx_aes_wrrd	(	uint8_t	addr,
		uint8_t *	idata,
		uint8_t	length
	)

Writes and reads data into/from SRAM of the transceiver.

This function writes data into the SRAM of the transceiver and simultaneously reads the bytes.

Parameters

addr	Start address in the SRAM for the write operation
idata	Pointer to the data written/read into/from SRAM
length	Number of bytes written/read into/from SRAM

References AT86RFX_SPI, delay_us, ENTER_TRX_REGION, LEAVE_TRX_REGION, SPI_AT86RFX_DEVICE, spi_is_ready_to_read(), spi_is_ready_to_write(), spi_is_write_complete(), spi_read(), spi_select_slave(), spi_write(), and TRX_CMD_SW.

Referenced by sal_aes_wrrd().

uint8_t trx_bit_read	(	uint8_t	addr,
		uint8_t	mask,
		uint8_t	pos
	)

Subregister read.

Parameters

addr	offset of the register
mask	bit mask of the subregister
pos	bit position of the subregister

Returns

value of the read bit(s)

References trx_reg_read().

Referenced by handle_received_frame_irq(), handle_tx_end_irq(), perform_cca_twice(), set_trx_state(), switch_pll_on(), tal_ant_div_config(), tal_ext_pa_ctrl(), tal_generate_rand_seed(), tal_get_curr_trx_config(), tal_get_trx_status(), tal_rxaack_prom_mode_ctrl(), tal_rxsafe_mode_ctrl(), tal_set_frequency(), tal_set_frequency_regs(), tal_set_rx_sensitivity_level(), tal_set_tx_pwr(), trx_init(), and trx_reset().

void trx_bit_write	(	uint8_t	reg_addr,
		uint8_t	mask,
		uint8_t	pos,
		uint8_t	new_value
	)

Subregister write.

Parameters

[in]	reg_addr	Offset of the register
[in]	mask	Bit mask of the subregister
[in]	pos	Bit position of the subregister
[out]	new_value	Data, which is muxed into the register

References trx_reg_read(), and trx_reg_write().

Referenced by ed_scan_done(), perform_cca_twice(), send_frame(), set_trx_state(), tal_ant_div_config(), tal_ed_start(), tal_ext_pa_ctrl(), tal_generate_rand_seed(), tal_pib_set(), tal_rxaack_prom_mode_ctrl(), tal_rxsafe_mode_ctrl(), tal_set_frequency(), tal_set_frequency_regs(), tal_set_rx_sensitivity_level(), tal_set_tx_pwr(), trx_config(), and write_all_tal_pib_to_trx().

void trx_frame_read	(	uint8_t *	data,
		uint8_t	length
	)

Reads frame buffer of the transceiver.

This function reads the frame buffer of the transceiver.

Parameters

[out]	data	Pointer to the location to store frame
[in]	length	Number of bytes to be read from the frame buffer.

References AT86RFX_SPI, ENTER_TRX_CRITICAL_REGION, LEAVE_TRX_CRITICAL_REGION, SPI_AT86RFX_DEVICE, spi_is_ready_to_read(), spi_is_ready_to_write(), spi_is_write_complete(), spi_read(), spi_select_slave(), spi_write(), and TRX_CMD_FR.

Referenced by handle_received_frame_irq().

void trx_frame_write	(	uint8_t *	data,
		uint8_t	length
	)

Writes data into frame buffer of the transceiver.

This function writes data into the frame buffer of the transceiver

Parameters

[in]	data	Pointer to data to be written into frame buffer
[in]	length	Number of bytes to be written into frame buffer

References AT86RFX_SPI, ENTER_TRX_CRITICAL_REGION, LEAVE_TRX_CRITICAL_REGION, SPI_AT86RFX_DEVICE, spi_is_ready_to_read(), spi_is_ready_to_write(), spi_is_write_complete(), spi_read(), spi_select_slave(), spi_write(), and TRX_CMD_FW.

Referenced by send_frame(), and tal_tx_beacon().

void trx_irq_init

(

FUNC_PTR

trx_irq_cb

)

References irq_hdl_trx.

Referenced by ed_scan_done(), set_trx_state(), tal_ed_start(), tal_init(), and tal_reset().

uint8_t trx_reg_read

(

uint8_t

addr

)

Reads current value from a transceiver register.

This function reads the current value from a transceiver register.

Parameters

addr	Specifies the address of the trx register from which the data shall be read

Returns

value of the register read

References AT86RFX_SPI, ENTER_TRX_CRITICAL_REGION, LEAVE_TRX_CRITICAL_REGION, READ_ACCESS_COMMAND, SPI_AT86RFX_DEVICE, spi_is_ready_to_read(), spi_is_ready_to_write(), spi_is_write_complete(), spi_read(), spi_select_slave(), and spi_write().

Referenced by perform_cca_twice(), set_trx_state(), switch_pll_on(), tal_dump_registers(), tal_ed_start(), tal_generate_rand_seed(), tal_get_curr_trx_config(), tal_rpc_mode_config(), tal_set_frequency(), tal_set_frequency_regs(), tal_trx_reg_read(), tal_trx_reg_write(), trx_bit_read(), trx_bit_write(), trx_ed_irq_handler_cb(), trx_init(), trx_irq_awake_handler_cb(), and trx_irq_handler_cb().

void trx_reg_write	(	uint8_t	addr,
		uint8_t	data
	)

Writes data into a transceiver register.

This function writes a value into transceiver register.

Parameters

addr	Address of the trx register
data	Data to be written to trx register

References AT86RFX_SPI, ENTER_TRX_CRITICAL_REGION, LEAVE_TRX_CRITICAL_REGION, SPI_AT86RFX_DEVICE, spi_is_ready_to_read(), spi_is_ready_to_write(), spi_is_write_complete(), spi_read(), spi_select_slave(), spi_write(), and WRITE_ACCESS_COMMAND.

Referenced by ed_scan_done(), set_trx_state(), switch_pll_on(), tal_ed_start(), tal_generate_rand_seed(), tal_pib_set(), tal_rpc_mode_config(), tal_set_frequency(), tal_set_frequency_regs(), tal_trx_reg_write(), trx_bit_write(), trx_config(), trx_ed_irq_handler_cb(), trx_init(), and write_all_tal_pib_to_trx().

void trx_spi_disable

(

void

)

Disables the SPI interface for communication with the transceiver.

References spi_disable().

void trx_spi_done_cb_init

(

void *

spi_done_cb

)

SPI done callback initialization.

Parameters

spi_done_cb

Pointer to SPI done callback function

void trx_spi_enable

(

void

)

enables the SPI interface for communication with the transceiver

References spi_enable().

void trx_spi_init

(

void

)

Initializes the SPI interface for communication with the transceiver.

References AT86RFX_IRQ_CHAN, AT86RFX_IRQ_PIN, AT86RFX_IRQ_PINMUX, AT86RFX_SPI, AT86RFX_SPI_BAUDRATE, AT86RFX_SPI_CS, AT86RFX_SPI_SERCOM_MUX_SETTING, AT86RFX_SPI_SERCOM_PINMUX_PAD0, AT86RFX_SPI_SERCOM_PINMUX_PAD1, AT86RFX_SPI_SERCOM_PINMUX_PAD2, AT86RFX_SPI_SERCOM_PINMUX_PAD3, extint_chan_conf::detection_criteria, EXTINT_CALLBACK_TYPE_DETECT, extint_chan_get_config_defaults(), extint_chan_set_config(), EXTINT_DETECT_RISING, EXTINT_PULL_DOWN, extint_register_callback(), extint_chan_conf::filter_input_signal, extint_chan_conf::gpio_pin, extint_chan_conf::gpio_pin_mux, extint_chan_conf::gpio_pin_pull, SPI_AT86RFX_DEVICE, spi_attach_slave(), spi_enable(), spi_get_config_defaults(), spi_init(), spi_slave_inst_get_config_defaults(), and extint_chan_conf::wake_if_sleeping.

Referenced by pal_init().

void trx_sram_read	(	uint8_t	addr,
		uint8_t *	data,
		uint8_t	length
	)

Reads data from SRAM of the transceiver.

This function reads from the SRAM of the transceiver

Parameters

[in]	addr	Start address in SRAM for read operation
[out]	data	Pointer to the location where data stored
[in]	length	Number of bytes to be read from SRAM

References AT86RFX_SPI, delay_us, ENTER_TRX_CRITICAL_REGION, LEAVE_TRX_CRITICAL_REGION, SPI_AT86RFX_DEVICE, spi_is_ready_to_read(), spi_is_ready_to_write(), spi_is_write_complete(), spi_read(), spi_select_slave(), spi_write(), and TRX_CMD_SR.

Referenced by handle_received_frame_irq(), sal_aes_read(), and sal_aes_setup().

void trx_sram_write	(	uint8_t	addr,
		uint8_t *	data,
		uint8_t	length
	)

Writes data into SRAM of the transceiver.

This function writes data into the SRAM of the transceiver

Parameters

addr	Start address in the SRAM for the write operation
data	Pointer to the data to be written into SRAM
length	Number of bytes to be written into SRAM

References AT86RFX_SPI, ENTER_TRX_CRITICAL_REGION, LEAVE_TRX_CRITICAL_REGION, SPI_AT86RFX_DEVICE, spi_is_ready_to_read(), spi_is_ready_to_write(), spi_is_write_complete(), spi_read(), spi_select_slave(), spi_write(), and TRX_CMD_SW.

Referenced by sal_aes_restart(), and sal_aes_setup().