Linux 驱动之DMA 子系统

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   0x10400000

static 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");