This module handles the functionalities of the Initiator in PER mode.

Modules
	PER mode Receptor
	This module handles the functionalities of the receptor in PER mode.

Data Structures
struct	set_param_cb_t
	Structure used for updating the parameters after sending them to peer. More...

Functions
static float	calculate_net_data_rate (float per_test_duration_sec)
	Function to calculate net data rate for the current PER test. More...

static float	calculate_time_duration (void)
	Function to Calculate the time taken for PER Test. More...

uint8_t	check_error_conditions (void)
	Function to check the error conditions before. More...

static void	config_ack_request (bool config_value)
	To set or reset ACK request value. More...

static void	config_csma (bool config_value)
	To configure CSMA Setting in the transceiver. More...

static void	config_frame_retry (bool config_value)
	To configure frame retry Setting. More...

static void	config_frequency (float frequency)
	Function to configure the ISM frequency based on the request. More...

static void	config_rpc_mode (bool config_value)
	toggle RPC mode request More...

static void	configure_frame_sending (void)
	To Configure the frame sending. More...

static void	configure_range_test_frame_sending (void)
	To Configure the frame sending. More...

void	disconnect_peer_node (void)
	Function to request the peer to get disconnected from source node. More...

	FLASH_DECLARE (uint8_t perf_config_param_size[])

void	get_board_details (void)
	prints the hardware details More...

void	get_current_configuration (void)
	To Get the updated/latest values of all configurable parameters on source and peer node. More...

uint8_t	get_param_length (uint8_t parameter_type)

void	get_sensor_data (void)
	To get the Sensor data like Battery voltage. More...

void	identify_peer_node (void)
	Identifying peer node. More...

void	initiate_per_test (void)
	Initiates the test procedure. More...

void	initiate_range_test (void)
	Initiates the Range test procedure. More...

void	per_mode_initiator_ed_end_cb (uint8_t energy_level)
	User call back function after ED Scan completion. More...

void	per_mode_initiator_init (void *parameter)
	Initialize the application in PER Measurement mode as Initiator. More...

void	per_mode_initiator_rx_cb (frame_info_t *frame)
	Callback that is called if data has been received by trx in the PER_FOUND_PER_INITIATOR state. More...

void	per_mode_initiator_task (void)
	Application task for PER Measurement mode as initiator. More...

void	per_mode_initiator_tx_done_cb (retval_t status, frame_info_t *frame)
	Callback that is called once tx is done in the PER_FOUND_PER_INITIATOR state . More...

void	perf_get_req (uint8_t param_type_data)
	Function to get the various configuaration paramters for PER Test. More...

void	perf_set_req (uint8_t set_param_type, param_value_t *param_value)
	More...

static void	range_test_timer_handler_cb (void *parameter)
	This function is called periodically by the range test timer to initiate the transmission of range test packets to the receptor. More...

static bool	send_disconnect_command (void)
	Function used to send disconnect peer node command. More...

static bool	send_identify_command (void)
	Function used to send identify peer node command. More...

static void	send_parameters_changed (uint8_t param, uint8_t val)
	Function to send the parameters which has been updated to the receptor node. More...

static bool	send_peer_info_req (void)
	Function to configure and send the peer node info request. More...

static bool	send_per_test_start_cmd (void)

static bool	send_range_test_marker_rsp (void)
	Function to send the response packet for the marker sent from the receptor. More...

static bool	send_range_test_start_cmd (void)
	Function to send the range test start command to the receptor to start the mode in the receptor. More...

static bool	send_range_test_stop_cmd (void)
	Function to send the range test stop command to the receptor to stop the mode in the receptor. More...

void	send_remote_cmd (uint8_t *serial_buf, uint8_t len, bool ack_req)
	Function to send the command to Remote node to perform remote test. More...

bool	send_remote_reply_cmd (uint8_t *serial_buf, uint8_t len)
	This function is used to send a remote test repsonse command back to the initiator. More...

static bool	send_result_req (void)
	Function used to request PER test result. More...

static bool	send_set_default_config_command (void)
	Function used to send set default config peer command. More...

static void	set_channel (uint16_t channel)
	To set the Channel. More...

static void	set_channel_page (uint8_t channel_page)
	To set the Channel Page. More...

void	set_default_configuration (void)
	To set the default values of all configurable parameters on source and peer node. More...

static void	set_parameter_on_transmitter_node (retval_t status)
	Set the parameters like channel,tx power etc on transmitter node. More...

static void	set_phy_frame_length (uint16_t frame_len)
	To set PER Test frame length. More...

static void	set_transceiver_state (uint8_t trx_state)
	Set Transceiver state as per the state given. More...

static void	set_tx_power (uint8_t tx_power_format, int8_t power_value)
	To set the Tx power of the Transceiver. More...

void	start_ed_scan (uint8_t ed_scan_duration, uint32_t channel_sel_mask)
	To start the ED scan. More...

static void	start_range_test (void)

static void	start_test (void)

void	stop_range_test (void)
	Function to Stop the range Test in PER Mode. More...

static void	toggle_trx_sleep (void)
	To toggle between sleep /deep state. More...

static bool	validate_tx_power (int8_t dbm_value)
	validating the tx power input based on the current channel and page configuration More...

static void	wait_for_reply_timer_handler_cb (void *parameter)
	Wait for reply timer handler is called if any command sent on air times out before any response message is received. More...

Variables
static uint8_t	channel_before_scan

static uint32_t	end_time

static uint32_t	frame_access_failure

static uint32_t	frame_failure

static uint32_t	frame_no_ack

static uint32_t	frames_to_transmit

static uint32_t	fw_feature_mask = 0
	This is variable is to keep track of the specific features supported. More...

static uint16_t	no_of_roll_overs

static uint16_t	num_channels

uint8_t	op_mode = TX_OP_MODE

uint8_t	set_param_cb_t::param_type

uint8_t	set_param_cb_t::param_value

static uint8_t	phy_tx_power

bool	pkt_stream_stop = true

static uint32_t	range_test_frame_cnt = 0

static bool	range_test_in_progress = false

static uint32_t	restart_time

static uint32_t	scan_channel_mask

static uint8_t	scan_duration

static bool	scanning = false

static uint8_t	seq_num_initiator

static set_param_cb_t	set_param_cb

static uint32_t	start_time

static bool	trx_sleep_status = false

static float calculate_net_data_rate ( float per_test_duration_sec )

static

Function to calculate net data rate for the current PER test.

Parameters

per_test_duration_sec Time duration for PER test

Returns: net data rate as float value

References curr_trx_config_params, trx_config_params_t::number_test_frames, and trx_config_params_t::phy_frame_length.

Referenced by per_mode_initiator_rx_cb().

static float calculate_time_duration ( void )

static

Function to Calculate the time taken for PER Test.

Returns: Time duration as float value

References end_time, MICRO_SEC_MULTIPLIER, no_of_roll_overs, start_time, and SUB_TIME.

Referenced by per_mode_initiator_rx_cb().

uint8_t check_error_conditions ( void )

Function to check the error conditions before.

Function used to check the error conditions before.

processing the received command

Returns: the error code based on the currently ongoing operation,if any

References CONTINUOUS_TX_MODE, CW_TRANSMISSION_UNDER_PROGRESS, ED_SCAN_UNDER_PROGRESS, frames_to_transmit, MAC_SUCCESS, op_mode, PKT_STREAM_IN_PROGRESS, pkt_stream_stop, RANGE_TEST_IN_PROGRESS, range_test_in_progress, remote_serial_tx_failure, rx_on_mode, RX_ON_MODE_IN_PROGRESS, scanning, TRANSCEIVER_IN_SLEEP, TRANSMISSION_UNDER_PROGRESS, trx_sleep_status, and UNABLE_TO_CONTACT_PEER.

Referenced by handle_incoming_msg().

static void config_ack_request ( bool config_value )

static

To set or reset ACK request value.

Parameters

config_value value to be configured

References trx_config_params_t::ack_request, curr_trx_config_params, MAC_SUCCESS, PARAM_ACK_REQUEST, param_value_t::param_value_bool, and usr_perf_set_confirm().

Referenced by perf_set_req().

static void config_csma ( bool config_value )

static

To configure CSMA Setting in the transceiver.

Parameters

config_value value to be configured

References trx_config_params_t::csma_enabled, curr_trx_config_params, MAC_SUCCESS, PARAM_CSMA, param_value_t::param_value_bool, and usr_perf_set_confirm().

Referenced by perf_set_req().

static void config_frame_retry ( bool config_value )

static

To configure frame retry Setting.

Parameters

config_value value to be configured

References curr_trx_config_params, MAC_SUCCESS, PARAM_FRAME_RETRY, param_value_t::param_value_bool, trx_config_params_t::retry_enabled, and usr_perf_set_confirm().

Referenced by perf_set_req().

static void config_frequency ( float frequency )

static

Function to configure the ISM frequency based on the request.

Parameters

frequency Frequency value to be configured

References BASE_ISM_FREQUENCY_MHZ, CC_BAND_8, CC_BAND_9, trx_config_params_t::channel, curr_trx_config_params, FREQ_BAND_08, FREQ_BAND_09, INVALID_VALUE, trx_config_params_t::ism_frequency, MAC_SUCCESS, MAX_ISM_FREQUENCY_MHZ, MID_ISM_FREQUENCY_MHZ, MIN_ISM_FREQUENCY_MHZ, PARAM_ISM_FREQUENCY, param_value_t::param_value_float, peer_found, send_parameters_changed(), SR_CC_BAND, SR_CC_NUMBER, tal_calculate_frequency(), usr_perf_set_confirm(), and VALUE_OUT_OF_RANGE.

Referenced by perf_set_req().

static void config_rpc_mode ( bool config_value )

static

toggle RPC mode request

Parameters

config_value Value to be configured for RPC

References ANT_CTRL_0, ANT_CTRL_1, ANT_DIVERSITY_DISABLE, ANT_DIVERSITY_ENABLE, ANTENNA_DEFAULT, CMD_RX_AACK_ON, CMD_RX_ON, CMD_TRX_OFF, curr_trx_config_params, DISABLE_ALL_RPC_MODES, DISABLE_RX_SAFE_MODE, ENABLE_ALL_RPC_MODES, ENABLE_RX_SAFE_MODE, MAC_SUCCESS, PARAM_RPC, param_value_t::param_value_bool, RG_TRX_CTRL_2, trx_config_params_t::rpc_enable, RX_AACK_ON, RX_ON, set_trx_state(), tal_get_trx_status(), tal_rpc_mode_config(), tal_trx_reg_write(), and usr_perf_set_confirm().

Referenced by perf_set_req().

static void configure_frame_sending ( void )

static

To Configure the frame sending.

References trx_config_params_t::ack_request, CCPU_ENDIAN_TO_LE16, app_payload_t::cmd_id, convert_16_bit_to_byte_array(), curr_trx_config_params, DST_PAN_ID, FCF_ACK_REQUEST, FCF_FRAMETYPE_DATA, FCF_LEN, FCF_PAN_ID_COMPRESSION, FCF_SET_DEST_ADDR_MODE, FCF_SET_SOURCE_ADDR_MODE, FCF_SHORT_ADDR, FCS_LEN, FRAME_OVERHEAD, frame_info_tag::mpdu, node_info, PAN_ID_LEN, node_ib_t::peer_short_addr, PER_TEST_PKT, trx_config_params_t::phy_frame_length, SHORT_ADDR_LEN, SRC_PAN_ID, tal_pib, and node_ib_t::tx_frame_info.

Referenced by set_phy_frame_length(), and start_test().

static void configure_range_test_frame_sending ( void )

static

void disconnect_peer_node ( void )

Function to request the peer to get disconnected from source node.

References app_reset(), DISCONNECT_PEER, MAC_SUCCESS, node_info, op_mode, node_ib_t::peer_found, send_disconnect_command(), TRANSMISSION_FAILURE, TX_OP_MODE, and usr_peer_disconnect_confirm().

Referenced by handle_incoming_msg().

static FLASH_DECLARE ( uint8_t perf_config_param_size[] )

void get_board_details ( void )

prints the hardware details

References BOARD_NAME, CONTINUOUS_RX_ON_MODE, FIRMWARE_VERSION, fw_feature_mask, fw_version, IC_TYPE, MAC_SUCCESS, MCU_SOC_NAME, MULTI_CHANNEL_SELECT, PER_RANGE_TEST_MODE, PER_REMOTE_CONFIG_MODE, PKT_STREAMING_MODE, reverse_float(), tal_pib, TRANSCEIVER_NAME, and usr_identify_board_confirm().

Referenced by handle_incoming_msg().

void get_current_configuration ( void )

To Get the updated/latest values of all configurable parameters on source and peer node.

Function to get the current values of the all configurable parameters.

References curr_trx_config_params, MAC_SUCCESS, and usr_get_current_config_confirm().

Referenced by handle_incoming_msg().

uint8_t get_param_length ( uint8_t parameter_type )

References PGM_READ_BYTE.

Referenced by handle_incoming_msg(), usr_perf_get_confirm(), and usr_perf_set_confirm().

void get_sensor_data ( void )

To get the Sensor data like Battery voltage.

Function to get the Sensor data like Battery volatge.

References MAC_SUCCESS, MILLI_VOLT_MULTIPLIER, reverse_float(), tfa_get_batmon_voltage(), tfa_get_temperature(), and usr_sensor_data_get_confirm().

Referenced by handle_incoming_msg().

void identify_peer_node ( void )

Identifying peer node.

References IDENTIFY_PEER, op_mode, send_identify_command(), TRANSMISSION_FAILURE, TX_OP_MODE, and usr_identify_peer_node_confirm().

Referenced by handle_incoming_msg().

void initiate_per_test ( void )

Initiates the test procedure.

References op_mode, PER_TEST_START, send_per_test_start_cmd(), and TX_OP_MODE.

Referenced by handle_incoming_msg().

void initiate_range_test ( void )

Initiates the Range test procedure.

References INVALID_CMD, op_mode, RANGE_TEST_START, send_range_test_start_cmd(), TX_OP_MODE, and usr_range_test_start_confirm().

Referenced by handle_incoming_msg().

void per_mode_initiator_ed_end_cb ( uint8_t energy_level )

User call back function after ED Scan completion.

Parameters

energy level as input

Send the ED_END_INDICATION with the no. of channels and the list with channel no and pin values

References channel_before_scan, ed_scan_result_t::channel_no, INVALID_VALUE, MAX_CHANNEL, MIN_CHANNEL, num_channels, ed_scan_result_t::p_in, phy_tx_power, phyCurrentChannel, phyCurrentPage, phyTransmitPower, RSSI_BASE_VAL_DBM, scan_channel_mask, scan_duration, scanning, tal_pib_get(), tal_pib_set(), and usr_ed_scan_end_indication().

void per_mode_initiator_init ( void * parameter )

Initialize the application in PER Measurement mode as Initiator.

Parameters

parameter Pointer to the parameter to be carried, if any.

References app_led_event(), APP_TIMER_TO_TX, CMD_TRX_OFF, config_per_test_parameters(), default_trx_config_params, FUNC_PTR, LED_EVENT_POWER_ON, MAC_SUCCESS, node_ib_t::main_state, node_info, NUL_VAL, NULL, op_mode, PA_EXT_ENABLE, peer_found, node_ib_t::peer_found, PEER_INFO_RSP_WAIT, PER_TEST_INITIATOR, phyTransmitPower, send_peer_info_req(), seq_num_initiator, set_trx_state(), START_MODE_SINGLE_NODE, SW_TIMEOUT_RELATIVE, sw_timer_start(), tal_pib_set(), TAL_TRANSMIT_POWER_DEFAULT, TIMEOUT_FOR_RESPONSE_IN_MICRO_SEC, usr_perf_start_confirm(), and wait_for_reply_timer_handler_cb().

void per_mode_initiator_rx_cb ( frame_info_t * frame )

Callback that is called if data has been received by trx in the PER_FOUND_PER_INITIATOR state.

Parameters

frame Pointer to received frame

References ANT_CTRL_0, ANT_CTRL_1, ANT_CTRL_2, app_led_event(), APP_TIMER_TO_TX, aver_lqi, aver_rssi, peer_info_rsp_t::board_name, calculate_net_data_rate(), calculate_time_duration(), CCPU_ENDIAN_TO_LE32, app_payload_t::cmd_id, CMD_ID_LEN, convert_ota_serial_frame_tx(), general_pkt_t::crc_stat_rsp_data, curr_trx_config_params, CW_TX_TIMER, default_trx_config_params, general_pkt_t::div_stat_rsp_data, range_tx_t::ed, ED_VAL_LEN, FCS_LEN, peer_info_rsp_t::feature_mask, frame_access_failure, frame_failure, frame_no_ack, FRAME_OVERHEAD, result_rsp_t::frames_with_wrong_crc, FUNC_PTR, peer_info_rsp_t::fw_version, peer_info_rsp_t::ic_type, INVALID_VALUE, LED_BLINK_RATE_IN_MICRO_SEC, LED_EVENT_RX_FRAME, LENGTH_FIELD_LEN, range_tx_t::lqi, result_rsp_t::lqi_avrg_rx, LQI_LEN, peer_info_rsp_t::mac_address, MAC_SUCCESS, marker_rsp_timer_handler_cb(), frame_info_tag::mpdu, NULL, result_rsp_t::num_of_frames_rx, number_rx_frames, op_mode, PARAM_ANT_DIVERSITY_ON_PEER, PARAM_CRC_ON_PEER, param_value_t::param_value_bool, app_payload_t::payload, PEER_INFO_RSP, general_pkt_t::peer_info_rsp_data, PEER_INFO_RSP_WAIT, RANGE_TEST_MARKER_CMD, RANGE_TEST_RSP, RANGE_TEST_TX, general_pkt_t::range_tx_data, remote_test_req_t::remote_serial_data, REMOTE_TEST_REPLY_CMD, general_pkt_t::remote_test_req_data, RESULT_RSP, reverse_float(), result_rsp_t::rssi_avrg_rx, rx_on_mode, send_range_test_marker_rsp(), app_payload_t::seq_num, SEQ_NUM_LEN, peer_info_rsp_t::soc_mcu_name, START_MODE_PER, div_stat_rsp_t::status, crc_stat_rsp_t::status, SW_TIMEOUT_RELATIVE, sw_timer_is_running(), sw_timer_start(), sw_timer_stop(), T_APP_TIMER, tal_get_rssi_base_val(), general_pkt_t::test_result_rsp_data, peer_info_rsp_t::trx_name, TX_OP_MODE, usr_per_test_end_indication(), usr_perf_get_confirm(), usr_perf_start_confirm(), usr_range_test_beacon_rsp(), usr_range_test_marker_ind(), and WAIT_FOR_TEST_RES.

void per_mode_initiator_task ( void )

Application task for PER Measurement mode as initiator.

This function

Implements the PER Measurement mode state machine.
On start up as initiator application will print menu on screen
On user inputs through menu app executes various tests

References APP_TIMER_TO_TX, CONTINUOUS_TX_MODE, trx_config_params_t::csma_enabled, CSMA_UNSLOTTED, curr_trx_config_params, DISCONNECT_PEER, frames_to_transmit, FUNC_PTR, IDENTIFY_PEER, node_ib_t::main_state, frame_info_tag::mpdu, NO_CSMA_NO_IFS, node_info, NULL, op_mode, PER_TEST_INITIATOR, pkt_stream_gap_time, pkt_stream_gap_timer(), PKT_STREAM_MODE, PL_POS_SEQ_NUM, rdy_to_tx, trx_config_params_t::retry_enabled, send_result_req(), SET_PARAMETER, stream_pkt, SW_TIMEOUT_RELATIVE, sw_timer_start(), T_APP_TIMER, tal_tx_frame(), TEST_FRAMES_SENT, TIMEOUT_FOR_RESPONSE_IN_MICRO_SEC, node_ib_t::transmitting, node_ib_t::tx_frame_info, TX_OP_MODE, wait_for_reply_timer_handler_cb(), and WAIT_FOR_TEST_RES.

void per_mode_initiator_tx_done_cb	(	retval_t	status,
		frame_info_t *	frame
	)

Callback that is called once tx is done in the PER_FOUND_PER_INITIATOR state .

Parameters

status	Status of the transmission procedure
frame	Pointer to the transmitted frame structure

References div_set_req_t::ant_sel, app_led_event(), app_reset(), APP_TIMER_TO_TX, APP_TIMER_TO_TX_LED_OFF, app_payload_t::cmd_id, CMD_ID_LEN, config_per_test_parameters(), CONTINUOUS_TX_MODE, convert_ota_serial_frame_rx(), general_pkt_t::crc_set_req_data, curr_trx_config_params, CW_TX_TIMER, default_trx_config_params, DISCONNECT_PEER, end_time, FCS_LEN, frame_access_failure, frame_failure, frame_no_ack, FRAME_OVERHEAD, frames_to_transmit, IDENTIFY_PEER, LED_EVENT_PEER_SEARCH_DONE, LED_EVENT_TX_FRAME, LED_TOGGLE_COUNT_FOR_PER, LENGTH_FIELD_LEN, MAC_CHANNEL_ACCESS_FAILURE, MAC_NO_ACK, MAC_SUCCESS, MICRO_SEC_MULTIPLIER, frame_info_tag::mpdu, no_of_roll_overs, node_info, NUL_VAL, op_mode, PARAM_ANT_DIVERSITY_ON_PEER, PARAM_CRC_ON_PEER, param_value_t::param_value_bool, app_payload_t::payload, PER_TEST_START, PKT_STREAM_MODE, pkt_stream_stop, range_test_frame_cnt, range_test_in_progress, RANGE_TEST_PKT, RANGE_TEST_START, RANGE_TEST_STOP, RANGE_TEST_TX, remote_test_req_t::remote_serial_data, remote_serial_tx_failure, REMOTE_TEST_MODE, general_pkt_t::remote_test_req_data, restart_time, SEQ_NUM_LEN, SET_DEFAULT_CONFIG_PEER, SET_PARAMETER, set_parameter_on_transmitter_node(), start_range_test(), start_test(), div_set_req_t::status, crc_set_req_t::status, sw_timer_get_time(), sw_timer_stop(), T_APP_TIMER_RANGE, TEST_FRAMES_SENT, node_ib_t::transmitting, node_ib_t::tx_frame_info, TX_OP_MODE, UNABLE_TO_CONTACT_PEER, usr_identify_peer_node_confirm(), usr_peer_disconnect_confirm(), usr_per_test_end_indication(), usr_perf_set_confirm(), usr_range_test_beacon_tx(), usr_range_test_start_confirm(), usr_range_test_stop_confirm(), usr_set_default_config_confirm(), and WAIT_FOR_TEST_RES.

void perf_get_req ( uint8_t param_type_data )

Function to get the various configuaration paramters for PER Test.

Parameters

param_type Parameter type to be read

References trx_config_params_t::ack_request, CONV_phyTransmitPower_TO_DBM, trx_config_params_t::csma_enabled, curr_trx_config_params, INVALID_ARGUMENT, trx_config_params_t::ism_frequency, MAC_SUCCESS, trx_config_params_t::number_test_frames, PARAM_ACK_REQUEST, PARAM_ANT_DIVERSITY, PARAM_ANT_DIVERSITY_ON_PEER, PARAM_CHANNEL, PARAM_CHANNEL_PAGE, PARAM_CRC_ON_PEER, PARAM_CSMA, PARAM_DESENSITIZATION, PARAM_FRAME_RETRY, PARAM_ISM_FREQUENCY, PARAM_NO_OF_TEST_FRAMES, PARAM_PHY_FRAME_LENGTH, PARAM_RPC, PARAM_TRX_STATE, PARAM_TX_POWER_DBM, param_value_t::param_value_16bit, param_value_t::param_value_32bit, param_value_t::param_value_8bit, param_value_t::param_value_bool, param_value_t::param_value_float, trx_config_params_t::phy_frame_length, phyCurrentChannel, phyCurrentPage, phyTransmitPower, trx_config_params_t::retry_enabled, trx_config_params_t::rpc_enable, tal_get_curr_trx_config(), tal_get_trx_status(), tal_pib_get(), TX_PWR, and usr_perf_get_confirm().

Referenced by handle_incoming_msg().

void perf_set_req	(	uint8_t	set_param_type,
		param_value_t *	param_value
	)

Function to set the various configuaration paramters for PER Test

Parameters

param_type	Parameter type to be set
param_value	Pointer to the parameter value to be set

References config_ack_request(), config_csma(), config_frame_retry(), config_frequency(), config_rpc_mode(), curr_trx_config_params, INVALID_ARGUMENT, last_tx_power_format_set, MAC_SUCCESS, NUL_VAL, trx_config_params_t::number_test_frames, PARAM_ACK_REQUEST, PARAM_ANT_DIVERSITY, PARAM_ANT_DIVERSITY_ON_PEER, PARAM_CHANNEL, PARAM_CHANNEL_PAGE, PARAM_CRC_ON_PEER, PARAM_CSMA, PARAM_DESENSITIZATION, PARAM_FRAME_RETRY, PARAM_ISM_FREQUENCY, PARAM_NO_OF_TEST_FRAMES, PARAM_PHY_FRAME_LENGTH, PARAM_RPC, PARAM_TRX_STATE, PARAM_TX_POWER_DBM, param_value_t::param_value_16bit, param_value_t::param_value_32bit, param_value_t::param_value_8bit, param_value_t::param_value_bool, param_value_t::param_value_float, set_channel(), set_channel_page(), set_phy_frame_length(), set_transceiver_state(), set_tx_power(), usr_perf_set_confirm(), and VALUE_OUT_OF_RANGE.

Referenced by handle_incoming_msg().

static void range_test_timer_handler_cb ( void * parameter )

static

This function is called periodically by the range test timer to initiate the transmission of range test packets to the receptor.

Parameters

parameter pass parameters to timer handler

References configure_range_test_frame_sending(), trx_config_params_t::csma_enabled, CSMA_UNSLOTTED, curr_trx_config_params, FUNC_PTR, NO_CSMA_NO_IFS, node_info, NULL, RANGE_TX_BEACON_INTERVAL, trx_config_params_t::retry_enabled, SW_TIMEOUT_RELATIVE, sw_timer_start(), T_APP_TIMER_RANGE, tal_tx_frame(), node_ib_t::transmitting, and node_ib_t::tx_frame_info.

Referenced by start_range_test().

static bool send_disconnect_command ( void )

static

Function used to send disconnect peer node command.

Returns: Transmission status - success/failure

References app_payload_t::cmd_id, DISCONNECT_NODE, FCF_SHORT_ADDR, MAC_SUCCESS, node_info, node_ib_t::peer_short_addr, app_payload_t::seq_num, seq_num_initiator, and transmit_frame().

Referenced by disconnect_peer_node().

static bool send_identify_command ( void )

static

Function used to send identify peer node command.

Returns: Transmission status - success/failure

References app_payload_t::cmd_id, FCF_SHORT_ADDR, IDENTIFY_NODE, MAC_SUCCESS, node_info, node_ib_t::peer_short_addr, app_payload_t::seq_num, seq_num_initiator, and transmit_frame().

Referenced by identify_peer_node().

static void send_parameters_changed	(	uint8_t	param,
		uint8_t	val
	)

static

Function to send the parameters which has been updated to the receptor node.

Parameters

param	Parameters being modified i.e. Channel,channel page,etc
val	Value of the parameter being modified

References app_payload_t::cmd_id, data, FCF_SHORT_ADDR, MAC_SUCCESS, node_info, op_mode, set_param_cb_t::param_type, set_parm_req_t::param_type, set_param_cb_t::param_value, set_parm_req_t::param_value, app_payload_t::payload, node_ib_t::peer_short_addr, app_payload_t::seq_num, seq_num_initiator, SET_PARAM, SET_PARAMETER, and transmit_frame().

Referenced by config_frequency(), set_channel(), and set_channel_page().

static bool send_peer_info_req ( void )

static

Function to configure and send the peer node info request.

Returns: Transmission status - success/failure

References app_payload_t::cmd_id, FCF_SHORT_ADDR, MAC_SUCCESS, node_info, PEER_INFO_REQ, node_ib_t::peer_short_addr, app_payload_t::seq_num, seq_num_initiator, and transmit_frame().

Referenced by per_mode_initiator_init().

static bool send_per_test_start_cmd ( void )

static

References result_req_t::cmd, app_payload_t::cmd_id, data, DUMMY_PAYLOAD, FCF_SHORT_ADDR, MAC_SUCCESS, node_info, app_payload_t::payload, node_ib_t::peer_short_addr, PER_TEST_START_PKT, app_payload_t::seq_num, seq_num_initiator, and transmit_frame().

Referenced by initiate_per_test().

static bool send_range_test_marker_rsp ( void )

static

Function to send the response packet for the marker sent from the receptor.

References APP_TIMER_TO_TX, result_req_t::cmd, app_payload_t::cmd_id, data, DUMMY_PAYLOAD, FCF_SHORT_ADDR, FUNC_PTR, LED_BLINK_RATE_IN_MICRO_SEC, MAC_SUCCESS, marker_seq_num, marker_tx_timer_handler_cb(), node_info, NULL, app_payload_t::payload, node_ib_t::peer_short_addr, RANGE_TEST_MARKER_RSP, app_payload_t::seq_num, seq_num_initiator, SW_TIMEOUT_RELATIVE, sw_timer_start(), and transmit_frame().

Referenced by per_mode_initiator_rx_cb().

static bool send_range_test_start_cmd ( void )

static

Function to send the range test start command to the receptor to start the mode in the receptor.

References result_req_t::cmd, app_payload_t::cmd_id, data, DUMMY_PAYLOAD, FCF_SHORT_ADDR, MAC_SUCCESS, node_info, app_payload_t::payload, node_ib_t::peer_short_addr, RANGE_TEST_START_PKT, app_payload_t::seq_num, seq_num_initiator, and transmit_frame().

Referenced by initiate_range_test().

static bool send_range_test_stop_cmd ( void )

static

Function to send the range test stop command to the receptor to stop the mode in the receptor.

References result_req_t::cmd, app_payload_t::cmd_id, data, DUMMY_PAYLOAD, FCF_SHORT_ADDR, MAC_SUCCESS, node_info, app_payload_t::payload, node_ib_t::peer_short_addr, RANGE_TEST_STOP_PKT, app_payload_t::seq_num, seq_num_initiator, and transmit_frame().

Referenced by stop_range_test().

void send_remote_cmd	(	uint8_t *	serial_buf,
		uint8_t	len,
		bool	ack_req
	)

Function to send the command to Remote node to perform remote test.

Parameters

serial_buf	Pointer to the serial buffer
len	Length of the message
ack_req	specifies ack requested for frame if set to 1

References app_payload_t::cmd_id, CW_TX_TIMER, FCF_SHORT_ADDR, FUNC_PTR, MAC_SUCCESS, node_info, op_mode, app_payload_t::payload, node_ib_t::peer_short_addr, REMOTE_MSG_BUF_SIZE, remote_test_req_t::remote_serial_data, REMOTE_TEST_CMD, REMOTE_TEST_MODE, general_pkt_t::remote_test_req_data, app_payload_t::seq_num, seq_num_initiator, SW_TIMEOUT_RELATIVE, sw_timer_start(), TIMEOUT_FOR_RESPONSE_IN_MICRO_SEC, transmit_frame(), TX_OP_MODE, and wait_for_reply_timer_handler_cb().

Referenced by handle_incoming_msg().

bool send_remote_reply_cmd	(	uint8_t *	serial_buf,
		uint8_t	len
	)

This function is used to send a remote test repsonse command back to the initiator.

References app_payload_t::cmd_id, FCF_SHORT_ADDR, MAC_SUCCESS, node_info, app_payload_t::payload, node_ib_t::peer_short_addr, REMOTE_MSG_BUF_SIZE, remote_test_req_t::remote_serial_data, REMOTE_TEST_REPLY_CMD, general_pkt_t::remote_test_req_data, app_payload_t::seq_num, seq_num_receptor, and transmit_frame().

Referenced by serial_data_handler().

static bool send_result_req ( void )

static

Function used to request PER test result.

Returns: true if request was sent successfully, false if not.

References result_req_t::cmd, app_payload_t::cmd_id, data, DUMMY_PAYLOAD, FCF_SHORT_ADDR, MAC_SUCCESS, node_info, app_payload_t::payload, node_ib_t::peer_short_addr, RESULT_REQ, app_payload_t::seq_num, seq_num_initiator, and transmit_frame().

Referenced by per_mode_initiator_task().

static bool send_set_default_config_command ( void )

static

Function used to send set default config peer command.

Returns: Transmission status - success/failure

References app_payload_t::cmd_id, FCF_SHORT_ADDR, MAC_SUCCESS, node_info, node_ib_t::peer_short_addr, app_payload_t::seq_num, seq_num_initiator, SET_DEFAULT_REQ, and transmit_frame().

Referenced by set_default_configuration().

static void set_channel ( uint16_t channel )

static

To set the Channel.

Parameters

channel channel number to be set

References BIT_COUNT, CC_BAND_0, CC_NUMBER_0, CHANNEL, trx_config_params_t::channel, CONV_phyTransmitPower_TO_DBM, curr_trx_config_params, MAC_SUCCESS, PARAM_CHANNEL, param_value_t::param_value_16bit, peer_found, phyChannelsSupported, phyCurrentChannel, phyTransmitPower, send_parameters_changed(), tal_pib_get(), tal_pib_set(), tal_set_frequency_regs(), trx_config_params_t::tx_power_dbm, usr_perf_set_confirm(), and VALUE_OUT_OF_RANGE.

Referenced by perf_set_req().

static void set_channel_page ( uint8_t channel_page )

static

To set the Channel Page.

Parameters

channel_page Channel page to be set

References trx_config_params_t::channel, CHANNEL_PAGE, trx_config_params_t::channel_page, CONV_phyTransmitPower_TO_DBM, curr_trx_config_params, MAC_SUCCESS, PARAM_CHANNEL_PAGE, param_value_t::param_value_8bit, peer_found, phyCurrentChannel, phyCurrentPage, phyTransmitPower, send_parameters_changed(), tal_pib_get(), tal_pib_set(), trx_config_params_t::tx_power_dbm, usr_perf_set_confirm(), and VALUE_OUT_OF_RANGE.

Referenced by perf_set_req().

void set_default_configuration ( void )

To set the default values of all configurable parameters on source and peer node.

Function to set the default values of.

References config_per_test_parameters(), default_trx_config_params, MAC_SUCCESS, op_mode, peer_found, send_set_default_config_command(), SET_DEFAULT_CONFIG_PEER, TRANSMISSION_FAILURE, TX_OP_MODE, and usr_set_default_config_confirm().

Referenced by handle_incoming_msg().

static void set_parameter_on_transmitter_node ( retval_t status )

static

Set the parameters like channel,tx power etc on transmitter node.

Parameters

status Transmission Status of the node.

References CC_BAND_0, CC_BAND_8, CC_BAND_9, CC_NUMBER_0, CHANNEL, trx_config_params_t::channel, CHANNEL_PAGE, trx_config_params_t::channel_page, CONV_phyTransmitPower_TO_DBM, curr_trx_config_params, FREQ_BAND_08, FREQ_BAND_09, INVALID_VALUE, trx_config_params_t::ism_frequency, MAC_SUCCESS, PARAM_CHANNEL, PARAM_CHANNEL_PAGE, PARAM_ISM_FREQUENCY, set_param_cb_t::param_type, set_param_cb_t::param_value, param_value_t::param_value_16bit, param_value_t::param_value_8bit, param_value_t::param_value_float, phyCurrentChannel, phyCurrentPage, phyTransmitPower, tal_calculate_frequency(), tal_pib_get(), tal_pib_set(), tal_set_frequency_regs(), trx_config_params_t::tx_power_dbm, UNABLE_TO_CONTACT_PEER, and usr_perf_set_confirm().

Referenced by per_mode_initiator_tx_done_cb().

static void set_phy_frame_length ( uint16_t frame_len )

static

To set PER Test frame length.

Parameters

frame_len Length of the frame to be set

References aMaxPHYPacketSize, configure_frame_sending(), curr_trx_config_params, FRAME_OVERHEAD, MAC_SUCCESS, PARAM_PHY_FRAME_LENGTH, param_value_t::param_value_16bit, trx_config_params_t::phy_frame_length, and usr_perf_set_confirm().

Referenced by perf_set_req().

static void set_transceiver_state ( uint8_t trx_state )

static

Set Transceiver state as per the state given.

Parameters

trx_state Transceiver state to be set

References ANT_AUTO_SEL, ANT_DIVERSITY_DISABLE, ANT_DIVERSITY_ENABLE, ANTENNA_DEFAULT, CMD_PLL_ON, CMD_RX_AACK_ON, CMD_TRX_OFF, curr_trx_config_params, MAC_SUCCESS, PARAM_TRX_STATE, param_value_t::param_value_8bit, PLL_ON, recover_all_settings(), RX_AACK_ON, save_all_settings(), set_trx_state(), SLEEP_MODE_1, tal_get_trx_status(), tal_reset(), toggle_trx_sleep(), TRANSCEIVER_IN_SLEEP, TRX_DEEP_SLEEP, TRX_OFF, TRX_RESET, TRX_SLEEP, trx_sleep_status, trx_config_params_t::trx_state, and usr_perf_set_confirm().

Referenced by perf_set_req().

static void set_tx_power	(	uint8_t	tx_power_format,
		int8_t	power_value
	)

static

To set the Tx power of the Transceiver.

Parameters

tx_power_format	Format in which input is given whether in dBm or reg
power_value	Tx power value in the given format

References trx_config_params_t::channel, CONV_DBM_TO_phyTransmitPower, curr_trx_config_params, MAC_SUCCESS, MIN_TX_PWR_REG_VAL, PARAM_TX_POWER_DBM, param_value_t::param_value_8bit, phyTransmitPower, REGISTER_VALUE, tal_get_curr_trx_config(), tal_pib_set(), trx_config_params_t::tx_power_dbm, TX_POWER_FORMAT_DBM, TX_POWER_FORMAT_REG, TX_PWR, usr_perf_set_confirm(), validate_tx_power(), and VALUE_OUT_OF_RANGE.

Referenced by perf_set_req().

void start_ed_scan	(	uint8_t	ed_scan_duration,
		uint32_t	channel_sel_mask
	)

To start the ED scan.

Function to start the ED scan.

Parameters

ed_scan_duration	Scan duration parameter which is used to calculate the scan time on each channel
channel_sel_mask	Selected channel mask for which the Energy should be detected

References aBaseSuperframeDuration, channel_before_scan, MAC_SUCCESS, MAX_CHANNEL, MAX_SCAN_DURATION, MIN_CHANNEL, NUL_VAL, num_channels, phy_tx_power, phyCurrentChannel, phyTransmitPower, reverse_float(), scan_channel_mask, scan_duration, scanning, TAL_CONVERT_SYMBOLS_TO_US, tal_pib, tal_pib_get(), tal_pib_set(), usr_ed_scan_start_confirm(), and VALUE_OUT_OF_RANGE.