input子系统学习笔记六 按键驱动实例分析下【转】

转自：http://blog.chinaunix.net/uid-20776117-id-3212095.html

本文接着input子系统学习笔记五 按键驱动实例分析上接续分析这个按键驱动实例！

input_report_key()向子系统报告事件

在 button_interrupt()中断函数中,不需要考虑重复按键的重复点击情况,input_report_key()函数会自动检查这个问题,并报告一次事件给输入子系统。该函数的代码如下:

C++代码

1. static inline void input_report_key(struct input_dev *dev,unsigned int
2. code, int value)
3. {
4. input_event(dev, EV_KEY, code, !!value);
5. }

该函数的第 1 个参数是产生事件的输入设备, 第2 个参数是产生的事件, 第3 个参数是事件的值。需要注意的是, 2 个参数可以取类似 BTN_0、 BTN_1、BTN_LEFT、BTN_RIGHT 等值,这些键值被定义在 include/linux/input.h 文件中。当第 2 个参数为按键时,第 3 个参数表示按键的状态,value 值为 0 表示按键释放,非 0 表示按键按下。

input_event()

在 input_report_key()函数中正在起作用的函数是 input_event()函数,该函数用来向输入子系统报告输入设备产生的事件,这个函数非常重要,它的代码如下:

Java代码

1. void input_event(struct input_dev *dev,unsigned int type, unsigned int code, int value)
2. {
3. unsigned long flags;
4. /*调用 is_event_supported()函数检查输入设备是否支持该事件*/
5. if (is_event_supported(type, dev->evbit, EV_MAX)) {
6. spin_lock_irqsave(&dev->event_lock, flags);//调用 spin_lock_irqsave()函数对将事件锁锁定。
7. add_input_randomness(type,code,value);//add_input_randomness()函数对事件发送没有一点用处,只是用来对随机数熵池增加一些贡献,因为按键输入是一种随机事件,所以对熵池是有贡献的。
8. input_handle_event(dev, type, code, value);//调用 input_handle_event()函数来继续输入子系统的相关模块发送数据。该函数较为复杂,下面单独进行分析。
9. spin_unlock_irqrestore(&dev->event_lock, flags);
10. }
11. }

is_event_supported()

C++代码

1. static inline int is_event_supported(unsigned int code,
2. unsigned long *bm, unsigned int max)
3. {
4. return code <= max && test_bit(code, bm);
5. }

该函数检查 input_dev.evbit 中的相应位是否设置,如果设置返回 1,否则返回 0。每一种类型的事件都在 input_dev.evbit 中用一个位来表示,构成一个位图,如果某位为 1,表示该输入设备支持这类事件,如果为 0,表示输入设备不支持这类事件。目前 Linux 支持十多种事件类型,所以用一个 long 型变量就可以全部表示了。

input_handle_event()

input_handle_event()函数向输入子系统传送事件信息。第 1 个参数是输入设备 input_dev,第 2 个参数是事件的类型,第 3 个参数是键码,第 4 个参数是键值。该函数的代码如下:

C++代码

1. static void input_handle_event(struct input_dev *dev,
2. unsigned int type, unsigned int code, int value)
3. {
4. int disposition = INPUT_IGNORE_EVENT;//定义了一个 disposition 变量,该变量表示使用什么样的方式处理事件。此处初始化为 INPUT_IGNORE_EVENT,表示如果后面没有对该变量重新赋值,则忽略这个事件。
5. switch (type) {
6. case EV_SYN:
7. switch (code) {
8. case SYN_CONFIG:
9. disposition = INPUT_PASS_TO_ALL;
10. break;
11. case SYN_REPORT:
12. if (!dev->sync) {
13. dev->sync = 1;
14. disposition = INPUT_PASS_TO_HANDLERS;
15. }
16. break;
17. case SYN_MT_REPORT:
18. dev->sync = 0;
19. disposition = INPUT_PASS_TO_HANDLERS;
20. break;
21. }
22. break;
23. case EV_KEY:
24. //调用 is_event_supported()函数判断是否支持该按键。
25. if (is_event_supported(code, dev->keybit, KEY_MAX) &&
26. !!test_bit(code, dev->key) != value) {
27. //调用 test_bit()函数来测试按键状态是否改变。
28. if (value != 2) {
29. __change_bit(code,dev->key);/*调用__change_bit()函数改变键的状态。*/
30. if (value)
31. input_start_autorepeat(dev, code);/*处理重复按键的情况。*/
32. else
33. input_stop_autorepeat(dev);
34. }
35. disposition = INPUT_PASS_TO_HANDLERS;/*将 disposition变量设置为 INPUT_PASS_TO_HANDLERS,表示事件需要 handler 来处理。disposition 的取值有如下几种:
36. 1. #define INPUT_IGNORE_EVENT 0
37. 2. #define INPUT_PASS_TO_HANDLERS 1
38. 3. #define INPUT_PASS_TO_DEVICE 2
39. 4.#define INPUT_PASS_TO_ALL(INPUT_PASS_TO_HANDLERS | INPUT_PASS_TO_DEVICE)
40. INPUT_IGNORE_EVENT 表示忽略事件,不对其进行处理。INPUT_PASS_ TO_HANDLERS 表示将事件交给handler处理。INPUT_PASS_TO_DEVICE 表示将事件交给 input_dev 处理。INPUT_PASS_TO_ALL 表示将事件交给 handler 和 input_dev 共同处理。 */
41. }
42. break;
43. case EV_SW:
44. if (is_event_supported(code, dev->swbit, SW_MAX) &&
45. !!test_bit(code, dev->sw) != value) {
46. __change_bit(code, dev->sw);
47. disposition = INPUT_PASS_TO_HANDLERS;
48. }
49. break;
50. case EV_ABS:
51. if (is_event_supported(code, dev->absbit, ABS_MAX)) {
52. if (test_bit(code, input_abs_bypass)) {
53. disposition = INPUT_PASS_TO_HANDLERS;
54. break;
55. }
56. value = input_defuzz_abs_event(value,
57. dev->abs[code], dev->absfuzz[code]);
58. if (dev->abs[code] != value) {
59. dev->abs[code] = value;
60. disposition = INPUT_PASS_TO_HANDLERS;
61. }
62. }
63. break;
64. case EV_REL:
65. if (is_event_supported(code, dev->relbit, REL_MAX) && value)
66. disposition = INPUT_PASS_TO_HANDLERS;
67. break;
68. case EV_MSC:
69. if (is_event_supported(code, dev->mscbit, MSC_MAX))
70. disposition = INPUT_PASS_TO_ALL;
71. break;
72. case EV_LED:
73. if (is_event_supported(code, dev->ledbit, LED_MAX) &&
74. !!test_bit(code, dev->led) != value) {
75. __change_bit(code, dev->led);
76. disposition = INPUT_PASS_TO_ALL;
77. }
78. break;
79. case EV_SND:
80. if (is_event_supported(code, dev->sndbit, SND_MAX)) {
81. if (!!test_bit(code, dev->snd) != !!value)
82. __change_bit(code, dev->snd);
83. disposition = INPUT_PASS_TO_ALL;
84. }
85. break;
86. case EV_REP:
87. if (code <= REP_MAX && value >= 0 && dev->rep[code] != value) {
88. dev->rep[code] = value;
89. disposition = INPUT_PASS_TO_ALL;
90. }
91. break;
92. case EV_FF:
93. if (value >= 0)
94. disposition = INPUT_PASS_TO_ALL;
95. break;
96. case EV_PWR:
97. disposition = INPUT_PASS_TO_ALL;
98. break;
99. }
100. if (disposition != INPUT_IGNORE_EVENT && type != EV_SYN)/*处理 EV_SYN 事件,这里并不对其进行关心。*/
101. dev->sync = 0;
102. /*首先判断 disposition 等于 INPUT_PASS_TO_DEVICE,然后判断 dev->event 是否对其指定了一个处理函数,如果这些条件都满足,则调用自定义的 dev->event()函数处理事件。有些事件是发送给设备,而不是发送给 handler 处理的。event()函数用来向输入子系统报告一个将要发送给设备的事件,例如让 LED 灯点亮事件、蜂鸣器鸣叫事件等。当事件报告给输入子系统后,就要求设备处理这个事件。*/
103. if ((disposition & INPUT_PASS_TO_DEVICE) && dev->event)
104. dev->event(dev, type, code, value);
105. /*第 87、88 行,如果事件需要 handler 处理,则调用 input_pass_event()函数
106. */
107. if (disposition & INPUT_PASS_TO_HANDLERS)
108. input_pass_event(dev, type, code, value);
109. }

input_pass_event()

input_pass_event()函数将事件传递到合适的函数,然后对其进行处理,该函数的代码如下:

C++代码

1. static void input_pass_event(struct input_dev *dev,
2. unsigned int type, unsigned int code, int value)
3. {
4. struct input_handler *handler;
5. struct input_handle *handle;/*分配一个 input_handle 结构的指针。*/
6. rcu_read_lock();
7. handle = rcu_dereference(dev->grab);/*得到 dev->grab 的指针。
8. grab 是强制为 input device 的 handler,这时要调用 handler的 event 函数。*/
9. if (handle)
10. handle->handler->event(handle, type, code, value);
11. else {
12. bool filtered = false;
13. /*表示如果没有为 input device 强制指定 handler,为 grab 赋值,即就会遍历 input device->h_list 上的 handle 成员。如果该 handle 被打开,表示该设备已经被一个用户进程使用。就会调用与输入设备对应的 handler 的 event()函数。注意,只有在 handle 被打开的情况下才会接收到事件,这就是说,只有设备被用户程序使用时,才有必要向用户空间导出信息。*/
14. list_for_each_entry_rcu(handle, &dev->h_list, d_node) {
15. if (!handle->open)
16. continue;
17. handler = handle->handler;
18. if (!handler->filter) {
19. if (filtered)
20. break;
21. handler->event(handle, type, code, value);
22. } else if (handler->filter(handle, type, code, value))
23. filtered = true;
24. }
25. }