全志 SDK软件开发资料,H3 DMA接口使用手册

介绍Dmaegine及其接口使用方法,H3 homlet44-dev sdk v1.0及其后续版本。

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. 全志H3循环缓存 
循环模式就是把一块 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: 目的突发长度，取值同上；

参考资料：