POWER9 Changes to OPAL API
==========================

This document is a summary of POWER9 changes to the OPAL API over what it
was for POWER7 and POWER8. As the POWER series of processors (at least up
to POWER9) require changes in the hypervisor to work on a new processor
generation, this gives us an opportunity with POWER9 to clean up several
parts of the OPAL API.

Eventually, when the kernel drops support for POWER8 and before, we can then
remove the associated kernel code too.

OPAL_REINIT_CPUS
----------------
Can now be extended beyond HILE BE/LE bits. If invalid flags are set on
POWER9, OPAL_UNSUPPORTED will be returned.

Device Tree
-----------

- ``/ibm,opal/`` compatible property now just lists ``ibm,opal-v3`` and no longer ``ibm,opal-v2`` (power9 and above only)
- Use only ``stdout-path`` property from POWER9 and above as usage of ``linux,stdout-path`` is deprecated
- Rename ``fsp-ipl-side`` as ``sp-ipl-side`` in ``/ipl-params``
- Add interrupt-parent property for ``/ibm,opal/ipmi`` node on POWER9 and above
  to make use of OPAL irqchip rather than event interface in linux.

TODO
----
Things we still have to do for POWER9:

- PCI to use async API rather than returning delays
- deprecate/remove v1 APIs where there's a V2
- Fix this FWTS warning: ::

   FAILED [MEDIUM] DeviceTreeBaseDTCWarnings: Test 3, dtc reports warnings from
   device tree: Warning (reg_format): "reg" property in /ibm,opal/flash@0 has
   invalid length (8 bytes) (#address-cells == 0, #size-cells == 0)

- Remove mi-version / ml-version from ``/ibm,opal/firmware`` and replace with something better and more portable