/*

* s3c2410-ts.c

*

* touchScreen driver for SAMSUNG S3C2410

*

* Author: Janghoon Lyu <nandy@mizi.com>

* Date : $Date: 2002/06/04 07:11:00 $

*

* $Revision: 1.1.2.6 $

*

* Based on pt036001b-ts.c

*

* This file is subject to the terms and conditions of the GNU General Public

* License. See the file COPYING in the main directory of this archive

* for more details.

*

* History:

*

* 2002-05-27: Janghoon Lyu <nandy@mizi.com>

* - Add HOOK_FOR_DRAG

* - PM 鍐呴潧鍟?鐢哥虎鍟?涔愬彉 绐嶇槫鐖?鎶涜兌椋?鐧荤槫 鑷肩柦婢?

*

*/

#include <linux/config.h>

#include <linux/module.h>

#include <linux/kernel.h>

#include <linux/init.h>

#include <linux/miscdevice.h>

#include <linux/sched.h>

#include <linux/delay.h>

#include <linux/poll.h>

#include <linux/spinlock.h>

#include <linux/irq.h>

#include <linux/delay.h>

#include <asm/hardware.h>

#ifdef CONFIG_PM

#include <linux/pm.h>

#endif

/* debug macros */

#undef DEBUG

#ifdef DEBUG

#define DPRINTK( x... ) printk("s3c2410-ts: " ##x)

#else

#define DPRINTK( x... )

#endif

//定义触摸屏笔的状态，其中PEN_UP 为笔抬起状态

// PEN_DOWN

为笔按下状态

//

PEN_FLEETING 为笔滑动状态

#define PEN_UP 0

#define PEN_DOWN 1

#define PEN_FLEETING 2

/*定义环形缓冲区的大小，环形缓冲区主要用来保存

应用程序来不及处理的触摸屏动作*/

#define MAX_TS_BUF 16 /* how many do we want to buffer */

#undef USE_ASYNC 1

#define DEVICE_NAME "s3c2410-ts"

#define TSRAW_MINOR 1

typedef struct {

//定义笔的状态

unsigned int penStatus; /* PEN_UP, PEN_DOWN, PEN_SAMPLE */

TS_RET buf[MAX_TS_BUF]; /* protect against overrun */

/*定义可以保存16 个事件的环形缓冲区，其每个元素类型为:

typedef struct {

//压力，这里被定义为触摸笔动作，即

//上面定义的PEN_UP/PEN_DOWN/PEN_FLEETING 三种

unsigned short pressure;

//横坐标的采样值

unsigned short x;

//纵坐标的采样值

unsigned short y;

//pad是填充位，这个成员是为了保证整个结构体的大小

//为4 字节整数倍而使用的

unsigned short pad;

} TS_RET;

*/

unsigned int head, tail; /* head and tail for queued events */

/*

head和tail 用于指向环形缓冲区的头和尾

*/

wait_queue_head_t wq;

/*Linux 内核的等待队列是以双循环链表为基础数据结构，与进程调度机制紧密结合，能够用于

实现核心的异步事件通知机制。在Linux2.4.21 中，等待队列在源代码树include/linux/wait.h 中，

这是一个通过list_head 连接的典型双循环链表，如下图所示。

*/

spinlock_t lock;

/*

定义一把自旋锁。在linux 内核中，锁有两种类型，一个是自旋锁，另外是读写锁自旋

锁最多只能被一个可执行线程持有。

自旋锁不会引起调用者睡眠，如果一个执行线程试图获得一个已经被持有的自旋锁，那

么线程就会一直进行忙循环，一直等待下去，在那里看是否该自旋锁的保持者已经释放了锁，

"自旋"一词就是因此而得名。 由于自旋锁使用者一般保持锁时间非常短，因此选择自旋而

不是睡眠是非常必要的，自旋锁的效率远高于互斥锁

*/

#ifdef USE_ASYNC

struct fasync_struct *aq;

#endif

#ifdef CONFIG_PM

struct pm_dev *pm_dev;

#endif

} TS_DEV;

static TS_DEV tsdev;

/* 定义触摸屏设备变量tsdev，该全局变量用于处理一触摸屏相关事务*/

#define BUF_HEAD (tsdev.buf[tsdev.head])

#define BUF_TAIL (tsdev.buf[tsdev.tail])

#define INCBUF(x,mod) ((++(x)) & ((mod) - 1))

static int tsMajor = 0;

static void (*tsEvent)(void);

#define HOOK_FOR_DRAG

#ifdef HOOK_FOR_DRAG

#define TS_TIMER_DELAY (HZ/100) /* 10 ms */

static struct timer_list ts_timer;

#endif

#define wait_down_int() { ADCTSC = DOWN_INT | XP_PULL_UP_EN | \

XP_AIN | XM_HIZ | YP_AIN | YM_GND | \

XP_PST(WAIT_INT_MODE); }

/*设置触摸屏处于等待中断模式，笔处于抬起状态，等待笔按下

*/

#define wait_up_int() { ADCTSC = UP_INT | XP_PULL_UP_EN | XP_AIN | XM_HIZ | \

YP_AIN | YM_GND | XP_PST(WAIT_INT_MODE); }

/*设置触摸屏处于等待中断模式，笔处于按下状态，等待笔抬起

*/

#define mode_x_axis() { ADCTSC = XP_EXTVLT | XM_GND | YP_AIN | YM_HIZ | \

XP_PULL_UP_DIS | XP_PST(X_AXIS_MODE); }

/*对X坐标进行测量*/