1 -------------------------------------------------------------------------------
3 -------------------------------------------------------------------------------
5 Flashrom is a universal flash programming utility for DIP, PLCC, or SPI
6 flash ROM chips. It can be used to flash BIOS/coreboot/firmware images.
8 (see http://coreboot.org for details on coreboot)
14 To build the flashrom utility you need to install the following packages:
17 * pciutils-devel / pciutils-dev / libpci-dev
18 * zlib-devel / zlib1g-dev
24 $ flashrom [-rwvEVfLhR] [-c chipname] [-s exclude_start] [-e exclude_end]
25 [-m [vendor:]part] [-l file.layout] [-i imagename] [file]
26 -r | --read: read flash and save into file
27 -w | --write: write file into flash (default when
29 -v | --verify: verify flash against file
30 -E | --erase: erase flash device
31 -V | --verbose: more verbose output
32 -c | --chip <chipname>: probe only for specified flash chip
33 -s | --estart <addr>: exclude start position
34 -e | --eend <addr>: exclude end postion
35 -m | --mainboard <[vendor:]part>: override mainboard settings
36 -f | --force: force write without checking image
37 -l | --layout <file.layout>: read rom layout from file
38 -i | --image <name>: only flash image name from flash layout
39 -L | --list-supported: print supported devices
40 -h | --help: print this help text
41 -R | --version: print the version (release)
43 If no file is specified, then all that happens
44 is that flash info is dumped and the flash chip is set to writable.
47 coreboot Table and Mainboard Identification
48 --------------------------------------------
50 Flashrom reads the coreboot table to determine the current mainboard
51 (parse DMI as well in future?). If no coreboot table could be read
52 or if you want to override these values, you can specify -m, e.g.:
54 $ flashrom -w --mainboard AGAMI:ARUMA agami_aruma.rom
56 See the 'Supported mainboards' section in the output of 'flashrom -L' for
57 a list of boards which require the specification of the board name, if no
58 coreboot table is found.
64 Flashrom supports ROM layouts. This allows you to flash certain parts of
65 the flash chip only. A ROM layout file looks like follows:
67 00000000:00008fff gfxrom
68 00009000:0003ffff normal
69 00040000:0007ffff fallback
72 startaddr:endaddr name
74 All addresses are offsets within the file, not absolute addresses!
76 If you only want to update the normal image in a ROM you can say:
78 flashrom -w --layout rom.layout --image normal agami_aruma.rom
80 To update normal and fallback but leave the VGA BIOS alone, say:
82 flashrom -w -l rom.layout -i normal -i fallback agami_aruma.rom
84 Currently overlapping sections are not supported.
86 ROM layouts should replace the -s and -e option since they are more
87 flexible and they should lead to a ROM update file format with the
88 ROM layout and the ROM image in one file (cpio, zip or something?).
94 Disk on Chip support was removed from flashrom in r3382. It had already
95 been disabled by default in flashrom for several years because the code
96 was considered unstable and incomplete. The products intended to work
97 have been End-Of-Lifed by the manufacturer for a long time.
100 Supported Flash Chips / Chipsets / Mainboards
101 ---------------------------------------------
103 Please check the output of 'flashrom -L' for the list of supported
104 flash chips, chipsets/southbridges, and mainboards.
106 See also http://coreboot.org/Flashrom for more details.