FirmwareTestSuiteLive

Differences between revisions 8 and 9
Revision 8 as of 2011-12-17 20:11:18
Size: 5107
Editor: cpe-174-109-107-185
Comment:
Revision 9 as of 2011-12-17 20:12:29
Size: 5104
Editor: cpe-174-109-107-185
Comment:
Deletions are marked like this. Additions are marked like this.
Line 31: Line 31:
And copy the image to the USB stick. For example, for the 64 bit image fwts-live-oneiric-amd64-usb-hdd-20111129-3.img we use: And copy the image to the USB stick. For example, for the 64 bit image fwts-live-oneiric-amd64-usb-hdd-20111217-0.img we use:
Line 33: Line 33:
    $ sudo dd if=fwts-live-oneiric-amd64-usb-hdd-20111217-0.img.gz of=/dev/sdb && sync     $ sudo dd if=fwts-live-oneiric-amd64-usb-hdd-20111217-0.img of=/dev/sdb && sync

fwts-live

http://odm.ubuntu.com/fwts-live/screenshots/fwts-live-0.png

Overview

fwts-live is a bootable USB image that will automatically boot and run the Firmware Test Suite on both legacy BIOS as well as native UEFI Firmware. The test results are stored on the USB device and can be analysed on the fly or later on another computer.

Have a look at a quick demo of fwts-live booting and executing tests within QEMU

Preparation

1. Download either the 32 bit or 64 bit image from http://odm.ubuntu.com/fwts-live/

2. Unzip the image using bunzip2, e.g.

    $ bzip2 -d fwts-live-oneiric-*.img.bz2

3. Insert a USB stick into your machine, and unmount it.

4. Copy the live image to the USB stick, you can find out the device using:

    $ dmesg | tail -10 | grep Attached
      [ 9705.954616] sd 5:0:0:0: [sdb] Attached SCSI removable disk

... in the above example it is /dev/sdb

And copy the image to the USB stick. For example, for the 64 bit image fwts-live-oneiric-amd64-usb-hdd-20111217-0.img we use:

    $ sudo dd if=fwts-live-oneiric-amd64-usb-hdd-20111217-0.img of=/dev/sdb && sync

5. Remove the USB stick.

Running the live image

Insert the USB stick into the machine you want to test and boot the machine. You may need to modify the BIOS settings to boot from the USB stick. You will see the following boot screen, wait a few moments and the boot will proceed.

http://odm.ubuntu.com/fwts-live/screenshots/fwts-live-1.png

After a while, you will be presented with the following screen:

http://odm.ubuntu.com/fwts-live/screenshots/fwts-live-2.png

You may chose to either run all the fwts batch tests, or select individual tests to run, or abort testing altogether. To navigate the menu press the cursor up/down keys and press the space key to toggle the selection. Press the enter key to confirm the selection.

Running all the batch tests

The "All Batch Tests" option will make fwts run all the batch tests automatically. This is the simplest and easiest way of using this tool. It will take few minutes to run through all the tests.

After selecting the "All Batch Tests" from the menu, the tests will start and you will see a progress dialog box:

http://odm.ubuntu.com/fwts-live/screenshots/fwts-live-3.png

and once the tests are all complete, you can opt to view the results log:

http://odm.ubuntu.com/fwts-live/screenshots/fwts-live-4.png

one can then look at the results log by pressing enter to select < Yes > and you will then be presented with a view of the results log:

http://odm.ubuntu.com/fwts-live/screenshots/fwts-live-5.png

You can navigate up/down using the cursor up/down and page up/down keys. Also one can scroll left/right using the cursor left/right keys. Press the enter key to select the < EXIT > button and exit the log viewer.

The tests are now complete and you will be see the following dialog box that will inform you the path name to the results.log on the USB stick and you can then press enter to shutdown the machine.

http://odm.ubuntu.com/fwts-live/screenshots/fwts-live-6.png

So, in the above example, if you later plug the USB stick into Ubuntu, you will find the results in /media/OEM_BUILD/fwts/11102011/1327/results.log. On a Windows machine, if this USB stick is mounted on drive D: you would find the log in D:\fwts\11102011\1327\results.log

Running individual tests

The "Select Individual Tests" option will allow you to select specific fwts tests. Once selected you will be presented with a scrollable menu of the available tests to run:

http://odm.ubuntu.com/fwts-live/screenshots/fwts-live-7.png

To navigate the menu press the cursor up/down keys and press the space key to toggle the selections. Press the enter key to run the test(s). You may select one or more tests.

You will then see a progress dialog box and then the option to see the results log, as described in the "Running all the batch tests" section above.

Interpreting the Results

The FWTS reference guide describes in detail each test and the errors that the test may find. Alternatively, the results.log can be copied from the USB stick and sent to Canonical for an engineer to analyse and diagnose any faults that need fixing in the firmware.

Sub-pages:

FirmwareTestSuite/FirmwareTestSuiteLive (last edited 2023-10-03 08:26:00 by ivan.hu)