P-tile Avalon® Streaming Intel® FPGA IP for PCI Express* Design Example User Guide

ID 683038
Date 4/10/2023
Public

A newer version of this document is available. Customers should click here to go to the newest version.

Document Table of Contents

2.6.2. Running the SR-IOV Design Example

Here are the steps to test the SR-IOV design example on hardware:
  1. Run the Intel FPGA IP PCIe link test by running the sudo ./intel_fpga_pcie_link_test command and then select the option 1: Manually select a device.
  2. Enter the BDF of the physical function for which the virtual functions are allocated.
  3. Enter BAR “0” to proceed to the test menu.
  4. Enter option 7 to enable SR-IOV for the current device.
  5. Enter the number of virtual functions to be enabled for the current device.
    Note: To disable Virtual Functions (VFs), choose option 7 (Enable SR-IOV) and enter the value 0 when prompted for the number of VFs to enable for the current device.
  6. In a new terminal, run the lspci –d 1172: | grep -c “Altera” command to verify the enumeration of PFs and VFs. The expected result is the sum of the number of physical functions and number of virtual functions.

    Below is an example of a design with two PFs and two VFs, where each PF has one VF assigned to it.

    If you run the command lspci -d 1172:, you see the following:

    08:00.0 Unassigned class [ff00]: Altera Corporation Device 0000 (rev01)

    (this BDF is for PF0)

    08:00.1 Unassigned class [ff00]: Altera Corporation Device 0000

    (this BDF is for PF1)

    08:00.2 Unassigned class [ff00]: Altera Corporation Device 0000

    (this BDF is for the VF of PF0)

    08:00.3 Unassigned class [ff00]: Altera Corporation Device 0000

    (this BDF is for the VF of PF1)

    When you disable the VF for PF0, lspci -d 1172: shows the following:

    08:00.0 Unassigned class [ff00]: Altera Corporation Device 0000 (rev01)
    08:00.1 Unassigned class [ff00]: Altera Corporation Device 0000
    08:00.3 Unassigned class [ff00]: Altera Corporation Device 0000

    When you disable the VFs for both PF0 and PF1, lspci -d 1172: shows the following:

    08:00.0 Unassigned class [ff00]: Altera Corporation Device 0000 (rev01)
    08:00.1 Unassigned class [ff00]: Altera Corporation Device 0000
  7. Enter option 8 to perform a link test for every enabled virtual function allocated for the physical function. The link test application does 100 memory writes with a single dword of data each and then reads the data back for checking. The application then prints the number of virtual functions that failed the link test at the end of the testing.