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

ID 683517
Date 9/15/2021
Public

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

Document Table of Contents

3.5.2.4.3. Run the Reference Example Application

  1. After the reference application is built, run it:

    $ ./build/mcdma-test -- -h

  2. This command will display the available options in the application as shown in the image below:
  3. Do a PIO test to check if the setup is correct. If successful, the application will show a Pass status.

    [root@BAPVENC011T perfq]# ./build/mcdma-test -- -b 0000:01:00.0 -o

    Here -b should be provided with the correct BDF in the system.

  4. The DPDK driver can be used with the Avalon-ST Packet Generate/Check design example to test the packet generator and checker design.

    The following diagram shows the testing strategy.

    Configuration in examples/mcdma-test/perfq/perfq_app.h

    In the case of static channel mapping, modify the following parameters (ignore these parameters in the case of dynamic channel mapping):
    • /* PF count starts from 1 */
    #define IFC_QDMA_CUR_PF <pf number>
    • /* VF count starts from 1. Zero implies PF was used instead of VF */
    #define IFC_QDMA_CUR_VF <vf number>
    • /* Number of PFs */
    #define IFC_QDMA_PFS <number of PFs>
    /* Channels available per PF */
    #define IFC_QDMA_PER_PF_CHNLS <number of channels per PF>
    • /* Channels available per VF */
    #define IFC_QDMA_PER_VF_CHNLS <number of channels per VF>
    • /* Number of VFs per PF */
    #define IFC_QDMA_PER_PF_VFS <number of VFs per PF>

    perfq_app command line parameters:

    Command:
    $ ./build/mcdma-test -m 8192 --file-prefix=pf0 --\
     -b 0000:01:00.0 -p 32768 -d 2 -c 1 -a 2 -l 5 -z
    2
    Configuration:
    1. 1 channel (-c 1)
    2. Packet generator bidirectional (-z)
    3. Payload length of 64 bytes in each descriptor (-p 32768)
    4. Transfer the data every 5 seconds (-l 5)
    5. Dump the progress log every second (-d 2)
    Note: This hardware test was run with the Intel® Stratix® 10 GX H-tile PCIe Gen3 x16 configuration.
  5. The DPDK driver can also be used with the Avalon-ST Device-side Packet Loopback design example to test loopback.

    The following diagram shows the testing strategy.

    Command: $ ./build/mcdma-test -m 8192 --file-prefix=pf0 -l 0-15 -- -b 0000:01:00.0 -p 32768 -d 2 -c 1 -a 2 -l 5 -i

    Configuration:
    1. 1 channel (-c 1)
    2. Packet generator bidirectional (-i)
    3. Payload length of 64 bytes in each descriptor (-p 32768)
    4. Transfer the data every 5 seconds (-l 5)
    5. Dump the progress log every second (-d 2)
    Note: This hardware test was run with the Intel® Stratix® 10 GX H-tile PCIe Gen3 x16 configuration.
If you are testing with 128 and 256 channels define the following flag in examples/mcdma-test/perfq/Makefile:
CFLAGS += -UIFC_MCDMA_FUNC_VER
  1. Verify with 508 batch size.
  2. Pass batch size as extra parameter (-x 508).
Example command:
./build/mcdma-test -m 8192 -l 0-15 -- -b 0000:01:00.0 -p 64\
 -i -l 5 -c 256 -d 1 -a 8 -x 508

Did you find the information on this page useful?

Characters remaining:

Feedback Message