转自:http://blog.163.com/kmustchenb@126/blog/static/110905765201042033235729/
键盘驱动程序解读----基于s3c6410+linux2.6.28
最近遇到一个问题: 就是用QT写的应用程序界面中,如果含有文本框,在激活状态下(跳出输入法,我用的是软键盘)如果按下某个硬件按键,此时就会有一个数字输入文本框,而且按下不同的按键输入的数字不同。一直不知道是驱动的问题还是应用程序本身的问题,所以想静下心来读下键盘的这个驱动。如果哪位朋友知道原因,请不吝赐教!
#include <linux/module.h>
#include <linux/kernel.h>
#include <linux/init.h>
#include <linux/interrupt.h>
#include <linux/input.h>
#include <linux/platform_device.h>
#include <linux/miscdevice.h>
#include <asm/hardware.h>
#include <asm/io.h>
#include <asm/delay.h>
#include <asm/irq.h>
#include <asm/arch/regs-gpio.h>
#include <asm/arch/regs-keypad.h>
#include "s3c-keypad.h"
#undef S3C_KEYPAD_DEBUG
//#define S3C_KEYPAD_DEBUG
#ifdef S3C_KEYPAD_DEBUG
#define DPRINTK(x...) printk("S3C-Keypad " x)
#else
#define DPRINTK(x...) /* !!!! */
#endif
#define DEVICE_NAME "s3c-keypad"
#define TRUE 1
#define FALSE 0
static struct timer_list keypad_timer;//Linux在include/linux/timer.h头文件中定义了数据结构timer_list来描述一个内核定时器
static int is_timer_on = FALSE;//关闭定时器
1.*************************************************************键盘扫描函数************************************************************
/*此为键盘扫描函数。在扫描时将某一列置0,其它列置1,记录下此时的行值,如果全部为1,说明不是此列,如果不是全部为1,那么根据此位所在的行位置与列组合就可以可出所按的键了。
在我的电路中键盘矩阵为:2列x8行,
第一列:0 1 2 3 4 5 6 7
第二列:8 9 10 11 12 13 14 15
当发生中断时将第一列置0,其他列置1,假设得出8行的行值为11111111(第一列置0时)
将第二列置0,其他列置1,假设得出8行的行值为11011111(第二列置0时)
将两次得出的结果做位或运算:11011111,11111111
由此可以得出第14键被按下了*/
以下是函数的执行过程:
当i=0:
1.cval = readl (从key_base+(0x08)读取32位数据) | 0xff
即cval = xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx | 00000000000000000000000011111111
cval = xxxxxxxxxxxxxxxxxxxxxxxx11111111
2.cval = xxxxxxxxxxxxxxxxxxxxxxxx11111111 & 11111111111111111111111110111111
即cval = xxxxxxxxxxxxxxxxxxxxxxxx10111111
3.writel( xxxxxxxxxxxxxxxxxxxxxxxx10111111,key_base+(0x08));
4.udelay(KEYPAD_DELAY);
5.rval=~(readl(key_base+0x0c)) & 0xff;
即rval=0000,0000,0000,0000,0000,0000,xxxxxxxx,即将读取的8行状态取反
6.if((0*KEYPAD_ROWS)<MAX_KEYMASK_NR)
*keymask_low |= 000000000000000000000000xxxxxxxx <<(0*8);
当i=1:
1.cval = readl (从key_base+(0x08)读取32位数据) | 0xff
即cval = xxxxxxxxxxxxxxxxxxxxxxxx10111111 | 00000000000000000000000011111111
cval = xxxxxxxxxxxxxxxxxxxxxxxx11111111
2.cval = xxxxxxxxxxxxxxxxxxxxxxxx11111111 & 11111111111111111111111101111111
即cval = xxxxxxxxxxxxxxxxxxxxxxxx01111111
3.writel(xxxxxxxxxxxxxxxxxxxxxxxx01111111,key_base+(0x08));
4.udelay(KEYPAD_DELAY);
5.rval=~(readl(key_base+0x0c)) & 0xff;
即rval=000000000000000000000000xxxxxxxx,即将读取的8行状态取反
6.if((1*KEYPAD_ROWS)<MAX_KEYMASK_NR)
*keymask_low |= 111111111111111111111111xxxxxxxx <<(1*8);
即*keymask_low = 00000000000000000000xxxxxxxx |1111111111111111xxxxxxxx00000000;
即*keymask_low = 1111111111111111xxxxxxxxxxxxxxxx
*/
static int keypad_scan(u32 *keymask_low, u32 *keymask_high)
{
int i,j = 0;
u32 cval,rval;
for (i=0; i<KEYPAD_COLUMNS; i++) {
cval = readl(key_base+S3C_KEYIFCOL) | KEYCOL_DMASK;//初始化列低8位输出高电平,即最后两列输出高电平
cval &= ~(1 << (i + 6));
writel(cval, key_base+S3C_KEYIFCOL);
udelay(KEYPAD_DELAY);
rval = ~(readl(key_base+S3C_KEYIFROW)) & KEYROW_DMASK;
if ((i*KEYPAD_ROWS) < MAX_KEYMASK_NR)
*keymask_low |= (rval << (i * KEYPAD_ROWS));
else {
*keymask_high |= (rval << (j * KEYPAD_ROWS));
j = j +1;
}
}
/*清空key_base+0x08的内容*/
writel(KEYIFCOL_CLEAR, key_base+S3C_KEYIFCOL);
return 0;
}
*************************************************定时处理函数*************************************************************************
static unsigned prevmask_low = 0, prevmask_high = 0;
/*定时时间到会触发此函数*/
static void keypad_timer_handler(unsigned long data)
{
u32 keymask_low = 0, keymask_high = 0;
u32 press_mask_low, press_mask_high;
u32 release_mask_low, release_mask_high;
int i;
struct s3c_keypad *pdata = (struct s3c_keypad *)data;
struct input_dev *dev = pdata->dev;
/*调用键盘扫描程序*/
keypad_scan(&keymask_low, &keymask_high);
/*相同时说明没有变化,即按下没有抬起,不同则说明按下已经抬起。第一次按下按键时此时keymask_low为key_scan函数所赋的值,这个值为 1111111111111111xxxxxxxxxxxxxxxx,即后16位为两次列分别置0时对应的行值,从右至左分别为第一列,第二列。通过执行第一个循环体确定按键按下的编号;prevmask_low = keymask_low;后,再次发生键盘抬起中断,这时执行key_scan函数后keymask_low变为111111111111111 0000000000000000,而prevmask_low为上次的keymask_low,所以此时keymask_low != prevmask_low,执行第二个循环体来确定抬起的按键编号。*/
if (keymask_low != prevmask_low) {
press_mask_low =
((keymask_low ^ prevmask_low) & keymask_low);/*执行此句之后,则后16位中有一位为1,此位就是健号*/
release_mask_low =
((keymask_low ^ prevmask_low) & prevmask_low); /*当键盘抬起时keymask_low后16位取反全为0,prevmask_low是上一次的keymask_low 异或后有一位为1则此即为抬起的键*/
i = 0;
while (press_mask_low) {//确定按下键值
if (press_mask_low & 1) {
input_report_key(dev,pdata->keycodes[i],1);
DPRINTK("low Pressed : %d\n",i);
}
press_mask_low >>= 1;
i++;
}
i = 0;
while (release_mask_low) {//确定抬起键值
if (release_mask_low & 1) {
input_report_key(dev,pdata->keycodes[i],0);
DPRINTK("low Released : %d\n",i);
}
release_mask_low >>= 1;
i++;
}
prevmask_low = keymask_low;
}
if (keymask_high != prevmask_high) {
press_mask_high =
((keymask_high ^ prevmask_high) & keymask_high);
release_mask_high =
((keymask_high ^ prevmask_high) & prevmask_high);
i = 0;
while (press_mask_high) {
if (press_mask_high & 1) {
input_report_key(dev,pdata->keycodes[i+MAX_KEYMASK_NR],1);
DPRINTK("high Pressed : %d %d\n",pdata->keycodes[i+MAX_KEYMASK_NR],i);
}
press_mask_high >>= 1;
i++;
}
i = 0;
while (release_mask_high) {
if (release_mask_high & 1) {
input_report_key(dev,pdata->keycodes[i+MAX_KEYMASK_NR],0);
DPRINTK("high Released : %d\n",pdata->keycodes[i+MAX_KEYMASK_NR]);
}
release_mask_high >>= 1;
i++;
}
prevmask_high = keymask_high;
}
if (keymask_low | keymask_high) {
mod_timer(&keypad_timer,jiffies + HZ/10);
} else {
writel(KEYIFCON_INIT, key_base+S3C_KEYIFCON);
is_timer_on = FALSE;
}
}
/************************************************************中断处理函数************************************************************/
static irqreturn_t s3c_keypad_isr(int irq, void *dev_id)
{
/* disable keypad interrupt and schedule for keypad timer handler */
writel(readl(key_base+S3C_KEYIFCON) & ~(INT_F_EN|INT_R_EN), key_base+S3C_KEYIFCON);//输入端口上升沿和下降沿中断屏蔽,写入x....xx00
keypad_timer.expires = jiffies + (HZ/100);//设置定时时间
if ( is_timer_on == FALSE) {
add_timer(&keypad_timer);//将参数keypad_timer指针所指向的定时器插入到一个合适的定时器链表中
is_timer_on = TRUE;
} else {
mod_timer(&keypad_timer,keypad_timer.expires);//修改注册入计时器列表的handler的起动时间
}
/*Clear the keypad interrupt status*/
writel(KEYIFSTSCLR_CLEAR, key_base+S3C_KEYIFSTSCLR);//KEYIFSTSCLR_CLEAR(0xffff),清除键盘中断状态位,包括按下中断和抬起中断
return IRQ_HANDLED;
}
/*驱动探测函数*/
static int __init s3c_keypad_probe(struct platform_device *pdev)
{
/***************************************************************/
ret = 0;
/*定义输入设备结构体*/
struct input_dev *input_dev;
int key, code;
struct s3c_keypad *s3c_keypad;//定义s3c_keypad结构体
/*ioremap函数将一个IO地址空间映射到内核的虚拟地址空间上去
S3C24XX_PA_KEYPAD(KEYIFCON,0x7E00A000):要映射的起始IO地址,
S3C24XX_SZ_KEYPAD(SZ_4K),要映射的空间大小*/
key_base = ioremap(S3C24XX_PA_KEYPAD, S3C24XX_SZ_KEYPAD);
if (key_base == NULL) {
printk(KERN_ERR "Failed to remap register block\n");
return -ENOMEM;
}
/*为struct s3c_keypad分配一段内存*/
s3c_keypad = kzalloc(sizeof(struct s3c_keypad), GFP_KERNEL);
/*1.分配input_dev结构体*/
input_dev = input_allocate_device();
if (!s3c_keypad || !input_dev) {
kfree(s3c_keypad);
input_free_device(input_dev);
return -ENOMEM;
}
platform_set_drvdata(pdev, s3c_keypad);/**/
s3c_keypad->dev = input_dev;/*初始化s3c_keypad结构体*/
/*初始化键盘控制寄存器,开下降沿中断,上升沿中断,滤波允许,允许除法计数器,关唤醒*/
writel(KEYIFCON_INIT, key_base+S3C_KEYIFCON);
/*初始化滤波分频寄存器,FCLK freq = FLT_CLK freq / ((KEYIFFC[9:0] + 1) x 2)*/
writel(KEYIFFC_DIV, key_base+S3C_KEYIFFC);
/* Set GPIO Port for keypad mode and pull-up disable*/
writel(KEYPAD_ROW_GPIO_SET, KEYPAD_ROW_GPIOCON);
writel(KEYPAD_COL_GPIO_SET, KEYPAD_COL_GPIOCON);
writel(KEYPAD_ROW_GPIOPUD_DIS, KEYPAD_ROW_GPIOPUD);
writel(KEYPAD_COL_GPIOPUD_DIS, KEYPAD_COL_GPIOPUD);
writel(KEYIFCOL_CLEAR, key_base+S3C_KEYIFCOL);
/* create and register the input driver */
/*2.初始化input_dev结构体*/
set_bit(EV_KEY, input_dev->evbit);/*设定支持的事件*/
set_bit(EV_REP, input_dev->evbit);
/*初始化s3c_keypad结构体*/
s3c_keypad->nr_rows = KEYPAD_ROWS;
s3c_keypad->no_cols = KEYPAD_COLUMNS;
s3c_keypad->total_keys = MAX_KEYPAD_NR;/*此处为16*/
//初始化结构体s3c_keypad的成员keycodes[MAX_KEYPAD_NR]
for(key = 0; key < s3c_keypad->total_keys; key++){
code = s3c_keypad->keycodes[key] = keypad_keycode[key];
if(code<=0)
continue;
set_bit(code & KEY_MAX, input_dev->keybit);
}
/*3.进一步初始化input_dev结构体*/
input_dev->name = DEVICE_NAME;
input_dev->phys = "s3c-keypad/input0";
input_dev->cdev.dev = &pdev->dev;
input_dev->private = s3c_keypad;
input_dev->id.bustype = BUS_HOST;
input_dev->id.vendor = 0x0001;
input_dev->id.product = 0x0001;
input_dev->id.version = 0x0001;
input_dev->keycode = keypad_keycode;
/*4.把设备注册进input子系统*/
ret = input_register_device(input_dev);
if (ret) {
printk("Unable to register s3c-keypad input device!!!\n");
goto out;
}
/***********************************************************************/
/* Scan timer init */
init_timer(&keypad_timer);/*初始化定时器*/
keypad_timer.function = keypad_timer_handler;/*定时时间到则进入处理函数*/
keypad_timer.data = (unsigned long)s3c_keypad;/*作为参数传入定时器处理函数*/
/***********************************************************************/
/*申请中断函数:IQ_KEYPAD:设备中断号,s3c_keypad_isr:指向中断处理程序的指针,DEVICE_NAME:产生中断的硬件的名字,
pdev:该标志在共享中断号时用*/
ret = request_irq(IRQ_KEYPAD, s3c_keypad_isr, IRQF_SAMPLE_RANDOM,
DEVICE_NAME, (void *) pdev);
if (ret) {
printk("request_irq failed (IRQ_KEYPAD) !!!\n");
goto out;
}
keypad_timer.expires = jiffies + (HZ/10);/*定时时间*/
if (is_timer_on == FALSE) {
add_timer(&keypad_timer);/*把定时器加入链表队列*/
is_timer_on = TRUE;
} else {
mod_timer(&keypad_timer,keypad_timer.expires);/*如果定时器已经加入链表队列,则修改定时时间*/
}
printk( DEVICE_NAME " Initialized\n");
return 0;
out:
input_unregister_device(input_dev);
kfree(s3c_keypad);
return ret;
}
/*驱动卸载函数*/
static int s3c_keypad_remove(struct platform_device *pdev)
{
struct input_dev *input_dev = platform_get_drvdata(pdev);
writel(KEYIFCON_CLEAR, key_base+S3C_KEYIFCON);
/*向系统注销输入设备*/
input_unregister_device(input_dev);
kfree(pdev->dev.platform_data);
/*释放中断请求*/
free_irq(IRQ_KEYPAD, (void *) pdev);
/*删除定时器*/
del_timer(&keypad_timer);
printk(DEVICE_NAME " Removed.\n");
return 0;
}
#ifdef CONFIG_PM
static int s3c_keypad_suspend(struct platform_device *dev, pm_message_t state)
{
/* TODO */
return 0;
}
static int s3c_keypad_resume(struct platform_device *dev)
{
/* TODO */
return 0;
}
#else
#define s3c_keypad_suspend NULL
#define s3c_keypad_resume NULL
#endif /* CONFIG_PM */
/*文件操作结构体*/
static struct platform_driver s3c_keypad_driver = {
.probe = s3c_keypad_probe,
.remove = s3c_keypad_remove,
.suspend = s3c_keypad_suspend,
.resume = s3c_keypad_resume,
.driver = {
.owner = THIS_MODULE,
.name = "s3c-keypad",
},
};
/*键盘模块加载时执行的函数*/
static int __init s3c_keypad_init(void)
{
int ret;
ret = platform_driver_register(&s3c_keypad_driver);
if(!ret)
printk(KERN_INFO "S3C Keypad Driver\n");
return ret;
}
/*键盘设备模块卸载时执行的函数*/
static void __exit s3c_keypad_exit(void)
{
platform_driver_unregister(&s3c_keypad_driver);
}
/*1.键盘设备模块加载函数*/
module_init(s3c_keypad_init);
/*键盘设备模块卸载函数*/
module_exit(s3c_keypad_exit);
MODULE_AUTHOR("Samsung");
MODULE_LICENSE("GPL");
MODULE_DESCRIPTION("KeyPad interface for Samsung S3C");
函数执行顺序为:module_init----> s3c_keypad_probe--->keypad_timer_handler--->keypad_scan