Altera RTE for OpenCL - Manual (Page 25)

Related Information
• Altera Licensing page on the Altera website
• Altera Software Installation and Licensing
• Altera website
Installing an FPGA Board
Before creating an OpenCL application for an FPGA board on Linux, you must first download and install
the Custom Platform from your board vendor. Most Custom Platform installers require administrator
privileges. To install your board into the host system, invoke the
install
utility command.
The steps below outline the board installation procedure. Some Custom Platforms require additional
installation tasks. Consult your board vendor's documentation for further information on board
installation.
Attention: If you are installing the Cyclone V SoC Development Kit for use with the Cyclone V SoC
Development Kit Reference Platform, refer to Installing the Cyclone V SoC Development Kit in
the Altera SDK for OpenCL Cyclone V SoC Getting Started Guide for more information.
1. Follow your board vendor's instructions to connect the FPGA board to your system.
2. Download the Custom Platform for your FPGA board from your board vendor's website.
For more information, refer to the OpenCL Reference Platforms page within the Altera website.
3. Install the Custom Platform in a directory that you own (that is, not a system directory).
4. Set the environment variable AOCL_BOARD_PACKAGE_ROOT to point to the location of the
Custom Platform subdirectory containing the board_env.xml file.
For example, for the Stratix V Network Reference Platform (s5_net), set
AOCL_BOARD_PACKAGE_ROOT to point to the /s5_net directory.
5. Add the Custom Platform library paths to the LD_LIBRARY_PATH environment variable. You may
apply permanent settings manually by adding the path to the memory-mapped (MMD) library within
the Custom Platform. . Alternatively, you may apply transient settings to the current command
window by running the $ALTERAOCLSDKROOT/init_opencl.sh script.
For example, if you use s5_net, the Linux LD_LIBRARY_PATH setting is
$AOCL_BOARD_PACKAGE_ROOT/linux64/lib .
For more information on the init_opencl.sh script, refer to the Setting the Environment Variables for
Linux section.
6. Invoke the command
aocl install
at a command prompt.
Invoking
aocl install
also installs a board driver that allows communication between host
applications and hardware kernel programs.
7. To query a list of FPGA devices installed in your machine, invoke the
aocl diagnose
command.
The software generates an output that includes the , which is an acl number that ranges
from acl0 to acl15.
For more information on querying the of your accelerator board, refer to the Querying
the Device Name of Your FPGA Board section.
8. To verify the successful installation of the FPGA board, invoke the command
aocl diagnose
to run any board vendor-recommended diagnostic test.
3-6 Installing an FPGA Board
OCL005-15.0.0
2015.05.04
Altera Corporation Getting Started with the Altera RTE for OpenCL for x86_64 Linux and 64-Bit Linux Big-Endian System
Send Feedback