Programming Guide


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>
FPGA Board initialization parameters
Board ID obtained from the aocl diagnose command. For example,
, and so on.
<board variant>
Name of the board variant as specified by the
flag the executable was compiled with. For example,
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

Product and Performance Information


Performance varies by use, configuration and other factors. Learn more at