coreboot for the Switch
Find a file
Ronald G. Minnich 3311076a44 Early setup support for the initram phase.
Signed-off-by: Ronald G. Minnich <rminnich@gmail.com>
Acked-by: Stefan Reinauer <stepan@coresystems.de>


git-svn-id: svn://coreboot.org/repository/LinuxBIOSv3@345 f3766cd6-281f-0410-b1cd-43a5c92072e9
2007-06-05 17:40:18 +00:00
arch Cosmetic fixes (trivial). 2007-06-02 12:28:58 +00:00
device Fix various license headers. 2007-05-20 20:35:59 +00:00
doc/design More information, we are on the next step, which is smbus support for 2007-06-01 23:13:15 +00:00
include no more linker hacks in v3, except for the .S parts. 2007-06-04 15:15:05 +00:00
lib This fixes ram.c correctly for cases where we link instead of 2007-06-01 04:41:42 +00:00
mainboard Use the same naming convention and placement for "include guards" in 2007-05-21 06:48:47 +00:00
northbridge Use the same naming convention and placement for "include guards" in 2007-05-21 06:48:47 +00:00
southbridge Early setup support for the initram phase. 2007-06-05 17:40:18 +00:00
superio Use the same naming convention and placement for "include guards" in 2007-05-21 06:48:47 +00:00
util Fix various license headers. 2007-05-20 20:35:59 +00:00
COPYING filling in 2006-10-06 19:19:14 +00:00
HACKING Fix various license headers. 2007-05-20 20:35:59 +00:00
Kconfig Payload selection dialog improvements (not fully usable, yet). 2007-05-21 14:51:57 +00:00
Makefile Cosmetic fixes (trivial). 2007-06-02 12:28:58 +00:00
README Short installation instructions for LinuxBIOSv3 (trivial). 2007-05-09 10:26:19 +00:00

-------------------------------------------------------------------------------
LinuxBIOS README
-------------------------------------------------------------------------------

LinuxBIOS is a Free Software project aimed at replacing the proprietary
BIOS you can find in most of today's computers.

It performs just a little bit of hardware initialization and then executes
one of many possible payloads, e.g. a Linux kernel.


Payloads
--------

After the basic initialization of the hardware has been performed, any
desired "payload" can be started by LinuxBIOS. Examples include:

 * A Linux kernel
 * FILO (a simple bootloader with filesystem support)
 * GRUB2 (a free bootloader; support is in development)
 * OpenBIOS (a free IEEE1275-1994 Open Firmware implementation)
 * Open Firmware (a free IEEE1275-1994 Open Firmware implementation)
 * SmartFirmware (a free IEEE1275-1994 Open Firmware implementation)
 * GNUFI (a free, UEFI-compatible firmware)
 * Etherboot (for network booting and booting from raw IDE or FILO)
 * ADLO (for booting Windows 2000 or OpenBSD)
 * Plan 9 (a distributed operating system)
 * memtest86 (for testing your RAM)


Supported Hardware
------------------

LinuxBIOS supports a wide range of chipsets, devices, and mainboards.

For details please consult:

 * http://www.linuxbios.org/Supported_Motherboards
 * http://www.linuxbios.org/Supported_Chipsets_and_Devices


Building and Installing
-----------------------

Note: Currently only the x86 QEMU target is supported in LinuxBIOSv3.

1) Build a payload:

  For example: FILO.

2) Configure LinuxBIOS:

  $ make menuconfig

  Select at least the desired mainboard vendor, the mainboard device,
  the size of your ROM chip, and a payload.

3) Build the LinuxBIOS ROM image:

  $ make

  The generated ROM image is build/linuxbios.rom.

4) You can now test the LinuxBIOS image using:

  $ qemu -L build -hda /dev/zero -serial stdio

  If you have a full QEMU image with a Linux distribution installed,
  you can boot that Linux kernel by using a proper FILO payload and typing:

  $ qemu -L build -hda /tmp/qemu.img -serial stdio


Website and Mailing List
------------------------

Further details on the project, a FAQ, many HOWTOs, news, development
guidelines and more can be found on the LinuxBIOS website:

  http://www.linuxbios.org

You can contact us directly on the LinuxBIOS mailing list:

  http://www.linuxbios.org/Mailinglist


Copyright and License
---------------------

The copyright on LinuxBIOS is owned by quite a large number of individual
developers and companies. Please check the individual source files for details.

LinuxBIOS is licensed under the terms of the GNU General Public License (GPL).
Some files are licensed under the "GPL (version 2, or any later version)",
and some files (mostly those derived from the Linux kernel) are licensed under
the "GPL, version 2". For some parts, which were derived from other projects,
other (GPL-compatible) licenses may apply. Please check the individual
source files for details.

This makes the resulting LinuxBIOS images licensed under the GPL, version 2.