Build HOWTO: Difference between revisions
(updated to git and crossgcc) |
m (Small fixes.) |
||
Line 1: | Line 1: | ||
[[File:Coreboot menuconfig.png|thumb|right|'''make menuconfig''' in coreboot]] | [[File:Coreboot menuconfig.png|thumb|right|'''make menuconfig''' in coreboot]] | ||
This page describes how you can build a coreboot image for your specific mainboard | This page describes how you can build a coreboot image for your specific mainboard. | ||
== Requirements == | == Requirements == | ||
Line 26: | Line 26: | ||
== Building coreboot == | == Building coreboot == | ||
First, get the latest coreboot version from [[Git | our git repository]]: | First, get the latest coreboot version from [[Git|our git repository]]: | ||
$ '''git clone http://review.coreboot.org/p/coreboot''' | $ '''git clone <nowiki>http://review.coreboot.org/p/coreboot</nowiki>''' | ||
$ '''cd coreboot''' | $ '''cd coreboot''' | ||
Line 52: | Line 52: | ||
== Known issue == | == Known issue == | ||
To switch to the cross-compiler just run | With certain versions of the gcc/ld toolchain shipped in some Linux distributions, it's possible that you'll see the following error when building coreboot: | ||
src/arch/x86/coreboot_ram.ld:129 cannot move location counter backwards | |||
This is a known bug in those versions of the toolchain. Before sending a complaint message to our mailing list, please try to switch to our reference cross-compilation toolkit then recompile the sources. To switch to the cross-compiler just run | |||
$ '''make crossgcc''' | $ '''make crossgcc''' | ||
Line 64: | Line 68: | ||
You can flash the coreboot image on a flash ROM chip using either an external EEPROM-programmer or a mainboard using the [http://www.flashrom.org flashrom] user-space utility. | You can flash the coreboot image on a flash ROM chip using either an external EEPROM-programmer or a mainboard using the [http://www.flashrom.org flashrom] user-space utility. | ||
Revision as of 15:20, 23 June 2011
![](/images/thumb/c/ca/Coreboot_menuconfig.png/300px-Coreboot_menuconfig.png)
This page describes how you can build a coreboot image for your specific mainboard.
Requirements
- gcc / g++
- make
- ncurses-dev (for make menuconfig)
Optional:
- doxygen (for generating/viewing documentation)
- iasl (for targets with ACPI support)
- gdb (for better debugging facilities on some targets)
- flex and bison (for regenerating parsers)
Building a payload
First you need to download the source code for the payload of your choice and build it.
Instructions for building the various payloads are not covered on this page, please see Payloads and the wiki page for the respective payload for details.
The result of this step should be an ELF file (e.g. filo.elf, or coreinfo.elf) which you can use with coreboot (see below).
Building coreboot
First, get the latest coreboot version from our git repository:
$ git clone http://review.coreboot.org/p/coreboot $ cd coreboot
In the coreboot directory you can configure the build-time options of coreboot:
$ make menuconfig
In that menu (which may look familiar, as other projects such as the Linux kernel or busybox use the same system), select at least the following options:
- Enter the Mainboard menu.
- In Mainboard vendor select the vendor of your board.
- In Mainboard model select your exact mainboard name.
- In ROM chip size select the exact size of the flash ROM chip you want to flash the coreboot image on.
- Enter the Payload menu.
- Set the Add a payload option to An ELF executable payload.
- Then, specify the file name and path to your payload file (which you built before).
That's the bare minimum. Feel free to adjust the other settings to your needs (see Coreboot Options for the full list), then exit menuconfig and build the coreboot image:
$ make
The file build/coreboot.rom is your final coreboot image you can flash onto a ROM chip.
Known issue
With certain versions of the gcc/ld toolchain shipped in some Linux distributions, it's possible that you'll see the following error when building coreboot:
src/arch/x86/coreboot_ram.ld:129 cannot move location counter backwards
This is a known bug in those versions of the toolchain. Before sending a complaint message to our mailing list, please try to switch to our reference cross-compilation toolkit then recompile the sources. To switch to the cross-compiler just run
$ make crossgcc
Then retry the compilation process:
$ make
Flashing coreboot
You can flash the coreboot image on a flash ROM chip using either an external EEPROM-programmer or a mainboard using the flashrom user-space utility.