zephyr/samples/microkernel/benchmark/boot_time
Allan Stephens 57de8be493 Eliminate VxMicro branding in sample projects
Eliminates references to the obsolete OS name. In most cases the name
is simply removed, as it isn't necessary.

Change-Id: I3796f2aebe802f8c6045b7424a3e7aab4d5fb8e8
Signed-off-by: Allan Stephens <allan.stephens@windriver.com>
2016-02-05 20:14:15 -05:00
..
generic_pc Kbuild: metrics config dependency resolved 2016-02-05 20:14:08 -05:00
quark Kbuild: Fix sanity checks for quark 2016-02-05 20:14:08 -05:00
src Eliminate VxMicro branding in sample projects 2016-02-05 20:14:15 -05:00
Makefile Kbuild: Changing build parameter CONF_OVERLAY to CONF_FILE 2016-02-05 20:14:09 -05:00
prj.vpf Get rid of VxMicro-specific warning from VPF files 2016-02-05 20:14:15 -05:00
README.txt Eliminate VxMicro branding in sample project output 2016-02-05 20:14:15 -05:00

Title:  BootTime

Description:

BootTime measures the time:
   a) from system reset to kernel start (crt0.s's __start)
   b) from kernel start to begin of main()
   c) from kernel start to begin of first task
   d) from kernel start to when microkernel's main task goes immediately idle

The project can be built using one of the following three configurations:

best
-------
 - Disables most features
 - Provides best case boot measurement

default
-------
 - Default configuration options
 - Provides typical boot measurement

worst
-------
 - Enables most features.
 - Provides worst case boot measurement

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

Building and Running Project:

This microkernel project outputs to the console.  It can be built and executed
on QEMU in three possibile configurations as follows:

    make BOOTTIME_QUALIFIER=best microkernel.qemu

    make BOOTTIME_QUALIFIER=default microkernel.qemu

    make BOOTTIME_QUALIFIER=worst 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:

tc_start() - Boot Time Measurement
MicroKernel Boot Result: Clock Frequency: 20 MHz
__start       : 377787 cycles, 18889 us
_start->main(): 3915 cycles, 195 us
_start->task  : 5898 cycles, 294 us
_start->idle  : 6399 cycles, 319 us
Boot Time Measurement finished
===================================================================
PASS - bootTimeTask.
===================================================================
PROJECT EXECUTION SUCCESSFUL