Altera RTE for OpenCL - Manual (Page 15)

8. To verify the successful installation of the FPGA board, invoke the command
aocl diagnose
<device_name>
to run any board vendor-recommended diagnostic test.
Related Information
• Setting the Environment Variables for Windows on page 2-2
• Querying the Device Name of Your FPGA Board on page 2-6
• Installing the Cyclone V SoC Development Kit on page 4-5
Updating the Hardware Image on the FPGA
If applicable, before you execute an OpenCL kernel program on the FPGA, ensure that the flash memory
of the FPGA contains a hardware image created using a current version of the OpenCL software.
Remember: If your Custom Platform requires that you preload a valid OpenCL image into the flash
memory, for every major release of the Altera Complete Design Suite, program the flash
memory of the FPGA with a hardware image compatible with the current version of the
software.
Querying the Device Name of Your FPGA Board
Some AOCL utility commands require you to specify the device name (<device_name>). The
<device_name> refers to the acl number (e.g. acl0 to acl15) that corresponds to the FPGA device. When
you query a list of accelerator boards, the RTE produces a list of installed devices on your machine in the
order of their device names.
• To query a list of installed devices on your machine, type
aocl diagnose
at a command prompt.
The software generates an output that resembles the example shown below:
aocl diagnose: Running diagnostic from ALTERAOCLSDKROOT/board/<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
2-6 Updating the Hardware Image on the FPGA
OCL005-15.0.0
2015.05.04
Altera Corporation Getting Started with the Altera RTE for OpenCL for 64-Bit Windows
Send Feedback