面向采用Intel® Arria® 10 GX FPGA的Intel®可编程加速卡的Intel加速堆栈快速入门指南

ID 683633
日期 12/04/2020
Public
文档目录

7.2.1. 运行Hello FPGA示例

hello_fpga示例主机应用程序使用OPAE库在本机环回模式(NLB)下测试硬件。使用nlb_mode_0 AFU映像加载FPGA以运行此示例。

运行以下命令以测试hello_fpga示例主机应用程序:

  1. 运行以下命令以加载AFU映像:
    sudo fpgasupdate $OPAE_PLATFORM_ROOT/hw/samples/nlb_mode_0/bin/\
    nlb_mode_0_unsigned.gbs
  2. 配置系统大页面以分配此实用程序所需的20个2 MB大页面。此命令需要根特权:
    sudo sh -c "echo 20 > /sys/kernel/mm/hugepages/\
    hugepages-2048kB/nr_hugepages"
  3. 编译位于$OPAE_PLATFORM_ROOT/sw/opae*/samples/hello_fpga.chello_fpga的源代码:
    cd $OPAE_PLATFORM_ROOT/sw
  4. 提取tar文件:
    tar xf opae*.tar.gz
    注: 仅当从二进制文件安装了OPAE软件时,才需要执行此步骤。有关更多信息,请参考从预构建二进制文件安装OPAE软件部分。
  5. 移至OPAE目录:
    cd opae*
  6. 编译示例:
    RHEL:
    gcc -o hello_fpga -std=gnu99 -rdynamic \
    -ljson-c -luuid -lpthread -lopae-c -lm -Wl,-rpath \
    -lopae-c $OPAE_PLATFORM_ROOT/sw/opae*/samples/hello_fpga.c
    
    Ubuntu:
    gcc -o hello_fpga -std=gnu99 -rdynamic \
    -ljson-c -luuid -lpthread -lopae-c -lm -Wl,--no-as-needed \
    -lopae-c -luuid $OPAE_PLATFORM_ROOT/sw/opae*/samples/hello_fpga.c
  7. 输入以下命令运行此示例:
    选项 描述
    For the OPAE RPM installation:
    sudo ./hello_fpga
    For an OPAE installation from source:
    sudo LD_LIBRARY_PATH=\
    $LD_LIBRARY_PATH:/<path to opae install>/\
    lib64 ./hello_fpga

    样本输出:

    Running Test
    Done Running Test
    关于hello_fpga示例的更多信息,请参考以下文件:
    • 位于$OPAE_PLATFORM_ROOT/sw/opae*/samples/hello_fpga.c中的源代码
    • Native Loopback Accelerator Functional Unit (AFU) User GuideAFU寄存器描述。