通过BRAM实现PS与PL数据交互
============================

有时CPU需要与PL进行小批量的数据交换，可以通过BRAM模块，也就是Block RAM实现此要求。本章通过Zynq的GP Master接口读写PL端的BRAM，实现与PL的交互。在本实验中加入了自定义的FPGA程序，并利用AXI4总线进行配置，通知其何时读写BRAM。

以下为本实验原理图，CPU通过AXI BRAM Controller读取BRAM数据，CPU仅配置自定义的PL BRAM Controller的寄存器，不通过它读写数据。

.. image:: images/06_media/image1.png
      
硬件环境搭建
------------

最终工程建立如下图所示，添加了GPIO用于产生中断，中断是在pl_ram_ctrl写完BRAM后发出write_end信号给GPIO，由GPIO产生中断。

.. image:: images/06_media/image2.png
      
1. 以下为AXI BRAM Controller模块配置，连接AXI总线，可用于读写BRAM模块，AXI模式设置为AXI4，数据宽度设置为32位，memory depth不在这里设置，需要在Address Editor里设置。BRAM端口数量设置为1个，用于连接双口RAM的PORTA。不使能ECC功能。

.. image:: images/06_media/image3.png
      
由于AXI4总线为字节询址，BRAM数据宽度设置也是32位，同样都是32位数据宽度，因此在映射到BRAM地址时，需要按4字节询址，即去掉最后两位，下图为BRAM控制器与BRAM的映射关系。

.. image:: images/06_media/image4.png
      
在Address Editor里选择BRAM询址大小，如设置4K空间，即可询址BRAM空间为1K深度。

.. image:: images/06_media/image5.png
      
2. BRAM设置如下，有两种模式选择，standalon模式，此模式可以自由配置RAM的数据宽度和深度。BRAM Controller模式，此模式下地址线和数据端口默认为32位，本实验因为用到了BRAM控制器，因此选择BRAM Controller模式。Memory类型选择双口RAM，一端连BRAM控制器，一端连PL RAM控制器。

.. image:: images/06_media/image6.png
      
1. 添加自定义的PL RAM控制器pl_ram_ctrl，功能很简单，start信号有效后开始读取BRAM的数据，可通过ILA逻辑分析仪观察读取的数据，PL RAM控制器读BRAM结束后，开始向BRAM写数据，写完数据使能write_end信号，通过GPIO产生中断，CPU即可读取BRAM的数据。将PL控制器信号与BRAM的PORTB连接。

.. image:: images/06_media/image7.png
      
自定义IP在ip_repo文件夹中

.. image:: images/06_media/image8.png
      
如果想添加自定义IP到IP库中，点击IP Catalog，在Vivado Repository右键点击Add Repository

.. image:: images/06_media/image9.png
      
找到自定义IP所在文件夹，点击Select

.. image:: images/06_media/image10.png
      
跳出窗口，选择IP，点击OK

.. image:: images/06_media/image11.png
      
即可看到，出现了刚添加的IP

.. image:: images/06_media/image12.png
      
4. GPIO设置为输入，并使能中断，并连接GPIO的ip2intr_irpt中断信号到CPU中断输入接口

.. image:: images/06_media/image13.png
      
5. 点击Run Synthesis，生成综合文件。

.. image:: images/06_media/image14.png
      
6. 生成综合文件后，点击Set Up Debug，添加逻辑分析仪信号

.. image:: images/06_media/image15.png
      
7. 添加BRAM的接口信号到逻辑分析仪，可点中信号按“+”添加，也可拖到窗口，系统会自动分配时钟

.. image:: images/06_media/image16.png
      
8. 点击Next，设置采样深度，采样深度越大，采集到的数据越多

.. image:: images/06_media/image17.png
      
9. 之后点击Finish完成

.. image:: images/06_media/image18.png
      
10. 保存当前的Synthesized Design，之后点击Generate Bitsream生成bit文件，并导出Hardware信息。

.. image:: images/06_media/image19.png
      
Vitis程序开发
-------------

1. 程序设计流程为：输入起始地址和长度CPU通过BRAM控制器写入BRAM数据通知PL控制器读取BRAM数据PL内部读完后向相同位置写入数据，初始数据由CPU告知写完后使能write_end信号，触发GPIO中断中断读取BRAM数据，打印显示

2. 进入Vitis后，在Vitis下新建项目，已经准备好程序。程序也比较简单，首先是进行GPIO的初始化，中断设置

.. image:: images/06_media/image20.png
      
3. While语句中需要输入起始地址和长度，之后调用bram_write函数

.. image:: images/06_media/image21.png
      
4. 在bram_read_write();函数里先通过BRAM控制器写入数据，数据初值为TEST_START_VAL，之后配置PL RAM控制器参数，有长度，起始地址，初始数据，以及开始信号。并在函数中判断测试长度是否超出BRAM控制器地址范围，如果超出，会报错，需要重新输入地址和长度。

.. image:: images/06_media/image22.png
      
1. 中断服务程序中，BRAM控制器读取BRAM的数据，并打印

.. image:: images/06_media/image23.png
      
实验现象
--------

1. 打开Putty

.. image:: images/06_media/image24.png
      
2. 通过Run Configurations下载程序，注意勾选Program FPGA，点击Run

.. image:: images/06_media/image25.png
      
3. 打开Hardware Manager，设置将en信号作为触发信号，选择上升沿触发，选择循环触发按钮，点击开始按钮，可以看到hw_ila_1变成了Waiting for trigger状态

.. image:: images/06_media/image26.png
      
4. 打开串口软件，下载程序，打印出信息，需要输入起始地址，由于BRAM询址为1K，那么可以设置为0~1023，长度设置为1~1024，注意起始地址+长度不要超过1024，因为超出了询址空间。

.. image:: images/06_media/image27.png
      
5. 输入的数据为十进制数，输入结束按回车

.. image:: images/06_media/image28.png
      
6. 打开ILA逻辑分析仪，可以看到已经触发，首先是PL控制器从BRAM读数据，之后是写数据，可以看到红色为PL读出的BRAM数据，正是CPU写入的数据，从12开始，共10个数据，PL写入的数据为黄色部分从1开始，共10个数据，正与上图CPU读BRAM的数据相符。

.. image:: images/06_media/image29.png
      
可以看到write_end有效之后，过一定时间触发中断

.. image:: images/06_media/image30.png
      
7. 如果超出范围，打印错误信息，需要重新输入有效信息

.. image:: images/06_media/image31.png
      
本章小结
--------

以上就是PS与PL通过BRAM实现低带宽数据交互的实验，两者通过GP口进行数据互连，可以实现小批量的数据交互。

知识点为逻辑分析仪的使用，GPIO中断的使用，自定义IP等。