AI 引擎编译器选项 - 2023.2 简体中文

对于栈、堆和同步缓冲器（32 字节，包括计算图运行迭代数信息），可分配最多 32768 字节的数据存储器。默认堆大小设置为 1024 字节。将堆大小更改为其他值之前，请确保栈、堆和同步缓冲器大小总和不超过 32768 字节。

该选项用于分配文件作用域内的任意剩余数据，这些数据在用户计算图中均未显式连接。

对于栈、堆和同步缓冲器（32 字节），可分配最多 32768 字节的数据存储器。默认栈大小设置为 1024 字节。将栈大小更改为其他值之前，请确保栈、堆和同步缓冲器大小总和不超过 32768 字节。

该选项用作为标准编译器调用约定，包括栈分配的局部变量和寄存器溢出。

默认阈值频率为 AI 引擎频率的八分之一，视特定器件速度等级而定。

• 0：错误
• 1：级别 0 + 警告
• 2：级别 1 + 参考消息
• 3：级别 2 + 调试消息

默认值为 2。

• hw 目标会生成 libadf.a 以供在目标平台上的硬件器件中和在硬件仿真中使用。
• x86sim 目标会编译代码以供在x86 simulator（x86 仿真器）中使用，如 x86 功能仿真器 中所述。

指定一个或多个 include 目录。

指定到 Vitis 平台文件的路径。该文件是您开发 Vitis 应用程序的起点。这些应用可以有效利用平台提供的资源和功能。此平台定义了可在应用中使用的硬件和软件组件。此平台可指定为赛灵思平台文件 (XPFM) 或赛灵思 Shell 存档 (XSA)。

例如，aiecompiler --include ./aie --part xcvc1902-vsvd1760-2MP-e-S graph.cpp

要执行 AI 引擎编译，aiecompiler 要求您指定 --platform 选项或 --part 选项。不能同时指定 --platform 选项与 --part 选项。

默认编译器将所有输出都写入当前目录中名为 Work 的子目录。该选项可用于指定其他输出目录。

通过再收敛数据路径来评估并解决死锁的步骤如下：

1. 使用该选项编译设计。
2. 在设计上运行 aiesimulator。
3. 打开 Vitis Unified IDE 并运行 run_summary 仿真。注意“Estimated FIFO”（估算的 FIFO）列，并在特定信号线上使用 fifo_depth 约束来应用建议的 FIFO 数量。

如需了解更多信息，请参阅 评估 FIFO 深度以打破死锁。

• 0：围绕获取和释放 I/O 缓冲器使用保守调度。
• 1（默认值）：围绕获取和释放 I/O 缓冲器使用积极调度，这可能减少周期计数。

选项字符串指定为 <kernel-function>:<optionid>=<value>。在映射指定内核函数的 AI 引擎上编译生成的源文件期间包含该选项字符串。

例如，为了将并行编译数量限制为 4，请写入 -Xelfgen="-j4"。

--Xmapper=DisableFloorplanning

如果设计在映射或布线阶段无法收敛，或者如果您要尝试通过减少存储体冲突来提升性能，则可尝试这些选项。

请参阅 映射器和布线器选项 以获取选项列表及其描述。

--Xpreproc=-D<var>=<value>

--Xpslinker=-L<libpath> -l<libname>

-Xrouter=dmaFIFOsInFreeBankOnly

-Xx86sim=clangStaticAnalyzer

为内核源代码启用 clang 静态分析器。

• safe：精度略好于 FP32。
• fast：提升性能，精度与 FP32 相似。
• low：最佳性能，精度好于 FP16 和 bfloat16。

其中，<value> 为以下值之一：

• functions
• functions_partial_stalls
• functions_all_stalls
• runtime

• 不含停滞的函数转换视图。
• 含串流/锁定/级联停滞的函数转换视图。
• 含所有停滞（串流/锁定/级联/存储器）的函数转换视图。
• AI 引擎存储器和接口拼块的运行时事件追踪配置。

• plio
• gmio

• 将 AI 引擎事件追踪端口设置为 plio
• 将 AI 引擎事件追踪端口设置为 gmio

• xlopt=1
  • 自动编译堆大小：使用内核分析来自动计算每个 AI 引擎的堆要求，由此保证易用性。因此，您无需指定堆大小。
  • 指导信息：通过提供指导信息来高亮未对齐的变量、可能由映射器分配的全局阵列、restrict 的不当使用以及可能出现的先读取后写入冲突。
  • 编译指示插入：在内核代码中自动推断和插入编译指示。
• xlopt=2
  • 自动内联：如果可自动内联函数，则执行此操作，即使这些函数未声明为 __inline 或 inline 也是如此。
  • 对展开的循环进行循环剥离：通过剥离，使循环迭代次数成为展开因子的倍数。基于循环的迭代次数和利益启发，将循环拆分为多个循环，并在拆分的循环上添加平铺编译指示。

• -annotate-pragma=false：关闭循环编译指示的自动插入
• -xlinline-threshold=T：将自动内联阈值设置为 T（默认 T = 5000）
• -annotate-pragma：自动插入循环展开、流水打拍和平铺编译指示（默认值 = true）

启用围绕 I/O 缓冲器的获取和释放开展更积极的调度的功能（默认值：0）。

• --lock-fence-mode=0：禁用积极调度
• --lock-fence-mode=1：使用积极调度，但多层设计除外

• --runtime-opt=false：无最优化。这是默认方式。
• --runtime-opt=true：启用最优化。