input子系统学习笔记七 handler处理器注册分析

感谢终结者投递本文】

        input_handler 是输入子系统的主要数据结构,一般将其称为handler处理器,表示对输入事件的具体处理。input_handler 为输入设备的功能实现了一个接口,输入事件最终传递到handler 处理器,handler 处理器根据一定的规则,然后对事件进行处理,具体的规则将在下面详细介绍。

关键数据结构

        struct input_dev 物理输入设备的基本数据结构,包含设备相关的一些信息

        struct input_handler 事件处理结构体,定义怎么处理事件的逻辑

        struct input_handle 用来创建 input_dev 和 input_handler 之间关系的结构体

input_handler 结构体

        input_handler 是输入设备的事件处理接口,为处理事件提供一个统一的函数模板,程序员应该根据具体的需要实现其中的一些函数,并将其注册到输入子系统中。该结构体的定义如下:

C/C++代码

struct input_handler {
        void *private;/*定义了一个 private 指针,表示驱动特定的数据。这里的驱动指的就是 handler 处理器。*/
        void (*event)(struct input_handle *handle, unsigned int type,
        unsigned int code, int value);/*定义了一个 event()处理函数,这个函数将被输入子系统调用去处理发送给设备的事件。例如将发送一个事件命令 LED 灯点亮,实际控制硬件的点亮操作就可以放在 event()函数中实现。*/
        int (*connect)(struct input_handler *handler, struct input_dev
                *dev,const struct input_device_id *id);/* 定 义 了 一 个 connect() 函 数 , 该 函 数 用 来 连 接 handler 和 input_dev 。 在input_attach_handler()函数的第 10 行,就是回调的这个自定义函数。*/
        void (*disconnect)(struct input_handle *handle);
        void (*start)(struct input_handle *handle);
        const struct file_operations *fops;/*表示 handler 实现的文件操作集,这里不是很重要。*/
        int minor;//表示设备的次设备号。
        const char *name;/* 表示handler 的名字,显示在/proc/bus/input/handlers 目录中。*/
        const struct input_device_id *id_table;/*定义了一个 id_table 表,表示驱动能够处理的表。*/
        const struct input_device_id *blacklist;/*指向一个 input_device_id 表,这个表包含 handler 应该忽略的设备。*/
        struct list_head h_list;/*定义了一个链表 h_list,表示与这个 input_handler 相联系的下一个 handler。*/
        struct list_head node;/*定义了一个链表 node,将其连接到全局的 input_handler_list 链表中,所有的input_handler 都连接在其上。*/
};

input_handle 结构体

        input_register_handle()函数用来注册一个新的 handle 到输入子系统中。input_handle 的主要功能是用来连接 input_dev 和 input_handler。其结构如下:

C/C++代码

struct input_handle {
        void *private;/*定义了 private 表示 handler 特定的数据。*/
        int open;/*定义了一个 open 变量,表示 handle 是否正在被使用,当使用时,会将事件分发给设备处理。*/
        const char *name;/*定义了一个 name 变量,表示 handle 的名字。*/
        struct input_dev *dev;/*定义了 dev 变量指针,表示该 handle 依附的 input_dev 设备。*/
        struct input_handler *handler;/*定义了一个 handler 变量指针,指向 input_handler,该 handler 处理器就是与设备相关的处理器。*/
        struct list_head d_node;/*定义了一个 d_node 变量,使用这个变量将 handle 放到设备相关的链表中,也就是放到 input_dev->h_list 表示的链表中。*/
        struct list_head h_node;/*定义了一个 h_node 变量,使用这个变量将 handle 放到 input_handler 相关的链表中,也就是放到 handler->h_list 表示的链表中。*/
};

注册input_handler

        input_register_handler()函数注册一个新的 input handler 处理器。这个 handler 将为输入设备使用,一个 handler 可以添加到多个支持它的设备中,也就是一个 handler 可以处理多个输入设备的事件。函数的参数传入简要注册的 input_handler 指针,该函数的代码如下:

C/C++代码

int input_register_handler(struct input_handler *handler)
{
        struct input_dev *dev;
        int retval;

        retval = mutex_lock_interruptible(&input_mutex);/*对 input_mutex 进行了加锁。当加锁失败后,则返回。*/
        if (retval)
                return retval;

        INIT_LIST_HEAD(&handler->h_list);/*初始化 h_hlist 链表,该链表连接与这个 input_handler 相联系的下一个 handler。*/

        if (handler->fops != NULL) {/*其中的 handler->minor 表示对应 input 设备结点的次设备号。 handler->minor以右移 5 位作为索引值插入到 input_table[ ]中,*/
                if (input_table[handler->minor >> 5]) {
                        retval = -EBUSY;
                        goto out;
                }
                input_table[handler->minor >> 5] = handler;
        }

        list_add_tail(&handler->node, &input_handler_list);/*调用 list_add_tail()函数,将 handler 加入全局的 input_handler_list 链表中, 该链表包含了系统中所有的 input_handler。*/

        list_for_each_entry(dev, &input_dev_list, node)
        input_attach_handler(dev, handler);/*input_attach_handler()函数的作用是匹配 input_dev_list 链表中的 input_dev 与 handler。如果成功会将 input_dev 与 handler 联系起来。*/
        input_wakeup_procfs_readers();
        out:
                mutex_unlock(&input_mutex);/*解互斥锁并退出。*/
        return retval;
}

注册input_handle

        input_handle 是用来连接input_dev和input_handler的一个中间结构体。事件通过input_handle 从 input_dev 发送到 input_handler,或者从 input_handler 发送到 input_dev 进行处理。在使用 input_handle 之前,需要对其进行注册,注册函数是 input_register_handle()。

注册函数 input_register_handle()

        input_register_handle()函数用来注册一个新的 handle 到输入子系统中。该函数接收一个input_handle 类型的指针,该变量要在注册前对其成员初始化。input_register_handle()函数的代码如下:

C/C++代码

int input_register_handle(struct input_handle *handle)
{
        struct input_handler *handler = handle->handler;/*从 handle 中取出一个指向 input_handler 的指针,为下面的操作使用。 */
        struct input_dev *dev = handle->dev;/*从 handle 中取出一个指向 input_dev 的指针,为下面的操作使用。 */
        int error;

        /*
        * We take dev->mutex here to prevent race with
        * input_release_device().
        */
        error = mutex_lock_interruptible(&dev->mutex);/*给竞争区域加一个互斥锁。*/
        if (error)
                return error;

        /*
        * Filters go to the head of the list, normal handlers
        * to the tail.
        */
        if (handler->filter)
                list_add_rcu(&handle->d_node, &dev->h_list);
        else
                list_add_tail_rcu(&handle->d_node, &dev->h_list);/*调用 list_add_tail_rcu()函数将 handle 加入输入设备的 dev->h_list 链表中。*/

        mutex_unlock(&dev->mutex);

        /*
        * Since we are supposed to be called from ->connect()
        * which is mutually exclusive with ->disconnect()
        * we can't be racing with input_unregister_handle()
        * and so separate lock is not needed here.
        */
        list_add_tail_rcu(&handle->h_node, &handler->h_list);

        if (handler->start)/*如果定义了 start()函数,则调用它。*/
                handler->start(handle);

        return 0;
}

三者之间的关系

 

        结点 1、2、3 表示input_dev设备,其通过input_dev->node变量连接到全局输入设备链input_dev_list中.结点4、5、6表示input_handler处理器,其通过input_handler->node连接到全局handler处理器链表input_handler_list中。结点7是一个input_handle的结构体,其用来连接input_dev和input_handler。input_handle的dev成员指向了对应的input_dev设备，input_handle的handler成员指向了对应的 input_handler。外结点7的input_handle另设备,通过d_node连接到了结点2的input_dev上的h_list链表上。另一方面,结点7的input_handle通过h_node连接到了结点5的input_handler的h_list链表上。通过这种关系,input_dev将和input_handler联系了起来。

原文 http://www.ourunix.org/post/296.html