Difference between revisions of "Build from Windows"

From coreboot
Jump to: navigation, search
(Setup the coreboot build environment (shortcut method))
(Build the coreboot project)
Line 70: Line 70:
 
Here are step-by-step instructions for building a coreboot based bios on a windows machine using the shortcut build environment setup method:
 
Here are step-by-step instructions for building a coreboot based bios on a windows machine using the shortcut build environment setup method:
  
:1.Decompress the [http://notabs.org/coreboot/win-build-env-001.7z sample project] into any directory. Note: Avoid the use of spaces in the project path and directory name. Use [http://7-zip.org/ 7-zip] for decompression.
+
:1. Decompress the [http://notabs.org/coreboot/windows-build.htm sample project] into any directory. Note: Avoid the use of spaces in the project path and directory name. Use [http://7-zip.org/ 7-zip] for decompression.
:2.Replace the sample <tt>coreboot</tt> [svn://coreboot.org/coreboot/trunk source code] (rev 5775) with your own. The directory must be named <tt>coreboot</tt>.  
+
:2. Replace the sample <tt>coreboot</tt> [svn://coreboot.org/coreboot/trunk source code] (rev 5775) with your own. The directory must be named <tt>coreboot</tt>.  
:3.Using Windows explorer, click on <tt>go.bat</tt> to start the build environment. It will look something like this:
+
:3. Using Windows explorer, click on <tt>go.bat</tt> to start the build environment. It will look something like this:
[[Image:winbuild-msys-prompt.png|left]]
+
<font color="#008000">Administrator@M3A78</font> <font color="#808000">/D/tmp/win-build-env-002/coreboot</font>
<br clear="all"/>
+
$ _
 +
:4. First, build the seabios payload:
 +
  $ <b>cd ../seabios/seabios-for-coreboot</b><br>
 +
  <font color="#008000">Administrator@M3A78</font> <font color="#808000">/D/tmp/win-build-env-002/seabios/seabios-for-coreboot</font>
 +
$ <b>make</b>
 +
&nbsp; Compiling whole program out/ccode.16.s
 +
&nbsp; Compiling to assembler out/asm-offsets.s
 +
&nbsp; Generating offset file out/asm-offsets.h
 +
&nbsp; Compiling (16bit) out/code16.o
 +
&nbsp; Compiling whole program out/ccode32flat.o
 +
src/coreboot.c: In function 'ulzma':
 +
src/coreboot.c:329:9: warning: format '%d' expects type 'int', but argument 3 has type 'long unsigned int'
 +
&nbsp; Compiling whole program out/code32seg.o
 +
&nbsp; Building ld scripts (version &quot;0.6.1-20100928_165201-m3a78&quot;)
 +
Fixed space: 0xe05b-0x10000 total: 8101 slack: 2 Percent slack: 0.0%
 +
16bit size: 37760
 +
32bit segmented size: 2416
 +
32bit flat size: 50752
 +
&nbsp; Linking out/rom16.o
 +
&nbsp; Stripping out/rom16.strip.o
 +
&nbsp; Linking out/rom32seg.o
 +
&nbsp; Stripping out/rom32seg.strip.o
 +
&nbsp; Linking out/rom.o
 +
&nbsp; Prepping out/bios.bin
 +
Total size: 90928 Free space: 40144 Percent used: 69.4% (128KiB rom)</font></p>
 +
:5. Now configure coreboot:
 +
$ <b>cd ../coreboot</b><br>
 +
<font color="#008000">Administrator@M3A78</font> <font color="#808000">/D/tmp/win-build-env-002/coreboot</font>
 +
$ <b>make oldconfig</b>
  
:4. At the <tt>$</tt> prompt, type <tt>make oldconfig</tt>. Answer the configuration questions. For this example, defaults were used for all questions except:
+
Answer the configuration questions. For this example, defaults were used for all questions except:
 
  mainboard vendor        : 3 AMD
 
  mainboard vendor        : 3 AMD
 
  mainboard model          : 9 Serengeti Cheetah (Fam10)
 
  mainboard model          : 9 Serengeti Cheetah (Fam10)
 
  rom chip size            : 3 512 KB
 
  rom chip size            : 3 512 KB
 
  add a payload            : 2 An ELF executable payload
 
  add a payload            : 2 An ELF executable payload
  Payload path and filename: ../payloads/bios.bin.elf-0.6.0
+
  Payload path and filename: ../seabios/seabios-for-coreboot/out/bios.bin.elf
  
:5. At the <tt>$</tt> prompt, type <tt>make</tt>. After a few seconds, the build should complete:
+
:6. At the <tt>$</tt> prompt, type <tt>make</tt>. After a few seconds, the build should complete:
[[Image:winbuild-build-complete.png|left]]
+
    CC        cpu/x86/mtrr/mtrr.o
<br clear="all"/>
+
    CC        cpu/x86/pae/pgtbl.o
 +
    AR        coreboot.a
 +
    CC        coreboot_ram.o
 +
    CC        coreboot_ram
 +
    CBFS      coreboot.rom
 +
    PAYLOAD    ../seabios/seabios-for-coreboot/out/bios.bin.elf (compression: LZMA)
 +
    CBFSPRINT  coreboot.rom<br>
 +
coreboot.rom: 512 kB, bootblocksize 2390, romsize 524288, offset 0x0
 +
Alignment: 64 bytes<br>
 +
Name                          Offset    Type        Size
 +
fallback/romstage              0x0        stage        69016
 +
fallback/coreboot_ram          0x10e00    stage        47261
 +
fallback/payload              0x1c700    payload      45815
 +
(empty)                        0x27a40    null        359458<br>
 +
<font color="#008000">Administrator@M3A78</font> <font color="#808000">/D/tmp/win-build-env-002/coreboot</font>
 +
$ _
  
 
The final bios image is in file coreboot\build\coreboot.rom:
 
The final bios image is in file coreboot\build\coreboot.rom:
Line 93: Line 136:
 
09/03/10  12:23 PM          524,288 coreboot.rom
 
09/03/10  12:23 PM          524,288 coreboot.rom
 
</pre>
 
</pre>
 +
 
==Test using simnow (optional, AMD projects only)==
 
==Test using simnow (optional, AMD projects only)==
 
The AMD simnow application is a software simulation of an AMD processor and reference board. Its accuracy is impressive, allowing it to boot an unmodified bios and operating system. To test the bios, download and install the public version of AMD's [http://developer.amd.com/cpu/simnow/Pages/default.aspx simnow]. This example uses version <tt>simnow-win64-4.6.2pub.exe</tt>, a recent public version for Windows. Note that simnow requires a 64-bit operation system. Add an environment variable named <tt>simnow</tt> that points to the directory where simnow is installed:
 
The AMD simnow application is a software simulation of an AMD processor and reference board. Its accuracy is impressive, allowing it to boot an unmodified bios and operating system. To test the bios, download and install the public version of AMD's [http://developer.amd.com/cpu/simnow/Pages/default.aspx simnow]. This example uses version <tt>simnow-win64-4.6.2pub.exe</tt>, a recent public version for Windows. Note that simnow requires a 64-bit operation system. Add an environment variable named <tt>simnow</tt> that points to the directory where simnow is installed:

Revision as of 22:57, 28 September 2010

Coreboot firmware is most often built from the linux environment. Because many bios developers are more familiar with Windows than linux, it is useful to know how to build coreboot on a Windows system.

Setup the coreboot build environment (long method)

The gnu tools needed to build coreboot have already been ported to Windows. They must be downloaded, customized, and installed. Here are the steps:

  1. Download and install a native msys+mingw environment on your Windows computer.
  2. Build and install cross compile versions of binutils and gcc that run on Windows and target 32-bit x86 linux.


Step 1 involves downloading and decompressing mingw and msys, both of which contain several components. See mingw.org for details.

Step 2: Once msys+mingw is installed, download and build cross compiler versions of gcc and binutils that produce elf output for 32-bit x86 linux. Use util/crossgcc/buildgcc for this purpose:

Administrator@M3A78 ~
$ mkdir /gcc450
Administrator@M3A78 ~ $ cd /gcc450/
Administrator@M3A78 /gcc450 $ /d/tmp/xgcc/coreboot/util/crossgcc/buildgcc-450 Welcome to the coresystems cross toolchain builder v1.01 (May 18th, 2010)
Downloading tar balls ... * gmp-5.0.1.tar.bz2 (downloading)SYSTEM_WGETRC = c:/progra~1/wget/etc/wgetrc syswgetrc = D:\tmp\xgcc\msys/etc/wgetrc
* mpfr-2.4.2.tar.bz2 (downloading)SYSTEM_WGETRC = c:/progra~1/wget/etc/wgetrc syswgetrc = D:\tmp\xgcc\msys/etc/wgetrc
* mpc-0.8.2.tar.gz (downloading)SYSTEM_WGETRC = c:/progra~1/wget/etc/wgetrc syswgetrc = D:\tmp\xgcc\msys/etc/wgetrc
* libelf-0.8.13.tar.gz (downloading)SYSTEM_WGETRC = c:/progra~1/wget/etc/wgetrc syswgetrc = D:\tmp\xgcc\msys/etc/wgetrc
* gcc-core-4.5.0.tar.bz2 (downloading)SYSTEM_WGETRC = c:/progra~1/wget/etc/wgetrc syswgetrc = D:\tmp\xgcc\msys/etc/wgetrc
* binutils-2.20.1.tar.bz2 (downloading)SYSTEM_WGETRC = c:/progra~1/wget/etc/wgetrc syswgetrc = D:\tmp\xgcc\msys/etc/wgetrc
* gdb-7.1.tar.bz2 (downloading)SYSTEM_WGETRC = c:/progra~1/wget/etc/wgetrc syswgetrc = D:\tmp\xgcc\msys/etc/wgetrc
Downloaded tar balls ... ok Unpacking and patching ... * gmp-5.0.1.tar.bz2 * mpfr-2.4.2.tar.bz2 * mpc-0.8.2.tar.gz * libelf-0.8.13.tar.gz * gcc-core-4.5.0.tar.bz2 * binutils-2.20.1.tar.bz2 * gdb-7.1.tar.bz2 Unpacked and patched ... ok Building GMP 5.0.1 ... ok Building MPFR 2.4.2 ... ok Building MPC 0.8.2 ... ok Building libelf 0.8.13 ... ok Building binutils 2.20.1 ... ok Building GCC 4.5.0 ... ok Building GDB 7.1 ... ok Cleaning up... ok
You can now run your i386-elf cross toolchain from /gcc450/xgcc.

Setup the coreboot build environment (shortcut method)

Getting through steps 1 and 2 from scratch takes a bit of work. As a shortcut, a coreboot-ready msys+mingw is included in the sample project. Decompress the sample project into any directory on your Windows computer. Note: Avoid the use of spaces in the project path and directory name. In the top level of the sample project is directory msys. This is the complete coreboot-ready msys+mingw. The msys.bat file in this directory starts the msys+mingw build environment. The standard tool names target the local Windows environment. To invoke tools that target linux, use the ones in the gcc444 or gcc450 directory. For example, gcc -c hello.c builds a Windows object, while /gcc450/xgcc/bin/i386-elf-gcc hello.c builds a linux object.

In addition to the coreboot ready msys+mingw build environment, the sample project contains:

  1. coreboot directory. Replace this sample coreboot source code with the one you want to build.
  2. seabios directory. This directory contains seabios source code, used as a sample payload.
  3. simnow directory. Helper files for testing on the simnow simulator (AMD projects only).
  4. tools directory. This directory contains needed tools that are not part of coreboot, msys, or mingw.
  5. go.bat. This batch file sets up environment variables needed for cross compiling, and switches to the coreboot directory.

Build the coreboot project

Here are step-by-step instructions for building a coreboot based bios on a windows machine using the shortcut build environment setup method:

1. Decompress the sample project into any directory. Note: Avoid the use of spaces in the project path and directory name. Use 7-zip for decompression.
2. Replace the sample coreboot source code (rev 5775) with your own. The directory must be named coreboot.
3. Using Windows explorer, click on go.bat to start the build environment. It will look something like this:
Administrator@M3A78 /D/tmp/win-build-env-002/coreboot
$ _
4. First, build the seabios payload:
 $ cd ../seabios/seabios-for-coreboot
Administrator@M3A78 /D/tmp/win-build-env-002/seabios/seabios-for-coreboot $ make   Compiling whole program out/ccode.16.s   Compiling to assembler out/asm-offsets.s   Generating offset file out/asm-offsets.h   Compiling (16bit) out/code16.o   Compiling whole program out/ccode32flat.o src/coreboot.c: In function 'ulzma': src/coreboot.c:329:9: warning: format '%d' expects type 'int', but argument 3 has type 'long unsigned int'   Compiling whole program out/code32seg.o   Building ld scripts (version "0.6.1-20100928_165201-m3a78") Fixed space: 0xe05b-0x10000 total: 8101 slack: 2 Percent slack: 0.0% 16bit size: 37760 32bit segmented size: 2416 32bit flat size: 50752   Linking out/rom16.o   Stripping out/rom16.strip.o   Linking out/rom32seg.o   Stripping out/rom32seg.strip.o   Linking out/rom.o   Prepping out/bios.bin Total size: 90928 Free space: 40144 Percent used: 69.4% (128KiB rom)</font></p>
5. Now configure coreboot:
$ cd ../coreboot
Administrator@M3A78 /D/tmp/win-build-env-002/coreboot $ make oldconfig

Answer the configuration questions. For this example, defaults were used for all questions except:

mainboard vendor         : 3 AMD
mainboard model          : 9 Serengeti Cheetah (Fam10)
rom chip size            : 3 512 KB
add a payload            : 2 An ELF executable payload
Payload path and filename: ../seabios/seabios-for-coreboot/out/bios.bin.elf
6. At the $ prompt, type make. After a few seconds, the build should complete:
    CC         cpu/x86/mtrr/mtrr.o
    CC         cpu/x86/pae/pgtbl.o
    AR         coreboot.a
    CC         coreboot_ram.o
    CC         coreboot_ram
    CBFS       coreboot.rom
    PAYLOAD    ../seabios/seabios-for-coreboot/out/bios.bin.elf (compression: LZMA)
    CBFSPRINT  coreboot.rom
coreboot.rom: 512 kB, bootblocksize 2390, romsize 524288, offset 0x0 Alignment: 64 bytes
Name Offset Type Size fallback/romstage 0x0 stage 69016 fallback/coreboot_ram 0x10e00 stage 47261 fallback/payload 0x1c700 payload 45815 (empty) 0x27a40 null 359458
Administrator@M3A78 /D/tmp/win-build-env-002/coreboot $ _

The final bios image is in file coreboot\build\coreboot.rom:

 Directory of D:\tmp\win-build-env-001\coreboot\build

09/03/10  12:23 PM           524,288 coreboot.rom

Test using simnow (optional, AMD projects only)

The AMD simnow application is a software simulation of an AMD processor and reference board. Its accuracy is impressive, allowing it to boot an unmodified bios and operating system. To test the bios, download and install the public version of AMD's simnow. This example uses version simnow-win64-4.6.2pub.exe, a recent public version for Windows. Note that simnow requires a 64-bit operation system. Add an environment variable named simnow that points to the directory where simnow is installed:

Winbuild-simnow-env.png


From Windows explorer, launch coreboot\simnow\simnow.bat. This will open 3 windows:

Winbuild-simnow-main.png


Winbuild-simnow-cmd.png


Winbuild-putty0.png


Optionally, setup a boot cd-rom, floppy, or hard disk image:

Winbuild-drive-image.png


Now, start the simulation by clicking the 'Run Simulation' button.

Winbuild-simnow-run.png


Putty will capture serial debug messages:

Winbuild-putty-output.png


After a few seconds, video will appear:

Winbuild-vbios-banner.png


At this point, the simulation hesitates while waiting for a keyboard response. Press a key while the mouse cursor is in the simnow window to avoid the delay. Alternatively, modify keyboard.c.

Next, the seabios payload executes:

Winbuild-seabios.png


If the optional disk image was supplied, seabios will attempt to boot it:

Winbuild-windows1.png


Looking good...

Winbuild-windows2.png


Oops, some ACPI debugging is needed here...

Winbuild-windows3.png


Known problems with this demo

  1. An unwanted stack access by an AP core during cache as ram disable causes a crash. The work-around used in the sample project is to remove AP cores from the simnow model. A proper fix is being developed.
  2. PS/2 Keyboard init timeout causes boot delay (workaround).
  3. PS/2 keyboard not working.

Known problems with windows building

  1. Libncurses is not available, which prevents make menuconfig from building. Work-around: use make oldconfig instead.