mini2440 触摸屏驱动程序分析
By JeefJiang July,8th,2009
这是mini2440 驱动分析系列的第三篇文章,本文分为三个部分,第一部分讲叙硬件知识,包括触摸屏
的原理以及SCC2440 SOC 上的触摸屏是如何工作的。第二部分分析输入设备子系统的框架,并进行相应
的代码分析。第三部分利用上述的原理来分析mini2440 的触摸屏驱动。第四部分介绍了测试和校准。
1.需要准备的硬件知识
1.1 电阻式触摸屏工作原理原理
触摸屏附着在显示器的表面,与显示器相配合使用,如果能测量出触摸点在屏幕上的坐标位置,则可根
据显示屏上对应坐标点的显示内容或图符获知触摸者的意图。触摸屏按其技术原理可分为五类:矢量压力
传感式、电阻式、电容式、红外线式、表面声波式,其中电阻式触摸屏在嵌入式系统中用的较多。电阻触
摸屏是一块4 层的透明的复合薄膜屏,如图2 所示,最下面是玻璃或有机玻璃构成的基层,最上面是一层
外表面经过硬化处理从而光滑防刮的塑料层,中间是两层金属导电层,分别在基层之上和塑料层内表面,
在两导电层之间有许多细小的透明隔离点把它们隔开。当手指触摸屏幕时,两导电层在触摸点处接触。
触摸屏的两个金属导电层是触摸屏的两个工作面,在每个工作面的两端各涂有一条银胶,称为该工作面
的一对电极,若在一个工作面的电极对上施加电压,则在该工作面上就会形成均匀连续的平行电压分布。
如图4 所示,当在X 方向的电极对上施加一确定的电压,而Y 方向电极对上不加电压时,在X 平行电压场
中,触点处的电压值可以在Y+(或Y-)电极上反映出来,通过测量Y+电极对地的电压大小,便可得知触点的
X 坐标值。同理,当在Y 电极对上加电压,而X 电极对上不加电压时,通过测量X+电极的电压,便可得知
触点的Y 坐标。电阻式触摸屏有四线和五线两种。四线式触摸屏的X 工作面和Y 工作面分别加在两个导电
层上,共有四根引出线,分别连到触摸屏的X 电极对和Y 电极对上。五线式触摸屏把X 工作面和Y 工作面
都加在玻璃基层的导电涂层上,但工作时,仍是分时加电压的,即让两个方向的电压场分时工作在同一工
作面上,而外导电层则仅仅用来充当导体和电压测量电极。因此,五线式触摸屏的引出线需为5 根。
1.2 在S3C2440 中的触摸屏接口
SOC S3C2440 的触摸屏接口是与ADC 接口结合在一起的,框图如下:
转换速率:当 PCLK=50MHz 时,分频设为49,则10 位的转换计算如下:
When the GCLK frequency is 50MHz and the prescaler value is 49,
A/D converter freq. = 50MHz/(49+1) = 1MHz
Conversion time = 1/(1MHz / 5cycles) = 1/200KHz = 5 us
This A/D converter was designed to operate at maximum 2.5MHz clock, so the conversion rate can
go up to 500 KSPS.
触摸屏接口的模式有以下几种:
普通 ADC 转换模式
独立 X/Y 位置转换模式
自动 X/Y 位置转换模式
等待中断模式
我们主要接受触摸屏接口的等待中断模式和自动 X/Y 位置转换模式(驱动程序中会用到):
自动转换模式操作流程如下:触摸屏控制器自动转换X,Y 的触摸位置,当转换完毕后将数据分别存放在
寄存器ADCDAT0 和ADCDAT1.并产生INT_ADC 中断通知转换完毕。
等待中断模式:
Touch Screen Controller generates interrupt (INT_TC) signal when the Stylus is down. Waiting for
Interrupt Modesetting value is rADCTSC=0xd3; // XP_PU, XP_Dis, XM_Dis, YP_Dis, YM_En.
当触摸后,触摸屏控制器产生INT_TC 中断,四个引脚设置应该为:
引脚 XP XM YP YM
状态 PULL UP/XP Disable Disable (初始值即是) Disable Enable
设置 1 0 1 1
当中断产生后,X/Y 的位置数据可以选择独立X/Y 位置转换模式,和自动X/Y 位置转换模式进行读取,
采用自动X/Y 位置转换模式进行读取需要对我们已经设置的TSC 寄存器进行更改,在原有的基础上或上
S3C2410_ADCTSC_PULL_UP_DISABLE | S3C2410_ADCTSC_AUTO_PST |
S3C2410_ADCTSC_XY_PST(0)。
数据转换完毕后,也会产生中断。
2. 输入子系统模型分析
2.1 整体框架:
输入子系统包括三个部分设备驱动、输入核心、事件处理器。
第一部分是连接在各个总线上的输入设备驱动,在我们的 SOC 上,这个总线可以使虚拟总线
platformbus,他们的作用是将底层的硬件输入转化为统一事件型式,向输入核心(Input core)汇报.
第二部分输入核心的作用如下:
(1) 调用 input_register_device() used to 添加设备,调用input_unregister_device() 除去设备。(下
面会结合触摸屏驱动讲述)
(2) 在/PROC 下产生相应的设备信息,下面这个例子即是:
/proc/bus/input/devices showing a USB mouse:
I: Bus=0003 Vendor=046d Product=c002 Version=0120
N: Name="Logitech USB-PS/2 Mouse M-BA47"
P: Phys=usb-00:01.2-2.2/input0
H: Handlers=mouse0 event2
B: EV=7
B: KEY=f0000 0 0 0 0 0 0 0 0
B: REL=103
(3) 通知事件处理器对事件进行处理
第三部分是事件处理器:
输入子系统包括了您所需要的大所属处理器,如鼠标、键盘、joystick,触摸屏,也有一个通用的处理
器被叫做event handler(对于内核文件evdev.C).需要注意的是随着内核版本的发展,event handler 将用
来处理更多的不同硬件的输入事件。在Linux2.6.29 版本中,剩下的特定设备事件处理就只有鼠标和joystick。
这就意味着越来越多的输入设备将通过event handler 来和用户空间打交道。事件处理层的主要作用就是和
用户空间打交道,我们知道Linux 在用户空间将所有设备当成文件来处理,在一般的驱动程序中都有提供
fops 接口,以及在/dev 下生成相应的设备文件nod,而在输入子系统的驱动中,这些动作都是在事件处理
器层完成的,我们看看evdev.C 相关代码吧。
static int __init evdev_init(void)
{
return input_register_handler(&evdev_handler);
}
这是该模块的注册程序,将在系统初始化时被调用。
初始化得过程很简单,就一句话,不过所有的秘密都被保藏在 evdev_handler 中了:
static struct input_handler evdev_handler = {
.event = evdev_event,
.connect = evdev_connect,
.disconnect = evdev_disconnect,
.fops = &evdev_fops,
.minor = EVDEV_MINOR_BASE,
.name = "evdev",
.id_table = evdev_ids,
};
先看connect 函数中如下的代码:
snprintf(evdev->name, sizeof(evdev->name), "event%d", minor);
evdev = kzalloc(sizeof(struct evdev), GFP_KERNEL);
evdev->handle.dev = input_get_device(dev);
evdev->handle.name = evdev->name;
dev_set_name(&evdev->dev, evdev->name);
evdev->dev.devt = MKDEV(INPUT_MAJOR, EVDEV_MINOR_BASE + minor);
evdev->dev.class = &input_class; evdev
->dev.parent = &dev->dev;
evdev->dev.release = evdev_free;
device_initialize(&evdev->dev);
error = device_add(&evdev->dev);
注意黑色的部分这将会在/sys/device/viture/input/input0/event0 这个目录就是在这里生成的,在event
下会有一个dev 的属性文件,存放着设备文件的设备号,,这样 udev 就能读
取该属性文件获得设备号,从而在/dev 目录下创建设备节点/dev/event0
再看evdev_fops 成员:
static const struct file_operations evdev_fops = {
.owner = THIS_MODULE,
.read = evdev_read,
.write = evdev_write,
.poll = evdev_poll,
.open = evdev_open,
.release = evdev_release, .unlocked_ioctl = evdev_ioctl,
#ifdef CONFIG_COMPAT
.compat_ioctl = evdev_ioctl_compat,
#endif
.fasync = evdev_fasync, .flush = evdev_flush
};
看过LDD3 的人都知道,这是设备提供给用户空间的接口,用来提供对设备的操作,其中evdev_ioctl
提供了很多命令,相关的命令使用参照《Using the Input Subsystem, Part II》
3 mini2440 的触摸屏驱动
3.1 初始化:
static int __init s3c2410ts_init(void)
{
struct input_dev *input_dev;
adc_clock = clk_get(NULL, "adc");
if (!adc_clock) {
printk(KERN_ERR "failed to get adc clock source\n");
return -ENOENT;
}
clk_enable(adc_clock);
//获取时钟,挂载APB BUS 上的外围设备,需要时钟控制,ADC 就是这样的设备。
base_addr=ioremap(S3C2410_PA_ADC,0x20);
I/O 内存是不能直接进行访问的,必须对其进行映射,为I/O 内存分配虚拟地址,这些虚拟地址以
__iomem 进行说明,但不能直接对其进行访问,需要使用专用的函数,如iowrite32
if (base_addr == NULL) {
printk(KERN_ERR "Failed to remap register block\n");
return -ENOMEM;
}
s3c2410_ts_connect();
iowrite32(S3C2410_ADCCON_PRSCEN | S3C2410_ADCCON_PRSCVL(0xFF),\
base_addr+S3C2410_ADCCON);//使能预分频和设置分频系数
iowrite32(0xffff, base_addr+S3C2410_ADCDLY);//设置ADC 延时,在等待中断
模式下表示产生 INT_TC 的间隔时间
iowrite32(WAIT4INT(0), base_addr+S3C2410_ADCTSC);
按照等待中断的模式设置TSC
接下来的部分是注册输入设备
input_dev = input_allocate_device();
//allocate memory for new input device,用来给输入设备分配空间,并做一些输入设备通用的初始的设
置
if (!input_dev) {
printk(KERN_ERR "Unable to allocate the input device !!\n");
return -ENOMEM;
}
dev = input_dev;
dev->evbit[0] = BIT(EV_SYN) | BIT(EV_KEY) | BIT(EV_ABS);
//设置事件类型
dev->keybit[BITS_TO_LONGS(BTN_TOUCH)] = BIT(BTN_TOUCH);
input_set_abs_params(dev, ABS_X, 0, 0x3FF, 0, 0);
input_set_abs_params(dev, ABS_Y, 0, 0x3FF, 0, 0);
input_set_abs_params(dev, ABS_PRESSURE, 0, 1, 0, 0);
以上四句都是设置事件类型中的code,如何理解呢,先说明事件类型,常用的事件类型EV_KEY、
EV_MOSSE, EV_ABS(用来接收像触摸屏这样的绝对坐标事件),而每种事件又会有不同类型的编码code,
比方说ABS_X,ABS_Y,这些编码又会有相应的value
dev->name = s3c2410ts_name;
dev->id.bustype = BUS_RS232;
dev->id.vendor = 0xDEAD;
dev->id.product = 0xBEEF;
dev->id.version = S3C2410TSVERSION;
//以上是输入设备的名称和id,这些信息时输入设备的身份信息了,在用户空间如何看到呢,
cat /proc/bus/input/devices,下面是我的截图
if (request_irq(IRQ_ADC, stylus_action, IRQF_SAMPLE_RANDOM,
"s3c2410_action", dev)) {
printk(KERN_ERR "s3c2410_ts.c: Could not allocate ts IRQ_ADC !\n");
iounmap(base_addr);
return -EIO;
}
if (request_irq(IRQ_TC, stylus_updown, IRQF_SAMPLE_RANDOM,
"s3c2410_action", dev)) {
printk(KERN_ERR "s3c2410_ts.c: Could not allocate ts IRQ_TC !\n");
iounmap(base_addr);
return -EIO;
}
printk(KERN_INFO "%s successfully loaded\n", s3c2410ts_name);
input_register_device(dev);
//前面已经设置了设备的基本信息和所具备的能力,所有的都准备好了,现在就可以注册了
return 0;
}
中断处理
stylus_action 和stylus_updown 两个中断处理函数,当笔尖触摸时,会进入到stylus_updown,
static irqreturn_t stylus_updown(int irq, void *dev_id)
{
unsigned long data0;
unsigned long data1;
int updown;
//注意在触摸屏驱动模块中,这个ADC_LOCK 的作用是保证任何时候都只有一个驱动程序使用ADC 的
中断线,因为在mini2440adc 模块中也会使用到ADC,这样只有拥有了这个锁,才能进入到启动ADC,注意
尽管LDD3 中说过信号量因为休眠不适合使用在ISR 中,但down_trylock 是一个例外,它不会休眠。
if (down_trylock(&ADC_LOCK) == 0) {
OwnADC = 1;
data0 = ioread32(base_addr+S3C2410_ADCDAT0);
data1 = ioread32(base_addr+S3C2410_ADCDAT1);
updown = (!(data0 & S3C2410_ADCDAT0_UPDOWN)) && (!(data1 &
S3C2410_ADCDAT0_UPDOWN));
if (updown) {//means down
touch_timer_fire(0);//这是一个定时器函数,当然在这里是作为普通函数调用,用来启动ADC
} else {
OwnADC = 0;
up(&ADC_LOCK);//注意红色的部分是基本不会执行的,除非你触摸后以飞快的速度是否,还来
不及启动ADC,当然这种飞快的速度一般是达不到的,笔者调试程序时发现这里是进入不了的
}
}
return IRQ_HANDLED;
}
static void touch_timer_fire(unsigned long data)
{
unsigned long data0;
unsigned long data1;
int updown;
data0 = ioread32(base_addr+S3C2410_ADCDAT0);
data1 = ioread32(base_addr+S3C2410_ADCDAT1);
updown = (!(data0 & S3C2410_ADCDAT0_UPDOWN)) && (!(data1 &
S3C2410_ADCDAT0_UPDOWN));
if (updown) {//means down
转换四次后进行事件汇报
if (count != 0) {
long tmp;
tmp = xp;
xp = yp;
yp = tmp;
//这里进行转换是因为我们的屏幕使用时采用的是240*320,相当于把原来的屏幕的X,Y 轴变换。
个人理解,不只是否正确
xp >>= 2;
yp >>= 2;
input_report_abs(dev, ABS_X, xp);
input_report_abs(dev, ABS_Y, yp);
//设备X,Y 值
input_report_key(dev, BTN_TOUCH, 1);
input_report_abs(dev, ABS_PRESSURE, 1);
input_sync(dev);
//这个表明我们上报了一次完整的触摸屏事件,用来间隔下一次的报告
}
xp = 0;
yp = 0;
count = 0;
iowrite32(S3C2410_ADCTSC_PULL_UP_DISABLE | AUTOPST,
base_addr+S3C2410_ADCTSC);
iowrite32(ioread32(base_addr+S3C2410_ADCCON) |
S3C2410_ADCCON_ENABLE_START, base_addr+S3C2410_ADCCON);
如果还没有启动ADC 或者ACD 转换四次完毕后则启动ADC
} else {
如果是up 状态,则提出报告并让触摸屏处在等待触摸的阶段
count = 0;
input_report_key(dev, BTN_TOUCH, 0);
input_report_abs(dev, ABS_PRESSURE, 0);
input_sync(dev);
iowrite32(WAIT4INT(0), base_addr+S3C2410_ADCTSC);
if (OwnADC) {
OwnADC = 0;
up(&ADC_LOCK);
}
}
}
static irqreturn_t stylus_action(int irq, void *dev_id)
{
unsigned long data0;
unsigned long data1;
if (OwnADC) {
data0 = ioread32(base_addr+S3C2410_ADCDAT0);
data1 = ioread32(base_addr+S3C2410_ADCDAT1);
xp += data0 & S3C2410_ADCDAT0_XPDATA_MASK;
yp += data1 & S3C2410_ADCDAT1_YPDATA_MASK;
count++;
读取数据
if (count < (1<<2)) {如果小如四次重新启动转换
iowrite32(S3C2410_ADCTSC_PULL_UP_DISABLE | AUTOPST,
base_addr+S3C2410_ADCTSC);
iowrite32(ioread32(base_addr+S3C2410_ADCCON) |
S3C2410_ADCCON_ENABLE_START, base_addr+S3C2410_ADCCON);
} else {如果超过四次,则等待1ms 后进行数据上报
mod_timer(&touch_timer, jiffies+1);
iowrite32(WAIT4INT(1), base_addr+S3C2410_ADCTSC);
}
}
return IRQ_HANDLED;
}
我们从整体上描述转换的过程:
(1) 如果触摸屏感觉到触摸,则进入updown ISR,如果能获取ADC_LOCK 则调用touch_timer_fire,
启动ADC,
(2) ADC 转换,如果小于四次继续转换,如果四次完毕后,启动1 个时间滴答的定时器,停止ADC,
也就是说在这个时间滴答内,ADC 是停止的,
(3) 这样可以防止屏幕抖动。
(4) 如果1 个时间滴答到时候,触摸屏仍然处于触摸状态则上报转换数据,并重启ADC,重复(2)
(5) 如果触摸笔释放了,则上报释放事件,并将触摸屏重新设置为等待中断状态。
4 测试与校准
关于应用程序的编写,请参照《Using the Input Subsystem, Part II》,讲解了input 设备的API,
触摸屏的校准时使触摸屏的坐标与LCD 得坐标进行对应,这种对应需要映射,这个映射的过程即为校
准.