------------------------------------------------------------------------------- Flashrom README ------------------------------------------------------------------------------- Flashrom is a universal flash programming utility for DIP, PLCC, or SPI flash ROM chips. It can be used to flash BIOS/coreboot/firmware images. (see http://coreboot.org for details on coreboot) Build Requirements ------------------ To build the flashrom utility you need to have the following packages installed on your Linux system: * pciutils * pciutils-devel / pciutils-dev * zlib-devel / zlib1g-dev 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 : probe only for specified flash chip -s | --estart : exclude start position -e | --eend : exclude end postion -m | --mainboard <[vendor:]part>: override mainboard settings -f | --force: force write without checking image -l | --layout : read rom layout from file -i | --image : only flash image name from flash layout If no file is specified, then all that happens is that flash info is dumped and the flash chip is set to writable. coreboot Table and Mainboard Identification -------------------------------------------- Flashrom reads the coreboot table to determine the current mainboard (parse DMI as well in future?). If no coreboot table could be read or if you want to override these values, you can specify -m, e.g.: flashrom -w --mainboard AGAMI:ARUMA agami_aruma.rom The following boards require the specification of the board name, if no coreboot table is found: * IWILL DK8-HTX: use -m iwill:dk8_htx * Agami Aruma: use -m AGAMI:ARUMA * ASUS P5A: use -m asus:p5a * IBM x3455: use -m ibm:x3455 * EPoX EP-BX3: use -m epox:ep-bx3 * GIGABYTE GA-M57SLI-S4 v2.0: use -m gigabyte:m57sli * GIGABYTE GA-M61P-S3: use -m gigabyte:m61p * MSI K8N Neo3: use -m msi:k8n-neo3 * Acorp 6A815EPD: use -m acorp:6a815epd ROM Layout Support ------------------ Flashrom supports ROM layouts. This allows you to flash certain parts of the flash chip only. A ROM layout file looks like follows: 00000000:00008fff gfxrom 00009000:0003ffff normal 00040000:0007ffff fallback i.e.: startaddr:endaddr name All addresses are offsets within the file, not absolute addresses! If you only want to update the normal image in a ROM you can say: flashrom -w --layout rom.layout --image normal agami_aruma.rom To update normal and fallback but leave the VGA BIOS alone, say: flashrom -w -l rom.layout -i normal -i fallback agami_aruma.rom Currently overlapping sections are not supported. 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?). Disk on Chip support -------------------- Disk on Chip support is currently disabled since it is considered unstable. Change CFLAGS in the Makefile to enable it: Remove -DDISABLE_DOC from CFLAGS. Supported Flash Chips --------------------- AMD AM-29F040B AMD AM-29F016D ASD AE49F2008 Atmel AT-29C040A Atmel AT-29C020 EMST F49B002UA Intel 82802AB (Firmware Hub) Intel 82802AC (Firmware Hub) M-Systems MD-2802 (unsupported, disabled by default) MX MX-29F002 PMC PMC-49FL002 PMC PMC-49FL004 Sharp LHF-00L04 Spansion S25FL016A SST SST-29EE020A SST SST-28SF040A SST SST-39SF010A SST SST-39SF020A SST SST-39SF040 SST SST-39VF020 SST SST-49LF040B SST SST-49LF040 SST SST-49LF020A SST SST-49LF080A SST SST-49LF160C SST SST-49LF002A/B SST SST-49LF003A/B SST SST-49LF004A/B SST SST-49LF008A SST SST-49LF004C SST SST-49LF008C SST SST-49LF016C ST ST-M50FLW040A ST ST-M50FLW040B ST ST-M50FLW080A ST ST-M50FLW080B ST ST-M50FW040 ST ST-M50FW080 ST ST-M50FW016 ST ST-M50LPW116 ST ST-M29F002B ST ST-M29F002T ST ST-M29F002NT ST ST-M29F400BT ST ST-M29F040B ST ST-M29W010B ST ST-M29W040B SyncMOS S29C51001T/B SyncMOS S29C51002T/B SyncMOS S29C51004T/B SyncMOS S29C31004T Winbond W29C011 Winbond W29C020C Winbond W29C040P Winbond W29EE011 Winbond W49F002U Winbond W49V002A Winbond W49V002FA Winbond W39V040FA Winbond W39V040A Winbond W39V040B Winbond W39V080A Supported Southbridges ---------------------- AMD CS5530/CS5530A AMD Geode SC1100 AMD AMD-8111 ATI SB400 Broadcom HT-1000 Intel ICH0-ICH8 (all variations) Intel PIIX4/PIIX4E/PIIX4M NVIDIA CK804 NVIDIA MCP51 NVIDIA MCP55 SiS 630 SiS 5595 VIA CX700 VIA VT8231 VIA VT8235 VIA VT8237 VIA VT82C686