【Linux驱动】Linux 按键驱动开发指南
Linux 按键驱动开发指南
1、按键驱动开发基础
1.1. 按键驱动类型
Linux下的按键驱动主要有两种实现方式:
-
输入子系统驱动:最常用,通过input子系统上报按键事件
-
字符设备驱动:较少用,需要自己实现文件操作接口
1.2. 输入子系统框架
推荐使用input子系统实现按键驱动,主要组件:
-
input_register_device() - 注册输入设备
-
input_report_key() - 上报按键事件
-
input_sync() - 同步事件
2、设备树配置
2.1. 基本按键节点配置
/ {gpio-keys {compatible = "gpio-keys";#address-cells = <1>;#size-cells = <0>;button@1 {label = "Power Button";linux,code = <KEY_POWER>; // 按键编码,定义在include/uapi/linux/input-event-codes.hgpios = <&gpio0 5 GPIO_ACTIVE_LOW>; // 使用的GPIO,低电平有效debounce-interval = <20>; // 消抖时间(ms)};};
};
【linux驱动】【设备树】按键设备树讲解
2.2. 关键属性说明
- compatible: 必须包含"gpio-keys"
- linux,code: 按键键值,如KEY_POWER、KEY_VOLUMEUP等
- gpios: 指定GPIO控制器、引脚和有效电平
- debounce-interval: 硬件消抖时间
3、驱动代码实现
3.1. 基本驱动框架
#include <linux/module.h>
#include <linux/gpio.h>
#include <linux/interrupt.h>
#include <linux/input.h>
#include <linux/platform_device.h>
#include <linux/of_gpio.h>struct gpio_key_data {struct gpio_desc *gpiod;int code;int irq;
};struct gpio_key_drvdata {struct input_dev *input;struct gpio_key_data *data;int n_buttons;
};static irqreturn_t gpio_key_isr(int irq, void *dev_id)
{struct gpio_key_data *key_data = dev_id;struct gpio_key_drvdata *ddata = container_of(key_data, struct gpio_key_drvdata, data);int state = gpiod_get_value(key_data->gpiod);input_report_key(ddata->input, key_data->code, !state);input_sync(ddata->input);return IRQ_HANDLED;
}static int gpio_key_probe(struct platform_device *pdev)
{// 驱动初始化代码// 1. 分配input设备// 2. 解析设备树获取按键信息// 3. 申请GPIO和中断// 4. 注册input设备// ...
}static const struct of_device_id gpio_key_of_match[] = {{ .compatible = "gpio-keys", },{ },
};
MODULE_DEVICE_TABLE(of, gpio_key_of_match);static struct platform_driver gpio_key_driver = {.probe = gpio_key_probe,.driver = {.name = "gpio-keys",.of_match_table = gpio_key_of_match,},
};
module_platform_driver(gpio_key_driver);
4、应用层使用按键驱动
4.1. 通过input子系统访问
按键驱动注册后会在/dev/input/下生成设备节点,如event0
4.2. 读取按键事件示例代码
#include <stdio.h>
#include <linux/input.h>
#include <fcntl.h>
#include <unistd.h>int main()
{int fd = open("/dev/input/event0", O_RDONLY);struct input_event ev;while(1) {read(fd, &ev, sizeof(ev));if(ev.type == EV_KEY && ev.value >= 0 && ev.value <= 2) {printf("Key %d %s\n", ev.code, ev.value ? "pressed" : "released");}}close(fd);return 0;
}
4.3. 使用工具测试
- evtest: 通用输入设备测试工具
- cat /proc/bus/input/devices: 查看已注册的输入设备
5、调试与问题排查
5.1 检查设备树是否正确加载:
ls /proc/device-tree/gpio-keys/
5.2 查看GPIO状态:
cat /sys/kernel/debug/gpio
5.3 检查中断是否注册:
cat /proc/interrupts
5.4 查看input设备信息:
cat /proc/bus/input/devices