S3C2440上触摸屏驱动实例开发讲解

一、开发环境

主 机：VMWare--Fedora 9

开发板：Mini2440--64MB Nand, Kernel:2.6.30.4

编译器：arm-linux-gcc-4.3.2

二、前提知识

1、Linux输入子系统(Input Subsystem)：

在Linux中，输入子系统是由输入子系统设备驱动层、输入子系统核心层(Input Core)和输入子系统事件处理层(Event Handler)组成。其中设备驱动层提供对硬件各寄存器的读写访问和将底层硬件对用户输入访问的响应转换为标准的输入事件，再通过核心层提交给事件处理层；而核心层对下提供了设备驱动层的编程接口，对上又提供了事件处理层的编程接口；而事件处理层就为我们用户空间的应用程序提供了统一访问设备的接口和驱动层提交来的事件处理。所以这使得我们输入设备的驱动部分不在用关心对设备文件的操作，而是要关心对各硬件寄存器的操作和提交的输入事件。下面用图形来描述一下这三者的关系吧！

另外，又找了另一幅图来说明Linux输入子系统的结构，可能更加形象容易理解。如下：

2、输入子系统设备驱动层实现原理：

在Linux中，Input设备用input_dev结构体描述，定义在input.h中。设备的驱动只需按照如下步骤就可实现了。
①、在驱动模块加载函数中设置Input设备支持input子系统的哪些事件；
②、将Input设备注册到input子系统中；
③、在Input设备发生输入操作时(如：键盘被按下/抬起、触摸屏被触摸/抬起/移动、鼠标被移动/单击/抬起时等)，提交所发生的事件及对应的键值/坐标等状态。

Linux中输入设备的事件类型有(这里只列出了常用的一些，更多请看linux/input.h中)：

EV_SYN 0x00 同步事件DE>DE>
EV_KEY 0x01 按键事件
EV_REL 0x02 相对坐标(如：鼠标移动，报告的是相对最后一次位置的偏移)
EV_ABS 0x03 绝对坐标(如：触摸屏和操作杆，报告的是绝对的坐标位置)
EV_MSC 0x04 其它
EV_LED 0x11 LED
EV_SND 0x12 声音
EV_REP 0x14 Repeat
EV_FF 0x15 力反馈DE>

用于提交较常用的事件类型给输入子系统的函数有：

voidinput_report_key(structinput_dev*dev,unsignedintcode,intvalue);//提交按键事件的函数
voidinput_report_rel(structinput_dev*dev,unsignedintcode,intvalue);//提交相对坐标事件的函数
voidinput_report_abs(structinput_dev*dev,unsignedintcode,intvalue);//提交绝对坐标事件的函数DE>

注意，在提交输入设备的事件后必须用下列方法使事件同步，让它告知input系统，设备驱动已经发出了一个完整的报告：

voidinput_sync(structinput_dev*dev)DE>

三、触摸屏驱动的实现步骤

1、硬件原理图分析：

S3c2440芯片内部触摸屏接口与ADC接口是集成在一起的，硬件结构原理图请看：S3C2440上ADC驱动实例开发讲解中的图，其中通道7(XP或AIN7)作为触摸屏接口的X坐标输入，通道5(YP或AIN5)作为触摸屏接口的Y坐标输入。在"S3C2440上ADC驱动实例开发讲解"中，AD转换的模拟信号是由开发板上的一个电位器产生并通过通道1(AIN0)输入的，而这里的模拟信号则是由点触触摸屏所产生的X坐标和Y坐标两个模拟信号，并分别通过通道7和通道5输入。S3c2440提供的触摸屏接口有4种处理模式，分别是：正常转换模式、单独的X/Y位置转换模式、自动X/Y位置转换模式和等待中断模式，对于在每种模式下工作的要求，请详细查看数据手册的描述。本驱动实例将采用自动X/Y位置转换模式和等待中断模式。

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

2、建立触摸屏驱动程序my2440_ts.c，首先实现加载和卸载部分，在驱动加载部分，我们主要做的事情是：启用ADC所需要的时钟、映射IO口、初始化寄存器、申请中断、初始化输入设备、将输入设备注册到输入子系统。代码如下：

#include
#include
#include
#include
#include
#include
#include
#include
#include

*用于保存从平台时钟列表中获取的ADC时钟*/
staticstructclk*adc_clk;

/*定义了一个用来保存经过虚拟映射后的内存地址*/
staticvoid__iomem*adc_base;

/*定义一个输入设备来表示我们的触摸屏设备*/
staticstructinput_dev*ts_dev;

/*设备名称*/
#defineDEVICE_NAME"my2440_TouchScreen"

/*定义一个WAIT4INT宏，该宏将对ADC触摸屏控制寄存器进行操作
S3C2410_ADCTSC_YM_SEN这些宏都定义在regs-adc.h中*/
#defineWAIT4INT(x)(((x)<<8)|S3C2410_ADCTSC_YM_SEN|S3C2410_ADCTSC_YP_SEN|
S3C2410_ADCTSC_XP_SEN|S3C2410_ADCTSC_XY_PST(3))

staticint__init ts_init(void)
{
intret;

/*从平台时钟队列中获取ADC的时钟，这里为什么要取得这个时钟，因为ADC的转换频率跟时钟有关。
系统的一些时钟定义在arch/arm/plat-s3c24xx/s3c2410-clock.c中*/
adc_clk=clk_get(NULL,"adc");
if(!adc_clk)
{
/*错误处理*/
printk(KERN_ERR"falied to find adc clock sourcen");
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 blockn");
ret=-EINVAL;
gotoerr_noclk;
}

/*初始化ADC控制寄存器和ADC触摸屏控制寄存器*/
adc_initialize();

/*申请ADC中断，AD转换完成后触发。这里使用共享中断IRQF_SHARED是因为该中断号在ADC驱动中也使用了，
最后一个参数1是随便给的一个值，因为如果不给值设为NULL的话，中断就申请不成功*/
ret=request_irq(IRQ_ADC,adc_irq,IRQF_SHARED|IRQF_SAMPLE_RANDOM,DEVICE_NAME,1);
if(ret)
{
printk(KERN_ERR"IRQ%d error %dn",IRQ_ADC,ret);
ret=-EINVAL;
gotoerr_nomap;
}

/*申请触摸屏中断，对触摸屏按下或提笔时触发*/
ret=request_irq(IRQ_TC,tc_irq,IRQF_SAMPLE_RANDOM,DEVICE_NAME,1);
if(ret)
{
printk(KERN_ERR"IRQ%d error %dn",IRQ_TC,ret);
ret=-EINVAL;
gotoerr_noirq;
}

/*给输入设备申请空间，input_allocate_device定义在input.h中*/
ts_dev=input_allocate_device();

/*下面初始化输入设备，即给输入设备结构体input_dev的成员设置值。
evbit字段用于描述支持的事件，这里支持同步事件、按键事件、绝对坐标事件，
BIT宏实际就是对1进行位操作，定义在linux/bitops.h中*/
ts_dev->evbit[0]=BIT(EV_SYN)|BIT(EV_KEY)|BIT(EV_ABS);

/*keybit字段用于描述按键的类型，在input.h中定义了很多，这里用BTN_TOUCH类型来表示触摸屏的点击*/
ts_dev->keybit[BITS_TO_LONGS(BTN_TOUCH)]=BIT(BTN_TOUCH);

/*对于触摸屏来说，使用的是绝对坐标系统。这里设置该坐标系统中X和Y坐标的最小值和最大值(0-1023范围)
ABS_X和ABS_Y就表示X坐标和Y坐标，ABS_PRESSURE就表示触摸屏是按下还是抬起状态*/
input_set_abs_params(ts_dev,ABS_X,0,0x3FF,0,0);
input_set_abs_params(ts_dev,ABS_Y,0,0x3FF,0,0);
input_set_abs_params(ts_dev,ABS_PRESSURE,0,1,0,0);

/*以下是设置触摸屏输入设备的身份信息，直接在这里写死。
这些信息可以在驱动挂载后在/proc/bus/input/devices中查看到*/
ts_dev->name=DEVICE_NAME;/*设备名称*/
ts_dev->id.bustype=BUS_RS232;/*总线类型*/
ts_dev->id.vendor=0xDEAD;/*经销商ID号*/
ts_dev->id.product=0xBEEF;/*产品ID号*/
ts_dev->id.version=0x0101;/*版本ID号*/

/*好了，一些都准备就绪，现在就把ts_dev触摸屏设备注册到输入子系统中*/
input_register_device(ts_dev);

return0;

/*下面是错误跳转处理*/
err_noclk:
clk_disable(adc_clk);
clk_put(adc_clk);

err_nomap:
iounmap(adc_base);

err_noirq:
free_irq(IRQ_ADC,1);

returnret;
}

/*初始化ADC控制寄存器和ADC触摸屏控制寄存器*/
staticvoidadc_initialize(void)
{
/*计算结果为(二进制)：111111111000000，再根据数据手册得知
此处是将AD转换预定标器值设为255、AD转换预定标器使能有效*/
writel(S3C2410_ADCCON_PRSCEN|S3C2410_ADCCON_PRSCVL(0xFF),adc_base+S3C2410_ADCCON);

/*对ADC开始延时寄存器进行设置，延时值为0xffff*/
writel(0xffff,adc_base+S3C2410_ADCDLY);

/*WAIT4INT宏计算结果为(二进制)：11010011，再根据数据手册得知
此处是将ADC触摸屏控制寄存器设置成等待中断模式*/
writel(WAIT4INT(0),adc_base+S3C2410_ADCTSC);
}

staticvoid__exit ts_exit(void)
{
/*屏蔽和释放中断*/
disable_irq(IRQ_ADC);
disable_irq(IRQ_TC);
free_irq(IRQ_ADC,1);
free_irq(IRQ_TC,1);

/*释放虚拟地址映射空间*/
iounmap(adc_base);

/*屏蔽和销毁时钟*/
if(adc_clk)
{
clk_disable(adc_clk);
clk_put(adc_clk);
adc_clk=NULL;
}

/*将触摸屏设备从输入子系统中注销*/
input_unregister_device(ts_dev);
}

module_init(ts_init);
module_exit(ts_exit);

MODULE_LICENSE("GPL");
MODULE_AUTHOR("Huang Gang");
MODULE_DESCRIPTION("My2440 Touch Screen Driver");DE>