S3C2440上ADC驱动实例开发讲解

 

一、开发环境

• 主  机：VMWare--Fedora 9
• 开发板：Mini2440--64MB Nand, Kernel:2.6.30.4
• 编译器：arm-linux-gcc-4.3.2

二、硬件原理分析
                               S3C2440内部ADC结构图

我们从上面的结构图和数据手册可以知道，该ADC模块总共有8个通道可以进行模拟信号的输入，分别是AIN0、AIN1、AIN2、AIN3、YM、YP、XM、XP。那么ADC是怎么实现模拟信号到数字信号的转换呢？首先模拟信号从任一通道输入，然后设定寄存器中预分频器的值来确定AD转换器频率，最后ADC将模拟信号转换为数字信号保存到ADC数据寄存器0中(ADCDAT0)，然后ADCDAT0中的数据可以通过中断或查询的方式来访问。对于ADC的各寄存器的操作和注意事项请参阅数据手册。

上图是mini2440上的ADC应用实例，开发板通过一个10K的电位器(可变电阻)来产生电压模拟信号，然后通过第一个通道(即：AIN0)将模拟信号输入ADC。

三、实现步骤

ADC设备在Linux中可以看做是简单的字符设备，也可以当做是一混杂设备(misc设备)，这里我们就看做是misc设备来实现ADC的驱动。注意：这里我们获取AD转换后的数据将采用中断的方式，即当AD转换完成后产生AD中断，在中断服务程序中来读取ADCDAT0的第0-9位的值(即AD转换后的值)。

1、建立驱动程序文件my2440_adc.c，实现驱动的初始化和退出，代码如下：

#include <linux/errno.h> #include <linux/kernel.h> #include <linux/module.h> #include <linux/init.h> #include <linux/input.h> #include <linux/serio.h> #include <linux/clk.h> #include <linux/miscdevice.h> #include <asm/io.h> #include <asm/irq.h> #include <asm/uaccess.h> /*定义了一个用来保存经过虚拟映射后的内存地址*/ static void __iomem *adc_base; /*保存从平台时钟队列中获取ADC的时钟*/ static struct clk *adc_clk; /*申明并初始化一个信号量ADC_LOCK，对ADC资源进行互斥访问*/ DECLARE_MUTEX(ADC_LOCK); static int __init adc_init(void) {     int ret;     /*从平台时钟队列中获取ADC的时钟，这里为什么要取得这个时钟，因为ADC的转换频率跟时钟有关。     系统的一些时钟定义在arch/arm/plat-s3c24xx/s3c2410-clock.c中*/     adc_clk = clk_get(NULL, "adc");     if (!adc_clk)     {         /*错误处理*/         printk(KERN_ERR "failed to find adc clock source\n");         return -ENOENT;     }     /*时钟获取后要使能后才可以使用，clk_enable定义在arch/arm/plat-s3c/clock.c中*/     clk_enable(adc_clk);     /*将ADC的IO端口占用的这段IO空间映射到内存的虚拟地址，ioremap定义在io.h中。      注意：IO空间要映射后才能使用，以后对虚拟地址的操作就是对IO空间的操作,      S3C2410_PA_ADC是ADC控制器的基地址，定义在mach-s3c2410/include/mach/map.h中，0x20是虚拟地址长度大小*/     adc_base = ioremap(S3C2410_PA_ADC, 0x20);     if (adc_base == NULL)     {         /*错误处理*/         printk(KERN_ERR "Failed to remap register block\n");         ret = -EINVAL;         goto err_noclk;     }     /*把看ADC注册成为misc设备，misc_register定义在miscdevice.h中      adc_miscdev结构体定义及内部接口函数在第②步中讲,MISC_DYNAMIC_MINOR是次设备号，定义在miscdevice.h中*/     ret = misc_register(&adc_miscdev);     if (ret)     {         /*错误处理*/         printk(KERN_ERR "cannot register miscdev on minor=%d (%d)\n", MISC_DYNAMIC_MINOR, ret);         goto err_nomap;     }     printk(DEVICE_NAME " initialized!\n");     return 0; //以下是上面错误处理的跳转点 err_noclk:     clk_disable(adc_clk);     clk_put(adc_clk); err_nomap:     iounmap(adc_base);     return ret; } static void __exit adc_exit(void) {     free_irq(IRQ_ADC, 1);    /*释放中断*/     iounmap(adc_base);       /*释放虚拟地址映射空间*/     if (adc_clk)             /*屏蔽和销毁时钟*/     {         clk_disable(adc_clk);             clk_put(adc_clk);         adc_clk = NULL;     }     misc_deregister(&adc_miscdev);/*注销misc设备*/ } /*导出信号量ADC_LOCK在触摸屏驱动中使用，因为触摸屏驱动和ADC驱动公用   相关的寄存器，为了不产生资源竞态，就用信号量来保证资源的互斥访问*/ EXPORT_SYMBOL(ADC_LOCK); module_init(adc_init); module_exit(adc_exit); MODULE_LICENSE("GPL"); MODULE_AUTHOR("Huang Gang"); MODULE_DESCRIPTION("My2440 ADC Driver");DE>

2、adc_miscdev结构体定义及内部各接口函数的实现，代码如下：

#include <plat/regs-adc.h> /*设备名称*/ #define DEVICE_NAME    "my2440_adc" /*定义并初始化一个等待队列adc_waitq，对ADC资源进行阻塞访问*/ static DECLARE_WAIT_QUEUE_HEAD(adc_waitq); /*用于标识AD转换后的数据是否可以读取，0表示不可读取*/ static volatile int ev_adc = 0; /*用于保存读取的AD转换后的值，该值在ADC中断中读取*/ static int adc_data; /*misc设备结构体实现*/ static struct miscdevice adc_miscdev = {     .minor   = MISC_DYNAMIC_MINOR, /*次设备号，定义在miscdevice.h中，为255*/     .name    = DEVICE_NAME,        /*设备名称*/     .fops    = &adc_fops,          /*对ADC设备文件操作*/ }; /*字符设备的相关操作实现*/ static struct file_operations adc_fops = {     .owner    = THIS_MODULE,     .open     = adc_open,     .read     = adc_read,         .release  = adc_release, }; /*ADC设备驱动的打开接口函数*/ static int adc_open(struct inode *inode, struct file *file) {     int ret;     /*申请ADC中断服务，这里使用的是共享中断:IRQF_SHARED,为什么要使用共享中断，因为在触摸屏驱动中      也使用了这个中断号。中断服务程序为:adc_irq在下面实现，IRQ_ADC是ADC的中断号，这里注意：      申请中断函数的最后一个参数一定不能为NULL，否则中断申请会失败，如果中断服务程序中用不到这个      参数，就随便给个值就好了，我这里就给个1*/     ret = request_irq(IRQ_ADC, adc_irq, IRQF_SHARED, DEVICE_NAME, 1);     if (ret)     {         /*错误处理*/         printk(KERN_ERR "IRQ%d error %d\n", IRQ_ADC, ret);         return -EINVAL;     }     return 0; } /*ADC中断服务程序，该服务程序主要是从ADC数据寄存器中读取AD转换后的值*/ static irqreturn_t adc_irq(int irq, void *dev_id) {     /*保证了应用程序读取一次这里就读取AD转换的值一次，      避免应用程序读取一次后发生多次中断多次读取AD转换值*/     if(!ev_adc)     {         /*读取AD转换后的值保存到全局变量adc_data中，S3C2410_ADCDAT0定义在regs-adc.h中，          这里为什么要与上一个0x3ff，很简单，因为AD转换后的数据是保存在ADCDAT0的第0-9位，          所以与上0x3ff(即：1111111111)后就得到第0-9位的数据，多余的位就都为0*/         adc_data = readl(adc_base + S3C2410_ADCDAT0) & 0x3ff;         /*将可读标识为1，并唤醒等待队列*/         ev_adc = 1;         wake_up_interruptible(&adc_waitq);     }     return IRQ_HANDLED; } /*ADC设备驱动的读接口函数*/ static ssize_t adc_read(struct file *filp, char *buffer, size_t count, loff_t *ppos) {     /*试着获取信号量(即：加锁)*/     if (down_trylock(&ADC_LOCK))     {         return -EBUSY;     }     if(!ev_adc)/*表示还没有AD转换后的数据，不可读取*/     {         if(filp->f_flags & O_NONBLOCK)         {             /*应用程序若采用非阻塞方式读取则返回错误*/             return -EAGAIN;         }         else/*以阻塞方式进行读取*/         {             /*设置ADC控制寄存器，开启AD转换*/             start_adc();             /*使等待队列进入睡眠*/             wait_event_interruptible(adc_waitq, ev_adc);         }     }     /*能到这里就表示已有AD转换后的数据，则标识清0，给下一次读做判断用*/     ev_adc = 0;     /*将读取到的AD转换后的值发往到上层应用程序*/     copy_to_user(buffer, (char *)&adc_data, sizeof(adc_data));     /*释放获取的信号量(即：解锁)*/     up(&ADC_LOCK);     return sizeof(adc_data); } /*设置ADC控制寄存器，开启AD转换*/ static void start_adc(void) {     unsigned int tmp;     tmp = (1 << 14) | (255 << 6) | (0 << 3);/* 0 1 00000011 000 0 0 0 */     writel(tmp, adc_base + S3C2410_ADCCON); /*AD预分频器使能、模拟输入通道设为AIN0*/     tmp = readl(adc_base + S3C2410_ADCCON);     tmp = tmp | (1 << 0);                 /* 0 1 00000011 000 0 0 1 */     writel(tmp, adc_base + S3C2410_ADCCON); /*AD转换开始*/ } /*ADC设备驱动的关闭接口函数*/ static int adc_release(struct inode *inode, struct file *filp) {     return 0; }

注意：在上面实现的每步中，为了让代码逻辑更加有条理和容易理解，就没有考虑代码的顺序，比如函数要先定义后调用。如果要编译此代码，请严格按照C语言的规范来调整代码的顺序。

3、编写用户应用程序测试my2440_adc驱动。建立应用程序adc_test.c，代码如下：

#include <stdio.h> #include <stdlib.h> #include <errno.h> int main(int argc, char **argv) {     int fd;     //以阻塞方式打开设备文件，非阻塞时flags=O_NONBLOCK     fd = open("/dev/my2440_adc", 0);     if(fd < 0)     {         printf("Open ADC Device Faild!\n");         exit(1);     }     while(1)     {         int ret;         int data;                  //读设备         ret = read(fd, &data, sizeof(data));         if(ret != sizeof(data))         {             if(errno != EAGAIN)             {                 printf("Read ADC Device Faild!\n");             }             continue;         }         else         {             printf("Read ADC value is: %d\n", data);         }     }     close(fd);     return 0; }

4、将驱动程序下载挂载到内核，下载应用程序到开发板上后，运行应用程序，扭动mini2440开发板上的定位器，可以观察到ADC转换值的变化，证明驱动程序工作正常。效果图如下：