处理用户管理的流程 - 2023.2 简体中文

该页面描述了使用 Vitis Unified IDE 来构建和运行用户管理的流程或 Makefile 流程的步骤，这些步骤适用于诸如 AI 引擎计算图应用、异构系统工程、数据中心加速或嵌入式软件流程等各种工程。

用户管理流程允许您配置该工具，使用可用命令、Makefile、源文件和配置文件来构建设计组件。Makefile 并非必需，但搭配该流程使用效果更好。您也可以按需指定命令行工具和编译命令。将 Vitis Unified IDE 与用户管理的流程搭配使用即可允许您导入现有工程和报告文件，并在 IDE 上下文中查看。

1. 启动 Vitis Unified IDE 工具，选中Open Workspace（打开工作空间）命令将以工作空间方式打开工程文件夹。工程文件夹可包含 Makefile（非必需）。

   Vitis Components Explorer（组件资源管理器）将报告称工作空间不含任何可识别的组件，并鼓励您创建组件或者切换至用户管理模式以便处理 Makefile 工程。

   
2. 从 Vitis Components Explorer 中选中User Managed Mode（用户管理模式）。

   这样会将 Vitis Components Explorer 视图替换为“Explorer”（资源管理器）视图，以提供工作空间内的文件和文件夹视图（不含增强功能）。

3. 在工作空间文件夹内，右键单击并从弹出菜单中选中Edit Build Configurations（编辑构建配置）命令。

   这样会将 build.json 文件添加到当前工作空间内，并在 IDE 中打开Build Configurations（构建配置）编辑器。

4. 在Build Configurations编辑器中，选中New Build Configuration（新建构建配置）命令或者单击工具栏菜单中的+按钮创建新构建配置。

   这样就会创建新的构建配置。

   • 指定Build config name（构建配置名称）
   • 指定要使用的Build command（构建命令）。构建命令可取自文件夹中的 Makefile。例如：

     make all TARGET=hw_emu PLATFORM=$PLATFORM_REPO_PATHS/xilinx_vck190_base_202320_1

     或者可采用命令行命令：

     v++ -c -t sw_emu --platform xilinx_u250_gen3x16_xdma_4_1_202210_1 --config ../src/u250.cfg -k vadd -I../src ../src/vadd.cpp -o sw_emu/vadd.xo

     提示： 您可选中右侧双头箭头展开Build command（构建命令）字段。这将提供更多空间以供编辑和查看命令文本。
   • 指定Clean command（清除命令）命令，此命令同样取自 Makefile：

     make clean TARGET=hw_emu

     或命令行：

     rm -rf sw_emu

   • 指定将执行构建的Run directory（运行目录）。当前工作目录即默认Run directory。
5. 按需为您的工程创建更多构建配置。
6. 创建构建配置后，您可右键单击Explorer视图并选中Build（构建）命令以构建组件。

   如果您创建了多个构建配置，IDE 将列出可用配置以供您选择。如果仅有单个构建配置，该工具将运行此配置。

   重要： 请确保从中启动 Vitis Unified IDE 的 shell 或终端窗口已正确配置，以便运行指定的构建命令。例如，Makefile 所需的任意环境变量对于该工具而言同样是必需的。
7. 组件或系统将根据构建配置命令执行构建。在“Output”（输出）视图中将报告此进程的输出。如果需要，您可从View > Output（视图 > 输出）菜单命令打开此视图。

构建设计组件后，您可按需在 IDE 中通过创建组件的启动配置来运行或调试这些组件。以下步骤可用于创建和运行或调试组件或系统工程。

1. 右键单击Explorer视图中的工作空间文件夹，并从弹出菜单中选中Edit Launch Configurations（编辑启动配置）命令。

   这样会将 launch.json 文件添加到当前工作空间内，并在 IDE 中打开Launch Configurations（启动配置）编辑器。

2. 选中New Launch Configuration（新建启动配置）命令或者选中工具栏菜单中的+按钮以定义启动配置。

   这样会打开Create Launch Configuration（创建启动配置）对话框，如下图所示。

   提示： 该工具将询问您是否需要指明指定构建目录的问题，例如，在构建进程中，该工具无法找到 v++ 生成的汇总文件。此警告将指明组件或系统无效，或者未能正确构建，并且该工具将无法继续运行。

   Create Launch Configurations对话框会提供可运行或调试的三个配置。

   AI 引擎计算图

   针对任意 AI 引擎计算图应用或模板，请选中该选项。指定的构建目录中会自动填充 v++ 命令生成的可用工作目录，以便启用 x86simulator 或 aiesimulator。

   单击Submit（提交）为 AI 引擎应用创建启动配置。在启动配置中，指定任意首选项，如Pipeline View（流水线视图）、“Trace”（追踪）和“Profiling”（剖析）。选中Play（执行）命令以运行组件，或者选中“Debug”（调试）按钮进行调试。

   加速应用

   对于使用可扩展平台来处理嵌入式系统设计或数据中心应用加速的系统工程，请选中该选项。指定的构建目录会利用构建目标、平台和二进制容器信息来自动完成映射。

   这样会为应用创建包含若干个部分的启动配置，提供必要的信息并运行/调试。

   嵌入式应用

   嵌入式应用有四个选项可用，如下所述。请参阅 Vitis 嵌入式软件开发用户指南(UG1400) 以获取更多信息。

   • Attach to Running Target（连接到运行中的目标）：要调试已运行的目标，请选中该选项。提供目标连接并启动应用的运行/调试。
   • “Baremetal”（裸机）：如果您有 XSA 并且想要创建运行配置，请映射 XSA 并单击Submit（提交）。这样会为应用创建包含若干个部分的启动配置，提供目标连接、FSBL、其他必要的信息并运行/调试。
   • Attach to Running Process on Linux Target（连接到 Linux 目标上运行中的进程）：要对已运行的 Linux 目标上的 Linux 应用进行调试，请选中该选项并单击“Submit”。这样会为应用创建包含若干个部分的启动配置，提供目标连接、主机可执行文件信息并运行/调试。
   • Linux Application with ELF（含 ELF 的 Linux 应用）：如果必须运行/调试某个 Linux 应用，请选中该选项并提供 ELF。这样会为应用创建包含若干个部分的启动配置，提供必要的信息并运行/调试。

3. 按需为正在尝试运行或调试的组件或系统配置“Launch Configuration”。如需了解更多详情，请参阅 启动配置。
4. 创建启动配置后，您可右键单击“Explorer”视图并从弹出菜单中选择Run或Debug命令。

5. 如果启动配置适用于 QEMU 下运行的嵌入式系统，那么您必须先启动仿真器，然后才能启动此配置。您可从弹出菜单中选中Start Emulator（启动仿真器）来完成此操作。这将打开Start Emulator对话框以便您按需复查并配置，然后单击Start（启动）。仿真器完全启动并正常运行后，请使用启动配置来运行或调试该应用。