当前位置：首页 > news >正文

从驱动编译到数据传输：RK3588与FPGA的PCIe通信实战解析

news 2026/4/2 3:26:47

1. RK3588与FPGA的PCIe通信基础

在嵌入式开发中，RK3588作为一款高性能处理器，与FPGA的协同工作越来越常见。PCIe（Peripheral Component Interconnect Express）作为一种高速串行计算机扩展总线标准，能够提供高带宽、低延迟的数据传输，非常适合RK3588与FPGA之间的通信需求。

PCIe通信的核心在于驱动程序的适配和数据传输机制的实现。RK3588的PCIe控制器支持Gen3 x4配置，理论带宽可达32Gbps，而FPGA端通常通过IP核实现PCIe端点功能。两者之间的通信需要经过驱动编译、设备枚举、资源分配和数据传输等多个步骤。

在实际项目中，我遇到过不少开发者对PCIe通信感到困惑，主要是因为涉及到底层硬件和驱动开发的交叉领域。不过只要掌握了基本原理和关键步骤，实现起来并没有想象中那么困难。接下来我将从驱动编译开始，一步步带你完成整个通信流程。

2. XDMA驱动编译与加载

2.1 驱动源码准备与编译环境搭建

XDMA驱动是Xilinx提供的一个开源PCIe DMA驱动，支持多种数据传输模式。在RK3588平台上使用需要针对内核版本进行适配。首先需要准备以下环境：

RK3588的Linux SDK，包含内核源码和交叉编译工具链
XDMA驱动源码（可从Xilinx官网获取）
开发主机上的交叉编译环境

编译前需要特别注意内核版本匹配问题。RK3588通常运行5.10或更高版本的内核，而XDMA驱动可能需要做一些适配修改。我在实际项目中遇到过内核API变更导致的编译错误，解决方法是对照内核版本差异调整驱动代码。

编译命令示例：

make -C $(BUILDSYSTEM_DIR) M=$(PWD) modules ARCH=arm64 CROSS_COMPILE=$(CROSS_COMPLIE_3588)

2.2 驱动参数配置与编译技巧

XDMA驱动提供了多个编译时可配置参数，这些参数直接影响驱动行为和性能：

DEBUG=1：启用详细调试信息，开发阶段建议开启
config_bar_num：配置PCIe BAR编号
xvc_bar_num：XVC调试接口的BAR编号

在Makefile中，可以通过EXTRA_CFLAGS添加这些参数：

EXTRA_CFLAGS := -I$(topdir)/include $(XVC_FLAGS) ifeq ($(DEBUG),1) EXTRA_CFLAGS += -D__LIBXDMA_DEBUG__ endif

编译完成后会生成xdma.ko模块文件，这个文件需要拷贝到RK3588的文件系统中。

3. 驱动加载与设备节点创建

3.1 驱动加载与初始化过程

将编译好的xdma.ko文件传输到RK3588后，使用insmod命令加载驱动：

insmod xdma.ko

驱动加载过程中会输出初始化信息，这些信息对于调试非常重要。例如：

[ 20.351795] xdma:xdma_mod_init: Xilinx XDMA Reference Driver xdma v2020.2.2 [ 20.352450] xdma:xdma_device_open: xdma device 0000:01:00.0

如果驱动加载失败，常见原因包括：

内核版本不匹配
PCIe设备未正确枚举
资源冲突（如内存地址、中断等）

3.2 设备节点与功能解析

驱动加载成功后，会在/dev目录下创建多个设备节点：

/dev/xdma0_c2h_0 # Card to Host通道0 /dev/xdma0_c2h_1 # Card to Host通道1 /dev/xdma0_h2c_0 # Host to Card通道0 /dev/xdma0_h2c_1 # Host to Card通道1 /dev/xdma0_control # DMA控制接口 /dev/xdma0_user # 用户空间访问接口

这些设备节点对应不同的功能：

c2h和h2c节点用于DMA数据传输
control节点用于DMA引擎配置
user节点用于直接访问FPGA寄存器

4. 内存映射与寄存器访问

4.1 BAR空间映射原理

PCIe设备通过BAR（Base Address Register）空间与主机通信。XDMA驱动通常会映射两个BAR空间：

BAR0：用户空间寄存器，用于控制和状态交互
BAR1：DMA控制寄存器，用于配置DMA引擎

在驱动初始化时，会调用pci_iomap()函数将这些BAR空间映射到内核虚拟地址空间：

bar0_addr = pci_iomap(pdev, 0, bar0_len); bar1_addr = pci_iomap(pdev, 1, bar1_len);

4.2 用户空间寄存器访问方法

在用户空间，可以通过mmap()系统调用将BAR空间映射到进程地址空间，然后直接访问FPGA寄存器。示例代码：

int fd = open("/dev/xdma0_user", O_RDWR); void *regs = mmap(NULL, PAGE_SIZE, PROT_READ|PROT_WRITE, MAP_SHARED, fd, 0); // 读写寄存器 uint32_t *reg = (uint32_t *)((char *)regs + offset); *reg = value; // 写寄存器 value = *reg; // 读寄存器 munmap(regs, PAGE_SIZE); close(fd);

需要注意的是，寄存器访问需要考虑字节序问题。RK3588是ARM64架构，使用小端字节序，而FPGA端可能需要特定的字节序处理。

5. DMA数据传输实现

5.1 DMA通道配置与使用

XDMA驱动提供了两种数据传输模式：

简单模式：通过read()/write()系统调用进行数据传输
SG（Scatter-Gather）模式：支持分散/聚集传输，效率更高

配置DMA通道前，需要先设置DMA引擎参数，如传输方向、数据宽度、突发长度等。这些参数通过control设备节点进行配置。

5.2 高性能数据传输实现

对于大数据量传输，建议使用SG模式。示例代码：

struct xdma_sg_ioctl sg_cmd; sg_cmd.buffer = (unsigned long)buf; sg_cmd.len = len; sg_cmd.ep_addr = fpga_addr; sg_cmd.done = 0; ioctl(fd, IOCTL_XDMA_SG_DMA, &sg_cmd);

在实际项目中，我通过以下优化手段将传输性能提升了30%：