Scalable Scatter-Gather DMA Intel® FPGA IP Design Example User Guide

Download PDF
ID 823179
Date 4/30/2025
Public
Document Table of Contents
Document Table of Contents x
1. Design Example Description 2. Quick Start Guide 3. Document Revision History for the Scalable Scatter-Gather DMA Intel® FPGA IP Design Example User Guide
1. Design Example Description x
1.1. H2D ST to D2H ST Loopback Design Example
1.1. H2D ST to D2H ST Loopback Design Example x
1.1.1. DMA PCIe* Mode Design Example 1.1.2. DMA SoC Mode Design Example
2. Quick Start Guide x
2.1. Directory Structure 2.2. Generating the Design Example 2.3. Simulating the Design Example 2.4. Testbench 2.5. Compiling the Design Example 2.6. Hardware and Software Requirements 2.7. Running the Design Example
2.3. Simulating the Design Example x
2.3.1. DMA SoC Mode Example Design 2.3.2. DMA PCIe Mode Example Design
2.3.2. DMA PCIe Mode Example Design x
2.3.2.1. Running Simulation using VCS* MX 2.3.2.2. Running Simulation Using QuestaSim* 2.3.2.3. Running Simulation using Xcelium 2.3.2.4. Running Simulation using Riviera-PRO
2.4. Testbench x
2.4.1. DMA SoC Mode H2D ST to D2H ST Loopback Example Testbench 2.4.2. DMA PCIe Mode H2D ST to D2H ST Loopback & H2D MM Example Testbench
2.4.2. DMA PCIe Mode H2D ST to D2H ST Loopback & H2D MM Example Testbench x
2.4.2.1. Design Example Testbench
2.7. Running the Design Example x
2.7.1. Running the DMA SoC Mode H2D ST to D2H ST Loopback Design Example 2.7.2. Running the DMA PCIe Mode H2D ST to D2H ST Loopback Design Example
2.7.1. Running the DMA SoC Mode H2D ST to D2H ST Loopback Design Example x
2.7.1.1. Building the Software Application Project for Nios® V/m Processor 2.7.1.2. Programming the Example Design into the Development Board
2.7.2. Running the DMA PCIe Mode H2D ST to D2H ST Loopback Design Example x
2.7.2.1. Installing the Linux Kernel Driver 2.7.2.2. Running the Loopback Design Example
2.7.2.2. Running the Loopback Design Example x
2.7.2.2.1. Testing H2D ST to D2H ST Loopback 2.7.2.2.2. Testing H2D MM
1. Design Example Description
2. Quick Start Guide
3. Document Revision History for the Scalable Scatter-Gather DMA Intel® FPGA IP Design Example User Guide

2.7.2.1. Installing the Linux Kernel Driver

Before you can test the design example in hardware, you must configure the FPGA with the generated programming file and then restart your computer/system to allow the enumeration to take place for the PCIe* device. After that, install the Linux kernel driver. You can use this driver to perform the following tests:
  • H2D ST and D2H ST loopback DMA transfer
  • On-chip Memory Read and Write via DMA Transfer

Complete the following steps to install the kernel driver:

  1. Navigate to <design_example>/PCIE_MODE/software under the design example generation directory.
  2. Set the architecture
    $ export ARCH=x86
  3. Set cross compiler to none
    $ export CROSS_COMPILE=
  4. Set Linux kernel source directory 
    $ export KERNELDIR=/lib/modules/$(uname -r)/build
  5. Clean the build directory
    $ make clean
  6. Build SSGDMA driver for DMA PCIe mode
    $ make debug_pcie
  7. Insert application as kernel module
    $ sudo insmod intel_ssgdma.ko
  8. Change the permission of the device module. 
    $ sudo chmod 777 /dev/edmadbg0
  9. Verify driver installation
    $ lspci -d 1172:005 -v | grep “Intel SSGDMA”

Expected result: “Kernel driver in use: Intel SSGDMA”

Level Two Title