开发者分享 | Vitis HLS 中的 AXI4-Lite 简介-上

您是否想创建自己带有 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。

https://china.xilinx.com/support/documentation/sw_manuals/xilinx2020_1/c...

AXI4-Lite 属于基本 AXI 通信协议。它常用于简单的低吞吐量存储器映射通信(例如,往来于控制寄存器和状态寄存器的通信)。

如上图所示,AXI4-Lite 接口可设置为只读(仅包含 2 条读取通道)或只写(仅包含 3 条写入通道)。

在本教程中,我们将创建以下 IP,并使用 s_axi_BUS_A 作为我们的 AXI4-Lite 接口:

本教程结束时,您将能够

  • 了解在 Vitis HLS 中创建 AXI4-Lite 接口的相关基础知识。
  • 了解 Vitis HLS 中的编译指示相关信息,此类编译指示用于定义所使用的 AXI 接口。
  • 打开 AXI4-Lite 设计示例

    在 Vitis HLS 中提供了 AXI4-Lite 的设计示例。要打开 AXI4-Lite 的设计示例,请遵循以下步骤进行操作:

    1. 打开 Vitis HLS GUI。在首页屏幕中,选择“克隆示例 (Clone Examples)”选项以便从 GitHub 复制 Vitis HLS 设计示例:

    2. 在弹出选项卡中,选择示例的保存位置,然后单击“确定 (OK)”:

    3. 在下一个屏幕中,设计示例将显示在左下角。选中“HLS 微教程 (HLS Tiny Tutorials)”和“工作树结构 (Working Tree)”旁的箭头即可查看所有可用示例。

    4. 向下滚动,找到 interface_axi_lite 示例。右键单击文件夹名称,然后选中“运行并打开 HLS 工程 (Run and Open HLS Project)”选项。

    5. 完成此操作后,将在左侧选项卡中打开此工程。双击 example.cpp 和 example_test.cpp 以查看源代码和测试激励文件。

    源代码详解

    此示例包含 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 即可打开源代码。接下来我们来详细看下代码:

    函数实参

    void example(char *a, char *b, char *c)

    进入库之后首先可看到的是 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 命令进行复位来实现,但不能为其指定任何其它默认值。(请参阅控制复位行为以了解详细信息)。

    https://china.xilinx.com/html_docs/xilinx2020_1/vitis_doc/programmingvit...

    接口编译指示

    接下来,我们来看看编译指示接口。

    首先逐一了解下其中每个组件:

    #pragma HLS INTERFACE s_axilite port=a bundle=BUS_A
    
    #pragma HLS INTERFACE s_axilite port=b bundle=BUS_A
    
    #pragma HLS INTERFACE s_axilite port=c register bundle=BUS_A
    
    #pragma HLS INTERFACE s_axilite port=return bundle=BUS_A

    我们需要把 IP 的输入/输出定义为 s_axilite,这样才能使用 AXI4-Lite 协议。如果我们的代码中不包含此行,那么数据输入/输出将综合到基本连线中,并且将不含关联的握手信号。在此情况下,输入将保持稳定状态直至执行读取输入操作为止,一旦未谨慎执行此操作,就可能导致错误。

    接口编译指示格式如下:

    #pragma HLS interface <mode> port=<name> (register) bundle=<string>

    其中:

    :用于指定函数实参的接口协议模式。在此例中,我们选择的是 s_axilite。

    port=:用于指定 INTERFACE 编译指示所应用到的函数实参名称。

    (register):这是可选关键字,用于寄存(即存储)信号和所有关联的协议信号。它会导致信号保持直至至少完成函数执行的最后一个周期为止。

    bundle=:此关键字支持您将端口信号手动组合到单一数据总线内。如果函数返回指定为 AXI4-Lite 接口(即代码示例中的第 25 行),那么所有数据端口都将被自动捆绑到单一总线中。如果未在此处明确提供捆绑名称,那么 Vitis HLS 将使用默认捆绑名称control。当使用其它器件(例如,CPU)来配置和控制块的启动和停止操作时,这是常见的做法。

    s_axilite port=return:用于设置类型为 s_axilite 的函数实参,端口名称“return”将在 IP 块中创建中断信号。您可通过 AXI4-Lite 接口和 C 语言驱动程序文件来完成中断编程。如需了解更多信息,请参阅 此处

    https://china.xilinx.com/html_docs/xilinx2020_1/vitis_doc/programmingvit...

    注:如果任意顶层函数实参指定为 AXI4-Lite 接口,则函数返回也必须指定为 AXI4-Lite 接口。

    注 2:默认情况下,HLS 会为分组到同一个 AXI4-Lite 接口的每个端口分配地址。Vitis HLS 在C 驱动程序文件 (如下链接)中提供了分配的地址。要显式定义地址,可使用 offset 选项。在 AXI4-Lite 接口中,Vitis HLS 保留地址 0x0000 到 0x000C,用于块级 I/O 协议信号和中断控制。

    https://china.xilinx.com/html_docs/xilinx2020_1/vitis_doc/programmingvit...

    函数主体

    *c += *a + *b;

    在该函数中,可以精确定义希望此 IP 执行的操作,此 IP 将导入 2 个值(a 和 b)并将结果 (c) 存储在寄存器中。为测试功能,测试激励文件将为 a 和 b 提供 example() 函数,并将其与自己计算 a+b 所得的值进行比较。如果结果相匹配,那么测试激励文件应始终返回 0,并且 c 仿真即可通过。

    在下一篇 AXI 基础系列文章中,我们将学习如何将 IP 导出到 Vivado Design Suite 中以便通过 AXI4-Lite 接口将其连接到其它 IP 或连接到 PS。

    本文转载自:Xilinx技术社区微信公众号

    推荐阅读