Flashrom
This wiki is retired
Our website is https://www.flashrom.org, instructions on how to add or update documentation are here
All wiki content available in read-only mode at wiki.flashrom.org
flashrom is a utility for reading, writing, verifying and erasing flash ROM chips. It's often used to flash BIOS/EFI/coreboot/firmware images.
Highlights of flashrom include:
- Supports parallel, LPC, FWH and SPI flash interfaces.
- Supports more than 150 flash chip families and half a dozen variants of each family.
- Flash chip package agnostic. DIP32, PLCC32, DIP8, SO8/SOIC8, TSOP32, TSOP40 and more have all been verified to work.
- Supports more than 75 different chipsets, some with multiple flash controllers.
- Features special mainboard enabling code for dozens of nonstandard mainboards.
- No physical access needed, root access is sufficient.
- No bootable floppy disk, bootable CD-ROM or other media needed.
- No keyboard or monitor needed. Simply reflash remotely via SSH.
- No instant reboot needed. Reflash your ROM in a running system, verify it, be happy. The new firmware will be present next time you boot.
- Crossflashing and hotflashing is possible as long as the flash chips are electrically and logically compatible (same protocol). Great for recovery.
- Scriptability. Reflash a whole pool of identical machines at the same time from the command line. It is recommended to check flashrom output and error codes.
- Speed. flashrom is much faster than most vendor flash tools.
- Supports Linux, FreeBSD, DragonFly BSD, Solaris, Mac OS X, and other Unix-like OSes.
Supported devices
Supported chips
|
|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Supported chipsets
|
|
|
Supported mainboards
In general, it is very likely that flashrom works out of the box even if your mainboard is not listed below.
This is a list of mainboards where we have verified that they either do or do not need any special initialization to make flashrom work (given flashrom supports the respective chipset and flash chip), or that they do not yet work at all. If they do not work, support may or may not be added later.
Mainboards which don't appear in the list may or may not work (we don't know, someone has to give it a try). Please report any further verified mainboards on the mailing list.
Known good (worked out of the box)
|
|
|
Known good (with write-enable code in flashrom)
|
|
Not supported (yet)
|
Board notes
- ASI MB-5BLMP: Used in the IGEL WinNET III thin client.
- MSI MS-7260 (K9N Neo): Interestingly flashrom does not work when the vendor BIOS is booted, but it does work flawlessly when the machine is booted with coreboot.
- ASUS M2A-VM: See http://www.coreboot.org/pipermail/coreboot/2007-September/025281.html.
- BCOM WinNET100: Used in the IGEL-316 thin client.
- ASUS A8V-E SE: See http://www.coreboot.org/pipermail/coreboot/2007-October/026496.html.
Supported laptops/notebooks
In general, flashing laptops is more difficult because
- laptops often use the flash ROM for stuff besides the BIOS
- laptops often have special protection stuff which has to be handled by flashrom
- laptops often use flash translation circuits which need extra drivers in flashrom.
|
Known-good
InstallationRequirements Flashrom requires the pciutils and zlib and the respective development packages in order to be built. In addition, the subversion package is required to download it. In Debian unstable these development packages are called pciutils-dev/libpci-dev, zlib1g-dev, and subversion. Most other distributions call them pciutils-devel, zlib-devel, and subversion. Manual Installation $ svn co svn://coreboot.org/flashrom/trunk flashrom $ cd flashrom $ make $ sudo make install Debian $ sudo aptitude install flashrom Fedora $ sudo yum install flashrom Gentoo $ emerge flashrom Mandriva $ urpmi flashrom openSUSE $ yast -i coreboot-utils For distributions older than openSUSE Factory (11.0) you find "backports" in the openSUSE Build Service. T2 SDE Installation from source: $ Emerge-Pkg flashrom Installation of binaries: $ mine -i flashrom-0.9.0.tar.bz2 Windows There is a Windows port of the flashrom utility. Download the latest version at http://google-summer-of-code-2007-coresystems.googlecode.com/files/DarmawanMappatutu_Salihun.tar.gz UsageDetect whether flashrom knows about your chipset/mainboard/BIOS chip: $ flashrom Read the current BIOS image into a file: $ flashrom -r backup.bin Depening on the chip driver, you may have to erase the chip before writing: $ flashrom -E Write a BIOS image (proprietary or coreboot) on the ROM chip: $ flashrom -wv newbios.bin WARNING: This will overwrite your current BIOS! Make sure you know what you're doing!
For more documentation please see the flashrom README or the man page. Fully testing flashrom chip/southbridge/mainboard supportSee this page for instructions on how to test flashrom properly (this may be risky, make sure you have a working backup ROM chip). Flashrom Live CDROM chip overviewModern mainboards store the BIOS in a reprogrammable flash ROM chip. There are hundreds of different flash ROMs, with variables such as memory size, speed, communication bus (LPC vs. ISA/PCI) and packaging to name just a few. The three most common packages are called DIP, PLCC and TSOP. The BIOS copyright holders often place a fancy sticker on the BIOS chip showing a name or logotype, BIOS version, serial number and copyright notice. DIP32: Dual In-line Package, 32 pinsA rectangular black plastic block with lots of pins along the two longer sides of the package. DIP ROMs can be socketed which means they are detachable from the mainboard using physical force. Since they haven't been moved in and out of the socket very much (yet, hehe) they can appear to be quite difficult to release from the socket. One way to remove a DIP from a socket is by prying a thin screwdriver in between the plastic package and the socket, along the shorter sides where there are no pins, and then gently bending the screwdriver to push the DIP upwards, away from the mainboard. Alternate between the two sides to avoid bending the pins, and don't touch any of the pins with the screwdriver, see FAQ about ESD, electro-static discharge. If the DIP is soldered directly to the mainboard, it has to be desoldered in order to be reprogrammed outside the mainboard. If you do this, it's a good idea to solder a socket to the mainboard instead, to ease any future experiments. PLCC32: Plastic Leaded Chip Carrier, 32 pinsBlack plastic block again, but this one is much more square. PLCC is becoming the standard for mainboards because of it's smaller physical size. PLCC can also be socketed or soldered directly to the mainboard. Socketed PLCC chips can be removed using a special PLCC removal tool, or using a piece of nylon line tied in a loop around the chip and pulled swiftly straight up, or bending/prying using small screwdrivers if one is careful. PLCC sockets are often fragile so the screwdriver approach is not recommended. While the nylon line method sounds onorthodox it works well. Desoldering PLCC can be painful without specialized desoldering equipment particularly because PLCC chips have leads on all four sides of the package. DIP8: Dual In-line Package, 8 pinsTSOP: Thin Small-Outline PackageTSOPs are often used in embedded systems where size is important and there is no need for replacement in the field. It is possible to (de)solder TSOPs by hand, but it comes close to wizardry. |
