zephyr

History

Anas Nashif ea0d0b220c doxygen: change comment style to match javadoc The change replaces multiple asterisks to ** at the beginning of comments and adds a space before the asterisks at the beginning of lines. Change-Id: I7656bde3bf4d9a31e38941e43b580520432dabc1 Signed-off-by: Anas Nashif <anas.nashif@intel.com>		2016-02-05 20:14:32 -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	doxygen: change comment style to match javadoc	2016-02-05 20:14:32 -05:00
Makefile	Rename TIMO -> ZEPHYR	2016-02-05 20:14:16 -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

README.txt

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 qemu

    make BOOTTIME_QUALIFIER=default qemu

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