简介面向FPGA与PCIe系统开发者这份PDF格式的IP介绍手册共278KB系统讲解8通道QDMA、RDMA、SGDMA与CDMA控制器的设计思路手册从PCI Express Integrated Block出发说明基于DMA地址队列的多通道QDMA和基于Ring缓冲的低延时RDMA并覆盖Continuous、Scatter Gather DMA实现机制适用于Ultrascale、Ultrascale与7系列器件。性能部分给出C2H/H2C实测数据PCIe 3.0 x16下超过14GB/sx8下超过7GB/sPCIe 2.0 x8下超过3.6GB/s同时还介绍AXI4-Stream/FIFO用户接口、64/128/256/512-bit数据路径、描述符预取和MSI中断等特性手册还讲清64位源/目的/描述符地址每个DMA引擎的地址队列深度可达32Ring缓冲深度和个数可配置并提供AXI4-Lite Master接口让PCIe绕过DMA直接访问用户寄存器典型应用包括数据通信、电信网络、视频采集显示和网络接口卡。对需要评估或集成多通道DMA方案、解决高吞吐数据搬移瓶颈的工程师这是一份可以快速上手的选型与设计参考。包体为1个PDF文档目前已有839人学习可作为FPGA PCIe IP的入门速查手册。1. DMA 控制器决定 PCIe 搬移的上限从 14GB/s 说起同样的 PCIe 3.0 x16 链路有人实测只能搬出 3GB/s有人能稳定跑到 14GB/s差距基本不在链路本身而在 DMA 控制器用哪种方式组织地址和描述符。这份 Multi-Channel PCIe QDMARDMA 子系统 IP 手册把 CDMA、SGDMA、RDMA 三种搬移模式收进同一套 8 通道 DMA 控制器里H2C 和 C2H 各 8 路独立工作每路再接各自的 AXI4-Stream/FIFO 接口。适合做多路视频采集与显示、网络接口卡、服务器 add-in card 这类需要“带宽可控、通道隔离”的场景。对 FPGA 工程师来说最关心的其实是三件事描述符怎么组织、数据面怎么对接、以及 90% 的 DMA 效率到底怎么验证。这篇就按这个顺序拆。2. 四种搬移模式辨析CDMA、SGDMA、QDMA 队列与 RDMA Ring 缓冲2.1 两个维度地址形态与提交方式SGDMA 和 CDMA 首先是一对地址形态概念。CDMAContinous DMA要求 host 侧物理地址连续DMA 引擎按固定地址连续搬简单直接延迟最小。SGDMAScatter Gather DMA把不连续的内存段用描述符链表串起来每个描述符记录一段源地址、目的地址和长度引擎取回链表后逐段搬运。手册里 Multi-Channel PCIe QDMA Subsystem 的两种工作模式就是指这两个CDMA 模式省掉了描述符遍历SGDMA 模式则换来了对 host 内存碎片的高度容忍。而 QDMA 和 RDMA 是另一对维度描述符以什么方式提交给硬件。QDMA 使用 DMA 地址队列软件把描述符所在地址写入队列项队列深度 32硬件按队列顺序取描述符RDMA 使用 DMA Ring 缓冲描述符直接写进 host 内存里固定大小的环形缓冲硬件通过头尾指针感知新描述符。手册把这两个子系统分列一个叫 Multi-Channel PCIe QDMA Subsystem一个叫 Multi-Channel PCIe RDMA Subsystem两者都提供最多 8 路 H2C 和 8 路 C2H、以及每通道独立的 AXI4-Stream/FIFO 用户接口。实际硬件在队列和 Ring 之上再叠加地址形态QDMA 子系统内部可选 ContinousCDMA或 Scatter GatherSGDMA工作模式RDMA 子系统则保持连续的 Ring 描述符流。2.2 描述符结构源地址、目的地址与 4GB 上限描述符是理解这套 DMA 的钥匙。手册给出的是标准的 64 位地址描述符每个通道的 DMA 引擎自己到 host 内存里去取描述符并解析不需要 CPU 逐段发起搬移。典型描述符可以用下面的 C 结构表达typedef struct { uint64_t src_addr; /* 源地址支持完整64-bit PCIe地址空间 */ uint64_t dst_addr; /* 目的地址H2C时指向card侧C2H时指向host */ uint32_t len; /* 本段传输长度按字节计上限4GB-1 */ uint32_t flags; /* 完成中断使能、错误标志、链尾标记等 */ uint64_t next; /* 指向下一个描述符的地址0表示链表结束 */ } pcie_dma_desc_t;这里 len 是 32 位无符号数所以单个描述符最大传输长度被限制在 4GB 内手册写“每个描述符的最大传输长度为 4GB”指的就是这个字段的边界。实际驱动会把一次大块读写拆成多个描述符拿 4MB 传输长度做性能测试时只需要两个描述符就够了。next 字段使描述符链表可以无限延伸SGDMA 的“无限列表大小”就来自这里硬件走到链尾描述符后写回完成状态再通过 MSI 中断通知驱动CPU 在整个数据搬移过程中不参与逐段拷贝。2.3 队列深度 32 与 Ring 缓冲的权衡队列深度 32 的意义在于给软件预填缓冲驱动可以先提交几十个描述符地址进队列硬件处理完一个自动取下一个不用每完成一笔就唤醒驱动补一个。RDMA 的 Ring 缓冲则把描述符直接放在内存环形区域深度和个数都可配置硬件可以连续预取多个描述符这是它超低延时、超低抖动的来源。描述符提交机制存放位置深度/规模延迟抖动特征手册对应子系统DMA 地址队列host 内存队列项存描述符地址每引擎深度 32吞吐优先描述符获取有批量性QDMA SubsystemDMA Ring 缓冲host 内存环形缓冲深度和个数可配置超低延时、超低抖动RDMA Subsystem在这个基础上再叠一层地址形态QDMA 子系统可以配置成 CDMA 或 SGDMA 模式RDMA 子系统用连续 Ring 描述符做 Continous Ring DMA。选型判断一般按这个顺序来host 内存能否锁页成连续块能就考虑 CDMA内存碎片多就必须上 SGDMA业务对延迟抖动有硬指标直接选 RDMA Ring多路业务流彼此独立就用多通道。常见误区是把 QDMA 和 SGDMA 当成二选一其实它们是两个维度的组合一个队列深度 32 的 QDMA 引擎完全可以跑 SGDMA 模式只是描述符地址入队、描述符本身靠链表串起来。3. 数据通路落点AXI4-Stream、数据路径位宽与请求尺寸权衡3.1 每通道独立 AXI4-Stream/FIFO 接口的结构工程上最常见的问题是“我的逻辑怎么接进去”。这版手册给出的用户接口是每通道独立的 AXI4-Stream/FIFOH2C 和 C2H 各 8 个。对 FPGA 逻辑来说H2C 通道是一个 Stream Master用户逻辑往里面送数据C2H 通道是一个 Stream Slave用户逻辑从里面取数据。每个通道有独立的 TDATA/TVALID/TREADY 信号互不干扰。8 路视频流的场景里MIPI 解串器、SDI 接收、HDMI RX 各接各的通道不用做仲裁。以 512-bit 数据路径的 H2C 发送接口为例用户侧握手长这样// H2C: User Logic - DMA - PCIe - Host 内存 module h2c_user_tx ( input wire axi_clk, input wire axi_rst_n, output reg [511:0] m_axis_tdata, // 512-bit 数据对应 PCIe 3.0 x16 宽路径 output reg [63:0] m_axis_tkeep, // 每字节有效标记64字节/拍 output reg m_axis_tlast, // 一次传输/一帧的最后一拍 output reg m_axis_tvalid, // 数据有效 input wire m_axis_tready // DMA 引擎反压信号 ); always (posedge axi_clk) begin if (!axi_rst_n) m_axis_tvalid 1b0; else if (m_axis_tready) m_axis_tvalid next_tvalid; end endmoduleTREADY 是 DMA 引擎给出的反压信号用户逻辑只需要在 TREADY 拉低时保持当前数据不变。TKEEP 的每一位对应 TDATA 的一个字节视频行尾或 DMA 描述符传输结束时 TLAST 拉高一拍DMA 引擎在这里关闭当前描述符并写回完成状态。这里有个容易忽略的细节TLAST 的语义需要和驱动约定好是代表一次描述符传输结束还是代表一帧视频结束手册里的 FIFO 接口模式下TLAST 通常对应一次 DMA 传输帧边界要另外用 sideband 信号或者描述符链的链尾来标。3.2 64/128/256/512-bit 数据路径怎么选数据路径位宽需要和链路带宽、接口时钟一起算。PCIe 3.0 x16 的单向有效带宽约为 16 GT/s × 16 lanes × 128/130 编码效率换算后约 15.75GB/s。512-bit 接口跑到 250MHz 就是 16GB/s刚好覆盖链路上限还留一点余量256-bit 要达到同样带宽就得跑 500MHz时序难度明显上升。手册支持 64/128/256/512-bit 数据路径实际选型一般按链路和场景对链路配置推荐数据路径接口时钟参考典型用途PCIe 2.0 x464-bit / 128-bit125MHz ~ 250MHz低速采集、控制面PCIe 3.0 x8128-bit / 256-bit250MHz ~ 500MHz单/双路视频采集PCIe 3.0 x16256-bit / 512-bit250MHz ~ 500MHz8 通道视频、NIC 加速接口时钟越低越好布线所以能上 512-bit 就不选 256-bit代价是 BRAM 和 LUT 占用明显上升。手册资源表里能直接看到这个差别8 通道 PCIe 3.0 x16 配置下 BRAM 用了 142 个同样 8 通道 x8 只用 73 个多出来的 BRAM 基本都耗在数据通路缓冲上。3.3 Max Payload Size 与 Max Read Request Size 对效率的影响手册性能测试条件里写着 Max Payload Size256 字节、Max Read Request Size512 字节。这两个参数直接决定 PCIe TLP 一次能写/读多少数据。C2H 方向是 card 向 host 写吃 MPS256 字节的写请求是常见保守选择H2C 方向是 card 向 host 发起读请求吃 MRRS512 字节意味着一次读请求最多返回 512 字节如果 MRRS 被压到 128 字节同样的总数据量要多发 4 倍读请求DMA 效率立刻掉下来。Linux 下直接在系统里确认当前值sudo lspci -vvv -s 01:00.0 | grep -iE MaxPayload|MaxReadReq # 期望输出: MaxPayload 256 bytes, MaxReadReq 512 bytes如果 lspci 没有显示 MaxReadReq部分老版本内核不解析可以用 setpci 读 PCIe 能力集里的 Device Control 寄存器# 0x08 是 Device Control 寄存器相对 PCIe 能力集的偏移 sudo setpci -s 01:00.0 CAP_EXP0x08.w # bit[14:12] 是 MRRSbit[7:5] 是 MPS001 表示 256B010 表示 512B注意这两个值可以在 PCIe Integrated Block 的配置里预设也可能被 BIOS 在枚举过程中改写。实测时如果性能比预期低很多第一件事就是用这条命令看 BIOS 有没有把 MRRS 收敛到 128B 或 256B。3.4 AXI4-Lite Master 配置接口绕过 DMA 引擎的控制面除了 8 路 Stream 数据面手册还提供一个固定的 32-bit AXI4-Lite Master 接口让 host 直接访问用户逻辑里的配置和状态寄存器数据不经过 DMA 引擎。这个接口适合放中断使能、帧格式寄存器、链路状态这类低频访问。它的宽度固定在 32-bit不要拿去做高带宽数据通路否则会成为瓶颈。数据面和控制面分离是这个体系结构的一个明显特征Stream 接口管大数据搬移AXI4-Lite 管寄存器读写User Register 信号管通道级控制/状态三者各司其职。4. 性能数据与资源占用实测把 14GB/s 拆解成可验证的指标4.1 官方性能数据对应什么链路配置手册第 3.1 节的性能表给的是 Endpoint 配置MPS256B、MRRS512B、DMA Transfer Length4MB。在这组参数下C2H 和 H2C 的带宽如下表链路配置C2H H2C 带宽相对单向理论带宽利用率PCIe 3.0 x16大于 14 GB/s约 90%PCIe 3.0 x8大于 7 GB/s约 89%PCIe 2.0 x8大于 3.6 GB/s约 85%PCIe 2.0 x4大于 1.7 GB/s约 90%PCIe 3.0 x16 单向理论有效带宽约 15.75GB/s14GB/s 大约是 88.9% 的链路利用率和手册宣传的“DMA 效率高达 90% 以上”互相印证。注意 C2H 和 H2C 是各自独立达到这个数字不是 8 通道共享 14GB/s。手册说支持 PCIe 4.0但性能测试只给了 2.0/3.0 的实测数据PCIe 4.0 x16 场景要靠同样思路自行估算。4.2 达到 90% 效率的三个机制第一个是描述符块获取。手册明确写了“连续描述符的块获取支持描述符预取”硬件一次 MMIO 读可以拿回多个连续描述符而不是逐个等待。第二个是描述符上限大每个描述符最大 4GB配合测试用的 4MB 传输长度一个描述符就能覆盖完整测试流量链路始终处于满突发状态。第三个是 MRRS 和 MPS 的配合512B 读请求在 x16 链路上可以保持足够的 in-flight 读请求数不会因为等待读完成而让链路空转。这三个机制单独拆开任何一个都不稀奇难的是把它们组合进同一套多通道引擎里。手册性能表格里 C2H 和 H2C 都标了“大于”实际跑到 14GB/s 时要注意测量方法DMA 完成中断的时效、描述符回写的开销、以及缓存一致性处理都会影响最终数字。4.3 资源占用8 通道并不是 1 通道的 8 倍把手册资源表挑几组放在一起看配置LUTsFFsBRAMsPCIe 3.0 x168 通道5342495356142PCIe 3.0 x161 通道221074611630PCIe 3.0 x88 通道254884174173PCIe 3.0 x81 通道869018174178 通道 x16 的 LUT 是 1 通道 x16 的 2.4 倍BRAM 约 4.7 倍并没有线性放大到 8 倍。这说明描述符解析、PCIe 请求打包、中断聚合这些逻辑是跨通道共享的多通道增加的主要是每通道独立的 FIFO 和队列状态。做资源预算时按“1 通道基础开销 每通道边际开销”的方式估算比直接乘 8 准得多。4.4 用 dd 实测 DMA 字符设备带宽驱动加载后每个 C2H 通道会暴露成一个字符设备节点可以直接用 dd 测速time sudo dd if/dev/pcieqdma_c2h_0 of/dev/null bs1M count4096 # 4096MB 除以 time 输出的 real 时间即该通道 C2H 单向带宽bs 取 1M 是为了让单次读请求对应到驱动内部一次完整 DMA 提交避免小缓冲区频繁进中断拉低效率。dd 的读操作会阻塞在 read 系统调用上直到 DMA 完成中断把数据交给驱动。测 H2C 方向时把 if 和 of 对调但要注意写成块设备或普通文件时写端可能被文件系统缓存干扰最好配合 O_DIRECT 或者用裸设备。5. 驱动与视频采集应用WDF/Linux/V4L2、MSI 中断与 H2C 显示定时5.1 三种驱动形态怎么选手册交付清单里列了 Windows WDF、Linux、V4L2 三类驱动。WDF 驱动面向 Windows 下的服务器加速卡和采集卡Linux 字符驱动适用通用 DMA 搬移V4L2 驱动则是把 C2H/H2C 通道包装成标准视频采集/显示设备。驱动形态系统典型对接方式Windows WDFWindows Server / 工作站Queue 模式与 Ring 模式都支持Linux 字符驱动Linuxopen/read/write/ioctl每通道独立设备节点V4L2Linux 嵌入式/dev/videoX配合 v4l2-ctl 或 GStreamer5.2 Linux 字符驱动队列提交Linux 驱动里一次 DMA 提交的典型流程是打开通道设备节点分配锁页缓冲区把缓冲区和长度通过 ioctl 提交到对应 DMA 队列然后阻塞 read 等待完成中断。int fd open(/dev/pcieqdma_c2h_0, O_RDWR | O_CLOEXEC); struct qdma_alloc_ioctl req { .size 4 * 1024 * 1024 }; ioctl(fd, QDMA_IOCTL_ALLOC, req); /* 分配并锁页 host 缓冲区 */ struct qdma_submit_ioctl xfr { .buf req.buf, .len req.size, }; ioctl(fd, QDMA_IOCTL_SUBMIT, xfr); /* 描述符地址写入 DMA 队列 */ read(fd, user_buf, xfr.len); /* 阻塞MSI 中断唤醒后返回 */这里 SUBMIT 的作用是把锁页缓冲区的物理地址填进描述符再把描述符地址写入该通道的 DMA 队列队列深度 32 允许驱动预提交多个请求。read 返回时硬件已经通过 MSI 中断把完成状态更新到描述符并且数据已写到用户缓冲区。驱动里通常还会做 ring 模式变体描述符直接写进环形缓冲提交路径比 ioctl 更短延迟更低。5.3 MSI 中断与查询模式手册同时支持 MSI 中断和查询模式。MSI 中断适合大块传输每完成一批描述符通知一次驱动查询模式适合超低延迟的控制类短事务驱动不断读完成状态寄存器牺牲 CPU 换响应速度。RDMA 子系统宣传的低抖动本质上来自 Ring 缓冲的确定性描述符位置固定、提交顺序固定、头尾指针同步简单中断聚合的时机更可控。手册还提供多达 16 个到 host 的用户中断信号用户逻辑可以把 VSYNC、帧同步等事件直接映射成 host 中断不需要经过 DMA 描述符完成中断。5.4 8 通道视频采集与 V4L2 接入手册典型应用图是 8 路摄像机输入和 8 路显示输出的对称结构MIPI/HDMI/SDI/CameraLink 进MIPI/DP/HDMI 出。V4L2 驱动把每个采集通道映射成独立 /dev/videoX抓一路 1080p 流的命令如下v4l2-ctl --device/dev/video0 \ --set-fmt-videowidth1920,height1080,pixelformatNV12 \ --stream-mmap --stream-count100 --stream-toframe.yuvpixelformat 选 NV12 是 YUV420 半平面格式视频采集卡最常见--stream-mmap 表示用 mmap 缓冲区避免每帧拷贝--stream-count100 抓 100 帧收工。这个命令能验证单通道 C2H 的帧率是否达到预期8 路同时跑时再用脚本并行起 8 个 v4l2-ctl 实例。H2C 方向支持视频显示定时时序输入控制驱动可以根据 VSYNC/HSYNC 信号精确控制 DMA 读的发起时刻把数据送到显示侧时不会撕裂画面DP 2160p 这类高带宽输出尤其依赖这个功能。6. 落地验证用 LTSSM 与 Linux 工具确认 DMA 链路健康6.1 lspci 三行看链路训练状态PCIe 枚举过程结束后的最终状态体现在 Link Status 寄存器里。系统起来后用一条命令确认链路有没有训练到预期速率和宽度sudo lspci -vvv -s 01:00.0 | grep -E LnkSta|LnkCap # LnkCap: 32 GT/s Width x16 - 设备能力 # LnkSta: 8 GT/s Width x16 - 当前实际状态LnkSta 显示 8 GT/s、x16说明链路已经稳定在 PCIe 3.0 x16。如果只到 2.5 GT/s 或 x1先查 REFCLK 和复位时序OS 阶段能看到的是 LTSSM 的最终结果Configuration 阶段卡在哪一步要靠逻辑分析仪抓 LTSSM 状态机才能定位。6.2 中断收敛性与队列健康检查数据搬移过程中中断分布也能反映问题watch -n 1 grep -i qdma /proc/interrupts多队列、多通道场景下MSI 中断应该分散到多个 CPU 核上如果全部集中在 CPU0说明 irqbalance 没有生效或者驱动没有正确设置 MSI-X affinity高负载时中断处理会拖累吞吐。中断次数应该随数据量线性增长完全不动就说明描述符没有完成回写或者 DMA 引擎已经出错挂起。6.3 三个容易踩的性能坑第一个坑是 BIOS 把 MRRS 压到 256B 以下H2C 读性能直接腰斩用 6.1 的 setpci 命令确认。第二个坑是未使用的通道没有关闭描述符预取空闲通道的引擎也在后台预取描述符白白占用 PCIe 读带宽寄存器里把不用通道的 DMA 引擎 disable 掉。第三个坑是用户侧 FIFO 深度小于一次 PCIe 突发长度AXI4-Stream 频繁反压链路长时间处于 idle 状态FIFO 深度至少要能吸收两倍 MPS 的突发数据。碰到 C2H 正常而 H2C 掉速优先查 MaxReadReq碰到中断抖动先查 MSI 是不是都落在同一个 CPU 核上。本文还有配套的精品资源点击获取