2. Dmaengine 框架

2.1.基本概述 

 Dmaengine 是 linux 内核 dma 驱动框架，针对 DMA 驱动的混乱局面内核社区提出了一个全新的框架驱动，目标在统一 dma API 让各个模块使用 DMA 时不用关心硬件细节，同时代码复用提高。并且实现异步的数据传输，降低机器负载。

2.1.1.术语约定

DMA: Direct Memory Access(直接内存存取)

Channel: DMA 通道

Slave: 从通道，一般指设备通道

Master: 主通道，一般指内存

2.1.2.功能简介

 Dmaengine 向使用者提供统一的接口，不同的模式下使用不同的 DMA 接口，省去使用过多的关注硬件接口。

2.2.基本结构

2.3.模式 

2.3.1. 内存拷贝 

纯粹地内存拷贝，即从指定的源地址拷贝到指定的目的地址。传输完毕会发生一个中断，并调用回函数。

2.3.2. 散列表 

散列模式是把不连续的内存块直接传输到指定的目的地址。当传输完毕会发生一个中断，并调用回调函数。

上述的散列拷贝操作是针对于 Slave 设备而言的，它支持的是 Slave 与 Master 之间的拷贝，还有另一散列拷贝是专门对内存进行操作的，即 Master 与 Master 之间进行操作，具体形式图如下：

2.3.3. 循环缓存 

循环模式就是把一块 Ring buffer 切成若干片，周而复始的传输，每传完一个片会发生一个中断，同时调用回调函数。

3. 接口介绍

3.1.通道相关

struct dma_chan *dma_request_channel(dma_cap_mask_t *mask,

 dma_filter_fn fn, void *fn_param);

功能：申请一个可用通道

参数：mask 所有申请的传输类型的掩码。

fn DMA 驱动私有的过滤函数。

fn_param 传入的私有参数。

返回：返回一个通道数据指针。

void dma_release_channel(struct dma_chan *chan)

功能：释放一个通道

参数：所需要释放的通道指针

3.2.配置相关

int dmaengine_slave_config(struct dma_chan *chan, struct dma_slave_config *config)

功能：配置一个从通道传输

参数：chan 通道结构指针

 config 配置数据指针

返回：非零表示失败，零表示成功

struct dma_slave_config {

enum dma_transfer_direction direction;

dma_addr_t src_addr;

dma_addr_t dst_addr;

enum dma_slave_buswidth src_addr_width;

enum dma_slave_buswidth dst_addr_width;

u32 src_maxburst;

u32 dst_maxburst;

bool device_fc;

unsigned int slave_id;

}

direction: 传输方向，取值 MEM_TO_DEV DEV_TO_MEM MEM_TO_MEM DEV_TO_DEV

src_addr: 源地址，必须是物理地址；

dst_addr: 目的地址，必须是物理地址；

src_addr_width: 源数据宽度，byte 整数倍，取值 1，2，4，8；

dst_addr_width: 目的数据宽度，取值同上；

src_max_burst: 源突发长度，取值 1，4，8；

dst_max_burst: 目的突发长度，取值同上；

slave_id: 从通道 id 号，此处用作 DRQ 的设置，使用 sunxi_slave_id(d, s)宏设置，具体取值参照

include/linux/sunxi-dma.h 里使用；

3.3.传输相关

struct dma_async_tx_descriptor *dmaengine_prep_slave_single(struct dma_chan *chan, 

 dma_addr_t buf, size_t len, enum dma_transfer_direction dir, 

 unsigned long flags)

功能：准备一次单包传输

参数：chan 通道指针；

 buf 需要传输地址；

 dir 传输方向，此处为 DMA_MEM_TO_DEV，DMA_DEV_TO_MEM

 flags 传输标志；

返回：返回一个传输描述符指针。