Add a section to the dts.rst file explaining how to
enable SR-IOV mode on an environment, as well
as any additional steps needed for virtual
function configuration.

Signed-off-by: Dean Marx <dm...@iol.unh.edu>
---
 doc/guides/tools/dts.rst | 46 ++++++++++++++++++++++++++++++++++++++++
 dts/README.md            |  2 +-
 2 files changed, 47 insertions(+), 1 deletion(-)

diff --git a/doc/guides/tools/dts.rst b/doc/guides/tools/dts.rst
index 7e68159571..5dd858a7c8 100644
--- a/doc/guides/tools/dts.rst
+++ b/doc/guides/tools/dts.rst
@@ -217,6 +217,52 @@ There are two areas that need to be set up on a System 
Under Test:
 
       sudo usermod -aG sudo <sut_user>
 
+#. **SR-IOV**
+
+   Before configuring virtual functions, SR-IOV support must be enabled in the 
system BIOS/UEFI:
+
+   #. Reboot the system and enter BIOS/UEFI settings.
+   #. Locate the SR-IOV option (often under PCIe or Advanced settings).
+   #. Set SR-IOV to **Enabled** and save changes.
+
+   For Mellanox environments, the following additional setup steps are 
required:
+
+   #. **Install mstflint tools** (if not already installed):
+
+      .. code-block:: bash
+
+         sudo apt install mstflint        # On Debian/Ubuntu
+         sudo yum install mstflint        # On RHEL/CentOS
+
+   #. **Start the MST service**:
+
+      .. code-block:: bash
+
+         sudo mst start
+
+   #. **List Mellanox devices**:
+
+      .. code-block:: bash
+
+         sudo mst status
+
+      This will output paths such as ``/dev/mst/mt4121_pciconf0`` and possibly 
additional functions (e.g., ``pciconf0.1``).
+
+   #. **Enable SR-IOV and configure number of VFs**:
+
+      .. code-block:: bash
+
+         sudo mlxconfig -d /dev/mst/mt4121_pciconf0 set SRIOV_EN=1 NUM_OF_VFS=8
+         sudo mlxconfig -d /dev/mst/mt4121_pciconf0.1 set SRIOV_EN=1 
NUM_OF_VFS=8
+
+      Replace the device names with those matching your setup (from ``mst 
status``). The number of VFs can be adjusted as needed.
+
+   #. **Reboot the system**:
+
+      .. code-block:: bash
+
+         sudo reboot now
+
 
 Setting up Traffic Generator Node
 ---------------------------------
diff --git a/dts/README.md b/dts/README.md
index 224a7aa20b..73c56ec504 100644
--- a/dts/README.md
+++ b/dts/README.md
@@ -33,7 +33,7 @@ its own ports.
 3. DTS uses ssh key auth to control the nodes. Copy your ssh keys to the TG 
and SUT:
     ssh-copy-id dts@{your host}.
 
-For additional detail, please refer to [dts.rst](doc/guides/tools/dts.rst)
+For additional detail on how to set up a valid DPDK environment, please refer 
to [dts.rst](doc/guides/tools/dts.rst)
 
 # DTS Configuration
 
-- 
2.49.0

Reply via email to