Intel altera opencl 入门

FPGA技术江湖

   今天给大侠带来Intel altera opencl 入门，话不多说，上货。

概述

: t9 B/ Y2 f; M2 ?( d1 x+ o- c5 \' U: g

, c/ l# B. e( D       Intel altera 的 OpenCL 主要面向信号处理类应用的客户，是用C语言开发FPGA的利器，开放计算语言(OpenCL)联盟著名的公司有 FPGA巨头Intel altera、两大显卡GPU巨头AMD和英伟达、CPU巨头Intel、软件和服务器巨头IBM以及全世界最大的公司Apple（苹果）等等。不过AMD和英伟达是用GPU实现的OpenCL并行运算，Intel altera是用FPGA实现并行运算。




8 K  ~1 m5 Y, t" u, b4 W% j$ ?1. 系统要求
2 d& D0 Y8 J; ]) a& @9 r$ VMicrosoft 64-bit Windows 7专业版或者更高。
, ?; o* R6 V" F  |1 _" T5 H对于Windows操作系统, 要安装微软公司的Visual Studio 2010或者2012专业版（推荐）。


   或者：
- \6 d5 ?; J( C: ?

Red Hat Enterprise 64-bit Linux (RHEL) 5或者6。
对于Linux操作系统, 安装操作系统过程中要把C编译器包括GCC勾选上。
: h' ]. L. T9 m0 J/ j7 ]. \( ], }
: o" l2 a9 T5 }
2.安装Altera的软件和搭建OpenCL环境（以Windows为例，Linux也类似）：

安装Quartus II 13.1  Update4（或者14.0）•安装Altera OpenCL 13.1 Update4（AOCLSetup-13.1.4.182.exe）（或者14.0）

7 U# f/ q, h+ L$ M! }2 }  `, z
设置环境变量（基于默认的安装路径）：
* n7 M, c, ], U0 z. s, a; H
. w% Z! E/ Q9 Q+ `: k5 I7 V! h变量和值如下：ALTERAOCLSDKROOT和C:\altera\13.1\hld（或者C:\altera\14.0\hld）
* F" N. a9 _1 r% Y/ p& Z& rPATH和C:\altera\13.1\hld\windows64\bin（或者C:\altera\14.0\hld\bin;C:\altera\14.0\hld\host\windows64\bin）
LM_LICENSE_FILE和c:\altera\license.dat
5 C' N0 {) T4 t2 k3 C0 l9 ^
% A1 g+ i3 }- W! C: [6 c6 K参考下图：

' P$ J& ~  W5 a! l* Z# F




. ^% W' R( T) T& f7 j; }# Q

4 h# j5 @+ M! ~% m
+ r$ J  n5 q  H% R/ G/ B: _       然后在命令行里面运行where aoc，测试一下软件是否安装正确以及环境变量是否设置正确，如果正确，如下图；如果不正确，修改错误再来。
5 A7 H! @0 E# }! Y) E

) g5 y8 m. m, y0 b, o
6 W8 |& }! p8 A& X' p
或者（14.0）

2 Y8 L9 Q; Y/ R

+ q6 |& n* _& V1 ]" C- F. R" v

, b: H# z# e" G9 c* h& M' }3.开发板环境的安装和测试（以台湾友晶的DE5-Net开发板为例，不过没有开发板也可以，开发板不是必需的）：
  y3 w  e; b0 G) {0 x6 ]# i
1). 准备工作：下载DE5-Net开发板的全套软件安装包，http://www.terasic.com/downloads ... 5NET_openCL_BSP.zip  136MB，把里面的terasic文件夹解压缩到C:\altera\13.1\hld\board\下。
6 P' F" l) f# y2 d. y- G
, u' N: e! o. b+ U1 L设置DE5-Net开发板的环境变量：
; a# D% v, H% u8 N2 b* C( R) p
变量和值如下：
* O' D4 N6 U; S7 m5 Q  s. X8 dAOCL_BOARD_PACKAGE_ROOT和C:\altera\13.1\hld\board\terasic\de5net参考下图：


: d( Y$ a; U4 \* p* g- e( m

然后在命令行里面运行aocl install来安装开发板驱动。

关闭你的PC，安装和连接开发板硬件后，重新开机，在命令行里面运行aoc --list-boards，如果硬件安装连接成功，会显示开发板名字de5net_a7，如果开发板不存在，显示none found。
6 v* o4 E; w% ]$ p2 f5 @$ n
7 R1 E# W/ K! P! P. i9 n1 A) Z2). 测试开发板：

* d, Q3 j2 T* N4 m在命令行里面运行 cd C:\altera\13.1\hld\board\terasic\tests\blank，运行aocl program blank.aocx，如果开发板已经安装连接好，aocx里面的sof文件会通过PCI-E接口下载，并且会返回成功的信息，如果开发板不存在或者没有安装连接好，会自动解压缩出reprogram_temp.sof，用户可以通过USB下载电缆去下载。
2 f5 t4 l$ N% _0 a! p
备注：没有开发板的客户可以在设置环境变量后跳过后面的步骤，继续。
- g3 ~- L" M8 p: W
9 b: c( m# c# \* _" }
4.编译和测试OpenCL工程：
5 T+ n* _' M. ^7 J
1 B8 t2 Z; v# d2 Y9 E0 w: W0 e
1). 编译OpenCL工程：在命令行里面运行cd C:\altera\13.1\hld\board\terasic\tests\boardtest进入工程文件夹，运行aoc boardtest.cl --sw-dimm-partition开始编译，编译时间大约1个小时，最终产生的boardtest.aocx里面包含了sof文件，可以给开发板编程进去。

2). 测试OpenCL工程（通过开发板）：
9 w( r4 ]& V, [% w% y9 @) f
在命令行里面运行 cd C:\altera\13.1\hld\board\terasic\tests\blank，运行aocl program boardtest.aocx，如果开发板已经安装连接好，aocx里面的sof文件会通过PCI-E接口下载，并且会返回成功的信息，如果开发板不存在或者没有安装连接好，会自动解压缩出reprogram_temp.sof，用户可以通过USB下载电缆去下载。

提示：没有开发板的客户可以跳过上面的步骤，直接编译下面不需要开发板的例子，有开发板的客户可以直接到第五步：
$ F; E6 F/ y7 ?7 Q( h+ i

下面完全脱离真实的开发板来运行Cytech_C5SOC.zip：

9 C, x7 e8 ]: x- Y& y0 v$ k( c
  ^+ k% h; \9 m+ z; W  @

设置“虚拟”板的环境变量（替换原来的环境变量）：

1 n8 N1 o4 [2 Y  {; f* ?8 \. |变量和值如下：
" b/ v9 _. @% @# l: [
AOCL_BOARD_PACKAGE_ROOT和 C:\altera\13.1\hld\board\Cytech_C5SOC
参考下图：



: a6 ~9 @8 h. S0 P! L* |


' W1 \7 I) o: B       解压缩Cytech_C5SOC.zip里面的内容到C:\altera\13.1\hld\board\（也可以是其它文件夹），把例子exm_opencl_hello_world_windows64.zip里面的hello_world.cl也复制到这个文件夹下，在命令行里面运行cd C:\altera\13.1\hld\board\，运行aoc hello_world.cl开始编译。----因为Cyclone V SOC的5CSXFC6容量比Stratix V的5SGSMD5小几倍，所以编译时间只有20分钟左右，最终产生的hello_world.aocx里面包含了sof文件，同时也产生了转换后的.V源码和整个编译后的Quartus II完整工程，包括大量的底层配套的各种IP源码。
- U/ O" B  X4 p+ w

6 r7 j% F/ O6 k1 q( {" P, x再演示3个不同的例子，分别是vector_add、matrix_mult和FFT，也是完全脱离真实的开发板来运行：
# v* h, E! F/ C; {0 T; o2 g
& H* E+ K2 n$ w8 w  }7 E5 d
" A3 W; J$ w6 ^( P6 Q3 ]; K
# }% }) }) I5 {1 Y6 x0 V) v不改变上面“虚拟”板的环境变量，目的是继续使用Cyclone V SOC的5CSXFC6，可以产生为这个系列优化的源码。
! P4 d, ~) P( j6 E
7 l; Y  @" v2 b
/ a! B% k' e8 G& O( ^8 x- [分别解压缩3个zip例子到C:\altera\13.1\hld\board\（也可以是其它目录），然后分别在在命令行里面：
0 F/ W, t1 S6 I! U! L: o; U
1.运行cd C:\altera\13.1\hld\board\vector_add\device，然后运行aoc vectorAdd.cl开始编译。
' |/ G$ h5 ~# V) _0 `- a  m2.运行cd C:\altera\13.1\hld\board\matrix_mult\device，然后运行aoc matrix_mult.cl开始编译。
' E5 g9 G" y7 w" a- r2 d2 L8 i8 x3.运行cd C:\altera\13.1\hld\board\fft1d\device，然后运行aoc fft1d.cl开始编译。

3个例子之间没有任何联系，可以单独运行，如果你的PC内存足够大，可以一起运行。
3 w( ^3 g& o+ a$ r2 X
: K5 {9 W; q, a+ ]8 u* A1 p. A       在产生的不同Quartus II工程中，可以找到matrix_mult.v、vectorAdd.v和fft1d.v这些转换出的源码。特别注意的是，这些最终的源码是acl_kernel_inteRFace接口，这种接口比较简单，和FIFO差不多，只不过多了几个启动结束控制线,如start，valid等等。

3 d( ^$ c4 o* l7 j4 n$ z备注：大家可以把这些源码复制到自己的工程中和自己写的其它逻辑模块连接起来即可。如果想产生基于Stratix V器件优化的源码，可以在环境变量的路径中把台湾友晶的DE5-Net开发板作为虚拟板（也就是恢复第三步的环境变量），然后编译cl文件即可。
  O% {- c! E/ S. E

$ `' @$ O  ]! h3 d/ s# ]( I8 a
+ U( x! Q; L; W$ y0 I5.编译Host程序：

       启动Visual Studio 2012，点击“文件打开项目”，选择C:\altera\13.1\hld\board\terasic\tests\boardtest\host\boardtest.sln（或者直接在硬盘上双击这个sln文件，VS 2012会自动完成上述步骤），然后点击“生成生成解决方案”，最后在……\host\x64\Release\下产生了boardtest.exe，不过这个exe不能运行，因为缺少几个dll文件，把C:\altera\13.1\hld\windows64\bin\下的所有的6个dll文件复制过来，和这个exe放在同一个文件夹下就可以运行了。
' e& w! m; X- ^3 n

备注：没有开发板的客户可以跳过上面这个步骤。

/ E$ T$ g8 ?0 y* L2 Y8 L
+ v! ]/ X/ W* A0 L9 Z8 L. W6.查看结果：
1 |5 T6 V! a3 t+ x$ ?0 ]/ s3 F! ]

       把第四步产生的aocx文件下载到开发板，成功后会返回信息，然后运行第五步产生的exe即可在PC屏幕上看到开发板返回的最终结果。
# p) F( O. N- }/ u3 S0 V
0 H" P) s1 @3 s; g$ ^, D* \2 t; `
% y" l4 @& i) |+ n0 O2 c4 R% x备注：没有开发板的客户可以跳过上面这个步骤。
  M/ s; \3 ^3 @7 \+ q- j8 X没有开发板的客户只需要走1、2、4步即可。
. F) Q( m: \$ |& [参考资料、例子和其它：

& m! p$ }, _8 M) _: e5 i0 p
1.参考资料：http://www.altera.com.cn/product ... l/opencl-index.html
/ k5 z( ^  V( n6 K% N网页最下面3个入门文档：
面向OpenCL的Altera SDK开始设计：aocl_getting_started.pdf
" s; Q4 l. S& {! z% `2 h; @面向OpenCL的Altera SDK编程指南：aocl_programming_guide.pdf
% ?5 K0 n( |- s6 m$ P0 D0 c# P& m; h面向OpenCL的Altera SDK优化指南：aocl_optimization_guide.pdf
其中13.1版本对应的aocl_getting_started.pdf第8页是错的，PATH应该是C:\altera\13.1\hld\windows64\bin，14.0里面改正了。
  i8 v3 p: V; |$ o2 Q- L
6 E" `: A/ k) x$ `7 P- ^" Q! j
2.Altera目前有13个OpenCL的例子在http://www.altera.com.cn/support/examples/opencl/opencl.html  里面，上面第4步用到的exm_opencl_hello_world_windows64.zip例子就来自于这个网页。
* S- w  u7 j/ h
! C4 l/ u  G& S. N" Y4 b
3.Cl文件是OpenCL的源码文件，aocx是cl文件编译后的编程文件，里面包括sof文件。PC机那边的Host软件不是必需的，做host软件仅仅是为了和开发板通信来获取开发板运行openCL的信息。没有开发板的用户只要写一个cl文件然后自己建立一个Quartus II工程就可以编译了，最后产生了转换后的.V源码和整个编译后的Quartus II完整工程，包括大量的底层配套的各种IP源码。

' M% _7 E4 Q8 b" L9 T4.因为事先设置了环境变量的缘故，所以cl文件放到任何路径下都可以编译，编译后会在cl文件所在的文件夹里面产生完整的Quartus II整个工程，里面就有转换后的.v文件。

1 W/ _+ K7 I% f) W- t