@@ -236,17 +236,17 @@ The OPAL API is the interface between an Operating System and OPAL.
+---------------------------------------------+--------------+------------------------+----------+-----------------+
| :ref:`OPAL_I2C_REQUEST` | 109 | :ref:`skiboot-4.0` | POWER9 | |
+---------------------------------------------+--------------+------------------------+----------+-----------------+
-| :ref:`OPAL_FLASH_READ` | 110 | v5.0 | POWER9 | |
+| :ref:`OPAL_FLASH_READ` | 110 | :ref:`skiboot-5.0` | POWER9 | |
+---------------------------------------------+--------------+------------------------+----------+-----------------+
-| :ref:`OPAL_FLASH_WRITE` | 111 | v5.0 | POWER9 | |
+| :ref:`OPAL_FLASH_WRITE` | 111 | :ref:`skiboot-5.0` | POWER9 | |
+---------------------------------------------+--------------+------------------------+----------+-----------------+
-| :ref:`OPAL_FLASH_ERASE` | 112 | v5.0 | POWER9 | |
+| :ref:`OPAL_FLASH_ERASE` | 112 | :ref:`skiboot-5.0` | POWER9 | |
+---------------------------------------------+--------------+------------------------+----------+-----------------+
-| :ref:`OPAL_PRD_MSG` | 113 | v5.0 | POWER9 | |
+| :ref:`OPAL_PRD_MSG` | 113 | :ref:`skiboot-5.0` | POWER9 | |
+---------------------------------------------+--------------+------------------------+----------+-----------------+
-| :ref:`OPAL_LEDS_GET_INDICATOR` | 114 | v5.0 | POWER9 | |
+| :ref:`OPAL_LEDS_GET_INDICATOR` | 114 | :ref:`skiboot-5.0` | POWER9 | |
+---------------------------------------------+--------------+------------------------+----------+-----------------+
-| :ref:`OPAL_LEDS_SET_INDICATOR` | 115 | v5.0 | POWER9 | |
+| :ref:`OPAL_LEDS_SET_INDICATOR` | 115 | :ref:`skiboot-5.0` | POWER9 | |
+---------------------------------------------+--------------+------------------------+----------+-----------------+
| :ref:`OPAL_CEC_REBOOT2` | 116 | :ref:`skiboot-5.1.0` | POWER9 | |
+---------------------------------------------+--------------+------------------------+----------+-----------------+
new file mode 100644
@@ -0,0 +1,145 @@
+.. _skiboot-5.0:
+
+===========
+skiboot 5.0
+===========
+
+Skiboot 5.0 was released Friday 10th April 2015.
+
+Changes in 5.0 (since rc3):
+
+ - Fix chip id for nx coprocessors.
+ - hw/ipmi: Fix FW Boot Progress sensor
+ - bt: Add a temporary workaround for bmc dropping messages
+ - FSP/CUPD: Fix lock issue
+
+Changes in rc3 (since rc2):
+
+ - add support for cec_power_down on mambo
+ - external/opal-prd: Use link register for cross-endian branch
+ - opal header file rework, Linux and skiboot now very closely match (API
+ in opal-api.h)
+ - libflash: don't use the low level interface if it doesn't exist
+ - libflash/file: add file abstraction for libflash
+ - external: create a GUARD partition parsing utility
+
+Changes in rc2 (since rc1):
+
+ - opal: Fix an issue where partial LID load causes opal to hang.
+ - nx: use proc_gen instead of param
+ - use chip id for NX engine Coproc Instance num
+ - Fix (hopefully) missing dot symbols in skiboot.map
+ - exceptions: Catch exceptions at boot time
+ - exceptions: Remove deprecated exception patching stuff
+ - mambo: Make mambo_utils.tcl optional
+ - mambo: Exit mambo when the simulation is stopped
+ - add NX register defines
+ - set NX crb input queues to 842 only
+ - core: Catch attempts to branch through a NULL pointer
+ - plat/firestone: Add missing platform hooks
+ - plat/firestone: Add missing platform hooks
+ - elog: Don't call uninitialized platform elog_commit
+ - external/opal-prd: Use "official" switch-endian syscall
+ - hw/ipmi: Rework sensors and fix boot count sensor
+
+Changes in rc1 (since 4.1.1):
+
+General:
+
+ * big OPAL API documentation updates
+ We now document around 19 OPAL calls. There's still ~100 left to doc
+ though :)
+ * skiboot can load FreeBSD kernel payload (thanks to Nathan Whitehorn)
+ * You can now run sparse by setting C=1 when building
+ * PSI: Revert the timeout for PSI link recovery to architected value
+ now 30mins (prev 15)
+ * cpuidle: Add validated metrics for idle states
+ * core/flash: Add flash API
+ OPAL_FLASH_(READ|WRITE|ERASE)
+ * capi: Dynamically calculate which CAPP port to use
+ no longer hardwired to PHB0
+ * vpd: Use slca parent-child relationship to create vpd tree
+ * opal: Do not overwrite same HMI event for multiple HMI errors.
+ Now Linux will get a HMI event for each HMI error
+ * HMI event v2 now includes information about checkstop
+ * HMI improvements, handle more conditions gracefully:
+
+ * TB residue error
+ * TFMR firmware control error
+ * TFMR parity
+ * TFMR HDEC parity error
+ * TFMR DEC parity error
+ * TFMR SPURR/PURR parity error
+ * TB residue and HDEC parity HMI errors on split core
+ * hostservices: Cache lids prior to first load request
+ * Warn when pollers are called with a lock held
+ and keep track of lock depth.
+
+ **NOTE:** This means we will get backtraces in skiboot msglog on FSP machines
+ This is a KNOWN ISSUE and is largely harmless.
+ There's still a couple that we haven't yet cleaned, these
+ messages can be thought of as a TODO list for developers.
+
+ * Don't run pollers in time_wait if lock held
+ * pci: Don't hang if we have only one CPU
+ * Detect recursive poller entry
+ * General cleanup
+ * Cleanup of opal.h so that we can have Linux and skiboot match
+ * add sparse annotations to opal.h
+ * Platform hooks for loading and preloading resources (LIDs)
+ This lays the groundwork for cutting 4-20 seconds off boot in a
+ future skiboot release.
+ * Fix potential race when clearing OCC interrupt status
+ * Add platform operation for reading sensors
+
+ * add support to read core and memory buffer temperatures
+
+Mambo/POWER8 Functional Simulator:
+
+ * Replace is_mambo_chip() with a better quirks mechanism.
+ * Don't hang if we only have one CPU and PCI.
+
+BMC systems:
+
+ * BMC can load payload from flash
+ * IPMI on BMC systems: graceful poweroff and reboot
+ * IPMI on BMC systems: watchdog timer support
+ * IPMI on BMC systems: PNOR locking
+ * Support for IPMI progress sensor
+ * IPMI boot count sensor
+ * capi: Rework microcode flash download and CAPP upload
+ load microcode on non-fsp systems
+ * NEW opal-prd userspace tool that handles PRD on non-FSP systems.
+ and OPAL PRD calls to support it.
+ * Improvements to opal-prd, libflash, and ipmi
+ * ECC support in libflash
+ * Load CAPI micro code, enabling CAPI on OpenPower systems.
+ * Dynamically calculate which CAPP port to use, don't hardcode to PHB0
+ * memboot flash backend
+
+POWER8
+
+ * add nx-842 coproc support
+
+FSP systems:
+
+ * Make abort() update sp attn area (like assert does)
+ On FSP systems this gives better error logs/dumps when abort() is hit
+ * FSP/LEDS: Many improvements and bug fixes
+ * LED support for FSP machines
+ Adds OPAL_LEDS_(GET|SET)_INDICATOR and device-tree bindings
+ * Refactor of fsp-rtc
+ * OCC loading fixes, including possible race condition where we would
+ fail to IPL.
+
+POWER7
+
+ * Fix unsupported return code of OPAL_(UN)REGISTER_DUMP_REGION on P7
+ * occ: Don't do bad XSCOMs on P7
+ The OCC interrupt register only exists on P8, accessing it on P7 causes
+ not only error logs but also causes PRD to eventually gard chips.
+ * cpu: Handle opal_reinit_cpus() more gracefully on P7
+ no longer generate error logs
+ * libflash updates for openpower
+ * misc code cleanup
+ * add nx-842 coproc support
Signed-off-by: Stewart Smith <stewart@linux.ibm.com> --- doc/opal-api/index.rst | 12 +-- doc/release-notes/skiboot-5.0.rst | 145 ++++++++++++++++++++++++++++++ 2 files changed, 151 insertions(+), 6 deletions(-) create mode 100644 doc/release-notes/skiboot-5.0.rst