diff options
Diffstat (limited to 'roms/skiboot/doc/opal-api/opal-handle-interrupt.rst')
| -rw-r--r-- | roms/skiboot/doc/opal-api/opal-handle-interrupt.rst | 29 |
1 files changed, 29 insertions, 0 deletions
diff --git a/roms/skiboot/doc/opal-api/opal-handle-interrupt.rst b/roms/skiboot/doc/opal-api/opal-handle-interrupt.rst new file mode 100644 index 000000000..f652af5a3 --- /dev/null +++ b/roms/skiboot/doc/opal-api/opal-handle-interrupt.rst @@ -0,0 +1,29 @@ +.. _OPAL_HANDLE_INTERRUPT: + +OPAL_HANDLE_INTERRUPT +===================== + +The host OS must pass all interrupts in the `opal-interrupts` property of :ref:`device-tree/ibm,opal` in the device tree to OPAL. + +An example dt snippet is: + +.. code-block:: dts + + ibm,opal { + opal-interrupts = <0x10 0x11 0x12 0x13 0x14 0x20010 0x20011 0x20012 0x20013 0x20014 0xffe 0xfff 0x17fe 0x17ff 0x2ffe 0x2fff 0x37fe 0x37ff 0x20ffe 0x20fff 0x217fe 0x217ff 0x22ffe 0x22fff 0x237fe 0x237ff>; + }; + +When the host OS gets any of these interrupts, it must call +``OPAL_HANDLE_INTERRUPT``. + +The ``OPAL_HANDLE_INTERRUPT`` call takes two parameters, one input and one output. + +``uint32_t isn`` + the interrupt + +``uint64_t *outstanding_event_mask`` + returns outstanding events for host OS to handle + +The host OS should then handle any outstanding events. + +See :ref:`OPAL_POLL_EVENTS` for documentation on events. |