Linux2.6 input子系统分析

Linux的input子系统提供了输入设备的驱动框架，比如鼠标、键盘、触摸屏等就属于输入设备。Linux中关于input子系统的文档在Documentation/input目录，input的核心代码在input.c和input.h中。
本文没有涉及input的一些细节实现，比如input_dev->grab，以及按键的定时事件等。

1.
input_handle, input_handler, input_dev

input_handle, input_handler, input_dev是input子系统中最重要的3个数据结构。
l
input_handler用于上层应用获取输入事件。上层应用打开输入设备的设备节点，然后对节点进行读写操作以获得鼠标移动信息，或者键盘信息等等。这里对设备节点的文件操作函数就是由input_handler提供。
l
input_dev代表的是具体的设备，比如鼠标、键盘等等。
l
对于一台Linux电脑，可能会连着多个鼠标、多个键盘。每一个鼠标都能控制光标的运动，每一个键盘也都能正常使用。这在input子系统中，体现为一个input_handler关联多个input_dev，能够同时从多个input_dev获取输入消息。与此同时，linux中可能会有多个input_handler同时与一个input_dev关联，这样，应用程序通过任何一个input_handler，都可以获得例如鼠标、键盘等具体设备的输入信息。所以，input_dev和input_handler之间是多对多的关联关系，而这些关联就是由input_handle表示。

1.1
handler与dev之间关联的建立

input_handle中包含一个input_dev的指针，和一个input_handler的指针，所以能建立handler和dev之间的一个一对一的关联。在input_handler中，有一个链表h_list，指向和这个handler关联的所有input_handle，通过这些handle就可以找到与handler关联的所有dev。同样的，在input_dev中，也有一个链表h_list，指向与dev关联的所有input_handle，通过这些handle可以找到与dev相关的所有handler。通过这两个链表和input_handle，input_handler和input_dev之间建立了一个复杂的网状结构。
那么，input_handler和input_dev之间建立关联的规则是什么？即在什么情况下需要建立关联，什么时候不需要建立关联？这就需要handler和dev之间有一个匹配机制。
input_handler中有两个指针，id_table和blacklist，其中blacklist是黑名单，凡是与之匹配的dev都将被强制过滤；而与id_table中任意一项匹配的dev才能与handler建立关联。

const struct input_device_id *id_table;

const struct input_device_id *blacklist;

struct input_device_id {

kernel_ulong_t flags;

__u16 bustype;

__u16 vendor;

__u16 product;

__u16 version;

kernel_ulong_t evbit[INPUT_DEVICE_ID_EV_MAX /
BITS_PER_LONG + 1];

kernel_ulong_t keybit[INPUT_DEVICE_ID_KEY_MAX /
BITS_PER_LONG + 1];

kernel_ulong_t relbit[INPUT_DEVICE_ID_REL_MAX /
BITS_PER_LONG + 1];

kernel_ulong_t absbit[INPUT_DEVICE_ID_ABS_MAX /
BITS_PER_LONG + 1];

kernel_ulong_t mscbit[INPUT_DEVICE_ID_MSC_MAX /
BITS_PER_LONG + 1];

kernel_ulong_t ledbit[INPUT_DEVICE_ID_LED_MAX /
BITS_PER_LONG + 1];

kernel_ulong_t sndbit[INPUT_DEVICE_ID_SND_MAX /
BITS_PER_LONG + 1];

kernel_ulong_t ffbit[INPUT_DEVICE_ID_FF_MAX /
BITS_PER_LONG + 1];

kernel_ulong_t swbit[INPUT_DEVICE_ID_SW_MAX /
BITS_PER_LONG + 1];

kernel_ulong_t driver_info;

};
在这个结构体中，flags中包含一些掩码：
#define INPUT_DEVICE_ID_MATCH_BUS
1
#define INPUT_DEVICE_ID_MATCH_VENDOR
2
#define INPUT_DEVICE_ID_MATCH_PRODUCT
4
#define INPUT_DEVICE_ID_MATCH_VERSION
8
这些掩码用来匹配bus类型、厂商、产品号、版本号等。如果选择不匹配这些信息，那么driver_info需要置位，以跳过flags的匹配过程。
evbit[INPUT_DEVICE_ID_EV_MAX /
BITS_PER_LONG + 1]中包含支持的事件掩码。input子系统支持以下事件：
#define EV_SYN
0x00 // EV_SYN用于标记一系列输入的结束
#define EV_KEY
0x01 // 键盘输入
#define EV_REL
0x02 // 鼠标的相对位移
#define EV_ABS
0x03 // 触摸屏的绝对坐标
#define EV_MSC
0x04
#define EV_SW
0x05
#define EV_LED
0x11 // 比如键盘的LED控制
#define EV_SND
0x12
#define EV_REP
0x14
#define EV_FF
0x15
#define EV_PWR
0x16
#define EV_FF_STATUS
0x17
如果handler支持某一种事件，那么evbit的对应位会置位。如果evbit的某一位置位了，那么结构体中与具体事件对应的掩码数组就会有效。例如，EV_KEY置位了，那么对应的keybit数组就有效，该数组里面定义了handler支持的具体key的类型。如果handler和dev需要匹配，那么dev必须能支持所有handler支持的事件；但是，handler却不一定要处理所有dev能提供的事件。
#define MATCH_BIT(bit, max) /

for (i = 0; i < BITS_TO_LONGS(max); i++) /

if ((id->bit[i] & dev->bit[i]) != id->bit[i]) /

break; /

if (i != BITS_TO_LONGS(max)) /

continue;
关于匹配的具体过程，可以参考函数input_match_device。

2.
input_dev

所有的input_dev都是虚拟设备，其class名为”input”，class的登记函数：

class_register(&input_class);
所以，需要先注册一个物理设备，已此物理设备为父设备注册input_dev。

2.1
input_dev的注册

input_dev的注册由input_register_device函数完成。
int input_register_device(struct input_dev *dev)

__set_bit(EV_SYN, dev->evbit); // 强制设置EV_SYN位

// 初始化定时器，REP_DELAY是第一次延时的超时值，REP_PERIOD是第一次延时
// 之后的超时值

init_timer(&dev->timer);

if (!dev->rep[REP_DELAY] && !dev->rep[REP_PERIOD]) {

dev->timer.data = (long) dev;

dev->timer.function = input_repeat_key;

dev->rep[REP_DELAY] = 250;

dev->rep[REP_PERIOD] = 33;

}

// 设置默认的get key和set
key函数

if (!dev->getkeycode) dev->getkeycode = input_default_getkeycode;

if (!dev->setkeycode) dev->setkeycode = input_default_setkeycode;

// 设置设备名称，然后注册设备

snprintf(dev->dev.bus_id, sizeof(dev->dev.bus_id),

"input%ld", (unsigned long) atomic_inc_return(&input_no) - 1);

device_add(&dev->dev);

list_add_tail(&dev->node, &input_dev_list); //
将设备加入input_dev_list链表

// 对每一个已注册的handler，调用input_attach_handler

list_for_each_entry(handler, &input_handler_list, node)

input_attach_handler(dev, handler); // 见下节

// proc有关的操作

input_wakeup_procfs_readers();

3
input_handler

struct input_handler {

void *private;

void (*event)(struct input_handle *handle, unsigned int type, unsigned int code, int value);

int (*connect)(struct input_handler *handler, struct input_dev *dev, const struct input_device_id *id);

void (*disconnect)(struct input_handle *handle);

void (*start)(struct input_handle *handle);

const struct file_operations *fops;

int minor;

const char *name;

const struct input_device_id *id_table;

const struct input_device_id *blacklist;

struct list_head h_list;

struct list_head node;
};

3.1
input_handler的注册

int input_register_handler(struct input_handler *handler)

// 将fops域登记到全局变量input_table

input_table[handler->minor >> 5] = handler;

// 将handler登记到链表input_handler_list

list_add_tail(&handler->node, &input_handler_list);

// 遍历已经登记的dev，对每个dev调用input_attach_handler（chapter
2.2）

list_for_each_entry(dev, &input_dev_list, node)

input_attach_handler(dev, handler);

// proc有关的操作

input_wakeup_procfs_readers();

3.2
input_attach_handler

static int input_attach_handler(struct input_dev *dev, struct input_handler *handler)

// 匹配黑名单，如果设备在handler的黑名单里，返回

…

// 匹配handler中的id_table，如果匹配，则需要建立handler与dev之间的关联，于
// 是调用handler->connect
handler的connect函数中，会malloc一个handle，把handler和dev填到handle中对应的域，然后调用input_register_handle函数，以及input_open_file函数。

4.
input_handle

struct input_handle {

void *private;

int open;

const char *name;
// handle的名称

struct input_dev *dev; // 关联的dev

struct input_handler *handler; // 关联的handler

struct list_head d_node;
// 通过这个域挂到dev的handle链表

struct list_head h_node;
// 通过这个域挂到handler的handle链表
};

4.1
input_handle的注册

int input_register_handle(struct input_handle *handle);
input_register_handle会在handler的connect函数中被调用，它会将handler挂到dev和handler的链表中。最后会调用handler->start函数。

5.
设备层

上层应用通过设备节点访问input子系统提供的服务，而input_handler为上层应用提供了接口，所以设备节点的文件访问函数理所当然由handler提供，这就是handler中的fops域。

input子系统本身也提供了一组文件读写操作函数，input_fops。

register_chrdev(INPUT_MAJOR, "input", &input_fops);
这里的input_fops中仅包含open函数，open函数的作用是根据子设备号重新设置设备文件的file->f_op域（这个机制在LDD的书中有提及），被更新的fops保存在全局数组input_table中。

在注册handler时，会将handler登记到一个全局数组input_table，具体代码在input_register_handler中：

input_table[handler->minor >> 5] = handler;
这个数组主要是保存了handler中的fops。另外，数组的下标是handler->minor
>> 5，也就是说，一个handler可以占有32个子设备号（1
<< 5）。

6.
事件的传递

input子系统的主要作用就是控制输入事件在handler和dev之间的传递。输入事件在input系统中的定义如下：
struct input_event {

struct timeval time;

__u16 type;

__u16 code;

__s32 value;
};
input_dev可以通过函数input_event传递消息。
void input_event(struct input_dev *dev, unsigned int type, unsigned int code, int value)

// 加锁、消息检验等

…

input_handle_event(dev, type, code, value);

void input_handle_event(struct input_dev *dev, unsigned int type, unsigned int code, int value)

判断消息是否需要传给handler和dev

如果需要传给dev，调用dev->event(dev,
type, code, value);

如果需要传给handler，调用input_pass_event(dev,
type, code, value);

input_pass_event遍历dev中所有handle列表，对每一个handle，调用event函数。