Intel® oneAPI Programming Guide

Programming Guide

Contents

FPGA Board Initialization

Before you run an executable containing an FPGA hardware image, you must initialize the FPGA board using the following command:
aocl initialize <board id> <board variant>
where:
FPGA Board initialization parameters
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 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 executable using the following compiler 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 executable without initializing the board again, unless you are doing one of the following:
  • Running a SYCL*-compiled workload for the first time after power cycling the host.
  • Running a SYCL-compiled workload after running a non-SYCL workload on the FPGA.
  • Running a SYCL compiled 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.