GNUBoot
/
coreboot-kgpe-d16
2
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
coreboot-kgpe-d16/util/flashrom
History
Peter Stuge b05b6a2555 flashrom: Remove dead M-Systems Disk on Chip code 
DOC support has been disabled by default for many years. The write function
does nothing but print text. It has a call to write_page_md2802() commented
out, but that function does not exist. This is dead code with ugly #ifdefs.

Updates README to reflect that there was a time when there was code, but it
didn't work. Removes M-Systems #defines and also includes svn rm msys_doc.*

Signed-off-by: Peter Stuge <peter@stuge.se>
Acked-by: Stefan Reinauer <stepan@coresystems.de>



git-svn-id: svn://svn.coreboot.org/coreboot/trunk@3382 2b7e53f0-3cfb-0310-b3e9-8179ed1497e1
 		2008-06-22 17:06:41 +00:00
..
82802ab.c Flash pages, which where excluded from updating using the exclude or the 2008-04-24 09:07:57 +00:00
COPYING Add a copy of the GPL in the flashrom repository as it's an independent 2007-09-08 14:36:01 +00:00
Makefile flashrom: Remove dead M-Systems Disk on Chip code 2008-06-22 17:06:41 +00:00
README flashrom: Remove dead M-Systems Disk on Chip code 2008-06-22 17:06:41 +00:00
am29f040b.c Add '(C)' where it's missing (for consistency reasons). 2007-09-09 20:21:05 +00:00
board_enable.c flashrom: Board enable and autodetection for GIGABYTE GA-7VT600 2008-06-13 01:39:45 +00:00
cbtable.c rename linuxbios_* files in utils repository. 2008-01-18 16:17:44 +00:00
chipset_enable.c A bunch of cosmetic improvements (trivial). 2008-05-22 22:47:04 +00:00
coreboot_tables.h rename linuxbios_* files in utils repository. 2008-01-18 16:17:44 +00:00
en29f002a.c Add continuation ID support to jedec.c 2007-12-31 01:49:00 +00:00
flash.h flashrom: Remove dead M-Systems Disk on Chip code 2008-06-22 17:06:41 +00:00
flashchips.c flashrom: Remove dead M-Systems Disk on Chip code 2008-06-22 17:06:41 +00:00
flashrom.8 Add --list-supported option to flashrom which lists the supported 2008-03-12 11:54:51 +00:00
flashrom.c flashrom: Show expected and read byte on verify failure. Trivial. 2008-06-20 02:58:42 +00:00
ichspi.c Add support for SPI chips on ICH9. This is done by using the generic SPI 2008-05-16 12:55:55 +00:00
it87spi.c Changes to make flashrom compile (and work) on FreeBSD. 2008-05-22 13:22:45 +00:00
jedec.c flashrom: Update comment to match delay change in probe_jedec() r3373 2008-06-21 01:02:20 +00:00
layout.c flashrom: Force read unknown flash chips 2008-06-18 02:08:40 +00:00
m29f400bt.c for some reasons the externals did not get committed. 2008-01-18 15:33:10 +00:00
mx29f002.c Some cosmetic cleanups in the flashrom code and output. 2007-10-17 23:55:15 +00:00
pm49fl00x.c flashrom: Support Pm49FL004/2 Block Locking Registers 2008-05-17 01:08:58 +00:00
sharplhf00l04.c Revert the delete of 82802ab.c in r3137. 2008-03-14 00:02:25 +00:00
spi.c Add support for SPI chips on ICH9. This is done by using the generic SPI 2008-05-16 12:55:55 +00:00
spi.h Add support for the JEDEC RES (Read Electronic Signature and Resume from 2008-05-15 03:19:49 +00:00
sst28sf040.c Some cosmetic cleanups in the flashrom code and output. 2007-10-17 23:55:15 +00:00
sst39sf020.c I looked at the datasheet and erase_sector_39sf020() is totally and 2008-05-16 21:11:53 +00:00
sst49lf040.c Some cosmetic cleanups in the flashrom code and output. 2007-10-17 23:55:15 +00:00
sst49lfxxxc.c Some cosmetic cleanups in the flashrom code and output. 2007-10-17 23:55:15 +00:00
sst_fwhub.c check whether SST FWH chip was successfully erased on flashchip -E, too 2008-03-16 19:44:13 +00:00
stm50flw0x0x.c The generic jedec.c does not work for the ST M50FLW flash 2008-04-28 17:51:09 +00:00
udelay.c Some cosmetic cleanups in the flashrom code and output. 2007-10-17 23:55:15 +00:00
w29ee011.c flashrom: Add support for AMIC Technology A49LF040A and do not probe W29EE011 anymore 2008-06-18 13:36:34 +00:00
w39v080fa.c oops. forgot to add the file. 2008-03-18 00:36:18 +00:00
w49f002u.c Some cosmetic cleanups in the flashrom code and output. 2007-10-17 23:55:15 +00:00

README 

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

Flashrom is a universal flash programming utility for DIP, PLCC, or SPI
flash ROM chips. It can be used to flash BIOS/coreboot/firmware images.

(see http://coreboot.org for details on coreboot)


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

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


coreboot Table and Mainboard Identification
--------------------------------------------

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

  flashrom -w --mainboard AGAMI:ARUMA agami_aruma.rom

The following boards require the specification of the board name, if
no coreboot table is found:

* IWILL DK8-HTX: use -m iwill:dk8_htx
* Agami Aruma: use -m AGAMI:ARUMA
* ASUS P5A: use -m asus:p5a
* IBM x3455: use -m ibm:x3455
* EPoX EP-BX3: use -m epox:ep-bx3
* GIGABYTE GA-M57SLI-S4 v2.0: use -m gigabyte:m57sli
* GIGABYTE GA-M61P-S3: use -m gigabyte:m61p
* MSI K8N Neo3: use -m msi:k8n-neo3
* Acorp 6A815EPD: use -m acorp:6a815epd


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

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

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


Disk on Chip support
--------------------

Disk on Chip support was removed from flashrom in r3380. It had already
been disabled by default in flashrom for several years because the code
was considered unstable and incomplete. The products intended to work
have been End-Of-Lifed by the manufacturer for a long time.


Supported Flash Chips
---------------------

AMD AM-29F040B
AMD AM-29F016D
ASD AE49F2008
Atmel AT-29C040A
Atmel AT-29C020
EMST F49B002UA
Intel 82802AB (Firmware Hub) 
Intel 82802AC (Firmware Hub) 
MX MX-29F002
PMC PMC-49FL002
PMC PMC-49FL004
Sharp LHF-00L04
Spansion S25FL016A
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-M50FLW040A
ST ST-M50FLW040B
ST ST-M50FLW080A
ST ST-M50FLW080B
ST ST-M50FW040
ST ST-M50FW080
ST ST-M50FW016
ST ST-M50LPW116
ST ST-M29F002B
ST ST-M29F002T
ST ST-M29F002NT
ST ST-M29F400BT
ST ST-M29F040B
ST ST-M29W010B
ST ST-M29W040B
SyncMOS S29C51001T/B
SyncMOS S29C51002T/B
SyncMOS S29C51004T/B
SyncMOS S29C31004T
Winbond W29C011
Winbond W29C020C
Winbond W29C040P
Winbond W29EE011
Winbond W49F002U
Winbond W49V002A
Winbond W49V002FA
Winbond W39V040FA
Winbond W39V040A
Winbond W39V040B
Winbond W39V080A


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

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