Altera RTE for OpenCL Manuel d'utilisateur

Altera RTE for OpenCLGetting Started GuideSubscribeSend FeedbackOCL005-15.0.02015.05.04101 Innovation DriveSan Jose, CA 95134www.altera.com

Getting Started with the Altera RTE for OpenCLfor 64-Bit Windows22015.05.04OCL005-15.0.0SubscribeSend Feedback1. Downloading the Altera RTE for OpenCL

If you do not have a myAltera account, register for a new account.2. Click DOWNLOADS to enter the Download Center.3. Click Altera SDK for OpenCL to en

Attention: If you set the environment variables permanently, you apply the settings once during installa‐tion. If you set the environment variables tr

Attention: The ARM processor on the Cyclone V SoC Development Kit does not support the AOCLversion utility.•At a command prompt, invoke the aocl versi

Related Information• Altera Licensing page on the Altera website• Altera Software Installation and Licensing• Altera websiteInstalling an FPGA BoardBe

8.To verify the successful installation of the FPGA board, invoke the command aocl diagnose<device_name> to run any board vendor-recommended dia

Programming the Flash Memory of an FPGA on WindowsBy default, you configure an FPGA using the hardware image stored in the flash memory of the device.

• OpenCL Design Examples page on the Altera websiteExecuting an OpenCL Kernel on an FPGABuild your OpenCL host application in Microsoft Visual Studio

Example output:Found 1 OpenCL platforms.Querying platform for info:==========================CL_PLATFORM_NAME = Altera SDK for

Uninstalling the FPGA BoardTo uninstall an FPGA board for Windows, invoke the uninstall utility command, uninstall theCustom Platform, and unset the r

ContentsAltera RTE for OpenCL Getting Started Guide... 1-1Prerequisites for the Altera RTE for OpenCL...

Getting Started with the Altera RTE for OpenCLfor x86_64 Linux and 64-Bit Linux Big-EndianSystem32015.05.04OCL005-15.0.0SubscribeSend Feedback1. Downl

If you do not have a myAltera account, register for a new account.2. Click DOWNLOADS to enter the Download Center.3. Click Altera SDK for OpenCL to en

Attention: If you set the environment variables permanently, you apply the settings once during installa‐tion. If you set the environment variables tr

Setting the Environment Variables on Big-Endian SystemsYou have the option to apply environment variables permanently or transiently. The environmentv

Attention: The ARM processor on the Cyclone V SoC Development Kit does not support the AOCLversion utility.•At a command prompt, invoke the aocl versi

Related Information• Altera Licensing page on the Altera website• Altera Software Installation and Licensing• Altera websiteInstalling an FPGA BoardBe

Related Information• Installing the Cyclone V SoC Development Kit on page 4-16• Setting the Environment Variables on Big-Endian Systems on page 3-4• Q

you power up the system, it configures the FPGA circuitry based on this hardware image in the flashmemory. Therefore, it is imperative that an OpenCL-

Building the Host ApplicationBuild the host executable with the <path_to_exm_opencl_hello_world_x64_linux_<version>>/hello_world/Makefile

CL_DEVICE_MIN_DATA_TYPE_ALIGN_SIZE = 128CL_DEVICE_PREFERRED_VECTOR_WIDTH_CHAR = 4CL_DEVICE_PREFERRED_VECTOR_WIDTH_SHORT = 2CL_DEVICE_PREFERRED

Running the Host Application...3-9Output from Succ

Getting Started with the Altera RTE for OpenCLfor Altera ARMv7-A SoC42015.05.04OCL005-15.0.0SubscribeSend FeedbackGetting Started with the Altera RTE

6. Installing the RTE onto the SoC Board on page 4-4The Altera Runtime Environment (RTE) for OpenCL installation package for Altera SoCs with 32-bitAR

To get started with the Altera RTE for OpenCL on the Cyclone V SoC Development Kit, install the AOCLfor Windows.Before you beginYou must have administ

You must obtain a separate license for the SoC Embedded Design Suite (EDS).4. If you have a fixed license, append the <path_to_license_file>/<

1.Create an RTE directory on the board's file system by typing the mkdir <rte_destina-tion_directory> command.2.Move the downloaded install

Figure 4-1: Key Components of the Cyclone V SoC Development Kit1. Writing an SD Card Image onto the Micro SD Flash Card on Windows on page 4-6To write

Before you beginThe SD card image linux_sd_card_image.tgz is available in the Cyclone V SoC Development Kit ReferencePlatform. Ensure that the environ

Setting Up Terminal Connection in WindowsTo set up the terminal connection for the Cyclone V SoC Development Kit in Windows, specify the USBvirtual CO

The init_opencl.sh file is available in the SD card image that you write onto the micro SD flash card. Itcontains the commands shown below:export ALTE

To reboot the CPU, press the Warm reset button next to the four hard processor system (HPS) LEDson the board.3. If you are unable to acquire the IP ad

Altera RTE for OpenCL Getting Started Guide12015.05.04OCL005-15.0.0SubscribeSend FeedbackThe Altera RTE for OpenCL Getting Started Guide describes the

The hello_world executable will be in the <path_to_exm_opencl_hello_world_arm32_linux_<version>>\hello_world\bin directory.Related Informa

CL_DEVICE_PREFERRED_VECTOR_WIDTH_DOUBLE = 0Command queue out of order? = falseCommand queue profiling enabled? = trueKernel initial

To download the Altera RTE for OpenCL, click the RTE tab and select Altera Runtime Environment forOpenCL Linux Cyclone V SoC TGZ.1. In the main page o

The installation path must not contain any spaces (for example, <home_directory>\altera\<version>\hld).3. Verify that the installer sets t

a. Create a backup copy of the provided license file.b. Save the new license file on your local hard drive.c. Append the <path_to_license_file>/

1.Create an RTE directory on the board's file system by typing the mkdir <rte_destina-tion_directory> command.2.Move the downloaded install

Figure 4-2: Key Components of the Cyclone V SoC Development Kit1. Writing an SD Card Image onto the Micro SD Flash Card on Linux on page 4-17To write

Cyclone V SoC Development Kit Reference Platform, and then write the image onto the micro SD flashcard. The SD card image contains everything you need

Setting Up Terminal Connection in LinuxTo set up the terminal connection for the Cyclone V SoC Development Kit in Linux, specify the USBvirtual COM po

a. Set the PATH, LD_LIBRARY_PATH, and AOCL_BOARD_PACKAGE_ROOT environmentvariables.b. Load the OpenCL Linux kernel driver.The init_opencl.sh file is a

Prerequisites for the Altera RTE for OpenCLTo install the RTE and deploy an OpenCL application on an Altera preferred accelerator board, yoursystem mu

Sending discover...No lease, failingThe board uses the dynamic host configuration protocol (DHCP) to acquire an IP address. If thesession times out wa

Build your host application using the GNU Compiler Collection (GCC) cross-compiler available with theSoC Embedded Design Suite (EDS).Related Informati

Querying device for info:========================CL_DEVICE_NAME = c5soc : Cyclone V SoC Development KitCL_DEVICE_VENDOR

Document Revision HistoryA2015.05.04OCL005-15.0.0SubscribeSend FeedbackDate Version ChangesMay 2015 15.0.0• Reorganized instructions into the followin

Utilities and Host Runtime Libraries• The RTE Utility includes commands you can invoke to perform high-level tasks. The RTE utilities area subset of o

WindowsFolderLinuxDirectoryBig-EndianSystemDirectoryARMDirectoryDescriptionhost\windows64\libhost/linux64/libhost/ppc64/libhost/arm32/libOpenCL host r

Displaying the Software VersionTo display the version of the Altera RTE for OpenCL , invoke the version utility command.Note: The ARM processor on the

For information on the following utility command options, refer to the Managing Host Applicationsection of the Altera SDK for OpenCL Programming Guide