L-tile and H-tile Avalon® Memory-mapped Intel® FPGA IP for PCI Express* User Guide

ID 683667
Date 9/26/2022
Public

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

Document Table of Contents

2.8. Running the Design Example Application

  1. Navigate to ./software/user/example under the design example directory.
  2. Compile the design example application:
    $ make
  3. Run the test:

    $ sudo ./intel_fpga_pcie_link_test

    You can run the Intel® FPGA IP PCIe* link test in manual or automatic mode.

    • In automatic mode, the application automatically selects the device. The test selects the Intel® Stratix® 10 PCIe* device with the lowest BDF by matching the Vendor ID. The test also selects the lowest available BAR.
    • In manual mode, the test queries you for the bus, device, and function number and BAR.
    For the Intel® Stratix® 10 GX Development Kit, you can determine the BDF by typing the following command:

    $ lspci -d 1172

  4. Here are sample transcripts for automatic and manual modes:
    Intel FPGA PCIe Link Test - Automatic Mode
    Version 2.0
    0: Automatically select a device
    1: Manually select a device
    ***************************************************
    >0
    Opened a handle to BAR 0 of a device with BDF 0x100
    ***************************************************
    0: Link test - 100 writes and reads
    1: Write memory space
    2: Read memory space
    3: Write configuration space
    4: Read configuration space
    5: Change BAR
    6: Change device
    7: Enable SR-IOV
    8: Do a link test for every enabled virtual function
       belonging to the current device
    9: Perform DMA
    10: Quit program
    ***************************************************
    > 0
    Doing 100 writes and 100 reads . . 
    Number of write errors:     0
    Number of read errors:      0
    Number of DWORD mismatches: 0
    Intel FPGA PCIe Link Test - Manual Mode
    Version 1.0
    0: Automatically select a device
    1: Manually select a device
    ***************************************************
    > 1
    Enter bus number:
    > 1
    Enter device number:
    > 0
    Enter function number:
    > 0
    BDF is 0x100
    Enter BAR number (-1 for none):
    > 4
    Opened a handle to BAR 4 of a device with BDF 0x100