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