zephyr/samples/microkernel/test/test_critical
Anas Nashif f367f071b6 doxygen: add @brief and capitalize
Remove function name from comment and add @brief instead.
Also capitilize first letter.

Change-Id: Ib708b49bf02e5bc89b0066637a55874e659637e0
Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2016-02-05 20:14:33 -05:00
..
src doxygen: add @brief and capitalize 2016-02-05 20:14:33 -05:00
Makefile Rename TIMO -> ZEPHYR 2016-02-05 20:14:16 -05:00
prj_arm.conf Configure number of task priorities for sample projects 2016-02-05 20:13:48 -05:00
prj_x86.conf Kbuild: Updates to the microkernel config overlays. 2016-02-05 20:14:07 -05:00
prj.mdef Rename VPF files to use MDEF file extension 2016-02-05 20:14:15 -05:00
README.txt Fixed make target for running in qemu (microkernel) 2016-02-05 20:14:16 -05:00

Title: Critical section test

Description:

This test verifies that the microkernel task_offload_to_fiber() API operates as
expected.

This test has two tasks that increment a counter.  The routine that
increments the counter is invoked from K_swapper() due to the two tasks
calling task_offload_to_fiber().  The final result of the counter is expected
to be the the number of times task_offload_to_fiber() was called to increment
the counter as the incrementing was done in the context of K_swapper().

This is done with time slicing both disabled and enabled to ensure that the
result always matches the number of times task_offload_to_fiber() is called.

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

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:

tc_start() - Test Microkernel Critical Section API

Obtained expected <criticalVar> value of 10209055
Enabling time slicing ...
Obtained expected <criticalVar> value of 15123296
===================================================================
PASS - RegressionTask.
===================================================================
PROJECT EXECUTION SUCCESSFUL