zephyr/samples/microkernel/benchmark/sys_kernel
Peter Mitsis 5c01c09f4d nano_stack: Simplify nano_xxx_stack_pop() API family
Changes the nanokernel stack API so that the timeout parameter must be
specified when invoking nano_isr_stack_pop(), nano_fiber_stack_pop(),
nano_task_stack_pop() and nano_stack_pop().

This obsoletes the following APIs:
	nano_fiber_stack_pop_wait()
	nano_task_stack_pop_wait()
	nano_stack_pop_wait()

Note that even though the new API requires that the timeout parameter
be specified, there are currently only two acceptable values:
	TICKS_NONE and TICKS_UNLIMITED
This nanokernel option does not support CONFIG_NANO_TIMEOUTS.

Change-Id: Ic7f16ee30c3534115ceffa19ef8591ecc5a79080
Signed-off-by: Peter Mitsis <peter.mitsis@windriver.com>
2016-02-05 20:25:14 -05:00
..
Makefile Use BOARD instead of PLATFORM_CONFIG 2016-02-05 20:25:11 -05:00
README.txt nano_stack: Simplify nano_xxx_stack_pop() API family 2016-02-05 20:25:14 -05:00
prj.conf samples: remove ENHANCED_SECURITY from project configs 2016-02-05 20:24:20 -05:00
prj.mdef Rename VPF files to use MDEF file extension 2016-02-05 20:14:15 -05:00
testcase.ini initial commit for next-gen sanity checks 2016-02-05 20:14:42 -05:00

README.txt

Title: Nanokernel Object Performance

Description:

The SysKernel test measures the performance of the nanokernel's semaphore,
lifo, fifo and stack objects.

--------------------------------------------------------------------------------

Building and Running Project:

This microkernel project outputs to the console. It can be built and executed
on QEMU as follows:

    make qemu

--------------------------------------------------------------------------------

Troubleshooting:

Problems caused by out-dated project information can be addressed by
issuing one of the following commands then rebuilding the project:

    make clean          # discard results of previous builds
                        # but keep existing configuration info
or
    make pristine       # discard results of previous builds
                        # and restore pre-defined configuration info

--------------------------------------------------------------------------------

Sample Output:

MODULE: Nanokernel API test
KERNEL VERSION: <varies>

Each test below are repeated 5000 times and the average
time for one iteration is displayed.

TEST CASE: Semaphore #1
TEST COVERAGE: 
	nano_sem_init
	nano_fiber_sem_take(TICKS_UNLIMITED)
	nano_fiber_sem_give
Starting test. Please wait...
TEST RESULT: SUCCESSFUL
DETAILS: Average time for 1 iteration: NNNN nSec
END TEST CASE

TEST CASE: Semaphore #2
TEST COVERAGE: 
	nano_sem_init
	nano_fiber_sem_take(TICKS_NONE)
	fiber_yield
	nano_fiber_sem_give
Starting test. Please wait...
TEST RESULT: SUCCESSFUL
DETAILS: Average time for 1 iteration: NNNN nSec
END TEST CASE

TEST CASE: Semaphore #3
TEST COVERAGE: 
	nano_sem_init
	nano_fiber_sem_take(TICKS_UNLIMITED)
	nano_fiber_sem_give
	nano_task_sem_give
	nano_task_sem_take(TICKS_UNLIMITED)
Starting test. Please wait...
TEST RESULT: SUCCESSFUL
DETAILS: Average time for 1 iteration: NNNN nSec
END TEST CASE

TEST CASE: LIFO #1
TEST COVERAGE: 
	nano_lifo_init
	nano_fiber_lifo_get(TICKS_UNLIMITED)
	nano_fiber_lifo_put
Starting test. Please wait...
TEST RESULT: SUCCESSFUL
DETAILS: Average time for 1 iteration: NNNN nSec
END TEST CASE

TEST CASE: LIFO #2
TEST COVERAGE: 
	nano_lifo_init
	nano_fiber_lifo_get(TICKS_UNLIMITED)
	nano_fiber_lifo_get(TICKS_NONE)
	nano_fiber_lifo_put
	fiber_yield
Starting test. Please wait...
TEST RESULT: SUCCESSFUL
DETAILS: Average time for 1 iteration: NNNN nSec
END TEST CASE

TEST CASE: LIFO #3
TEST COVERAGE: 
	nano_lifo_init
	nano_fiber_lifo_get(TICKS_UNLIMITED)
	nano_fiber_lifo_put
	nano_task_lifo_get(TICKS_UNLIMITED)
	nano_task_lifo_put
Starting test. Please wait...
TEST RESULT: SUCCESSFUL
DETAILS: Average time for 1 iteration: NNNN nSec
END TEST CASE

TEST CASE: FIFO #1
TEST COVERAGE: 
	nano_fifo_init
	nano_fiber_fifo_get
	nano_fiber_fifo_put
Starting test. Please wait...
TEST RESULT: SUCCESSFUL
DETAILS: Average time for 1 iteration: NNNN nSec
END TEST CASE

TEST CASE: FIFO #2
TEST COVERAGE: 
	nano_fifo_init
	nano_fiber_fifo_get(TICKS_UNLIMITED)
	nano_fiber_fifo_get
	nano_fiber_fifo_put
	fiber_yield
Starting test. Please wait...
TEST RESULT: SUCCESSFUL
DETAILS: Average time for 1 iteration: NNNN nSec
END TEST CASE

TEST CASE: FIFO #3
TEST COVERAGE: 
	nano_fifo_init
	nano_fiber_fifo_get
	nano_fiber_fifo_put
	nano_task_fifo_get
	nano_task_fifo_put
Starting test. Please wait...
TEST RESULT: SUCCESSFUL
DETAILS: Average time for 1 iteration: NNNN nSec
END TEST CASE

TEST CASE: Stack #1
TEST COVERAGE: 
	nano_stack_init
	nano_fiber_stack_pop(TICKS_UNLIMITED)
	nano_fiber_stack_push
Starting test. Please wait...
TEST RESULT: SUCCESSFUL
DETAILS: Average time for 1 iteration: NNNN nSec
END TEST CASE

TEST CASE: Stack #2
TEST COVERAGE: 
	nano_stack_init
	nano_fiber_stack_pop(TICKS_UNLIMITED)
	nano_fiber_stack_pop
	nano_fiber_stack_push
	fiber_yield
Starting test. Please wait...
TEST RESULT: SUCCESSFUL
DETAILS: Average time for 1 iteration: NNNN nSec
END TEST CASE

TEST CASE: Stack #3
TEST COVERAGE: 
	nano_stack_init
	nano_fiber_stack_pop(TICKS_UNLIMITED)
	nano_fiber_stack_push
	nano_task_stack_pop(TICKS_UNLIMITED)
	nano_task_stack_push
Starting test. Please wait...
TEST RESULT: SUCCESSFUL
DETAILS: Average time for 1 iteration: NNNN nSec
END TEST CASE

PROJECT EXECUTION SUCCESSFUL