构建系统 - 2022.1 简体中文

Vitis 统一软件平台文档 应用加速开发 (UG1393)

Document ID
UG1393
Release Date
2022-05-25
Version
2022.1 简体中文

构建系统时,最好使用 构建目标 中所述的 3 个可用构建目标。在Assistant(助手)视图中,每个构建目标都呈现为一个独立的构建配置。请按下列顺序处理这些构建配置:

Emulation-SW
针对软件仿真 (sw_emu) 进行构建,以确认主机程序与内核代码的算法功能能够协同工作。
Emulation-HW
针对硬件仿真 (hw_emu) 进行构建,以将内核编译为硬件描述语言 (HDL)、确认生成的逻辑正确与否,并评估其仿真性能。
Hardware
执行系统硬件构建 (hw) 以实现在目标平台上运行的应用。

在启动构建命令前,请配置每个构建配置,以确保它满足您的需求。选中特定构建配置,单击Settings(设置)按钮打开Build Configuration Settings(构建配置设置)对话框。如需了解有关使用此对话框的更多信息,请参阅 Vitis 构建配置设置

除构建配置设置外,在通过Vitis Hardware Function Settings(Vitis 硬件函数设置)对话框访问的“Hardware Function”(硬件函数)中,包含了将影响应用的诸多设置。建议最好复查每个Settings(设置)对话框,如 配置 Vitis IDE 中所述。

在“Assistant”视图中,您可利用指定构建配置的各选项来启动构建进程,具体方法是选中构建配置,然后单击Build(构建)() 按钮。Vitis 核开发套件使用两部分组成的构建进程,通过 Vitis™ 编译器 v++ 命令,为硬件内核生成 FPGA 二进制文件 (.xclbin),并使用 g++ 编译器来编译和链接主机程序代码。

提示:Vitis IDE 的右下角,将显示进行中的构建的状态,如下图中的左侧所示。如果单击状态旁边的按钮,则会打开“Progress”(进度)视图,如右侧所示。您可通过单击构建步骤旁边的红色方块来取消构建,如下图中所示。
图 1. 取消构建

构建进程完成后,“Assistant”视图会显示特定构建配置,此配置包含绿色复选标记,用于表示它已成功完成构建,如下图所示。您可以打开任一构建报告,例如,“Hardware Function”中的“Compile Summary”(编译汇总)报告,或二进制容器中的“Link Summary”(链接汇总)报告。右键单击Assistant视图中的报告,然后选择Open in Vitis Analyzer(在 Vitis 分析器中打开)。

图 2. 助手视图 - 成功构建

构建完成后,您即可在特定构建配置所提供的环境内运行应用。例如,在 Emulation-SW 构建中实践主机程序与 FPGA 二进制文件协同工作的 C 语言模型,或者在 Emulation-HW 构建的仿真中复查主机程序和 RTL 内核代码,或者在 Hardware 构建中于目标平台上运行应用。

要在 Vitis IDE 内运行应用,请选中构建配置,然后单击Run(运行)按钮 () 以启动默认运行配置。您也可以右键单击构建配置并使用Run菜单来选择特定运行配置,或者按 Vitis 运行和调试配置设置 中所述方式编辑运行配置。

提示: Vitis IDE 会创建一个文件夹,此文件夹根据当前运行的特定构建配置中的运行配置来命名。例如,./project/Emulation-HW/run_config。应用运行的输出文件和 log 日志将写入此文件夹。传递到主机程序的所有实参都应按与该文件夹的相对关系来写入。