Terasic DE5a-Net User manual

DE5a-Net OpenCL
www.terasic.com
March 29, 2017
1

DE5a-Net OpenCL
www.terasic.com
March 29, 2017
2
CONTENTS
CHAPTER 1 DE5A-NET OPENCL ..........................................................................................................................3
1.1 SYSTEM REQUIREMENT ............................................................................................................................................3
1.2 OPENCLARCHITECTURE ..........................................................................................................................................4
CHAPTER 2 OPENCL FOR WINDOWS ................................................................................................................5
2.1 SOFTWARE INSTALLATION.........................................................................................................................................5
2.2 OPENCLLICENSE INSTALLATION..............................................................................................................................7
2.3CONFIGURE...............................................................................................................................................................8
2.4 BOARD SETUP.........................................................................................................................................................11
2.5 OPENCLENVIRONMENT VERIFYAND FLASH CVP..................................................................................................12
2.6 COMPILE AND TEST OPENCLPROJECT....................................................................................................................16
CHAPTER 3 OPENCL FOR LINUX .......................................................................................................................19
3.1 SOFTWARE INSTALLATION.......................................................................................................................................19
3.2 OPENCLLICENSE INSTALLATION............................................................................................................................22
3.3 CONFIGURE.............................................................................................................................................................22
3.4 BOARD SETUP.........................................................................................................................................................23
3.5 OPENCLENVIRONMENT VERIFYAND FLASH CVP..................................................................................................24
3.6 COMPILE AND TEST OPENCLPROJECT....................................................................................................................28

DE5a-Net OpenCL
www.terasic.com
March 29, 2017
3
Chapter 1
DE5a-Net OpenCL
DE5a-Net, an unparalleled and powerful platform for high-speed computation, is now officially also
an Altera certified board for Intel‟s Preferred Board Partner Program for OpenCL. It supports both
64-bit Windows and Linux. This document will introduce you how to setup OpenCL development
environment for DE5a-Net board, and how to compile and execute the example projects for
DE5a-Net. Note that OpenCL coding instruction is not in the scope of this document, but the user
can refer to Altera SDK for OpenCL Programming Guide for more details.
https://www.altera.com/en_US/pdfs/literature/hb/opencl-sdk/aocl_programming_guide.pdf
1
1. .1 1 S Sy ys st te em m R Re eq qu ui ir re em me en nt t
The following items are required to set up OpenCL for DE5a-Net board:
DE5a-Net Board with two 4GB DDR3-SODIMM installed on two DDR3-SODIMM port.
A Host PC with
USB Host Port
One PCI Express x8/x16 slot with 12V power pin
32GB memory is recommended, 24GB is minimal
2x3 pin 12V Power for DE5a-Net (optional)
An USB Cable(type A to mini-B)
64-bit Windows7/10 or Linux(Redhat 6.5/CentOS 7.0) Installed
Intel Quartus Prime Pro Edition 16.1 Installed, licensed is required
Intel FPGA SDK for OpenCL 16.1 Installed, license is required
DE5a-Net OpenCL BSP 16.1 Installed
Visual Studio 2012 C/C++ installed for Windows7/10
GNU development tools for Linux
Note:
1. Intel FPGA OpenCL only supports 64-bit OS and x86 architecture.
2. We strongly recommend setting the PCIe speed to Gen3x8 in your PC BIOS for good
performance.

DE5a-Net OpenCL
www.terasic.com
March 29, 2017
4
1
1. .2 2 O Op pe en nC CL L A Ar rc ch hi it te ec ct tu ur re e
An OpenCL project is composed of both OpenCL Kernel and Host Program as shown in Figure
1-1. OpenCL kernel is compiled with Intel FPGA OpenCL compiler provided by the Altera OpenCL
SDK. The Host Program is compiled by Visual Studio C/C++ in Windows or GCC on Linux.
Figure 1-1 Intel FPGA OpenCLArchitecture

DE5a-Net OpenCL
www.terasic.com
March 29, 2017
5
Chapter 2
OpenCL for Windows
This chapter describes how to set up DE5a-Net OpenCL development environment on 64-bit
Windows, and how to compile and test the OpenCL examples for DE5a-Net. For more details about
Intel FPGA OpenCL started guide, please refer to:
https://www.altera.com/en_US/pdfs/literature/hb/opencl-sdk/aocl_getting_started.pdf
2
2. .1 1 S So of ft tw wa ar re e I In ns st ta al ll la at ti io on n
This section describes where to get the required softwares for OpenCL.
Quartus II and OpenCLSDK
Intel Quartus Prime Pro Edition 16.1 and Intel FPGA SDK for OpenCL 16.1 can be download from
the web site:
http://dl.altera.com/opencl/16.1/?edition=standard
For Quartus II installation, please make sure that the Arria 10 device is included.
open the link and select the Windows SDK table as Figure 2-1shows.

DE5a-Net OpenCL
www.terasic.com
March 29, 2017
6
Figure 2-1 OpenCLWindows SDK Files
Visual Studio 2012
If developers don‟t have Visual studio C/C++ 2012, they can use the trial version of Visual Studio
2012 Express. The software can be downloaded from the web site:
http://www.microsoft.com/en-us/download/details.aspx?id=34673
DE5a-Net OpenCLBSP (Board Support Package)
After Quartus II and OpenCL SDK are installed, download the DE5ANET_E1_OpenCL_BSP
_16.1.zip DE5a-Net windows BSP for Intel FPGA OpenCL 16.1 from the web:
http://de5a-net.terasic.com/cd
Then, decompress DE5ANET_E1_OpenCL_BSP_16.1.zip to the “de5a_net_e1” folder under the
folder “C:\intelFPGA_pro\16.1\hld\board”, as shown in Figure 2-2, where assumed Quartus II is
installed on the folder “C:\ intelFPGA_pro \16.1”.

DE5a-Net OpenCL
www.terasic.com
March 29, 2017
7
Figure 2-2 DE5a-Net OpenCL BSPContent
2
2. .2 2 O Op pe en nC CL L L Li ic ce en ns se e I In ns st ta al ll la at ti io on n
An OpenCL license is required for Intel FPGA OpenCL SDK to compile any OpenCL projects
successfully. Developers can purchase the OpenCL license from either Altera or Terasic. Assuming
that developers have obtained a license file with the filename “license.dat”, and it is saved in the
local disk with the file path such as “c:\license.dat”. The license can then be set up by creating an
environment variable LM_LICENSE_FILE, and set its value as “c:\license.dat”. Note that this
environment value needs to correspond to the actual “license.dat” file location.
Now, here are the procedures to create the required LM_LICENSE_FILE environment variable on
Windows 7:
1. Open the Start Menu and right click on Computer. Select Properties.
2. Select Advanced system settings.
3. In the Advanced tab, select Environment Variables.
4. Select New.
5. In the popup New User Variable dialog as shown in Figure 2-3,type “LM_LIC
ENSE_FILE” in the Variable name edit box and type “c:\license.dat”in the Vari
able value edit box.

DE5a-Net OpenCL
www.terasic.com
March 29, 2017
8
Figure 2-3 Setup LM_LICENSE_FILE Environment Variable
2
2. .3 3 C Co on nf fi ig gu ur re e
For Intel FPGA OpenCL SDK to be able to find the kit location of DE5a-Net correctly, developers
need to create an environment variable AOCL_BOARD_PACKAGE_ROOT, and set its value as:
“%ALTERAOCLSDKROOT%\board\de5a_net_e1”
Also, append "%AOCL_BOARD_PACKAGE_ROOT%\windows64\bin" and "%ALTERAO
CLSDKROOT%\bin" and "%ALTERAOCLSDKROOT%\windows64\bin" and "C:\intelFP
GA_pro\16.1\qsys\bin" into the PATH environment variable so the OpenCL SDK can find
the binary file provided by DE5a-Net BSP.
Here are the procedures to create the required AOCL_BOARD_PACKAGE_ROOT environment
variable on Windows 7:
1. Open the Start Menu and right click on Computer. Select Properties.
2. Select Advanced system settings.
3. In the Advanced tab, select Environment Variables.
4. Select New.
5. In the popup New User Variable dialog as shown in Figure 2-4, type
“AOCL_BOARD_PACKAGE_ROOT” in the Variable name edit box and type
“%ALTERAOCLSDKROOT%\board\de5a_net_e1”in the Variable value edit box.

DE5a-Net OpenCL
www.terasic.com
March 29, 2017
9
Figure 2-4 Setup AOCL_BOARD_PACKAGE_ROOT Environment Variable
Here are the procedures to add "%AOCL_BOARD_PACKAGE_ROOT%\windows64\bin" and
"%ALTERAOCLSDKROOT%\bin" and "%ALTERAOCLSDKROOT%\windows64\bin" and
"C:\intelFPGA_pro\16.1\qsys\bin" into the PATH environment variable on Windows 7:
1. Open the Start Menu and right click on Computer. Select Properties.
2. Select Advanced system settings.
3. In the Advanced tab, select Environment Variables.
4. In the Environment Variables window (as shown below), highlight the PATH variable in
the Systems Variable section and click the Edit button as shown in Figure 2-5.
5. In the Edit dialog, Append “%AOCL_BOARD_PACKAGE_ROOT%\windows64\bin;
%ALTERAOCLSDKROOT%\bin; %ALTERAOCLSDKROOT%\windows64\bin;
C:\intelFPGA_pro\16.1\qsys\bin” into the Variable value edit box. Note, each different
directory should be separated with a semicolon as shown in Figure 2-6.

DE5a-Net OpenCL
www.terasic.com
March 29, 2017
10
Figure 2-5 Select “Path” and click “Edit” bottom
Figure 2-6 Edit PATH environment variable
6. In Command Prompt window, type “aocl install” to install PCI Express driver. Note that
users need to have administrator privileges to install the driver.

DE5a-Net OpenCL
www.terasic.com
March 29, 2017
11
2
2. .4 4 B Bo oa ar rd d S Se et tu up p
Before testing OpenCL on DE5a-Net, please follow the below procedures to set up DE5a-Net board
on your PC as shown in Figure 2-7.
1. Make sure your PC is powered off.
2. Insert DE5a-Net board into PCI Express x8 or x16 slot.
3. Connect PC‟s 12V PCI Express 6-pin power source to the DE5a-Net
4. Connect PC‟s USB port to DE5a-Net mini USB port using an USB cable.
Note, the usb cable can be removed later if OpenCL code had been programming to the startup
configuration flash of DE5a-Net by „aocl flash ‟ command.
Figure 2-7 Setup DE5a-Net board on PC

DE5a-Net OpenCL
www.terasic.com
March 29, 2017
12
2
2. .5 5 O Op pe en nC CL L E En nv vi ir ro on nm me en nt t V Ve er ri if fy y a an nd d F Fl la as sh h C Cv vP P
This section will show how to make sure the OpenCL environment is setup correctly. Firstly, please
open Command Prompt windows by click Windows Start button, clicking All Programs, clicking
Accessories, and then click Command Prompt.
Target Board
In Command Prompt window, type “aoc --list-boards” command, and make sure “de5a_net_e1” is
listed in Board list as shown in Figure 2-8.
Figure 2-8 „de5a_net_e1‟ is listed in Board list
Test „aocl flash‟ Command
In Command Prompt window, type ”cd C:\intelFPGA_pro\16.1\hld\board\de5a_net_e1\tests\hell
o_world\bin” to go to hello world OpenCL project folder.
Then type “aocl flash aclde5a_net0 hello_world.aocx” to write hello_world.aocx OpenCL image
onto the startup configuration flash of DE5a-Net. Before flash programming, the programmer will
ask users which startup configuration image area will be used as shown in Figure 2-9. This is
because DE5a-Net provides two startup configuration image areas, called as Factory Image and
User Image. We recommend users to key in „1‟ to select User Image area.

DE5a-Net OpenCL
www.terasic.com
March 29, 2017
13
Figure 2-9 Select Flash Page
After users select desired flash area, it will take about 20 minutes for flash programming. Figure
2-10 is the screen shot when flash programming is done successfully.
Figure 2-10 aocl flash aclde5a_net_e10 hello_world.aocx” successfully
To make sure a correct image is used when FPGA boots up, please make sure the dip switch SW3.4
on DE5a-Net is changed to the correct location. If a User Image area is selected, the dip switch
SW3.4 on the DE5a-Net should be moved to Up position as shown in Figure 2-.

DE5a-Net OpenCL
www.terasic.com
March 29, 2017
14
Figure 2-11 Set SW3.4 to Up Position (User Image Page)
After flash programming is done successfully and SW3.4 is set to correct position, developers can
power off PC and DE5a-Net board, then turn it back on.
Test „aocl diagnose‟ Command
The diagnose utility in the Arria 10 DE5a-Net board reports device information and identifies issues.
The diagnose utility first verifies the installation of the kernel driver and returns the overall
information of all the devices installed in a host machine.
In Command Prompt window, type ”aocl diagnose” to check if the initialization completed
successfully. If successful, the programming message displays “DIAGNOSTIC_PASSED” as
shown in Figure 2-12.
Figure 2-12 “aocl diagnose”messages

DE5a-Net OpenCL
www.terasic.com
March 29, 2017
15
Note: For DE5a-Net to negotiate with the host PC at Gen 3 as the link speed, it is strongly
recommended that users set the PCIe speed at Gen 3 in the BIOS on the host PC. If your PC support
PCIe Gen3x8, but it gets incorrect detected information, you can modify the PCIe settings in the
BIOS, and reboot.
Test „aocl program‟ Command
Check whether the hello_world OpenCL image,which is CvP enabled, configures the FPGA
successfully. In Command Prompt window, type ”cd C:\intelFPGA_pro\16.1\hld\board\
de5a_net_e1\tests\hello_world\bin” to go to hello_world\bin project folder, then type “aocl
program aclde5a_net0 hello_world.aocx” to configure the FPGA with hello_world.aocx OpenCL
image. If the programming message displays “Program succeed” as shown in Figure 2-12, it means
the hello_world OpenCL image is programmed into the flash correctly and CvP works well.
Figure 2-12 “aocl program aclde5a_net0 hello_world.aocx” use CvP

DE5a-Net OpenCL
www.terasic.com
March 29, 2017
16
2
2. .6 6 C Co om mp pi il le e a an nd d T Te es st t O Op pe en nC CL L P Pr ro oj je ec ct t
This section will show how to compile and test OpenCL kernel and OpenCL Host Program for the
vector_add project. Developers can use the same procedures to compile and test other OpenCL
examples for DE5a-Net.
Compile OpenCL Kernel
The utility aoc (Altera SDK for OpenCL Kernel Compiler) is used to compile OpenCL ker
nel. In Command Prompt window,type “cd C:\intelFPGA_pro\16.1\hld\board\de5a_net_e1\tests\
vector_add” to go to vector_add project folder, then type “aoc device\vector_add.cl -o bin\
vector_add.aocx --board de5a_net_e1” to compile the OpenCL kernel. It will take about o
ne hour for compiling. When the compilation process is finished, OpenCL image file vector
_add.aocx is generated. Figure 2-13 is the screenshot when OpenCL kernel is compiled su
ccessfully. For required parameters to compile vector_add.cl, please refer to the README.tx
t that is in the same folder as the vector_add.cl. For detailed usage of aoc, please refer to
the Altera SDK for OpenCL Programming Guide:
https://www.altera.com/en_US/pdfs/literature/hb/opencl-sdk/aocl_programming_guide.pdf
Figure 2-13 “aoc vector_add.cl” OpenCL kernel compile

DE5a-Net OpenCL
www.terasic.com
March 29, 2017
17
Compile Host Program
Visual Studio C/C++ 2012 is used to compile the Host Program. Launch Visual Studio, and select
menu item “FILEOpen Project…”. In the Open Project dialog, go to the folder
“C:\intelFPGA_pro\16.1\hld\board\de5a_net_e1\tests\vector_add”, and select “vector_add.sln” as
shown Figure 2-14.
Figure 2-14 Open vector_add.sln Host Program
After vector_add Host Program project is opened successfully, in Visual Studio IDE select menu
item “BUILDBuild Solution” to build host program. When build is successfully, you will see
successful message as show in Figure 2-15. The execute file is generate in:
“C:\intelFPGA_pro\16.1\hld\board\de5a_net_e1\tests\vector_add\bin\host.exe”
Figure 2-15 Message for vector_add Host Program build successfully

DE5a-Net OpenCL
www.terasic.com
March 29, 2017
18
Test vector_add project
Firstly, use the compiled OpenCL image file vector_add.aocx to configure the FPGA. In Command
Prompt window, type “cd C:\intelFPGA_pro\16.1\hld\board\de5a_net_e1\tests\vector_add\bin” to
go to vector_add\bin project folder, then type “aocl program aclde5a_net0 vector_add.aocx” to
configure FPGA with the OpenCL Image vector_add.aocx. If configuration is successfully, you will
see the successful message as shown in Figure 2-16.
Figure 2-16 “aocl program aclde5a_net0 vector_add.aocx” configured successfully
In Command Prompt window, execute “host.exe”. Figure 2-17 is the screen shot when the test is
successful.
Figure 2-17 “vector_add” test successfully

DE5a-Net OpenCL
www.terasic.com
March 29, 2017
19
Chapter 3
OpenCL for Linux
This chapter describe how to setup DE5a-Net OpenCL development environment on 64-bit Linux
(Red Hat Enterprise Linux 6.5/CentOS 7.0 are recommended), and how to compile and test the
OpenCL examples for DE5a-Net. For more details about Altera OpenCL , please refer to Altera
SDK for OpenCL Getting Started document:
https://www.altera.com/en_US/pdfs/literature/hb/opencl-sdk/aocl_getting_started.pdf
3
3. .1 1 S So of ft tw wa ar re e I In ns st ta al ll la at ti io on n
This section describes how to download and install the required software for OpenCL.
Altera Quartus II and OpenCL
Intel Quartus Prime Pro Edition 16.1 and Intel FPGA SDK for OpenCL 16.1 can be download from
the web site:
http://dl.altera.com/opencl/16.1/?edition=standard
For Quartus II installation, please make sure that the Arria 10 device is included.
open the link and select the Linux SDK as Figure 3-1 shows.

DE5a-Net OpenCL
www.terasic.com
March 29, 2017
20
Figure 3-1 Linux SDK table
In the software download selection form, choose Software and devices as Figure 3-2 show.
Figure 3-2 software and devices download
Quartus II software uses the built-in USB-Blaster II drivers on Linux to access USB-Blaster II
download cable on DE5a-Net. but after installed the Quartus II software with built-in drivers, User
need to change the port permission for USB-Blaster II via issuing