A newer version of this document is available. Customers should click here to go to the newest version.
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:
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 -Xstarget 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:
icpx -fsycl -fintelfpga -Xshardware -Xstarget=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 -Xstarget flag.