lim_unit_test.c File Reference

Unit test for the LIM package. More...

#include <string.h>
#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>
#include <stddef.h>
#include <CDM/CDM_pubdefs.h>
#include <ITC/ITC_msgs.h>
#include <ITC/ITC_pubdefs.h>
#include <LCS/LCS_pubdefs.h>
#include <LIM/LIM_msgs.h>
#include <LIM/LIM_pubdefs.h>
#include <LPA/LPA_msgs.h>
#include <MSG/MSG_pubdefs.h>
#include <MSG/MSG_printProc.h>
#include <PBS/PBS.h>
#include <PBS/SEM.h>
#include <PBS/TASK.h>
#include <TRD/TRD_msgs.h>
#include <lim_unit_test.h>

Functions
static void	show_banner (const char *desc_1, const char *desc_2)
	Display a message as a banner.
static void	show_at_level (const int level, const char *item_1, const char *item_2)
	Display text with indentation.
void	test_Push_State (test_Test_Descriptor *td_p, const char *desc, const int index)
	Enter a new test state.
void	test_Pop_State (test_Test_Descriptor *td_p)
	Return for a test state.
static void	show_desc_stack (const test_Test_Descriptor *td_p)
	Display the current state description stack.
const char *	test_Action_Name (const LIM_Action_Id action)
	Return a text description of a LIM action.
const char *	test_Grb_State_Name (const LIM_Grb_State grb_state)
	Return a text description of a GRB state.
const char *	test_Op_Mode_Name (const LIM_Operating_Mode op_mode)
	Return a text description of an operating mode.
const char *	test_Other_State_Name (const LIM_Other_State other_state)
	Return a text description of an 'other' task state.
const char *	test_Status_Name (const unsigned int status)
	Return a text description of a status code.
static void	show_status_name (const unsigned int status)
	Display the name for a status code.
static unsigned int	lim_start_message_system (void)
	Start the messaging system.
static unsigned int	lim_stop_message_system (void)
	Stop the messaging system.
void	test_Show (const test_Test_Descriptor *td_p, const int level, const char *item_1, const char *item_2)
	Display text with indentation.
void	test_Show_Msg_OK (const test_Test_Descriptor *td_p)
	Indicate that the next error message is expected.
void	test_Sleep_Sec (int num_secs)
	Sleep for the specified number of seconds.
static WUT_cb_status	test_wut_handler (void *prm, WUT_tmr *wut)
	Handle wake-up timer expiration.
int	test_Delay (const test_Test_Descriptor *td_p, const unsigned int num_usecs)
	Delay the current task a number of microseconds.
int	test_Generic_Error (const test_Test_Descriptor *td_p, const char *fmt, const char *str_param, const unsigned int int_param)
	Display a generic error message.
int	test_Count_Compare (const test_Test_Descriptor *td_p, const test_Cmd_Counts *exp_p, const test_Cmd_Counts *act_p, const char *desc)
	Verify command count values.
int	test_Parm_Compare (const test_Test_Descriptor *td_p, const test_Start_Parms *exp_p, const test_Start_Parms *act_p, const char *desc)
	Verify simulated task start parameter values.
void	test_Show_Info (const test_Test_Descriptor *td_p, const LIM_Info *exp_p, const LIM_Info *act_p)
	Display LIM info.
int	test_Info_Compare (const test_Test_Descriptor *td_p, const LIM_Info *exp_p, const LIM_Info *act_p, const char *desc)
	Verify the contents of LIM information.
void	test_Show_Slew (const test_Test_Descriptor *td_p, const test_Slew_Info *exp_p, const test_Slew_Info *act_p, const char *desc)
	Display Slew-Request command parameters.
int	test_Slew_Compare (const test_Test_Descriptor *td_p, const test_Slew_Info *exp_p, const test_Slew_Info *act_p, const char *desc)
	Verify Slew-Request command parameters.
int	test_Memory_Compare (const test_Test_Descriptor *td_p, const void *expect_p, const void *actual_p, const void *mask_p, const size_t num_bytes)
	Verify the contents of a buffer in memory.
int	test_NULL_Compare (const test_Test_Descriptor *td_p, const unsigned int actual, const char *desc)
	Check a 32-bit value to make sure it is not NULL.
int	test_Status_Compare (const test_Test_Descriptor *td_p, const unsigned int expect, const unsigned int actual, const char *func)
	Check a MSG status code value.
int	test_Status_Success (const test_Test_Descriptor *td_p, const unsigned int actual, const char *func)
	Check a MSG status code to make sure it's reporting success.
int	test_Value32_Compare (const test_Test_Descriptor *td_p, const unsigned int expect, const unsigned int actual, const char *desc)
	Check a 32-bit value.
void	test_Show_Item (const test_Test_Descriptor *td_p, const char *name, const char *fmt, const char *str_param, const unsigned int int_param)
	Display an item of data.
int	lim_unit_test (void)
	The unit test entry point.
int	main (void)
	The application entry point for the host version of the test.
Variables
test_Test_Descriptor	LIM_td
	Descriptor for the LIM unit test.

---

Detailed Description

Unit test for the LIM package.

**  CVS $Id: lim_unit_test.c,v 1.41 2011/03/29 21:20:27 apw Exp $
**  

---

Function Documentation

unsigned int lim_start_message_system

(

void

)

[static]

Start the messaging system.

Returns:

MSG code.

Referenced by lim_unit_test().

unsigned int lim_stop_message_system

(

void

)

[static]

Stop the messaging system.

Returns:

MSG code.

Referenced by lim_unit_test().

int lim_unit_test

(

void

)

The unit test entry point.

Configures the test environment, runs the various subtests, collects the status values, and displays the results.

Return values:

	0	Success.
	-1	Failure.

References DIM, _test_Test_Descriptor::exec, _test_Test_Descriptor::fail, lim_start_message_system(), lim_stop_message_system(), lim_test_arr(), lim_test_cal(), lim_test_command(), lim_test_control(), lim_test_diag(), lim_test_gbm(), lim_test_init(), lim_test_load_shed(), lim_test_mode(), lim_test_physics(), lim_test_pids(), lim_test_pig(), lim_test_pool(), lim_test_saa(), lim_test_shutdown(), lim_test_too(), lim_test_use_cases(), show_banner(), test_Delay(), test_Pop_State(), test_Push_State(), and _test_Test_Descriptor::wut.

Referenced by main().

int main

(

void

)

The application entry point for the host version of the test.

Return values:

	0	Success.
	-1	Failure.

References lim_unit_test().

void show_at_level	(	const int	level,
		const char *	item_1,
		const char *	item_2
	)			[static]

Display text with indentation.

Display text with indentation appropriate for the specified test state level.

Parameters:

	level	Test state level.
	item_1	First text string to display.
	item_2	Second text string to display.

Returns:

Nothing.

Referenced by show_desc_stack(), test_Count_Compare(), test_Generic_Error(), test_Info_Compare(), test_Memory_Compare(), test_NULL_Compare(), test_Parm_Compare(), test_Push_State(), test_Show(), test_Show_Info(), test_Show_Item(), test_Show_Slew(), test_Slew_Compare(), test_Status_Compare(), test_Status_Success(), and test_Value32_Compare().

void show_banner	(	const char *	desc_1,
		const char *	desc_2
	)			[static]

Display a message as a banner.

Parameters:

	desc_1	First text string to display.
	desc_2	Second text string to display.

Returns:

Nothing.

Referenced by lim_unit_test(), test_Pop_State(), and test_Push_State().

void show_desc_stack

(

const test_Test_Descriptor *

td_p

)

[static]

Display the current state description stack.

Display all the state descriptions on the test's state stack.

Parameters:

td_p

Pointer to test descriptor.

Returns:

Nothing.

References _test_Test_Descriptor::depth, _test_Test_Descriptor::desc, _test_Test_Descriptor::index, show_at_level(), and test_Sleep_Sec().

Referenced by test_Count_Compare(), test_Generic_Error(), test_Info_Compare(), test_Memory_Compare(), test_NULL_Compare(), test_Parm_Compare(), test_Slew_Compare(), test_Status_Compare(), test_Status_Success(), and test_Value32_Compare().

void show_status_name

(

const unsigned int

status

)

[static]

Display the name for a status code.

Parameters:

status

Status code to interpret.

Returns:

Nothing.

References test_Status_Name().

Referenced by test_Status_Compare(), and test_Status_Success().

const char * test_Action_Name

(

const LIM_Action_Id

action

)

Return a text description of a LIM action.

Parameters:

action

Action ID value to interpret.

Returns:

Pointer to text description string.

References LIM_ACTION_ARR_STATE_CHANGE, LIM_ACTION_BIAS_ACD, LIM_ACTION_BIAS_CAL, LIM_ACTION_BIAS_TKR, LIM_ACTION_CAL_ABORT, LIM_ACTION_CAL_ABORT_STATUS, LIM_ACTION_CAL_COMPLETE, LIM_ACTION_CAL_OTHER, LIM_ACTION_CAL_START, LIM_ACTION_CAL_START_STATUS, LIM_ACTION_EVENT_INSERT, LIM_ACTION_EVENT_REMOVE, LIM_ACTION_GBM_COMMAND, LIM_ACTION_GBM_INT_PRI, LIM_ACTION_GBM_INT_RED, LIM_ACTION_GBM_STATE_CHANGE, LIM_ACTION_HV_STATE_CHANGE, LIM_ACTION_LCI_STATE_CHANGE, LIM_ACTION_LPA_STATE_CHANGE, LIM_ACTION_LTC_STOP, LIM_ACTION_MAIN_FEED_ON, LIM_ACTION_NON_SAA_CONFIG, LIM_ACTION_OP_MODE_CHANGE, LIM_ACTION_PHYSICS_ACTIVE, LIM_ACTION_PHYSICS_COMPLETE, LIM_ACTION_PHYSICS_GBM_INT, LIM_ACTION_PHYSICS_IDLE, LIM_ACTION_PHYSICS_SET_MODE, LIM_ACTION_PHYSICS_START, LIM_ACTION_PHYSICS_START_STATUS, LIM_ACTION_PHYSICS_STOP, LIM_ACTION_PHYSICS_STOP_STATUS, LIM_ACTION_PID_DIS_GBM_PRI, LIM_ACTION_PID_DIS_GBM_RED, LIM_ACTION_PID_EN_GBM_PRI, LIM_ACTION_PID_EN_GBM_RED, LIM_ACTION_PID_SELECT_PRI, LIM_ACTION_PID_SELECT_RED, LIM_ACTION_POWER_OFF, LIM_ACTION_POWER_ON, LIM_ACTION_RCV_GBM_CALCINFO, LIM_ACTION_RCV_GBM_CLOSEOUT, LIM_ACTION_RCV_GBM_REP_NOREC, LIM_ACTION_RCV_GBM_REP_REC, LIM_ACTION_RCV_GRB_CONFIRM, LIM_ACTION_RCV_GRB_FINISH, LIM_ACTION_RCV_GRB_SUSPECT, LIM_ACTION_RCV_SLEW_ACCEPT, LIM_ACTION_RCV_SLEW_REJECT, LIM_ACTION_REP_REQ_STATE_CHANGE, LIM_ACTION_SAA_CHANGE, LIM_ACTION_SAA_CONFIG, LIM_ACTION_SEND_SLEW_REQ, LIM_ACTION_SHED_BEGIN, LIM_ACTION_SHED_END, LIM_ACTION_SIU_REBOOT, LIM_ACTION_START, LIM_ACTION_STOP, and LIM_ACTION_TOO_STATE_CHANGE.

Referenced by test_Show_Info().

int test_Count_Compare	(	const test_Test_Descriptor *	td_p,
		const test_Cmd_Counts *	exp_p,
		const test_Cmd_Counts *	act_p,
		const char *	desc
	)

Verify command count values.

Parameters:

	td_p	Pointer to test descriptor.
	exp_p	Pointer to expected count values.
	act_p	Pointer to actual count values.
	desc	Description of the information.

Return values:

	0	Count values are correct.
	-1	One or more count values are incorrect.

References _test_Cmd_Counts::abort, _test_Cmd_Counts::active, _test_Cmd_Counts::calc_info, _test_Cmd_Counts::closeout, _test_Cmd_Counts::complete, _test_Test_Descriptor::depth, _test_Cmd_Counts::idle, _test_Cmd_Counts::other, _test_Cmd_Counts::reconfig, _test_Cmd_Counts::repoint, _test_Cmd_Counts::restart, show_at_level(), show_desc_stack(), _test_Cmd_Counts::start, and _test_Cmd_Counts::stop.

Referenced by SIM_check_stats().

int test_Delay	(	const test_Test_Descriptor *	td_p,
		const unsigned int	num_usecs
	)

Delay the current task a number of microseconds.

Parameters:

	td_p	Pointer to test descriptor.
	num_usecs	Number of microseconds to delay.

Return values:

	0	Success.
	-1	Failure.

References test_NULL_Compare(), test_Status_Success(), test_wut_handler(), and _test_Test_Descriptor::wut.

Referenced by lim_test_command(), lim_unit_test(), SIM_check_parms(), SIM_check_stats(), SIM_stop_tasks(), TLM_stop(), WRAP_check_telem(), and WRAP_send_cmd().

int test_Generic_Error	(	const test_Test_Descriptor *	td_p,
		const char *	fmt,
		const char *	str_param,
		const unsigned int	int_param
	)

Display a generic error message.

Parameters:

	td_p	Pointer to test descriptor.
	fmt	Format string to display.
	str_param	First parameter (string) for fmt string.
	int_param	Second parameter (uint) for fmt string.

Returns:

-1.

References _test_Test_Descriptor::depth, show_at_level(), and show_desc_stack().

Referenced by sim_shutdown_task(), TLM_check_no_tlm(), and TLM_check_tlm().

const char * test_Grb_State_Name

(

const LIM_Grb_State

grb_state

)

Return a text description of a GRB state.

Parameters:

grb_state

GRB state value to interpret.

Returns:

Pointer to text description string.

References LIM_GRB_STATE_0, LIM_GRB_STATE_1, LIM_GRB_STATE_2, and LIM_GRB_STATE_IDLE.

Referenced by test_Show_Info().

int test_Info_Compare	(	const test_Test_Descriptor *	td_p,
		const LIM_Info *	exp_p,
		const LIM_Info *	act_p,
		const char *	desc
	)

Verify the contents of LIM information.

Parameters:

	td_p	Pointer to test descriptor.
	exp_p	Pointer to expected information.
	act_p	Pointer to actual information.
	desc	Description of the information.

Return values:

	0	Information is correct.
	-1	Information is not correct.

References _LIM_Info::arr_remain_sec, _test_Test_Descriptor::depth, _LIM_Info::gbm_int_dis_remain_sec, _LIM_Info::last_status, show_at_level(), show_desc_stack(), test_Show_Info(), and _LIM_Info::too_remain_sec.

Referenced by TLM_check_tlm(), and WRAP_get_info().

int test_Memory_Compare	(	const test_Test_Descriptor *	td_p,
		const void *	expect_p,
		const void *	actual_p,
		const void *	mask_p,
		const size_t	num_bytes
	)

Verify the contents of a buffer in memory.

This function verifies the contents of a memory buffer and reports an error if the values are not as expected. An optional mask can be used to indicate which bits should be verified.

Parameters:

	td_p	Pointer to test descriptor.
	expect_p	Pointer to a memory buffer with the expected values.
	actual_p	Pointer to the memory buffer to verify.
	mask_p	Pointer to a memory buffer of mask values.
	num_bytes	Number of bytes to verify within the buffer.

Return values:

	0	Buffer values are correct.
	-1	One or more values within the buffer are incorrect.

References _test_Test_Descriptor::depth, show_at_level(), and show_desc_stack().

Referenced by lim_bias_acd_test(), lim_bias_cal_test(), lim_bias_tkr_test(), lim_power_cfg_test(), and lim_siu_cfg_test().

int test_NULL_Compare	(	const test_Test_Descriptor *	td_p,
		const unsigned int	actual,
		const char *	desc
	)

Check a 32-bit value to make sure it is not NULL.

Parameters:

	td_p	Pointer to test descriptor.
	actual	Actual value.
	desc	Description of the value.

Return values:

	0	Actual value != NULL.
	-1	Actual value == NULL.

References _test_Test_Descriptor::depth, show_at_level(), and show_desc_stack().

Referenced by cmd_send_cmd(), lim_alloc_wrap(), lim_init_wrap(), sim_init_task(), test_Delay(), and WRAP_send_cmd().

const char * test_Op_Mode_Name

(

const LIM_Operating_Mode

op_mode

)

Return a text description of an operating mode.

Parameters:

op_mode

Operating mode value to interpret.

Returns:

Pointer to text description string.

References LIM_OP_MODE_ARR, LIM_OP_MODE_CALIBRATION, LIM_OP_MODE_HOLD, LIM_OP_MODE_PHYSICS, LIM_OP_MODE_QUIESCENT, LIM_OP_MODE_TERMINAL, and LIM_OP_MODE_TOO.

Referenced by test_Show_Info().

const char * test_Other_State_Name

(

const LIM_Other_State

other_state

)

Return a text description of an 'other' task state.

Parameters:

other_state

'Other' task state value to interpret.

Returns:

Pointer to text description string.

References LIM_OTHER_STATE_IDLE, LIM_OTHER_STATE_RUNNING, and LIM_OTHER_STATE_STOPPING.

Referenced by test_Show_Info().

int test_Parm_Compare	(	const test_Test_Descriptor *	td_p,
		const test_Start_Parms *	exp_p,
		const test_Start_Parms *	act_p,
		const char *	desc
	)

Verify simulated task start parameter values.

Parameters:

	td_p	Pointer to test descriptor.
	exp_p	Pointer to expected parameter values.
	act_p	Pointer to actual parameter values.
	desc	Description of the information.

Return values:

	0	Parameter values are correct.
	-1	One or more parameter values are incorrect.

References _test_Start_Parms::consign, _test_Start_Parms::cpus, _test_Start_Parms::db, _test_Test_Descriptor::depth, _test_Start_Parms::ignore, _test_Start_Parms::latc, _test_Start_Parms::mode, _test_Start_Parms::run, show_at_level(), and show_desc_stack().

Referenced by SIM_check_parms().

void test_Pop_State

(

test_Test_Descriptor *

td_p

)

Return for a test state.

Pop a test state description from a test's state stack.

Parameters:

td_p

Pointer to test descriptor.

Returns:

Nothing.

References _test_Test_Descriptor::depth, _test_Test_Descriptor::desc, and show_banner().

Referenced by CMD_init(), CMD_rcv_cmd(), cmd_send(), CMD_send_arr_abort(), CMD_send_arr_response(), CMD_send_bias_acd(), CMD_send_bias_cal(), CMD_send_bias_tkr(), cmd_send_bulk(), CMD_send_cal_abort(), CMD_send_cal_complete(), CMD_send_cal_other(), CMD_send_cal_start(), cmd_send_cmd(), CMD_send_config_gbm(), CMD_send_config_hv(), CMD_send_config_pid(), CMD_send_diag_abort(), CMD_send_diag_complete(), CMD_send_diag_other(), CMD_send_diag_start(), CMD_send_gbm_calc_info(), CMD_send_gbm_closeout(), CMD_send_gbm_int(), CMD_send_gbm_repoint(), CMD_send_grb_confirm(), CMD_send_grb_finish(), CMD_send_grb_suspect(), CMD_send_hold_enter(), CMD_send_hold_exit(), CMD_send_latc_config(), CMD_send_latc_record(), CMD_send_latc_verify(), CMD_send_load_shed(), CMD_send_look_at_me(), CMD_send_main_feed_on(), CMD_send_no_op(), CMD_send_phys_active(), CMD_send_phys_complete(), CMD_send_phys_idle(), CMD_send_phys_start(), CMD_send_phys_stop(), CMD_send_pig_record(), CMD_send_power_off(), CMD_send_power_on(), CMD_send_saa_enter(), CMD_send_saa_exit(), CMD_send_safe_mode(), CMD_send_too_abort(), CMD_send_too_start(), CMD_shutdown(), lim_alloc_wrap(), lim_arr_send_grb_cmds(), lim_arr_transition(), lim_bias_acd_test(), lim_bias_cal_test(), lim_bias_tkr_test(), lim_free_wrap(), lim_gbm_send_cmds(), lim_init_wrap(), lim_pid_send_cmds(), lim_pig_send_cmds(), lim_power_cfg_test(), lim_shutdown_wrap(), lim_siu_cfg_test(), lim_test_arr(), lim_test_cal(), lim_test_command(), lim_test_control(), lim_test_diag(), lim_test_gbm(), lim_test_init(), lim_test_load_shed(), lim_test_mode(), lim_test_physics(), lim_test_pids(), lim_test_pig(), lim_test_pool(), lim_test_saa(), lim_test_shutdown(), lim_test_too(), lim_test_use_cases(), lim_unit_test(), SIM_check_parms(), SIM_check_stats(), sim_init_task(), SIM_init_tasks(), sim_shutdown_task(), SIM_shutdown_tasks(), SIM_start_tasks(), sim_stop_task(), SIM_stop_tasks(), TLM_check_tlm(), TLM_init(), TLM_shutdown(), TLM_start(), TLM_stop(), TLM_tlm_rcvd(), WRAP_capture_cal(), WRAP_capture_diag(), WRAP_capture_phys(), WRAP_check_telem(), WRAP_get_info(), WRAP_init(), WRAP_init_with_db(), WRAP_send_cmd(), WRAP_shutdown(), WRAP_start(), WRAP_start_LIM(), WRAP_start_with_db(), WRAP_stop(), and WRAP_stop_LIM().

void test_Push_State	(	test_Test_Descriptor *	td_p,
		const char *	desc,
		const int	index
	)

Enter a new test state.

Push a new test state description onto a test's state stack. This state stack provides a trace of the execution of the test.

Parameters:

	td_p	Pointer to test descriptor.
	desc	Description of the new state.
	index	Generic index value.

Returns:

Nothing.

References _test_Test_Descriptor::depth, _test_Test_Descriptor::desc, DIM, _test_Test_Descriptor::index, show_at_level(), and show_banner().

Referenced by CMD_init(), CMD_rcv_cmd(), cmd_send(), CMD_send_arr_abort(), CMD_send_arr_response(), CMD_send_bias_acd(), CMD_send_bias_cal(), CMD_send_bias_tkr(), cmd_send_bulk(), CMD_send_cal_abort(), CMD_send_cal_complete(), CMD_send_cal_other(), CMD_send_cal_start(), cmd_send_cmd(), CMD_send_config_gbm(), CMD_send_config_hv(), CMD_send_config_pid(), CMD_send_diag_abort(), CMD_send_diag_complete(), CMD_send_diag_other(), CMD_send_diag_start(), CMD_send_gbm_calc_info(), CMD_send_gbm_closeout(), CMD_send_gbm_int(), CMD_send_gbm_repoint(), CMD_send_grb_confirm(), CMD_send_grb_finish(), CMD_send_grb_suspect(), CMD_send_hold_enter(), CMD_send_hold_exit(), CMD_send_latc_config(), CMD_send_latc_record(), CMD_send_latc_verify(), CMD_send_load_shed(), CMD_send_look_at_me(), CMD_send_main_feed_on(), CMD_send_no_op(), CMD_send_phys_active(), CMD_send_phys_complete(), CMD_send_phys_idle(), CMD_send_phys_start(), CMD_send_phys_stop(), CMD_send_pig_record(), CMD_send_power_off(), CMD_send_power_on(), CMD_send_saa_enter(), CMD_send_saa_exit(), CMD_send_safe_mode(), CMD_send_too_abort(), CMD_send_too_start(), CMD_shutdown(), lim_alloc_wrap(), lim_arr_send_grb_cmds(), lim_arr_transition(), lim_bias_acd_test(), lim_bias_cal_test(), lim_bias_tkr_test(), lim_free_wrap(), lim_gbm_send_cmds(), lim_init_wrap(), lim_pid_send_cmds(), lim_pig_send_cmds(), lim_power_cfg_test(), lim_shutdown_wrap(), lim_siu_cfg_test(), lim_test_arr(), lim_test_cal(), lim_test_command(), lim_test_control(), lim_test_diag(), lim_test_gbm(), lim_test_init(), lim_test_load_shed(), lim_test_mode(), lim_test_physics(), lim_test_pids(), lim_test_pig(), lim_test_pool(), lim_test_saa(), lim_test_shutdown(), lim_test_too(), lim_test_use_cases(), lim_unit_test(), SIM_check_parms(), SIM_check_stats(), sim_init_task(), SIM_init_tasks(), sim_shutdown_task(), SIM_shutdown_tasks(), SIM_start_tasks(), sim_stop_task(), SIM_stop_tasks(), TLM_check_tlm(), TLM_init(), TLM_shutdown(), TLM_start(), TLM_stop(), TLM_tlm_rcvd(), WRAP_capture_cal(), WRAP_capture_diag(), WRAP_capture_phys(), WRAP_check_telem(), WRAP_get_info(), WRAP_init(), WRAP_init_with_db(), WRAP_send_cmd(), WRAP_shutdown(), WRAP_start(), WRAP_start_LIM(), WRAP_start_with_db(), WRAP_stop(), and WRAP_stop_LIM().

void test_Show	(	const test_Test_Descriptor *	td_p,
		const int	level,
		const char *	item_1,
		const char *	item_2
	)

Display text with indentation.

Display text with indentation appropriate for the specified level.

Parameters:

	td_p	Pointer to test descriptor.
	level	Indentation level.
	item_1	First text string to display.
	item_2	Second text string to display.

Returns:

Nothing.

References show_at_level().

Referenced by test_Show_Msg_OK().

void test_Show_Info	(	const test_Test_Descriptor *	td_p,
		const LIM_Info *	exp_p,
		const LIM_Info *	act_p
	)

Display LIM info.

Parameters:

	td_p	Pointer to test descriptor.
	exp_p	Pointer to expected information.
	act_p	Pointer to actual information.

Returns:

Nothing.

References _LIM_Info::arr_active, _LIM_Info::arr_ready, _LIM_Info::arr_remain_sec, _test_Test_Descriptor::depth, _LIM_Info::gbm_int_dis_remain_sec, _LIM_Info::gbm_pri_int_allowed, _LIM_Info::gbm_red_int_allowed, _LIM_Info::gbm_rep_allowed, _LIM_Info::grb_state, _LIM_Info::hv_allowed, _LIM_Info::last_action, _LIM_Info::last_status, _LIM_Info::lci_state, _LIM_Info::ldf_state, _LIM_Info::lpa_state, _LIM_Info::op_mode, _LIM_Info::rep_req_pending, _LIM_Info::saa_transit, show_at_level(), test_Action_Name(), test_Grb_State_Name(), test_Op_Mode_Name(), test_Other_State_Name(), test_Status_Name(), _LIM_Info::too_active, _LIM_Info::too_ready, _LIM_Info::too_remain_sec, _LIM_Info::too_started, and _LIM_Info::virt_mode.

Referenced by test_Info_Compare(), TLM_check_no_tlm(), and tlm_dispatch_ctl().

void test_Show_Item	(	const test_Test_Descriptor *	td_p,
		const char *	name,
		const char *	fmt,
		const char *	str_param,
		const unsigned int	int_param
	)

Display an item of data.

This function displays an item of data in a predefined format.

Parameters:

	td_p	Pointer to test descriptor.
	name	Name of the item.
	fmt	Format string to display the item's value.
	str_param	First parameter (string) for fmt string.
	int_param	Second parameter (uint) for fmt string.

Returns:

Nothing.

References _test_Test_Descriptor::depth, and show_at_level().

Referenced by CMD_send_gbm_int(), and WRAP_send_cmd().

void test_Show_Msg_OK

(

const test_Test_Descriptor *

td_p

)

Indicate that the next error message is expected.

Display text that indicates that the next error message is expected.

Parameters:

td_p

Pointer to test descriptor.

Returns:

Nothing.

References test_Show().

Referenced by lim_alloc_wrap(), lim_free_wrap(), lim_init_wrap(), lim_shutdown_wrap(), WRAP_capture_cal(), WRAP_capture_diag(), WRAP_capture_phys(), WRAP_get_info(), WRAP_init(), WRAP_init_with_db(), WRAP_send_cmd(), WRAP_shutdown(), WRAP_start(), WRAP_start_with_db(), and WRAP_stop().

void test_Show_Slew	(	const test_Test_Descriptor *	td_p,
		const test_Slew_Info *	exp_p,
		const test_Slew_Info *	act_p,
		const char *	desc
	)

Display Slew-Request command parameters.

Parameters:

	td_p	Pointer to test descriptor.
	exp_p	Pointer to expected information.
	act_p	Pointer to actual information.
	desc	Description of the packet.

Returns:

Nothing.

References _test_Slew_Info::accepted, _test_Slew_Info::dec, _test_Test_Descriptor::depth, _test_Slew_Info::dwell_time, _test_Slew_Info::pad, _test_Slew_Info::ra, _test_Slew_Info::sclk_seconds, _test_Slew_Info::sclk_subseconds, show_at_level(), and _test_Slew_Info::transaction_id.

Referenced by test_Slew_Compare(), TLM_check_no_tlm(), tlm_dispatch_cmd(), and tlm_dispatch_ctl_x().

void test_Sleep_Sec

(

int

num_secs

)

Sleep for the specified number of seconds.

Parameters:

num_secs

Number of seconds to sleep.

Returns:

Nothing.

Referenced by show_desc_stack(), and sim_handle_start().

int test_Slew_Compare	(	const test_Test_Descriptor *	td_p,
		const test_Slew_Info *	exp_p,
		const test_Slew_Info *	act_p,
		const char *	desc
	)

Verify Slew-Request command parameters.

Parameters:

	td_p	Pointer to test descriptor.
	exp_p	Pointer to expected information.
	act_p	Pointer to actual information.
	desc	Description of the information.

Return values:

	0	Information is correct.
	-1	Information is not correct.

References _test_Test_Descriptor::depth, _test_Slew_Info::pad, _test_Slew_Info::sclk_seconds, _test_Slew_Info::sclk_subseconds, show_at_level(), show_desc_stack(), and test_Show_Slew().

Referenced by TLM_check_tlm().

int test_Status_Compare	(	const test_Test_Descriptor *	td_p,
		const unsigned int	expect,
		const unsigned int	actual,
		const char *	func
	)

Check a MSG status code value.

Compare actual and expected status code values and display a message if they differ.

Parameters:

	td_p	Pointer to test descriptor.
	expect	Expected value.
	actual	Actual value.
	func	Name of the function that returned the status.

Return values:

	0	Actual value == Expected value
	-1	Actual value != Expected value.

References _test_Test_Descriptor::depth, show_at_level(), show_desc_stack(), and show_status_name().

Referenced by lim_free_wrap(), lim_init_wrap(), lim_shutdown_wrap(), WRAP_capture_cal(), WRAP_capture_diag(), WRAP_capture_phys(), WRAP_get_info(), WRAP_init(), WRAP_init_with_db(), WRAP_send_cmd(), WRAP_shutdown(), WRAP_start(), WRAP_start_with_db(), and WRAP_stop().

const char * test_Status_Name

(

const unsigned int

status

)

Return a text description of a status code.

Parameters:

status

Status code to interpret.

Returns:

Pointer to text description string.

Referenced by show_status_name(), test_Show_Info(), and wrap_free_cb().

int test_Status_Success	(	const test_Test_Descriptor *	td_p,
		const unsigned int	actual,
		const char *	func
	)

Check a MSG status code to make sure it's reporting success.

Parameters:

	td_p	Pointer to test descriptor.
	actual	Actual value.
	func	Name of the function that returned the status.

Return values:

	0	Actual value == Expected value
	-1	Actual value != Expected value.

References _test_Test_Descriptor::depth, show_at_level(), show_desc_stack(), and show_status_name().

Referenced by CMD_init(), cmd_send_cmd(), CMD_send_gbm_int(), CMD_shutdown(), sim_init_task(), SIM_init_tasks(), sim_shutdown_task(), SIM_shutdown_tasks(), SIM_start_tasks(), sim_stop_task(), test_Delay(), TLM_check_no_tlm(), TLM_check_tlm(), TLM_init(), TLM_shutdown(), TLM_start(), TLM_stop(), TLM_tlm_rcvd(), and WRAP_send_cmd().

int test_Value32_Compare	(	const test_Test_Descriptor *	td_p,
		const unsigned int	expect,
		const unsigned int	actual,
		const char *	desc
	)

Check a 32-bit value.

Compare actual and expected 32-bit values and display a message if they differ.

Parameters:

	td_p	Pointer to test descriptor.
	expect	Expected value.
	actual	Actual value.
	desc	Description of the value.

Return values:

	0	Actual value == Expected value
	-1	Actual value != Expected value.

References _test_Test_Descriptor::depth, show_at_level(), and show_desc_stack().

Referenced by lim_alloc_wrap(), lim_init_wrap(), and TLM_check_tlm().

WUT_cb_status test_wut_handler	(	void *	prm,
		WUT_tmr *	wut
	)			[static]

Handle wake-up timer expiration.

Parameters:

	prm	Pointer to semaphore to give.
	wut	Pointer to wake-up timer.

Returns:

WUT status.

Referenced by test_Delay().