告别内核恐慌！手把手教你用Petalinux 2017.4为ZYNQ 7010配置AXI DMA驱动（附CMA避坑指南）

告别内核恐慌！手把手教你用Petalinux 2017.4为ZYNQ 7010配置AXI DMA驱动（附CMA避坑指南）

第一次在ZYNQ Linux环境下接触DMA的开发者，往往会被各种晦涩的概念和复杂的配置流程吓退。本文将从一个嵌入式开发者的实际经验出发，带你一步步完成从环境搭建到DMA驱动运行的完整流程，重点解决那些官方文档语焉不详、网上教程避而不谈的"坑点"。

1. 环境准备与工程创建

在开始之前，我们需要确保开发环境完全匹配。不同版本的Petalinux和Vivado可能存在兼容性问题，这也是很多新手第一个容易踩的坑。

必备工具清单：

• Vivado 2017.4
• Petalinux 2017.4
• ZYNQ 7010开发板（以黑金7010为例）
• DMA硬件描述文件(.hdf)

注意：版本一致性至关重要。混合使用不同版本工具链是导致90%编译错误的根源。

创建Petalinux工程的正确姿势：

source /opt/pkg/petalinux/2017.4/settings.sh petalinux-create -t project --name zynq_dma --template zynq cd zynq_dma petalinux-config --get-hw-description=/path/to/your_dma.hdf

常见问题排查：

• 如果遇到"Invalid template"错误，检查Petalinux安装路径是否正确
• "No valid hardware description"通常意味着.hdf文件路径错误或文件损坏
• 确保工程目录路径不包含中文或空格

2. 内核配置的魔鬼细节

2.1 DMA引擎配置

进入内核配置界面：

petalinux-config -c kernel

必须确认以下选项已启用：

[*] DMA Engine support [*] Xilinx AXI DMA Engine support [*] DMA shared buffer support [*] Contiguous Memory Allocator

实际经验：黑金开发板自带的内核通常已配置好这些选项，但自行编译内核时这些选项经常被遗漏。

2.2 CMA配置的艺术

CMA（Contiguous Memory Allocator）是DMA工作的基础，也是新手最容易栽跟头的地方。通过设备树修改CMA大小：

// 在system-user.dtsi中添加 / { reserved-memory { #address-cells = <1>; #size-cells = <1>; ranges; linux,cma { compatible = "shared-dma-pool"; reusable; size = <0x1000000>; // 16MB CMA区域 alignment = <0x2000>; linux,cma-default; }; }; };

CMA大小设置原则：

1. 至少为传输数据量的两倍（发送和接收各需空间）
2. 考虑系统其他驱动对CMA的需求
3. 不宜过大以免挤占常规内存

典型错误案例：

axidma: page allocation failure: order:4, mode:0x40cc0 CMA: failed to allocate 65536 bytes

3. 设备树修改实战

设备树是连接硬件和软件的桥梁，正确的设备树配置是DMA工作的关键。以下是完整的设备树配置示例：

&amba_pl { axidma_chrdev: axidma_chrdev@0 { compatible = "xlnx,axidma-chrdev"; dmas = <&axi_dma_0 0 &axi_dma_0 1>; dma-names = "tx_channel", "rx_channel"; }; }; &axi_dma_0 { dma-channel@40400000 { xlnx,device-id = <0x0>; }; dma-channel@40400030 { xlnx,device-id = <0x1>; }; };

设备树修改后需要重新编译并更新BOOT.BIN：

petalinux-build petalinux-package --boot --fsbl images/linux/zynq_fsbl.elf --fpga images/linux/system.bit --u-boot --force

4. xilinx_axidma库的编译与使用

4.1 获取和配置源码

从GitHub克隆最新代码：

git clone https://github.com/bperez77/xilinx_axidma.git cd xilinx_axidma

关键配置文件config.mk的修改要点：

KBUILD_DIR获取方法：完成petalinux-build后，在build/tmp/work目录下搜索linux-xlnx路径

4.2 编译与部署

编译驱动和示例程序：

make driver make examples

部署到开发板的三种方式：

1. 直接复制到SD卡
2. 通过NFS挂载
3. 打包进rootfs

推荐测试顺序：

1. 加载驱动：insmod axidma.ko
2. 基准测试：./axidma_benchmark
3. 传输测试：创建测试文件并运行./axidma_transfer 1.txt 2.txt

5. 实战排错指南

5.1 常见错误及解决方案

问题1：驱动加载失败

insmod: ERROR: could not insert module axidma.ko: Unknown symbol in module

解决方案：

• 检查内核版本匹配性
• 确认CONFIG_DMA_CMA已启用
• 重新编译驱动时指定正确的KBUILD_DIR

问题2：CMA分配失败

DMA: preallocated 16MB pool axidma: page allocation failure: order:4, mode:0x40cc0

解决方案：

• 增加CMA大小（见2.2节）
• 检查是否有其他驱动占用大量CMA空间

问题3：数据传输不完整解决方案：

• 检查DMA通道配置是否正确
• 验证源和目的地址是否4字节对齐
• 使用示波器检查PL端信号完整性

5.2 性能优化技巧

1. 双缓冲技术：在用户空间实现ping-pong缓冲，隐藏DMA传输延迟
2. 大页内存：使用hugepage减少TLB miss
3. 缓存控制：适当使用cache flush/invalidate操作
4. 中断合并：调整DMA中断触发阈值

实测性能对比：

6. 进阶应用：自定义DMA传输

对于需要更灵活控制的场景，可以直接操作DMA引擎：

// 初始化DMA传输描述符 struct dma_async_tx_descriptor *tx_desc; tx_desc = dmaengine_prep_slave_sg(chan, sg_list, sg_len, dir, flags); // 设置回调函数 tx_desc->callback = dma_callback; tx_desc->callback_param = callback_param; // 提交传输 dma_cookie_t cookie = dmaengine_submit(tx_desc); dma_async_issue_pending(chan);

关键参数说明：

• sg_list：散列表，描述内存区域
• dir：传输方向（DMA_MEM_TO_DEV等）
• flags：控制标志（DMA_PREP_INTERRUPT等）

在实际项目中，我们通常会封装一个DMA传输管理器，处理以下情况：

• 传输超时检测
• 错误自动恢复
• 带宽动态调整
• 多通道负载均衡

7. 系统集成注意事项

将DMA驱动集成到完整系统时需注意：

1. 电源管理：DMA控制器在低功耗模式下的行为
2. 安全考虑：DMA区域的内存保护
3. 多进程访问：实现合理的资源锁定机制
4. 实时性保证：在RT内核下的表现差异

一个健壮的DMA系统应该包含：

• 完善的状态监控
• 详尽的日志记录
• 优雅的错误处理
• 性能统计接口

经过三个实际项目的验证，这套方法在黑金7010开发板上的稳定性表现：