Programming Guide

Contents

FPGA Board Initialization

Before you run a DPC++ executable containing an FPGA hardware image, you must initialize the FPGA board using the following command:
aocl initialize <board id> <board variant>
where:
Parameter
Description
<board_id>
Board ID obtained from the
aocl diagnose
command. For example,
acl0
,
acl1
, and so on.
<board variant>
Name of the board variant as specified by the
-Xsboard
flag the DPC++ executable was compiled with. For example,
pac_s10_usm
.
For example, consider that you have a single Intel® Programmable Acceleration Card (PAC) D5005 (previously known as
Intel® Programmable Acceleration Card (PAC) with Intel® Stratix® 10 SX
) on your system and you compile the DPC++ executable using the following command:
dpcpp -fintelfpga -Xshardware -Xsboard=intel_s10sx_pac:pac_s10_usm kernel.cpp
In this case, you must initialize the board using the following command:
aocl initialize acl0 pac_s10_usm
Once this is complete, you can run the DPC++ executable without initializing the board again, unless you are doing one of the following:
  • Running a DPC++ workload for the first time after power cycling the host.
  • Running a DPC++ workload after running a non-DPC++ workload on the FPGA.
  • Running a DPC++ workload compiled with a different board variant in
    -Xsboard
    flag.

Product and Performance Information

1

Performance varies by use, configuration and other factors. Learn more at www.Intel.com/PerformanceIndex.