AXI 基础第 6 讲 - Vitis HLS 中的 AXI4-Lite 简介(第 1 部分)_百度...
发布网友
发布时间：2024-10-24 03:31
共1个回答
热心网友
时间：2024-10-30 15:26
注：本文转自赛灵思中文社区论坛，源文链接 在此。本文原作者为XILINX工程师。
以下为个人译文，仅供参考，如有疏漏之处，还请不吝赐教。
您是否想创建自己带有 AXI4-Lite 接口的 IP 却感觉无从着手？本文将为您讲解有关如何在 Vitis HLS 中使用 C 语言代码创建 AXI4-Lite 接口的基础知识。
在本教程中，我们将来聊一聊有关如何在 Vitis HLS 中使用 AXI4-Lite 接口创建定制 IP 的基础知识。如果您是 AXI 初学者，并且想要熟悉一下相关的基本术语和背景知识，请参阅教程 AXI 基础第 1 讲。
注：在 Vivado HLS 中使用 AXI 创建 IP 的过程与使用 Vitis HLS 的过程不同。如果您想要在 Vivado HLS 中创建 AXI IP，请参阅 UG902。
AXI4-Lite 属于基本 AXI 通信协议。它常用于简单的低吞吐量存储器映射通信（例如，往来于控制寄存器和状态寄存器的通信）。
如上图所示，AXI4-Lite 接口可设置为只读（仅包含 2 条读取通道）或只写（仅包含 3 条写入通道）。
在本教程中，我们将创建以下 IP，并使用 s_axi_BUS_A 作为我们的 AXI4-Lite 接口：
本教程结束时，您将能够
打开 AXI4-Lite 设计示例
在 Vitis HLS 中提供了 AXI4-Lite 的设计示例。要打开 AXI4-Lite 的设计示例，请遵循以下步骤进行操作：
此示例包含 2 个主要文件：
Example.cpp - 此代码将综合到 RTL 中以创建“简介”中所示的 IP。此 IP 将与 Vivado Design Suite 中的其它 IP 相结合，并最终被放置到您的硬件上。
Example_test.cpp - 此测试激励文件将用于确保 example.cpp 按期望方式运行。Example.cpp 算法将通过如下方式进行检查：将该算法的输出与测试激励文件中执行的“黄金数据 (golden data)”计算结果进行比较。只要黄金数据与 example.cpp 的返回结果相匹配，HLS 中的测试激励文件就会返回 0。
选中左侧列中“源代码 (Source)”下的 example.cpp 即可打开源代码。接下来我们来详细看下代码：
进入库之后首先可看到的是 example(); 函数。只要您熟悉基于 C 语言的设计，就不难发现，通过形参（如上述示例中的 char *a、char *b 和 char*c）即可瞬间执行所有输入和输出操作。
在 RTL 设计中，数据通过端口进出 IP。这些端口可使用特定 I/O 协议（例如，AXI4-Lite、AXI4-Stream 等）来进行操作，这样即可保证 IP 块之间能够进行标准化的通信。
对于进出 IP 的每一条数据，都应将其指定为主源文件中的一个独立函数实参。稍后，该函数实参将被综合成硬件 (RTL) 中的一个“端口”。
注：端口实际上可通过 3 种不同方法来创建，但本教程将主要讲解采用函数实参的方法。
端口衍生自：
注：由于 AXI4-Lite 接口中的变量为函数实参，因此在 C 语言代码中无法为其指定默认值。因此，无法为 AXI4-Lite 接口中的任何寄存器指定默认值。这些寄存器可通过 config_rtl 命令进行复位来实现，但不能为其指定任何其它默认值。（请参阅 控制复位行为以了解详细信息）。
接下来，我们来看看编译指示接口。
首先逐一了解下其中每个组件：
我们需要把 IP 的输入/输出定义为 s_axilite，这样才能使用 AXI4-Lite 协议。如果我们的代码中不包含此行，那么数据输入/输出将综合到基本连线中，并且将不含关联的握手信号。在此情况下，输入将保持稳定状态直至执行读取输入操作为止，一旦未谨慎执行此操作，就可能导致错误。
接口编译指示格式如下：
其中：
：用于指定函数实参的接口协议模式。在此例中，我们选择的是 s_axilite。
port=：用于指定 INTERFACE 编译指示所应用到的函数实参名称。
(register)：这是可选关键字，用于寄存（即存储）信号和所有关联的协议信号。它会导致信号保持直至至少完成函数执行的最后一个周期为止。
bundle=：此关键字支持您将端口信号手动组合到单一数据总线内。如果函数返回指定为 AXI4-Lite 接口（即代码示例中的第 25 行），那么所有数据端口都将被自动捆绑到单一总线中。如果未在此处明确提供捆绑名称，那么 Vitis HLS 将使用默认捆绑名称 control。当使用其它器件（例如，CPU）来配置和控制块的启动和停止操作时，这是常见的做法。
s_axilite port=return：用于设置类型为 s_axilite 的函数实参，端口名称“return”将在 IP 块中创建中断信号。您可通过 AXI4-Lite 接口和 C 语言驱动程序文件来完成中断编程。如需了解更多信息，请参阅 此处。
注：如果任意顶层函数实参指定为 AXI4-Lite 接口，则函数返回也必须指定为 AXI4-Lite 接口。
注 2：默认情况下，HLS 会为分组到同一个 AXI4-Lite 接口的每个端口分配地址。Vitis HLS 在 C 驱动程序文件中提供了分配的地址。要显式定义地址，可使用 offset 选项。在 AXI4-Lite 接口中，Vitis HLS 保留地址 0x0000 到 0x000C，用于块级 I/O 协议信号和中断控制。
函数主体
在该函数中，可以精确定义希望此 IP 执行的操作，此 IP 将导入 2 个值（a 和 b）并将结果 (c) 存储在寄存器中。为测试功能，测试激励文件将为 a 和 b 提供 example() 函数，并将其与自己计算 a+b 所得的值进行比较。如果结果相匹配，那么测试激励文件应始终返回 0，并且 c 仿真即可通过。
在下一篇 AXI 基础系列文章中，我们将学习如何将 IP 导出到 Vivado Design Suite 中以便通过 AXI4-Lite 接口将其连接到其它 IP 或连接到 PS。
