FPGA云服务器 f3实例RTL开发最佳实践

操作步骤

1. 远程连接Linux实例。
   说明 编译工程时需要2~3小时。建议您使用nohup或者VNC连接实例，以免编译时意外退出。

2. 下载并解压RTL参考设计。
3. 配置环境。
   • 如果驱动为xdma，需要运行以下命令来配置环境。

     source /root/xbinst_oem/F3_env_setup.sh xdma #每打开一个终端窗口就需要执行该命令一次  

   • 如果驱动为xocl，则需要运行以下命令来配置环境。

     source /root/xbinst_oem/F3_env_setup.sh xocl #每打开一个终端窗口就需要执行该命令一次

   说明 配置环境主要包括安装xdma驱动或xocl驱动，设置vivado环境变量，检查vivado license，检测aliyun-f3 sdaccel平台，2018.2 runtime配置和faascmd版本检测 。

4. 指定OSS存储空间。

   faascmd config --id=<hereIsYourSecretId> --key=<hereIsYourSecretKey> #将<hereIsYourSecretId>和<hereIsYourSecretKey>替换为您的RAM用户AK信息
   faascmd auth --bucket=hereIsYourBucket # 将<hereIsYourBucket>替换为您创建的OSS Bucket名称                        

5. 运行以下命令编译RTL工程。

   cd <您之前解压的路径>/hw/ # 进入解压后的hw路径
   sh compiling.sh               

   说明 编译工程需要2~3小时。

6. 上传网表文件，并下载FPGA镜像。您可以采用脚本化流程或者单步操作流程完成该步骤。
   • 脚本化流程：仅适用于配备单块FPGA卡的f3实例。
     1. 运行以下命令上传并生成镜像文件。

        sh /root/xbinst_oem/tool/faas_upload_and_create_image.sh <需要上传的压缩包文件名>

        

     2. 下载镜像文件。

        sh /root/xbinst_oem/tool/faas_download_image.sh <压缩包的文件名> <0/1> # 最后的数字<0/1>为实例中fpga的序号

        0为FaaS实例中的第一个FPGA，单芯片实例序号一律为0，对多芯片实例，例如4芯片的序号为0，1，2，3。

        如果需要对多个FPGA下载同一个镜像，可以在命令的末尾添加相应的序号。例如，对4芯片FPGA下载同一镜像的命令为：

        sh /root/xbinst_oem/tool/faas_download_image.sh <压缩包的文件名> 0
        sh /root/xbinst_oem/tool/faas_download_image.sh <压缩包的文件名> 1
        sh /root/xbinst_oem/tool/faas_download_image.sh <压缩包的文件名> 2
        sh /root/xbinst_oem/tool/faas_download_image.sh <压缩包的文件名> 3

   • 单步操作流程：使用faascmd工具进行操作。具体操作，请参见使用faascmd。
     1. 依次运行以下命令，将压缩包上传到您个人的OSS Bucket，再将存放在您个人OSS Bucket中的gbs上传到FaaS管理单元的OSS Bucket中。

        faascmd upload_object --object=bit.tar.gz --file=bit.tar.gz
        faascmd create_image --object=bit.tar.gz --fpgatype=xilinx --name=<hereIsFPGAImageName> --tags=<hereIsFPGAImageTag> --encrypted=false --shell=<hereIsShellVersionOfFPGA>                      

        

     2. 运行命令查看FPGA镜像是否处于可下载状态。

        faascmd list_images

        在返回结果中：

        • 如果"State"为compiling，表示FPGA镜像处于编译状态，您需要继续等待。
        • 如果"State"为success，表示FPGA镜像已经可以下载。您需要找到并记录FpgaImageUUID。

        

     3. 运行以下命令。在命令返回结果中，您需要找到并记录FpgaUUID。

        faascmd list_instances --instanceId=<hereIsYourInstanceId> # 将<hereIsYourInstanceId>替换为f3实例ID

     4. 运行以下命令下载FPGA镜像。

        # 将<hereIsYourInstanceId>替换为f3的实例ID，<hereIsFpgaUUID>替换为您获取的FpgaUUID，<hereIsImageUUID>替换为您获取的FpgaImageUUID
        faascmd download_image --instanceId=<hereIsYourInstanceId> --fpgauuid=<hereIsFpgaUUID> --fpgatype=xilinx --imageuuid=<hereIsImageUUID> --imagetype=afu --shell=<hereIsShellVersionOfFpga>

        

     5. 运行以下命令查看镜像是否下载成功。

        # 将<hereIsFpgaUUID>替换为您获取的FpgaUUID，<hereIsYourInstanceId>替换为f3实例ID。
        faascmd fpga_status --fpgauuid=<hereIsFpgaUUID> --instanceId=<hereIsYourInstanceId> 

        以下为返回结果示例。如果显示的FpgaImageUUID与您获取的FpgaImageUUID一致，并且显示"TaskStatus":"valid"，说明镜像下载成功。

        

FAQ

问题一：上传镜像时出现异常，如何查看异常详情？

问题二：如何重新加载镜像？

您可以参考以下步骤重新加载镜像：

1. 卸载驱动。
   • 如果您安装了xdma驱动，则需要在实例中运行sudo rmmod xdma命令卸载驱动。
   • 如果您安装了xocl驱动，则需要在实例中运行sudo rmmod xocl命令卸载驱动。
2. 下载镜像。
   您可以使用以下两种方式之一：

   • 使用脚本：

     sh faas_download_image.sh bit.tar.gz <0/1> #最后的数字为实例中FPGA的序号

   • 使用faascmd：

     faascmd download_image --instanceId=hereIsYourInstanceId --fpgauuid=hereIsFpgaUUID --fpgatype=xilinx --imageuuid=hereIsImageUUID --imagetype=afu --shell=hereIsShellVersionOfFpga

3. 安装驱动。
   • 如果您需要安装xdma驱动，请运行以下命令。

     sudo depmod
     sudo modprobe xdma

   • 如果您需要安装xocl驱动，请运行以下命令。

     sudo depmod 
     sudo modprobe xocl