Xilinx AXI DMA驱动及库安装配置完全指南

Xilinx AXI DMA驱动及库安装配置完全指南

xilinx_axidma A zero-copy Linux driver and a userspace interface library for Xilinx's AXI DMA and VDMA IP blocks. These serve as bridges for communication between the processing system and FPGA programmable logic fabric, through one of the DMA ports on the Zynq processing system. Distributed under the MIT License. 项目地址: https://gitcode.com/gh_mirrors/xil/xilinx_axidma

项目基础介绍

本项目Xilinx AXI DMA 提供了一个零拷贝的Linux驱动程序及用户空间接口库，专为Xilinx的AXI DMA和VDMA IP块设计。它作为处理系统与FPGA可编程逻辑之间的桥梁，通过Zynq处理器系统的其中一个DMA端口进行通信。项目遵循MIT许可证，并旨在让Linux用户空间应用程序能够与FPGA内的硬件互动，简化DMA事务设置的复杂性。

主要编程语言: C/C++

关键技术和框架

• 零拷贝传输: 实现高效的数据传递，减少CPU干预。
• AXI DMA与VDMA支持: 支持Xilinx的高性能DMA和视频DMA IP块。
• 连续物理内存分配: 利用内核的连续内存分配器(CMA)，优化DMA数据传输。
• DMA缓冲区共享与异步处理: 支持多进程访问独立DMA引擎（需特定分支）。

安装和配置步骤

准备工作

1. 环境需求: 确保你的系统安装了Linux内核开发者工具链，包括gcc, make, 和内核头文件。
2. Git客户端: 需要安装Git用于从GitHub克隆代码。
3. PetaLinux或相应Xilinx SDK: 对于硬件开发和设备树修改可能需要。
4. 设备树(DTBO): 根据你的硬件配置调整。

克隆项目

打开终端，运行以下命令以克隆项目仓库到本地：

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

编译驱动

1. 检查和配置内核: 确认你的内核配置已启用以下选项：

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

   如果需要，使用make menuconfig进行调整。

2. 编译驱动:

   • 设置交叉编译前缀(如果在目标架构上编译)，否则跳过此步骤。

   export CROSS_COMPILE=your_cross_compile_prefix-
   

   • 运行Makefile编译驱动。

   make
   

设备树修改

• 在你的硬件设备树中添加一个符合“xlnx,axidma-chrdev”兼容性的节点，正确指定dmas属性指向你的AXI DMA或VDMA设备。

加载驱动

将编译好的模块加载到内核中：

sudo insmod axidma.ko

测试与验证

• 使用提供的示例程序测试驱动功能，如make run_tests（确保有相应的权限和依赖项）。

注意事项

• 对于多进程支持，考虑使用@corna的分支，该分支提供了独立DMA引擎的访问。
• 调整CMA大小（如果默认值不足以满足需求），这可能涉及内核参数或设备树更改。

以上步骤应提供足够的指导来安装和配置Xilinx AXI DMA驱动及其相关库，适合初学者至中级用户操作。在实际应用中，根据具体硬件和内核版本可能还需做进一步的定制化调整。

xilinx_axidma A zero-copy Linux driver and a userspace interface library for Xilinx's AXI DMA and VDMA IP blocks. These serve as bridges for communication between the processing system and FPGA programmable logic fabric, through one of the DMA ports on the Zynq processing system. Distributed under the MIT License. 项目地址: https://gitcode.com/gh_mirrors/xil/xilinx_axidma