Gitiles
Code Review Sign In
review.sourcearcade.org / flashprog / fc7fbdd3fcdb893d4e55d0c7d56f988e52f5cfba / . / README
blob: fd91cb6f5504b9a3d2da19aa557be02fa712d39c [file] [log] [blame]
Ollie Lho184a4042005-11-26 21:55:36 +0000[diff] [blame]1This is the universal LinuxBIOS flash utility.
Ronald G. Minnich1e5003f2002-04-10 18:02:07 +0000[diff] [blame]2
Stefan Reinauer06b2c4d2005-12-01 10:51:08 +0000[diff] [blame]3build requirements
4------------------
5
6To build the flashrom utility you need to have the following packages
7installed on your linux system:
8
9* pciutils
10* pciutils-devel
11
12
13usage
14-----
15
Ollie Lho184a4042005-11-26 21:55:36 +0000[diff] [blame]16usage: ./flashrom [-rwvE] [-V] [-c chipname]
17 [-s exclude_start] [-e exclude_end] [file]
Ronald G. Minnich1e5003f2002-04-10 18:02:07 +0000[diff] [blame]18
Ollie Lho184a4042005-11-26 21:55:36 +0000[diff] [blame]19 -r | --read: read flash and save into file
20 -w | --write: write file into flash (default when file is specified)
21 -v | --verify: verify flash against file
22 -E | --erase: Erase flash device
23 -V | --verbose: more verbose output
Ronald G. Minnich5e5f75e2002-01-29 18:21:41 +0000[diff] [blame]24
Ollie Lho184a4042005-11-26 21:55:36 +0000[diff] [blame]25 -c | --chip <chipname>: probe only for specified flash chip
26 -s | --estart <addr>: exclude start position
27 -e | --eend <addr>: exclude end postion
28 -m | --mainboard <vendor:part>: override mainboard settings
29 -l | --layout <file.layout>: read rom layout from file
30 -i | --image <name>: only flash image name from flash layout
Ronald G. Minnich5e5f75e2002-01-29 18:21:41 +0000[diff] [blame]31
Ollie Lho184a4042005-11-26 21:55:36 +0000[diff] [blame]32 If no file is specified, then all that happens
33 is that flash info is dumped and the flash chip is set to writable.
Ronald G. Minnich5e5f75e2002-01-29 18:21:41 +0000[diff] [blame]34
Ronald G. Minnich5e5f75e2002-01-29 18:21:41 +0000[diff] [blame]35
Ollie Lho184a4042005-11-26 21:55:36 +0000[diff] [blame]36LinuxBIOS table and Mainboard identification
37--------------------------------------------
Ronald G. Minnich5e5f75e2002-01-29 18:21:41 +0000[diff] [blame]38
Ollie Lho184a4042005-11-26 21:55:36 +0000[diff] [blame]39flashrom reads the LinuxBIOS table to determine the current mainboard.
40(Parse DMI as well in future?) If no LinuxBIOS table could be read
41or if you want to override these values, you can to specify -m ie.:
42
43 flashrom -w --mainboard ISLAND:ARUMA island_aruma.rom
44
45
46rom layout support
47------------------
48
49flashrom supports rom layouts. This allows to flash certain parts of
50the flash chip only. A rom layout file looks like follows:
51
52 00000000:00008fff gfxrom
53 00009000:0003ffff normal
54 00040000:0007ffff fallback
55
56 i.e.:
57 startaddr:endaddr name
58
59 all addresses are offsets within the file, not absolute addresses!
60
61If you only want to update the normal image in a rom you can say:
62
63 flashrom -w --layout rom.layout --image normal island_aruma.rom
64
65To update normal and fallback but leave the vga bios alone, say:
66
67 flashrom -w -l rom.layout -i normal -i fallback island_aruma.rom
68
69Currently overlapping sections are not spported.
70
71rom layouts should replace the -s and -e option since they are more
72flexible and they should lead to a rom update file format with the
73rom layout and the rom image in one file (cpio, zip or something?)
74
75
76DOC support
77-----------
78
79DISK on Chip support is currently disabled since it is considered unstable.
80Change CFLAGS in the Makefile to enable it.
81
82