coreboot-kgpe-d16/util/flashrom
Peter Stuge 4e40e46d49 flashrom: Check that a filename was specified also when using force read
Signed-off-by: Peter Stuge <peter@stuge.se>
Acked-by: Peter Stuge <peter@stuge.se>


git-svn-id: svn://svn.coreboot.org/coreboot/trunk@3647 2b7e53f0-3cfb-0310-b3e9-8179ed1497e1
2008-10-10 20:43:17 +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 Activate proper support for EN29F002(A)(N)[BT]. 2008-09-26 13:19:02 +00:00
README Some flashrom documentation fixes, and removal of duplicated info (trivial). 2008-06-22 18:50:25 +00:00
am29f040b.c Add '(C)' where it's missing (for consistency reasons). 2007-09-09 20:21:05 +00:00
board_enable.c Add support for MSI KT4V to flashrom. The KT4V is autodetected and supports 2008-08-19 21:51:39 +00:00
cbtable.c rename linuxbios_* files in utils repository. 2008-01-18 16:17:44 +00:00
chipset_enable.c flashrom: Recognize the Intel EP80579 LPC flash interface. 2008-08-20 20:31:41 +00:00
coreboot_tables.h rename linuxbios_* files in utils repository. 2008-01-18 16:17:44 +00:00
en29f002a.c Activate proper support for EN29F002(A)(N)[BT]. 2008-09-26 13:19:02 +00:00
flash.h Support for AM29F002(N)B[BT]. Fully tested on AM29F002NBT. 2008-10-07 12:21:12 +00:00
flashchips.c Support for AM29F002(N)B[BT]. Fully tested on AM29F002NBT. 2008-10-07 12:21:12 +00:00
flashrom.8 Some flashrom documentation fixes, and removal of duplicated info (trivial). 2008-06-22 18:50:25 +00:00
flashrom.c flashrom: Check that a filename was specified also when using force read 2008-10-10 20:43:17 +00:00
ichspi.c flashrom: Trivial indent fix in ichspi.c 2008-07-07 05:14:06 +00:00
it87spi.c flashrom: Trivial SPI cleanups 2008-07-07 06:38:51 +00:00
jedec.c flashrom: Increase delay in probe_jedec() after Product ID Entry to 10ms 2008-06-24 02:09:09 +00:00
layout.c Fix and clean up coreboot image detection heuristic. 2008-07-11 00:06:38 +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 flashrom: Trivial SPI cleanups 2008-07-07 06:38:51 +00:00
spi.h flashrom: Trivial SPI cleanups 2008-07-07 06:38:51 +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 flashrom: Debug print actual time base calculated by myusec_calibrate_delay() 2008-09-07 03:14:27 +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
w39v040c.c flashrom: Winbond W39V040C and MSI K8T Neo2-F 2008-07-21 17:48:40 +00:00
w39v080fa.c set w39v080fa to fully supported. I'm am flashing this chip several times a 2008-07-02 13:33:09 +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 install the following packages:

* pciutils
* pciutils-devel / pciutils-dev / libpci-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

See the 'Supported mainboards' section in the output of 'flashrom -L' for
a list of boards which require the specification of the board name, if no
coreboot table is found.


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 r3382. 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 / Chipsets / Mainboards
---------------------------------------------

Please check the output of 'flashrom -L' for the list of supported
flash chips, chipsets/southbridges, and mainboards.

See also http://coreboot.org/Flashrom for more details.