Difference between revisions of "Buildrom"
(Use a table.) |
(→Supported Platforms/Boards: Add missing platforms, fix colors.) |
||
| Line 33: | Line 33: | ||
| style="background:yellow" | ? | | style="background:yellow" | ? | ||
| — | | — | ||
| − | |||
|- bgcolor="#eeeeee" | |- bgcolor="#eeeeee" | ||
| AMD | | AMD | ||
| Line 45: | Line 44: | ||
| style="background:yellow" | ? | | style="background:yellow" | ? | ||
| — | | — | ||
| − | + | |- bgcolor="#eeeeee" | |
| − | |- bgcolor="# | + | |
| AMD | | AMD | ||
| Serengeti Cheetah | | Serengeti Cheetah | ||
| Line 58: | Line 56: | ||
| — | | — | ||
| − | |- bgcolor="# | + | |- bgcolor="#dddddd" |
| Artec Group | | Artec Group | ||
| [http://www.artecgroup.com/thincan/index.php?option=com_content&task=blogcategory&id=15&Itemid=34 DBE61] | | [http://www.artecgroup.com/thincan/index.php?option=com_content&task=blogcategory&id=15&Itemid=34 DBE61] | ||
| Line 69: | Line 67: | ||
| style="background:yellow" | ? | | style="background:yellow" | ? | ||
| — | | — | ||
| + | |||
| + | |- bgcolor="#eeeeee" | ||
| + | | ASUS | ||
| + | | [http://www.asus.com.tw/products.aspx?l1=3&l2=15&l3=143&l4=0&model=576&modelmenu=1 A8V-E SE] | ||
| + | | AMD K8 | ||
| + | | VIA K8T890 / VT8237R | ||
| + | | Winbond™ W83627EHG | ||
| + | | AMD Athlon™ 64 / FX / X2 | ||
| + | | Socket 939 | ||
| + | | style="background:yellow" | ? | ||
| + | | style="background:yellow" | ? | ||
| + | | [[ASUS A8V-E SE Build Tutorial|Tutorial]] | ||
| + | |- bgcolor="#eeeeee" | ||
| + | | ASUS | ||
| + | | [http://www.asus.com.tw/products.aspx?l1=3&l2=15&l3=143&l4=0&model=376&modelmenu=1 A8V-E Deluxe] | ||
| + | | AMD K8 | ||
| + | | VIA K8T890 / VT8237R | ||
| + | | Winbond™ W83627EHG | ||
| + | | AMD Athlon™ 64 / FX / X2 | ||
| + | | Socket 939 | ||
| + | | style="background:yellow" | ? | ||
| + | | style="background:yellow" | ? | ||
| + | | [[ASUS A8V-E Deluxe Build Tutorial|Tutorial]] | ||
|- bgcolor="#dddddd" | |- bgcolor="#dddddd" | ||
| Line 83: | Line 104: | ||
|- bgcolor="#eeeeee" | |- bgcolor="#eeeeee" | ||
| + | | Emulation | ||
| + | | [http://fabrice.bellard.free.fr/qemu/ QEMU x86] | ||
| + | | Intel® 440BX | ||
| + | | Intel® 82371EB (PIIX4E) | ||
| + | | — | ||
| + | | Intel® Pentium® II/III (?) | ||
| + | | — | ||
| + | | style="background:yellow" | ? | ||
| + | | style="background:yellow" | ? | ||
| + | | [[QEMU Build Tutorial|Tutorial]] | ||
| + | |||
| + | |- bgcolor="#dddddd" | ||
| GIGABYTE | | GIGABYTE | ||
| [http://www.gigabyte.com.tw/Products/Motherboard/Products_Overview.aspx?ProductID=2287&ModelName=GA-M57SLI-S4 GA-M57SLI-S4] | | [http://www.gigabyte.com.tw/Products/Motherboard/Products_Overview.aspx?ProductID=2287&ModelName=GA-M57SLI-S4 GA-M57SLI-S4] | ||
| Line 93: | Line 126: | ||
| style="background:yellow" | ? | | style="background:yellow" | ? | ||
| [[GIGABYTE GA-M57SLI-S4 Build Tutorial|Tutorial]] | | [[GIGABYTE GA-M57SLI-S4 Build Tutorial|Tutorial]] | ||
| − | + | |- bgcolor="#dddddd" | |
| − | |- bgcolor="# | + | |
| GIGABYTE | | GIGABYTE | ||
| [http://www.rssfeedbus.com/index.php?showtopic=1515 GA-2761GXDK] (Churchill) | | [http://www.rssfeedbus.com/index.php?showtopic=1515 GA-2761GXDK] (Churchill) | ||
| Line 118: | Line 150: | ||
| [[PC Engines ALIX1.C Build Tutorial|Tutorial]] | | [[PC Engines ALIX1.C Build Tutorial|Tutorial]] | ||
| − | |- bgcolor="# | + | |- bgcolor="#dddddd" |
| Supermicro | | Supermicro | ||
| [http://www.supermicro.com/Aplus/motherboard/Opteron2000/MCP55/H8DMR-i2.cfm H8DMR-i2] | | [http://www.supermicro.com/Aplus/motherboard/Opteron2000/MCP55/H8DMR-i2.cfm H8DMR-i2] | ||
| Line 130: | Line 162: | ||
| — | | — | ||
| − | |- bgcolor="# | + | |- bgcolor="#eeeeee" |
| + | | Tyan | ||
| + | | [http://www.tyan.com/archive/products/html/thunderk8sr.html Thunder K8SR (S2881)] | ||
| + | | AMD K8 | ||
| + | | AMD-8111™, 8131™ | ||
| + | | Winbond™ W83627HF | ||
| + | | AMD Opteron™ | ||
| + | | Socket 940 | ||
| + | | style="background:yellow" | ? | ||
| + | | style="background:yellow" | ? | ||
| + | | [[Tyan S2881 Build Tutorial|Tutorial]] | ||
| + | |- bgcolor="#eeeeee" | ||
| Tyan | | Tyan | ||
| [http://www.tyan.com/archive/products/html/thunderk8spro.html Thunder K8S Pro (S2882)] | | [http://www.tyan.com/archive/products/html/thunderk8spro.html Thunder K8S Pro (S2882)] | ||
| Line 141: | Line 184: | ||
| style="background:yellow" | ? | | style="background:yellow" | ? | ||
| [[Tyan S2882 Build Tutorial|Tutorial]] | | [[Tyan S2882 Build Tutorial|Tutorial]] | ||
| − | + | |- bgcolor="#eeeeee" | |
| − | |- bgcolor="# | + | |
| Tyan | | Tyan | ||
| [http://www.tyan.com/archive/products/html/thunderk8sre.html Thunder K8SRE (S2891)] | | [http://www.tyan.com/archive/products/html/thunderk8sre.html Thunder K8SRE (S2891)] | ||
Revision as of 00:15, 22 April 2008
Buildrom is a tool that can construct a coreboot image (comprising the coreboot loader and payload) from scratch.
Starting from a configuration file, it will download and build all the code necessary to construct the final binary.
A tool with similar functionality is Etherboot's ROM-o-matic which builds etherboot as a coreboot ELF payload.
Contents |
Supported Platforms/Boards
Buildrom currently supports the following platforms / mainboards:
| Vendor | Mainboard | Northbridge | Southbridge | Super I/O | CPU | Socket | v2 | v3 | Tutorial |
|---|---|---|---|---|---|---|---|---|---|
| AMD | DB800 (Salsa) | AMD LX | AMD CS5536 | Winbond™ W83627HF | AMD Geode™ LX | — | ? | ? | — |
| AMD | Norwich | AMD LX | AMD CS5536 | — | AMD Geode™ LX | — | ? | ? | — |
| AMD | Serengeti Cheetah | AMD K8 | AMD-8111™, 8151™, 8132™ | Winbond™ W83627HF | AMD Opteron™ | Socket F | ? | ? | — |
| Artec Group | DBE61 | AMD LX | AMD CS5536 | — | AMD Geode™ LX | — | ? | ? | — |
| ASUS | A8V-E SE | AMD K8 | VIA K8T890 / VT8237R | Winbond™ W83627EHG | AMD Athlon™ 64 / FX / X2 | Socket 939 | ? | ? | Tutorial |
| ASUS | A8V-E Deluxe | AMD K8 | VIA K8T890 / VT8237R | Winbond™ W83627EHG | AMD Athlon™ 64 / FX / X2 | Socket 939 | ? | ? | Tutorial |
| DIGITAL-LOGIC | MSM800SEV | AMD Geode™ LX | AMD Geode™ CS5536 | — | AMD Geode™ LX | — | ? | ? | — |
| Emulation | QEMU x86 | Intel® 440BX | Intel® 82371EB (PIIX4E) | — | Intel® Pentium® II/III (?) | — | ? | ? | Tutorial |
| GIGABYTE | GA-M57SLI-S4 | AMD K8 | NVIDIA MCP55 | ITE IT8716F | AMD Sempron™ / Athlon™ 64 / FX / X2 | Socket AM2 | ? | ? | Tutorial |
| GIGABYTE | GA-2761GXDK (Churchill) | AMD K8 | SiS761GX/SiS966 | ITE IT8716F | AMD Sempron™ / Athlon™ 64 / FX / X2 (?) | Socket AM2 | ? | ? | Tutorial |
| PC Engines | ALIX1.C | AMD Geode™ LX | AMD Geode™ CS5536 | Winbond® W83627HF | AMD Geode™ LX | — | ? | ? | Tutorial |
| Supermicro | H8DMR-i2 | AMD K8 | NVIDIA MCP55 | Winbond™ W83627EHG | AMD Opteron™ | Socket F | ? | ? | — |
| Tyan | Thunder K8SR (S2881) | AMD K8 | AMD-8111™, 8131™ | Winbond™ W83627HF | AMD Opteron™ | Socket 940 | ? | ? | Tutorial |
| Tyan | Thunder K8S Pro (S2882) | AMD K8 | AMD-8111™, 8131™ | Winbond™ W83627HF | AMD Opteron™ | Socket 940 | ? | ? | Tutorial |
| Tyan | Thunder K8SRE (S2891) | AMD K8 | AMD-8131™, NVIDIA CK8041 | Winbond™ W83627HF | AMD Opteron™ | Socket 940 | ? | ? | Tutorial |
Supported Payloads
Buildrom supports the following payloads:
- Linux kernel
- Etherboot
- FILO
- "Linux-as-bootloader" (LAB)
- Memtest86+ (except on the GA-M57SLI-S4 and the Tyan S2891)
Download
$ svn co svn://coreboot.org/buildrom
You can also visit the web-based trac instance to browse the code and outstanding issues.
Prerequisites
You will need the following packages on your system to use buildrom. Please consult your distribution documentation on how to install new packages:
- subversion
- make
- quilt
- GNU compiler tools (as, ld, gcc)
- iasl (for AMD K8 platforms)
Configuration
In the buildrom-devel directory, type:
$ make menuconfig
You can now navigate the configuration system (this is the same configuration engine that the Linux kernel uses, so it should be familiar to some readers).
Building the ROM
Make sure you have access to the internet (to download new packages), and type the following to create your ROM:
$ make
Buildrom will download and build all the components of the ROM selected in the configuration stage. if the build is successful, then the final ROM will be located in buildrom-devel/deploy. If it is not successful, then you will see an error message. You can see the build output for each package in by reading build.log in the work/<package>logs/ directory (i.e work/filo/logs/build.log).
Developing within Buildrom
This section is for the developers who wish to change and rebuild the code. BuildROM builds the code for coreboot and the payloads in the work/ directory. Here is a typical view of the buildROM work/ directory:
$ ls work/ linuxbios filo
In each directory, you will find three directories. Logs from the build will be found in logs/ and timestamps that the build system uses are in stamps/. You normally won't have to touch these directories. The source code is located in the third directory. BuildROM provides several commands to make it easy to rebuild individual packages and ROMs. To clean a directory (but not remove the source code) use 'make <package>-clean'. You can build an individual packages with 'make <package>'. f you wish to completely erase the source code and start again with a pristine version, use 'make <package>-distclean'. Typing 'make' at any time will rebuild the ROM using the most current versions of the individual packages. Here is a typical work flow for modifying coreboot code:
- Build the initial ROM from scratch with 'make'
- Edit the coreboot source code in work/linuxbios/svn/
- Clean the coreboot package with 'make linuxbios-clean'
- Rebuild the ROM with 'make'
