zephyr/samples/microkernel/test/test_tickless
Allan Stephens e3108813cc Revise misleading instructions in sample project README.txt files
Removes the instruction directing users to issue "make pristine"
before building a sample project, as this should be unnecessary
under normal circumstances and can cause the user to unexpectedly
lose their current configuration information. In its place, a section
on troubleshooting is added that describes how to rebuild a project
using the desired configuration.

Change-Id: I4eaace2888000c3ec5d101c27a38c74c2987312e
Signed-off-by: Allan Stephens <allan.stephens@windriver.com>
2016-02-05 20:14:14 -05:00
..
src Eliminate non-standard boolean type support 2016-02-05 20:14:14 -05:00
Makefile Kbuild: Changing build parameter CONF_OVERLAY to CONF_FILE 2016-02-05 20:14:09 -05:00
prj_arm.conf samples: remove explicit enabling of SW_ISR_TABLE/DYNAMIC 2016-02-05 20:13:45 -05:00
prj_x86.conf Kbuild: Updates to the microkernel config overlays. 2016-02-05 20:14:07 -05:00
prj.vpf First commit 2015-04-10 16:44:37 -07:00
README.txt Revise misleading instructions in sample project README.txt files 2016-02-05 20:14:14 -05:00

Title:  test_tickless

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 resource 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 microkernel.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
===================================================================
VXMICRO PROJECT EXECUTION SUCCESSFUL