分享

S3C2410的Linux下DMA驱动程序开发 &SEP4020 DMA驱动编写心得及使用流程

 raymoon_sure 2014-05-15

http://www./Linux/2011-05/36694.htm
网上介绍Linux下的一般驱动程序开发示例浩如烟海,或是因为简单,关于DMA驱动的介绍却寥寥无几;近期因工作需要,花了几日时间开发了某设备在S3C2410处理器Linux下DMA通信的驱动程序,有感于刚接手时无资料借鉴的茫然,故写点介绍,期待能给有DMA开发任务的网友们一点帮助。

本文将包括如下内容:

DMA驱动主要函数功能 
驱动中关键技术分析 
具体的DMA实例分析 
申明:本DMA驱动开发介绍仅适合S3C2410处理器类型,分析源码为韩国MIZI研究中心维护的dma驱动代码: linux/arch/arm/mach-s3c2410/dma.h,linux/arch/arm/mach-s3c2410/dma.c,其它处理器平台DMA开发可比对此文,自行分析。

DMA驱动主要数据结构(linux/arch/arm/mach-s3c2410/dma.h) 
S3C2410有四通道DMA,每通道有9个控制寄存器:6个控制寄存器控制DMA传输,其它3个监视DMA控制器状态。

(1)DMA单个内核缓冲区数据结构:

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;

(2)DMA寄存器数据结构

/* 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;

(3)DMA设备数据结构

/* 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;

(4)DMA通道数据结构

/* 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;

以下分配了四个DMA通道:

s3c2410_dma_t dma_chan[MAX_S3C2410_DMA_CHANNELS];

每个DMA通道维护着一个多缓冲区组成的单链表等待队列,执行DMA操作时先更新DMA通道控制寄存器内容,再依次摘取当前缓冲区投入使用,缓冲区头指针顺次前移;需要插入新的缓冲区时,可从head或tail插入;

DMA驱动主要函数功能分析(linux/arch/arm/mach-s3c2410/dma.c) 
写一个DMA驱动的主要工作包括:DMA通道申请、DMA中断申请、控制寄存器设置、挂入DMA等待队列、清除DMA中断、释放DMA通道。Dma.c中对这些工作作了很好的实现,以下具体分析关键函数:

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

函数描述:申请某通道的DMA资源,填充s3c2410_dma_t 数据结构的内容,申请DMA中断。

输入参数:device_id DMA 设备名;channel 通道号;

write_cb DMA写操作完成的回调函数;read_cb DMA读操作完成的回调函数

输出参数:若channel通道已使用,出错返回;否则,返回0

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

函数描述:这是DMA操作最关键的函数,它完成了一系列动作:分配并初始化一个DMA内核缓冲区控制结构,并将它插入DMA等待队列,设置DMA控制寄存器内容,等待DMA操作触发

输入参数: channel 通道号;buf_id,缓冲区标识

dma_addr_t data DMA数据缓冲区起始物理地址;size DMA数据缓冲区大小;write 是写还是读操作

输出参数:操作成功,返回0;否则,返回错误号

int s3c2410_dma_stop(dmach_t channel) 
函数描述:停止DMA操作。

int s3c2410_dma_flush_all(dmach_t channel) 
函数描述:释放DMA通道所申请的所有内存资源

void s3c2410_free_dma(dmach_t channel) 
函数描述:释放DMA通道

因为各函数功能强大,一个完整的DMA驱动程序中一般只需调用以上3个函数即可。可在驱动初始化中调用s3c2410_request_dma,开始DMA传输前调用s3c2410_dma_queue_buffer,释放驱动模块时调用s3c2410_free_dma。

具体的DMA实例分析 
Linux下的IIS音频驱动主要都在/kernel/drivers/sound/s3c2410-uda1341.c文件中。它定义了2个重要的数据结构audio_bufer_t, 管理audio缓冲区的数据结构;audio_stream_t 管理多缓冲区的数据结构,它为音频流数据组成了一个环形缓冲区。

我们先看一下加载驱动模块时的初始化函数:int __init s3c2410_uda1341_init(void),该函数先初始化IO和UDA341芯片,然后语句s3c2410_request_dma("I2SSDO", s->dma_ch, audio_dmaout_done_callback, NULL);申请了一个DMA通道用于输出音频数据;

smdk2410_audio_write是音频驱动最关键的函数,它从用户进程中拷贝音频数据流至DMA内核缓冲区,然后适用DMA通道2把音频数据发送出去,从而输出声音。我们可以在smdk2410_audio_write 中发现语句s3c2410_dma_queue_buffer(s->dma_ch, (void *) b,b->dma_addr, b->size, DMA_BUF_WR);就是它为DMA写操作作好了一切准备,当I2SSDO中断到来,DMA2通道执行一次写操作(从DMA缓冲写往IO地址0x55000010)。

smdk2410_audio_release函数中先后调用了s3c2410_dma_flush_all、s3c2410_free_dma释放DMA2占用的内存资源、和释放DMA2通道。

后记 
DMA操作直接关系到CPU性能的提升,s3c2410提供了4个DMA通道可实现无约束的系统总线(AHB)或者外设总线之间(APB)的数据传输,功能强大。



SEP4020 DMA驱动编写心得及使用流程
照例,一个驱动写完后要记录点东西,日后有问题绝对是珍贵的参考资料。

前两天看了s3c2410的linux dma驱动,写的很巧妙,我们的SEP4020也有必要编写一个专用的DMA驱动程序。
SEP4020以前的驱动中,在使用DMA时(如nand、iis、sd、usb)都是在驱动中各自配置,一般使用while循环来等待DMA传输完成。
这种方法实现功能没有问题,但是因为一直要等待传输完成,感觉完全没有利用DMA不经过CPU的优点。
专用DMA驱动程序,就是要解决这个问题,实现DMA列队,其他驱动使用DMA时只要调用DMA驱动,将需要发送缓冲区丢入DMA列队,就可以执行其他代码了。

花了几天时间终于按照2410的驱动写完了SEP4020的Linux DMA驱动,记录下SEP4020需要注意的几个问题:
(1)SEP4020有六个DMA通道,但是共用一个中断控制器的中断号(IRQ30),需要在中断处理程序中读取DMA控制器对应的中断位,判断是那个DMA通道引起的中断。
正是因为共用中断,所以前期写的代码各自使用DMA时都没有使用中断,怕驱动之间打架。
也正因为共用中断,注册中断的任务就不再放在request_dma_channel中,而是放在init函数中执行。

(2)s3c2410的DMA有个很好用的功能,可以自动加载,只需要再加载前改写source地址和传输大小即可。
DMA驱动中也使用了自动加载功能,一般在loadbuf函数后DMA即可自动开始下次传输。
SEP4020可没有自动加载buf功能,因此需要手动启动DMA传输。具体的做法实在loadbuf之后执行start函数。
sep4020_dma_loadbuffer(chan, chan->next);
sep4020_dma_ctrl(chan->number, SEP4020_DMAOP_START);

(3)同样是由于没有自动加载功能,SEP4020在DMA传输完成后就自动停止,不需要修改寄存器手动来停止。
所以s3c2410驱动中的dostop函数就没用了。

(4)每次传输开始时要重新写一遍control寄存器,不知道什么原因,configuration寄存器就不需要重写。
也可能我测试的不够,我是用IIS-UDA1341进行测试的,每次启动前要重写一遍control寄存器才能出声音。

(5)DMA使用devconfig函数进行配置,config函数没有使用。需要配置内容如下:
A source是硬件还是memory
B dest地址
C contorl寄存器
D configuration寄存器(不启动)

(6)DMA start函数的作用实际就是将对应通道的configuration寄存器的最后一位置1,启动传输。

(7)2410在传输时如果load状态处于loaded_running时,需要等待传输完成再load缓冲区。
SEP4020传输完成后直接进中断,并清除了传输完成位,所以无法判断。
我将相关超时等待函数注释掉,暂时没有发现问题,可能还需要全面考虑。

好,就记录以上几点,状态机使用s3c2410的,没有改变。
这个DMA驱动终于可以实现IIS播放MP3直接从nand上读取数据,不会再卡了!

当然DMA驱动程序还存在一定局限性:只能实现硬件到内存或者内存到硬件的传输,也就是启动一个地址是固定的,另外一个地址不断变化。

=======================================================
附录:SEP4020 DMA驱动使用流程(以IIS为例)

1)初始化结构体成员
static struct sep4020_dma_client sep4020_uda1341 =
{
    .name = "sep4020_uda1341",
};

2)完成回调函数(参考)
static void uda1341_dma_done_callback(sep4020_dma_chan_t *ch, void *buf, int size,sep4020_dma_buffresult_t result)
{
   printk("uda1341_dma_done_callback\n");
   audio_buf_t *b = (audio_buf_t *) buf;
   up(&b->sem);
   wake_up(&b->sem.wait);
}

3)初始化IIS驱动时,申请DMA通道
sep4020_dma_request(CHANNEL1, &sep4020_uda1341, NULL);

4)设置DMA传输完成回调函数
sep4020_dma_set_buffdone_fn(CHANNEL1, uda1341_dma_done_callback);

5)配置DMA通道参数
sep4020_dma_setflags(CHANNEL1, SEP4020_DMAF_AUTOSTART);//这个函数基本没用了
sep4020_dma_devconfig(CHANNEL1, SEP4020_DMASRC_MEM, destadd, ctrl, conf);
稍微解释下:
SEP4020_DMASRC_MEM:说明source是memory
destadd:既然source定了,传入dest的地址
ctrl:控制寄存器
conf:配置寄存器
寄存器请参考SEP4020数据手册

6)建立buf缓冲区,可以参考uda1341驱动中的audio_setup_buf函数
dmabuf = dma_alloc_coherent(NULL, dmasize, &dmaphys, GFP_KERNEL|GFP_DMA);
关键在与使用dma_alloc_coherent申请连续空间(不会被cache),获取虚拟地址及物理地址,DMA寄存器需要赋值物理地址。

7)发起DMA传输
sep4020_dma_enqueue(CHANNEL1, (void *) b, b->dma_addr, b-size);
其中b是缓冲区,b->dma_addr是物理地址,b->size是大小(暂时没有实现,大小在devconfig函数配置)


    本站是提供个人知识管理的网络存储空间,所有内容均由用户发布,不代表本站观点。请注意甄别内容中的联系方式、诱导购买等信息,谨防诈骗。如发现有害或侵权内容,请点击一键举报。
    转藏 分享 献花(0

    0条评论

    发表

    请遵守用户 评论公约

    类似文章 更多