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 usage: ./flashrom [-rwvEVfh] [-c chipname] [-s exclude_start]
  22        [-e exclude_end] [-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 ISLAND:ARUMA island_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
  59
  60 ROM Layout Support
  61 ------------------
  62
  63 Flashrom supports ROM layouts. This allows to flash certain parts of
  64 the flash chip only. A ROM layout file looks like follows:
  65
  66   00000000:00008fff gfxrom
  67   00009000:0003ffff normal
  68   00040000:0007ffff fallback
  69
  70   i.e.:
  71   startaddr:endaddr name
  72
  73   all addresses are offsets within the file, not absolute addresses!
  74
  75 If you only want to update the normal image in a ROM you can say:
  76
  77      flashrom -w --layout rom.layout --image normal island_aruma.rom
  78
  79 To update normal and fallback but leave the VGA BIOS alone, say:
  80
  81      flashrom -w -l rom.layout -i normal -i fallback island_aruma.rom
  82
  83 Currently overlapping sections are not supported.
  84
  85 ROM layouts should replace the -s and -e option since they are more
  86 flexible and they should lead to a ROM update file format with the
  87 ROM layout and the ROM image in one file (cpio, zip or something?)
  88
  89
  90 DOC support
  91 -----------
  92
  93 DISK on Chip support is currently disabled since it is considered unstable.
  94 Change CFLAGS in the Makefile to enable it: Remove -DDISABLE_DOC from CFLAGS.
  95
  96
  97 Supported Flash Chips
  98 ---------------------
  99
 100 AMD AM-29F040B
 101 AMD AM-29F016D
 102 ASD AE49F2008
 103 Atmel AT-29C040A
 104 Atmel AT-29C020
 105 EMST F49B002UA
 106 Intel 82802AB (Firmware Hub)
 107 Intel 82802AC (Firmware Hub)
 108 M-Systems MD-2802 (unsupported, disabled by default)
 109 MX MX-29F002
 110 PMC PMC-49FL002
 111 PMC PMC-49FL004
 112 Sharp LHF-00L04
 113 SST SST-29EE020A
 114 SST SST-28SF040A
 115 SST SST-39SF010A
 116 SST SST-39SF020A
 117 SST SST-39SF040
 118 SST SST-39VF020
 119 SST SST-49LF040B
 120 SST SST-49LF040
 121 SST SST-49LF020A
 122 SST SST-49LF080A
 123 SST SST-49LF160C
 124 SST SST-49LF002A/B
 125 SST SST-49LF003A/B
 126 SST SST-49LF004A/B
 127 SST SST-49LF008A
 128 SST SST-49LF004C
 129 SST SST-49LF008C
 130 SST SST-49LF016C
 131 ST ST-M50FLW040A
 132 ST ST-M50FLW040B
 133 ST ST-M50FLW080A
 134 ST ST-M50FLW080B
 135 ST ST-M50FW040
 136 ST ST-M50FW080
 137 ST ST-M50FW016
 138 ST ST-M50LPW116
 139 ST ST-M29F002B
 140 ST ST-M29F002T
 141 ST ST-M29F002NT
 142 ST ST-M29F400BT
 143 ST ST-M29F040B
 144 ST ST-M29W010B
 145 ST ST-M29W040B
 146 SyncMOS S29C51001T/B
 147 SyncMOS S29C51002T/B
 148 SyncMOS S29C51004T/B
 149 SyncMOS S29C31004T
 150 Winbond W29C011
 151 Winbond W29C020C
 152 Winbond W29C040P
 153 Winbond W49F002U
 154 Winbond W49V002A
 155 Winbond W49V002FA
 156 Winbond W39V040FA
 157 Winbond W39V040A
 158 Winbond W39V040B
 159 Winbond W39V080A
 160
 161
 162 Supported Southbridges
 163 ----------------------
 164
 165 AMD CS5530/CS5530A
 166 AMD Geode SC1100
 167 AMD AMD-8111
 168 ATI SB400
 169 Broadcom HT-1000
 170 Intel ICH0-ICH8 (all variations)
 171 Intel PIIX4/PIIX4E/PIIX4M
 172 NVIDIA CK804
 173 NVIDIA MCP51
 174 NVIDIA MCP55
 175 SiS 630
 176 SiS 5595
 177 VIA CX700
 178 VIA VT8231
 179 VIA VT8235
 180 VIA VT8237
 181 VIA VT82C686
 182