Visible to Intel only — GUID: GUID-B247CD0C-13DD-451A-9085-F4B2813D4050
Visible to Intel only — GUID: GUID-B247CD0C-13DD-451A-9085-F4B2813D4050
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.
The aocl diagnose Command
Use device_name output from the aocl diagnose command to obtain the board ID for your installed accelerator boards.
The aocl diagnose command generates output similar to the following output:
aocl diagnose: Running diagnostic from <board_package_path>/<board_name>/<platform>/libexec Verified that the kernel mode driver is installed on the host machine. Using board package from vendor: <board_vendor_name> Querying information for all supported devices that are installed on the host machine ... device_name Status Information acl0 Passed <descriptive_board_name> PCIe dev_id = <device_ID>, bus:slot.func = 02:00.00, at Gen 2 with 8 lanes. FPGA temperature = 43.0 degrees C. acl1 Passed <descriptive_board_name> PCIe dev_id = <device_ID>, bus:slot.func = 03:00.00, at Gen 2 with 8 lanes. FPGA temperature = 35.0 degrees C. Found 2 active device(s) installed on the host machine, to perform a full diagnostic on a specific device, please run aocl diagnose <device_name> DIAGNOSTIC_PASSED