util/flashrom/README

   1 -------------------------------------------------------------------------------
   2 Flashrom README
   3 -------------------------------------------------------------------------------
   4
   5 This is the universal (LinuxBIOS) flash utility.
   6
   7 Build Requirements
   8 ------------------
   9
  10 To build the flashrom utility you need to have the following packages
  11 installed on your Linux system:
  12
  13 * pciutils
  14 * pciutils-devel / pciutils-dev
  15 * zlib-devel / zlib1g-dev
  16
  17
  18 Usage
  19 -----
  20
  21  $ flashrom [-rwvEVfh] [-c chipname] [-s exclude_start] [-e exclude_end]
  22             [-m vendor:part] [-l file.layout] [-i imagename] [file]
  23    -r | --read:                    read flash and save into file
  24    -w | --write:                   write file into flash (default when
  25                                    file is specified)
  26    -v | --verify:                  verify flash against file
  27    -E | --erase:                   erase flash device
  28    -V | --verbose:                 more verbose output
  29    -c | --chip <chipname>:         probe only for specified flash chip
  30    -s | --estart <addr>:           exclude start position
  31    -e | --eend <addr>:             exclude end postion
  32    -m | --mainboard <vendor:part>: override mainboard settings
  33    -f | --force:                   force write without checking image
  34    -l | --layout <file.layout>:    read rom layout from file
  35    -i | --image <name>:            only flash image name from flash layout
  36
  37  If no file is specified, then all that happens
  38  is that flash info is dumped and the flash chip is set to writable.
  39
  40
  41 LinuxBIOS Table and Mainboard Identification
  42 --------------------------------------------
  43
  44 Flashrom reads the LinuxBIOS table to determine the current mainboard
  45 (parse DMI as well in future?). If no LinuxBIOS table could be read
  46 or if you want to override these values, you can specify -m, e.g.:
  47
  48   flashrom -w --mainboard AGAMI:ARUMA agami_aruma.rom
  49
  50 The following boards require the specification of the board name, if
  51 no LinuxBIOS table is found:
  52
  53 * IWILL DK8-HTX: use -m iwill:dk8_htx
  54 * Agami Aruma: use -m AGAMI:ARUMA
  55 * ASUS P5A: use -m asus:p5a
  56 * IBM x3455: use -m ibm:x3455
  57 * EPoX EP-BX3: use -m epox:ep-bx3
  58 * GIGABYTE GA-M57SLI-S4 v2.0: use -m gigabyte:m57sli
  59 * GIGABYTE GA-M61P-S3: use -m gigabyte:m61p
  60 * MSI K8N Neo3: use -m msi:k8n-neo3
  61 * Acorp 6A815EPD: use -m acorp:6a815epd
  62
  63
  64 ROM Layout Support
  65 ------------------
  66
  67 Flashrom supports ROM layouts. This allows to flash certain parts of
  68 the flash chip only. A ROM layout file looks like follows:
  69
  70   00000000:00008fff gfxrom
  71   00009000:0003ffff normal
  72   00040000:0007ffff fallback
  73
  74   i.e.:
  75   startaddr:endaddr name
  76
  77   All addresses are offsets within the file, not absolute addresses!
  78
  79 If you only want to update the normal image in a ROM you can say:
  80
  81   flashrom -w --layout rom.layout --image normal agami_aruma.rom
  82
  83 To update normal and fallback but leave the VGA BIOS alone, say:
  84
  85   flashrom -w -l rom.layout -i normal -i fallback agami_aruma.rom
  86
  87 Currently overlapping sections are not supported.
  88
  89 ROM layouts should replace the -s and -e option since they are more
  90 flexible and they should lead to a ROM update file format with the
  91 ROM layout and the ROM image in one file (cpio, zip or something?).
  92
  93
  94 Disk on Chip support
  95 --------------------
  96
  97 Disk on Chip support is currently disabled since it is considered unstable.
  98 Change CFLAGS in the Makefile to enable it: Remove -DDISABLE_DOC from CFLAGS.
  99
 100
 101 Supported Flash Chips
 102 ---------------------
 103
 104 AMD AM-29F040B
 105 AMD AM-29F016D
 106 ASD AE49F2008
 107 Atmel AT-29C040A
 108 Atmel AT-29C020
 109 EMST F49B002UA
 110 Intel 82802AB (Firmware Hub)
 111 Intel 82802AC (Firmware Hub)
 112 M-Systems MD-2802 (unsupported, disabled by default)
 113 MX MX-29F002
 114 PMC PMC-49FL002
 115 PMC PMC-49FL004
 116 Sharp LHF-00L04
 117 SST SST-29EE020A
 118 SST SST-28SF040A
 119 SST SST-39SF010A
 120 SST SST-39SF020A
 121 SST SST-39SF040
 122 SST SST-39VF020
 123 SST SST-49LF040B
 124 SST SST-49LF040
 125 SST SST-49LF020A
 126 SST SST-49LF080A
 127 SST SST-49LF160C
 128 SST SST-49LF002A/B
 129 SST SST-49LF003A/B
 130 SST SST-49LF004A/B
 131 SST SST-49LF008A
 132 SST SST-49LF004C
 133 SST SST-49LF008C
 134 SST SST-49LF016C
 135 ST ST-M50FLW040A
 136 ST ST-M50FLW040B
 137 ST ST-M50FLW080A
 138 ST ST-M50FLW080B
 139 ST ST-M50FW040
 140 ST ST-M50FW080
 141 ST ST-M50FW016
 142 ST ST-M50LPW116
 143 ST ST-M29F002B
 144 ST ST-M29F002T
 145 ST ST-M29F002NT
 146 ST ST-M29F400BT
 147 ST ST-M29F040B
 148 ST ST-M29W010B
 149 ST ST-M29W040B
 150 SyncMOS S29C51001T/B
 151 SyncMOS S29C51002T/B
 152 SyncMOS S29C51004T/B
 153 SyncMOS S29C31004T
 154 Winbond W29C011
 155 Winbond W29C020C
 156 Winbond W29C040P
 157 Winbond W29EE011
 158 Winbond W49F002U
 159 Winbond W49V002A
 160 Winbond W49V002FA
 161 Winbond W39V040FA
 162 Winbond W39V040A
 163 Winbond W39V040B
 164 Winbond W39V080A
 165
 166
 167 Supported Southbridges
 168 ----------------------
 169
 170 AMD CS5530/CS5530A
 171 AMD Geode SC1100
 172 AMD AMD-8111
 173 ATI SB400
 174 Broadcom HT-1000
 175 Intel ICH0-ICH8 (all variations)
 176 Intel PIIX4/PIIX4E/PIIX4M
 177 NVIDIA CK804
 178 NVIDIA MCP51
 179 NVIDIA MCP55
 180 SiS 630
 181 SiS 5595
 182 VIA CX700
 183 VIA VT8231
 184 VIA VT8235
 185 VIA VT8237
 186 VIA VT82C686
 187