diff options
Diffstat (limited to 'roms/skiboot/doc/opal-api/opal-pci-set-mve-enable-34.rst')
-rw-r--r-- | roms/skiboot/doc/opal-api/opal-pci-set-mve-enable-34.rst | 44 |
1 files changed, 44 insertions, 0 deletions
diff --git a/roms/skiboot/doc/opal-api/opal-pci-set-mve-enable-34.rst b/roms/skiboot/doc/opal-api/opal-pci-set-mve-enable-34.rst new file mode 100644 index 000000000..55bf10a08 --- /dev/null +++ b/roms/skiboot/doc/opal-api/opal-pci-set-mve-enable-34.rst @@ -0,0 +1,44 @@ +.. _OPAL_PCI_SET_MVE_ENABLE: + +OPAL_PCI_SET_MVE_ENABLE +======================= + + +.. code-block:: c + + #define OPAL_PCI_SET_MVE_ENABLE 34 + + int64_t opal_pci_set_mve_enable(uint64_t phb_id, uint32_t mve_number, uint32_t state); + + enum OpalMveEnableAction { + OPAL_DISABLE_MVE = 0, + OPAL_ENABLE_MVE = 1 + }; + +**WARNING:** following documentation is from old sources, and is possibly +not representative of OPALv3 as implemented by skiboot. This should be +used as a starting point for full documentation. + +The host calls this function to enable or disable an MVE to respond to an MSI +DMA address and message data value. + +``phb_id`` + is the value from the PHB node ibm,opal-phbid property. + +``mve_number`` + is the index, from 0 to ibm,opal,ibm-num-msi-ports minus1 + +``state`` + A '1' value of the state parameter indicates to enable the MVE and a '0' + value indicates to disable the MVE. + +This call sets the MVE to an enabled (1) or disabled (0) state. + +Return value: + +.. code-block:: c + + if (!phb) + return OPAL_PARAMETER; + if (!phb->ops->set_mve_enable) + return OPAL_UNSUPPORTED; |