linux input输入子系统分析《二》：s3c2440的ADC简单驱动实例分析

主要讲述本人在学习Linux内核input子系统的全部过程，如有分析不当，多谢指正。以下交流方式，文章欢迎转载，保留联系信息，以便交流。

邮箱：eabi010@gmail.com

主页：www.ielife.cn（爱嵌论坛——嵌入式技术学习交流）

博客：blog.csdn.net/ielife

1 mini2440的ADC驱动实例

这节与输入子系统无关，出现在这里是因为后面的章节会讲到触摸屏输入子系统驱动，由于触摸屏也使用ADC，因此本节是为了说明ADC通过驱动代码是如何控制的。

本节重点：

如何通过原理图查找ADC硬件使用的资源
如何通过芯片手册查找ADC硬件的操作方法
ADC设备驱动程序的初始化流程
ADC设备驱动程序的中断处理流程

本节难点：

ADC的控制寄存器的操作方法
ADC驱动程序的控制逻辑

1.1 模数转换（ADC）简介

ADC是把模拟信号转化为计算机能够处理的数字信号的过程。

模拟信号一般为电压，或者是电流。有些时候也可以是非电信号，如温度、湿度、声音、位移等，它们通过传感器转换为电压信号传递给A/D转换器才可以进行A/D转换。

1.2 mini2440上的可调电阻

由mini2440的用户手册的1.3.8节A/D输入测试可知，S3C2440的AIN0引脚接到了开发板的可调电阻W1上，原理图如下图3所示：

图3 mini2440可调电阻原理图

上图中，1、2电路的状态是能够确定的，一个接3.3V电压，一个接地，中间接可变电阻W1（10K）。而引脚3接AIN0，它是什么？可以通过mini2440开发板原理图来查找：

图4 mini2440可调电阻与S3C2440接口电路

通过上图可知，开发板的AIN0引脚与S3C2440 CPU芯片上的AIN0引脚相连接。因此需要进一步查看S3C2440芯片手册获得AIN0引脚的作用。

下图5是S3C2440芯片手册的第16章对A/D转换器和触摸屏接口的介绍。S3C2440内部共有8个通道的模拟输入接口，其转换的模拟信号为10位的二进制数字编码。

A[3:0]分别代表AIN0、AIN1、AIN2、AIN3，触摸屏接口可以控制/选择触摸屏X、Y方向的引脚（XP，XM，YP，YM）的变换。

图5 A/D转换器和触摸屏的功能结构图

那么ADC如何实现模拟信号到数字信号的转换呢，由上图可知，模拟信号通过8个通道的任意一个输入，然后通过分频器决定A/D转换器的频率，最后通过ADC将模拟信号转换为数字信号保存在ADCDAT0中，ADCDAT0中的数据可以通过查询或者中断的方式来获得。

S3C2440模数转换器的控制逻辑可由以下寄存器来进行操作：

ADCCON ADC控制寄存器

ADCTSC ADC触摸屏控制寄存器器

ADCDLY ADC启动初始化延迟寄存器

ADCDAT0 ADC转换数据寄存器

ADCDAT1 ADC转换数据寄存器

ADCUPDN 笔尖抬起或落下中断状态寄存器

由以上内容，开发板可以通过W1可变电阻的阻值变化产生电压的变化，由AIN0引脚传递给ADC控制器转化为数字信号，我们通过驱动来获得可调电阻W1硬件的变化。

1.3 可调电阻的ADC驱动程序

既然需要写驱动，首先先确定可调电阻的ADC驱动属于什么设备。由于是顺序读取寄存器ADCDAT0的过程，所以把它看成一个字符设备，而且对于这个设备来说，更简单的实现方法是通过misc杂项设备来实现。

代码实现的非常简单，通过中断的方式获取ADCDAT0的前10位的值就可以了。代码如下：

[cpp]view plaincopy 
   
 /* 
  * mini2440 ADC驱动程序 
  * 
  * Kevin Lee <www.ielife.cn> 
  */  
    
 #include<linux/kernel.h> /* 提供prink等内核特有属性 */  
 #include<linux/module.h> /* 提供如MODULE_LICENSE()、EXPORT_SYMBOL() */  
 #include<linux/init.h> /* 设置段，如_init、_exit，设置初始化优先级，如__initcall */  
 #include<linux/wait.h> /* 等待队列wait_queue */  
 #include<linux/interrupt.h> /* 中断方式，如IRQF_SHARED */  
 #include<linux/fs.h> /* file_operations操作接口等 */  
 #include<linux/clk.h> /* 时钟控制接口，如struct clk */  
 #include<linux/miscdevice.h> /* 杂项设备 */  
 #include<asm/io.h> /* 提供readl、writel */  
 #include<asm/irq.h> /* 提供中断号，中断类型等，如IRQ_ADC中断号 */  
 #include<asm/arch/regs-adc.h> /* 提供控制器的寄存器操作，如S3C2410_ADCCON */  
 #include<asm/uaccess.h> /* 提供copy_to_user等存储接口 */  
    
 /* 定义设备名称，用户访问接口/dev/adc */  
 #defineDEVICE_NAME "adc"  
    
 /* 定义adc时钟，通过adc_clock接口获得adc输入时钟，adc转换器需要 */  
 staticstruct clk *adc_clock;  
    
 /* 定义虚拟地址访问硬件寄存器，__iomem只是用于表示指针将指向I/O内存 */  
 staticvoid __iomem *base_addr;  
    
 /* 定义并初始化一个等待队列adc_waitqueue，对ADC资源进行阻塞访问 */  
 staticwait_queue_head_t adc_waitqueue;  
    
 /* 定义并初始化信号量adc_lock，用于控制共享中断IRQ_ADC资源的使用 */  
 DECLARE_MUTEX(adc_lock);  
 EXPORT_SYMBOL(adc_lock);  
    
 /* 定义等待队列的条件，当is_read_ok=1时，ADC转换完毕，数据可读 */  
 staticvolatile int is_read_ok = 0;  
    
 /* 定义ADC转换的数据内容 */  
 staticvolatile int adc_data;  
    
 staticint adc_open(struct inode *inode, struct file *file);  
 staticssize_t adc_read(struct file *filp, char *buffer, size_t count, loff_t *ppos);  
 staticint adc_close(struct inode *inode, struct file *filp);  
    
 /* 实现字符设备操作接口 */  
 staticstruct file_operations adc_fops =  
 {  
     .owner   = THIS_MODULE,  
     .open    = adc_open,  
     .read    = adc_read,     
     .release = adc_close,  
 };  
    
 /* 实现misc杂项设备操作接口 */  
 staticstruct miscdevice adc_miscdev =  
 {  
     .minor  = MISC_DYNAMIC_MINOR, /* 动态获取杂项设备的次设备号 */  
     .name   = DEVICE_NAME,        /* 杂项设备的设备名称，这里为adc */  
     .fops   = &adc_fops,          /* 杂项设备子系统接口，指向adc_fops操作接口 */  
 };  
    
 /*ADC中断服务程序，获取ADC转换后的数据 */  
 staticirqreturn_t adc_irq(int irq, void *dev_id)  
 {  
     /* 仅当is_read_ok=0时才进行转换，防止多次中断 */  
     if(!is_read_ok)  
     {  
         /* 读取ADCCON[9:0]的值，0x3ff为只获取[9:0]位，ADCCON为转换后的数据 */  
         adc_data = readl(base_addr +S3C2410_ADCDAT0) & 0x3ff;  
    
         /* 设置标识为1，唤醒读等待进程可以拷贝数据给用户空间了 */  
         is_read_ok = 1;  
        wake_up_interruptible(&adc_waitqueue);  
     }  
    
     return IRQ_RETVAL(IRQ_HANDLED);  
 }  
    
 /*ADC设备打开，并注册IRQ_ADC中断处理函数 */  
 staticint adc_open(struct inode *inode, struct file *file)  
 {  
     int ret;  
    
     /* 由于IRQ_ADC为共享中断，因此中断类型选择IRQF_SHARED，最后一个参数需要设置NULL以外的值 */  
     ret = request_irq(IRQ_ADC, adc_irq,IRQF_SHARED, DEVICE_NAME, (void *)1);  
     if (ret)  
     {  
         printk(KERN_ERR "Could notallocate ts IRQ_ADC !\n");  
         return -EBUSY;  
     }  
    
     return 0;  
 }  
    
 /*设置ADC控制寄存器，开启AD转换*/  
 staticvoid adc_run(void)  
 {  
     volatile unsigned int adccon;  
      
     /* ADCCON的位[14]=1为使能A/D预分频器，位[13:6]=32表示设置的分频值，ADC的转换频率需要在2.5MHZ以下 
      * 我们使用的ADC输入时钟为PCLK=50MHZ，50MHZ/32<2.5MHZ，满足条件 
      * 位[5:3]=000，表示模拟输入通道选择AIN0 
      */  
     adccon = (1 << 14) | (32 << 6);  
     writel(adccon, base_addr + S3C2410_ADCCON);  
      
     /* 位[0]=1表示使能ADC转换，当转换完毕后此位被ADC控制器自动清0 */  
     adccon = readl(base_addr + S3C2410_ADCCON)| (1 << 0);  
     writel(adccon, base_addr + S3C2410_ADCCON);  
 }  
    
 /*ADC设备驱动读函数 */  
 staticssize_t adc_read(struct file *filp, char *buff, size_t count, loff_t *offp)  
 {  
     int err;  
    
     /* 获取信号量，如果被占用，睡眠等待持有者调用up唤醒 
      * 这样做的原因是，有可能其他进程抢占执行或是触摸屏驱动抢占执行 
      */  
     down_interruptible(&adc_lock);  
    
     /* 启动adc转换，调用中断处理函数adc_irq*/  
     adc_run();  
    
     /* 如果is_read_ok为假，则睡眠等待条件为真，由中断处理函数唤醒 */  
     wait_event_interruptible(adc_waitqueue,is_read_ok);  
    
     /* 执行到此说明中断处理程序获得了ADC转换后的值，清除为0等待下一次的读 */  
     is_read_ok = 0;  
    
     /* 将转换后的数据adc_data提交给用户 */  
     err = copy_to_user(buff, (char*)&adc_data, min(sizeof(adc_data),count));  
    
     /* 释放信号量，并唤醒因adc_lock而睡眠的进程 */  
     up(&adc_lock);  
    
     return err ? -EFAULT : sizeof(adc_data);  
 }  
    
 /*ADC设备关闭函数 */  
 staticint adc_close(struct inode *inode, struct file *filp)  
 {  
     /*释放中断*/  
     free_irq(IRQ_ADC, (void *)1);     
     return 0;  
 }  
    
 staticint __init adc_init(void)  
 {  
     int ret;  
    
     /* 获得adc的时钟源，通过arch/arm/mach-s3c2410/clock.c获得提供的时钟源为PCLK */  
     adc_clock = clk_get(NULL, "adc");  
     if (!adc_clock)  
     {  
         printk(KERN_ERR "failed to get adcclock source\n");  
         return -ENOENT;  
     }  
    
     /* 在时钟控制器中给adc提供输入时钟，ADC转换需要输入时钟 */  
     clk_enable(adc_clock);  
    
     /* 使用ioremap获得操作ADC控制器的虚拟地址 
      * S3C2410_PA_ADC=ADCCON，是ADC控制器的基地址，寄存器组的长度=0x1c 
      */  
     base_addr = ioremap(S3C2410_PA_ADC, 0x1c);  
     if (base_addr == NULL)  
     {  
         printk(KERN_ERR "Failed to remapregister block\n");  
         return -ENOMEM;  
         goto fail1;  
     }  
      
     /* 初始化等待队列 */  
     init_waitqueue_head(&adc_waitqueue);  
    
     /* 注册杂项设备 */  
     ret = misc_register(&adc_miscdev);  
     if (ret)  
     {  
         printk(KERN_ERR "Failed toregister miscdev\n");  
         goto fail2;  
     }  
    
     printk(DEVICE_NAME "initialized!\n");  
    
     return 0;  
      
 fail2:  
     iounmap(base_addr);  
 fail1:  
     clk_disable(adc_clock);  
     clk_put(adc_clock);  
    
     return ret;  
 }  
    
 staticvoid __exit adc_exit(void)  
 {  
     /* 释放虚拟地址 */  
     iounmap(base_addr);  
    
     /* 禁止ADC的时钟源 */  
     if (adc_clock)              
     {  
         clk_disable(adc_clock);  
         clk_put(adc_clock);  
         adc_clock = NULL;  
     }  
    
     /*注销misc设备*/  
     misc_deregister(&adc_miscdev);  
 }  
    
 module_init(adc_init);  
 module_exit(adc_exit);  
    
 MODULE_AUTHOR("KevinLee <www.ielife.cn>");  
 MODULE_DESCRIPTION("Mini2440ADC Misc Device Driver");  
 MODULE_VERSION("MINI2440ADC 1.0");  
 MODULE_LICENSE("GPL");  

由于驱动程序不同于应用程序main函数，因此读者观看以上程序的顺序应该如下所示：

首先执行的代码是__init adc_init函数，它会被insmod加载进内核，当然也可以在内核初始化的时候加载，加载成功，应用层访问接口“/dev/adc”被创建；

其次，由于应用层会首先打开“/dev/adc”设备，进而操作ADC设备，因此需要查看adc_open函数做了什么。由于打开设备意味着要使用设备，所以在adc_open中注册IRQ_ADC中断资源；

最后，用户会调用read函数读取ADC转换的值，会调用到adc_read。因此，在adc_read函数中需要设置好AIN0引脚的模拟输入，并启动ADC，把读取的任务交给adc_irq函数去完成，最后由adc_read函数把数据提交给应用层。

如果使用insmod的方式加载，需要编写Makefile函数，如下：

[cpp]view plaincopy 
   
 MODULENAME:= adc.o  
    
 ifneq($(KERNELRELEASE),)  
 #call from kernel build system  
 obj-m      := $(MODULENAME)  
    
 else  
 #KERNELDIR?= /lib/modules/$(shell uname -r)/build  
 KERNELDIR?= /work/system/linux-2.6.22.6  
 PWD       := $(shell pwd)  
 default:  
        $(MAKE) -C $(KERNELDIR) M=$(PWD) modules  
 endif  
    
 clean:  
        rm -rf *.o *~ core .depend .*.cmd *.ko*.mod.c .tmp_versions module* Module* $(APPNAME)  
    
 depend.depend dep:  
        $(CC) $(CFLAGS) -M *.c > .depend  
    
 ifeq(.depend,$(wildcard .depend))  
 include.depend  
 endif  

adc.c与Makefile文件放在同一目录下，执行make就可以了。Makefile中使用的编译器的名称为arm-linux-gcc，根据自己的情况修改即可。

编译成功，在当前目录下得到adc.ko驱动模块，使用命令modinfo adc.ko，获取信息如下：

stu@stu-desktop:adc$modinfo adc.ko

filename: adc.ko

license: GPL

version: MINI2440 ADC 1.0

description: Mini2440 ADC Misc Device Driver

author: Kevin Lee <www.ielife.cn>

srcversion: 901D02B007F9D53D9C54EA3

depends: built-in,built-in,built-in,built-in,built-in

vermagic: 2.6.22.6mod_unload ARMv4

以上信息也是我们在adc.c代码中添加的，还有的是在编译过程中得到的。

把adc.ko文件放到开发板中，执行insmod adc.ko，看到如下信息则说明启动正常：

adc initialized!

并且可以查看/dev目录下，已经有adc设备文件

# ls -l /dev/adc

crw-rw---- 1 0 0 10, 61 Jul 27 23:17 /dev/adc

1.4 可调电阻的测试程序

编写测试程序adc_test.c文件，源代码如下：

[cpp]view plaincopy 
   
 #include<stdio.h>  
 #include<stdlib.h>  
 #include<fcntl.h>  
 #include<unistd.h>  
 #include<sys/types.h>  
 #include<errno.h>  
    
 #defineDEVICE_NAME       "/dev/adc"  
    
 intmain()  
 {  
     int fd,ret,value;  
    
     fd = open(DEVICE_NAME, O_RDONLY);  
     if(fd < 0) {  
         perror("open ADC : ");  
         exit(EXIT_FAILURE);  
     }  
    
     ret = read(fd, &value, sizeof(value));  
     if(ret < 0) {  
             perror("read ADC:");  
             close(fd);  
             exit(EXIT_FAILURE);  
     }  
      
     printf("read from ADC : %d\n",value);  
     close(fd);  
    
     return 0;  
 }  