aboutsummaryrefslogtreecommitdiff
path: root/README
diff options
context:
space:
mode:
authorStewart Smith <stewart@linux.vnet.ibm.com>2015-08-28 15:10:31 +1000
committerStewart Smith <stewart@linux.vnet.ibm.com>2015-08-28 15:10:31 +1000
commite4a7821a8ee93f24914a5f576e30c09a5564260c (patch)
tree58759c4e48b4574f64caa60c4265dddccc569e7a /README
parent23e88a9001985d8b684ddd9e17ca058bd9138e53 (diff)
downloadskiboot-e4a7821a8ee93f24914a5f576e30c09a5564260c.zip
skiboot-e4a7821a8ee93f24914a5f576e30c09a5564260c.tar.gz
skiboot-e4a7821a8ee93f24914a5f576e30c09a5564260c.tar.bz2
Update README
Signed-off-by: Stewart Smith <stewart@linux.vnet.ibm.com>
Diffstat (limited to 'README')
-rw-r--r--README11
1 files changed, 10 insertions, 1 deletions
diff --git a/README b/README
index 5ba0e23..735ad99 100644
--- a/README
+++ b/README
@@ -39,7 +39,8 @@ They may be all part of one payload or three separate images (depending on
platform).
The bootloader will kexec a host kernel (probably linux). The host OS can
-make OPAL calls. A TODO item is to extensively document this API.
+make OPAL calls. The OPAL API is documented in doc/opal-api/ (there are
+missing parts, patches are welcome!)
See doc/overview.txt for a more in depth overview of skiboot.
@@ -71,6 +72,8 @@ http://www-304.ibm.com/support/customercare/sas/f/pwrfs/home.html
Qemu (as of 2.2.0) is not suitable as it does not (yet) implement
the HyperVisor mode of the POWER8 processor.
+See https://www.flamingspork.com/blog/2015/08/28/running-opal-in-qemu-the-powernv-platform/ for instructions on how to use a work-in-progress patchset
+to qemu that may be suitable for some work.
To run a boot-to-bootloader test, you'll need a zImage.papr built using
the mambo_defconfig config for op-build. See
@@ -78,9 +81,15 @@ https://github.com/open-power/op-build/ on howto build. Drop zImage.epapr
in the skiboot directory and the skiboot test suite will automatically pick
it up.
+See opal-ci/README for further testing instructions.
+
To test on real hardware, you will need to understand how to flash new
skiboot onto your system. This will vary from platform to platform.
+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
-------
All patches should be sent to the mailing list with linux-kernel style