============================================
    Linux-ready firmware developer kit:
              HOWTO RUN STANDALONE
============================================

CONTENTS
---------

1. Creating stand-lone self-extracting script to run tests on an already running Linux distro
2. Compile and run individual tests on running Linux distro

----------------------------------------------------------------------------------------------
1. Creating stand-lone self-extracting script to run tests on an already running Linux distro
----------------------------------------------------------------------------------------------

- # cd linuxfirmwarekit/
- # make iso
- This will create a script: linuxfirmwarekit/initramfs/firmwarekit.sh
- # cd linuxfirmwarekit/initramfs
- # sh firmwarekit.sh;
- This will extract the iso image, chroot into it, and run the tests (no shutdown or restart 
occurs)


------------------------------------------------------------
2. Compile and run individual tests on running Linux distro
------------------------------------------------------------

- Each test is contained in its own dir (e.g. battery/ cpufreq/ fan/, etc.)
- Either run 'make' in root dir to compile all tests, or cd into the individual's 
  test dir and run 'make'
- The resulting binaries will be copied into the plugins/ dir
- Execute .exe, .sh or .pl.  Preface with DEBUG=1 to output readable (non-hex) 
  output of tests.
  e.g. # DEBUG=1 ./fan.exe
- ( note, make sure you can link with linuxfirmwarekit/libstandalone.so )


* Root user note: Running with 'root' privileges will provide best results


Contributer:   Rolla Selbak (rolla.n.selbak@intel.com)


