86 lines
2.4 KiB
ReStructuredText
86 lines
2.4 KiB
ReStructuredText
|
.. SPDX-License-Identifier: GPL-2.0+
|
||
|
|
.. note: can be edited and viewed with /usr/bin/formiko-vim
|
||
|
|
|
||
|
|
==========================================================
|
||
|
|
PCI vDPA driver for the AMD/Pensando(R) DSC adapter family
|
||
|
|
==========================================================
|
||
|
|
|
||
|
|
AMD/Pensando vDPA VF Device Driver
|
||
|
|
|
||
|
|
Copyright(c) 2023 Advanced Micro Devices, Inc
|
||
|
|
|
||
|
|
Overview
|
||
|
|
========
|
||
|
|
|
||
|
|
The ``pds_vdpa`` driver is an auxiliary bus driver that supplies
|
||
|
|
a vDPA device for use by the virtio network stack. It is used with
|
||
|
|
the Pensando Virtual Function devices that offer vDPA and virtio queue
|
||
|
|
services. It depends on the ``pds_core`` driver and hardware for the PF
|
||
|
|
and VF PCI handling as well as for device configuration services.
|
||
|
|
|
||
|
|
Using the device
|
||
|
|
================
|
||
|
|
|
||
|
|
The ``pds_vdpa`` device is enabled via multiple configuration steps and
|
||
|
|
depends on the ``pds_core`` driver to create and enable SR-IOV Virtual
|
||
|
|
Function devices. After the VFs are enabled, we enable the vDPA service
|
||
|
|
in the ``pds_core`` device to create the auxiliary devices used by pds_vdpa.
|
||
|
|
|
||
|
|
Example steps:
|
||
|
|
|
||
|
|
.. code-block:: bash
|
||
|
|
|
||
|
|
#!/bin/bash
|
||
|
|
|
||
|
|
modprobe pds_core
|
||
|
|
modprobe vdpa
|
||
|
|
modprobe pds_vdpa
|
||
|
|
|
||
|
|
PF_BDF=`ls /sys/module/pds_core/drivers/pci\:pds_core/*/sriov_numvfs | awk -F / '{print $7}'`
|
||
|
|
|
||
|
|
# Enable vDPA VF auxiliary device(s) in the PF
|
||
|
|
devlink dev param set pci/$PF_BDF name enable_vnet cmode runtime value true
|
||
|
|
|
||
|
|
# Create a VF for vDPA use
|
||
|
|
echo 1 > /sys/bus/pci/drivers/pds_core/$PF_BDF/sriov_numvfs
|
||
|
|
|
||
|
|
# Find the vDPA services/devices available
|
||
|
|
PDS_VDPA_MGMT=`vdpa mgmtdev show | grep vDPA | head -1 | cut -d: -f1`
|
||
|
|
|
||
|
|
# Create a vDPA device for use in virtio network configurations
|
||
|
|
vdpa dev add name vdpa1 mgmtdev $PDS_VDPA_MGMT mac 00:11:22:33:44:55
|
||
|
|
|
||
|
|
# Set up an ethernet interface on the vdpa device
|
||
|
|
modprobe virtio_vdpa
|
||
|
|
|
||
|
|
|
||
|
|
|
||
|
|
Enabling the driver
|
||
|
|
===================
|
||
|
|
|
||
|
|
The driver is enabled via the standard kernel configuration system,
|
||
|
|
using the make command::
|
||
|
|
|
||
|
|
make oldconfig/menuconfig/etc.
|
||
|
|
|
||
|
|
The driver is located in the menu structure at:
|
||
|
|
|
||
|
|
-> Device Drivers
|
||
|
|
-> Network device support (NETDEVICES [=y])
|
||
|
|
-> Ethernet driver support
|
||
|
|
-> Pensando devices
|
||
|
|
-> Pensando Ethernet PDS_VDPA Support
|
||
|
|
|
||
|
|
Support
|
||
|
|
=======
|
||
|
|
|
||
|
|
For general Linux networking support, please use the netdev mailing
|
||
|
|
list, which is monitored by Pensando personnel::
|
||
|
|
|
||
|
|
netdev@vger.kernel.org
|
||
|
|
|
||
|
|
For more specific support needs, please use the Pensando driver support
|
||
|
|
email::
|
||
|
|
|
||
|
|
drivers@pensando.io
|