Open Firmware: Difference between revisions

From OpenBIOS
Jump to navigation Jump to search
mNo edit summary
m (New patch for config.fth with "create pc-linux" enabled)
Line 26: Line 26:
  Index: config.fth
  Index: config.fth
  ===================================================================
  ===================================================================
  --- config.fth  (revision 548)
  --- config.fth  (revision 599)
  +++ config.fth  (working copy)
  +++ config.fth  (working copy)
  @@ -9,7 +9,7 @@
  @@ -2,14 +2,14 @@
  \ - Image Format - Example Media - previous stage bootloader
purpose: Establish configuration definitions
 
  \ - (Syslinux) COM32 format - USB Key w/ FAT FS - Syslinux
create pc              \ Demo version for generic PC
-\ create pc-linux      \ Demo version for generic PC and Linux
+create pc-linux        \ Demo version for generic PC and Linux
\ create pc-serial    \ Demo version for generic PC
\ --- The environment that "boots" OFW ---
\ - Image Format - Example Media - previous stage bootloader
\ - (Syslinux) COM32 format - USB Key w/ FAT FS - Syslinux
  -create syslinux-loaded
  -create syslinux-loaded
  +\ create syslinux-loaded
  +\ create syslinux-loaded
 
  \ - Linux kernel format - USB Key w/ FAT FS - LinuxBIOS w/ stripped Linux payload  
\ - Linux kernel format - USB Key w/ FAT FS - LinuxBIOS w/ stripped Linux payload
  \ create bzimage-loaded
\ create bzimage-loaded
  @@ -19,7 +19,7 @@
  @@ -19,10 +19,10 @@
  \ create etherboot-variant  \ Enable additional tweaks for Etherboot
\ create etherboot-variant  \ Enable additional tweaks for Etherboot
 
  \ - ELF format (no pheader) - ROM - LinuxBIOS direct
\ - ELF format (no pheader) - ROM - LinuxBIOS direct
  -\ create linuxbios-loaded
  -\ create linuxbios-loaded
  +create linuxbios-loaded
  +create linuxbios-loaded
 
  \ Load and run in qemu
\ Load and run in qemu
  -\ create qemu-loaded  
  -\ create qemu-loaded  
  +create qemu-loaded  
  +create qemu-loaded  
[ifdef] pc-serial
create serial-console
@@ -47,7 +47,7 @@
\ the point where Linux starts using the MMU.  It isn't strictly
\ necessary to use virtual mode if you just want to boot Linux
\ and then have OFW disappear.
-create virtual-mode
+\ create virtual-mode
create pc
create linux-support
[then]


== Building ==
== Building ==

Revision as of 15:40, 3 September 2007

Introduction

In 2006 the company of Open Firmware inventor Mitch Bradley, Firmworks, Inc, released their Open Firmware implementation under a BSD license. This code shares some code with SUN's OpenBOOT implementation. It supports the x86 architecture and runs, amongst others, as a LinuxBIOS payload. It is the firmware implementation on the OLPC.

Download

The code can be browsed online with the ViewVC facility.

The repository is available through Subversion:

You can check it out as follows:

 $ svn co svn://openbios.org/openfirmware/

if you want a specific revision:

 $ svn co svn://openbios.org/openfirmware -r 35

If your company installed a firewall that blocks the svn port (3690) you can also check out using the webdav frontend:

$ svn co https://www.openbios.org/openfirmware-svn/ openfirmware


LinuxBIOS

You should change openfirmware/cpu/x86/pc/biosload/config.fth:

Index: config.fth
===================================================================
--- config.fth  (revision 599)
+++ config.fth  (working copy)
@@ -2,14 +2,14 @@
purpose: Establish configuration definitions

create pc              \ Demo version for generic PC
-\ create pc-linux      \ Demo version for generic PC and Linux
+create pc-linux        \ Demo version for generic PC and Linux
\ create pc-serial     \ Demo version for generic PC

\ --- The environment that "boots" OFW ---
\ - Image Format - Example Media - previous stage bootloader

\ - (Syslinux) COM32 format - USB Key w/ FAT FS - Syslinux
-create syslinux-loaded
+\ create syslinux-loaded

\ - Linux kernel format - USB Key w/ FAT FS - LinuxBIOS w/ stripped Linux payload
\ create bzimage-loaded
@@ -19,10 +19,10 @@
\ create etherboot-variant  \ Enable additional tweaks for Etherboot

\ - ELF format (no pheader) - ROM - LinuxBIOS direct
-\ create linuxbios-loaded
+create linuxbios-loaded

\ Load and run in qemu
-\ create qemu-loaded 
+create qemu-loaded 

[ifdef] pc-serial
create serial-console
@@ -47,7 +47,7 @@
\ the point where Linux starts using the MMU.  It isn't strictly
\ necessary to use virtual mode if you just want to boot Linux
\ and then have OFW disappear.
-create virtual-mode
+\ create virtual-mode
create pc
create linux-support
[then]


Building

Software Requirements:

   qemu-0.9.0 + ROMSIZE-patch
   Open Firmware rev. >= 500
   LinuxBIOS >= v2

Patch and build qemu

Get the patch from http://www.freimann.org/qemu_biossize.patch and apply it against qemu-0.9.0.

       tar xvfz qemu-0.9.0.tar.gz
       cd qemu-0.9.0
       wget http://www.freimann.org/qemu_biossize.patch
       patch -p1 < qemu_biossize.patch

Make sure that you have gcc-3.x installed, then

       ./config && make && make install


Build Open Firmware

Get Open Firmware from Subversion

       svn co svn://openbios.org/openfirmware

Change to the build directory of the biosload build.

       cd cpu/x86/pc/biosload/

To change the config file of Open Firmware you can either use the above patch, or you can edit config.fth with your favorite editor (vi!!1!). Uncomment the lines

       create linuxbios-loaded
       create qemu-loaded

Comment out the line with

       create syslinux-loaded

Now change to the build directory and type "make"

       cd build
       make

After make is finished there should be a file "ofwlb.elf" in the same directory. Copy this to your LinuxBIOSv[x] directory.

Build LinuxBIOS

Follow the instructions in the LinuxBIOS documentation. Make sure that you use the ofwlb.elf file as your payload. It is also very imortant that the ROMSIZE for LinuxBIOS and qemu correspond with each other.


Run it

   qemu  -L LinuxBIOSv3/build -hda path/to/disk.img -serial `tty` -nographic