仿真运行 - 阿里云FaaS F2使用教程

直接运行

export XCL_EMULATION_MODE=true #一定要设置这个环境变量，不然会报错，找不到设备
./vadd bin_vadd_cpu_emu.xclbin
#如果报如下错：Error: Unable to find Target Device xilinx_kcu1500_4ddr-xpr_4_0；请检查XCL_EMULATION_MODE是否为true，如果没有，请设置：export XCL_EMULATION_MODE=true

硬件仿真

make -f sdaccel.mk cleanall
make -f sdaccel.mk run_hw_em

看仿真结果是否PASSED

直接运行

export XCL_EMULATION_MODE=true #一定要设置这个环境变量，不然会报错，找不到设备
./vadd bin_vadd_cpu_emu.xclbin
#如果报如下错：Error: Unable to find Target Device xilinx_kcu1500_4ddr-xpr_4_0；请检查XCL_EMULATION_MODE是否为true，如果没有，请设置：export XCL_EMULATION_MODE=true

编译

make -f sdaccel.mk cleanall
make -f sdaccel.mk xbin_hw

//其他一些操作
/*
make -f sdaccel.mk xbin_hw #生成最终的二进制文件，时间比较长，差不多4个小时才能完成
make -f ./sdaccel.mk help #查看帮助文档
#Compile and run CPU emulation using default xilinx:adm-pcie-7v3:1ddr:3.0 DSA
make -f sdaccel.mk run_cpu_em //即：软件仿真
#Compile and run hardware emulation using default xilinx:adm-pcie-7v3:1ddr:3.0 DSA
make -f sdaccel.mk run_hw_em //硬件仿真
#Compile host executable only
make -f sdaccel.mk host //只编译host代码
#Compile XCLBIN file for system run only
make -f sdaccel.mk xbin_hw //这个最重要，编译生成可以下载到FPGA内的二进制文件
#Clean working diretory
#make -f sdaccel.mk clean
#Super clean working directory
#make -f sdaccel.mk cleanall
*/

ps:此处编译的时间会比较久，建议通过screen或者nohub等方式，防止ssh timeout退出。

3. 配置安全烧写环境

source /root/xbinst_oem/F2_env_setup.sh
faascmd config --id= --key= ＃id/key为阿里云accessID/accessKey，上述新建子帐号曾经保存过

faascmd auth --bucket= #新建的OSS bucket 名字

4. 编译成功后打包结

#如果/root/xbinst_oem/目录里没有sdaccel_package.sh，先下载：wget
/root/xbinst_oem/sdaccel_package.sh -xclbin=/opt/Xilinx/SDx/2017.2/examples/vadd/bin_vadd_cpu_emu.xclbin

5. 上传压缩包到自己的OSS指定的bucket

faascmd upload_object --object=<在bucket中名字，建议和file一致> --file=<打包生成的结果，一个tar包>

6. 新建一个可以在F2上运行的FPGA image

faascmd create_image --object=<在bucket中名字，建议和file一致> --fpgatype=xilinx --name=hereIsFPGAImageName --tags=hereIsFPGAImageTag --encrypted=false --shell=V1.0

7. 查看fpga image是否已经可以下载

我们看到状态已经是success，可以下载了。记下FPGAIamgeUUID，一会下载的时候需要用

下载

如何编译和仿真是在另外一台ECS上完成的，这里首先要购买一台F2实例；具体的购买过程参考**购买**章节

1. 首先配置安全烧写环境(如果之前已经设置过，跳过)
source /root/xbinst_oem/F2_env_setup.sh

faascmd config --id= --key= ＃id/key为阿里云accessID/accessKey，上述新建子帐号曾经保存过

faascmd auth --bucket= #新建的OSS bucket 名字

2. 获取fpgauuid
faascmd list_instances --instanceId=hereIsYourInstanceId
vm instance Id:可以在阿里云控制台找到

3. 下载fpga image
faascmd download_image --instanceId=hereIsYourInstanceId --fpgauuid=hereIsFpgaUUID --fpgatype=xilinx --imageuuid=hereIsImageUUID --imagetype=afu --shell=V1.0

4. 查看是否下载成功
faascmd fpga_status --fpgauuid=hereIsFpgaUUID --instanceId=hereIsYourInstanceId

板卡上的FpgaImageUUID已经跟需要下载的image一致，并且TaskStatus已经valid，说明下载已经成功。

5.跑host程序

make -f sdaccel.mk host
unset XILINX_SDX
./vadd bin_vadd_hw.xclbin