coreboot-kgpe-d16/payloads/libpayload
Patrick Georgi 7f43dc1060 Add an EHCI driver to libpayload's USB stack.
Interrupt transfer support is missing (ie. no keyboard),
bulk and control transfers work (ie. mass storage).

Signed-off-by: Patrick Georgi <patrick.georgi@coresystems.de>
Acked-by: Peter Stuge <peter@stuge.se>


git-svn-id: svn://svn.coreboot.org/coreboot/trunk@5845 2b7e53f0-3cfb-0310-b3e9-8179ed1497e1
2010-09-25 17:01:13 +00:00
..
arch Attached patch moves functions out of the huge libpayload.h into headers 2010-06-24 11:16:10 +00:00
bin __i386__ and __powerpc__ are set by the compiler already. 2010-06-24 14:43:17 +00:00
configs Add an EHCI driver to libpayload's USB stack. 2010-09-25 17:01:13 +00:00
crypto [PATCH] libpayload: rename config.h to libpayload-config.h 2008-11-24 17:54:46 +00:00
curses Only try to beep when speaker support is compiled in. 2010-09-09 14:44:51 +00:00
drivers Add an EHCI driver to libpayload's USB stack. 2010-09-25 17:01:13 +00:00
include libpayload: Add function to fix CMOS checksum. 2010-08-17 10:14:50 +00:00
lib This patch fixes payloads on certain Fedora versions 2009-07-18 15:18:22 +00:00
libc Changes to str*cmp functions. Fixes a couple more corner cases. 2010-09-08 10:27:13 +00:00
libpci Incomplete implementation of libpci's (of pciutils) interface. 2010-06-24 14:15:49 +00:00
sample fix compilation of hello.elf example payload. 2010-08-28 23:23:47 +00:00
util Fix libpayload xconfig script to find coreboot utils xgcc. 2010-06-22 19:12:58 +00:00
Config.in Add an EHCI driver to libpayload's USB stack. 2010-09-25 17:01:13 +00:00
Doxyfile Run doxygen -u on doxygen configuration files 2010-06-28 10:40:38 +00:00
LICENSES Since some people disapprove of white space cleanups mixed in regular commits 2010-04-27 06:56:47 +00:00
Makefile Resolved the bug of filo+libpayload building. The bug is if libpayload is installed before filo load "make -C ../libpayload/Makefile DEST=**", it would not 2010-07-29 00:08:21 +00:00
README Add more information to the libpayload README (trivial). 2008-08-18 18:55:33 +00:00

README

-------------------------------------------------------------------------------
libpayload README
-------------------------------------------------------------------------------

libpayload is a minimal library to support standalone payloads
that can be booted with firmware like coreboot. It handles the setup
code, and provides common C library symbols such as malloc() and printf().

Note: This is _not_ a standard library for use with an operating system,
rather it's only useful for coreboot payload development!
See http://coreboot.org for details on coreboot.


Installation
------------

 $ svn co svn://coreboot.org/repos/trunk/payloads/libpayload

 $ cd libpayload

 $ make menuconfig

 $ make

 $ sudo make install (optional, will install into /opt per default)

As libpayload is for 32bit x86 systems only, you might have to install the
32bit libgcc version, otherwise your payloads will fail to compile.
On Debian systems you'd do 'apt-get install gcc-multilib' for example.


Usage
-----

Here's an example of a very simple payload (hello.c) and how to build it:

 #include <libpayload.h>

 int main(void)
 {
     printf("Hello, world!\n");
     return 0;
 }

Building the payload using the 'lpgcc' compiler wrapper:

 $ lpgcc -o hello.elf hello.c

Please see the sample/ directory for details.


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

The main website is http://www.coreboot.org/Libpayload.

For additional information, patches, and discussions, please join the
coreboot mailing list at http://coreboot.org/Mailinglist, where most
libpayload developers are subscribed.


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

See LICENSES.