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

在Petalinux 2020.2上移植xilinx_axidma库：一个ZYNQ开发者的避坑实录与性能调优

news 2026/7/11 6:11:05

在Petalinux 2020.2上移植xilinx_axidma库：一个ZYNQ开发者的避坑实录与性能调优

作为一名长期深耕ZYNQ平台的开发者，我最近在将开源xilinx_axidma库移植到Petalinux 2020.2环境时，经历了一段既充满挑战又收获颇丰的旅程。不同于简单的步骤复现，这次移植更像是一场与内核版本、设备树配置和DMA性能的深度对话。本文将分享我从"代码能跑"到"系统稳定高效"的完整心路历程，特别聚焦那些文档中未曾提及的"坑"和性能调优的实战技巧。

1. 环境准备与内核适配陷阱

Petalinux 2020.2默认搭载的是Linux 5.4内核，这与xilinx_axidma库最初开发的4.x内核环境存在显著差异。我的第一个教训来自于想当然地认为"版本差异不会太大"。

1.1 关键内核配置项

在petalinux-config -c kernel中，以下配置必须确保正确：

CONFIG_CMA=y CONFIG_DMA_CMA=y CONFIG_XILINX_DMAENGINES=y CONFIG_XILINX_AXIDMA=y CONFIG_XILINX_AXIVDMA=y CONFIG_DMA_SHARED_BUFFER=y

提示：使用menuconfig保存自定义配置时，建议先保存为临时文件名（如alinx_sgdma_linux_defconfig），检查无误后再覆盖回.config文件。

1.2 CMA大小配置的艺术

默认的CMA配置往往无法满足高性能DMA传输需求。通过多次测试，我发现25MB是一个平衡点：

场景	推荐CMA大小	性能影响
小数据包测试	10MB	吞吐量下降15%
中等数据流	25MB	最佳性价比
4K视频处理	50MB+	内存占用较高

在Library routines -> CMA中设置后，务必检查生成的pl.dtsi文件是否包含：

linux,cma { size = <0x1900000>; // 25MB的十六进制表示 };

2. 设备树配置的深层逻辑

设备树配置是移植过程中最易出错的部分，特别是当PL端使用多个DMA通道时。

2.1 设备树结构解析

Petalinux的设备树架构遵循以下层级：

system-top.dts ├── zynq-7000.dtsi (基础SoC定义) ├── pl.dtsi (PL外设自动生成) └── system-user.dtsi (用户自定义)

关键修改应在system-user.dtsi中进行。对于AXI DMA配置，需要特别注意：

&amba_pl { axidma_chrdev: axidma_chrdev@0 { compatible = "xlnx,axidma-chrdev"; dmas = <&axi_dma_0 0 &axi_dma_1 1>; dma-names = "tx_channel", "rx_channel"; }; };

2.2 内核版本差异处理

在5.4内核中，我遇到了以下API变化：

access_ok()函数参数从两个变为三个：

// 4.x内核 access_ok(VERIFY_READ, arg, size); // 5.4内核适配 access_ok(arg, size);

of_dma_configure调用方式变化：

// 原代码 of_dma_configure(dev->device, NULL, true); // 修改后 of_dma_configure(&dev->pdev->dev, NULL, true);

信号处理结构体变更：

// 4.x内核 struct siginfo sig_info; // 5.4内核 struct kernel_siginfo sig_info;

3. 驱动移植与编译技巧

3.1 创建自定义内核模块

使用Petalinux命令创建模块骨架：

petalinux-create -t modules --name xilinx-axidma --enable

Makefile关键配置：

DRIVER_NAME = xilinx-axidma $(DRIVER_NAME)-objs = axi_dma.o axidma_chrdev.o axidma_dma.o axidma_of.o obj-m := $(DRIVER_NAME).o MY_CFLAGS += -g -DDEBUG ccflags-y += ${MY_CFLAGS}

3.2 设备树编译验证技巧

在修改设备树后，使用以下命令验证：

# 生成dtb文件 petalinux-build -c device-tree # 反编译验证 dtc -I dtb -O dts -o system.dts images/linux/system.dtb

特别注意检查：

DMA通道ID是否正确映射
时钟配置是否与Vivado工程一致
中断号是否冲突

4. 性能调优实战

4.1 DMA传输参数优化

通过axidmabenchmark测试工具，我对比了不同参数下的性能表现：

参数组合	吞吐量(MiB/s)	CPU占用率
默认参数	212.31	45%
增大DMA缓冲区	287.56	38%
调整SG模式	315.22	32%
优化时钟分配	342.18	28%

最佳实践配置：

// 在axidma_dma.c中调整 dma_cap_set(DMA_SG, dma_dev->cap_mask); dma_dev->max_sg_burst = 16;

4.2 零拷贝实现关键

xilinx_axidma库通过mmap实现用户空间零拷贝，这需要：

内核配置开启：

CONFIG_MMU=y CONFIG_DMA_CMA=y

用户空间映射代码示例：

void *map_axidma_buffer(int fd, size_t size) { return mmap(NULL, size, PROT_READ|PROT_WRITE, MAP_SHARED, fd, 0); }

驱动端mmap实现：

static int axidma_mmap(struct file *filp, struct vm_area_struct *vma) { return dma_mmap_coherent(dev, vma, buf->vaddr, buf->dma_addr, vma->vm_end - vma->vm_start); }

4.3 中断优化策略

在高速传输场景下，中断处理可能成为瓶颈。我采用的优化方法：

合并中断：

// 在设备树中配置共享中断 interrupts = <0 29 4>, <0 30 4>; interrupt-names = "s2mm", "mm2s";

采用NAPI机制：

napi_schedule(&dma_chan->napi);

调整中断亲和性：

echo 2 > /proc/irq/29/smp_affinity

5. 稳定性保障措施

5.1 内存屏障使用

在DMA操作中正确使用内存屏障：

// 传输前 dma_wmb(); // 传输后 dma_rmb();

5.2 超时处理机制

为DMA操作添加稳健的超时处理：

unsigned long timeout = msecs_to_jiffies(100); if (!wait_for_completion_timeout(&cb_data->comp, timeout)) { dmaengine_terminate_async(chan); return -ETIMEDOUT; }