输入子系统¶

输入核心¶

struct input_value¶: 输入值表示

定义:

struct input_value {
    __u16 type;
    __u16 code;
    __s32 value;
};

成员

type: 值的类型 (EV_KEY, EV_ABS, 等)
code: 值代码
value: 值

struct input_dev¶: 表示一个输入设备

定义:

struct input_dev {
    const char *name;
    const char *phys;
    const char *uniq;
    struct input_id id;
    unsigned long propbit[BITS_TO_LONGS(INPUT_PROP_CNT)];
    unsigned long evbit[BITS_TO_LONGS(EV_CNT)];
    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)];
    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;
    struct input_dev_poller *poller;
    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)];
    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);
    struct input_handle __rcu *grab;
    spinlock_t event_lock;
    struct mutex mutex;
    unsigned int users;
    bool going_away;
    struct device dev;
    struct list_head        h_list;
    struct list_head        node;
    unsigned int num_vals;
    unsigned int max_vals;
    struct input_value *vals;
    bool devres_managed;
    ktime_t timestamp[INPUT_CLK_MAX];
    bool inhibited;
};

成员

name: 设备名称
phys: 设备在系统层次结构中的物理路径
uniq: 设备的唯一标识码 (如果设备有)
id: 设备的 ID (struct input_id)
propbit: 设备属性和怪癖的位图
evbit: 设备支持的事件类型位图 (EV_KEY, EV_REL, 等)
keybit: 此设备拥有的键/按钮位图
relbit: 设备的相对轴位图
absbit: 设备的绝对轴位图
mscbit: 设备支持的杂项事件位图
ledbit: 设备上存在的 LED 位图
sndbit: 设备支持的声音效果位图
ffbit: 设备支持的力反馈效果位图
swbit: 设备上存在的开关位图
hint_events_per_packet: 设备在一个数据包中生成的平均事件数 (在 EV_SYN/SYN_REPORT 事件之间)。事件处理程序使用它来估计保存事件所需的缓冲区大小。
keycodemax: keycode 表的大小
keycodesize: keycode 表中元素的大小
keycode: 此设备的扫描码到 keycode 的映射
setkeycode: 用于更改当前 keymap 的可选方法，用于实现稀疏 keymap。如果未提供，将使用默认机制。该方法在持有 event_lock 时被调用，因此不得休眠
getkeycode: 用于检索当前 keymap 的可选旧方法。
ff: 如果设备支持力反馈效果，则与设备关联的力反馈结构
poller: 如果设备设置为使用轮询模式，则与设备关联的轮询器结构
repeat_key: 存储上次按下的键的代码；用于实现软件自动重复
timer: 用于软件自动重复的定时器
rep: 自动重复参数 (延迟，速率) 的当前值
mt: 指向多点触控状态的指针
absinfo: struct input_absinfo 元素的数组，保存有关绝对轴的信息 (当前值，最小，最大，平坦，模糊，分辨率)
key: 反映设备键/按钮的当前状态
led: 反映设备 LED 的当前状态
snd: 反映声音效果的当前状态
sw: 反映设备开关的当前状态
open: 当第一个用户调用 input_open_device() 时调用此方法。驱动程序必须准备好设备以开始生成事件 (启动轮询线程，请求 IRQ，提交 URB 等)。 open() 的含义是开始向输入核心提供事件。
close: 当最后一个用户调用 input_close_device() 时调用此方法。 close() 的含义是停止向输入核心提供事件。
flush: 清除设备。最常用于在断开连接时摆脱加载到设备中的力反馈效果
event: 事件处理程序，用于发送 _to_ 设备的事件，例如 EV_LED 或 EV_SND。期望设备执行请求的操作 (打开 LED，播放声音等)。调用受 event_lock 保护，不得休眠
grab: 当前已抓取设备的输入句柄 (通过 EVIOCGRAB ioctl)。当句柄抓取设备时，它将成为来自该设备的所有输入事件的唯一接收者
event_lock: 当输入核心接收并处理设备的新事件时 (在 input_event() 中) 获取此自旋锁。在设备已向输入核心注册后访问和/或修改设备参数 (例如 keymap 或 absmin, absmax, absfuzz 等) 的代码必须获取此锁。
mutex: 序列化对 open()，close() 和 flush() 方法的调用
users: 存储打开此设备的用户 (输入处理程序) 数。 input_open_device() 和 input_close_device() 使用它来确保仅在第一个用户打开设备时调用 dev->open()，并且仅在最后一个用户关闭设备时调用 dev->close()
going_away: 标记正在注销的设备，并导致 input_open_device*() 失败并显示 -ENODEV。
dev: 设备模型对此设备的视图
h_list: 与设备关联的输入句柄列表。访问列表时，必须持有 dev->mutex
node: 用于将设备放置到 input_dev_list 上
num_vals: 当前帧中排队的值的数量
max_vals: 帧中排队的最大值数量
vals: 当前帧中排队的值的数组
devres_managed: 表示设备由 devres 框架管理，不需要显式注销或释放。
timestamp: 用于存储驱动程序调用的 input_set_timestamp 设置的时间戳
inhibited: 表示输入设备被抑制。如果是这种情况，则输入核心会忽略设备生成的任何事件。当设备被抑制时，会调用设备的 close()，当设备被取消抑制时，会调用其 open()。

struct input_handler¶: 实现输入设备的接口之一

定义:

struct input_handler {
    void *private;
    void (*event)(struct input_handle *handle, unsigned int type, unsigned int code, int value);
    unsigned int (*events)(struct input_handle *handle, struct input_value *vals, unsigned int count);
    bool (*filter)(struct input_handle *handle, unsigned int type, unsigned int code, int value);
    bool (*match)(struct input_handler *handler, struct input_dev *dev);
    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);
    bool passive_observer;
    bool legacy_minors;
    int minor;
    const char *name;
    const struct input_device_id *id_table;
    struct list_head        h_list;
    struct list_head        node;
};

成员

private: 驱动程序特定数据
event: 事件处理程序。输入核心在禁用中断并持有 dev->event_lock 自旋锁的情况下调用此方法，因此它可能不会休眠
events: 事件序列处理程序。输入核心在禁用中断并持有 dev->event_lock 自旋锁的情况下调用此方法，因此它可能不会休眠。该方法必须返回传递给它的事件数。
filter: 与 event 类似；将常规事件处理程序与“过滤器”分开。
match: 在将设备的 ID 与处理程序的 id_table 进行比较后调用，以执行设备和处理程序之间的精细匹配
connect: 在将处理程序附加到输入设备时调用
disconnect: 从输入设备断开处理程序
start: 为给定的句柄启动处理程序。此函数由输入核心在 connect() 方法之后立即调用，并且当“抓取”设备的进程释放它时也会调用
passive_observer: 仅对观察来自设备的数据流感兴趣的驱动程序设置为 true，如果存在其他用户。当为它们的句柄调用 input_open_device() 时，此类驱动程序不会导致启动底层硬件设备
legacy_minors: 使用旧次要范围的驱动程序设置为 true
minor: 此驱动程序可以提供的设备的 32 个旧次要设备的范围的开始
name: 处理程序的名称，显示在 /proc/bus/input/handlers 中
id_table: 指向此驱动程序可以处理的 input_device_ids 表的指针
h_list: 与处理程序关联的输入句柄列表
node: 用于将驱动程序放置到 input_handler_list 上

描述

输入处理程序附加到输入设备并创建输入句柄。任何给定的输入设备可能同时附加多个处理程序。所有这些处理程序都将获得由设备生成的输入事件的副本。

相同的结构用于实现输入过滤器。输入核心允许过滤器首先运行，并且如果任何过滤器指示应该过滤该事件 (通过从它们的 filter() 方法返回 true) 则不会将事件传递给常规处理程序。

请注意，输入核心会序列化对 connect() 和 disconnect() 方法的调用。

struct input_handle¶: 将输入设备与输入处理程序链接

定义:

struct input_handle {
    void *private;
    int open;
    const char *name;
    struct input_dev *dev;
    struct input_handler *handler;
    unsigned int (*handle_events)(struct input_handle *handle,struct input_value *vals, unsigned int count);
    struct list_head        d_node;
    struct list_head        h_node;
};

成员

private: 处理程序特定数据
open: 计数器，显示句柄是否“打开”，即是否应从其设备传递事件
name: 创建它的处理程序赋予句柄的名称
dev: 句柄附加到的输入设备
handler: 通过此句柄与设备一起使用的处理程序
handle_events: 事件序列处理程序。它由输入核心根据 handler 中指定的事件处理方法设置。请参阅 input_handle_setup_event_handler()。输入核心在禁用中断并持有 dev->event_lock 自旋锁的情况下调用此方法，因此它可能不会休眠。
d_node: 用于将句柄放在设备的已附加句柄列表中
h_node: 用于将句柄放在从中获取事件的处理程序句柄列表中

void input_set_events_per_packet(struct input_dev *dev, int n_events)¶: 告诉处理程序有关驱动程序事件速率的信息

参数

struct input_dev *dev: 驱动程序使用的输入设备
int n_events: 调用 input_sync() 之间的平均事件数

描述

如果从设备发送的事件速率异常大，请使用此函数设置预期的事件速率。这将允许处理程序为事件流设置适当的缓冲区大小，以最大程度地减少信息丢失。

struct ff_device¶: 输入设备的力反馈部分

定义:

struct ff_device {
    int (*upload)(struct input_dev *dev, struct ff_effect *effect, struct ff_effect *old);
    int (*erase)(struct input_dev *dev, int effect_id);
    int (*playback)(struct input_dev *dev, int effect_id, int value);
    void (*set_gain)(struct input_dev *dev, u16 gain);
    void (*set_autocenter)(struct input_dev *dev, u16 magnitude);
    void (*destroy)(struct ff_device *);
    void *private;
    unsigned long ffbit[BITS_TO_LONGS(FF_CNT)];
    struct mutex mutex;
    int max_effects;
    struct ff_effect *effects;
    struct file *effect_owners[] ;
};

成员

upload: 调用以将新效果上传到设备
erase: 调用以从设备中擦除效果
playback: 调用以请求设备开始播放指定的效果
set_gain: 调用以设置指定的增益
set_autocenter: 调用以自动对中设备
destroy: 在销毁父输入设备时由输入核心调用
private: 驱动程序特定数据，将自动释放
ffbit: 设备真正支持的力反馈能力位图 (不是像 input_dev->ffbit 中那样模拟的)
mutex: 用于序列化对设备的访问的互斥锁
max_effects: 设备支持的最大效果数
effects: 指向当前加载到设备中的效果数组的指针
effect_owners: 效果所有者的数组；当拥有效果的文件句柄关闭时，效果将自动擦除

描述

每个力反馈设备必须实现 upload() 和 playback() 方法； erase() 是可选的。仅当驱动程序设置 FF_GAIN 和 FF_AUTOCENTER 位时，才需要实现 set_gain() 和 set_autocenter()。

请注意，调用 playback()，set_gain() 和 set_autocenter() 时，将持有 dev->event_lock 自旋锁，并且中断已关闭，因此可能不会休眠。

void input_event(struct input_dev *dev, unsigned int type, unsigned int code, int value)¶: 报告新的输入事件

参数

struct input_dev *dev: 生成事件的设备
unsigned int type: 事件的类型
unsigned int code: 事件代码
int value: 事件的值

描述

实现各种输入设备的驱动程序应使用此函数来报告输入事件。另请参阅 input_inject_event()。

注意

可以在使用 input_allocate_device() 分配输入设备后立即安全地使用 input_event()，甚至在使用 input_register_device() 注册它之前，但是该事件将不会到达任何输入处理程序。这种 input_event() 的早期调用可用于“播种”开关的初始状态或绝对轴的初始位置等。

void input_inject_event(struct input_handle *handle, unsigned int type, unsigned int code, int value)¶: 从输入处理程序发送输入事件

参数

struct input_handle *handle: 用于发送事件的输入句柄
unsigned int type: 事件的类型
unsigned int code: 事件代码
int value: 事件的值

描述

类似于 input_event()，但如果设备被“抓取”并且注入事件的句柄不是拥有该设备的句柄，则会忽略该事件。

void input_alloc_absinfo(struct input_dev *dev)¶: 分配 input_absinfo 结构体数组

参数

struct input_dev *dev: 发出绝对事件的输入设备

描述

如果调用者请求的 absinfo 结构体已经分配，此函数将不执行任何操作。

void input_copy_abs(struct input_dev *dst, unsigned int dst_axis, const struct input_dev *src, unsigned int src_axis)¶: 将 absinfo 从一个 input_dev 复制到另一个 input_dev

参数

struct input_dev *dst: 要将 abs 设置复制到的目标输入设备
unsigned int dst_axis: 选择目标轴的 ABS_* 值
const struct input_dev *src: 要从中复制 abs 设置的源输入设备
unsigned int src_axis: 选择源轴的 ABS_* 值

描述

通过从指定的源输入设备的源轴复制，来设置所选目标轴的 absinfo。这对于设置组合式触摸屏/笔硬件的笔/手写笔输入设备非常有用，其中笔使用与触摸屏相同的坐标。

int input_grab_device(struct input_handle *handle)¶: 抓取设备以供独占使用

参数

struct input_handle *handle: 想要拥有该设备的输入句柄

描述

当设备被输入句柄抓取时，设备生成的所有事件都只传递给此句柄。此外，当设备被抓取时，其他输入句柄注入的事件将被忽略。

void input_release_device(struct input_handle *handle)¶: 释放先前抓取的设备

参数

struct input_handle *handle: 拥有该设备的输入句柄

描述

释放先前抓取的设备，以便其他输入句柄可以开始接收输入事件。释放后，附加到设备的所有处理程序都会调用其 start() 方法，以便它们有机会将设备状态与系统的其余部分同步。

int input_open_device(struct input_handle *handle)¶: 打开输入设备

参数

struct input_handle *handle: 通过其访问设备的句柄

描述

当输入处理程序想要开始接收来自给定输入设备的事件时，应调用此函数。

void input_close_device(struct input_handle *handle)¶: 关闭输入设备

参数

struct input_handle *handle: 通过其访问设备的句柄

描述

当输入处理程序想要停止接收来自给定输入设备的事件时，应调用此函数。

int input_scancode_to_scalar(const struct input_keymap_entry *ke, unsigned int *scancode)¶: 转换 struct input_keymap_entry 中的扫描码

参数

const struct input_keymap_entry *ke: 包含要转换的扫描码的 keymap 条目。
unsigned int *scancode: 指向应存储转换后的扫描码的位置的指针。

描述

此函数用于将 struct keymap_entry 中存储的扫描码转换为旧版 keymap 处理方法可以理解的标量形式。这些方法希望扫描码表示为 “unsigned int”。

int input_get_keycode(struct input_dev *dev, struct input_keymap_entry *ke)¶: 检索当前映射到给定扫描码的键码

参数

struct input_dev *dev: 正在查询其 keymap 的输入设备
struct input_keymap_entry *ke: keymap 条目

描述

任何有兴趣检索当前 keymap 的人都应调用此函数。目前，evdev 处理程序使用它。

int input_set_keycode(struct input_dev *dev, const struct input_keymap_entry *ke)¶: 将键码分配给给定的扫描码

参数

struct input_dev *dev: 正在更新其 keymap 的输入设备
const struct input_keymap_entry *ke: 新的 keymap 条目

描述

任何需要更新当前 keymap 的人都应调用此函数。目前，键盘和 evdev 处理程序使用它。

void input_reset_device(struct input_dev *dev)¶: 重置/恢复输入设备的状态

参数

struct input_dev *dev: 需要重置其状态的输入设备

描述

此函数尝试重置打开的输入设备的状态，并将内部状态和硬件状态彼此同步。我们将所有键标记为已释放，恢复 LED 状态、重复率等。

struct input_dev *input_allocate_device(void)¶: 为新的输入设备分配内存

参数

void: 无参数

描述

返回准备好的 struct input_dev 或 NULL。

注意

使用 input_free_device() 释放尚未注册的设备； input_unregister_device() 应该用于已注册的设备。

struct input_dev *devm_input_allocate_device(struct device *dev)¶: 分配托管的输入设备

参数

struct device *dev: 拥有正在创建的输入设备的设备

描述

返回准备好的 struct input_dev 或 NULL。

托管的输入设备不需要显式注销或释放，因为它会在所有者设备与其驱动程序解除绑定（或绑定失败）时自动完成。一旦分配了托管的输入设备，就可以像常规输入设备一样以相同的方式进行设置和注册。没有特殊的 devm_input_device_[un]register() 变体，常规的变体既适用于托管设备，也适用于非托管设备，如果您需要它们。但是，在大多数情况下，托管的输入设备不需要显式注销或释放。

注意

所有者设备设置为输入设备的父设备，用户不应覆盖它。

void input_free_device(struct input_dev *dev)¶: 释放 input_dev 结构体占用的内存

参数

struct input_dev *dev: 要释放的输入设备

描述

仅当尚未调用 input_register_device() 或调用失败时，才应使用此函数。注册设备后，使用 input_unregister_device()，内存将在最后一个引用被删除后释放。

设备应由 input_allocate_device() 分配。

注意

如果存在对输入设备的引用，则在删除最后一个引用之前，不会释放内存。

void input_set_timestamp(struct input_dev *dev, ktime_t timestamp)¶: 设置输入事件的时间戳

参数

struct input_dev *dev: 要设置时间戳的输入设备
ktime_t timestamp: 事件在 CLOCK_MONOTONIC 中发生的时刻

描述

此函数旨在向输入系统提供事件实际发生时间的更准确的时间。驱动程序应尽快调用此函数以获取时间戳，确保 input_set_timestamp 中的时钟转换正确完成。

在时间戳获取和调用 input_set_timestamp 之间进入暂停状态的系统可能会导致不准确的转换。

ktime_t *input_get_timestamp(struct input_dev *dev)¶: 获取输入事件的时间戳

参数

struct input_dev *dev: 要从中获取时间戳的输入设备

描述

有效的时间戳是非零值的时间戳。

void input_set_capability(struct input_dev *dev, unsigned int type, unsigned int code)¶: 将设备标记为能够处理某个事件

参数

struct input_dev *dev: 能够发出或接受事件的设备
unsigned int type: 事件的类型（EV_KEY、EV_REL 等...）
unsigned int code: 事件代码

描述

除了在相应的能力位图中设置相应的位之外，该函数还调整 dev->evbit。

void input_enable_softrepeat(struct input_dev *dev, int delay, int period)¶: 启用软件自动重复

参数

struct input_dev *dev: 输入设备
int delay: 重复延迟
int period: 重复周期

描述

在输入设备上启用软件自动重复。

int input_register_device(struct input_dev *dev)¶: 向输入核心注册设备

参数

struct input_dev *dev: 要注册的设备

描述

此函数向输入核心注册设备。设备必须使用 input_allocate_device() 分配，并在注册之前设置其所有功能。如果函数失败，则必须使用 input_free_device() 释放设备。成功注册设备后，可以使用 input_unregister_device() 注销设备；在这种情况下，不应调用 input_free_device()。

请注意，此函数也用于注册托管的输入设备（使用 devm_input_allocate_device() 分配的设备）。此类托管的输入设备不需要显式注销或释放，它们的拆卸由 devres 基础架构控制。同样值得注意的是，托管输入设备的拆卸在内部是一个两步过程：注册的托管输入设备首先被注销，但保留在内存中并且仍然可以处理 input_event() 调用（尽管事件不会传递到任何地方）。托管输入设备的释放将在稍后发生，当 devres 堆栈被解开到进行设备分配的点时。

void input_unregister_device(struct input_dev *dev)¶: 注销先前注册的设备

参数

struct input_dev *dev: 要注销的设备

描述

此函数注销输入设备。设备注销后，调用者不应尝试访问它，因为它可能随时被释放。

int input_register_handler(struct input_handler *handler)¶: 注册新的输入处理程序

参数

struct input_handler *handler: 要注册的处理程序

描述

此函数在系统中注册新的输入处理程序（接口）用于输入设备，并将其附加到所有与处理程序兼容的输入设备。

void input_unregister_handler(struct input_handler *handler)¶: 注销一个输入处理程序

参数

struct input_handler *handler: 要注销的处理程序

描述

此函数将处理程序与其输入设备断开连接，并将其从已知处理程序的列表中移除。

int input_handler_for_each_handle(struct input_handler *handler, void *data, int (*fn)(struct input_handle*, void*))¶: 句柄迭代器

参数

struct input_handler *handler: 要迭代的输入处理程序
void *data: 回调函数的数据
int (*fn)(struct input_handle *, void *): 为每个句柄调用的函数

描述

迭代 **bus** 的设备列表，并为每个设备调用 **fn**，传递 **data**，并在 **fn** 返回非零值时停止。该函数使用 RCU 遍历列表，因此可能在原子上下文中使用。 **fn** 回调函数从 RCU 临界区调用，因此不得睡眠。

int input_register_handle(struct input_handle *handle)¶: 注册一个新的输入句柄

参数

struct input_handle *handle: 要注册的句柄

描述

此函数将新的输入句柄放到设备和处理程序的列表中，以便在使用 input_open_device() 打开后，事件可以通过它流动。

此函数应从处理程序的 connect() 方法中调用。

void input_unregister_handle(struct input_handle *handle)¶: 注销一个输入句柄

参数

struct input_handle *handle: 要注销的句柄

描述

此函数从设备和处理程序的列表中删除输入句柄。

此函数应从处理程序的 disconnect() 方法中调用。

int input_get_new_minor(int legacy_base, unsigned int legacy_num, bool allow_dynamic)¶: 分配一个新的输入次设备号

参数

int legacy_base: 要搜索的旧范围的开始
unsigned int legacy_num: 旧范围的大小
bool allow_dynamic: 我们是否也可以从动态范围中获取 ID

描述

此函数从输入主命名空间分配一个新的设备次设备号。调用者可以通过指定 **legacy_base** 和 **legacy_num** 参数来请求旧的次设备号，以及如果在旧范围中没有空闲 ID，是否可以从动态范围分配 ID。

void input_free_minor(unsigned int minor)¶: 释放先前分配的次设备号

参数

unsigned int minor: 要释放的次设备号

描述

此函数释放先前分配的输入次设备号，以便以后可以重复使用。

int input_ff_upload(struct input_dev *dev, struct ff_effect *effect, struct file *file)¶: 将效果上传到力反馈设备

参数

struct input_dev *dev: 输入设备
struct ff_effect *effect: 要上传的效果
struct file *file: 效果的所有者

int input_ff_erase(struct input_dev *dev, int effect_id, struct file *file)¶: 从设备中删除力反馈效果

参数

struct input_dev *dev: 从中删除效果的输入设备
int effect_id: 要删除的效果的 ID
struct file *file: 请求的假定所有者

描述

此函数从指定的设备中删除力反馈效果。仅当效果是通过请求删除的同一文件句柄上传时，才会删除该效果。

int input_ff_event(struct input_dev *dev, unsigned int type, unsigned int code, int value)¶: 力反馈事件的通用处理程序

参数

struct input_dev *dev: 要将效果发送到的输入设备
unsigned int type: 事件类型（除 EV_FF 之外的任何内容都将被忽略）
unsigned int code: 事件代码
int value: 事件值

int input_ff_create(struct input_dev *dev, unsigned int max_effects)¶: 创建力反馈设备

参数

struct input_dev *dev: 支持力反馈的输入设备
unsigned int max_effects: 设备支持的最大效果数

描述

此函数为输入设备的力反馈部分分配所有必需的内存，并安装所有默认处理程序。在调用此函数之前，应已设置 **dev->ffbit**。创建 ff 设备后，您需要在注册输入设备之前设置其上传、擦除、播放和其他处理程序

void input_ff_destroy(struct input_dev *dev)¶: 释放输入设备的力反馈部分

参数

struct input_dev *dev: 支持力反馈的输入设备

描述

此函数仅在错误路径中需要，因为输入核心会在设备销毁时自动释放力反馈结构。

int input_ff_create_memless(struct input_dev *dev, void *data, int (*play_effect)(struct input_dev*, void*, struct ff_effect*))¶: 创建无内存的力反馈设备

参数

struct input_dev *dev: 支持力反馈的输入设备
void *data: 要传递到 **play_effect** 的特定于驱动程序的数据
int (*play_effect)(struct input_dev *, void *, struct ff_effect *): 用于播放 FF 效果的特定于驱动程序的方法

多点触摸库¶

struct input_mt_slot¶: 表示输入 MT 插槽的状态

定义:

struct input_mt_slot {
    int abs[ABS_MT_LAST - ABS_MT_FIRST + 1];
    unsigned int frame;
    unsigned int key;
};

成员

abs: 保存此插槽的 ABS_MT 轴的当前值
frame: 调用 input_mt_report_slot_state() 的最后一个帧
key: 此插槽的可选驱动程序指定

struct input_mt¶: 跟踪的触点的状态

定义:

struct input_mt {
    int trkid;
    int num_slots;
    int slot;
    unsigned int flags;
    unsigned int frame;
    int *red;
    struct input_mt_slot slots[] ;
};

成员

trkid: 存储下一个触点的 MT 跟踪 ID
num_slots: 设备使用的 MT 插槽数
slot: 当前正在传输的 MT 插槽
flags: input_mt 操作标志
frame: 每次调用 input_mt_sync_frame() 时都会递增
red: 内核内跟踪的降低成本矩阵
slots: 保存跟踪的触点的当前值的插槽数组

struct input_mt_pos¶: 接触位置

定义:

struct input_mt_pos {
    s16 x, y;
};

成员

x: 水平坐标
y: 垂直坐标

int input_mt_init_slots(struct input_dev *dev, unsigned int num_slots, unsigned int flags)¶: 初始化 MT 输入插槽

参数

struct input_dev *dev: 支持 MT 事件和手指跟踪的输入设备
unsigned int num_slots: 设备使用的插槽数
unsigned int flags: 要在核心中处理的 mt 任务

描述

此函数为输入设备中 MT 插槽处理分配所有必需的内存，准备 ABS_MT_SLOT 和 ABS_MT_TRACKING_ID 事件以供使用，并设置适当的缓冲区。根据设置的标志，它还执行指针仿真和帧同步。

可以重复调用。如果尝试使用不同的插槽数重新初始化，则返回 -EINVAL。

void input_mt_destroy_slots(struct input_dev *dev)¶: 释放输入设备的 MT 插槽

参数

struct input_dev *dev: 具有已分配的 MT 插槽的输入设备

描述

此函数仅在错误路径中需要，因为输入核心会在设备销毁时自动释放 MT 插槽。

bool input_mt_report_slot_state(struct input_dev *dev, unsigned int tool_type, bool active)¶: 报告触点状态

参数

struct input_dev *dev: 具有已分配的 MT 插槽的输入设备
unsigned int tool_type: 在此插槽中使用的工具类型
bool active: 如果触点处于活动状态，则为 true，否则为 false

描述

通过 ABS_MT_TRACKING_ID 报告触点，并可选择报告 ABS_MT_TOOL_TYPE。如果 active 为 true 并且插槽当前未激活，或者如果工具类型已更改，则将新的跟踪 ID 分配给该插槽。仅当设置了相应的 absbit 字段时，才会报告工具类型。

如果触点处于活动状态，则返回 true。

void input_mt_report_finger_count(struct input_dev *dev, int count)¶: 报告触点计数

参数

struct input_dev *dev: 具有已分配的 MT 插槽的输入设备
int count: 触点数

描述

通过 BTN_TOOL_FINGER、BTN_TOOL_DOUBLETAP、BTN_TOOL_TRIPLETAP 和 BTN_TOOL_QUADTAP 报告触点计数。

输入核心确保只有为此设备设置的 KEY 事件才会产生输出。

void input_mt_report_pointer_emulation(struct input_dev *dev, bool use_count)¶: 通用指针仿真

参数

struct input_dev *dev: 具有已分配的 MT 插槽的输入设备
bool use_count: 将活动触点数报告为手指计数

描述

通过 BTN_TOUCH、ABS_X、ABS_Y 和 ABS_PRESSURE 执行旧式指针仿真。如果 use_count 为 true，则仿真触摸板手指计数。

输入核心确保只有为此设备设置的 KEY 和 ABS 轴才会产生输出。

void input_mt_drop_unused(struct input_dev *dev)¶: 取消激活在此帧中未见到的槽位

参数

struct input_dev *dev: 具有已分配的 MT 插槽的输入设备

描述

释放自上次调用此函数后未见到的所有槽位。

void input_mt_sync_frame(struct input_dev *dev)¶: 同步mt帧

参数

struct input_dev *dev: 具有已分配的 MT 插槽的输入设备

描述

关闭当前帧，并为新帧准备内部状态。根据标志，将未使用的槽位标记为非活动状态，并执行指针模拟。

int input_mt_assign_slots(struct input_dev *dev, int *slots, const struct input_mt_pos *pos, int num_pos, int dmax)¶: 执行最佳匹配分配

参数

struct input_dev *dev: 具有已分配的 MT 插槽的输入设备
int *slots: 要填充的槽位分配
const struct input_mt_pos *pos: 要匹配的位置数组
int num_pos: 位置数量
int dmax: ABS_MT_POSITION 最大位移 (零表示无限)

描述

针对当前触点执行最佳匹配，并返回槽位分配列表。新的触点被分配到未使用的槽位。

分配是平衡的，因此所有坐标位移都低于欧几里得距离 dmax。如果找不到这样的分配，则某些触点将被分配到未使用的槽位。

成功时返回零，失败时返回负错误。

int input_mt_get_slot_by_key(struct input_dev *dev, int key)¶: 返回匹配键值的槽位

参数

struct input_dev *dev: 具有已分配的 MT 插槽的输入设备
int key: 要查找的槽位的键值

描述

如果存在，则返回给定键值的槽位，否则，在第一个未使用的槽位上设置键值并返回。

如果找不到可用的槽位，则返回 -1。请注意，为了使此函数正常工作，必须在每一帧调用 input_mt_sync_frame()。

矩阵键盘/小键盘¶

struct matrix_keymap_data¶: 矩阵键盘的键盘映射

定义:

struct matrix_keymap_data {
    const uint32_t *keymap;
    unsigned int    keymap_size;
};

成员

键盘映射: 指向使用 KEY() 宏编码的 uint32 值数组的指针，表示键盘映射
keymap_size: 此键盘映射中条目的数量（已初始化）

描述

平台代码应使用此结构向实现类矩阵键盘/小键盘的驱动程序提供键盘映射。

稀疏键盘映射支持¶

struct key_entry¶: 用于稀疏键盘映射的键盘映射条目

定义:

struct key_entry {
    int type;
    u32 code;
    union {
        u16 keycode;
        struct {
            u8 code;
            u8 value;
        } sw;
    };
};

成员

type: 键条目的类型 (KE_KEY, KE_SW, KE_VSW, KE_END); 驱动程序可以扩展列表，使用自己的私有定义。
code: 设备特定的数据，用于标识按钮/开关
{unnamed_union}: 匿名
keycode: 分配给键/按钮的 KEY_* 代码
sw: 具有 KE_SW 和 KE_VSW 使用的代码/值的结构体
sw.code: 分配给开关的 SW_* 代码
sw.value: 当切换 KE_SW 开关时，应在输入事件中发送的值。 KE_VSW 开关会忽略此字段，并希望驱动程序提供事件的值。

描述

此结构定义了稀疏键盘映射中的一个条目，某些输入设备使用该映射，传统的基于表的方法不适用。

struct key_entry *sparse_keymap_entry_from_scancode(struct input_dev *dev, unsigned int code)¶: 执行稀疏键盘映射查找

参数

struct input_dev *dev: 使用稀疏键盘映射的输入设备
unsigned int code: 扫描码

描述

此函数用于在使用稀疏键盘映射的输入设备中执行 struct key_entry 查找。

struct key_entry *sparse_keymap_entry_from_keycode(struct input_dev *dev, unsigned int keycode)¶: 执行稀疏键盘映射查找

参数

struct input_dev *dev: 使用稀疏键盘映射的输入设备
unsigned int keycode: 键码

描述

此函数用于在使用稀疏键盘映射的输入设备中执行 struct key_entry 查找。

int sparse_keymap_setup(struct input_dev *dev, const struct key_entry *keymap, int (*setup)(struct input_dev*, struct key_entry*))¶: 为输入设备设置稀疏键盘映射

参数

struct input_dev *dev: 输入设备
const struct key_entry *keymap: 键盘映射采用 key_entry 结构数组的形式，以 KE_END 类型的条目结束
int (*setup)(struct input_dev *, struct key_entry *): 可用于根据设备的需求调整键盘映射条目的函数，可以为 NULL

描述

该函数计算大小并分配原始键盘映射的副本，然后适当地设置输入设备事件位。当不再需要键盘映射的已分配副本时，会自动释放它。

void sparse_keymap_report_entry(struct input_dev *dev, const struct key_entry *ke, unsigned int value, bool autorelease)¶: 报告与给定键条目对应的事件

参数

struct input_dev *dev: 应报告事件的输入设备
const struct key_entry *ke: 描述事件的键条目
unsigned int value: 应报告的值（KE_SW 条目忽略）
bool autorelease: 指示是否应在报告按下事件后立即为 KE_KEY 条目发出释放事件，所有其他条目忽略

描述

此函数用于报告给定 struct key_entry 描述的输入事件。

bool sparse_keymap_report_event(struct input_dev *dev, unsigned int code, unsigned int value, bool autorelease)¶: 报告与给定扫描码对应的事件

参数

struct input_dev *dev: 使用稀疏键盘映射的输入设备
unsigned int code: 扫描码
unsigned int value: 应报告的值（KE_SW 条目忽略）
bool autorelease: 指示是否应在报告按下事件后立即为 KE_KEY 条目发出释放事件，所有其他条目忽略

描述

此函数用于在使用稀疏键盘映射的输入设备中执行查找并报告相应的事件。如果查找成功，则返回 true，否则返回 false。

PS/2 协议支持¶

enum ps2_disposition¶: 指示应如何处理收到的字节

常量

PS2_PROCESS: 传递到主协议处理程序，正常处理
PS2_IGNORE: 跳过该字节
PS2_ERROR: 不处理该字节，中止正在进行的命令

struct ps2dev¶: 表示使用 PS/2 协议的设备

定义:

struct ps2dev {
    struct serio *serio;
    struct mutex cmd_mutex;
    wait_queue_head_t wait;
    unsigned long flags;
    u8 cmdbuf[8];
    u8 cmdcnt;
    u8 nak;
    ps2_pre_receive_handler_t pre_receive_handler;
    ps2_receive_handler_t receive_handler;
};

成员

serio: PS/2 设备使用的 serio 端口
cmd_mutex: 一个互斥锁，确保一次只执行一个命令
wait: 一个等待队列，用于从 serio 中断处理程序发出完成信号
flags: 各种内部标志，指示 PS/2 命令执行的阶段
cmdbuf: 保存命令响应的缓冲区
cmdcnt: 命令响应的未完成字节数
nak: 设备拒绝命令时发送的字节
pre_receive_handler: 检查通信错误并返回接收到的数据字节的处置 (enum ps2_disposition)
receive_handler: 特定 PS/2 协议（例如键盘或鼠标协议）的主处理程序

int ps2_sendbyte(struct ps2dev *ps2dev, u8 byte, unsigned int timeout)¶: 向设备发送一个字节并等待确认

参数

struct ps2dev *ps2dev: 要向其发送数据的 PS/2 设备
u8 byte: 要发送到设备的数据
unsigned int timeout: 发送数据和接收确认的超时时间

描述

该函数不处理重传，调用者应在需要时处理它。

ps2_sendbyte() 只能从进程上下文中调用。

void ps2_begin_command(struct ps2dev *ps2dev)¶: 标记复杂命令执行的开始

参数

struct ps2dev *ps2dev: 执行命令的 PS/2 设备

描述

序列化复杂/复合命令。命令完成后，应调用 ps2_end_command()。

void ps2_end_command(struct ps2dev *ps2dev)¶: 标记复杂命令执行的结束

参数

struct ps2dev *ps2dev: 执行命令的 PS/2 设备

void ps2_drain(struct ps2dev *ps2dev, size_t maxbytes, unsigned int timeout)¶: 等待设备发送请求的字节数并丢弃它们

参数

struct ps2dev *ps2dev: 应排空的 PS/2 设备
size_t maxbytes: 要排空的最大字节数
unsigned int timeout: 排空设备的时间

bool ps2_is_keyboard_id(u8 id_byte)¶: 根据已知的键盘 ID 列表检查接收到的 ID 字节

参数

u8 id_byte: 应检查的数据字节

int __ps2_command(struct ps2dev *ps2dev, u8 *param, unsigned int command)¶: 向 PS/2 设备发送命令

参数

struct ps2dev *ps2dev: 应执行命令的 PS/2 设备
u8 *param: 一个缓冲区，包含要随命令一起发送的参数，或者存放命令执行结果的地方，或者两者兼有。
unsigned int command: 命令字，编码了命令本身，以及应该发送到设备的附加参数字节数和期望的命令响应长度。

描述

未序列化。调用者应使用 ps2_begin_command() 和 ps2_end_command() 来确保复杂命令的正确序列化。

int ps2_command(struct ps2dev *ps2dev, u8 *param, unsigned int command)¶: 向 PS/2 设备发送命令

参数

struct ps2dev *ps2dev: 应执行命令的 PS/2 设备
u8 *param: 一个缓冲区，包含要随命令一起发送的参数，或者存放命令执行结果的地方，或者两者兼有。
unsigned int command: 命令字，编码了命令本身，以及应该发送到设备的附加参数字节数和期望的命令响应长度。

注意

ps2_command() 序列化命令执行，以便一次只能为一个单独的端口或整个 8042 控制器执行一个命令。

int ps2_sliced_command(struct ps2dev *ps2dev, u8 command)¶: 向鼠标发送扩展的 PS/2 命令

参数

struct ps2dev *ps2dev: 应执行命令的 PS/2 设备
u8 command: 命令字节

描述

该命令使用高级设备（如罗技或 Synaptics 触摸板）理解的“切片”语法发送。该命令编码为：0xE6 0xE8 rr 0xE8 ss 0xE8 tt 0xE8 uu，其中 (rr*64)+(ss*16)+(tt*4)+uu 是命令。

void ps2_init(struct ps2dev *ps2dev, struct serio *serio, ps2_pre_receive_handler_t pre_receive_handler, ps2_receive_handler_t receive_handler)¶: 初始化 ps2dev 结构

参数

struct ps2dev *ps2dev: 要初始化的结构
struct serio *serio: 与 PS/2 设备关联的 serio 端口
ps2_pre_receive_handler_t pre_receive_handler: 验证处理程序，用于检查基本通信状态
ps2_receive_handler_t receive_handler: 主协议处理程序

描述

准备 ps2dev 结构，以便在 PS/2 设备的驱动程序中使用。

irqreturn_t ps2_interrupt(struct serio *serio, u8 data, unsigned int flags)¶: PS/2 设备的通用中断处理程序

参数

struct serio *serio: 设备的 serio 端口
u8 data: 从设备接收的数据字节
unsigned int flags: 标志，例如 SERIO_PARITY 或 SERIO_TIMEOUT，指示数据传输的状态

描述

ps2_interrupt() 调用预接收处理程序，可选地处理来自设备的命令确认和响应，最后将数据传递给主协议处理程序以供进一步处理。

Linux 内核

目录

本页