README 2.04 KB
Newer Older
Uwe Hermann's avatar
Uwe Hermann committed
1
-------------------------------------------------------------------------------
2
flashrom README
Uwe Hermann's avatar
Uwe Hermann committed
3
-------------------------------------------------------------------------------
4

5
flashrom is a utility for reading, writing, verifying and erasing flash ROM
6 7 8 9
chips. It's often used to flash BIOS/EFI/coreboot/firmware images in-system
using a supported mainboard, but it also supports flashing of network
cards (NICs), SATA controller cards, and other external devices which can
program flash chips.
Uwe Hermann's avatar
Uwe Hermann committed
10

11 12 13
It supports a wide range of DIP32, PLCC32, DIP8, SO8/SOIC8, TSOP32, and
TSOP40 chips, which use various protocols such as LPC, FWH, parallel flash,
or SPI.
14 15 16

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

Uwe Hermann's avatar
Uwe Hermann committed
17 18

Build Requirements
19 20
------------------

21
To build flashrom you need to install the following packages or ports:
22

23
Linux et al:
24 25 26 27

 * pciutils
 * pciutils-devel / pciutils-dev / libpci-dev
 * zlib-devel / zlib1g-dev
28

29 30
On FreeBSD, you need the following ports:

31 32 33 34 35 36 37 38 39 40
 * devel/gmake
 * devel/libpci

To compile on Linux, use:

 make

To compile on FreeBSD, use:

 gmake
41

42
To compile on Solaris, use:
43

44 45 46 47 48 49 50
 gmake LDFLAGS="-L$pathtolibpci -lpci -lz" CC="gcc -I$pathtopciheaders" \
       CFLAGS=-O2

To compile on DragonFly BSD, use:

 ln -s /usr/pkg/include/pciutils pci
 gmake CFLAGS=-I. LDFLAGS="-L/usr/pkg/lib -lpci -lz"
51 52

To compile and run on Darwin/Mac OS X:
53 54 55

 Install DirectIO from coresystems GmbH.
 DirectIO is available at http://www.coresystems.de/en/directio.
56

57

58 59 60 61
Usage / Options
---------------

Please see the flashrom(8) manpage.
62 63


64 65
Exit status
-----------
Uwe Hermann's avatar
Uwe Hermann committed
66

67
Please see the flashrom(8) manpage.
68 69


Stefan Reinauer's avatar
Stefan Reinauer committed
70
coreboot Table and Mainboard Identification
71 72
--------------------------------------------

73
Please see the flashrom(8) manpage.
Uwe Hermann's avatar
Uwe Hermann committed
74

75

Uwe Hermann's avatar
Uwe Hermann committed
76
ROM Layout Support
77 78
------------------

79
Please see the flashrom(8) manpage.
80 81


82 83 84 85
Supported Flash Chips / Chipsets / Mainboards
---------------------------------------------

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

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