输出 - 2022.1 简体中文

Versal ACAP AI 引擎编程环境 用户指南 (UG1076)

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

默认情况下,AI 引擎编译器会将所有输出都写入名为 Work 的目录和 libadf.a 文件,其中,Work 是启动工具的当前目录的子目录,libadf.a 文件则用作为 Vitis 编译器的输入,此文件是在启动 AI 引擎编译器的相同目录中创建的。输出的类型和输出目录的内容取决于指定的 --target,如 AI 引擎编译器选项 中所述。如需了解有关 Vitis 编译器的更多信息,请参阅 Vitis 统一软件平台文档:应用加速开发(UG1393) 中的 Vitis 编译器命令

提示: 您可使用 --workdir 选项指定不同的输出目录。

下表中描述了 ./Work 目录的结构和内容。

表 1. 工作目录结构
目录/文件 描述
./Work/  
  <name>.aiecompile_summary 这是一个生成文件,可在 Vitis 分析器中将其打开以查看编译汇总信息。
  config/scsim_config.json 该 JSON 脚本用于为 SystemC 仿真器指定选项。它包含 AI 引擎阵列拼块几何结构、输入/输出文件规范及其与串流交换机的连接。
  arch/  
  logical_arch_aie.larch 该 JSON 文件旨在描述 AI 引擎应用的硬件要求。
  aieshim_constraints.json 该 JSON 文件如果存在,即表示 AI 引擎阵列与通过 AI 引擎应用所提供的可编程逻辑之间的用户定义的物理接口约束。
  aieshim_solution.aiesol 该 JSON 文件旨在描述从逻辑通道到物理通道的映射,这些通道跨越 AI 引擎阵列与可编程逻辑之间的接口。
  cfgraph.xml 该 XML 文件旨在描述 AI 引擎应用的硬件要求。此文件供 Vitis 工具流程使用。
  aie/  
  Makefile 此 Makefile 文件用于为所有 AI 引擎编译代码。
  array and programmable<n>_<m>/ 这些目录是各个 AI 引擎编译目录。
  Release/ Synopsys 版本目录,适用于包含 ELF 文件的 AI 引擎
  <n>_<m>.lst 内核微码,位于 <n>_<m>
  <n>_<m>.map 用于显示位于 <n>_<m> 的内核的存储器映射。它还包含存储器大小、宽度和偏移。
  scripts/ Synopsys 编译器工程和连接器脚本。
  src/ 处理器(包含内核与 main)的源文件。
  ps/c_rts/ 此目录包含基于 C 语言的运行时协议,用于对 PS 交互进行建模。
  aie_control.cpp 这是 AI 引擎控制代码,它是通过为程序中存在的特定 graph 对象实现 initrunend graph API 后所生成的。此文件与 main 应用相链接,为仿真器和裸机创建 PS 线程。
  aie_control_xrt.cpp 这是 AI 引擎控制代码,它是通过为程序中存在的特定 graph 对象实现 initrunend graph API 后所生成的。此文件与 main 应用相链接,为 Linux 应用创建 PS 线程。
  systemC/ 此目录包含 PS main 的 SystemC 模型。
  Makefile 此 Makefile 文件用于编译所有 PS SystemC 模型。
  generated-source/ 其中包含 SystemC 封装文件,用于 PS main
  generated-objects/ 包含已编译的共享库,用于 PS main
  ps/cdo/ 此目录包含生成器代码,用于以配置数据对象格式 (CDO) 进行 graph 配置和初始化。可在 SystemC-RTL 仿真和实际硬件执行期间使用。
  Makefile Makefile用于编译 graph CDO
  generateAIEConfig 此 bash 脚本用于构建 graph CDO
  generated-sources/ 包含用于生成 CDO 的 C++ 程序。
  generated-objects/ 包含用于生成 CDO 的已编译程序。
  pthread/  
  PthreadSim.c 这表示从输入数据流 graph 到 C 语言程序的源码到源码转换,使用 pthreads 来实现。
  sim.out GCC 编译的二进制文件,适用于 PthreadSim.c
  reports/  
  <graph>_mapping_analysis_report.txt 此映射报告用于描述如何将内核分配给 AI 引擎以及如何将窗口缓冲器分配给 AI 引擎存储器组。
  <graph>.png 此 bitmap 文件用于显示基于 AI 引擎的内核 graph 连接和分区。
  <graph>.xpe 此 XML 文件用于描述基于所使用的硬件资源估算的 graph 功耗剖析。此文件可搭配 Xilinx® Power Estimator (XPE) 工具来使用。
  sync_buffer_address.json 显示内核同步缓冲器地址,并包含局部和全局地址。
  lock_allocation_report.json 描述端口以及与内核关联的锁定和缓冲器。
  dma_lock_report.json 显示 AI 引擎的输入/输出的 DMA 锁定及其连接到的内核(含缓冲器信息)。
  temp/ 此目录包含由 AI 引擎编译器生成的部分临时文件,可用于调试。此外,此处默认还会创建 CF graph .o 文件。