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 have the following packages
15 installed on your Linux system:
18 * pciutils-devel / pciutils-dev
19 * zlib-devel / zlib1g-dev
25 $ flashrom [-rwvEVfh] [-c chipname] [-s exclude_start] [-e exclude_end]
26 [-m vendor:part] [-l file.layout] [-i imagename] [file]
27 -r | --read: read flash and save into file
28 -w | --write: write file into flash (default when
30 -v | --verify: verify flash against file
31 -E | --erase: erase flash device
32 -V | --verbose: more verbose output
33 -c | --chip <chipname>: probe only for specified flash chip
34 -s | --estart <addr>: exclude start position
35 -e | --eend <addr>: exclude end postion
36 -m | --mainboard <vendor:part>: override mainboard settings
37 -f | --force: force write without checking image
38 -l | --layout <file.layout>: read rom layout from file
39 -i | --image <name>: only flash image name from flash layout
41 If no file is specified, then all that happens
42 is that flash info is dumped and the flash chip is set to writable.
45 coreboot Table and Mainboard Identification
46 --------------------------------------------
48 Flashrom reads the coreboot table to determine the current mainboard
49 (parse DMI as well in future?). If no coreboot table could be read
50 or if you want to override these values, you can specify -m, e.g.:
52 flashrom -w --mainboard AGAMI:ARUMA agami_aruma.rom
54 The following boards require the specification of the board name, if
55 no coreboot table is found:
57 * IWILL DK8-HTX: use -m iwill:dk8_htx
58 * Agami Aruma: use -m AGAMI:ARUMA
59 * ASUS P5A: use -m asus:p5a
60 * IBM x3455: use -m ibm:x3455
61 * EPoX EP-BX3: use -m epox:ep-bx3
62 * GIGABYTE GA-M57SLI-S4 v2.0: use -m gigabyte:m57sli
63 * GIGABYTE GA-M61P-S3: use -m gigabyte:m61p
64 * MSI K8N Neo3: use -m msi:k8n-neo3
65 * Acorp 6A815EPD: use -m acorp:6a815epd
71 Flashrom supports ROM layouts. This allows you to flash certain parts of
72 the flash chip only. A ROM layout file looks like follows:
74 00000000:00008fff gfxrom
75 00009000:0003ffff normal
76 00040000:0007ffff fallback
79 startaddr:endaddr name
81 All addresses are offsets within the file, not absolute addresses!
83 If you only want to update the normal image in a ROM you can say:
85 flashrom -w --layout rom.layout --image normal agami_aruma.rom
87 To update normal and fallback but leave the VGA BIOS alone, say:
89 flashrom -w -l rom.layout -i normal -i fallback agami_aruma.rom
91 Currently overlapping sections are not supported.
93 ROM layouts should replace the -s and -e option since they are more
94 flexible and they should lead to a ROM update file format with the
95 ROM layout and the ROM image in one file (cpio, zip or something?).
101 Disk on Chip support is currently disabled since it is considered unstable.
102 Change CFLAGS in the Makefile to enable it: Remove -DDISABLE_DOC from CFLAGS.
105 Supported Flash Chips
106 ---------------------
114 Intel 82802AB (Firmware Hub)
115 Intel 82802AC (Firmware Hub)
116 M-Systems MD-2802 (unsupported, disabled by default)
171 Supported Southbridges
172 ----------------------
179 Intel ICH0-ICH8 (all variations)
180 Intel PIIX4/PIIX4E/PIIX4M