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