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

 input_report_key()向子系统报告事件

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

C++代码

 static inline void input_report_key(struct input_dev *dev,unsigned int
 code, int value)
 {
         input_event(dev, EV_KEY, code, !!value);
 }

        该函数的第 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代码

 void input_event(struct input_dev *dev,unsigned int type, unsigned int code, int value)
 {
         unsigned long flags;
         /*调用 is_event_supported()函数检查输入设备是否支持该事件*/
         if (is_event_supported(type, dev->evbit, EV_MAX)) {

                 spin_lock_irqsave(&dev->event_lock, flags);//调用 spin_lock_irqsave()函数对将事件锁锁定。
                 add_input_randomness(type,code,value);//add_input_randomness()函数对事件发送没有一点用处,只是用来对随机数熵池增加一些贡献,因为按键输入是一种随机事件,所以对熵池是有贡献的。
                 input_handle_event(dev, type, code, value);//调用 input_handle_event()函数来继续输入子系统的相关模块发送数据。该函数较为复杂,下面单独进行分析。
                 spin_unlock_irqrestore(&dev->event_lock, flags);
         }
 }

        is_event_supported()

C++代码

 static inline int is_event_supported(unsigned int code,
 unsigned long *bm, unsigned int max)
 {
         return code <= max && test_bit(code, bm);
 }

        该函数检查 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++代码

 static void input_handle_event(struct input_dev *dev,
 unsigned int type, unsigned int code, int value)
 {
         int disposition = INPUT_IGNORE_EVENT;//定义了一个 disposition 变量,该变量表示使用什么样的方式处理事件。此处初始化为 INPUT_IGNORE_EVENT,表示如果后面没有对该变量重新赋值,则忽略这个事件。
         switch (type) {

         case EV_SYN:
                 switch (code) {
                         case SYN_CONFIG:
                                 disposition = INPUT_PASS_TO_ALL;
                                 break;

                         case SYN_REPORT:
                                 if (!dev->sync) {
                                         dev->sync = 1;
                                         disposition = INPUT_PASS_TO_HANDLERS;
                                 }
                                 break;
                         case SYN_MT_REPORT:
                                 dev->sync = 0;
                                 disposition = INPUT_PASS_TO_HANDLERS;
                                 break;
                 }
         break;

         case EV_KEY:
         //调用 is_event_supported()函数判断是否支持该按键。

                 if (is_event_supported(code, dev->keybit, KEY_MAX) &&
                 !!test_bit(code, dev->key) != value) {
                         //调用 test_bit()函数来测试按键状态是否改变。
                         if (value != 2) {
                                 __change_bit(code,dev->key);/*调用__change_bit()函数改变键的状态。*/

                                         if (value)
                                                 input_start_autorepeat(dev, code);/*处理重复按键的情况。*/

                                         else
                                                 input_stop_autorepeat(dev);
                         }

                 disposition = INPUT_PASS_TO_HANDLERS;/*将 disposition变量设置为 INPUT_PASS_TO_HANDLERS,表示事件需要 handler 来处理。disposition 的取值有如下几种:
                         1. #define INPUT_IGNORE_EVENT 0
                         2. #define INPUT_PASS_TO_HANDLERS 1
                         3. #define INPUT_PASS_TO_DEVICE 2
                         4.#define INPUT_PASS_TO_ALL(INPUT_PASS_TO_HANDLERS | INPUT_PASS_TO_DEVICE)
                 INPUT_IGNORE_EVENT 表示忽略事件,不对其进行处理。INPUT_PASS_ TO_HANDLERS 表示将事件交给handler处理。INPUT_PASS_TO_DEVICE 表示将事件交给 input_dev 处理。INPUT_PASS_TO_ALL 表示将事件交给 handler 和 input_dev 共同处理。 */

         }
         break;

         case EV_SW:
                 if (is_event_supported(code, dev->swbit, SW_MAX) &&
                         !!test_bit(code, dev->sw) != value) {

                         __change_bit(code, dev->sw);
                         disposition = INPUT_PASS_TO_HANDLERS;
                 }
                 break;

         case EV_ABS:
                 if (is_event_supported(code, dev->absbit, ABS_MAX)) {

                 if (test_bit(code, input_abs_bypass)) {
                         disposition = INPUT_PASS_TO_HANDLERS;
                         break;
                     }

         value = input_defuzz_abs_event(value,
         dev->abs[code], dev->absfuzz[code]);

                 if (dev->abs[code] != value) {
                         dev->abs[code] = value;
                         disposition = INPUT_PASS_TO_HANDLERS;
                 }
         }
         break;

         case EV_REL:
                 if (is_event_supported(code, dev->relbit, REL_MAX) && value)
                         disposition = INPUT_PASS_TO_HANDLERS;

                         break;

         case EV_MSC:
                 if (is_event_supported(code, dev->mscbit, MSC_MAX))
                         disposition = INPUT_PASS_TO_ALL;

                 break;

         case EV_LED:
                 if (is_event_supported(code, dev->ledbit, LED_MAX) &&
                         !!test_bit(code, dev->led) != value) {

                         __change_bit(code, dev->led);
                         disposition = INPUT_PASS_TO_ALL;
         }
         break;

         case EV_SND:
                 if (is_event_supported(code, dev->sndbit, SND_MAX)) {

                         if (!!test_bit(code, dev->snd) != !!value)
                 __change_bit(code, dev->snd);
                 disposition = INPUT_PASS_TO_ALL;
                 }
         break;

         case EV_REP:
         if (code <= REP_MAX && value >= 0 && dev->rep[code] != value) {
                 dev->rep[code] = value;
                 disposition = INPUT_PASS_TO_ALL;
         }
         break;

         case EV_FF:
         if (value >= 0)
                 disposition = INPUT_PASS_TO_ALL;
                 break;

         case EV_PWR:
                 disposition = INPUT_PASS_TO_ALL;
         break;
         }

         if (disposition != INPUT_IGNORE_EVENT && type != EV_SYN)/*处理 EV_SYN 事件,这里并不对其进行关心。*/

         dev->sync = 0;
         /*首先判断 disposition 等于 INPUT_PASS_TO_DEVICE,然后判断 dev->event 是否对其指定了一个处理函数,如果这些条件都满足,则调用自定义的 dev->event()函数处理事件。有些事件是发送给设备,而不是发送给 handler 处理的。event()函数用来向输入子系统报告一个将要发送给设备的事件,例如让 LED 灯点亮事件、蜂鸣器鸣叫事件等。当事件报告给输入子系统后,就要求设备处理这个事件。*/
         if ((disposition & INPUT_PASS_TO_DEVICE) && dev->event)
         dev->event(dev, type, code, value);
         /*第 87、88 行,如果事件需要 handler 处理,则调用 input_pass_event()函数
         */
         if (disposition & INPUT_PASS_TO_HANDLERS)
                 input_pass_event(dev, type, code, value);
         }

        input_pass_event()

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

C++代码

 static void input_pass_event(struct input_dev *dev,
 unsigned int type, unsigned int code, int value)
 {
         struct input_handler *handler;
         struct input_handle *handle;/*分配一个 input_handle 结构的指针。*/
         rcu_read_lock();

         handle = rcu_dereference(dev->grab);/*得到 dev->grab 的指针。
         grab 是强制为 input device 的 handler,这时要调用 handler的 event 函数。*/
         if (handle)
         handle->handler->event(handle, type, code, value);
         else {
         bool filtered = false;


         /*表示如果没有为 input device 强制指定 handler,为 grab 赋值,即就会遍历 input device->h_list 上的 handle 成员。如果该 handle 被打开,表示该设备已经被一个用户进程使用。就会调用与输入设备对应的 handler 的 event()函数。注意,只有在 handle 被打开的情况下才会接收到事件,这就是说,只有设备被用户程序使用时,才有必要向用户空间导出信息。*/
         list_for_each_entry_rcu(handle, &dev->h_list, d_node) {
         if (!handle->open)
                 continue;

         handler = handle->handler;
         if (!handler->filter) {
                 if (filtered)
                         break;

                 handler->event(handle, type, code, value);

         } else if (handler->filter(handle, type, code, value))
                 filtered = true;
         }
         }