dma子系统　dmac

DMA子是CPU中实现数据传输的一种方式,CPU配置好DMA控制器之后发起数据传输，CPU本身不参与数据传输的动作中去。

DMA种类：
分为外设DMA和DMA控制器。其中外设DMA实现的为特定的外设与内存之间的数据传输，一般是外设向RAM单向传输数据。而DMA控制器则可以实现任意外设与内存之间的数据传输。此时外设跟CPU控制器之间通过流控制信号来保证传输通道的正常运行。

DMA传输的数据宽度不固定。

还可以实现任意长度的burst 操作。burst是DMA控制地址总线自行改变。

DMA也支持分散集合模式，即内存中数据并非连续，而是分配在多个块中，块大小也不一样，这时候DMA可以根据Scatter Gather Descriptors来进行DMA数据传输。

Descriptors是一个单向列表，描述了每块数据的位置和大小还有其他配置。DMA自行解析Descriptors的内容进行数据传输并寻找小一个链表节点，

如果Descriptor 链表是一个循环链接，则传输被叫做环形传输（Cyclic Transfers）。

linux实现了DMA框架，叫做DMA Engine,内核驱动开发者必须按照固定的流程编码才能正确的使用DMA。DMA Engine提供出来了Slave API供其它内核调用。这些API实现了复杂的scatter gather 传输模式，通过这些API实现DMA传输的驱动被叫做DMA client.

DMA中调用API的顺序为：

DMA通道申请

DMA client的第一步就是要申请DMA 通道，有的DMA client 可能需要申请特殊的通道，而有的DMA client可以申请任意可用的通道。通道申请的API为dma_request_channel 或者他的某一变形API。

struct dma_chan *dma_request_channel(dma_cap_mask_t mask, dma_filter_fn filter_fn, void *filter_param);

其中dma_cap_mask_t是根据dma_cap_sets指定的DMA传输类型。
如：

    dma_cap_mask_t mask;dma_cap_zero(mask);dma_cap_set(DMA_MEMCPY,mask);dma_chan1 = dma_request_channel(mask,0,NULL);

而传输类型具体列为：

enum dma_transaction_type {DMA_MEMCPY,DMA_XOR,DMA_PQ,DMA_XOR_VAL,DMA_PQ_VAL,DMA_MEMSET,DMA_INTERRUPT,DMA_SG,DMA_PRIVATE,DMA_ASYNC_TX,DMA_SLAVE,DMA_CYCLIC,DMA_INTERLEAVE,/* last transaction type for creation of the capabilities mask */DMA_TX_TYPE_END,};

配置DMA通道

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

获取一个传输描述符

dmaengine_prep_slave_single()

提交传输到挂起队列

dmaengine_submit

发起传输申请

dmaengine_issue_pending调用会从第一个描述符开始进行传输。如果DMA client 驱动有回调函数的话，会在传输完成后执行。

一个简单的DMA传输案例:

#include <linux/module.h>
#include <linux/kernel.h>    /* printk() */
#include <linux/moduleparam.h>
#include <asm/uaccess.h>
#include <asm/pgtable.h>
#include <linux/fs.h>
#include <linux/gfp.h>
#include <linux/cdev.h>
#include <linux/sched.h>
#include <linux/interrupt.h>
#include <linux/mm.h>
#include <linux/kdev_t.h>
#include <linux/proc_fs.h>
#include <linux/ioctl.h>
#include <linux/slab.h>
#include <linux/mempool.h>
#include <linux/mm.h>
#include <linux/device.h>
#include <linux/kobject.h>
#include <linux/sysfs.h>
#include <linux/dma-mapping.h>
#include <linux/dmaengine.h>
#include <asm/types.h>
#include <asm/io.h>
#include <asm/dma-mapping.h>#define DEST_ADDRESS 0x73800000
#define SRC_ADDRESS   0x10400000static volatile struct completion comp1;
static volatile struct dma_chan *dma_chan1;static int device_mmap(struct file *file,struct vm_area_struct* vma)
{int size;printk("mmap fpga\n");size=vma->vm_end - vma->vm_start;if(remap_pfn_range(vma,vma->vm_start,DEST_ADDRESS>>PAGE_SHIFT,0x800000,vma->vm_page_prot))return -EAGAIN;return 0;
}
static void dma_complete_func(void *completion)
{complete(completion);
}struct dma_async_tx_descriptor *tx1 = NULL;static int device_ioctl(struct inode *inode,struct file *file,int num,int param)
{struct dma_device *dma_dev;enum dma_ctrl_flags flags;dma_cookie_t cookie;dma_dev = dma_chan1->device;flags =  DMA_CTRL_ACK | DMA_COMPL_SKIP_DEST_UNMAP | DMA_COMPL_SKIP_SRC_UNMAP;tx1 = dma_dev->device_prep_dma_memcpy(dma_chan1, DEST_ADDRESS,SRC_ADDRESS+0x40000*param, 0x40000, flags);if (!tx1) {printk("Failed to prepare DMA memcpy\n");return -1;}init_completion(&comp1);tx1->callback = dma_complete_func;tx1->callback_param = &comp1;cookie = tx1->tx_submit(tx1);if (dma_submit_error(cookie)) {printk("Failed to do DMA tx_submit\n");return -1;}dma_async_issue_pending(dma_chan1);wait_for_completion(&comp1);
}static struct file_operations fpga_fops =
{.owner = THIS_MODULE,.mmap = device_mmap,.ioctl = device_ioctl,
};static int __init hello_init (void)
{dev_t fpga_dev;struct cdev *fpga_cdev;struct device *dev;dma_addr_t dm;dma_cap_mask_t mask;dma_cap_zero(mask);dma_cap_set(DMA_MEMCPY,mask);dma_chan1 = dma_request_channel(mask,0,NULL);if(dma_chan1 == 0){printk("fpga:failed to request DMA channel\n");}if(register_chrdev_region(MKDEV(200,0),1,"fpga")){printk (KERN_INFO "alloc chrdev error.\n");return -1;}fpga_cdev=cdev_alloc();if(!fpga_cdev){printk (KERN_INFO "cdev alloc error.\n");return -1;}fpga_cdev->ops = &fpga_fops;fpga_cdev->owner = THIS_MODULE;if(cdev_add(fpga_cdev,MKDEV(200,0),1)){printk (KERN_INFO "cdev add error.\n");return -1;}printk("fpga driver loaded\n");return 0;}late_initcall(hello_init);
MODULE_LICENSE("GPL");