CAPI-PSLSE 在linux环境下的编译

怎么使用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了。