解决Xilinx官方PCIe测试程序xdma_rw.exe传输数据量受限的问题（传输超过8 MB数据时报错error code=1359）

一、问题描述与解决思路

在利用Xilinx Zynq开发板进行PCIe数据传输时，经常用到XDMA这个IP，并配套Xilinx官方测试程序xdma_rw.exe进行PC到开发板的数据传输测试。可是在传输超过一定大小的数据时，就会失败。如图1，我传输了8500000字节（8.11MB）的数据，会显示报错。

图1

上网搜索错误号1359无果。经Xilinx中文论坛一位老师的指点，知道是一个叫XDMA_MAX_TRANSFER_SIZE的参数限制了传输数据量，从名称上可以猜出这是一个有关“最大传输大小”的参数，其存在于源工程的一个库文件dma engine.h中。Xilinx在提供测试程序的同时，也会提供它们的源工程，用Visual Studio打开并在项目中搜索XDMA_MAX_TRANSFER_SIZE即可找到。在源工程中XDMA_MAX_TRANSFER_SIZE的初始值为 8 * 1024 * 1024，即8MB，所以也验证了我上方8.11 MB传输失败的问题。我们要将其修改成自己需要的大小，比如80 * 1024 * 1024。

二、VS + WDK环境的搭建

本问题的关键在于修改驱动程序，与xdma_rw.exe没有关系，所以我们接下来要做的事总结起来就是建立工程、修改参数、重新生成驱动程序并在PC上更新驱动程序。

进行以上步骤前需要先准备好VS + WDK的驱动开发环境。需要分别下载好VS、SDK和WDK，其中SDK和WDK的版本必须匹配。比如我的SDK是10.1.22000，那么我的WDK也要是10.1.22000。具体如何下载和配置可以参考如下文章：

Download the Windows Driver Kit (WDK) - Windows drivers | Microsoft Learn

VS2019+WDK环境搭建_虚伪2.0的博客-CSDN博客_vs2019 wdk

VS2019+WDK10驱动开发环境搭建_、moddemod的博客-CSDN博客_vs2019+wdk10

三、工程的建立

打开Visual Studio，新建Empty WDMDriver工程（图2）。

图2

到源工程的文件夹里复制以下三个文件夹到新建立的WDM项目的文件夹里。

图3

删除无用的模板（图4）：

图4

打开Xilinx提供的源工程，发现是这样的结构（图5），我们可以学习用到的部分，仿照着添加项目libxdma.vcxproj和XDMA_Driver.vcxproj，如图6。

图5

图6

在libxdma项目中找到dma engine.h，修改其中的XDMA_MAX_TRANSFER_SIZE。修改参数结束后，我们要进行项目的配置。

右键项目libxdma选择“属性”，进行如下界面的配置（图7-12）：

图7

图8

图9

图10

图11

图12

项目XDMA Driver的属性配置和libxdma完全一样，只是这里改一下（图13）：

图13

最后在“选项”中把这里的复选框取消勾选（图14-15）：

图14

图15

四、生成新的驱动程序

配置好项目后，就可以点击“生成——重新生成解决方案”

图16

生成了build和build_tmp文件夹。在build文件夹中找到XDMA_Driver文件夹，里面包含了四个文件（缺一不可）：

图17

将vivado工程下载到开发版中，通过PCIe接口连接到PC，确保PC处于测试模式并且能识别到PCIe接口后，右键选择更新驱动程序，点“浏览我的电脑以查找驱动程序”并选择新生成的XDMA_Driver文件夹，安装时会有安全警报，直接选择“始终安装此驱动程序软件”。安装好后，可能仍然会遇到问题“Windows 无法验证此设备所需的驱动程序的数字签名”，这一点可以参考博客 Windows 无法验证此设备所需的驱动程序的数字签名。某软件或硬件最近有所更改，可能安装了签名错误或损毁的文件，或者安装的文件可能是来路不明的恶意软件。(代码52) - 笨笨鱼~ - 博客园 (cnblogs.com) 解决。如果识别到的PCIe端口没有警告标志，说明驱动程序安装成功。按照语法运行xdma_rw.exe，发现可传输的数据量增大了，与XDMA_MAX_TRANSFER_SIZE所描述的相符。

参考博客：

Download the Windows Driver Kit (WDK) - Windows drivers | Microsoft Learn

VS2019+WDK环境搭建_虚伪2.0的博客-CSDN博客_vs2019 wdk

VS2019+WDK10驱动开发环境搭建_、moddemod的博客-CSDN博客_vs2019+wdk10

Windows 无法验证此设备所需的驱动程序的数字签名。某软件或硬件最近有所更改，可能安装了签名错误或损毁的文件，或者安装的文件可能是来路不明的恶意软件。(代码52) - 笨笨鱼~ - 博客园 (cnblogs.com)

VS2015+WDK10环境下PCIe_XDMA驱动工程编译_altair12345的博客-CSDN博客_xdma_max_transfer_size

编译空KMDF驱动程序时生成的.cat文件不存在 - 优文库 (uwenku.com)

如何将自己的项目工程生成exe发送给别人_逐梦之的博客-CSDN博客_vs生成的exe怎么给别人用