OpenBIOS: Difference between revisions

From OpenBIOS
Jump to navigation Jump to search
No edit summary
 
(29 intermediate revisions by 4 users not shown)
Line 3: Line 3:
Welcome to the OpenBIOS download page. Here you'll find releases of OpenBIOS components.
Welcome to the OpenBIOS download page. Here you'll find releases of OpenBIOS components.


We are currently working hard toward the release of OpenBIOS v1.0. See the [http://bugzilla.openbios.org/ OpenBIOS issue tracker] for milestones, tasks and open bugs.
After 4 years of hard work, OpenBIOS v1.1 has been released. The new features include:
  * Internal memory API (OFMEM) implementation
  * Forth Source Debugger
  * 64-bit 1275 6d5 implementation
  * Forth Local Variables
  * Internal libopenbios code reorganisation


All the releases on this page are rather old. It is suggested that you have a look at the [[#Snapshots|snapshots section]] to get a development snapshot of OpenBIOS.
See the [https://github.com/openbios/openbios/issues OpenBIOS issue tracker] for milestones, tasks and open bugs.


= OpenBIOS =
= OpenBIOS =
Line 11: Line 16:
Download the latest release of OpenBIOS including the Forth kernel and all of the IEEE 1275-1994 compliant Forth code for user interface, client interface and device interface.
Download the latest release of OpenBIOS including the Forth kernel and all of the IEEE 1275-1994 compliant Forth code for user interface, client interface and device interface.


Latest release version is: [http://www.openbios.org/viewvc/openbios-devel.tar.gz?view=tar&root=OpenBIOS&pathrev=96 OpenBIOS 1.0alpha1] (2006-10-12)
Latest release version is: [https://github.com/openbios/openbios/archive/v1.1.zip OpenBIOS 1.1] (2013-05-04)


'''NOTE:''' The FCODE utilities are no longer part of the main OpenBIOS distribution. Have a look at the [[FCODE suite]] if you are looking for toke and detok.
'''NOTE:''' The FCODE utilities are no longer part of the main OpenBIOS distribution. Have a look at the [[FCODE suite]] if you are looking for toke and detok.
= Status and use cases =
OpenBIOS can be used directly as a boot ROM for [http://qemu.org/ QEMU] system emulators for PPC, PPC64, Sparc32 and Sparc64.
OpenBIOS/SPARC32 is currently able to boot the following OS/kernels:
  * Linux
  * NetBSD
  * OpenBSD
  * Solaris
OpenBIOS/SPARC64 is currently able to boot the following OS/kernels:
  * Linux
  * NetBSD
  * OpenBSD
  * FreeBSD
  * HelenOS
OpenBIOS/PPC is currently able to boot the following OS/kernels:
  * Linux
  * HelenOS
  * Darwin/Mac OS X
The following operating systems will partially boot, but may suffer from some emulation bugs under QEMU:
  * FreeBSD
  * NetBSD
  * Mac OS 9
[http://www.coreboot.org Coreboot] can use OpenBIOS as a payload on x86.
Do not try to put OpenBIOS in a real boot ROM, it will not work and may damage your hardware!


== Kernel ==
== Kernel ==
Line 26: Line 59:
== FCode Suite ==
== FCode Suite ==


Download the latest version of the FCode Suite, including an FCode detokenizer, an FCode tokenizer and the romheader utility.
To download the latest version of the FCode Suite, including an FCode detokenizer, an FCode tokenizer and the romheader utility, please go to the [[FCODE suite|FCode Suite page]].
 
== Flashing ==
/dev/bios is obsolete and has been replaced by a new and better utility. Please download a coreboot snapshot and use the [[FlashRom|flashrom utility]] from ''coreboot-v2/util/flashrom''.
 
= Development Repository =
 
OpenBIOS keeps its development tree in a [http://git-scm.com/ git ] repository. If you do not want to use git, please have a look at the [[#Snapshots|Snapshots]]  below.
 
== Anonymous access ==
 
You can check it out as follows:
  $ git clone https://github.com/openbios/openbios.git
 
or for checking out the source code for the OpenBIOS FCode Suite:
  $ git clone https://github.com/openbios/fcode-utils.git
 
== Developer access ==


Go to the [[FCODE suite|FCode Suite page]] (2006-09-21)
Access for developers is very similar to anonymous access. Just add your github username as follows when checking out the repository:
  $ git clone https://username@github.com/openbios/openbios.git


=== detok ===
= Source code browsing =
Download the latest release of detok, the OpenBIOS FCode detokenizer.


Latest release version is: [http://www.openbios.org/viewcvs/fcode-utils.tar.gz?view=tar&root=OpenBIOS&pathrev=96 detok-1.0.0] (2006-10-15)
You can also browse the [https://github.com/openbios/openbios OpenBIOS github repository] online.


=== toke ===
= Snapshots =
Download the latest release of toke, the OpenBIOS FCode tokenizer.


Latest release version is: [http://www.openbios.org/viewcvs/fcode-utils.tar.gz?view=tar&root=OpenBIOS&pathrev=95 toke-1.0.1] (2006-10-15)
There is currently no archive of snapshots available for OpenBIOS. You can use the [https://github.com/openbios/openbios source code browser] to download a ZIP archive of any revision.


=== romheaders ===
Alternatively you can also download the [https://github.com/openbios/openbios/archive/master.zip most current snapshot] directly.
Romheaders is a small utility to dump the pci header information from pci rom images in human readable form. Romheaders is [[FCODE Suite|part of the FCODE suite]] now.


== Flashing ==
= Building OpenBIOS =
/dev/bios is obsolete and has been replaced by a new and better utility. Please download a LinuxBIOS snapshot and use the [[FlashRom|flashrom utility]] from ''LinuxBIOSv2/util/flashrom''.
 
Download fcode suite:
 
  $ git clone https://github.com/openbios/fcode-utils.git
 
Build the needed programs inside the fcode-utils-devel folder:
 
  $ make
 
Install the programs:


= Development Repository =
  $ make install


OpenBIOS keeps its development tree in a [http://subversion.tigris.org/ Subversion ] repository. If you do not want to use Subversion, please have a look at the [[Downloads#Snapshots|Snapshots]]  below.
Download OpenBIOS:


== Anonymous access ==
  $ git clone https://github.com/openbios/openbios.git


You can check it out as follows:
Select the build targets:
   $ svn co svn://openbios.org/openbios/openbios-devel
   $ ./config/scripts/switch-arch sparc32 sparc64 x86 ppc amd64


if you want a specific revision: (see the Confirmed working svn revisions page)
Build OpenBIOS:
   $ svn co svn://openbios.org/openbios/openbios-devel -r 4
   $ make
or
  $ make build-verbose


or for checking out the source code for the OpenBIOS FCode Suite:
  $ svn co svn://openbios.org/openbios/fcode-suite


If your company installed a firewall that blocks the svn port (3690) you can also check out using the webdav frontend:
OpenBIOS can even be cross-compiled on a host which is different type (big vs. little endian and 32 vs. 64 bits) from the target. At least Linux and OpenBSD hosts are known to work.


$ svn co <nowiki>https://www.openbios.org/openbios-svn/openbios-devel</nowiki>
If your cross tools use different prefix from what the makefiles assume, the prefix can be overridden with:
  $ make build-verbose TARGET=powerpc-elf-


or
or
  $ make -C obj-ppc CC=powerpc-elf-gcc


$ svn co <nowiki>https://www.openbios.org/openbios-svn/fcode-suite</nowiki>
The OpenBIOS binaries (typically openbios-builtin.elf) can be found in obj- subdirectories. The Unix executable version (native only) is named openbios-unix.


== Developer access ==


Access for developers is very similar to anonymous access. Just add your subversion username as follows when checking out the repository:
= Additional Resources =
  $ svn co svn://username@openbios.org/openbios/openbios-devel
[http://www.mediafire.com/download/wy5xgj2hwjp8k4k/AWOS_Cross-Compilers.zip PowerPC, x86, ARM, and Sparc elf cross-compilers for Mac OS X ]
*This compiler uses a unsupported compiler prefix. To use it, set the CROSS_COMPILE variable to "ppc-elf-" before running the switch-arch script.


Subversion has commands very similar to CVS.
Example:
  CROSS_COMPILE=ppc-elf- ./switch-arch ppc


= Source code browsing =
= Notes for Building on Mac OS X =
There is a known build issue when building on Mac OS 10.6. The switch-arch script  will report your computer as 32 bit (x86) when it is really 64 bit (amd64). If you see the message "''panic: segmentation violation at …''" while building, you probably have this problem.


You can also browse the [http://www.openbios.org/viewvc/?root=OpenBIOS OpenBIOS subversion repository] online.
If this happens to you, try setting the HOSTARCH variable before using the switch-arch script.  


= Snapshots =
Example:
  HOSTARCH=amd64 ./switch-arch ppc


There is currently no archive of snapshots available for OpenBIOS. You can use the [http://www.openbios.org/viewvc/?root=OpenBIOS source code browser] to download a gzipped tar archive of any revision.


Alternatively you can also download the [http://www.openbios.org/viewvc/openbios-devel.tar.gz?root=OpenBIOS&view=tar most current snapshot] directly.
= Troubleshooting =
Seeing this message:  ''Unable to locate toke executable from the fcode-utils package - aborting''
<br>- Install the fcode suite first before trying to build OpenBIOS.


= More on Subversion =


* [http://svnbook.red-bean.com/ Subversion book] - this online book is the best SVN documentation available online.
__NOEDITSECTION__
* [http://subversion.tigris.org/ Subversion homepage]

Latest revision as of 23:43, 9 July 2016

OpenBIOS - Code Releases

Welcome to the OpenBIOS download page. Here you'll find releases of OpenBIOS components.

After 4 years of hard work, OpenBIOS v1.1 has been released. The new features include:

  * Internal memory API (OFMEM) implementation
  * Forth Source Debugger
  * 64-bit 1275 6d5 implementation
  * Forth Local Variables
  * Internal libopenbios code reorganisation

See the OpenBIOS issue tracker for milestones, tasks and open bugs.

OpenBIOS

Download the latest release of OpenBIOS including the Forth kernel and all of the IEEE 1275-1994 compliant Forth code for user interface, client interface and device interface.

Latest release version is: OpenBIOS 1.1 (2013-05-04)

NOTE: The FCODE utilities are no longer part of the main OpenBIOS distribution. Have a look at the FCODE suite if you are looking for toke and detok.

Status and use cases

OpenBIOS can be used directly as a boot ROM for QEMU system emulators for PPC, PPC64, Sparc32 and Sparc64.

OpenBIOS/SPARC32 is currently able to boot the following OS/kernels:

  * Linux
  * NetBSD
  * OpenBSD
  * Solaris

OpenBIOS/SPARC64 is currently able to boot the following OS/kernels:

  * Linux
  * NetBSD
  * OpenBSD
  * FreeBSD
  * HelenOS

OpenBIOS/PPC is currently able to boot the following OS/kernels:

  * Linux
  * HelenOS
  * Darwin/Mac OS X

The following operating systems will partially boot, but may suffer from some emulation bugs under QEMU:

  * FreeBSD
  * NetBSD
  * Mac OS 9

Coreboot can use OpenBIOS as a payload on x86.

Do not try to put OpenBIOS in a real boot ROM, it will not work and may damage your hardware!

Kernel

There is also an ancient stand-alone version of the OpenBIOS Forth kernel BeginAgain.

The last released stand-alone version is: BeginAgain 1.1 (2003-10-12).

NOTE: You should use the latest version of BeginAgain that is present in the complete OpenBIOS release above. It is much newer than BeginAgain 1.1 and it supports cross compiling and lots of other nifty features. BeginAgain 1.1 is here for educational purposes only: The core binary is only 6k on x86.

Development Environment

FCode Suite

To download the latest version of the FCode Suite, including an FCode detokenizer, an FCode tokenizer and the romheader utility, please go to the FCode Suite page.

Flashing

/dev/bios is obsolete and has been replaced by a new and better utility. Please download a coreboot snapshot and use the flashrom utility from coreboot-v2/util/flashrom.

Development Repository

OpenBIOS keeps its development tree in a git repository. If you do not want to use git, please have a look at the Snapshots below.

Anonymous access

You can check it out as follows:

 $ git clone https://github.com/openbios/openbios.git

or for checking out the source code for the OpenBIOS FCode Suite:

 $ git clone https://github.com/openbios/fcode-utils.git

Developer access

Access for developers is very similar to anonymous access. Just add your github username as follows when checking out the repository:

  $ git clone https://username@github.com/openbios/openbios.git

Source code browsing

You can also browse the OpenBIOS github repository online.

Snapshots

There is currently no archive of snapshots available for OpenBIOS. You can use the source code browser to download a ZIP archive of any revision.

Alternatively you can also download the most current snapshot directly.

Building OpenBIOS

Download fcode suite:

 $ git clone https://github.com/openbios/fcode-utils.git

Build the needed programs inside the fcode-utils-devel folder:

 $ make

Install the programs:

 $ make install

Download OpenBIOS:

 $ git clone https://github.com/openbios/openbios.git

Select the build targets:

 $ ./config/scripts/switch-arch sparc32 sparc64 x86 ppc amd64

Build OpenBIOS:

 $ make

or

 $ make build-verbose


OpenBIOS can even be cross-compiled on a host which is different type (big vs. little endian and 32 vs. 64 bits) from the target. At least Linux and OpenBSD hosts are known to work.

If your cross tools use different prefix from what the makefiles assume, the prefix can be overridden with:

  $ make build-verbose TARGET=powerpc-elf-

or

  $ make -C obj-ppc CC=powerpc-elf-gcc

The OpenBIOS binaries (typically openbios-builtin.elf) can be found in obj- subdirectories. The Unix executable version (native only) is named openbios-unix.


Additional Resources

PowerPC, x86, ARM, and Sparc elf cross-compilers for Mac OS X

  • This compiler uses a unsupported compiler prefix. To use it, set the CROSS_COMPILE variable to "ppc-elf-" before running the switch-arch script.

Example:

  CROSS_COMPILE=ppc-elf- ./switch-arch ppc

Notes for Building on Mac OS X

There is a known build issue when building on Mac OS 10.6. The switch-arch script will report your computer as 32 bit (x86) when it is really 64 bit (amd64). If you see the message "panic: segmentation violation at …" while building, you probably have this problem.

If this happens to you, try setting the HOSTARCH variable before using the switch-arch script.

Example:

  HOSTARCH=amd64 ./switch-arch ppc


Troubleshooting

Seeing this message: Unable to locate toke executable from the fcode-utils package - aborting
- Install the fcode suite first before trying to build OpenBIOS.