怎么使用CAPI
我也是刚刚使用CAPI ,这个是ibm 推出的一个加速框架,示例还没有完全的做完,先把做的东西记下来,等到完全完事的时候在详细整理。 我使用的是ubuntu 16.04 LTS 系统。
- 在Ubuntu上安装Xilinx Vivado 软件
- 我在安装的时候,使用的是在线安装,但是下载一部分的时候出现了错误,后来只是安装Vivado ,其他的选项没有选。也可以尝试一下下载全版本的安装包,不使用在线安装。至于在线版本的安装的方法我在之前的博客已经写了。我安装的版本是Vivado 2016.2
- 在Linux系统上对CAPI进行编译
- 首先在命令行下运行
git clone https://github.com/ibm-capi/pslse
这个命令是在github上下载pslse repo. - 命令行下执行,bulid the afu driver
- 首先在命令行下运行
cd pslse/afu_driver/src/
export VPI_USER_H_DIR="/home/lemon/Downloads/Vivado/2016.2/data/xsim/include"
BIT32=y make
这里边需要说明是,VPI_USER_H_DIR是个环境变量,其后的目录是安装VIvado的目录,BIT32=y 这个是对于32位的程序需要的,要是Vivado是64位不需要这个,直接make就行。在make之前,首先应该确定一下电脑是不是支持i386,有些依赖包可能是不存在的,可以使用 sudo apt-get -f install
,这个命令是可以将依赖的包安装。
- bulid pslse 本身
cd ../../pslse make
- build libcxl from pslse repo
cd ../libcxl make
以上的命令的作用就是创建了一个模仿PSLSE/CAPP的行为和支持它的内核代码的独立可执行文件。
使用Memcpy Demo 来进行示例演示Memcpy Demo 可以在 IBM-developerWorks上下载。
- 使用Vivado创建新的工程
- create new project
- Project type 选择 RTL Project
- 一路next
- 为工程选择板子,点击Boards,我使用的是 KCU105这款开发板。
- 将pslse/afu_driver 目录中的top.v作为工程的顶层文件,然后将memcpy demo中的设计文件全部都添加进入工程中。
- 对于工程进行仿真,但是此时会出现一个问题,就是在top.v文件中的import 导入的函数是SystemVerilog中的函数,但是top.v文件是Verilog类型,所以就不能使用Vivado中的behaviour Simulation 进行仿真,需要tcl console 中使用命令进行仿真。命令如下:
xelab -timescale 1ns/1ps -svlog $TOP/top.v -sv_root $ROOT_DIR -sv_lib libdpi -debug all
这其中需要说明的$TOP是top.v的绝对路径,$ROOT_DIR是libdpi.so的绝对路径,这两个路径可以使用环境变量实现。$TOP就是环境变量。xelab这个命令的具体说明可以参考Xilinx 官方文档 ug900 Logic Simulation。 - 在tcl console中运行完之后,运行
xsmi work.top -gui
,这个命令的用处就是对于xelab产生的snapshot使用xsim进行仿真,其中snapshot的默认名称就是work.top. - 进入到仿真页面之后,执行按钮 run all。
- 在pslse-master/pslse这个目录下面,由于之前已经对于这个目录进行了make,所以可以直接执行./pslse .这就是将pslse启动了。
- 在sample-app这个文件夹下面,其中的app.c是你所要加速的应用代码,其中有两个makefile,一个是Makefile_a,另一个是Makefile_so,这两个文件的差别可以在README中看到。但是我在使用的过程中,Makefile_so文件在进行make的时候是出现问题的,Makefile_a这个是可以使用的,具体的原因我也在进一步的寻找中。在这个目录下面创建一个文件,pslse_server.dat,这个文件中写入
host:16384
,这里需要说明的是,host表示的主机的名称,这个是和你自己电脑的设置有关的,16384这个是端口号,需要看运行pslse时候terminal中显示的进行设置。使用make -f Makefile_a
,然后产生可执行文件app,这样就可以了。但是这个app.c是没有任何功能的,我们要是想要讲memcpy demo那个实现,需要将那个capi_memcpy.c文件copy过来,还需要将Makefile_a中的一些参数进行修改,这里面只需要修改所需make的文件名字就可以了,将app改成capi_memcpy,然后执行。这样就可以实现memcpy demo了。