input_dev结构体加注释

输入设备

/* include/linux/input.h */

struct input_dev {

    const char *name;  /* 设备名称 */

    const char *phys;  /* 设备在系统中的路径 */

    const char *uniq;  /* 设备唯一id */

    struct input_id id;  /* input设备id号   匹配时用到*/

    unsigned long propbit[BITS_TO_LONGS(INPUT_PROP_CNT)];

    unsigned long evbit[BITS_TO_LONGS(EV_CNT)];  /* 设备支持的事件类型，主要有EV_SYNC，EV_KEY，EV_KEY,EV_REL,EV_ABS等*/        

    unsigned long keybit[BITS_TO_LONGS(KEY_CNT)];  /* 按键所对应的位图 */

    unsigned long relbit[BITS_TO_LONGS(REL_CNT)];  /* 相对坐标对应位图 */

    unsigned long absbit[BITS_TO_LONGS(ABS_CNT)];  /* 绝对坐标对应位图 */

    unsigned long mscbit[BITS_TO_LONGS(MSC_CNT)];  /* 支持其他事件 */

    unsigned long ledbit[BITS_TO_LONGS(LED_CNT)];  /* 支持led事件 */

    unsigned long sndbit[BITS_TO_LONGS(SND_CNT)];  /* 支持声音事件 */

    unsigned long ffbit[BITS_TO_LONGS(FF_CNT)];  /* 支持受力事件 */

    unsigned long swbit[BITS_TO_LONGS(SW_CNT)];  /* 支持开关事件 */

    unsigned int hint_events_per_packet;  /*  平均事件数*/

    unsigned int keycodemax;  /* 支持最大按键数 */

    unsigned int keycodesize;  /* 每个键值字节数 */

    void *keycode;  /* 存储按键值的数组的首地址 */

    int (*setkeycode)(struct input_dev *dev,

              const struct input_keymap_entry *ke, unsigned int *old_keycode);

    int (*getkeycode)(struct input_dev *dev, struct input_keymap_entry *ke);

    struct ff_device *ff;  /* 设备关联的反馈结构，如果设备支持 */

    unsigned int repeat_key;  /* 最近一次按键值，用于连击 */

    struct timer_list timer;  /* 自动连击计时器 */

    int rep[REP_CNT];  /* 自动连击参数 */

    struct input_mt *mt;  /* 多点触控区域 */

    struct input_absinfo *absinfo;  /* 存放绝对值坐标的相关参数数组 */

    unsigned long key[BITS_TO_LONGS(KEY_CNT)];  /* 反应设备当前的案件状态 */

    unsigned long led[BITS_TO_LONGS(LED_CNT)];  /* 反应设备当前的led状态 */

    unsigned long snd[BITS_TO_LONGS(SND_CNT)];  /* 反应设备当前的声音状态 */

    unsigned long sw[BITS_TO_LONGS(SW_CNT)];  /* 反应设备当前的开关状态 */

    int (*open)(struct input_dev *dev);  /* 第一次打开设备时调用，初始化设备用 */

    void (*close)(struct input_dev *dev);  /* 最后一个应用程序释放设备事件，关闭设备 */

    int (*flush)(struct input_dev *dev, struct file *file); /* 用于处理传递设备的事件 */

int (*event)(struct input_dev *dev, unsigned int type, unsigned int code,          int value);  /* 事件处理函数，主要是接收用户下发的命令，如点亮led */

    struct input_handle __rcu *grab;  /* 当前占有设备的input_handle */

    spinlock_t event_lock;  /* 事件锁 */

    struct mutex mutex;  /* 互斥体 */

    unsigned int users;  /* 打开该设备的用户数量（input_handle） */

    bool going_away;  /* 标记正在销毁的设备 */

    struct device dev;  /* 一般设备 */

    struct list_head        h_list;  /* 设备所支持的input handle */

    struct list_head        node;  /* 用于将此input_dev连接到input_dev_list */

    unsigned int num_vals;  /* 当前帧中排队的值数 */

    unsigned int max_vals;  /*  队列最大的帧数*/

    struct input_value *vals;  /*  当前帧中排队的数组*/

    bool devres_managed; /* 表示设备被devres 框架管理，不需要明确取消和释放*/

};