[Skiboot] [PATCH 2/2] doc: Add a man page for OPAL_PCI_SET_PHB_CAPI_MODE
andrew.donnellan at au1.ibm.com
Thu Jul 19 18:07:54 AEST 2018
On 19/07/18 17:55, Vaibhav Jain wrote:
> We add a man page describing the opal call OPAL_PCI_SET_PHB_CAPI_MODE
> used for activating/deactivating CAPP attached to a PEC for CAPI 1 & 2.
> Signed-off-by: Vaibhav Jain <vaibhav at linux.ibm.com>
A few nitpicks below but they can perhaps be fixed in a followup if we
want to merge this series now.
Reviewed-by: Andrew Donnellan <andrew.donnellan at au1.ibm.com>
> .../opal-pci-set-phb-capi-mode-93.rst | 74 +++++++++++++++++++
> 1 file changed, 74 insertions(+)
> create mode 100644 doc/opal-api/opal-pci-set-phb-capi-mode-93.rst
> diff --git a/doc/opal-api/opal-pci-set-phb-capi-mode-93.rst b/doc/opal-api/opal-pci-set-phb-capi-mode-93.rst
> new file mode 100644
> index 00000000..c0c7bd8d
> --- /dev/null
> +++ b/doc/opal-api/opal-pci-set-phb-capi-mode-93.rst
> @@ -0,0 +1,74 @@
> +Switch the CAPP attached to the given PHB in one of the supported CAPI modes
> +``uint64_t phb_id``
> + the ID of the PHB which identifies attached CAPP to perform mode switch on
> +``uint64_t mode``
> + A mode id as described below
> + PE number for the initiating device
> +Switch CAPP attached to the given PHB in one of the following supported modes:
> +OPAL_PHB_CAPI_MODE_PCIE = 0
> +OPAL_PHB_CAPI_MODE_CAPI = 1
> +OPAL_PHB_CAPI_MODE_SNOOP_OFF = 2
> +OPAL_PHB_CAPI_MODE_SNOOP_ON = 3
> +OPAL_PHB_CAPI_MODE_DMA = 4
> +OPAL_PHB_CAPI_MODE_DMA_TVT1 = 5
> +Modes `OPAL_PHB_CAPI_MODE_PCIE` and `OPAL_PHB_CAPI_MODE_CAPI` are used to
> +enable/disable CAPP attached to the PHB.
> +Modes `OPAL_PHB_CAPI_MODE_SNOOP`_OFF and `OPAL_PHB_CAPI_MODE_SNOOP_ON` are
The ` should come after _OFF
> +used to enable/disable CAPP snooping of Powerbus traffic for cache line
> +Mode `OPAL_PHB_CAPI_MODE_DMA` and `OPAL_PHB_CAPI_MODE_DMA_TVT1` are used to
> +enable CAPP DMA mode.
> +Presently Mode `OPAL_PHB_CAPI_MODE_DMA_TVT1` is exclusively used by the Mellanox
> +CX5 adapter. Requesting this mode will also indicate to opal that the card
> +requests maximum number of DMA read engines allocated to improve DMA read
> +performance at cost of reduced bandwidth available to other traffic including
> +CAPP-PSL transactions.
> +* If PHB is in PEC2 then requesting mode `OPAL_PHB_CAPI_MODE_DMA_TVT1` will
> + allocate extra 16/8 dma read engines to the PHB depending on its stack
> + (stack 0/ stack 1). This is needed to improve the Direct-GPU DMA read
> + performance for the Mellanox CX5 card.
> +* Mode `OPAL_PHB_CAPI_MODE_PCIE` not yet supported on Power-9.
Or on POWER8.
> +* Requesting mode `OPAL_PHB_CAPI_MODE_CAPI` on Power-9 will disable fast-reboot.
> +* Modes `OPAL_PHB_CAPI_MODE_DMA`, `OPAL_PHB_CAPI_MODE_SNOOP_OFF` are
> + not supported on Power-9 yet.
> +Return Codes
> + Switch to the reqeuested capi mode performed successfully.
> + The requested value of mode or phb_id parameter is not valid.
> + An error occurred while switching the CAPP to requested mode.
> + Switching to requested capi mode is not possible at the moment
> + CAPP ucode not available hence activating CAPP not supported.
> + CAPP is presently in recovery-mode and mode switch cannot be performed.
Andrew Donnellan OzLabs, ADL Canberra
andrew.donnellan at au1.ibm.com IBM Australia Limited
More information about the Skiboot