README 2.85 KB
Newer Older
Uwe Hermann's avatar
Uwe Hermann committed
1 2 3
-------------------------------------------------------------------------------
Flashrom README
-------------------------------------------------------------------------------
4

Uwe Hermann's avatar
Uwe Hermann committed
5 6 7
This is the universal (LinuxBIOS) flash utility.

Build Requirements
8 9 10
------------------

To build the flashrom utility you need to have the following packages
Uwe Hermann's avatar
Uwe Hermann committed
11
installed on your Linux system:
12 13 14 15 16

* pciutils
* pciutils-devel


Uwe Hermann's avatar
Uwe Hermann committed
17
Usage
18 19
-----

20 21 22 23 24 25 26 27 28 29 30
usage: ./flashrom [-rwvEVfh] [-c chipname] [-s exclude_start]
       [-e exclude_end] [-m vendor:part] [-l file.layout] [-i imagename] [file]
   -r | --read:                    read flash and save into file
   -w | --write:                   write file into flash (default when
                                   file is specified)
   -v | --verify:                  verify flash against file
   -E | --erase:                   erase flash device
   -V | --verbose:                 more verbose output
   -c | --chip <chipname>:         probe only for specified flash chip
   -s | --estart <addr>:           exclude start position
   -e | --eend <addr>:             exclude end postion
31
   -m | --mainboard <vendor:part>: override mainboard settings
32 33 34
   -f | --force:                   force write without checking image
   -l | --layout <file.layout>:    read rom layout from file
   -i | --image <name>:            only flash image name from flash layout
35

36 37
 If no file is specified, then all that happens
 is that flash info is dumped and the flash chip is set to writable.
38 39


Uwe Hermann's avatar
Uwe Hermann committed
40
LinuxBIOS Table and Mainboard Identification
41 42
--------------------------------------------

Uwe Hermann's avatar
Uwe Hermann committed
43
Flashrom reads the LinuxBIOS table to determine the current mainboard.
44
(Parse DMI as well in future?) If no LinuxBIOS table could be read
Uwe Hermann's avatar
Uwe Hermann committed
45
or if you want to override these values, you can specify -m, e.g.:
46

Uwe Hermann's avatar
Uwe Hermann committed
47
  flashrom -w --mainboard ISLAND:ARUMA island_aruma.rom
48 49


Uwe Hermann's avatar
Uwe Hermann committed
50
ROM Layout Support
51 52
------------------

Uwe Hermann's avatar
Uwe Hermann committed
53 54
Flashrom supports ROM layouts. This allows to flash certain parts of
the flash chip only. A ROM layout file looks like follows:
55 56 57 58 59 60 61 62 63 64

  00000000:00008fff gfxrom
  00009000:0003ffff normal
  00040000:0007ffff fallback

  i.e.:
  startaddr:endaddr name

  all addresses are offsets within the file, not absolute addresses!
  
Uwe Hermann's avatar
Uwe Hermann committed
65
If you only want to update the normal image in a ROM you can say:
66 67 68

     flashrom -w --layout rom.layout --image normal island_aruma.rom
     
Uwe Hermann's avatar
Uwe Hermann committed
69
To update normal and fallback but leave the VGA BIOS alone, say:
70 71 72

     flashrom -w -l rom.layout -i normal -i fallback island_aruma.rom
 
Uwe Hermann's avatar
Uwe Hermann committed
73
Currently overlapping sections are not supported.
74

Uwe Hermann's avatar
Uwe Hermann committed
75 76 77
ROM layouts should replace the -s and -e option since they are more 
flexible and they should lead to a ROM update file format with the 
ROM layout and the ROM image in one file (cpio, zip or something?)
78 79 80 81 82 83


DOC support
-----------

DISK on Chip support is currently disabled since it is considered unstable. 
84
Change CFLAGS in the Makefile to enable it: Remove -DDISABLE_DOC from CFLAGS.
85

86