Test

Data Structures
struct	testcase
	Structure representing a test case. More...
union	test_buffers

Functions
void	test_printn (uint32_t n)
	Prints a decimal unsigned number.
void	test_print (const char *msgp)
	Prints a line without final end-of-line.
void	test_println (const char *msgp)
	Prints a line.
static void	clear_tokens (void)
static void	print_tokens (void)
void	test_emit_token (char token)
	Emits a token into the tokens buffer.
bool	_test_fail (unsigned point)
bool	_test_assert (unsigned point, bool condition)
bool	_test_assert_sequence (unsigned point, char *expected)
bool	_test_assert_time_window (unsigned point, systime_t start, systime_t end)
void	test_terminate_threads (void)
	Sets a termination request in all the test-spawned threads.
void	test_wait_threads (void)
	Waits for the completion of all the test-spawned threads.
void	test_cpu_pulse (unsigned duration)
	CPU pulse.
systime_t	test_wait_tick (void)
	Delays execution until next system time tick.
static void	tmr (void *p)
void	test_start_timer (unsigned ms)
	Starts the test timer.
static void	execute_test (const struct testcase *tcp)
static void	print_line (void)
msg_t	TestThread (void *p)
	Test execution thread function.
void	ChkIntSources (void)

Variables
static ROMCONST struct testcase *ROMCONST *	patterns []
static bool	local_fail
static bool	global_fail
static unsigned	failpoint
static char	tokens_buffer [MAX_TOKENS]
static char *	tokp
union test_buffers	test
thread_t *	threads [MAX_THREADS]
void *ROMCONST	wa [5]
static BaseSequentialStream *	chp
bool	test_timer_done
	Set to TRUE when the test timer reaches its deadline.
static VirtualTimer	vt
Thread *	threads [MAX_THREADS]
union test_buffers	test
void *ROMCONST	wa []
bool	test_timer_done
	Set to TRUE when the test timer reaches its deadline.

Detailed Description

Function Documentation

_test_assert()

bool _test_assert	(	unsigned	point,
		bool	condition
	)

Definition at line 147 of file test.c.

                                                  {
 
  if (!condition)
    return _test_fail(point);
  return FALSE;
}

Referenced by _test_assert_time_window().

Here is the call graph for this function:

Here is the caller graph for this function:

_test_assert_sequence()

bool _test_assert_sequence	(	unsigned	point,
		char *	expected
	)

Definition at line 154 of file test.c.

                                                           {
  char *cp = tokens_buffer;
  while (cp < tokp) {
    if (*cp++ != *expected++)
     return _test_fail(point);
  }
  if (*expected)
    return _test_fail(point);
  clear_tokens();
  return FALSE;
}

Here is the call graph for this function:

_test_assert_time_window()

bool _test_assert_time_window	(	unsigned	point,
		systime_t	start,
		systime_t	end
	)

Definition at line 166 of file test.c.

                                                                              {
 
  return _test_assert(point, chTimeIsWithin(start, end));
}

Here is the call graph for this function:

_test_fail()

bool _test_fail

(

unsigned

point

)

Definition at line 139 of file test.c.

                                {
 
  local_fail = TRUE;
  global_fail = TRUE;
  failpoint = point;
  return TRUE;
}

Referenced by _test_assert(), and _test_assert_sequence().

Here is the caller graph for this function:

ChkIntSources()

void ChkIntSources

(

void

)

Referenced by __attribute__(), bmk10_execute(), bmk11_execute(), bmk12_execute(), bmk4_execute(), bmk5_execute(), bmk6_execute(), bmk7_execute(), bmk9_execute(), test_cpu_pulse(), and thread8().

Here is the caller graph for this function:

clear_tokens()

static void clear_tokens ( void  )

static

Definition at line 112 of file test.c.

                               {
 
  tokp = tokens_buffer;
}

Referenced by _test_assert_sequence(), and execute_test().

Here is the caller graph for this function:

execute_test()

static void execute_test ( const struct testcase *  tcp )

static

Definition at line 264 of file test.c.

                                                     {
  int i;
 
  /* Initialization */
  clear_tokens();
  local_fail = FALSE;
  for (i = 0; i < MAX_THREADS; i++)
    threads[i] = NULL;
 
  if (tcp->setup != NULL)
    tcp->setup();
  tcp->execute();
  if (tcp->teardown != NULL)
    tcp->teardown();
 
  test_wait_threads();
}

Referenced by TestThread().

Here is the call graph for this function:

Here is the caller graph for this function:

print_line()

static void print_line ( void  )

static

Definition at line 282 of file test.c.

                             {
  unsigned i;
 
  for (i = 0; i < 76; i++)
    chSequentialStreamPut(chp, '-');
  chSequentialStreamWrite(chp, (const uint8_t *)"\r\n", 2);
}

Referenced by TestThread().

Here is the caller graph for this function:

print_tokens()

static void print_tokens ( void  )

static

Definition at line 117 of file test.c.

                               {
  char *cp = tokens_buffer;
 
  while (cp < tokp)
    chSequentialStreamPut(chp, *cp++);
}

Referenced by TestThread().

Here is the caller graph for this function:

test_cpu_pulse()

void test_cpu_pulse

(

unsigned

duration

)

CPU pulse.

Note

The current implementation is not totally reliable.

Parameters

[in]

duration

CPU pulse duration in milliseconds

Definition at line 206 of file test.c.

                                       {
  systime_t start, end, now;
 
  start = chThdSelf()->p_time;
  end = start + TIME_MS2I(duration);
  do {
    now = chThdSelf()->p_time;
#if defined(SIMULATOR)
    ChkIntSources();
#endif
  }
  while (end > start ? (now >= start) && (now < end) :
                       (now >= start) || (now < end));
}

Here is the call graph for this function:

test_emit_token()

void test_emit_token

(

char

token

)

Emits a token into the tokens buffer.

Parameters

[in]

token

the token as a char

Definition at line 129 of file test.c.

                                 {
 
  chSysLock();
  *tokp++ = token;
  chSysUnlock();
}

test_print()

void test_print

(

const char *

msgp

)

Prints a line without final end-of-line.

Parameters

[in]

msgp

the message

Definition at line 92 of file test.c.

                                  {
 
  while (*msgp)
    chSequentialStreamPut(chp, *msgp++);
}

Referenced by bmk10_execute(), bmk11_execute(), bmk12_execute(), bmk13_execute(), bmk1_execute(), bmk2_execute(), bmk3_execute(), bmk4_execute(), bmk5_execute(), bmk6_execute(), bmk7_execute(), bmk8_execute(), bmk9_execute(), test_println(), and TestThread().

Here is the caller graph for this function:

test_println()

void test_println

(

const char *

msgp

)

Prints a line.

Parameters

[in]

msgp

the message

Definition at line 103 of file test.c.

                                    {
 
  test_print(msgp);
  chSequentialStreamWrite(chp, (const uint8_t *)"\r\n", 2);
}

Referenced by bmk10_execute(), bmk11_execute(), bmk12_execute(), bmk13_execute(), bmk1_execute(), bmk2_execute(), bmk3_execute(), bmk4_execute(), bmk5_execute(), bmk6_execute(), bmk7_execute(), bmk8_execute(), bmk9_execute(), and TestThread().

Here is the call graph for this function:

Here is the caller graph for this function:

test_printn()

void test_printn

(

uint32_t

n

)

Prints a decimal unsigned number.

Parameters

[in]

n

the number to be printed

Definition at line 73 of file test.c.

                             {
  char buf[16], *p;
 
  if (!n)
    chSequentialStreamPut(chp, '0');
  else {
    p = buf;
    while (n)
      *p++ = (n % 10) + '0', n /= 10;
    while (p > buf)
      chSequentialStreamPut(chp, *--p);
  }
}

Referenced by bmk10_execute(), bmk11_execute(), bmk12_execute(), bmk13_execute(), bmk1_execute(), bmk2_execute(), bmk3_execute(), bmk4_execute(), bmk5_execute(), bmk6_execute(), bmk7_execute(), bmk8_execute(), bmk9_execute(), and TestThread().

Here is the caller graph for this function:

test_start_timer()

void test_start_timer

(

unsigned

ms

)

Starts the test timer.

Parameters

[in]

ms

time in milliseconds

Definition at line 254 of file test.c.

                                   {
 
  systime_t duration = TIME_MS2I(ms);
  test_timer_done = FALSE;
  chVTSet(&vt, duration, tmr, NULL);
}

Referenced by __attribute__(), bmk10_execute(), bmk11_execute(), bmk12_execute(), bmk4_execute(), bmk5_execute(), bmk6_execute(), bmk7_execute(), and bmk9_execute().

Here is the call graph for this function:

Here is the caller graph for this function:

test_terminate_threads()

void test_terminate_threads

(

void

)

Sets a termination request in all the test-spawned threads.

Definition at line 178 of file test.c.

                                  {
  int i;
 
  for (i = 0; i < MAX_THREADS; i++)
    if (threads[i])
      chThdTerminate(threads[i]);
}

Referenced by bmk7_execute(), and bmk8_execute().

Here is the caller graph for this function:

test_wait_threads()

void test_wait_threads

(

void

)

Waits for the completion of all the test-spawned threads.

Definition at line 189 of file test.c.

                             {
  int i;
 
  for (i = 0; i < MAX_THREADS; i++)
    if (threads[i] != NULL) {
      chThdWait(threads[i]);
      threads[i] = NULL;
    }
}

Referenced by bmk1_execute(), bmk2_execute(), bmk3_execute(), bmk4_execute(), bmk7_execute(), bmk8_execute(), and execute_test().

Here is the caller graph for this function:

test_wait_tick()

systime_t test_wait_tick

(

void

)

Delays execution until next system time tick.

Returns

The system time.

Definition at line 227 of file test.c.

                               {
 
  chThdSleep(1);
  return chTimeNow();
}

Referenced by __attribute__(), bmk10_execute(), bmk11_execute(), bmk12_execute(), bmk4_execute(), bmk5_execute(), bmk6_execute(), bmk7_execute(), bmk8_execute(), and bmk9_execute().

Here is the caller graph for this function:

TestThread()

msg_t TestThread

(

void *

p

)

Test execution thread function.

Parameters

[in]

p

pointer to a BaseChannel object for test output

Returns

A failure boolean value.

Definition at line 296 of file test.c.

                          {
  int i, j;
 
  chp = p;
  test_println("");
  test_println("*** ChibiOS/RT test suite");
  test_println("***");
  test_print("*** Kernel:       ");
  test_println(CH_KERNEL_VERSION);
  test_print("*** Compiled:     ");
  test_println(__DATE__ " - " __TIME__);
#ifdef CH_COMPILER_NAME
  test_print("*** Compiler:     ");
  test_println(CH_COMPILER_NAME);
#endif
  test_print("*** Architecture: ");
  test_println(CH_ARCHITECTURE_NAME);
#ifdef CH_CORE_VARIANT_NAME
  test_print("*** Core Variant: ");
  test_println(CH_CORE_VARIANT_NAME);
#endif
#ifdef CH_PORT_INFO
  test_print("*** Port Info:    ");
  test_println(CH_PORT_INFO);
#endif
#ifdef PLATFORM_NAME
  test_print("*** Platform:     ");
  test_println(PLATFORM_NAME);
#endif
#ifdef BOARD_NAME
  test_print("*** Test Board:   ");
  test_println(BOARD_NAME);
#endif
  test_println("");
 
  global_fail = FALSE;
  i = 0;
  while (patterns[i]) {
    j = 0;
    while (patterns[i][j]) {
      print_line();
      test_print("--- Test Case ");
      test_printn(i + 1);
      test_print(".");
      test_printn(j + 1);
      test_print(" (");
      test_print(patterns[i][j]->name);
      test_println(")");
#if DELAY_BETWEEN_TESTS > 0
      chThdSleepMilliseconds(DELAY_BETWEEN_TESTS);
#endif
      execute_test(patterns[i][j]);
      if (local_fail) {
        test_print("--- Result: FAILURE (#");
        test_printn(failpoint);
        test_print(" [");
        print_tokens();
        test_println("])");
      }
      else
        test_println("--- Result: SUCCESS");
      j++;
    }
    i++;
  }
  print_line();
  test_println("");
  test_print("Final result: ");
  if (global_fail)
    test_println("FAILURE");
  else
    test_println("SUCCESS");
 
  return (msg_t)global_fail;
}

Referenced by runChibioTest().

Here is the call graph for this function:

Here is the caller graph for this function:

tmr()

static void tmr ( void *  p )

static

Definition at line 243 of file test.c.

                         {
  (void)p;
 
  test_timer_done = TRUE;
}

Referenced by test_start_timer().

Here is the caller graph for this function:

Variable Documentation

chp

BaseSequentialStream* chp

static

Definition at line 66 of file test.c.

Referenced by print_line(), print_tokens(), test_print(), test_println(), test_printn(), and TestThread().

failpoint

unsigned failpoint

static

Definition at line 42 of file test.c.

Referenced by _test_fail(), and TestThread().

global_fail

bool global_fail

static

Definition at line 41 of file test.c.

Referenced by _test_fail(), and TestThread().

local_fail

bool local_fail

static

Definition at line 41 of file test.c.

Referenced by _test_fail(), execute_test(), and TestThread().

patterns

ROMCONST struct testcase* ROMCONST* patterns[]

static

Initial value:

= {
  patternbmk,
  NULL
}

Definition at line 36 of file test.c.

                                                         {
  patternbmk,
  NULL
};

Referenced by TestThread().

test [1/2]

union test_buffers test

Definition at line 50 of file test.c.

Referenced by isBigEndian(), isPhaseInRange(), and Hysteresis::test().

test [2/2]

union test_buffers test

extern

Definition at line 50 of file test.c.

Referenced by isBigEndian(), isPhaseInRange(), and Hysteresis::test().

test_timer_done [1/2]

bool test_timer_done

Set to TRUE when the test timer reaches its deadline.

Definition at line 240 of file test.c.

Referenced by __attribute__(), bmk10_execute(), bmk11_execute(), bmk12_execute(), bmk4_execute(), bmk5_execute(), bmk6_execute(), bmk7_execute(), bmk9_execute(), test_start_timer(), and tmr().

test_timer_done [2/2]

bool test_timer_done

extern

Set to TRUE when the test timer reaches its deadline.

Definition at line 240 of file test.c.

Referenced by __attribute__(), bmk10_execute(), bmk11_execute(), bmk12_execute(), bmk4_execute(), bmk5_execute(), bmk6_execute(), bmk7_execute(), bmk9_execute(), test_start_timer(), and tmr().

threads [1/2]

thread_t* threads[MAX_THREADS]

Definition at line 55 of file test.c.

Referenced by bmk1_execute(), bmk2_execute(), bmk3_execute(), bmk4_execute(), bmk7_execute(), bmk8_execute(), execute_test(), test_terminate_threads(), and test_wait_threads().

threads [2/2]

Thread* threads[MAX_THREADS]

extern

Definition at line 55 of file test.c.

Referenced by bmk1_execute(), bmk2_execute(), bmk3_execute(), bmk4_execute(), bmk7_execute(), bmk8_execute(), execute_test(), test_terminate_threads(), and test_wait_threads().

tokens_buffer

char tokens_buffer[MAX_TOKENS]

static

Definition at line 43 of file test.c.

Referenced by _test_assert_sequence(), clear_tokens(), and print_tokens().

tokp

char* tokp

static

Definition at line 44 of file test.c.

Referenced by _test_assert_sequence(), clear_tokens(), print_tokens(), and test_emit_token().

vt

VirtualTimer vt

static

Definition at line 242 of file test.c.

Referenced by test_start_timer().

wa [1/2]

void* ROMCONST wa[5]

Initial value:

= {test.wa.T0, test.wa.T1, test.wa.T2,
                         test.wa.T3, test.wa.T4}

Definition at line 60 of file test.c.

                        {test.wa.T0, test.wa.T1, test.wa.T2,
                         test.wa.T3, test.wa.T4};

Referenced by bmk1_execute(), bmk2_execute(), bmk3_execute(), bmk4_execute(), bmk5_execute(), bmk6_execute(), bmk7_execute(), and bmk8_execute().

wa [2/2]

void* ROMCONST wa[]

extern

Definition at line 60 of file test.c.

                        {test.wa.T0, test.wa.T1, test.wa.T2,
                         test.wa.T3, test.wa.T4};

Referenced by bmk1_execute(), bmk2_execute(), bmk3_execute(), bmk4_execute(), bmk5_execute(), bmk6_execute(), bmk7_execute(), and bmk8_execute().