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 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-Xsboardflag.