DMA Accelerator Functional Unit User Guide: Intel® FPGA Programmable Acceleration Card D5005

Download PDF
ID 683270
Date 8/03/2020
Public
Document Table of Contents
Document Table of Contents x
1. About this Document 2. DMA AFU Description 3. Register Map and Address Spaces 4. Software Programming Model 5. Running DMA AFU Example 6. Compiling the DMA AFU Example 7. Simulating the AFU Example 8. Optimization for Improved DMA Performance 9. DMA Accelerator Functional Unit User Guide Archives 10. Document Revision History for the DMA Accelerator Functional Unit User Guide
1. About this Document x
1.1. Intended Audience 1.2. Conventions 1.3. Acronyms 1.4. Acceleration Glossary
2. DMA AFU Description x
2.1. Introduction 2.2. The DMA AFU Software Package 2.3. The DMA AFU Hardware Components
2.3. The DMA AFU Hardware Components x
2.3.1. DMA Test System 2.3.2. DMA BBB
3. Register Map and Address Spaces x
3.1. DMA AFU Register Map
3.1. DMA AFU Register Map x
3.1.1. DMA AFU Address Space 3.1.2. Device Feature Header Linked-List
1. About this Document
2. DMA AFU Description
3. Register Map and Address Spaces
4. Software Programming Model
5. Running DMA AFU Example
6. Compiling the DMA AFU Example
7. Simulating the AFU Example
8. Optimization for Improved DMA Performance
9. DMA Accelerator Functional Unit User Guide Archives
10. Document Revision History for the DMA Accelerator Functional Unit User Guide

5. Running DMA AFU Example

Before you begin:
  • You should be familiar with the examples in the Intel Acceleration Stack Quick Start Guide for Intel® FPGA Programmable Acceleration Card D5005 .
  • You must define an environment variable. The environment variable is dependent on the Intel® Acceleration Stack version you are using:
    • For current version, set the environment variable to $OPAE_PLATFORM_ROOT
  • You must install the Intel® Threading Building Blocks (TBB) library since the DMA driver relies on it.
  • You must also set up two 1 GB hugepages to run the sample application.
    $ sudo sh -c "echo 2 > /sys/kernel/mm/hugepages/hugepages-1048576kB/nr_hugepages"

Perform the following steps to download the DMA Accelerator Function (AF) bitstream, to build the application and driver, and to run the design example:

  1. Change to the DMA application and driver directory: 
    cd $OPAE_PLATFORM_ROOT/hw/samples/dma_afu/sw
  2. Build the driver and application: 
    make
  3. Download the DMA AFU bitstream: 
    sudo fpgasupdate ../bin/dma_afu_unsigned.gbs
  4. Execute the host application to write 100 MB in 1 MB portions from host memory to FPGA device memory and read it back: 
    ./fpga_dma_test -s 104857600 -p 1048576 -r mtom
Related Information
Level Two Title