zephyr/samples/microkernel/test/test_tickless
Peter Mitsis 5fe44f42ba Update Title in sample project README.txt files
Assigns more descriptive titles to the sample project README.txt files.

Change-Id: I4a0efdac481a8ed75a847871dbfe686e74a9f113
Signed-off-by: Peter Mitsis <peter.mitsis@windriver.com>
2016-02-05 20:15:21 -05:00
..
src Remove references to BSPs from sample projects 2016-02-05 20:14:43 -05:00
Makefile Renames supported platform configurations 2016-02-05 20:14:39 -05:00
README.txt Update Title in sample project README.txt files 2016-02-05 20:15:21 -05:00
prj.mdef Rename VPF files to use MDEF file extension 2016-02-05 20:14:15 -05:00
prj_arm.conf
prj_x86.conf Kbuild: Updates to the microkernel config overlays. 2016-02-05 20:14:07 -05:00
testcase.ini initial commit for next-gen sanity checks 2016-02-05 20:14:42 -05:00

README.txt

Title: Tickless Idle Support

Description:

This test verifies the timing accuracy of the tickless idle feature.

The test first calibrates itself by repeatedly sleeping for 10 ticks with the
tickless idle feature disabled.  It then repeats this process with the tickless
idle feature enabled.  Lastly, it compares the average measured duration of
each approach and displays the result.  The tick timing is correct if the
'diff ticks' with tickless enabled matches the SLEEP_TICKS (10) setting in
the source.

The demonstration utilizes microkernel mutex APIs, timers and tickless
idle mode.

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

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:

Tickless Idle Test
Calibrating TSC...
Calibrated time stamp period = 0x00000000163adc3a
Do the real test with tickless enabled
Going idle for 10 ticks...
start ticks     : 343
end   ticks     : 353
diff  ticks     : 10
diff  time stamp: 0x0000000018a69898
Cal   time stamp: 0x00000000163adc3a
variance in time stamp diff: 10 percent
===================================================================
PROJECT EXECUTION SUCCESSFUL