Zynq平台AXI VDMA设备树配置与帧缓冲驱动开发

1. 项目概述

在基于Xilinx Zynq系列SoC的嵌入式系统开发中，设备树（Device Tree）是连接硬件描述与Linux内核的关键桥梁。最近我在一个视频采集处理项目中，需要为AXI VDMA控制器添加设备树节点，实现帧缓冲（framebuffer）驱动支持。这个过程中遇到了一些值得记录的配置细节和避坑经验。

Zynq平台的传统开发流程中，Petalinux工具链极大地简化了Linux系统的构建过程。但当我们引入自定义IP（如VDMA控制器）时，设备树的正确配置往往成为系统能否正常工作的决定性因素。本文将详细演示如何通过修改设备树文件，为AXI VDMA添加帧缓冲支持，最终生成可启动的Linux系统镜像。

2. 环境准备与工程创建

2.1 Petalinux开发环境配置

在开始之前，确保你的开发主机满足以下条件：

• 已安装Petalinux对应版本（本文基于2019.2）
• 拥有有效的Xilinx工具链license
• 磁盘空间至少100GB（编译过程会产生大量中间文件）

建议使用普通用户身份操作，避免权限问题。我通常在~/.bashrc中添加环境变量：

bash复制source /opt/pkg/petalinux/2019.2/settings.sh

2.2 创建基础工程

使用硬件工程师提供的XSA文件创建工程骨架：

bash复制petalinux-create --type project --template zynq --name ask_fx2
cd ask_fx2
cp <path_to_hdf>/system.xsa .
petalinux-config --get-hw-description=./

这里有几个关键注意点：

1. --template zynq 指定了Zynq-7000系列模板，对于UltraScale+需要改为zynqMP
2. XSA文件必须与开发板型号严格匹配
3. 首次配置时会弹出图形界面，建议至少配置以下参数：
   • Subsystem AUTO Hardware Settings → Serial Setting → ps7_uart_1
   • Image Packaging Configuration → Root filesystem type → EXT4
   • FPGA Manager → Enable FPGA driver

经验分享：如果硬件设计中使用的是SD卡启动，务必在配置中选择正确的启动设备。我曾经因为误选QSPI启动模式导致系统无法引导，浪费了半天排查时间。

3. 组件配置与编译

3.1 U-Boot配置

虽然大多数情况下默认配置即可工作，但建议检查以下参数：

bash复制petalinux-config -c u-boot

重点关注：

• Bootargs是否包含正确的console设置
• 网络驱动是否使能（如需TFTP下载）
• 设备树加载地址是否与内存布局冲突

保存配置时建议使用有意义的文件名：

code复制Save Configuration to /path/to/u-boot.config

3.2 内核配置

视频采集项目通常需要特别关注以下内核选项：

bash复制petalinux-config -c kernel

关键配置项：

code复制Device Drivers → Graphics support → Frame buffer Devices → Enable
Device Drivers → DMA Engine support → Xilinx DMA engines → Enable
Device Drivers → Multimedia support → Video capture adapters → Enable

3.3 根文件系统配置

根据应用需求添加必要的软件包：

bash复制petalinux-config -c rootfs

对于视频处理项目，建议添加：

• alsa-utils（音频支持）
• v4l-utils（视频采集工具）
• fb-test（帧缓冲测试工具）

4. 设备树定制开发

4.1 理解VDMA设备树结构

AXI VDMA控制器的设备树节点通常包含三个关键部分：

1. DMA控制器定义（包含寄存器映射、中断号等）
2. DMA通道配置（数据位宽、突发长度等）
3. 帧缓冲设备绑定（将DMA通道与显示设备关联）

4.2 修改system-user.dtsi

在project-spec/meta-user/recipes-bsp/device-tree/files/目录下创建或修改system-user.dtsi：

dts复制/include/ "system-conf.dtsi"

/ {
    chosen {
        bootargs = "console=ttyPS0,115200 earlyprintk root=/dev/mmcblk0p2 rw rootwait rootfstype=ext4";
    };
    
    vdmafb {
        compatible = "xilinx,vdmafb";
        dmas = <&axi_vdma_0 0>;
        dma-names = "lcd_vdma";
    };
};

&sdhci1 {
    status = "okay";
    disable-wp;
    bus-width = <4>;
    max-frequency = <50000000>;
    no-1-8-v;
};

关键参数说明：

• dmas = <&axi_vdma_0 0>：绑定到axi_vdma_0控制器的通道0
• max-frequency = <50000000>：SD卡工作频率设置为50MHz
• no-1-8-v：禁用1.8V电平（某些旧版SD卡不支持）

4.3 修改pl.dtsi

在Petalinux工作目录中找到自动生成的pl.dtsi（路径通常为components/plnx_workspace/device-tree/device-tree），添加VDMA控制器定义：

dts复制axi_vdma_0: dma@43000000 {
    #dma-cells = <1>;
    clock-names = "s_axi_lite_aclk", "m_axi_mm2s_aclk", "m_axis_mm2s_aclk";
    clocks = <&clkc 15>, <&clkc 15>, <&clkc 15>;
    compatible = "xlnx,axi-vdma-6.3", "xlnx,axi-vdma-1.00.a";
    interrupt-names = "mm2s_introut";
    interrupt-parent = <&intc>;
    interrupts = <0 29 4>;
    reg = <0x43000000 0x10000>;
    xlnx,addrwidth = <0x20>;
    xlnx,flush-fsync = <0x1>;
    xlnx,num-fstores = <0x1>;
    dma-channel@43000000 {
        compatible = "xlnx,axi-vdma-mm2s-channel";
        interrupts = <0 29 4>;
        xlnx,datawidth = <0x10>;
        xlnx,device-id = <0x0>;
        xlnx,genlock-mode;
    };
};

寄存器地址0x43000000必须与Vivado设计中保持一致。我曾遇到因地址偏移错误导致DMA传输失败的情况，建议通过以下命令验证：

bash复制petalinux-build -c device-tree -x do_compile

5. 系统构建与部署

5.1 完整编译工程

bash复制petalinux-build

编译过程可能需要30分钟到数小时，取决于主机性能。建议：

• 使用-j参数指定并行编译任务数（如-j8）
• 监控内存使用，避免OOM错误
• 首次编译前运行petalinux-build -x distclean确保环境干净

5.2 生成启动镜像

bash复制cd images/linux
petalinux-package --boot --fsbl zynq_fsbl.elf --fpga system.bit --u-boot u-boot.elf --force

生成的BOOT.BIN包含：

• FSBL（第一阶段启动加载器）
• FPGA比特流
• U-Boot镜像

5.3 SD卡准备

使用fdisk分区工具创建两个分区：

1. FAT32分区（至少100MB），用于存放BOOT.BIN和image.ub
2. EXT4分区（剩余空间），作为根文件系统

bash复制sudo mkfs.vfat -F 32 -n boot /dev/sdX1
sudo mkfs.ext4 -L rootfs /dev/sdX2

6. 常见问题排查

6.1 启动卡在"Starting kernel..."

可能原因：

• 设备树编译错误
• 内存地址冲突
• 内核参数错误

解决方法：

1. 检查设备树编译日志：

   bash复制cat build/tmp/work/*/device-tree/*/log.do_compile
   

2. 确认bootargs中的root参数与SD卡分区一致
3. 尝试在U-Boot中手动加载设备树：

   bash复制fatload mmc 0 0x1000000 system.dtb
   fdt addr 0x1000000
   fdt print
   

6.2 VDMA驱动加载失败

典型症状：

• 内核日志中出现"probe failed"错误
• /dev下没有生成fb设备节点

排查步骤：

1. 确认DTS中compatible字符串与驱动匹配：

   bash复制grep -r "xilinx,vdmafb" /lib/modules/
   

2. 检查DMA通道状态：

   bash复制dmesg | grep dma
   

3. 验证时钟和复位信号：

   bash复制cat /sys/kernel/debug/clk/clk_summary
   

6.3 帧缓冲显示异常

当出现花屏、撕裂等问题时，可以：

1. 调整VDMA的stride参数：

   dts复制xlnx,stride = <1920>;
   

2. 检查像素格式是否匹配：

   bash复制fbset -i
   

3. 测试使用fb-test工具：

   bash复制fb-test -f 1
   

7. 性能优化建议

通过多次项目实践，我总结出以下优化技巧：

1. DMA缓冲区配置：

   • 在设备树中增加buffer数量：

     dts复制xlnx,num-fstores = <3>;
     

   • 调整buffer大小以减少中断频率

2. 时钟优化：

   dts复制clocks = <&clkc 15>, <&clkc 16>, <&clkc 15>;
   

   将m_axi_mm2s_aclk设置为更高频率的时钟

3. 内核参数调整：

   bash复制bootargs = "... coherent_pool=4M vmalloc=512M";
   

4. 启用DMA缓存一致性：

   dts复制dma-coherent;
   

这个VDMA配置方案已经在多个工业视觉项目中验证稳定，最高支持1080p@60fps的视频流处理。实际部署时建议使用散热片，因为持续高带宽DMA传输会导致PL部分温度显著升高。