RedHat 和 CentOS 上的 XRT 和部署平台安装流程

VCK5000 数据中心加速开发套件硬件 安装指南 (UG1531)

Document ID
UG1531
Release Date
2023-07-19
Revision
1.1 简体中文

使用 RPM 安装包,按下列步骤下载并安装 XRT 和部署平台。

如需了解有关安装新版本或旧版本 XRT 和部署平台的详细信息,请参阅 变更 XRT 与目标平台的版本

  1. XRT 安装需要企业级 Linux 附加安装包 (EPEL) 和相关存储库。如果系统上尚未安装 EPEL,请遵循 XRT 安装中提供的步骤完成安装。
  2. 请运行以下命令以安装内核头文件和内核开发包。请确保 uname 前后加反引号 (`) 而不是单引号 (')。
    $ sudo yum install kernel-headers-`uname -r` 
    $ sudo yum install kernel-devel-`uname -r`
  3. 完成前述命令后,请重启机器。
  4. 从专区内下载 Xilinx Runtime (XRT) 安装包和部署目标平台安装包。
    单击显示的安装包名称进行下载。
    重要: 本指南不支持 2022.1 Gen4x8 XDMA Base 2 平台和 2022.2 Gen4x8 QDMA Base 2 平台。对于这些平台,必须按照 VCK5000 Migration Guide 中讨论的两阶段过程移植存储器分区。要成功运行 2022.2 Gen4x8 QDMA Base 2 平台,首先必须将卡移植到 2022.1 Gen4x8 XDMA Base 2 平台,然后再烧写到 2022.2 Gen4x8 QDMA Base 2 平台。
  5. 请在安装包所在目录下运行以下命令来安装 XRT 安装包。<version> 是安装包文件名的后半部分。
    $ sudo yum install ./xrt_<version>.rpm

    这一步将安装 XRT 和必要的依赖项。在整个安装过程中,请根据提示进行操作。

  6. 将部署目标平台 tar.gz 文件解压到单个目录内。目录位置不重要,但此目录不应包含任何其他文件。

  7. 安装部署包。在安装包解压到的目录中,运行以下命令。这将安装所有部署包。
    sudo yum install ./*.rpm
  8. 将平台固件烧写到卡上。按上述步骤所述完成部署安装包的安装后,会显示如下消息:
    Partition package installed successfully.
    Please flash card manually by running below command:
    sudo /opt/xilinx/xrt/bin/xbmgmt program --base --device <bdf> --image xilinx_vck5000_gen3x16_xdma_base_1
    To find <bdf>, run this command:
    sudo /opt/xilinx/xrt/bin/xbmgmt examine
    使用以下命令将平台固件烧写到卡上:
    $ sudo /opt/xilinx/xrt/bin/xbmgmt program --base --device <management BDF> --image xilinx_vck5000_gen3x16_xdma_base_1
    其中 management BDF 即为要进行编程的卡。请参阅 获取卡的 BDF 值 以获取器件的管理 BDF。

    烧写可能需要几分钟时间完成。

    重要: 固件烧写时,请勿在终端上按Ctrl + c,因为这可能导致卡变为不可操作。
    重要: 如果您的系统中安装了多张卡,则必须为每张卡都单独运行以上 xbmgmt program 命令。
    成功完成卡烧写后,将显示如下消息:
    1 device(s) flashed successfully.
    ****************************************************
    Cold reboot machine to load the new image on device(s).
    ****************************************************
    如果该卡是使用当前平台固件完成烧写的,那么将显示如下消息。
    Device(s) up-to-date and do not need to be flashed.
  9. 冷启动您的机器,将新固件镜像加载到 FPGA。
    重要: 请务必先完全切断机器电源,然后再上电。如果仅重启机器,将无法从闪存启动镜像。
  10. 更新卡上的卫星控制器 (SC) 固件。运行以下命令以更新卡上的 SC 固件。此命令与用于将平台固件烧写到卡上的命令完全相同。
    $ sudo /opt/xilinx/xrt/bin/xbmgmt program --base --device <management BDF> --image xilinx_vck5000_gen3x16_xdma_base_1
    其中 management BDF 是需进行 SC 固件更新的卡。请参阅 获取卡的 BDF 值 以获取器件的管理 BDF。

    更新 SC 固件可能需要几分钟时间完成。

    重要: 如果您的系统中安装了多张卡,则必须为每张卡都单独运行以上 xbmgmt program 命令。
    成功完成 SC 固件更新后将显示如下消息,其中提供的器件管理 BDF 将以方括号括起。
    Report
     [0000:af:00.0] : Successfully flashed
    1 device(s) flashed successfully.
    ******************************************************************
    Warm reboot is required to recognize new SC image on the device.
    ******************************************************************
    如果卡已包含当前固件,则将显示如下消息,且无需执行任何额外安装步骤。
    Device(s) up-to-date and do not need to be flashed.
  11. 热重启系统以便 XRT 识别新的 SC 镜像。

部署安装现已完成。卡初始化和确认 提供了用于确认该卡是否已安装成功的步骤。