Add sb800 spi support.

[coreboot.git] / README

diff --git a/README b/README
index 94c95a26e069e7b453dbc342a5ee4da1214b1767..2c25bef8a8fac2f995da4cada648693f3a4fdf13 100644 (file)
--- a/README
+++ b/README
@@ -1,37 +1,36 @@
 -------------------------------------------------------------------------------
 -------------------------------------------------------------------------------

-Coreboot README
+coreboot README

 -------------------------------------------------------------------------------
 
 -------------------------------------------------------------------------------
 

-Coreboot is a Free Software project aimed at replacing the proprietary
-BIOS you can find in most of today's computers.
+coreboot is a Free Software project aimed at replacing the proprietary BIOS
+(firmware) found in most computers.  coreboot performs a little bit of
+hardware initialization and then executes additional boot logic, called a
+payload.

 
 

-It performs just a little bit of hardware initialization and then executes
-one of many possible payloads, e.g. a Linux kernel.
+With the separation of hardware initialization and later boot logic,
+coreboot can scale from specialized applications that run directly
+firmware, run operating systems in flash, load custom
+bootloaders, or implement firmware standards, like PC BIOS services or
+UEFI. This allows for systems to only include the features necessary
+in the target application, reducing the amount of code and flash space
+required.
+
+coreboot was formerly known as LinuxBIOS.

 
 
 Payloads
 --------
 
 After the basic initialization of the hardware has been performed, any
 
 
 Payloads
 --------
 
 After the basic initialization of the hardware has been performed, any

-desired "payload" can be started by coreboot. Examples include:
+desired "payload" can be started by coreboot.

 
 

- * 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)
+See http://www.coreboot.org/Payloads for a list of supported payloads.

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

-Coreboot supports a wide range of chipsets, devices, and mainboards.
+coreboot supports a wide range of chipsets, devices, and mainboards.

 
 For details please consult:
 
 
 For details please consult:
 


@@ -39,6 +38,37 @@ For details please consult:
  * http://www.coreboot.org/Supported_Chipsets_and_Devices
 
 
  * http://www.coreboot.org/Supported_Chipsets_and_Devices
 
 

+Build Requirements
+------------------
+
+ * gcc / g++
+ * make
+
+Optional:
+
+ * doxygen (for generating/viewing documentation)
+ * iasl (for targets with ACPI support)
+ * gdb (for better debugging facilities on some targets)
+ * ncurses (for 'make menuconfig')
+ * flex and bison (for regenerating parsers)
+
+
+Building coreboot
+-----------------
+
+Please consult http://www.coreboot.org/Build_HOWTO for details.
+
+
+Testing coreboot Without Modifying Your Hardware
+------------------------------------------------
+
+If you want to test coreboot without any risks before you really decide
+to use it on your hardware, you can use the QEMU system emulator to run
+coreboot virtually in QEMU.
+
+Please see http://www.coreboot.org/QEMU for details.
+
+

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


@@ -58,12 +88,11 @@ Copyright and License
 The copyright on coreboot is owned by quite a large number of individual
 developers and companies. Please check the individual source files for details.
 
 The copyright on coreboot is owned by quite a large number of individual
 developers and companies. Please check the individual source files for details.
 

-Coreboot is licensed under the terms of the GNU General Public License (GPL).
+coreboot 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)",
 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.
+and some files 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 coreboot images licensed under the GPL, version 2.
 
 
 This makes the resulting coreboot images licensed under the GPL, version 2.