============================================
    Linux-ready firmware developer kit:
                 USER GUIDE
============================================

CONTENTS
---------

1. How to run the test-kit (using CD)
2. How to navigate in the Test Results page
3. How to run Interactive Tests
4. How to run Hardware Poke Tests

---------------------------------------
1. How to run the test-kit (using CD)
---------------------------------------

- Make sure your BIOS is set up to boot from your cd-rom drive.

- Insert the CD into your cd-rom drive and boot from the CD itself.

- Once booted, you will have 4 choices:
	#1- To run the test suite, simply press [ENTER].  (If nothing is entered, the default 
	    will be this option)
	#2- To run the test suite in safe-mode (i.e. no ACPI interrupt routing), type "safe".
	#3- To run the test suite over a serial console (settings: 115200/8N1), type "serial".
	#4- To boot from your local harddisk (and not run the test suite), type "local".

		*NOTE: In general, #1 is the option you want to use.

- The Welcome Screen will be displayed for around 6 secs, then the test suite execution will start automatically.  As each test is being run, you will see a progress-bar indicating its status.

- Once the test suite is complete, you will be taken to an interactive Test Results page, displaying the results of the test suite and allowing for further manual and interactive tests.

---------------------------------------------
2. How to navigate in the Test Results page
---------------------------------------------

- After the test suite has been run (see section #1. How to run the test-kit (using CD)), you will then be taken to the Test Results page. Use the [TAB] and arrow keys to navigate throughout this page.

- Scrolling up and down the test results, you can press [ENTER] on any line-item to get more details.  

- The format of the test results displayed is:

		[  SCORE  ] < TEST DESCRIPTION >
		[SUB-SCORE] < SUB-TEST DESCRIPTION >

 where

		TEST DESCRIPTION = description of the main tests that were run
		SUB-TEST DESCRIPTION = description of the sub-tests run under the main tests
		SCORE = WARN | FAIL | PASS | INFO
		SUB-SCORE = W | F | <none>

- Once you have analyzed the test results, you can choose to save these results either to a USB key or via ssh.  For USB, insert a USB key into a USB port, choose 'Save', then 'Save to USB'. For ssh, choose 'Save', then 'Save via SSH', then follow the "HOWTO_SSHCopyResults.txt" doc for details.

- If you wish to exit testing, choose "Exit".  If you want to continue with some interactive manual testing or hardware pokes, continue to the next section.

---------------------------------
3. How to run Interactive Tests
---------------------------------

- On the Test Results page, choose "Interactive".  This will give you the chance of running the following interactive tests (press [ENTER] to start any of these tests and follow the instructions):

	* Suspend/Resume (this will suspend-to-ram, trigger wake-up like you usually would)
	* lmbench version 3
	* Bash Linux shell
	* Speaker test
	* USB port validation

-----------------------------------
4. How to run Hardware Poke Tests
-----------------------------------

- On the Test Results page, choose "Poke HW".  This will give you the chance of running the following hardware pokes (press [ENTER] to start any of these tests and follow the instructions):

	* MSR registers
	* PCI Configuration space



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


