#include <linux/module.h>
#include <linux/kernel.h>
#include <linux/clk.h>
#include <linux/init.h>
#include <linux/input.h>
#include <linux/serio.h>
#include <plat/regs-adc.h>
#include <asm/irq.h>
#include <asm/io.h>
/*用于保存从平台时钟列表中获取的ADC时钟*/
static struct clk *adc_clk;
/*定义了一个用来保存经过虚拟映射后的内存地址*/
static void __iomem *adc_base;
/*定义一个输入设备来表示我们的触摸屏设备*/
static struct input_dev *ts_dev;
/*设备名称*/
#define DEVICE_NAME "my2440_TouchScreen"
/*定义一个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))
static int __init ts_init(void)
{
int ret;
/*从平台时钟队列中获取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 source\n");
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 block\n");
ret = -EINVAL;
goto err_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 %d\n", IRQ_ADC, ret);
ret = -EINVAL;
goto err_nomap;
}
/*申请触摸屏中断，对触摸屏按下或提笔时触发*/
ret = request_irq(IRQ_TC, tc_irq, IRQF_SAMPLE_RANDOM, DEVICE_NAME, 1);
if(ret)
{
printk(KERN_ERR "IRQ%d error %d\n", IRQ_TC, ret);
ret = -EINVAL;
goto err_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);
return 0;
/*下面是错误跳转处理*/
err_noclk:
clk_disable(adc_clk);
clk_put(adc_clk);
err_nomap:
iounmap(adc_base);
err_noirq:
free_irq(IRQ_ADC, 1);
return ret;
}
/*初始化ADC控制寄存器和ADC触摸屏控制寄存器*/
static void adc_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);
}
static void __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("Dual BSD/GPL");
MODULE_AUTHOR("apple");
MODULE_DESCRIPTION("My2440 Touch Screen Driver");
|
