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