mini2440触摸屏驱动详解

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

#include
#include

/* For ts.dev.id.version */
#define S3C2410TSVERSION 0x0101

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

#define AUTOPST (S3C2410_ADCTSC_YM_SEN | S3C2410_ADCTSC_YP_SEN | S3C2410_ADCTSC_XP_SEN |
S3C2410_ADCTSC_AUTO_PST | S3C2410_ADCTSC_XY_PST(0))

static char *s3c2410ts_name = "s3c2410 TouchScreen";
#define DEVICE_NAME "mini2440_TouchScreen" /*设备名称*/

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

static long xp;
static long yp;
static int count;

/*定义一个外部的信号量ADC_LOCK，因为ADC_LOCK在ADC驱动程序中已申明
这样就能保证ADC资源在ADC驱动和触摸屏驱动中进行互斥访问*/
extern struct semaphore ADC_LOCK;
static int OwnADC = 0;

static void __iomem *base_addr; /*定义了一个用来保存经过虚拟映射后的内存地址*/

static inline void s3c2410_ts_connect(void)
{
s3c2410_gpio_cfgpin(S3C2410_GPG(12), S3C2410_GPG12_XMON);
s3c2410_gpio_cfgpin(S3C2410_GPG(13), S3C2410_GPG13_nXPON);
s3c2410_gpio_cfgpin(S3C2410_GPG(14), S3C2410_GPG14_YMON);
s3c2410_gpio_cfgpin(S3C2410_GPG(15), S3C2410_GPG15_nYPON);
}

static void touch_timer_fire(unsigned long data)
{
/*用于记录这一次AD转换后的值*/
unsigned long data0;
unsigned long data1;
int updown; /*用于记录触摸屏操作状态是按下还是抬起*/

data0 = ioread32(base_addr+S3C2410_ADCDAT0);
data1 = ioread32(base_addr+S3C2410_ADCDAT1);
/*记录这一次对触摸屏是压下还是抬起，该状态保存在数据寄存器的第15位，所以需要逻辑与上S3C2410_ADCDAT0_UPDOWN*/
updown = (!(data0 & S3C2410_ADCDAT0_UPDOWN)) && (!(data1 & S3C2410_ADCDAT0_UPDOWN));

if (updown) /*判断触摸屏的操作状态*/
{
/*如果状态是按下，并且ADC已经转换了就报告事件和数据*/
if (count != 0) //转换四次后进行事件汇报
{
long tmp;

tmp = xp;
xp = yp;
yp = tmp;
//这里进行转换是因为我们的屏幕使用时采用的是240*320，相当于把原来的屏幕的X,Y 轴变换。
//个人理解，不知是否正确

//设备X,Y 值
xp >>= 2;
yp >>= 2;
#ifdef CONFIG_TOUCHSCREEN_MINI2440_DEBUG
/*触摸屏调试信息，编译内核时选上此项后，点击触摸屏会在终端上打印出坐标信息*/
struct timeval tv;
do_gettimeofday(&tv);
printk(KERN_DEBUG "T: %06d, X: %03ld, Y: %03ldn", (int)tv.tv_usec, xp, yp);
#endif
input_report_abs(ts_dev, ABS_X, xp);
input_report_abs(ts_dev, ABS_Y, yp);
/*报告按键事件，键值为1(代表触摸屏对应的按键被按下)*/
input_report_key(ts_dev, BTN_TOUCH, 1);
//input_event(ts_dev, EV_KEY, BTN_TOUCH, 1);
/*报告触摸屏的状态，1表明触摸屏被按下*/
input_report_abs(ts_dev, ABS_PRESSURE, 1);
/*等待接收方受到数据后回复确认，用于同步*/
input_sync(ts_dev);
//这个表明我们上报了一次完整的触摸屏事件，用来间隔下一次的报告
}
/*如果状态是按下，并且ADC还没有开始转换就启动ADC进行转换*/
xp = 0;
yp = 0;
count = 0;
/*设置触摸屏的模式为自动转换模式*/
iowrite32(S3C2410_ADCTSC_PULL_UP_DISABLE | AUTOPST, base_addr+S3C2410_ADCTSC);
/*启动ADC转换*/
iowrite32(ioread32(base_addr+S3C2410_ADCCON) | S3C2410_ADCCON_ENABLE_START, base_addr+S3C2410_ADCCON);
//如果还没有启动ADC 或者ACD 转换四次完毕后则启动ADC
}
else /*否则是抬起状态*/
{
//如果是up 状态，则提出报告并让触摸屏处在等待触摸的阶段
count = 0;
// input_event(ts_dev, EV_KEY, BTN_TOUCH, 0);
input_report_key(ts_dev, BTN_TOUCH, 0); /*报告按键事件，键值为0(代表触摸屏对应的按键被释放)*/
input_report_abs(ts_dev, ABS_PRESSURE, 0); /*报告触摸屏的状态，0表明触摸屏没被按下*/
input_sync(ts_dev); /*等待接收方受到数据后回复确认，用于同步*/

iowrite32(WAIT4INT(0), base_addr+S3C2410_ADCTSC);
if (OwnADC)
{
OwnADC = 0;
up(&ADC_LOCK);
}
}
}
/*定义并初始化了一个定时器touch_timer，定时器服务程序为touch_timer_fire*/
static struct timer_list touch_timer = TIMER_INITIALIZER(touch_timer_fire, 0, 0);

/*ADC中断服务程序，AD转换完成后触发执行*/
static irqreturn_t stylus_updown(int irq, void *dev_id)
{
unsigned long data0;
unsigned long data1;
int updown;
//注意在触摸屏驱动模块中，这个ADC_LOCK 的作用是保证任何时候都只有一个驱动程序使用ADC 的
//中断线，因为在mini2440adc 模块中也会使用到ADC,这样只有拥有了这个锁，才能进入到启动ADC
if (down_trylock(&ADC_LOCK) == 0)
{
OwnADC = 1;
data0 = ioread32(base_addr+S3C2410_ADCDAT0);
data1 = ioread32(base_addr+S3C2410_ADCDAT1);
/*记录这一次对触摸屏是压下还是抬起，该状态保存在数据寄存器的第15位，所以需要逻辑与上S3C2410_ADCDAT0_UPDOWN*/
updown = (!(data0 & S3C2410_ADCDAT0_UPDOWN)) && (!(data1 & S3C2410_ADCDAT0_UPDOWN));

if (updown)
{
touch_timer_fire(0); //这是一个定时器函数，当然在这里是作为普通函数调用，用来启动ADC
}
//小赖注:准确说，else部分根本不会执行
/*
分析:当第一次按下，则申请了ADC信号量，并进入按下中断，此时强制执行touch_timer_fire
函数，又因为初次count = 0，因此会强制启动ADC转换进入ADC中断，于是进入stylus_action函数
进入此函数后，连续进行四次ADC转换，当完成四次转换后执行esle部分，即1ms后再次执行touch_timer_fire函数
同时执中断为检测弹起中断。好，到这里就是重点了，总之，不管怎么样mod_timer(&touch_timer, jiffies+1);函数的
意思是1ms后去执行touch_timer定时器上挂载的函数touch_timer_fire，好，也就是说不管怎样1ms以后
强制执行touch_timer_fire函数，那么，1ms后如果还是按下状态呢，那没办法上报坐标后继续，count xp yp清零
进入下一个四次的ADC中断，只要是按下的就一直不断的ADC转换按下处的坐标值，为什么要一直呢，转换一次不就完成了吗
何必要重复转换呢，注意，这里还有种情况就比较重要了，那就是按下在触摸屏上滑动的话，如果只转换一次，那么只能
得到第一次按下的点的坐标，如果这样每隔1ms采样四次的话，就能得到滑动的轨迹了，奥妙就在这里。回过头来，当某一次
弹起时，那就应该又进入stylus_updown中断函数。由于再次申请信号量会失败，则直接返回，因而不会执行下来
更不会执行else中的语句了。也就是说一次完整的按下到弹起过程中，第一次按下申请ADC信号量后，进入ADC启动过程；
第二次弹起进入stylus_updown，等于什么都没做，不会执行任何操作。
总结:
1、首次，按下进入stylus_updown中断，并启动touch_timer_fire函数，再启动ADC转换中断
2、ADC转换，转换没超过四次，继续转换直到四次，完成四次启动1ms定时器，1ms后执行touch_timer_fire函数
并置中断为弹起中断
3、1ms后如果是按下情况，上报坐标信息，完成后启动下一次ADC转换
4、继续2步骤，1ms后如果为弹起中断，则上报检测坐标完成信息，并置按下中断

*/
else
{
OwnADC = 0;
up(&ADC_LOCK); //注意这部分是基本不会执行的，除非你触摸后以飞快的速度是否，还来
//不及启动ADC，当然这种飞快的速度一般是达不到的，笔者调试程序时发现这里是进入不了的
}
}