zephyr/samples/nanokernel/test/test_sema
Peter Mitsis d63a4f7bf7 nano_timers: Simplify nano_xxx_timer_test() API family
Simplifies the nanokernel timer API so that the timeout parameter must be
specified when invoking nano_isr_timer_test(), nano_fiber_timer_test(),
nano_task_timer_test() and nano_timer_test().

This obsoletes the following APIs:
	nano_fiber_timer_wait()
	nano_task_timer_wait()
	nano_timer_wait()

Note that even the though the new API requires that the timeout parameter
be specified, there are currentl only two acceptable values:
	TICKS_NONE and TICKS_UNLIMITED

Theoretically, the current implementation would allow one to supply a
finite positive value for the timeout and the system would wait up to
that many ticks for the timer to expire. However, it is thought that
that unnecessarily complicates the nanokernel timer model and so it is
left as an unsupported option.  Should that change, then that feature
could be enabled by updating the documentation.

Change-Id: I8835c5342ab5025d6f70fdfbed54a50add7568d7
Signed-off-by: Peter Mitsis <peter.mitsis@windriver.com>
2016-02-05 20:25:15 -05:00
..
src nano_timers: Simplify nano_xxx_timer_test() API family 2016-02-05 20:25:15 -05:00
Makefile Use BOARD instead of PLATFORM_CONFIG 2016-02-05 20:25:11 -05:00
README.txt nano_sema: Simplify nano_xxx_sem_take() API family 2016-02-05 20:25:14 -05:00
prj.conf test_sema: enable for generic_arc 2016-02-05 20:25:06 -05:00
testcase.ini update tests due to recent board files shuffle 2016-02-05 20:25:12 -05:00

README.txt

Title: Semaphore APIs

Description:

This test verifies that the nanokernel semaphore APIs operate as expected.

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

Building and Running Project:

This nanokernel 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:

tc_start() - Test Nanokernel Semaphores
Nano objects initialized
Giving and taking a semaphore in a task (non-blocking)
Giving and taking a semaphore in an ISR (non-blocking)
Giving and taking a semaphore in a fiber (non-blocking)
Semaphore from the task woke the fiber
Semaphore from the fiber woke the task
Semaphore from the ISR woke the task.
First pass
multiple-waiter fiber 0 trying to get semaphore...
multiple-waiter fiber 1 trying to get semaphore...
multiple-waiter fiber 2 trying to get semaphore...
multiple-waiter fiber 0 acquired semaphore, sending reply
multiple-waiter fiber 1 acquired semaphore, sending reply
multiple-waiter fiber 2 acquired semaphore, sending reply
Task took multi-waiter reply semaphore 3 times, as expected.
Second pass
multiple-waiter fiber 0 trying to get semaphore...
multiple-waiter fiber 1 trying to get semaphore...
multiple-waiter fiber 2 trying to get semaphore...
multiple-waiter fiber 0 acquired semaphore, sending reply
multiple-waiter fiber 1 acquired semaphore, sending reply
multiple-waiter fiber 2 acquired semaphore, sending reply
Task took multi-waiter reply semaphore 3 times, as expected.
test nano_task_sem_take() with timeout > 0
nano_task_sem_take() timed out as expected
nano_task_sem_take() got sem in time, as expected
testing timeouts of 5 fibers on same sem
 got fiber (q order: 2, t/o: 10, sem: 200001c8) as expected
 got fiber (q order: 3, t/o: 15, sem: 200001c8) as expected
 got fiber (q order: 0, t/o: 20, sem: 200001c8) as expected
 got fiber (q order: 4, t/o: 25, sem: 200001c8) as expected
 got fiber (q order: 1, t/o: 30, sem: 200001c8) as expected
testing timeouts of 9 fibers on different sems
 got fiber (q order: 0, t/o: 10, sem: 200001d4) as expected
 got fiber (q order: 5, t/o: 15, sem: 200001c8) as expected
 got fiber (q order: 7, t/o: 20, sem: 200001c8) as expected
 got fiber (q order: 1, t/o: 25, sem: 200001c8) as expected
 got fiber (q order: 8, t/o: 30, sem: 200001d4) as expected
 got fiber (q order: 2, t/o: 35, sem: 200001c8) as expected
 got fiber (q order: 6, t/o: 40, sem: 200001c8) as expected
 got fiber (q order: 4, t/o: 45, sem: 200001d4) as expected
 got fiber (q order: 3, t/o: 50, sem: 200001d4) as expected
testing 5 fibers timing out, but obtaining the sem in time
(except the last one, which times out)
 got fiber (q order: 0, t/o: 20, sem: 200001c8) as expected
 got fiber (q order: 1, t/o: 30, sem: 200001c8) as expected
 got fiber (q order: 2, t/o: 10, sem: 200001c8) as expected
 got fiber (q order: 3, t/o: 15, sem: 200001c8) as expected
 got fiber (q order: 4, t/o: 25, sem: 200001c8) as expected
===================================================================
PASS - main.
===================================================================
PROJECT EXECUTION SUCCESSFUL