Vitis 运行和调试配置设置 - 2022.1 简体中文

启动已编译、已链接和已封装的应用后，要在 Vitis IDE 中运行或调试，需使用Launch Configuration（启动配置）对话框，如下图所示。构建流程完成后，该工具会在Assistant（助手）中视图启用Run（运行）按钮和Debug（调试）按钮，以便您指定要使用的“Launch Configuration”（启动配置）。

要编辑启动配置的设置，请选中构建目标，然后单击Run（运行）按钮以打开Run Configurations（运行配置）对话框。Run Configuration对话框（如下所示）支持您指定调试选项、对运行中的应用启用剖析并指定要收集的剖析数据的类型。

Name

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

Project

显示当前工程，但可更改为其它打开的工程。

Build Configuration

选择启动配置适用于的构建目标，或者它适用于处于活动状态的构建配置。

Disable Build Before Launch

启用此复选框后，可避免该工具在运行或调试工程前对其进行重构。

Target

指定配置的运行或调试目标。请注意，仿真 (emulation) 构建目标为 Linux TCF 代理，而硬件构建则需要 hw_server，如 调试应用与内核 中所述。

远程工作目录

对于嵌入式处理器系统，请指定 QEMU 环境的安装盘，或者指定物理器件的安装盘。

Program Arguments

显示“Programs Argument”（程序实参）对话框。此对话框允许您按需为应用指定命令行实参。启用Automatically update arguments（自动更新实参）复选框即可允许该工具自动指定 xclbin 文件作为该应用的实参。xclbin 文件将被追加到命令行末尾，位于任何其它已指定的实参之后。

注释： 程序实参应根据与运行期间创建的运行配置文件夹的相对关系来指定。您可参考 IDE 中的 Vitis log 日志窗口，以复查用于启动此应用的命令行副本。

Override Application Options

为 launch_emulator.py 命令创建选项文件，您可手动编辑此文件以根据自己的需求进行自定义。单击Generate（生成）按钮创建新的 launch_options.cfg 文件，或者使用Browse（浏览）按钮找到现有文件。

Xilinx Runtime Profiling

指定应用运行期间启用的剖析和事件追踪功能。指定的选项存储在配置文件中，并写入 xrt.ini 文件以供在运行应用期间使用。单击Edit（编辑）按钮打开Xilinx Runtime Profiling（赛灵思运行时剖析）对话框，如下所示。

Host Trace

指定要为应用运行启用的主机剖析类型。默认启用Host trace（主机追踪）选项，但可通过添加一个或多个其它选项来覆盖此设置，如 在应用中启用剖析 中所述。

提示： 对于硬件构建，您还可为加速器卡启用Power profiling（功耗剖析）或Device Counters（器件计数器）。

Device Trace

指定在硬件内核上执行的剖析级别。该选项与 device_trace 相关，如 xrt.ini 文件 中所述。粗糙的器件剖析可显示 CU 的数据传输活动。精细的器件剖析显示的是端口上的所有 AXI 级别的传输事务。

Collect Stall Trace

表示各种条件下捕获的停滞数据，如 --profile 选项 和 xrt.ini 文件 中所述。

Device Trace Offload

指定分配用于捕获追踪数据的全局存储器的量，并支持按指定时间间隔进行连续追踪卸载，以防止在中断进程中损失“Timeline Trace”（时间线轨迹）数据，如 在应用中启用剖析 中所述。

Launch Configuration（启动配置）对话框还包含其它有助于为应用配置运行时环境的选项卡。包括以下 3 个选项卡：

Target Setup

主要用于含裸机应用的嵌入式平台。它提供了用于对开发板、器件和程序进行初始化、管理和复位的选项。

Environment

支持您设置和管理 Vitis IDE 所需的环境变量。

Common

该选项卡派生自 Eclipse。这些是与 Eclipse 环境通用的设置和功能特性。