深入浅出~Linux设备驱动之DMA

alloc_pages(gfp_mask,order)
返回第一个所分配页框描述符的地址，或者如果分配失败则返回NULL。
__get_free_pages(gfp_mask,order)
类似于alloc_pages()，但它返回第一个所分配页的线性地址。如果需要获得线性地址对应的页框号，那么需要调用virt_to_page(addr)宏产生线性地址。

__free_pages(page,order)
这里主要强调page是要释放缓冲区的线性首地址所在的页框号
free_pages(page,order)
这个函数类似于__free_pages(page,order)，但是它接收的参数为要释放的第一个页框的线性地址addr

typedef struct dma_buf_s {
int size;    /* buffer size：缓冲大小 */
dma_addr_t dma_start;    /* starting DMA address ：缓冲区起始物理地址*/
int ref;    /* number of DMA references 缓冲区起始虚拟地址*/
void *id;    /* to identify buffer from outside 标记 */
int write;    /* 1: buf to write , 0: buf to read DMA读还是写*/
struct dma_buf_s *next;    /* next buf to process 指向下一个缓冲区结构*/
} dma_buf_t;

/* DMA control register structure */
typedef struct {
volatile u_long DISRC;/源地址寄存器
volatile u_long DISRCC;//源控制寄存器
volatile u_long DIDST;//目的寄存器
volatile u_long DIDSTC;//目的控制寄存器
volatile u_long DCON;//DMA控制寄存器
volatile u_long DSTAT;//状态寄存器
volatile u_long DCSRC;//当前源
volatile u_long DCDST;//当前目的
volatile u_long DMASKTRIG;//触发掩码寄存器
} dma_regs_t;

/* DMA device structre */
typedef struct {
dma_callback_t callback;//DMA操作完成后的回调函数，在中断处理例程中调用
u_long dst;//目的寄存器内容
u_long src;//源寄存器内容
u_long ctl;//此设备的控制寄存器内容
u_long dst_ctl;//目的控制寄存器内容
u_long src_ctl;//源控制寄存器内容
} dma_device_t;

/* DMA channel structure */
typedef struct {
dmach_t channel;//通道号：可为0，1，2，3
unsigned int in_use;    /* Device is allocated 设备是否已*/
const char *device_id;    /* Device name 设备名*/
dma_buf_t *head;    /* where to insert buffers 该DMA通道缓冲区链表头*/
dma_buf_t *tail;    /* where to remove buffers该DMA通道缓冲区链表尾*/
dma_buf_t *curr;    /* buffer currently DMA‘ed该DMA通道缓冲区链表中的当前缓冲区*/
unsigned long queue_count;    /* number of buffers in the queue 链表中缓冲区个数*/
int active;    /* 1 if DMA is actually processing data 该通道是否已经在使用*/
dma_regs_t *regs;    /* points to appropriate DMA registers 该通道使用的DMA控制寄存器*/
int irq;    /* IRQ used by the channel //通道申请的中断号*/
dma_device_t write;    /* to write //执行读操作的DMA设备*/
dma_device_t read;    /* to read 执行写操作的DMA设备*/
} s3c2410_dma_t;

int s3c2410_request_dma(const char *device_id, dmach_t channel,
dma_callback_t write_cb, dma_callback_t read_cb) (s3c2410_dma_queue_buffer);

int s3c2410_dma_queue_buffer(dmach_t channel, void *buf_id,
dma_addr_t data, int size, int write) (s3c2410_dma_stop);

int s3c2410_dma_stop(dmach_t channel)

int s3c2410_dma_flush_all(dmach_t channel)

void s3c2410_free_dma(dmach_t channel)