tal.c File Reference

This file implements the TAL state machine and provides general functionality used by the TAL.

Copyright (c) 2013-2018 Microchip Technology Inc. and its subsidiaries.

#include <stdint.h>
#include <stdbool.h>
#include <stddef.h>
#include <stdlib.h>
#include "pal.h"
#include "return_val.h"
#include "tal.h"
#include "ieee_const.h"
#include "tal_pib.h"
#include "tal_irq_handler.h"
#include "at86rf233.h"
#include "stack_config.h"
#include "bmm.h"
#include "qmm.h"
#include "tal_rx.h"
#include "tal_tx.h"
#include "tal_constants.h"
#include "tal_internal.h"
#include "mac_build_config.h"

Macros
#define	PLL_LOCK_ATTEMPTS   (3)

Functions
tal_trx_status_t	set_trx_state (trx_cmd_t trx_cmd)
	Sets transceiver state. More...
static void	switch_pll_on (void)
	Switches the PLL on. More...
uint32_t	tal_convert_symbols_to_us_def (uint32_t symbols)
	Conversion of symbols to microseconds. More...
uint32_t	tal_convert_us_to_symbols_def (uint32_t time)
	Conversion of microseconds to symbols. More...
void	tal_task (void)
	TAL task handling. More...

Variables
uint8_t	last_frame_length
frame_info_t *	mac_frame_ptr
	Frame pointer for the frame structure provided by the MCL. More...
volatile bool	tal_awake_end_flag
uint8_t *	tal_frame_to_tx
	Pointer to the 15.4 frame created by the TAL to be handed over to the transceiver. More...
queue_t	tal_incoming_frame_queue
	Queue that contains all frames that are uploaded from the trx, but have not be processed by the MCL yet. More...
tal_pib_t	tal_pib
buffer_t *	tal_rx_buffer = NULL
	Pointer to receive buffer that can be used to upload a frame from the trx. More...
bool	tal_rx_on_required
	Indicates if the transceiver needs to switch on its receiver by tal_task(), because it could not be switched on due to buffer shortage. More...
tal_state_t	tal_state
	Current state of the TAL state machine. More...
tal_trx_status_t	tal_trx_status
	Current state of the transceiver. More...

#define PLL_LOCK_ATTEMPTS   (3)

static void switch_pll_on ( void  )

static

Switches the PLL on.

References Assert, CMD_PLL_ON, ENTER_TRX_REGION, LEAVE_TRX_REGION, pal_get_current_time(), pal_sub_time_us(), pal_trx_irq_flag_clr, PLL_LOCK_DURATION_MAX_US, RG_IRQ_MASK, RG_IRQ_STATUS, RG_PLL_CF, RG_TRX_STATE, SR_TRX_STATUS, trx_bit_read(), TRX_IRQ_0_PLL_LOCK, TRX_IRQ_HIGH, TRX_OFF, trx_reg_read(), and trx_reg_write().

Referenced by set_trx_state().

uint32_t tal_convert_symbols_to_us_def

(

uint32_t

symbols

)

Conversion of symbols to microseconds.

TAL task handling.

References TAL_CONVERT_SYMBOLS_TO_US.

uint32_t tal_convert_us_to_symbols_def

(

uint32_t

time

)

Conversion of microseconds to symbols.

References TAL_CONVERT_US_TO_SYMBOLS.

void tal_task

(

void

)

TAL task handling.

This function

• Checks and allocates the receive buffer.
• Processes the TAL incoming frame queue.
• Implements the TAL state machine.

References Assert, bmm_buffer_alloc(), CMD_RX_AACK_ON, CMD_RX_ON, ed_scan_done(), process_incoming_frame(), qmm_queue_remove(), set_trx_state(), queue_tag::size, TAL_ED_DONE, TAL_ED_RUNNING, TAL_IDLE, tal_pib, tal_rx_on_required, tal_state, TAL_TX_AUTO, TAL_TX_DONE, and tx_done_handling().

uint8_t last_frame_length

Referenced by process_incoming_frame(), send_frame(), and tal_tx_frame().

frame_info_t* mac_frame_ptr

Frame pointer for the frame structure provided by the MCL.

Referenced by handle_tx_end_irq(), tal_tx_frame(), and tx_done_handling().

volatile bool tal_awake_end_flag

Referenced by set_trx_state(), and trx_irq_awake_handler_cb().

uint8_t* tal_frame_to_tx

Pointer to the 15.4 frame created by the TAL to be handed over to the transceiver.

Referenced by send_frame(), tal_tx_frame(), and tx_done_handling().

queue_t tal_incoming_frame_queue

Queue that contains all frames that are uploaded from the trx, but have not be processed by the MCL yet.

Referenced by handle_received_frame_irq(), mac_ready_to_sleep(), tal_init(), and tal_reset().

tal_pib_t tal_pib

Referenced by build_data_frame(), handle_received_frame_irq(), init_tal_pib(), mac_awake_scan(), mac_build_and_tx_beacon(), mac_coord_realignment_command_tx_success(), mac_process_beacon_frame(), mac_process_beacon_request(), mac_process_tal_data_ind(), mac_sleep_trans(), mac_tx_coord_realignment_command(), main(), mcps_data_request(), mlme_get(), mlme_rx_enable_request(), mlme_scan_request(), mlme_start_request(), parse_mpdu(), process_data_ind_not_transient(), process_incoming_frame(), send_frame(), send_scan_cmd(), tal_get_rssi_base_val(), tal_init(), tal_pib_set(), tal_rx_enable(), tal_set_tx_pwr(), tal_task(), tal_tx_frame(), tx_done_handling(), and write_all_tal_pib_to_trx().

buffer_t* tal_rx_buffer = NULL

Pointer to receive buffer that can be used to upload a frame from the trx.

Referenced by handle_received_frame_irq(), handle_tx_end_irq(), tal_init(), tal_pib_set(), and tal_rx_enable().