修订历史 - 2022.1 简体中文

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

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

下表列出了本文档的修订历史。

章节 修订综述
2022 年 5 月 25 日 2022.1 版
AI 引擎编译器选项 添加有关两个保留码字的注释:aieadf 在 graph 编程中均为无效的名称空间标识符
在 Vitis 分析器中查看编译结果 更新 2022.1 版的 graph。
可编程逻辑 (PL)信号线拼块 更新 2022.1 版的示例详细信息以及 Vitis 分析器 GUI 截屏。
接口通道 添加新的 graph 接口通道详细信息。
用于 graph 输入和输出的事件剖析 API 添加有关信号线上的事件的详细信息。
使用 Vitis 分析器查看指南 添加本指南。
生成流量用于软硬件仿真 澄清除 C++ 和 Python 外,您也可在 HDL 中写入外部流量生成器。
2022 年 4 月 26 日 2022.1 版
概述 更新 2022.1 版的 Vitis 核开发套件详细信息。
创建数据流 graph(包含内核) 更新 2022.1 编程模型。
同步窗口访问 添加章节,用于解释窗口到窗口的广播以及多重速率设计支持。
基于串流的访问 添加章节,用于解释使用级联串流执行基于串流的访问的方式。
并行使用串流 更新 32 位宏和 64 位宏的列表。
运行时参数支持汇总 移除不再受支持的 AI 引擎到 AI 引擎运行时间参数构造。
多播支持 更新多播支持场景表。
使用 RTL 编程逻辑的设计流程 更新示例,用于反映 2022.1 编程模型更改。
graph 编程模型 更新整章内的编程模型详细信息和示例。
AI 引擎编译器选项 添加新的多重速率选项。

更新 --Xrouter=<string> 示例。

映射器和布线器选项 移除 enableSplitAsBroadcast 选项(始终开启)。

添加 disablePathBalancing 选项。

x86 功能仿真器 添加在 Vitis 分析器中可视化 X86 仿真输出的功能。
设计编译 添加 X86 仿真器选项。
数据快照 添加在 Vitis 分析器中可视化快照的功能。
限制 移除“仿真输出文件处理注意事项”和“adf::headers 约束和 aie_api 包含文件”章节,因为这些 x86 仿真限制已得到解决。
仿真器选项 添加新选项和挂起检测详细信息。
启用第三方仿真器 更新 VCS 详细信息。

添加 Riviera 仿真器信息。

剖析硬件中的 AI 引擎

接口拼块剖析

剖析 AI 引擎、存储器模块和接口拼块

添加用于 DMA write/read_bandwidths 的事件。

添加剖析接口事件的功能。

Vitis 分析器中的 FIFO 深度可视化 添加可视化 Vitis 分析器中的 DMA FIFO 深度(来自仿真 VCD 数据)的功能。
XSDB 流程

XRT 流程

添加指定事件追踪开始时间的功能。

添加定期卸载追踪数据的功能。

使用 Vitis 分析器查看剖析结果 添加接口指标示例。

添加在 Vitis 分析器中整合多个剖析结果的功能。

分析硬件中的 AI 引擎状态

生成 AI 引擎状态

在 Vitis 分析器中分析 AI 引擎状态

添加报告并输出硬件中的 AI 引擎状态的功能,并添加在 Vitis 分析器中打开和分析该报告的功能。
以 DFX 平台为目标 添加了除基础平台外还可使用 DFX 平台的功能,并添加了有关在硬件中使用此平台的信息。
用于控制 AI 引擎 graph 的多进程和多线程支持 添加有关 xrtGraphClosexrtDeviceClose 行为的澄清信息。
平台 更新“平台类型”,以包含 DFX 平台。
性能指标 添加“Show Percentage”按钮描述。
锁定停滞分析

串流停滞分析

级联停滞分析

存储器停滞分析

添加程序计数器 (PC) 选项,该选项允许您在 Vitis 分析器中对来自“Trace”视图的源代码进行交叉探测。
生成流量用于软硬件仿真

以 Python 和 C++ 创建流量生成器

添加在 x86 功能仿真器、AI 引擎仿真器、软件仿真和硬件仿真中使用流量生成器的支持。这些流量生成器可采用 Python、C++ 或 HDL 来编写。
裸机的主机编程

构建裸机系统

Linux 与裸机之间的主机编程支持比较

添加有关裸机软件栈的详细信息。

对在裸机中与在 Linux 操作系统中运行主机应用的功能进行比对。

使用 Vitis 工具流程来集成应用

系统链接

系统封装

更新以反应 v++ 链接现在可生成 XSA 文件的事实。
AI 引擎硬件剖析和调试方法论 新增有关 AI 引擎硬件剖析和调试方法论的章节。
input_gmio/output_gmio

input_plio/output_plio

更新文档,以反映编程模型的更改,包括 input_gmio/output_gmioinput_plio/output_plio
其它约束 为多重速率设计添加 repetition_count 约束。
2021 年 12 月 17 日 2021.2 版
窗口和串流数据 API 添加更多受支持的无符号整数数据类型。
执行运行时数据参数 澄清描述。
模型功能特性编程 更改章节标题。
AI 引擎编译器选项 新增 表 10
AI 引擎剖析 新增章节。
graph 吞吐量剖析 添加信息。
剖析硬件中的 AI 引擎 新增章节。
硬件中的事件追踪 新增章节。
硬件事件追踪 新增章节。
在硬件中对事件追踪进行故障排除 新增章节。
2021 年 10 月 22 日 2021.2 版
AI 引擎拼块架构 更新了 图 1
内核准备 更新 AI 引擎 API。
创建数据流 graph(包含内核) 添加表示 graph 连接的图示。
窗口和串流数据 API 更新 AI 引擎 API 和模板支持的数据类型。
包切换 graph 构造 添加浮点数据示例。
面积位置约束 新增章节。
分层约束 添加信息。
模型功能特性编程 新增章节。
AI 引擎编译器选项 新增选项。
AI 引擎 graph 应用仿真 添加仿真流程相关信息。
数据快照 新增章节。
死锁检测 新增章节。
追踪报告 新增章节。
存储器访问违例和 Valgrind 新增章节。
存储器模型 更新信息。
仿真输出文件处理注意事项 新增章节。
adf::headers 约束和 aie_api 包含文件 新增章节。
软件仿真 新增章节。
仿真器选项 新增选项。
硬件仿真 新增章节。
复用 AI 引擎仿真器选项 添加有关设置 AI 引擎编译器 workdir 环境变量以及手动创建仿真选项的信息。
基于 AI 引擎仿真的剖析 新增章节。
受支持的窗口数据类型 更新数据类型。
受支持的串流数据类型
在 Vitis 分析器中执行 AI 引擎停滞分析 新增章节。
用于控制 AI 引擎 graph 的多进程和多线程支持 新增章节。
AI 引擎错误事件 更新错误以及调试技巧。
运行软件仿真 新增章节。
面积分组约束 更新属性。
创建 AI 引擎 graph 工程和顶层系统工程 更新截屏。
构建和运行系统 更新以添加软件仿真。
调试 AI 引擎应用 添加调试信息。
从 Vitis IDE 进行软件仿真调试 新增章节。
从命令行运行软件仿真 新增章节。
使用调试环境 更新截屏。
观察点 新增章节。
用于软件仿真调试的 Vitis IDE 布局 新增章节。
窗口和串流 API 的非模板版本 添加附录,描述窗口和串流数据类型的非模板版本和 API。
2021 年 7 月 19 日 2021.1 版
FIFO 位置约束 更新 FIFO 约束示例。
受支持的窗口数据类型 新增主题。
受支持的串流数据类型 新增主题。
在 Vitis IDE 中构建裸机 AI 引擎 更新步骤 4。
2021 年 6 月 16 日 2021.1 版
运行时比率 新增主题。
串流数据类型

读取并递增输入串流

写入并递增输出串流

新增串流类型。
运行时参数支持汇总 添加 AI 引擎 RTP 支持表。
串流交换机 FIFO

DMA FIFO

AI 引擎拼块 DMA 性能

新增 FIFO 主题。
包切换 graph 构造 更新允许的包串流数量。
多播支持 新增主题。
AI 引擎/可编程逻辑集成 更新内容。
硬件仿真流程和硬件流程 移除 ADF_FRONTEND
AI 引擎/PL 与 AI 引擎/NoC 接口之间的性能比较 新增主题。
AI 引擎编译器选项
  • 更新堆和栈大小。
  • 添加 --broadcast-enable-core CDO 选项。
  • 更新追踪选项。
  • 更新 xlopt
graph 和阵列详细信息 新增章节。
AI 引擎编译器指南 新增主题。
复用 AI 引擎仿真器选项 添加 --profile/AIE_PROFILE 选项。
启用第三方仿真器 添加仿真器并更新版本。
x86 功能仿真器 更新内容,添加新章节。
在 Vitis 分析器中查看运行汇总 更新内容。
追踪视图数据可视化 新增章节。
运行时事件 API 性能计数器使用汇总 新增主题。
PS 主机应用编程 移除 ADF_FRONTEND
利用 XRT C++ API 控制 AI 引擎 graph 新增主题。
通过 XRT API 报告错误 更新 xbutil 作用域。
含 ADF API 和 XRT API 的主机代码参考 更新 printf
PL 内核时钟设置 更新主题。
为 Cortex-A72 处理器编译嵌入式应用 更新代码。
  • aarch64-linux-gnu-g++ 改为 aarch64-xilinx-linux-g++
运行硬件仿真 新增章节。
使用 Vitis IDE 更新截屏。
映射器/布线器方法论 新增章节。
事件 API 移除额外的“Enumeration”章节。
FIFO 约束 新增主题。
在 AI 引擎内核中使用 restrict 关键字 更新 C++。