仅对英特尔可见 — GUID： ewa1421439650367
Ixiasoft
3.5. 安装FPGA板级
在Linux上为FPGA板级创建OpenCL™应用程序之前，您必须首先下载并安装Intel Reference Platform或者板级供应商提供的Custom Platform。大多数Custom Platform安装程序需要管理员权限。请访问FPGA Software Download Center网站来下载Intel Reference Platform。 要将板级安装到Linux主机系统中，请调用install工具命令。
以下步骤概述了板级的安装过程。某些Custom Platform需要额外的安装任务。有关板级安装的更多信息，请参考板级供应商提供的文档。
- 按照板级供应商的说明将FPGA板级连接到系统。
- 从板级供应商的网站上下载FPGA板级的Custom Platform。
注： 从20.3版本开始，Linux OpenCL BSP的支持将不再继续。请使用FPGA Software Download Center上的20.2或更早版本的OpenCL BSP作为参考。如果您想移植OpenCL BSP到更新的版本，那么请按照Intel FPGA SDK for OpenCL documentation下的Reference Platform Porting Guides中提供的建议步骤进行操作。
- 在您拥有的目录(即，不是系统目录)中安装Custom Platform。
您可以在同一系统上同时安装多个Custom Platform。使用RTE工具(例如aocl diagnose)和多个Custom Platform。Custom Platform子目录包含board_env.xml文件。
在一个具有多个Custom Platform的系统中，要确保主机程序使用FPGA Client Drivers (FCD)来发现板级，而不是直接链接到Custom Platform的存储器映射器件(MMD)库。如果FCD对于Custom Platform进行了正确地设置，那么FCD在运行时会找到所有已安装的板级。
- 设置QUARTUS_ROOTDIR_OVERRIDE用户环境变量以指向 Intel® Quartus® Prime Pro Edition软件的安装目录。打开一个shell，然后在命令提示符处输入echo $QUARTUS_ROOTDIR_OVERRIDE。
- 将Custom Platform库的路径(例如，MMD库的路径类似于<path_to_customplatform>/linux64/lib)添加到LD_LIBRARY_PATH环境变量设置中。
关于设置Linux用户环境变量和运行init_opencl脚本的信息，请参考设置 Intel® FPGA SDK for OpenCL™ Pro Edition用户环境变量部分。
- 在命令提示符处调用命令 aocl install <path_to_customplatform> 。
切记： 您需要sudo或root权限才能安装板级。
调用 aocl install <path_to_customplatform> 将安装FCD和一个板级驱动程序， 此板级驱动程序支持主机应用程序和硬件内核程序之间进行通信。
如果系统已经安装了驱动程序，并且您需要在没有root权限的情况下安装FCD，那么您可以执行以下操作：
- 导出 ACL_BOARD_VENDOR_PATH=<path_to_install_fcd> 环境变量以指定FCD的安装目录(而不是默认位置)。
注： 如果您设置ACL_BOARD_VENDOR_PATH环境变量，那么每次通过source init_opencl.sh文件进入OpenCL开发环境之后都要设置此环境变量。
- 调用带有标志 -fcd-only的aocl install命令(如下所示)，并按照提示进行FCD的安装：
aocl install <path_to_customplatform> -fcd-only
- 导出 ACL_BOARD_VENDOR_PATH=<path_to_install_fcd> 环境变量以指定FCD的安装目录(而不是默认位置)。
- 通过调用 aocl diagnose 命令查询安装在机器中的FPGA器件列表。
此软件生成一个包含<device_name>的输出，这是一个acl编号，范围从acl0到acl127。
注意： 关于调用aocl diagnose工具后可能出现的错误，请参考Possible Errors After Running the diagnose Utility部分。关于查询加速器板级的<device_name>的详细信息，请参考Querying the Device Name of Your FPGA Board部分。 - 通过调用命令 aocl diagnose <device_name> 来运行板级供应商建议的诊断测试以验证FPGA板级的成功安装。