coreboot-kgpe-d16/util/flashrom
Ed Swierk 3ecf5002b3 Currently the flashrom Makefile tries to detect whether pciutils-devel
is installed, but the test also fails if zlib-devel is missing. This
patch changes the error message accordingly.

Signed-off-by: Ed Swierk <eswierk@arastra.com>
Signed-off-by: Uwe Hermann <uwe@hermann-uwe.de>
Acked-by: Uwe Hermann <uwe@hermann-uwe.de>



git-svn-id: svn://svn.coreboot.org/coreboot/trunk@2553 2b7e53f0-3cfb-0310-b3e9-8179ed1497e1
2007-02-16 14:36:12 +00:00
..
82802ab.c This patch is a rework of Adam Kaufman's Solaris patch. 2007-02-06 19:47:50 +00:00
82802ab.h flasrom update from Stefan, resovle issue 21 2005-11-26 21:55:36 +00:00
Makefile Currently the flashrom Makefile tries to detect whether pciutils-devel 2007-02-16 14:36:12 +00:00
README Add support for the SST 49LF160C. 2007-01-27 13:39:06 +00:00
am29f040b.c make am29f040b driver more solid by printing every 4096th flash address. 2006-03-16 16:46:19 +00:00
am29f040b.h flasrom update from Stefan, resovle issue 21 2005-11-26 21:55:36 +00:00
debug.h * make -v switch print debug messages. 2005-12-18 16:41:10 +00:00
flash.h This patch is a rework of Adam Kaufman's Solaris patch. 2007-02-06 19:47:50 +00:00
flash_enable.c This patch is a rework of Adam Kaufman's Solaris patch. 2007-02-06 19:47:50 +00:00
flash_rom.c This patch is a rework of Adam Kaufman's Solaris patch. 2007-02-06 19:47:50 +00:00
flashchips.c Add support for the SST 49LF160C. 2007-01-27 13:39:06 +00:00
flashrom.1 Improve flashrom description in the manpage a bit (trivial). 2006-12-20 14:59:56 +00:00
jedec.c apply patch from Giampiero Giancipoli <gianci@email.it>: 2006-11-22 00:29:51 +00:00
jedec.h flasrom update from Stefan, resovle issue 21 2005-11-26 21:55:36 +00:00
layout.c redo image checking in conversion case. Please update to this 2005-12-18 18:40:46 +00:00
layout.h flasrom update from Stefan, resovle issue 21 2005-11-26 21:55:36 +00:00
lbtable.c Include src/include/boot/linuxbios_tables.h in the flashrom source 2007-02-06 19:53:51 +00:00
lbtable.h flasrom update from Stefan, resovle issue 21 2005-11-26 21:55:36 +00:00
linuxbios_tables.h Include src/include/boot/linuxbios_tables.h in the flashrom source 2007-02-06 19:53:51 +00:00
m29f400bt.c Removing $Id$ tags as they have no meaning in SVN 2006-08-23 14:33:54 +00:00
m29f400bt.h flasrom update from Stefan, resovle issue 21 2005-11-26 21:55:36 +00:00
msys_doc.c flasrom update from Stefan, resovle issue 21 2005-11-26 21:55:36 +00:00
msys_doc.h flasrom update from Stefan, resovle issue 21 2005-11-26 21:55:36 +00:00
mx29f002.c Removing $Id$ tags as they have no meaning in SVN 2006-08-23 14:33:54 +00:00
mx29f002.h flasrom update from Stefan, resovle issue 21 2005-11-26 21:55:36 +00:00
pm49fl004.c flasrom update from Stefan, resovle issue 21 2005-11-26 21:55:36 +00:00
pm49fl004.h flasrom update from Stefan, resovle issue 21 2005-11-26 21:55:36 +00:00
rom.layout flasrom update from Stefan, resovle issue 21 2005-11-26 21:55:36 +00:00
sharplhf00l04.c This patch is a rework of Adam Kaufman's Solaris patch. 2007-02-06 19:47:50 +00:00
sharplhf00l04.h Fix for nehemiah 2006-03-14 19:58:14 +00:00
sst28sf040.c flasrom update from Stefan, resovle issue 21 2005-11-26 21:55:36 +00:00
sst28sf040.h flasrom update from Stefan, resovle issue 21 2005-11-26 21:55:36 +00:00
sst39sf020.c Removing $Id$ tags as they have no meaning in SVN 2006-08-23 14:33:54 +00:00
sst39sf020.h flasrom update from Stefan, resovle issue 21 2005-11-26 21:55:36 +00:00
sst49lf040.c Fix flashrom for sst49lf080a and small print bug, 2006-10-07 00:21:13 +00:00
sst49lf040.h flasrom update from Stefan, resovle issue 21 2005-11-26 21:55:36 +00:00
sst49lfxxxc.c This patch is a rework of Adam Kaufman's Solaris patch. 2007-02-06 19:47:50 +00:00
sst49lfxxxc.h Add support for the SST-49LF004C, SST-49LF008C, SST-49LF016C in flashrom. 2007-01-22 20:21:17 +00:00
sst_fwhub.c This patch is a rework of Adam Kaufman's Solaris patch. 2007-02-06 19:47:50 +00:00
sst_fwhub.h flasrom update from Stefan, resovle issue 21 2005-11-26 21:55:36 +00:00
udelay.c flasrom update from Stefan, resovle issue 21 2005-11-26 21:55:36 +00:00
w49f002u.c Removing $Id$ tags as they have no meaning in SVN 2006-08-23 14:33:54 +00:00
w49f002u.h flasrom update from Stefan, resovle issue 21 2005-11-26 21:55:36 +00:00

README

-------------------------------------------------------------------------------
Flashrom README
-------------------------------------------------------------------------------

This is the universal (LinuxBIOS) flash utility.

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
-----

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 <chipname>:         probe only for specified flash chip
   -s | --estart <addr>:           exclude start position
   -e | --eend <addr>:             exclude end postion
   -m | --mainboard <vendor:part>: override mainboard settings
   -f | --force:                   force write without checking image
   -l | --layout <file.layout>:    read rom layout from file
   -i | --image <name>:            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.


LinuxBIOS Table and Mainboard Identification
--------------------------------------------

Flashrom reads the LinuxBIOS table to determine the current mainboard.
(Parse DMI as well in future?) If no LinuxBIOS table could be read
or if you want to override these values, you can specify -m, e.g.:

  flashrom -w --mainboard ISLAND:ARUMA island_aruma.rom


ROM Layout Support
------------------

Flashrom supports ROM layouts. This allows 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 island_aruma.rom
     
To update normal and fallback but leave the VGA BIOS alone, say:

     flashrom -w -l rom.layout -i normal -i fallback island_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?)


DOC 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
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
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-M29F400BT
ST ST-M29F040B
SyncMOS S29C51001T/B
SyncMOS S29C51002T/B
SyncMOS S29C51004T/B
SyncMOS S29C31004T
Winbond W29C011
Winbond W29C020C
Winbond W49F002U
Winbond W49V002A
Winbond W49V002FA
Winbond W39V040A
Winbond W39V040B


Supported Southbridges
----------------------

AMD CS5530
AMD Geode SC1100
AMD AMD-8111
ATI SB400
Intel ICH0-ICH8 (all variations)
Intel PIIX4/PIIX4E/PIIX4M
NVIDIA CK804
NVIDIA MCP51
NVIDIA MCP55
SiS 630
SiS 5595
VIA VT8231
VIA VT8235
VIA VT8237
VIA VT82C686