PCIe 采集卡常用主机内存里的描述符告诉 FPGA 该向哪里搬运数据。AMD 的 PG195 描述了逐通道的描述符链表,并提供在轮询模式下回写完成描述符计数的机制。调试时容易从这个计数直接跳到复用缓冲区,但软件还得确认完成记录属于哪个通道和哪批请求,并依照操作系统的 DMA 接口把缓冲区交还给应用。驱动和 FPGA 对缓冲区所有权的理解如果不同,低速单请求时也许能工作,队列压满后就可能读取到上一轮数据。
把递交和回收定义成两个独立交接点
递交前,驱动准备描述符和缓冲区,写入设备需要的 DMA 地址、长度及标志。设备看到通知时,描述符内容必须已经可见。Linux DMA 映射指南特别指出,一致性映射并不消除正确使用内存屏障的需要。驱动还要按平台规则使用寄存器访问接口,保证设备接到通知时看到的是已经写好的内容。设备访问的地址应来自正确的映射接口,不能用进程虚拟地址代替。
回收时,先确认硬件提供的完成机制和启用条件,再把计数或状态映射到实际提交记录。PG195 的轮询回写只带完成计数的低二十四位,并另带错误汇总位,驱动需要按字段解析,还要考虑计数绕回。一个槽位多次复用时,软件可以将槽位索引和软件维护的代次关联,防止复位后迟来的记录被算到新请求上。若数据缓冲采用流式 DMA 映射,处理器读取前还要按映射方向和生命周期执行相应同步或解除映射。完成描述符、载荷可见和应用接管需要按驱动约定依次发生,避免应用提前读取。
用小队列和已知图样让错误可重复
可以先使用容量很小的队列,让描述符地址和槽位很快绕回。每个请求填入不同的序号、长度和校验信息,在用户态比对每次数据的起点、尾部与边界。随后增加并发,分别测试轮询和中断路径,观察驱动记录的递交、完成和回收三个时刻。若设备状态显示完成而数据序号滞后一轮,要优先检查回收条件、缓存同步以及是否误认了队列索引,再核对吞吐瓶颈。
复位路径也应覆盖满队列和未完成事务。停止新递交后,按平台允许的方式停用设备或等待其结束,直到能确认旧 DMA 不再访问相关内存,再解除映射或重新使用缓冲。验收记录应同时包含通道、请求序号、长度和完成来源。这样遇到偶发旧数据时,可以用记录判断它来自 FPGA 数据路径、驱动交接顺序还是应用复用得过早。

Silicon Software microEnable IV-AD4-CL PCIe 图像采集卡实拍。同类 PCIe 采集应用参考。 摄影 htomari,原图来源,图片按 CC BY-SA 2.0 使用。图片经过缩放并加边。