diff options
author | Michael Neuling <mikey@neuling.org> | 2016-06-30 17:44:21 +1000 |
---|---|---|
committer | Stewart Smith <stewart@linux.vnet.ibm.com> | 2016-07-01 18:01:08 +1000 |
commit | 16ef1b8217ba437df7cf3c8893f0c5b9ef094cbe (patch) | |
tree | d1f0edbf6b87c6232d5f9f8e48cd4a9bf83806d7 | |
parent | ae6713b495391d9c4e3ce88771aa5a03e1c687da (diff) | |
download | skiboot-16ef1b8217ba437df7cf3c8893f0c5b9ef094cbe.zip skiboot-16ef1b8217ba437df7cf3c8893f0c5b9ef094cbe.tar.gz skiboot-16ef1b8217ba437df7cf3c8893f0c5b9ef094cbe.tar.bz2 |
Toplevel README -> README.md
Make it pretty as well.
Signed-off-by: Michael Neuling <mikey@neuling.org>
Signed-off-by: Stewart Smith <stewart@linux.vnet.ibm.com>
-rw-r--r-- | README.md (renamed from README) | 70 |
1 files changed, 36 insertions, 34 deletions
@@ -1,39 +1,38 @@ -skiboot -------- +# skiboot Firmware for OpenPower systems. -Source: -https://github.com/open-power/skiboot +Source: https://github.com/open-power/skiboot Mailing list: skiboot@lists.ozlabs.org + Info/subscribe: https://lists.ozlabs.org/listinfo/skiboot + Archives: https://lists.ozlabs.org/pipermail/skiboot/ -Patchwork: -http://patchwork.ozlabs.org/project/skiboot/list/ +Patchwork: http://patchwork.ozlabs.org/project/skiboot/list/ -Overview --------- +## Overview OPAL firmware (OpenPower Abstraction Layer) comes in several parts. A simplified flow of what happens when the power button is pressed is: - 1) The baseboard management controller (BMC) powers the system on. - 2) The BMC selects the master chip and releases the self-boot engines (SBEs) - on the POWER8 chips, master last. - 3) The BMC relinquishes control of the flexible service interface (FSI) - SCAN/SCOM engines. - 4) The hostboot firmware IPLs the system. It initiates a secondary power-on - sequence through a digital power systems sweep (DPSS). - 5) The hostboot firmware loads the OPAL image and moves all processors to - their execution starting points. +1. The baseboard management controller (BMC) powers the system on. +2. The BMC selects the master chip and releases the self-boot engines (SBEs) + on the POWER8 chips, master last. +3. The BMC relinquishes control of the flexible service interface (FSI) + SCAN/SCOM engines. +4. The hostboot firmware IPLs the system. It initiates a secondary power-on + sequence through a digital power systems sweep (DPSS). +5. The hostboot firmware loads the OPAL image and moves all processors to + their execution starting points. Here, the OPAL image is three parts: - 1) skiboot (includes OPAL runtime services) - 2) skiroot - the bootloader environment - a) kernel - b) initramfs (containing petitboot bootloader) + +1. skiboot (includes OPAL runtime services) +2. skiroot - the bootloader environment + * kernel + * initramfs (containing petitboot bootloader) They may be all part of one payload or three separate images (depending on platform). @@ -44,8 +43,7 @@ missing parts, patches are welcome!) See doc/overview.txt for a more in depth overview of skiboot. -Building --------- +## Building You can build on a linux host. Modern Debian and Ubuntu are well known to be suitable. Build and testing on x86 is fine. You do not need a POWER host to build and test skiboot. @@ -55,8 +53,11 @@ not provide one, crosstool built compilers work well: https://www.kernel.org/pub/tools/crosstool/ You should then be able to just (where 4=nr cpu cores of your machine) -$ make -j4 -$ make -j4 check + +``` +make -j4 +make -j4 check +``` If using crosstool compilers, add /opt/cross/gcc-4.8.0-nolibc/powerpc64-linux/bin/ to your PATH. @@ -65,10 +66,10 @@ If using packaged cross compilers on Ubuntu, you may need to set the following environment variable: CROSS=powerpc-linux-gnu- -Testing -------- +## Testing To test in a simulator, install the IBM POWER8 Functional Simulator from: http://www-304.ibm.com/support/customercare/sas/f/pwrfs/home.html +Also see external/mambo/README.md Qemu (as of 2.2.0) is not suitable as it does not (yet) implement the HyperVisor mode of the POWER8 processor. @@ -90,17 +91,18 @@ You may want to start with external/boot-tests/boot_test.sh as it can (provided the correct usernames/passwords) automatically flash a new skiboot onto ASTBMC based OpenPower machines. -Hacking -------- +## Hacking + All patches should be sent to the mailing list with linux-kernel style 'Signed-Off-By'. The following git commands are your friends: -- git commit -s -- git format-patch +``` +git commit -s +git format-patch +``` You probably want to read the linux Documentation/SubmittingPatches as much of it applies to skiboot. -License -------- -See LICENSE +## License +See LICENSE
\ No newline at end of file |