Macros
#define	GET_CHINA_FREQ(x) (11 + (2 * x))

Functions
static bool	apply_channel_page_configuration (uint8_t ch_page)
	Apply channel page configuartion to transceiver. More...

static uint8_t	convert_phyTransmitPower_to_reg_value (uint8_t phyTransmitPower_value)
	Converts a phyTransmitPower value to a register value. More...

	FLASH_DECLARE (int8_t tx_pwr_table[16])

static	FLASH_DECLARE (uint8_t tx_pwr_table_NA[TX_PWR_TABLE_SIZE]) = { TX_PWR_TABLE_EU }
	Tx power table in flash. More...

void	init_tal_pib (void)
	Initialize the TAL PIB. More...

static void	limit_tx_pwr (void)
	Limit the phyTransmitPower to the trx limits. More...

static uint8_t	limit_tx_pwr (uint8_t curr_transmit_power)
	Limit the phyTransmitPower to the trx limits. More...

static void	set_default_tx_pwr (void)
	Set the default Power Values For Respective Pages and Channels. More...

retval_t	tal_pib_get (uint8_t attribute, uint8_t *value)
	Gets a TAL PIB attribute. More...

retval_t	tal_pib_set (uint8_t attribute, pib_value_t *value)
	Sets a TAL PIB attribute. More...

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

#define GET_CHINA_FREQ ( x ) (11 + (2 * x))

Referenced by apply_channel_page_configuration(), and tal_pib_set().

static bool apply_channel_page_configuration ( uint8_t ch_page )

static

Apply channel page configuartion to transceiver.

Parameters

ch_page Channel page

Returns: true if changes could be applied else false

References ACK_TIME_12_SYMBOLS, ACK_TIME_2_SYMBOLS, ALT_SPECTRUM_DISABLE, ALT_SPECTRUM_ENABLE, ALTRATE_100_KBPS_OR_250_KBPS, ALTRATE_200_KBPS_OR_500_KBPS, ALTRATE_400_KBPS_OR_1_MBPS, BPSK_MODE, BPSK_TX_OFFSET, GET_CHINA_FREQ, HIGH_DATA_RATE, LOW_DATA_RATE, MAX_FRAME_DURATION, NO_OF_SYMBOLS_PREAMBLE_SFD, OQPSK_MODE, OQPSK_TX_OFFSET, SR_AACK_ACK_TIME, SR_ALT_SPECTRUM, SR_BPSK_OQPSK, SR_CC_BAND, SR_CC_NUMBER, SR_CHANNEL, SR_GC_TX_OFFS, SR_OQPSK_DATA_RATE, SR_SUB_MODE, SYMBOLS_PER_OCTET, tal_pib, trx_bit_write(), TRX_SUPPORTED_CHANNELS, and TRX_SUPPORTED_CHANNELS_CHINA.

Referenced by tal_pib_set(), and write_all_tal_pib_to_trx().

static uint8_t convert_phyTransmitPower_to_reg_value ( uint8_t phyTransmitPower_value )

static

Converts a phyTransmitPower value to a register value.

Parameters

phyTransmitPower_value phyTransmitPower value

Returns: register value

FLASH_DECLARE ( int8_t tx_pwr_table[16] )

static FLASH_DECLARE ( uint8_t tx_pwr_table_NA[TX_PWR_TABLE_SIZE] ) = { TX_PWR_TABLE_EU }

static

Tx power table in flash.

void init_tal_pib ( void )

Initialize the TAL PIB.

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

References limit_tx_pwr(), TAL_BATTERY_LIFE_EXTENSION_DEFAULT, TAL_BEACON_ORDER_DEFAULT, TAL_CCA_MODE_DEFAULT, TAL_CURRENT_CHANNEL_DEFAULT, TAL_CURRENT_PAGE_DEFAULT, TAL_MAX_CSMA_BACKOFFS_DEFAULT, TAL_MAX_FRAME_DURATION_DEFAULT, TAL_MAXBE_DEFAULT, TAL_MAXFRAMERETRIES_DEFAULT, TAL_MINBE_DEFAULT, TAL_PAN_COORDINATOR_DEFAULT, TAL_PANID_BC_DEFAULT, tal_pib, TAL_PIB_PROMISCUOUS_MODE_DEFAULT, TAL_SHORT_ADDRESS_DEFAULT, TAL_SHR_DURATION_DEFAULT, TAL_SUPERFRAME_ORDER_DEFAULT, TAL_SYMBOLS_PER_OCTET_DEFAULT, and TAL_TRANSMIT_POWER_DEFAULT.

static void limit_tx_pwr ( void )

static

Limit the phyTransmitPower to the trx limits.

Parameters

phyTransmitPower phyTransmitPower value

References CONV_DBM_TO_phyTransmitPower, CONV_phyTransmitPower_TO_DBM, MAX_TX_PWR, MIN_TX_PWR, tal_pib, and TX_PWR_TOLERANCE.

Referenced by init_tal_pib(), set_default_tx_pwr(), and tal_pib_set().

static uint8_t limit_tx_pwr ( uint8_t curr_transmit_power )

static

Limit the phyTransmitPower to the trx limits.

Parameters

phyTransmitPower phyTransmitPower value

Returns: limited tal_pib_TransmitPower

References CONV_DBM_TO_phyTransmitPower, CONV_phyTransmitPower_TO_DBM, PGM_READ_BYTE, and TX_PWR_TOLERANCE.

static void set_default_tx_pwr ( void )

static

Set the default Power Values For Respective Pages and Channels.

References CONV_DBM_TO_phyTransmitPower, CONV_phyTransmitPower_TO_DBM, convert_phyTransmitPower_to_reg_value(), DEFAULT_TX_PWR_BPSK_20, DEFAULT_TX_PWR_CHINA_CH_0_3, DEFAULT_TX_PWR_OQPSK_RC_250_500, DEFAULT_TX_PWR_OQPSK_SIN_RC_100_200_400, limit_tx_pwr(), RG_PHY_TX_PWR, tal_pib, trx_reg_write(), and TX_PWR_TOLERANCE.

Referenced by tal_pib_set().

retval_t tal_pib_get	(	uint8_t	attribute,
		uint8_t *	value
	)

Gets a TAL PIB attribute.

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

Parameters

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

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

References mac_i_pan_coordinator, MAC_SUCCESS, MAC_UNSUPPORTED_ATTRIBUTE, macAckWaitDuration, macBattLifeExt, macBeaconOrder, macBeaconTxTime, macIeeeAddress, macMaxBE, macMaxCSMABackoffs, macMaxFrameRetries, macMinBE, macPANId, macPromiscuousMode, macShortAddress, macSuperframeOrder, phyCCAMode, phyChannelsSupported, phyCurrentChannel, phyCurrentPage, phyMaxFrameDuration, phySHRDuration, phySymbolsPerOctet, phyTransmitPower, and tal_pib.

retval_t tal_pib_set	(	uint8_t	attribute,
		pib_value_t *	value
	)

Sets a TAL PIB attribute.

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

Parameters

attribute	TAL infobase attribute ID
value	TAL infobase attribute value to be set

Returns

MAC_UNSUPPORTED_ATTRIBUTE if the TAL info base attribute is not found
TAL_BUSY if the TAL is not in TAL_IDLE state. An exception is macBeaconTxTime which can be accepted by TAL even if TAL is not in TAL_IDLE state.
MAC_SUCCESS if the attempt to set the PIB attribute was successful
TAL_TRX_ASLEEP if trx is in SLEEP mode and access to trx is required

References apply_channel_page_configuration(), Assert, CMD_PLL_ON, CMD_RX_AACK_ON, CMD_RX_ON, CMD_TRX_OFF, convert_phyTransmitPower_to_reg_value(), for(), GET_CHINA_FREQ, i, limit_tx_pwr(), mac_i_pan_coordinator, MAC_INVALID_PARAMETER, MAC_SUCCESS, MAC_UNSUPPORTED_ATTRIBUTE, macAckWaitDuration, macBattLifeExt, macBeaconOrder, macBeaconTxTime, macIeeeAddress, macMaxBE, macMaxCSMABackoffs, macMaxFrameRetries, macMinBE, macPANId, macPromiscuousMode, macShortAddress, macSuperframeOrder, NULL, phyCCAMode, phyCurrentChannel, phyCurrentPage, phyTransmitPower, ptr, RG_IEEE_ADDR_0, RG_PAN_ID_0, RG_PHY_TX_PWR, RG_SHORT_ADDR_0, RX_AACK_ON, set_default_tx_pwr(), set_trx_state(), SR_AACK_I_AM_COORD, SR_CC_NUMBER, SR_CCA_MODE, SR_CHANNEL, SR_MAX_BE, SR_MIN_BE, TAL_BUSY, TAL_IDLE, tal_pib, tal_rx_buffer, tal_rx_on_required, tal_state, TAL_TRX_ASLEEP, tal_trx_status, tal_trx_wakeup(), trx_bit_write(), TRX_OFF, trx_reg_write(), TRX_SLEEP, TRX_SUPPORTED_CHANNELS, and TRX_SUPPORTED_CHANNELS_CHINA.

void write_all_tal_pib_to_trx ( void )

Write all shadow PIB variables to the transceiver.

This function writes all shadow PIB variables to the transceiver. It is assumed that the radio does not sleep.

References apply_channel_page_configuration(), CMD_RX_ON, convert_phyTransmitPower_to_reg_value(), for(), i, RG_IEEE_ADDR_0, RG_PAN_ID_0, RG_PHY_TX_PWR, RG_SHORT_ADDR_0, set_trx_state(), SR_AACK_I_AM_COORD, SR_CCA_MODE, SR_MAX_BE, SR_MAX_CSMA_RETRIES, SR_MAX_FRAME_RETRIES, SR_MIN_BE, tal_pib, trx_bit_write(), and trx_reg_write().

Microchip® Advanced Software Framework

Macros

Functions