zephyr

History

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	Use ccflags-y and asflags-y instead of EXTRA_CFLAGS	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_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

README.txt

Title: test_fp_sharing

Description:

This test uses two tasks to independently compute pi, while two other tasks
load and store floating point registers and check for corruption. This tests
the ability of tasks to safely share floating point hardware resources, even
when switching occurs preemptively. (Note that both sets of tests run
concurrently even though they report their progress at different times.)

The demonstration utilizes microkernel resource APIs, timers, semaphores,
round robin scheduling, and floating point support.

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

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:

Floating point sharing tests started
===================================================================
Pi calculation OK after 50 (high) + 1 (low) tests (computed 3.141594)
Load and store OK after 100 (high) + 29695 (low) tests
Pi calculation OK after 150 (high) + 2 (low) tests (computed 3.141594)
Load and store OK after 200 (high) + 47593 (low) tests
Pi calculation OK after 250 (high) + 4 (low) tests (computed 3.141594)
Load and store OK after 300 (high) + 66674 (low) tests
Pi calculation OK after 350 (high) + 5 (low) tests (computed 3.141594)
Load and store OK after 400 (high) + 83352 (low) tests
Pi calculation OK after 450 (high) + 7 (low) tests (computed 3.141594)
Load and store OK after 500 (high) + 92290 (low) tests
===================================================================
VXMICRO PROJECT EXECUTION SUCCESSFUL