input子系统学习笔记
- 1、下载文档前请自行甄别文档内容的完整性,平台不提供额外的编辑、内容补充、找答案等附加服务。
- 2、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
- 3、如文档侵犯您的权益,请联系客服反馈,我们会尽快为您处理(人工客服工作时间:9:00-18:30)。
in pu t子系统学习笔记一序
i nput子系统学习系列文章,是我在实际开发过程中遇到也是必须啃下去的第一个Li nux驱动,所以有必要记载下来的。
由于刚开始未接触过I nput子系统,部分资料还是借鉴网络,本系列文章是本人的学习心得以及集百家所长的产物。
注:这是本人第一次在O ur U ni x博客发表文章,所以i nput子系统学习系列文章的介绍格式参考自博主的:m m c子系统学习笔记
i nput子系统学习系列文章,主要包含下述内容:
I nputsubsyst em理论部分
i nputsubsyst em介绍
i nput子系统结构图
l i nux中输入设备驱动的分层
输入子系统设备驱动层实现原
软件设计流程
设计有关的A P I
分配一个输入设备
注册一个输入设备
驱动实现-事件支持
驱动实现-报告事件
释放与注销设备
实例分析(按键驱动)
代码实现之重要函数分析
i nput_al l ocat e_devi ce()
注册函数i nput_r egi st er_devi ce()
i nput_r eport_key()向子系统报告事件
handl er注册分析
关键数据结构
注册i nput_handl er
注册i nput_handl e
子系统
子系统初始化函数i nput_i ni t()
evdev输入事件驱动分析
evdev的初始化
in pu t子系统学习笔记二in pu t子系统介绍及结构图
i nput子系统介绍
输入设备(如按键,键盘,触摸屏,鼠标,蜂鸣器等)是典型的字符设备,其一般的工作机制是底层在按键,触摸等动作发生时产生一个中断(或驱动通过t i m er定时查询),然后cpu通过S PI,I2C或者外部存储器总线读取键值,坐标等数据,放一个缓冲区,字符设备驱动管理该缓冲区,而驱动的r ead()接口让用户可以读取键值,坐标等数据。
在Li nux中,输入子系统是由输入子系统设备驱动层、输入子系统核心层(I nputC or e)和输入子系统事件处理层(EventH andl er)组成。
其中设备驱动层提供对硬件各寄存器的读写访问和将底层硬件对用户输入访问的响应转换为标准的输入事件,再通过核心层提交给事件处理层;而核心层对下提供了设备驱动层的编程接口,对上又提供了事件处理层的编程接口;而事件处理层就为我们用户空间的应用程序提供了统一访问设备的接口和驱动层提交来的事件处理。
所以这使得我们输入设备的驱动部分不在用关心对设备文件的操作,而是要关心对各硬件寄存器的操作和提交的输入事件。
在Li nux中,输入子系统作为一个模块存在,向上,为用户层提供接口函数,向下,为驱动层程序提供统一的接口函数。
其构建非常灵活,只需要调用一些简单的函数,就可以将一个输入设备的功能呈现给应用程序。
这样,就能够使输入设备的事件通过输入子系统发送给用户层应用程序,用户层应用程序也可以通过输入子系统通知驱动程序完成某项功能。
i nput子系统结构图
in pu t子系统学习笔记三驱动的分层及设备驱动层实现原理
l i nux中输入设备驱动的分层
下图展现了l i nux中输入设备驱动的分层,从此图我们不难看出Li nux是如何设计输入设备的驱动架构的,结合i nput子系统学习笔记二i nput子系统介绍及结构图我们接下来分析i nput子系统驱动的分层及设备驱动层实现原理。
输入子系统设备驱动层实现原理
在Li nux中,I nput设备用i nput_dev结构体描述,定义在i nput.h中。
设备的驱动只需按照如下步骤就可实现了。
1).在驱动模块加载函数中设置I nput设备支持i nput子系统的哪些事件;
2).将I nput设备注册到i nput子系统中;
3).在I nput设备发生输入操作时(如:键盘被按下/抬起、触摸屏被触摸/抬起/移动、鼠标被移动/单击/抬起时等),提交所发生的事件及对应的键值/坐标等状态。
in pu t子系统学习笔记四软件设计流程及相关A P I
接下来,我们就开始看I nput子系统的软件设计流程,我在阅读的时候同时整理设计代码中的相关A P I,并在下一篇文章详细介绍i nput子系统的代码实现。
i nput子系统的软件设计流程
软件设计流程如下所示:
分配一个输入设备——注册一个输入设备——上报输入事件——注销一个输入设备——释放一个输入设备
设计有关的A PI
分配一个输入设备
C/C++代码
1.struct input_dev*input_allocate_device*(void);
注册一个输入设备
C/C++代码
1.int input_register_device(struct input_dev*dev);
驱动实现-事件支持
C/C++代码
1.Set_bit(EV_KEY,button_dev.evbit)
2.//Set_bit告诉inout子系统它支持哪些事件
3.//Struct input_dev中有两个成员,一个是evbit;一个是keybit;分别用来表示设备所支持的事件类型和按键类型。
事件类型
Li nux中输入设备的事件类型有(这里只列出了常用的一些,更多请看l i nux/i nput.h中):
C/C++代码
1.EV_SYN0x00同步事件
2.EV_KEY0x01按键事件
3.EV_REL0x02相对坐标
4.EV_ABS0x03绝对坐标
5.EV_MSC0x04其它
6.EV_LED0x11LED
7.EV_SND0x12声音
8.EV_REP0x14Repeat
9.EV_FF0x15Force feedback事件
按键类型
当事件类型为E V_K E Y时,还需指明按键类型:
C/C++代码
1.BTN_LEFT鼠标左键
2.BTN_RIGHT鼠标右键
3.BTN_MIDDLE鼠标中键
4.BTN_0数字0键
5.BTN_1数字1键
上述set_bi t函数实则完成了把E V_K E Y赋值到but t on_dev.evbi t
驱动实现-报告事件
C/C++代码
1.Void input_event(struct input_dev*dev,unsigned int type,unsigned int code,int value);//报告指定type,
code的输入事件
2.Void input_report_key(struct input_dev*dev,unsigned int code,int value);/*报告键值,code:事件的代码,
如果事件是ev_key,该代码则为设备的键盘代码。
例如鼠标按键代码为0x110~0x116,其中0x110(BTN_LEFT),0x111(BTN_ RIGHT),0x112(BTN_MIDDLE)。
其它带按摩含义参考include/linux/input.h文件*/
3.value:事件的值,如果事件的类型是EV_KEY,当按键按下时值为1,松开时为0。
4.Void input_report_rel(struct input_dev*dev,unsigned int code,int value);//报告相对坐标
5.Void input_report_abs(struct input_dev*dev,unsigned int code,int value);//报告绝对坐标
6.Void input_sync(struct input_dev*dev);/*报告同步事件,input_sync()用于高速input core此次报告已经结束,
能够根据上报的信息往后面处理了*/
在触摸屏驱动设计中,一次坐标及按下状态的整个报告过程如下:
C/C++代码
1.Input_report_abs(input_dev,ABS_X,x);//X坐标
2.Input_report_abs(input_dev,ABS_Y,y);//Y坐标
3.Input_report_abs(input_dev,ABS_PRESSURE,pres);//压力
4.input_sync(struct input_dev*dev);//同步
释放与注销设备
C/C++代码
1.Void input_free_device(struct input_dev*dev);
2.Void input_unregister_device(struct input_dev*);
in pu t子系统学习笔记五按键驱动实例分析上
下面是按键驱动的简单例子,这个输入设备只有一个按键,按键被连接到一条中断线上,当按键被按下时,将产生一个中断,内核将检测到这个中断,并对其进行处理。
代码含注释如下:
C++代码
2.#include<asm/irq.h>
3.#include<asm/io.h>
4.static struct input_dev*button_dev;/*输入设备结构体*/
5.static irqreturn_t button_interrupt(int,irq,void*dummy)/*中断处理函数*/
6.{
7.input_report_key(button_dev,BTN_0,inb(BUTTON_PORT)&1);
8./*向输入子系统报告产生按键事件*/
9.input_sync(button_dev);
10./*通知接收者,一个报告发送完毕*/
11.return IRQ_HANDLED;
12.}
13.static int__init button_init(void)/*加载函数*/
14.{
15.int error;
16.if(request_irq(BUTTON_IRQ,button_interrupt,0,"button",NULL))
17./*申请中断处理函数*/
18.{
19./*申请失败,则打印出错信息*/
20.printk(KERN_ERR"button.c:Can't allocate irq%d\n",button_irq);
21.return-EBUSY;
22.}
23.button_dev=input_allocate_device();/*分配一个设备结构体*/
24.if(!button_dev)/*判断分配是否成功*/
25.{
26.printk(KERN_ERR"button.c:Not enough memory\n");
27.error=-ENOMEM;
28.goto err_free_irq;
29.}
30.button_dev->evbit[0]=BIT_MASK(EV_KEY);/*设置按键信息*/
31.button_dev->keybit[BIT_WORD(BTN_0)]=BIT_MASK(BTN_0);
32.error=input_register_device(button_dev);/*注册一个输入设备*/
33.if(error)
34.{
35.printk(KERN_ERR"button.c:Failed to register device\n");
36.goto err_free_dev;
37.}
38.return0;
39.err_free_dev:/*以下是错误处理*/
40.input_free_device(button_dev);
41.err_free_irq:
42.free_irq(BUTTON_IRQ,button_interrupt);
43.return error;
44.}
45.static void__exit button_exit(void)
46./*卸载函数*/
47.{
48.input_unregister_device(button_dev);
49./*注销按键设备*/
50.free_irq(BUTTON_IRQ,button_interrupt);/*释放按键占用的中断线*/
51.}
52.module_init(button_init);
53.module_exit(button_exit);
重要函数分析
这个实例程序代码比较简单,在初始化函数but t on_i ni t()中注册了一个中断处理函数,然后并调用
i nput_r egi st er_devi ce()调用i nput_al l ocat e_devi ce()函数分配了一个i nput_dev结构体,函数对其进行了注册。
在中断处理函数but t on_i nt er rupt()中,实例将接收到的按键信息上报给i nput子系统。
从而通过i nput子系统,向用户态程序提供按键输入信息。
本实例采用了中断方式,除了中断相关的代码外,实例中包含了一些i nput子系统提供的函数,现对其中一些重要的函数进行分析。
i nput_al l ocat e_devi ce()
C++代码
2.struct input_dev*input_allocate_device(void)
3.{
4.struct input_dev*dev;
5.dev=kzalloc(sizeof(struct input_dev),GFP_KERNEL);/*分配一个input_dev结构体,并初始化为0*/
6.
7.if(dev){
8.dev->dev.type=&input_dev_type;/*初始化设备的类型*/
9.dev->dev.class=&input_class;/*设置为输入设备类*/
10.device_initialize(&dev->dev);/*初始化device结构*/
11.mutex_init(&dev->mutex);/*初始化互斥锁*/
12.spin_lock_init(&dev->event_lock);/*初始化事件自旋锁*/
13.INIT_LIST_HEAD(&dev->h_list);/*初始化链表*/
14.INIT_LIST_HEAD(&dev->node);/*初始化链表*/
15.__module_get(THIS_MODULE);/*模块引用技术加1*/
16.}
17.return dev;
18.}
该函数返回一个指向i nput_dev类型的指针,该结构体是一个输入设备结构体,包含了输入设备的一些相关信息,如设备支持的按键码、设备的名称、设备支持的事件等。
注册函数i nput_r egi st er_devi ce()
i nput_r egi st er_devi ce()函数是输入子系统核心(i nputcor e)提供的函数。
该函数将i nput_dev结构体注册到输入子系统核心中,i nput_dev结构体必须由前面讲的i nput_al l ocat e_devi ce()函数来分配。
i nput_r egi st er_devi ce()函数如果注册失败,必须调用i nput_f r ee_devi ce()函数释放分配的空间。
如果该函数注册成功,在卸载函数中应该调用i nput_unregi st er_devi ce()函数来注销输入设备结构体。
简而言之,注册i nput
devi ce的过程就是为i nputdevi ce设置默认值,并将其挂以i nput_dev_l i st。
与挂载在i nput_handl er_l i st中的handl er相匹配。
如果匹配成功,就会调用handl er的connect函数。
代码如下:
C++代码
4.int input_register_device(struct input_dev*dev)
5.{
6.static atomic_t input_no=ATOMIC_INIT(0);
7.struct input_handler*handler;
8.const char*path;
9.int error;
10.
11./*Every input device generates EV_SYN/SYN_REPORT events.*/
12.__set_bit(EV_SYN,dev->evbit);/*调用__set_bit()函数设置input_dev所支持的事件类型。
事件类型由inpu
t_dev的evbit成员来表示,在这里将其EV_SYN置位,表示设备支持所有的事件。
一个设备可以支持一种或者多种事件类型。
*/
13.
14./*KEY_RESERVED is not supposed to be transmitted to userspace.*/
15.__clear_bit(KEY_RESERVED,dev->keybit);
16.
17./*Make sure that bitmasks not mentioned in dev->evbit are clean.*/
18.input_cleanse_bitmasks(dev);
19.
20./*
21.*If delay and period are pre-set by the driver,then autorepeating
22.*is handled by the driver itself and we don't do it in input.c.
23.*/
24.init_timer(&dev->timer);/*初始化一个timer定时器,这个定时器是为处理重复击键而定义的。
*/
25.
26./*如果dev->rep[REP_DELAY]和dev->rep[REP_PERIOD]没有设值,则将其赋默认值,这主要是为自动处理重复按键
定义的。
*/
27.if(!dev->rep[REP_DELAY]&&!dev->rep[REP_PERIOD]){
28.dev->timer.data=(long)dev;
29.dev->timer.function=input_repeat_key;
30.dev->rep[REP_DELAY]=250;
31.dev->rep[REP_PERIOD]=33;
32.}
33./*检查getkeycode()函数和setkeycode()函数是否被定义,如果没定义,则使用默认的处理函数,这两个函数为inp
ut_default_getkeycode()和
34.input_default_setkeycode()。
input_default_getkeycode()函数用来得到指定位置的键值。
input_default_
setkeycode()函数用来设置键值。
*/
35.if(!dev->getkeycode)
36.dev->getkeycode=input_default_getkeycode;
37.
38.if(!dev->setkeycode)
39.dev->setkeycode=input_default_setkeycode;
40./*设置input_dev中的device的名字,名字以input0、input1、input2、input3、input4等的形式出现在sysf
s文件系统中。
*/
41.dev_set_name(&dev->dev,"input%ld",
42.(unsigned long)atomic_inc_return(&input_no)-1);
43.
44.error=device_add(&dev->dev);
45.if(error)
46.return error;
47.
48.path=kobject_get_path(&dev->dev.kobj,GFP_KERNEL);
49.printk(KERN_INFO"input:%s as%s\n",
50.dev->name?dev->name:"Unspecified device",path?path:"N/A");//打印设备的路径,输出调试信
息。
51.kfree(path);
52.
53.error=mutex_lock_interruptible(&input_mutex);
54.if(error){
55.device_del(&dev->dev);
56.return error;
57.}
58.
59.list_add_tail(&dev->node,&input_dev_list);
60./*调用list_add_tail()函数将input_dev加入input_dev_list链表中,input_dev_list链表中包含了系统中
所有的input_dev设备。
*/
61.list_for_each_entry(handler,&input_handler_list,node)
62.input_attach_handler(dev,handler);/*input_attach_handler()函数用来匹配input_dev和handler,只
有匹配成功,才能进行下一步的关联操作。
*/
63.
64.input_wakeup_procfs_readers();
65.
66.mutex_unlock(&input_mutex);
67.
68.return0;
69.}
i nput_at t ach_handl er()
内核中代码如下:
XML/HTML代码
10.static int input_attach_handler(struct input_dev*dev,struct input_handler*handler)
11.{
12.const struct input_device_id*id;/*输入设备的指针,该结构体表示设备的标识,标识中存储了设备的信息*/
13.
14.int error;
15.if(handler->blacklist&&input_match_device(handler->blacklist,
16.dev))/*首先判断handle的blacklist是否被赋值,如果被赋值,则匹配blacklist中的数据跟dev->id的数
据是否匹配。
blacklist是一个input_device_id*的类型,其指向input_device_id的一个表,这个表中存放了驱动程序应该
忽略的设备。
即使在id_table中找到支持的项,也应该忽略这种设备。
*/
17.return-ENODEV;
18.
19.id=input_match_device(handler,dev);
20.if(!id)
21.return-ENODEV;
22.
23.error=handler->connect(handler,dev,id);/*连接设备和处理函数*/
24.
25.if(error&&error!=-ENODEV)
26.printk(KERN_ERR
27."input:failed to attach handler%s to device%s,"
28."error:%d\n",
29.handler->name,kobject_name(&dev->dev.kobj),error);
30.
31.return error;
32.}
i nput_devi ce_i d
C++代码
6.struct input_device_id{
7.
8.kernel_ulong_t flags;/*标志信息*/
9.__u16bustype;/*总线类型*/
10.__u16vendor;/*制造商ID*/
11.__u16product;/*产品ID*/
12.__u16version;/*版本号*/
13.
14.kernel_ulong_t evbit[INPUT_DEVICE_ID_EV_MAX/BITS_PER_LONG+1];
15.kernel_ulong_t keybit[INPUT_DEVICE_ID_KEY_MAX/BITS_PER_LONG+1];
16.kernel_ulong_t relbit[INPUT_DEVICE_ID_REL_MAX/BITS_PER_LONG+1];
17.kernel_ulong_t absbit[INPUT_DEVICE_ID_ABS_MAX/BITS_PER_LONG+1];
18.kernel_ulong_t mscbit[INPUT_DEVICE_ID_MSC_MAX/BITS_PER_LONG+1];
19.kernel_ulong_t ledbit[INPUT_DEVICE_ID_LED_MAX/BITS_PER_LONG+1];
20.kernel_ulong_t sndbit[INPUT_DEVICE_ID_SND_MAX/BITS_PER_LONG+
21.1];
22.kernel_ulong_t ffbit[INPUT_DEVICE_ID_FF_MAX/BITS_PER_LONG+1];
23.kernel_ulong_t swbit[INPUT_DEVICE_ID_SW_MAX/BITS_PER_LONG+1];
24.
25.kernel_ulong_t driver_info;/*驱动额外的信息*/
26.
27.};
i nput_m at ch_devi ce()
i nput_m at ch_devi ce()函数匹配handl e->>i d_t abl e和dev->i d中的数据。
如果不成功则返回。
handl e->i d_t abl e也是一个i nput_devi ce_i d类型的指针,其表示驱动支持的设备列表。
i nput_m at ch_devi ce()函数用来与i nput_dev和handl er进行匹配。
handl er的i d_t abl e表中定义了其支持的i nput_dev设备。
该函数的代码如下:
Java代码
7.static const struct input_device_id*input_match_device(struct input_handler*handler,struct input_
dev*dev)
8.{
9.const struct input_device_id*id;
10.int i;//声明一个局部变量i,用于循环。
11.
12./*是一个for循环,用来匹配id和dev->id中的信息,只要有一项相同则返回。
*/
13.for(id=handler->id_table;id->flags||id->driver_info;id++){
14./*用来匹配总线类型。
id->flags中定义了要匹配的项,其中INPUT_DEVICE_ID_MATCH_BUS如果没
有设置,则比较input device和input handler的总线类型。
*/
15.if(id->flags&INPUT_DEVICE_ID_MATCH_BUS)
16.if(id->bustype!=dev->id.bustype)
17.continue;
18.
19.if(id->flags&INPUT_DEVICE_ID_MATCH_VENDOR)//匹配设备厂商的信息。
20.
21.if(id->vendor!=dev->id.vendor)
22.continue;
23.
24.if(id->flags&INPUT_DEVICE_ID_MATCH_PRODUCT)//分别匹配设备号的信息。
25.
26.if(id->product!=dev->id.product)
27.continue;
28.
29.if(id->flags&INPUT_DEVICE_ID_MATCH_VERSION)
30.if(id->version!=dev->id.version)
31.continue;
32./*使用MATCH_BIT匹配项。
如果id->flags定义的类型匹配成功,或者id->flags没有定义,才会进入到MATCH_
BIT的匹配项。
*/
33.MATCH_BIT(evbit,EV_MAX);
34.MATCH_BIT(keybit,KEY_MAX);
35.MATCH_BIT(relbit,REL_MAX);
36.MATCH_BIT(absbit,ABS_MAX);
37.MATCH_BIT(mscbit,MSC_MAX);
38.MATCH_BIT(ledbit,LED_MAX);
39.MATCH_BIT(sndbit,SND_MAX);
40.MATCH_BIT(ffbit,FF_MAX);
41.MATCH_BIT(swbit,SW_MAX);
42.
43.if(!handler->match||handler->match(handler,dev))
44.return id;
45.}
46.
47.return NULL;
48.}
从M A TC H_B I T宏的定义可以看出。
只有当i putdevi ce和i nputhandl er的I D成员在evbi t、keybi t、... sw bi t项相同才会匹配成功。
而且匹配的顺序是从evbi t、keybi t到sw bi t。
只要有一项不同,就会循环到I D中的下一项进行比较。
你可以继续阅读:i nput子系统学习笔记六按键驱动实例分析下
in pu t子系统学习笔记六按键驱动实例分析下
本文接着i nput子系统学习笔记五按键驱动实例分析上接续分析这个按键驱动实例!
i nput_report_key()向子系统报告事件
在but t on_i nt er rupt()中断函数中,不需要考虑重复按键的重复点击情况,i nput_r eport_key()函数会自动检查这个问题,并报告一次事件给输入子系统。
该函数的代码如下:
C++代码
54.static inline void input_report_key(struct input_dev*dev,unsigned int
55.code,int value)
56.{
57.input_event(dev,EV_KEY,code,!!value);
58.}
该函数的第1个参数是产生事件的输入设备,第2个参数是产生的事件,第3个参数是事件的值。
需要注意的是,2个参数可以取类似B TN_0、B TN_1、B TN_LE FT、B TN_R I G H T等值,这些键值被定义在i ncl ude
/l i nux/i nput.h文件中。
当第2个参数为按键时,第3个参数表示按键的状态,val ue值为0表示按键释放,非0表示按键按下。
i nput_event()
在i nput_r epor t_key()函数中正在起作用的函数是i nput_event()函数,该函数用来向输入子系统报告输入设备产生的事件,这个函数非常重要,它的代码如下:
Java代码
19.void input_event(struct input_dev*dev,unsigned int type,unsigned int code,int value)
20.{
21.unsigned long flags;
22./*调用is_event_supported()函数检查输入设备是否支持该事件*/
23.if(is_event_supported(type,dev->evbit,EV_MAX)){
24.
25.spin_lock_irqsave(&dev->event_lock,flags);//调用spin_lock_irqsave()函数对将事件锁锁定。
26.add_input_randomness(type,code,value);//add_input_randomness()函数对事件发送没有一点用处,只
是用来对随机数熵池增加一些贡献,因为按键输入是一种随机事件,所以对熵池是有贡献的。
27.input_handle_event(dev,type,code,value);//调用input_handle_event()函数来继续输入子系统的
相关模块发送数据。
该函数较为复杂,下面单独进行分析。
28.spin_unlock_irqrestore(&dev->event_lock,flags);
29.}
30.}
i s_event_support ed()
C++代码
70.static inline int is_event_supported(unsigned int code,
71.unsigned long*bm,unsigned int max)
72.{
73.return code<=max&&test_bit(code,bm);
74.}
该函数检查i nput_dev.evbi t中的相应位是否设置,如果设置返回1,否则返回0。
每一种类型的事件都在
i nput_dev.evbi t中用一个位来表示,构成一个位图,如果某位为1,表示该输入设备支持这类事件,如果为0,表示输入设备不支持这类事件。
目前Li nux支持十多种事件类型,所以用一个l ong型变量就可以全部表示了。
i nput_handl e_event()
i nput_handl e_event()函数向输入子系统传送事件信息。
第1个参数是输入设备i nput_dev,第2个参数是事件的类型,第3个参数是键码,第4个参数是键值。
该函数的代码如下:
C++代码
33.static void input_handle_event(struct input_dev*dev,
34.unsigned int type,unsigned int code,int value)
35.{
36.int disposition=INPUT_IGNORE_EVENT;//定义了一个disposition变量,该变量表示使用什么样的方式处理事
件。
此处初始化为INPUT_IGNORE_EVENT,表示如果后面没有对该变量重新赋值,则忽略这个事件。
37.switch(type){
38.
39.case EV_SYN:
40.switch(code){
41.case SYN_CONFIG:
42.disposition=INPUT_PASS_TO_ALL;
43.break;
44.
45.case SYN_REPORT:
46.if(!dev->sync){
47.dev->sync=1;
48.disposition=INPUT_PASS_TO_HANDLERS;
49.}
50.break;
51.case SYN_MT_REPORT:
52.dev->sync=0;
53.disposition=INPUT_PASS_TO_HANDLERS;
54.break;
55.}
56.break;
57.
58.case EV_KEY:
59.//调用is_event_supported()函数判断是否支持该按键。
60.
61.if(is_event_supported(code,dev->keybit,KEY_MAX)&&
62.!!test_bit(code,dev->key)!=value){
63.//调用test_bit()函数来测试按键状态是否改变。
64.if(value!=2){
65.__change_bit(code,dev->key);/*调用__change_bit()函数改变键的状态。
*/
66.
67.if(value)
68.input_start_autorepeat(dev,code);/*处理重复按键的情况。
*/
69.
70.else
71.input_stop_autorepeat(dev);
72.}
73.
74.disposition=INPUT_PASS_TO_HANDLERS;/*将disposition变量设置为INPUT_PASS_TO_HANDLERS,表示
事件需要handler来处理。
disposition的取值有如下几种:
75. 1.#define INPUT_IGNORE_EVENT0
76. 2.#define INPUT_PASS_TO_HANDLERS1
77. 3.#define INPUT_PASS_TO_DEVICE2
78. 4.#define INPUT_PASS_TO_ALL(INPUT_PASS_TO_HANDLERS|INPUT_PASS_TO_DEVICE)
79.INPUT_IGNORE_EVENT表示忽略事件,不对其进行处理。
INPUT_PASS_TO_HANDLERS表示将事件交给handler
处理。
INPUT_PASS_TO_DEVICE表示将事件交给input_dev处理。
INPUT_PASS_TO_ALL表示将事件交给handler和input_d ev共同处理。
*/
80.
81.}
82.break;
83.
84.case EV_SW:
85.if(is_event_supported(code,dev->swbit,SW_MAX)&&
86.!!test_bit(code,dev->sw)!=value){
87.
88.__change_bit(code,dev->sw);
89.disposition=INPUT_PASS_TO_HANDLERS;
90.}
91.break;
92.
93.case EV_ABS:
94.if(is_event_supported(code,dev->absbit,ABS_MAX)){
95.
96.if(test_bit(code,input_abs_bypass)){
97.disposition=INPUT_PASS_TO_HANDLERS;
98.break;
99.}
100.
101.value=input_defuzz_abs_event(value,
102.dev->abs[code],dev->absfuzz[code]);
103.
104.if(dev->abs[code]!=value){
105.dev->abs[code]=value;
106.disposition=INPUT_PASS_TO_HANDLERS;
107.}
108.}
109.break;
110.
111.case EV_REL:
112.if(is_event_supported(code,dev->relbit,REL_MAX)&&value)
113.disposition=INPUT_PASS_TO_HANDLERS;
114.
115.break;
116.
117.case EV_MSC:
118.if(is_event_supported(code,dev->mscbit,MSC_MAX))
119.disposition=INPUT_PASS_TO_ALL;
120.
121.break;
122.
123.case EV_LED:
124.if(is_event_supported(code,dev->ledbit,LED_MAX)&&
125.!!test_bit(code,dev->led)!=value){
126.
127.__change_bit(code,dev->led);
128.disposition=INPUT_PASS_TO_ALL;
129.}
130.break;
131.
132.case EV_SND:
133.if(is_event_supported(code,dev->sndbit,SND_MAX)){
134.
135.if(!!test_bit(code,dev->snd)!=!!value)
136.__change_bit(code,dev->snd);
137.disposition=INPUT_PASS_TO_ALL;
138.}
139.break;
140.
141.case EV_REP:
142.if(code<=REP_MAX&&value>=0&&dev->rep[code]!=value){
143.dev->rep[code]=value;
144.disposition=INPUT_PASS_TO_ALL;
145.}
146.break;
147.
148.case EV_FF:
149.if(value>=0)
150.disposition=INPUT_PASS_TO_ALL;
151.break;
152.
153.case EV_PWR:
154.disposition=INPUT_PASS_TO_ALL;
155.break;
156.}
157.
158.if(disposition!=INPUT_IGNORE_EVENT&&type!=EV_SYN)/*处理EV_SYN事件,这里并不对其进行关心。
*/ 159.
160.dev->sync=0;
161./*首先判断disposition等于INPUT_PASS_TO_DEVICE,然后判断dev->event是否对其指定了一个处理函数,如果这些条件都满足,则调用自定义的dev->event()函数处理事件。
有些事件是发送给设备,而不是发送给handler处理的。
event ()函数用来向输入子系统报告一个将要发送给设备的事件,例如让LED灯点亮事件、蜂鸣器鸣叫事件等。
当事件报告给输入子系统后,就要求设备处理这个事件。
*/
162.if((disposition&INPUT_PASS_TO_DEVICE)&&dev->event)
163.dev->event(dev,type,code,value);
164./*第87、88行,如果事件需要handler处理,则调用input_pass_event()函数
165.*/
166.if(disposition&INPUT_PASS_TO_HANDLERS)
167.input_pass_event(dev,type,code,value);
168.}
i nput_pass_event()
i nput_pass_event()函数将事件传递到合适的函数,然后对其进行处理,该函数的代码如下:
C++代码
28.static void input_pass_event(struct input_dev*dev,
29.unsigned int type,unsigned int code,int value)
30.{
31.struct input_handler*handler;
32.struct input_handle*handle;/*分配一个input_handle结构的指针。
*/
33.rcu_read_lock();
34.
35.handle=rcu_dereference(dev->grab);/*得到dev->grab的指针。
36.grab是强制为input device的handler,这时要调用handler的event函数。
*/
37.if(handle)
38.handle->handler->event(handle,type,code,value);
39.else{
40.bool filtered=false;
41.
42.
43./*表示如果没有为input device强制指定handler,为grab赋值,即就会遍历input device->h_list上的handl
e成员。
如果该handle被打开,表示该设备已经被一个用户进程使用。
就会调用与输入设备对应的handler的event()函数。
注意,只有在handle被打开的情况下才会接收到事件,这就是说,只有设备被用户程序使用时,才有必要向用户空间导出信息。
*/
44.list_for_each_entry_rcu(handle,&dev->h_list,d_node){
45.if(!handle->open)
46.continue;
47.
48.handler=handle->handler;
49.if(!handler->filter){
50.if(filtered)
51.break;
52.
53.handler->event(handle,type,code,value);
54.
55.}else if(handler->filter(handle,type,code,value))
56.filtered=true;
57.}
58.}
in pu t子系统学习笔记七h a n d le r处理器注册分析
i nput_handl er是输入子系统的主要数据结构,一般将其称为handl er处理器,表示对输入事件的具体处理。
i nput_handl er为输入设备的功能实现了一个接口,输入事件最终传递到handl er处理器,handl er处理器根据一定的规则,然后对事件进行处理,具体的规则将在下面详细介绍。
关键数据结构
st ructi nput_dev物理输入设备的基本数据结构,包含设备相关的一些信息
st ructi nput_handl er事件处理结构体,定义怎么处理事件的逻辑
st ructi nput_handl e用来创建i nput_dev和i nput_handl er之间关系的结构体
i nput_handl er结构体
i nput_handl er是输入设备的事件处理接口,为处理事件提供一个统一的函数模板,程序员应该根据具体的需要实现其中的一些函数,并将其注册到输入子系统中。
该结构体的定义如下:
C/C++代码
59.struct input_handler{
60.void*private;/*定义了一个private指针,表示驱动特定的数据。
这里的驱动指的就是handler处理器。
*/
61.void(*event)(struct input_handle*handle,unsigned int type,
62.unsigned int code,int value);/*定义了一个event()处理函数,这个函数将被输入子系统调用去处理发送给设备
的事件。
例如将发送一个事件命令LED灯点亮,实际控制硬件的点亮操作就可以放在event()函数中实现。
*/
63.int(*connect)(struct input_handler*handler,struct input_dev
64.*dev,const struct input_device_id*id);/*定义了一个connect()函数,该函数用来连接handle
r和input_dev。
在input_attach_handler()函数的第10行,就是回调的这个自定义函数。
*/
65.void(*disconnect)(struct input_handle*handle);
66.void(*start)(struct input_handle*handle);
67.const struct file_operations*fops;/*表示handler实现的文件操作集,这里不是很重要。
*/
68.int minor;//表示设备的次设备号。
69.const char*name;/*表示handler的名字,显示在/proc/bus/input/handlers目录中。
*/
70.const struct input_device_id*id_table;/*定义了一个id_table表,表示驱动能够处理的表。
*/
71.const struct input_device_id*blacklist;/*指向一个input_device_id表,这个表包含handler应该忽略的
设备。
*/
72.struct list_head h_list;/*定义了一个链表h_list,表示与这个input_handler相联系的下一个handler。
*/
73.struct list_head node;/*定义了一个链表node,将其连接到全局的input_handler_list链表中,所有的input_
handler都连接在其上。
*/
74.};
i nput_handl e结构体
i nput_r egi st er_handl e()函数用来注册一个新的handl e到输入子系统中。
i nput_handl e的主要功能是用来连接i nput_dev和i nput_handl er。
其结构如下:
C/C++代码
31.struct input_handle{
32.void*private;/*定义了private表示handler特定的数据。
*/
33.int open;/*定义了一个open变量,表示handle是否正在被使用,当使用时,会将事件分发给设备处理。
*/
34.const char*name;/*定义了一个name变量,表示handle的名字。
*/
35.struct input_dev*dev;/*定义了dev变量指针,表示该handle依附的input_dev设备。
*/
36.struct input_handler*handler;/*定义了一个handler变量指针,指向input_handler,该handler处理器就
是与设备相关的处理器。
*/
37.struct list_head d_node;/*定义了一个d_node变量,使用这个变量将handle放到设备相关的链表中,也就是放
到input_dev->h_list表示的链表中。
*/
38.struct list_head h_node;/*定义了一个h_node变量,使用这个变量将handle放到input_handler相关的链表
中,也就是放到handler->h_list表示的链表中。
*/
39.};
注册i nput_handl er
i nput_r egi st er_handl er()函数注册一个新的i nputhandl er处理器。
这个handl er将为输入设备使用,一个handl er可以添加到多个支持它的设备中,也就是一个handl er可以处理多个输入设备的事件。
函数的参数传入简要注册的i nput_handl er指针,该函数的代码如下:
C/C++代码
75.int input_register_handler(struct input_handler*handler)
76.{
77.struct input_dev*dev;
78.int retval;
79.
80.retval=mutex_lock_interruptible(&input_mutex);/*对input_mutex进行了加锁。
当加锁失败后,则返回。
*/
81.if(retval)
82.return retval;
83.
84.INIT_LIST_HEAD(&handler->h_list);/*初始化h_hlist链表,该链表连接与这个input_handler相联系的下一
个handler。
*/
85.
86.if(handler->fops!=NULL){/*其中的handler->minor表示对应input设备结点的次设备号。
handler->mino
r以右移5位作为索引值插入到input_table[]中,*/
87.if(input_table[handler->minor>>5]){
88.retval=-EBUSY;
89.goto out;
90.}
91.input_table[handler->minor>>5]=handler;
92.}
93.
94.list_add_tail(&handler->node,&input_handler_list);/*调用list_add_tail()函数,将handler加入全
局的input_handler_list链表中,该链表包含了系统中所有的input_handler。
*/
95.
96.list_for_each_entry(dev,&input_dev_list,node)
97.input_attach_handler(dev,handler);/*input_attach_handler()函数的作用是匹配input_dev_list链表
中的input_dev与handler。
如果成功会将input_dev与handler联系起来。
*/
98.input_wakeup_procfs_readers();
99.out:
100.mutex_unlock(&input_mutex);/*解互斥锁并退出。
*/
101.return retval;
102.}
注册i nput_handl e
i nput_handl e是用来连接i nput_dev和i nput_handl er的一个中间结构体。
事件通过i nput_handl e从
i nput_dev发送到i nput_handl er,或者从i nput_handl er发送到i nput_dev进行处理。
在使用i nput_handl e 之前,需要对其进行注册,注册函数是i nput_r egi st er_handl e()。
注册函数i nput_r egi st er_handl e()
i nput_r egi st er_handl e()函数用来注册一个新的handl e到输入子系统中。
该函数接收一个i nput_handl e类型的指针,该变量要在注册前对其成员初始化。
i nput_r egi st er_handl e()函数的代码如下:
C/C++代码
169.int input_register_handle(struct input_handle*handle)
170.{
171.struct input_handler*handler=handle->handler;/*从handle中取出一个指向input_handler的指针,为下面的操作使用。
*/
172.struct input_dev*dev=handle->dev;/*从handle中取出一个指向input_dev的指针,为下面的操作使用。
*/ 173.int error;
174.
175./*
176.*We take dev->mutex here to prevent race with
177.*input_release_device().
178.*/
179.error=mutex_lock_interruptible(&dev->mutex);/*给竞争区域加一个互斥锁。
*/
180.if(error)
181.return error;
182.
183./*
184.*Filters go to the head of the list,normal handlers
185.*to the tail.
186.*/
187.if(handler->filter)
188.list_add_rcu(&handle->d_node,&dev->h_list);
189.else
190.list_add_tail_rcu(&handle->d_node,&dev->h_list);/*调用list_add_tail_rcu()函数将handle加入输入设备的dev->h_list链表中。
*/
191.
192.mutex_unlock(&dev->mutex);
193.
194./*
195.*Since we are supposed to be called from->connect()
196.*which is mutually exclusive with->disconnect()
197.*we can't be racing with input_unregister_handle()
198.*and so separate lock is not needed here.
199.*/
200.list_add_tail_rcu(&handle->h_node,&handler->h_list);
201.
202.if(handler->start)/*如果定义了start()函数,则调用它。
*/
203.handler->start(handle);
204.
205.return0;
206.}
三者之间的关系
结点1、2、3表示i nput_dev设备,其通过i nput_dev->node变量连接到全局输入设备链i nput_dev_l i st中.结点4、5、6表示i nput_handl er处理器,其通过i nput_handl er->node连接到全局handl er处理器链表
i nput_handl er_l i st中。
结点7是一个i nput_handl e的结构体,其用来连接i nput_dev和i nput_handl er。
i nput_handl e的dev成员指向了对应的i nput_dev设备,i nput_handl e的handl er成员指向了对应的
i nput_handl er。
外结点7的i nput_handl e另设备,通过d_node连接到了结点2的i nput_dev上的h_l i st链表上。
另一方面,结点7的i nput_handl e通过h_node连接到了结点5的i nput_handl er的h_l i st链表上。
通过这种关系, i nput_dev将和i nput_handl er联系了起来。
in pu t子系统学习笔记八in pu t子系统的详细分析
为了对输入子系统有一个清晰的认识,本节将分析输入系统的初始化过程。
在Li nux中,输入子系统作为一个模块存在,向上,为用户层提供接口函数,向下,为驱动层程序提供统一的接口函数。
这样,就能够使输入设备的事件通过输入子系统发送给用户层应用程序,用户层应用程序也可以通过输入子系统通知驱动程序完成某项功能。
子系统初始化函数i nput_i ni t()
输入子系统作为一个模块存在,必然有一个初始化函数。
在/dri vers/i nput/i nput.c文件中定义了输入子系统的初始化函数i nput_i ni t(),该函数的代码如下:
C/C++代码
75.static int__init input_init(void)
76.{
77.int err;
78.input_init_abs_bypass();
79.err=class_register(&input_class);
80./*调用class_register()函数先注册了一个名为input的类。
所有input device都属于这个类。
在sysfs中表现就是,
所有input device所代表的目录都位于/dev/class/input下面。
81.代码如下:
82.struct class input_class={
="input",
84.};*/
85.if(err){
86.printk(KERN_ERR"input:unable to register input_dev class\n");
87.return err;
88.}
89.
90.err=input_proc_init();/*调用input_proc_init()在/proc下面建立相关的交互文件。
*/
91.if(err)
92.goto fail1;
93.
94.err=register_chrdev(INPUT_MAJOR,"input",&input_fops);/*调用register_chrdev()注册了主设备号为
INPUT_MAJOR(13)。
次设备号为0~255的字符设备。
它的操作指针为input_fops。
在这里,可以看到所有主设备号13的字符设备的操作最终都会转入到input_fops中。
例如/dev/input/event0~/dev/input/event4的主设备号为13,对其的操作会落在input_fops中。
input_fops只定义了一个input_open_file()函数,input_fops的定义代码如下:
95.static const struct file_operations input_fops={
96..owner=THIS_MODULE,
97..open=input_open_file,
98.};*/
99.if(err){
100.printk(KERN_ERR"input:unable to register char major%d",
101.INPUT_MAJOR);
102.goto fail2;
103.}
104.
105.return0;
106.
107.fail2:input_proc_exit();
108.fail1:class_unregister(&input_class);
109.return err;
110.}
文件打开函数i nput_open_f i l e()
文件操作指针中定义了i nput_open_f i l e()函数,该函数将控制转到i nput_handl er中定义的f ops文件指针的open()函数。
该函数在i nput_handl er中实现,这样就使不同的handl er处理器对应了不同的文件打开方法,为完成不同功能提供了方便。
i nput_open_f i l e()函数的代码如下:
C/C++代码
40.static int input_open_file(struct inode*inode,struct file*file)
41.{
42.struct input_handler*handler;
43.const struct file_operations*old_fops,*new_fops=NULL;
44.int err;
45.
46.err=mutex_lock_interruptible(&input_mutex);
47.if(err)
48.return err;
49.
50./*No load-on-demand here?*/
51.handler=input_table[iminor(inode)>>5];/*出现了熟悉的input_table[]数组。
iminor(inode)为打开文
件所对应的次设备号。
input_table是一个struct input_handler全局数组,只有8个元素,其定义为:
52.static struct input_handler*input_table[8];
53.在这里,首先将设备结点的次设备号右移5位做为索引值到input_table中取对应项,从这里也可以看到,一个handl。