大家好，我是王鸽，这篇文章主要是关于input子系统的实际应用，以 “GPIO 按键” 为例。首先谈论一下整个架构。- 硬件层：物理按键通过 GPIO 连接到 SOC，按键按下 / 松开对应 GPIO 电平变化（高 / 低）；
- GPIO 子系统：提供 GPIO 配置（输入 / 输出、上下拉）、中断注册等基础功能；
- gpio_keys 驱动：核心逻辑层，负责解析设备树 / 平台数据、注册中断、转换按键事件；
- 输入子系统：将按键事件封装为标准 input_event，向上暴露给用户空间（/dev/input/eventX）。
gpio_keys { compatible = "gpio-keys"; // 核心匹配属性 #address-cells = <1>; // 子节点地址编码长度 #size-cells = <0>; // 子节点大小编码长度 autorepeat; // 按键自动重复功能 button@21 { // 单个按键子节点（地址21） label = "GPIO Key UP"; // 按键名称 linux,code = <103>; // 按键对应的Linux标准键值 gpios = <&gpio1 0 1>; // GPIO引脚配置 };};//gpios = <&gpio1 0 1> 是硬件绑定，1表示低电平有效，需与硬件电路匹配（若硬件是按下为高电平，需改为//0）；
位于drivers/input/keyboard/gpio_keys.c，代码是将标准化的 GPIO 按键处理驱动，核心作用是将 “GPIO 引脚的电平变化” 转化为 Linux 输入子系统（Input Subsystem）的标准按键事件，让上层应用（如终端、Android、QT）无需关注底层 GPIO 硬件细节，直接通过统一的输入接口读取按键操作。驱动的执行流程分为：驱动注册 → 设备匹配 → 按键初始化 → 中断处理 → 事件上报，以下是关键函数的解析。先理解驱动中最关键的几个数据结构（kernel/include/linux/gpio_keys.h）：gpio_keys_button（单个按键的配置）struct gpio_keys_button { int gpio; // 按键对应的GPIO编号（-1表示无效） int active_low; // 按键有效电平：1=低电平有效，0=高电平有效 const char *desc; // 按键描述（如"volume_up"） unsigned int type; // 事件类型（EV_KEY/EV_SW） unsigned int code; // 按键编码（如KEY_VOLUMEUP，定义在input-event-codes.h） int debounce_interval; // 消抖时间（ms，避免机械按键抖动导致误触发） bool wakeup; // 是否支持唤醒系统（休眠时按键可唤醒） bool can_disable; // 是否可禁用该按键 unsigned int irq; /* Irq number in case of interrupt keys */};
gpio_button_data/*key/button控制逻辑配置参数*/
struct gpio_button_data {const struct gpio_keys_button *button;//按键配置struct input_dev *input;//输入设备句柄struct timer_list timer;struct work_struct work; // 工作队列（中断上下文转进程上下文）unsigned int timer_debounce; /* in msecs */unsigned int irq; //中断号spinlock_t lock; //自旋锁bool disabled;bool key_pressed;};
gpio_keys_platform_data（平台级配置，旧版）
struct gpio_keys_platform_data { struct gpio_keys_button *buttons; // 按键数组 int nbuttons; // 按键数量 const char *name; // 输入设备名称（/sys/class/input/inputX/name） bool rep; // 是否支持按键自动重复（长按连发） int (*enable)(struct device *dev); void (*disable)(struct device *dev); const char *name; /* input device name */ };
gpio_keys_drvdata（驱动私有数据）
struct gpio_keys_drvdata {const struct gpio_keys_platform_data *pdata;struct input_dev *input;struct mutex disable_lock;struct gpio_button_data data[0];};
gpio-keys驱动是以platform_driver的身份注册到系统中的，所以其需要定义platfrom_driver结构static int __init gpio_keys_init(void){return platform_driver_register(&gpio_keys_device_driver);}static void __exit gpio_keys_exit(void){platform_driver_unregister(&gpio_keys_device_driver);}late_initcall(gpio_keys_init);module_exit(gpio_keys_exit);
static struct of_device_id gpio_keys_of_match[] = { { .compatible = "gpio-keys", }, { },};MODULE_DEVICE_TABLE(of, gpio_keys_of_match);static struct platform_driver gpio_keys_device_driver = { .probe = gpio_keys_probe, .remove = gpio_keys_remove, .driver = { .name = "gpio-keys", .owner = THIS_MODULE, .pm = &gpio_keys_pm_ops, .of_match_table = of_match_ptr(gpio_keys_of_match), }};
按键初始化
使用设备树来描述 KEY 设备信息的话，设备节点的 compatible 属性值要设置为“gpio-keys”。当设备和驱动匹配以后 gpio_keys_probe 函数就会执行， gpio_keys_probe 函数内容如下：static int gpio_keys_probe(struct platform_device *pdev){struct device *dev = &pdev->dev;const struct gpio_keys_platform_data *pdata = dev_get_platdata(dev);struct gpio_keys_drvdata *ddata;struct input_dev *input;int i, error;int wakeup = 0;if (!pdata) { pdata = gpio_keys_get_devtree_pdata(dev);if (IS_ERR(pdata))return PTR_ERR(pdata); } ddata = kzalloc(sizeof(struct gpio_keys_drvdata) + pdata->nbuttons * sizeof(struct gpio_button_data), GFP_KERNEL); input = input_allocate_device();if (!ddata || !input) { dev_err(dev, "failed to allocate state\n");error = -ENOMEM;goto fail1; } //初始化输入设备核心参数和配置输入设备属性 ddata->pdata = pdata; ddata->input = input; mutex_init(&ddata->disable_lock); platform_set_drvdata(pdev, ddata); input_set_drvdata(input, ddata); input->name = pdata->name ? : pdev->name; input->phys = "gpio-keys/input0"; input->dev.parent = &pdev->dev; input->open = gpio_keys_open; input->close = gpio_keys_close; input->id.bustype = BUS_HOST; input->id.vendor = 0x0001; input->id.product = 0x0001; input->id.version = 0x0100;/* Enable auto repeat feature of Linux input subsystem */if (pdata->rep) __set_bit(EV_REP, input->evbit);for (i = 0; i < pdata->nbuttons; i++) {const struct gpio_keys_button *button = &pdata->buttons[i];struct gpio_button_data *bdata = &ddata->data[i];error = gpio_keys_setup_key(pdev, input, bdata, button);if (error)goto fail2;if (button->wakeup) wakeup = 1; }error = sysfs_create_group(&pdev->dev.kobj, &gpio_keys_attr_group);if (error) { dev_err(dev, "Unable to export keys/switches, error: %d\n",error);goto fail2; }error = input_register_device(input);if (error) { dev_err(dev, "Unable to register input device, error: %d\n",error);goto fail3; } device_init_wakeup(&pdev->dev, wakeup);return 0; fail3: sysfs_remove_group(&pdev->dev.kobj, &gpio_keys_attr_group); fail2: while (--i >= 0) gpio_remove_key(&ddata->data[i]); platform_set_drvdata(pdev, NULL); fail1: input_free_device(input); kfree(ddata);/* If we have no platform data, we allocated pdata dynamically. */if (!dev_get_platdata(&pdev->dev)) kfree(pdata);return error;}
其中gpio_keys_get_devtree_pdata(dev)：解析DTS关于gpio-keys的属性定义，创建、初始化gpio_keys_platform_data。
input = input_allocate_device()：分配、初始化input设备。
遍历所有key/button,注册key/buton所需的资源(gpio、irq等)，如下代码
for (i = 0; i < pdata->nbuttons; i++) { const struct gpio_keys_button *button = &pdata->buttons[i]; struct gpio_button_data *bdata = &ddata->data[i]; error = gpio_keys_setup_key(pdev, input, bdata, button); if (error) goto fail2; if (button->wakeup) wakeup = 1; }
其中gpio_keys_setup_key功能：为单个按键（button）初始化 GPIO/IRQ、设置中断、注册输入事件能力。代码调用流程
staticintgpio_keys_setup_key(struct platform_device *pdev,struct input_dev *input,struct gpio_button_data *bdata,const struct gpio_keys_button *button){const char *desc = button->desc ? button->desc : "gpio_keys";struct device *dev = &pdev->dev;irq_handler_t isr;unsigned long irqflags;int irq, error; bdata->input = input; bdata->button = button;spin_lock_init(&bdata->lock);if (gpio_is_valid(button->gpio)) { //请求指定的 GPIO 作为输入引脚。 error = gpio_request_one(button->gpio, GPIOF_IN, desc);/if (error < 0) {dev_err(dev, "Failed to request GPIO %d, error %d\n", button->gpio, error);return error; } //设置消抖设置，硬件去抖（单位微秒，所以乘以 1000）。if (button->debounce_interval) { error = gpio_set_debounce(button->gpio, button->debounce_interval * 1000);/* use timer if gpiolib doesn't provide debounce */if (error < 0) bdata->timer_debounce = button->debounce_interval; } irq = gpio_to_irq(button->gpio);//获取gpio中断号IRQif (irq < 0) { error = irq;dev_err(dev,"Unable to get irq number for GPIO %d, error %d\n", button->gpio, error);goto fail; } bdata->irq = irq;INIT_WORK(&bdata->work, gpio_keys_gpio_work_func);//初始化工作队列setup_timer(&bdata->timer, gpio_keys_gpio_timer, (unsigned long)bdata); //设置 ISR 和中断触发方式 isr = gpio_keys_gpio_isr; irqflags = IRQF_TRIGGER_RISING | IRQF_TRIGGER_FALLING; } else {if (!button->irq) {dev_err(dev, "No IRQ specified\n");return -EINVAL; } bdata->irq = button->irq;if (button->type && button->type != EV_KEY) {dev_err(dev, "Only EV_KEY allowed for IRQ buttons.\n");return -EINVAL; } bdata->timer_debounce = button->debounce_interval;setup_timer(&bdata->timer, gpio_keys_irq_timer, (unsigned long)bdata); isr = gpio_keys_irq_isr; irqflags = 0; }//告诉输入子系统：这个设备能产生 button->type（默认 EV_KEY）类型的事件，具体键码为 button->code（如 //KEY_POER）。input_set_capability(input, button->type ?: EV_KEY, button->code);/* * If platform has specified that the button can be disabled, * we don't want it to share the interrupt line. */if (!button->can_disable) irqflags |= IRQF_SHARED;//允许该中断线被多个设备共享（非可禁用按键）。 error = request_any_context_irq(bdata->irq, isr, irqflags, desc, bdata);if (error < 0) {dev_err(dev, "Unable to claim irq %d; error %d\n", bdata->irq, error);goto fail; }return 0;fail:if (gpio_is_valid(button->gpio))gpio_free(button->gpio);return error;}
static int gpio_keys_setup_key(struct platform_device *pdev,
struct input_dev *input,
struct gpio_button_data *bdata,
const struct gpio_keys_button *button)
参数说明：
pdev：平台设备结构体，代表当前驱动绑定的设备。input：输入子系统设备，用于上报按键事件。bdata：每个按键的私有数据结构（运行时状态）。button：描述按键硬件属性的静态配置（来自设备树或平台数据）
另外通过 devm_request_any_context_irq 申请中断，any_context 表示中断处理函数可在进程 / 中断上下文运行，兼容性更好；完成按键的硬件→软件事件的链路打通。gpio_keys_setup_key有两个分支，使用 GPIO 按键（gpio_is_valid(button->gpio)）和使用非 GPIO 的外部 IRQ（else）。
结果按键中断处理函数有两个：GPIO 按键绑定 gpio_keys_gpio_isr，纯中断按键绑定 gpio_keys_irq_isr；
使用 GPIO 按键（gpio_is_valid(button->gpio)）
isr = gpio_keys_gpio_isr;
staticirqreturn_tgpio_keys_gpio_isr(int irq, void *dev_id){struct gpio_button_data *bdata = dev_id;BUG_ON(irq != bdata->irq);if (bdata->button->wakeup)pm_stay_awake(bdata->input->dev.parent);if (bdata->timer_debounce)mod_timer(&bdata->timer, jiffies + msecs_to_jiffies(bdata->timer_debounce));elseschedule_work(&bdata->work);return IRQ_HANDLED;}
gpio_keys_gpio_isr：定时器消抖处理另外调用schedule_work(&bdata->work);用于下半部处理（避免在 ISR 中做耗时操作）。即调用static void gpio_keys_gpio_work_func(struct work_struct *work)，该函数主要是调用gpio_keys_gpio_report_event(bdata);上报event事件。static void gpio_keys_gpio_report_event(struct gpio_button_data *bdata){const struct gpio_keys_button *button = bdata->button;struct input_dev *input = bdata->input; unsigned int type = button->type ?: EV_KEY;int state = (gpio_get_value_cansleep(button->gpio) ? 1 : 0) ^ button->active_low;if (type == EV_ABS) {if (state) input_event(input, type, button->code, button->value); } else { input_event(input, type, button->code, !!state); } input_sync(input);}
使用非 GPIO 的外部 IRQ（else），当按键按下去触发中断后，调用中断回调函数
isr = gpio_keys_irq_isr;static irqreturn_t gpio_keys_irq_isr(int irq, void *dev_id){struct gpio_button_data *bdata = dev_id;const struct gpio_keys_button *button = bdata->button;struct input_dev *input = bdata->input; unsigned long flags; BUG_ON(irq != bdata->irq); spin_lock_irqsave(&bdata->lock, flags);if (!bdata->key_pressed) {if (bdata->button->wakeup) pm_wakeup_event(bdata->input->dev.parent, 0); input_event(input, EV_KEY, button->code, 1); input_sync(input);if (!bdata->timer_debounce) { input_event(input, EV_KEY, button->code, 0); input_sync(input);goto out; } bdata->key_pressed = true; }if (bdata->timer_debounce) mod_timer(&bdata->timer, jiffies + msecs_to_jiffies(bdata->timer_debounce));out: spin_unlock_irqrestore(&bdata->lock, flags);return IRQ_HANDLED;}
gpio_keys_irq_isr 是按键中断处理函数，向 Linux 系统上报 EV_KEY 事件，表示按键按下。使用 input_sync 函数向系统上报 EV_REP 同步事件。即：
input_event(input, EV_KEY, button->code, 1); input_sync(input);
gpio_keys_setup_key 是单个按键初始化的核心，关键要点：
- 资源兼容同时支持设备树（GPIO 描述符）和传统 GPIO 号配置，优先设备树；
- 消抖策略硬件消抖优先，失败则用软件消抖（延迟工作队列 / 定时器）；
- 中断处理GPIO 按键绑定
gpio_keys_gpio_isr，纯中断按键绑定 gpio_keys_irq_isr； - 核心动作通过
input_set_capability 向输入子系统注册按键能力，通过 devm_request_any_context_irq 申请中断，完成按键的硬件→软件事件的链路打通。
error = sysfs_create_group(&pdev->dev.kobj, &gpio_keys_attr_group)：注册gpio-keys在sys文件系统下的访问接口属性，gpio-keys设备在sys文件系统路径为：/sys/devices/button，其中button为DTS中设备设备节点名称。
error = input_register_device(input);：注册输入设备到内核。
总的来说流程：probe 初始化（GPIO / 中断 / 输入设备）→ 中断 / 轮询处理（消抖 + 电平读取）→ input_event 上报事件。
驱动测试（验证是否生效）
驱动加载后，可通过以下步骤验证：
- 1.查看输入设备节点
ls /dev/input/ # 会看到eventX（如event0、event1）cat /proc/bus/input/devices # 找到名称为"gpio-key-0"的设备，确认event节点hexdump /dev/input/eventX # 替换为实际的event节点按下 / 松开按键时，会看到输出的事件数据，说明驱动正常上报事件。假设按一下「音量 +」按键，hexdump /dev/input/event1 会输出两行核心数据（按下 + 松开）：0000000 8f67 5ff9 8a49 0007 0001 0183 0001 00000000010 8f67 5ff9 8a49 0007 0000 0000 0000 00000000020 8f67 5ff9 9012 0007 0001 0183 0000 00000000030 8f67 5ff9 9012 0007 0000 0000 0000 0000
关键注意事项
- 事件上报规范
- 每一组事件必须以
input_sync()结尾，否则上层无法正确解析； - 按键事件的
value：1 = 按下，0 = 松开，2 = 长按（可选）；
- 中断触发方式
- 物理按键建议用
IRQF_TRIGGER_RISING | IRQF_TRIGGER_FALLING（双边沿），同时检测按下和松开；
- 资源释放顺序
- 注册顺序：GPIO → input_dev → 中断；
- 释放顺序：中断 → input_dev → GPIO（逆序释放，避免依赖）；
- 设备树匹配（进阶）
- 实际项目中，GPIO、按键编码等参数建议通过设备树传递，而非硬编码，只需修改 probe 函数读取设备树属性即可；
- 去抖处理（可选）
- 物理按键可能有抖动，可在中断处理函数中加
msleep(20)去抖，或用工作队列延迟处理。
