From: Jason Wang <jasowang@redhat.com> To: Shannon Nelson <shannon.nelson@amd.com> Cc: brett.creeley@amd.com, mst@redhat.com, netdev@vger.kernel.org, virtualization@lists.linux-foundation.org, kuba@kernel.org, drivers@pensando.io, davem@davemloft.net Subject: Re: [PATCH RFC v2 virtio 7/7] pds_vdpa: pds_vdps.rst and Kconfig Date: Wed, 15 Mar 2023 15:05:51 +0800 [thread overview] Message-ID: <CACGkMEsuG98ASnuS2zjfro3ZkBhAr5KnhWYWqBkyT9ZzPvLXiw@mail.gmail.com> (raw) In-Reply-To: <20230309013046.23523-8-shannon.nelson@amd.com> On Thu, Mar 9, 2023 at 9:31 AM Shannon Nelson <shannon.nelson@amd.com> wrote: > > Add the documentation and Kconfig entry for pds_vdpa driver. > > Signed-off-by: Shannon Nelson <shannon.nelson@amd.com> > --- > .../ethernet/pensando/pds_vdpa.rst | 84 +++++++++++++++++++ > MAINTAINERS | 4 + > drivers/vdpa/Kconfig | 8 ++ > 3 files changed, 96 insertions(+) > create mode 100644 Documentation/networking/device_drivers/ethernet/pensando/pds_vdpa.rst > > diff --git a/Documentation/networking/device_drivers/ethernet/pensando/pds_vdpa.rst b/Documentation/networking/device_drivers/ethernet/pensando/pds_vdpa.rst > new file mode 100644 > index 000000000000..d41f6dd66e3e > --- /dev/null > +++ b/Documentation/networking/device_drivers/ethernet/pensando/pds_vdpa.rst > @@ -0,0 +1,84 @@ > +.. 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. > + > +Shown below are the steps to bind the driver to a VF and also to the > +associated auxiliary device created by the ``pds_core`` driver. > + > +.. code-block:: bash > + > + #!/bin/bash > + > + modprobe pds_core > + modprobe vdpa > + modprobe pds_vdpa > + > + PF_BDF=`grep -H "vDPA.*1" /sys/kernel/debug/pds_core/*/viftypes | head -1 | awk -F / '{print $6}'` > + > + # Enable vDPA VF auxiliary device(s) in the PF > + devlink dev param set pci/$PF_BDF name enable_vnet value true cmode runtime > + Does this mean we can't do per VF configuration for vDPA enablement (e.g VF0 for vdpa VF1 to other type)? Thanks > + # 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 > diff --git a/MAINTAINERS b/MAINTAINERS > index cb21dcd3a02a..da981c5bc830 100644 > --- a/MAINTAINERS > +++ b/MAINTAINERS > @@ -22120,6 +22120,10 @@ SNET DPU VIRTIO DATA PATH ACCELERATOR > R: Alvaro Karsz <alvaro.karsz@solid-run.com> > F: drivers/vdpa/solidrun/ > > +PDS DSC VIRTIO DATA PATH ACCELERATOR > +R: Shannon Nelson <shannon.nelson@amd.com> > +F: drivers/vdpa/pds/ > + > VIRTIO BALLOON > M: "Michael S. Tsirkin" <mst@redhat.com> > M: David Hildenbrand <david@redhat.com> > diff --git a/drivers/vdpa/Kconfig b/drivers/vdpa/Kconfig > index cd6ad92f3f05..c910cb119c1b 100644 > --- a/drivers/vdpa/Kconfig > +++ b/drivers/vdpa/Kconfig > @@ -116,4 +116,12 @@ config ALIBABA_ENI_VDPA > This driver includes a HW monitor device that > reads health values from the DPU. > > +config PDS_VDPA > + tristate "vDPA driver for AMD/Pensando DSC devices" > + depends on PDS_CORE > + help > + VDPA network driver for AMD/Pensando's PDS Core devices. > + With this driver, the VirtIO dataplane can be > + offloaded to an AMD/Pensando DSC device. > + > endif # VDPA > -- > 2.17.1 > _______________________________________________ Virtualization mailing list Virtualization@lists.linux-foundation.org https://lists.linuxfoundation.org/mailman/listinfo/virtualization
WARNING: multiple messages have this Message-ID (diff)
From: Jason Wang <jasowang@redhat.com> To: Shannon Nelson <shannon.nelson@amd.com> Cc: mst@redhat.com, virtualization@lists.linux-foundation.org, brett.creeley@amd.com, davem@davemloft.net, netdev@vger.kernel.org, kuba@kernel.org, drivers@pensando.io Subject: Re: [PATCH RFC v2 virtio 7/7] pds_vdpa: pds_vdps.rst and Kconfig Date: Wed, 15 Mar 2023 15:05:51 +0800 [thread overview] Message-ID: <CACGkMEsuG98ASnuS2zjfro3ZkBhAr5KnhWYWqBkyT9ZzPvLXiw@mail.gmail.com> (raw) In-Reply-To: <20230309013046.23523-8-shannon.nelson@amd.com> On Thu, Mar 9, 2023 at 9:31 AM Shannon Nelson <shannon.nelson@amd.com> wrote: > > Add the documentation and Kconfig entry for pds_vdpa driver. > > Signed-off-by: Shannon Nelson <shannon.nelson@amd.com> > --- > .../ethernet/pensando/pds_vdpa.rst | 84 +++++++++++++++++++ > MAINTAINERS | 4 + > drivers/vdpa/Kconfig | 8 ++ > 3 files changed, 96 insertions(+) > create mode 100644 Documentation/networking/device_drivers/ethernet/pensando/pds_vdpa.rst > > diff --git a/Documentation/networking/device_drivers/ethernet/pensando/pds_vdpa.rst b/Documentation/networking/device_drivers/ethernet/pensando/pds_vdpa.rst > new file mode 100644 > index 000000000000..d41f6dd66e3e > --- /dev/null > +++ b/Documentation/networking/device_drivers/ethernet/pensando/pds_vdpa.rst > @@ -0,0 +1,84 @@ > +.. 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. > + > +Shown below are the steps to bind the driver to a VF and also to the > +associated auxiliary device created by the ``pds_core`` driver. > + > +.. code-block:: bash > + > + #!/bin/bash > + > + modprobe pds_core > + modprobe vdpa > + modprobe pds_vdpa > + > + PF_BDF=`grep -H "vDPA.*1" /sys/kernel/debug/pds_core/*/viftypes | head -1 | awk -F / '{print $6}'` > + > + # Enable vDPA VF auxiliary device(s) in the PF > + devlink dev param set pci/$PF_BDF name enable_vnet value true cmode runtime > + Does this mean we can't do per VF configuration for vDPA enablement (e.g VF0 for vdpa VF1 to other type)? Thanks > + # 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 > diff --git a/MAINTAINERS b/MAINTAINERS > index cb21dcd3a02a..da981c5bc830 100644 > --- a/MAINTAINERS > +++ b/MAINTAINERS > @@ -22120,6 +22120,10 @@ SNET DPU VIRTIO DATA PATH ACCELERATOR > R: Alvaro Karsz <alvaro.karsz@solid-run.com> > F: drivers/vdpa/solidrun/ > > +PDS DSC VIRTIO DATA PATH ACCELERATOR > +R: Shannon Nelson <shannon.nelson@amd.com> > +F: drivers/vdpa/pds/ > + > VIRTIO BALLOON > M: "Michael S. Tsirkin" <mst@redhat.com> > M: David Hildenbrand <david@redhat.com> > diff --git a/drivers/vdpa/Kconfig b/drivers/vdpa/Kconfig > index cd6ad92f3f05..c910cb119c1b 100644 > --- a/drivers/vdpa/Kconfig > +++ b/drivers/vdpa/Kconfig > @@ -116,4 +116,12 @@ config ALIBABA_ENI_VDPA > This driver includes a HW monitor device that > reads health values from the DPU. > > +config PDS_VDPA > + tristate "vDPA driver for AMD/Pensando DSC devices" > + depends on PDS_CORE > + help > + VDPA network driver for AMD/Pensando's PDS Core devices. > + With this driver, the VirtIO dataplane can be > + offloaded to an AMD/Pensando DSC device. > + > endif # VDPA > -- > 2.17.1 >
next prev parent reply other threads:[~2023-03-15 7:06 UTC|newest] Thread overview: 36+ messages / expand[flat|nested] mbox.gz Atom feed top 2023-03-09 1:30 [PATCH RFC v2 virtio 0/7] pds_vdpa driver Shannon Nelson 2023-03-09 1:30 ` [PATCH RFC v2 virtio 1/7] pds_vdpa: Add new vDPA driver for AMD/Pensando DSC Shannon Nelson 2023-03-12 14:06 ` Simon Horman 2023-03-12 14:35 ` Simon Horman 2023-03-13 16:13 ` Shannon Nelson 2023-03-13 16:26 ` Simon Horman 2023-03-09 1:30 ` [PATCH RFC v2 virtio 2/7] pds_vdpa: get vdpa management info Shannon Nelson 2023-03-15 7:05 ` Jason Wang 2023-03-15 7:05 ` Jason Wang 2023-03-16 3:25 ` Shannon Nelson 2023-03-17 3:33 ` Jason Wang 2023-03-17 3:33 ` Jason Wang 2023-03-09 1:30 ` [PATCH RFC v2 virtio 3/7] pds_vdpa: virtio bar setup for vdpa Shannon Nelson 2023-03-15 7:05 ` Jason Wang 2023-03-15 7:05 ` Jason Wang 2023-03-16 3:25 ` Shannon Nelson 2023-03-17 3:37 ` Jason Wang 2023-03-17 3:37 ` Jason Wang 2023-03-09 1:30 ` [PATCH RFC v2 virtio 4/7] pds_vdpa: add vdpa config client commands Shannon Nelson 2023-03-15 7:05 ` Jason Wang 2023-03-15 7:05 ` Jason Wang 2023-03-16 3:25 ` Shannon Nelson 2023-03-17 3:36 ` Jason Wang 2023-03-17 3:36 ` Jason Wang 2023-03-09 1:30 ` [PATCH RFC v2 virtio 5/7] pds_vdpa: add support for vdpa and vdpamgmt interfaces Shannon Nelson 2023-03-15 7:05 ` Jason Wang 2023-03-15 7:05 ` Jason Wang 2023-03-16 3:25 ` Shannon Nelson 2023-03-09 1:30 ` [PATCH RFC v2 virtio 6/7] pds_vdpa: subscribe to the pds_core events Shannon Nelson 2023-03-09 1:30 ` [PATCH RFC v2 virtio 7/7] pds_vdpa: pds_vdps.rst and Kconfig Shannon Nelson 2023-03-15 7:05 ` Jason Wang [this message] 2023-03-15 7:05 ` Jason Wang 2023-03-16 3:25 ` Shannon Nelson 2023-03-17 3:54 ` Jason Wang 2023-03-17 3:54 ` Jason Wang 2023-03-15 18:10 ` kernel test robot
Reply instructions: You may reply publicly to this message via plain-text email using any one of the following methods: * Save the following mbox file, import it into your mail client, and reply-to-all from there: mbox Avoid top-posting and favor interleaved quoting: https://en.wikipedia.org/wiki/Posting_style#Interleaved_style * Reply using the --to, --cc, and --in-reply-to switches of git-send-email(1): git send-email \ --in-reply-to=CACGkMEsuG98ASnuS2zjfro3ZkBhAr5KnhWYWqBkyT9ZzPvLXiw@mail.gmail.com \ --to=jasowang@redhat.com \ --cc=brett.creeley@amd.com \ --cc=davem@davemloft.net \ --cc=drivers@pensando.io \ --cc=kuba@kernel.org \ --cc=mst@redhat.com \ --cc=netdev@vger.kernel.org \ --cc=shannon.nelson@amd.com \ --cc=virtualization@lists.linux-foundation.org \ /path/to/YOUR_REPLY https://kernel.org/pub/software/scm/git/docs/git-send-email.html * If your mail client supports setting the In-Reply-To header via mailto: links, try the mailto: linkBe sure your reply has a Subject: header at the top and a blank line before the message body.
This is an external index of several public inboxes, see mirroring instructions on how to clone and mirror all data and code used by this external index.