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, asp_usm_variant. |
For example, consider that you download a BSP named custom-oneapi-asp which has a USM board variant on your system and you compile your executable with the following command:
icpx -fsycl -fintelfpga -Xshardware -Xstarget=custom-oneapi-asp:asp_usm_variant
In this case, initialize the board using the following command:
aocl initialize acl0 asp_usm_variant
Refer to the documentation provided by your board vendor for your BSP and the names of the supported board variants.
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:
-------------------------------------------------------------------- ICD System Diagnostics -------------------------------------------------------------------- Using the following location for ICD installation: /etc/OpenCL/vendors Found 3 icd entry at that location: /etc/OpenCL/vendors/intel64.icd /etc/OpenCL/vendors/Altera.icd /etc/OpenCL/vendors/Intel_FPGA_SSG_Emulator.icd The following OpenCL libraries are referenced in the icd files: /opt/intel/oneapi/compiler/latest/linux/lib/x64/libintelocl.so Checking LD_LIBRARY_PATH for registered libraries: /opt/intel/oneapi/compiler/latest/linux/lib/x64/libintelocl.so was registered on the system. /opt/intel/oneapi/compiler/latest/linux/lib/oclfpga/host/linux64/lib/libalteracl.so Checking LD_LIBRARY_PATH for registered libraries: /opt/intel/oneapi/compiler/latest/linux/lib/oclfpga/host/linux64/lib/libalteracl.so was registered on the system. /opt/intel/oneapi/compiler/latest/linux/lib/x64/libintelocl_emu.so Checking LD_LIBRARY_PATH for registered libraries: /opt/intel/oneapi/compiler/latest/linux/lib/x64/libintelocl_emu.so was registered on the system. Using OCL_ICD_FILENAMES to search for ICD clients, it is set to libintelocl_emu.so:libalteracl.so:/opt/intel/oneapi/compiler/2023.2.0/linux/lib/x64/libintelocl.so Checking LD_LIBRARY_PATH for registered libraries specified by OCL_ICD_FILENAMES libintelocl_emu.so was registered on the system at /opt/intel/oneapi/compiler/2023.2.0/linux/lib/x64 libalteracl.so was registered on the system at /opt/intel/oneapi/compiler/2023.2.0/linux/lib/oclfpga/linux64/lib /opt/intel/oneapi/compiler/2023.2.0/linux/lib/x64/libintelocl.so was registered on the system. Using the following location for fcd installations: /opt/Intel/OpenCLFPGA/oneAPI/Boards Found 1 fcd entry at that location: /opt/Intel/OpenCLFPGA/oneAPI/Boards/ofs_platform-name_shim.fcd The following OpenCL libraries are referenced in the fcd files: libopae-c.so /home/ofsuser/oneapi-asp/platform-name/linux64/lib/libMPF.so /home/ofsuser/oneapi-asp/platform-name/linux64/lib/libintel_opae_mmd.so Checking LD_LIBRARY_PATH for registered libraries: libopae-c.so was registered on the system at /usr/lib64 /home/ofsuser/oneapi-asp/platform-name/linux64/lib/libMPF.so was registered on the system. /home/ofsuser/oneapi-asp/platform-name/linux64/lib/libintel_opae_mmd.so was registered on the system. Number of Platforms = 4 1. Intel(R) FPGA Emulation Platform for OpenCL(TM) | Intel(R) Corporation | OpenCL 1.2 Intel(R) FPGA SDK for OpenCL(TM), Version 20.3 2. Intel(R) FPGA SDK for OpenCL(TM) | Intel(R) Corporation | OpenCL 1.0 Intel(R) FPGA SDK for OpenCL(TM), Version 2023.2 3. Intel(R) OpenCL | Intel(R) Corporation | OpenCL 3.0 LINUX 4. Intel(R) FPGA SDK for OpenCL(TM) | Intel(R) Corporation | OpenCL 1.0 Intel(R) FPGA SDK for OpenCL(TM), Version 2023.2 -------------------------------------------------------------------- ICD diagnostics PASSED -------------------------------------------------------------------- -------------------------------------------------------------------- BSP Diagnostics -------------------------------------------------------------------- -------------------------------------------------------------------- Device Name: acl0 BSP Install Location: /home/ofsuser/oneapi-asp/platform-name Vendor: Intel Corp Physical Dev Name Status Information ofs_ee00001 Passed Intel OFS Platform (ofs_ee00001) PCIe b1:00.0 FPGA temperature = 59 degrees C. DIAGNOSTIC_PASSED -------------------------------------------------------------------- Call "aocl diagnose <device-names>" to run diagnose for specified devices Call "aocl diagnose all" to run diagnose for all devices