5f67eef6df
Adds a misc driver for Marvell CN10K DPI(DMA Engine) device's physical function which initializes DPI DMA hardware's global configuration and enables hardware mailbox channels between physical function (PF) and it's virtual functions (VF). VF device drivers (User space drivers) use this hw mailbox to communicate any required device configuration on it's respective VF device. Accordingly, this DPI PF driver provisions the VF device resources. At the hardware level, the DPI physical function (PF) acts as a management interface to setup the VF device resources, VF devices are only provisioned to handle or control the actual DMA Engine's data transfer capabilities. Signed-off-by: Vamsi Attunuru <vattunuru@marvell.com> Reviewed-by: Srujana Challa <schalla@marvell.com> Link: https://lore.kernel.org/r/20240706153009.3775333-1-vattunuru@marvell.com Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
53 lines
1.8 KiB
ReStructuredText
53 lines
1.8 KiB
ReStructuredText
.. SPDX-License-Identifier: GPL-2.0
|
|
|
|
===============================================
|
|
Marvell CN10K DMA packet interface (DPI) driver
|
|
===============================================
|
|
|
|
Overview
|
|
========
|
|
|
|
DPI is a DMA packet interface hardware block in Marvell's CN10K silicon.
|
|
DPI hardware comprises a physical function (PF), its virtual functions,
|
|
mailbox logic, and a set of DMA engines & DMA command queues.
|
|
|
|
DPI PF function is an administrative function which services the mailbox
|
|
requests from its VF functions and provisions DMA engine resources to
|
|
it's VF functions.
|
|
|
|
mrvl_cn10k_dpi.ko misc driver loads on DPI PF device and services the
|
|
mailbox commands submitted by the VF devices and accordingly initializes
|
|
the DMA engines and VF device's DMA command queues. Also, driver creates
|
|
/dev/mrvl-cn10k-dpi node to set DMA engine and PEM (PCIe interface) port
|
|
attributes like fifo length, molr, mps & mrrs.
|
|
|
|
DPI PF driver is just an administrative driver to setup its VF device's
|
|
queues and provisions the hardware resources, it cannot initiate any
|
|
DMA operations. Only VF devices are provisioned with DMA capabilities.
|
|
|
|
Driver location
|
|
===============
|
|
|
|
drivers/misc/mrvl_cn10k_dpi.c
|
|
|
|
Driver IOCTLs
|
|
=============
|
|
|
|
:c:macro::`DPI_MPS_MRRS_CFG`
|
|
ioctl that sets max payload size & max read request size parameters of
|
|
a pem port to which DMA engines are wired.
|
|
|
|
|
|
:c:macro::`DPI_ENGINE_CFG`
|
|
ioctl that sets DMA engine's fifo sizes & max outstanding load request
|
|
thresholds.
|
|
|
|
User space code example
|
|
=======================
|
|
|
|
DPI VF devices are probed and accessed from user space applications using
|
|
vfio-pci driver. Below is a sample dpi dma application to demonstrate on
|
|
how applications use mailbox and ioctl services from DPI PF kernel driver.
|
|
|
|
https://github.com/MarvellEmbeddedProcessors/dpi-sample-app
|