Multi Channel DMA Intel® FPGA IP for PCI Express Design Example User Guide

ID 683517
Date 10/28/2022

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

Document Table of Contents Install PMD and Test Application

  1. Download dpdk and apply the build patches.

    Execute the following commands with root as user.

    $ cd software/dpdk/patches/v20.05-rc1

    $ sh
    Note: If you are using higher kernel versions in Ubuntu, apply the below patch.
    $cd dpdk
    $git apply ../mcdma-Ubuntu-21.04-Compilation-Fix-patch
  2. Enable the following parameters in the build configuration.

    Update the following macro in ./config/common_base to “y”. By default, igb_uio is disabled.


    Enabling VFIO: If you want to use VFIO instead of UIO:
    1. In the file ./dpdk/drivers/net/mcdma/rte_pmd_mcdma.h
      undefine UIO_SUPPORT #undef UIO_SUPPORT
    2. Update the following macro in ./config/common_base to “y”
  3. Build DPDK and install.
    Execute the following steps:
    • $ export DPDK_DIR= <cloned dir>/software/dpdk/patches/v20.05-rc1/dpdk
    • $ export RTE_SDK=${DPDK_DIR}
    • $ export DPDK_TARGET=x86_64-native-linuxapp-gcc
    • $ export RTE_TARGET=x86_64-native-linuxapp-gcc
    • $ make config T=x86_64-native-linuxapp-gcc
    • $ rm -rf x86_64-native-linuxapp-gcc
    • $ make -j32 install T=$DPDK_TARGET DESTDIR=install
  4. Execute the following steps if proceeding with UIO support.

    Install UIO base module.

    $ modprobe uio

    Install igb_uio module.

    $ insmod x86_64-native-linuxapp-gcc/build/kernel/linux/igb_uio/igb_uio.ko

    Bind the device to the igb_uio driver.

    $ ./usertools/ -b igb_uio <BDF>

    To install VFIO module (If VFIO is being used instead of UIO)
    $modprobe vfio-pci
    Bind the device to the vfio-pci driver.
    $DPDK_DIR/usertools/ -b vfio-pci <BDF>
  5. Build the reference application.

    $ cd examples/mcdma-test/perfq/

    $ make clean all

    $ make