9.1 特定芯片组增强支持概述
除本手册中描述的支持任何PCI/ISA设备驱动程序开发的标准WinDriver API和DriverWizard代码生成功能外，WinDriver还为特定PCI芯片组提供增强支持。这种增强支持包括自定义API、定制化代码生成（适用于部分芯片组）和示例诊断代码，均专为这些芯片组设计。
目前，WinDriver定制化代码生成功能的增强支持适用于以下PCI芯片组和FPGA PCIe IP核：
| 厂商 | 样例 | 定制化代码生成功能 |
|---|---|---|
| PLX | 6466、9030、9050、9052、9054、9056、9080、9656 | No |
| Altera | mSGDMA | Yes |
| Altera | Avalon-MM | Yes |
| Altera | Avalon-MM Scaler | Yes |
| Altera | MCDMA | Yes |
| Xilinx | BMD | Yes |
| Xilinx | XDMA | Yes |
| Xilinx | QDMA | Yes |
| Lattice | CertusProNX SGDMA PCIe IP | Yes |
| Lattice | Avant DMA Bridge Core PCIe IP | Yes |
9.2 利用芯片组增强支持开发驱动程序
当为基于上述增强支持芯片组的设备开发驱动程序时，可通过以下方式使用WinDriver的芯片组专用支持：
-
若设备基于Altera Qsys、Avalon-MM设计、Xilinx BMD、XDMA、QDMA设计，可在DriverWizard代码生成选项对话框中选择相应选项，为设备生成定制化代码（参见6.2节：DriverWizard操作指南）。
-
若使用其他增强支持设备，或选择其他开发方式，可按照以下步骤，以WinDriver增强支持示例为开发起点：
- 在
WinDriver/samples/language/chip_vendor/chip_name目录下找到对应设备的示例诊断程序。
大多数示例诊断程序命名为xxx_diag，其源代码通常位于xxx_diag子目录下，可执行文件位于目标操作系统对应的子目录中（例如，Windows系统对应WIN32目录）。
-
运行定制诊断程序，诊断设备并熟悉示例程序提供的功能选项。
-
将诊断程序的源代码作为设备驱动程序的框架，根据具体开发需求修改代码。修改时，可使用该芯片组专用的WinDriver自定义API，该API通常位于
WinDriver/samples/language/chip_vendor/lib目录下。 -
若通过上述步骤创建的用户模式驱动程序中包含需要增强性能的部分（例如中断处理程序），可将相关代码移至内核插件（Kernel PlugIn）驱动程序中以获得最佳性能，具体说明参见
第11章：提升PCI性能。
9.3 XDMA示例代码
从12.3版本开始，WinDriver提供用户模式诊断工具示例代码，展示采用Xilinx DMA IP编程的Xilinx PCI Express卡的多项功能。
示例源代码和预编译示例可在WinDriver/samples/c/xilinx/xdma目录中找到。
运行诊断工具前，请确保关闭DriverWizard，以避免“资源冲突”错误。
⚠ 注意
若已连接支持XDMA的合规设备，诊断工具可能在启动时自动打开该设备（如下所示）；否则，可选择选项2手动尝试打开设备。
xdma_diag 应用
9.3.1 XDMA设计和设备支持
XDMA 示例代码基于 XDMA 默认示例设计构建。有关该设计的更多详情，请参考《PCI Express DMA / 桥接子系统产品指南 ——AXI4 内存映射默认示例设计》。
该 XDMA 设计兼容以下器件系列：
- UltraScale
- UltraScale+
- 7 Series Gen2 devices
- Spartan UltraScale+
9.3.2 执行直接内存访问（DMA）测试
在XDMA主菜单中选择选项6后，用户可执行DMA传输或测量DMA性能。
该选项允许用户实际从设备读取数据或向设备写入数据：
-
写入选项：提示用户输入32位十六进制数据包，根据用户输入的“传输数据包数量”，将该数据包重复写入设备内存。
-
读取选项：根据用户输入的FPGA偏移量，打印指定内存区域的内容。
简单测试流程：
-
向设备内存写入某个32位数据包。
-
从相同偏移量读取数据，验证读取结果与之前写入的数据是否一致。
XDMA传输示例：
xdma_diag 应用
该选项允许用户测试设备速度，操作流程如下：
-
选择传输方向（到设备、从设备或双向同时传输）。
-
输入测试过程中每次传输的缓冲区大小和测试持续时间。
-
测试执行完成后，系统将打印测试结果。
XDMA性能测试示例：
9.3.3 XDMA图形界面（GUI）工具
从WinDriver 12.5版本开始，WinDriver提供基于xdma_diag源代码的GUI工具，支持上述DMA传输和DMA性能测试功能。该工具可在WinDriver/samples/c/xilinx/xdma/gui目录中找到。
与控制台程序xdma_diag类似，xdma_gui工具启动时会尝试自动打开XDMA设备；若失败，需先选择并打开支持XDMA的设备，再执行测试。
XDMA GUI工具
DMA传输测试（xdma_gui）
DMA性能测试（xdma_gui）
9.3.4 DriverWizard中的XDMA代码生成
从WinDriver 12.5版本开始，在DriverWizard中，通过“添加设备特定定制（可选）”菜单选择“Xilinx XDMA设计”，可生成与提供的xdma_diag程序类似的用户模式诊断程序源代码。
有关更多信息，请参见 6.2.9.1 示例或代码生成。
9.4 QDMA示例代码
从14.4版本开始，WinDriver提供跨平台用户模式诊断工具示例代码，展示支持QDMA IP（多队列DMA）的Xilinx PCI Express卡的多项功能。
示例源代码和预编译示例可在WinDriver/samples/c/xilinx/qdma目录中找到。
运行诊断工具前，请确保关闭DriverWizard，以避免“资源冲突”错误。
⚠ 注意
若已连接支持QDMA的设备，诊断工具将在启动时自动打开该设备；也可选择“查找并打开QDMA设备”选项手动尝试打开设备。
9.4.1 QDMA 设计及支持的器件系列
QDMA 示例代码基于QDMA AXI 内存映射示例设计构建。有关该设计的更多详情，请参考《PCI Express QDMA 子系统产品指南 ——AXI 内存映射示例设计》。
该 QDMA 设计兼容以下器件系列：
- UltraScale+
- Spartan UltraScale+
9.4.2 执行直接内存访问（DMA）事务
选择“直接内存访问（DMA）事务”选项后，用户可执行DMA事务（读取或写入设备数据），操作步骤如下：
-
添加MM队列（内存映射队列）。
-
启动MM队列。
-
创建读取请求或写入请求。
若选择阻塞方式（Blocking method）：事务完成后可查看事务详情（包括事务速率）。 若选择非阻塞方式（Non-blocking method）：可在“请求（Requests）”子菜单中查看事务详情。
9.4.2 切换物理功能
可同时打开多个QDMA设备，在菜单中选择“切换物理功能（Change physical function）”即可在不同物理功能间切换。
9.4.3 请求信息（Requests info）
在“请求（Requests）”菜单中可执行以下操作：
-
显示请求列表（读取和写入请求）。
-
显示缓冲区内容。
-
从列表中删除请求（包括释放该请求分配的缓冲区）。
-
获取所有队列状态：选择“获取队列状态（Get queue status）”，可查看队列的可用（Available）、已编程（Programmed）、已启动（Started）状态。
9.4.4 DriverWizard中的QDMA代码生成
从WinDriver 14.4版本开始，在DriverWizard中，通过“添加设备特定定制（可选）”菜单选择“Xilinx QDMA设计”，可生成与提供的qdma_diag程序类似的用户模式诊断程序源代码。
9.5 Avalon-MM示例代码
从14.7版本开始，WinDriver提供用户模式诊断工具示例代码，展示采用Avalon-MM IP编程的Intel Altera PCI Express卡的多项功能。
示例源代码和预编译示例可在WinDriver/samples/c/altera/avalonmm目录中找到。
9.5.1 DriverWizard中的Avalon-MM代码生成
在DriverWizard中，通过“添加设备特定定制（可选）”菜单选择“Altera Avalon内存映射（Avalon-MM）设计”，可生成与提供的avalonmm_diag程序类似的用户模式诊断程序源代码。
原文链接：https://windriver.jungo.com/manual/ch9_enhanced_support_for_specific_chipsets.html
（注：文档内容由 AI 生成,翻译正确性不做保证，只做参考，请参对比原文进行浏览，对于由翻译引起的问题不负任何责任 By chencarl）
