| Ollie Lho | 184a404 | 2005-11-26 21:55:36 +0000 | [diff] [blame] | 1 | This is the universal LinuxBIOS flash utility. |
| Ronald G. Minnich | 1e5003f | 2002-04-10 18:02:07 +0000 | [diff] [blame] | 2 | |
| Stefan Reinauer | 06b2c4d | 2005-12-01 10:51:08 +0000 | [diff] [blame] | 3 | build requirements |
| 4 | ------------------ |
| 5 | |
| 6 | To build the flashrom utility you need to have the following packages |
| 7 | installed on your linux system: |
| 8 | |
| 9 | * pciutils |
| 10 | * pciutils-devel |
| 11 | |
| 12 | |
| 13 | usage |
| 14 | ----- |
| 15 | |
| Stefan Reinauer | f8337dd | 2006-08-03 10:49:09 +0000 | [diff] [blame] | 16 | usage: ./flashrom [-rwvEVfh] [-c chipname] [-s exclude_start] |
| 17 | [-e exclude_end] [-m vendor:part] [-l file.layout] [-i imagename] [file] |
| 18 | -r | --read: read flash and save into file |
| 19 | -w | --write: write file into flash (default when |
| 20 | file is specified) |
| 21 | -v | --verify: verify flash against file |
| 22 | -E | --erase: erase flash device |
| 23 | -V | --verbose: more verbose output |
| 24 | -c | --chip <chipname>: probe only for specified flash chip |
| 25 | -s | --estart <addr>: exclude start position |
| 26 | -e | --eend <addr>: exclude end postion |
| Ollie Lho | 184a404 | 2005-11-26 21:55:36 +0000 | [diff] [blame] | 27 | -m | --mainboard <vendor:part>: override mainboard settings |
| Stefan Reinauer | f8337dd | 2006-08-03 10:49:09 +0000 | [diff] [blame] | 28 | -f | --force: force write without checking image |
| 29 | -l | --layout <file.layout>: read rom layout from file |
| 30 | -i | --image <name>: only flash image name from flash layout |
| Ronald G. Minnich | 5e5f75e | 2002-01-29 18:21:41 +0000 | [diff] [blame] | 31 | |
| Ollie Lho | 184a404 | 2005-11-26 21:55:36 +0000 | [diff] [blame] | 32 | If no file is specified, then all that happens |
| 33 | is that flash info is dumped and the flash chip is set to writable. |
| Ronald G. Minnich | 5e5f75e | 2002-01-29 18:21:41 +0000 | [diff] [blame] | 34 | |
| Ronald G. Minnich | 5e5f75e | 2002-01-29 18:21:41 +0000 | [diff] [blame] | 35 | |
| Ollie Lho | 184a404 | 2005-11-26 21:55:36 +0000 | [diff] [blame] | 36 | LinuxBIOS table and Mainboard identification |
| 37 | -------------------------------------------- |
| Ronald G. Minnich | 5e5f75e | 2002-01-29 18:21:41 +0000 | [diff] [blame] | 38 | |
| Ollie Lho | 184a404 | 2005-11-26 21:55:36 +0000 | [diff] [blame] | 39 | flashrom reads the LinuxBIOS table to determine the current mainboard. |
| 40 | (Parse DMI as well in future?) If no LinuxBIOS table could be read |
| 41 | or if you want to override these values, you can to specify -m ie.: |
| 42 | |
| 43 | flashrom -w --mainboard ISLAND:ARUMA island_aruma.rom |
| 44 | |
| 45 | |
| 46 | rom layout support |
| 47 | ------------------ |
| 48 | |
| 49 | flashrom supports rom layouts. This allows to flash certain parts of |
| 50 | the flash chip only. A rom layout file looks like follows: |
| 51 | |
| 52 | 00000000:00008fff gfxrom |
| 53 | 00009000:0003ffff normal |
| 54 | 00040000:0007ffff fallback |
| 55 | |
| 56 | i.e.: |
| 57 | startaddr:endaddr name |
| 58 | |
| 59 | all addresses are offsets within the file, not absolute addresses! |
| 60 | |
| 61 | If you only want to update the normal image in a rom you can say: |
| 62 | |
| 63 | flashrom -w --layout rom.layout --image normal island_aruma.rom |
| 64 | |
| 65 | To update normal and fallback but leave the vga bios alone, say: |
| 66 | |
| 67 | flashrom -w -l rom.layout -i normal -i fallback island_aruma.rom |
| 68 | |
| 69 | Currently overlapping sections are not spported. |
| 70 | |
| 71 | rom layouts should replace the -s and -e option since they are more |
| 72 | flexible and they should lead to a rom update file format with the |
| 73 | rom layout and the rom image in one file (cpio, zip or something?) |
| 74 | |
| 75 | |
| 76 | DOC support |
| 77 | ----------- |
| 78 | |
| 79 | DISK on Chip support is currently disabled since it is considered unstable. |
| 80 | Change CFLAGS in the Makefile to enable it. |
| 81 | |
| 82 | |