本笔记概述了Overlay类在PYNQ 2.0中的变化以及如何有效地使用它。
重新设计的Overlay类有三个主要的设计目标
1.允许覆盖用户以一致的方式找出覆盖内的内容
2.为新硬件设计的开发人员提供一种简单的方法来测试新IP
3.促进Overlays之间IP的重用
本教程主要用于演示最后两点,介绍与新IP交互的过程,开发驱动程序,最后从多个IP块构建更复杂的系统。 所有代码和框图都可以在[https://github.com/PeterOgden/overlay_tutorial]能找到。 要使这些示例工作,请将覆盖目录的内容复制到PYNQ-Z1板上的主目录中。
开发单一IP
对于第一个例子,我们将使用一个简单的设计,其中包含一个IP。 此IP是使用HLS开发的,将两个32位整数进行相加。 加速器的完整代码是:
void add(int a, int b, int& c) {
#pragma HLS INTERFACE ap_ctrl_none port=return
#pragma HLS INTERFACE s_axilite port=a
#pragma HLS INTERFACE s_axilite port=b
#pragma HLS INTERFACE s_axilite port=c
c = a + b;
}
使用仅由HLS IP组成的框图和所需的胶连逻辑将其连接到ZYNQ7 IP
简单的框图如下:
要首先与IP交互,我们需要加载包含IP的overlay。
In [1]: from pynq import Overlay
overlay = Overlay(’/home/xilinx/tutorial_1.bit’)
创建overlay将自动下载它。 我们现在可以使用问号来找出overlay中的内容。
In [2]: overlay?
所有条目都可以通过带有指定驱动程序的overlay类上的属性访问。 访问它的scalar_add属性将为IP创建驱动程序 - 因为目前没有添加IP核的驱动程序将使用DefaultIP驱动程序,因此我们可以与IP核进行交互。
In [3]: add_ip = overlay.scalar_add
add_ip?
读取HLS生成的源代码告诉我们使用我们需要的核心来写两个参数来偏移0x10和0x18并从0x20读回结果。
In [4]: add_ip.write(0x10, 4)
add_ip.write(0x18, 5)
add_ip.read(0x20)
Out[4]: 9
创建驱动程序
虽然UnknownIP驱动程序对于确定IP正常运行非常有用,但它并不是最容易使用的API,无法向overlay的最终用户公开。 理想情况下,我们希望创建一个特定的IP的驱动程序,公开单个添加函数来调用加速器。 通过继承UnknownIP并添加由驱动程