coreboot-kgpe-d16/util/flashrom
Scott Tsai, scott.tsai e32243a9b1 From: Scott Tsai, scott.tsai <AT> arima.com.tw
Tested on my home Shuttle SB51G box.
data sheet:
http://www.alldatasheet.com/datasheet-pdf/pdf/47674/WINBOND/W49V002FAP.html



git-svn-id: svn://svn.coreboot.org/coreboot/trunk@2341 2b7e53f0-3cfb-0310-b3e9-8179ed1497e1
2006-07-19 15:13:21 +00:00
..
82802ab.c flasrom update from Stefan, resovle issue 21 2005-11-26 21:55:36 +00:00
82802ab.h flasrom update from Stefan, resovle issue 21 2005-11-26 21:55:36 +00:00
Makefile redo ts5300 auto.c 2006-03-19 22:30:42 +00:00
README mention build dependencies in Makefile. 2005-12-01 10:51:08 +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 From: Scott Tsai, scott.tsai <AT> arima.com.tw 2006-07-19 15:13:21 +00:00
flash_enable.c * https://openbios.org/roundup/linuxbios/issue96 - SST_49LF040B flash support for flashrom 2006-03-31 11:36:06 +00:00
flash_rom.c - speed up flash verification by only printing 1 of 4096 addresses 2006-03-16 16:57:41 +00:00
flashchips.c From: Scott Tsai, scott.tsai <AT> arima.com.tw 2006-07-19 15:13:21 +00:00
jedec.c flasrom update from Stefan, resovle issue 21 2005-11-26 21:55:36 +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 flasrom update from Stefan, resovle issue 21 2005-11-26 21:55:36 +00:00
lbtable.h flasrom update from Stefan, resovle issue 21 2005-11-26 21:55:36 +00:00
m29f400bt.c flasrom update from Stefan, resovle issue 21 2005-11-26 21:55:36 +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 flasrom update from Stefan, resovle issue 21 2005-11-26 21:55:36 +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 Fix for nehemiah 2006-03-14 19:58:14 +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 flasrom update from Stefan, resovle issue 21 2005-11-26 21:55:36 +00:00
sst39sf020.h flasrom update from Stefan, resovle issue 21 2005-11-26 21:55:36 +00:00
sst49lf040.c compilation fix for gcc 4.0.2 (SUSE10) 2006-03-20 21:37:54 +00:00
sst49lf040.h flasrom update from Stefan, resovle issue 21 2005-11-26 21:55:36 +00:00
sst_fwhub.c flasrom update from Stefan, resovle issue 21 2005-11-26 21:55:36 +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 flasrom update from Stefan, resovle issue 21 2005-11-26 21:55:36 +00:00
w49f002u.h flasrom update from Stefan, resovle issue 21 2005-11-26 21:55:36 +00:00

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


usage
-----

usage: ./flashrom [-rwvE] [-V] [-c chipname] 
                           [-s exclude_start] [-e exclude_end] [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
   -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 to specify -m ie.:

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

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.