Linux GPIO按键驱动开发与实战指南

1. Linux设备驱动开发概述

在嵌入式系统和物联网设备开发中，GPIO（General Purpose Input/Output）是最基础也是最常用的硬件接口之一。作为通用输入输出引脚，GPIO可以配置为输入模式检测外部信号，也可以配置为输出模式控制外部设备。而gpio-keys驱动则是Linux内核中专门用于处理GPIO按键的标准驱动框架。

我从事Linux驱动开发已有八年时间，从早期的2.6内核到现在的5.x内核，gpio-keys驱动一直是嵌入式设备按键处理的首选方案。相比自行编写字符设备驱动，使用内核提供的标准框架不仅能减少开发工作量，还能获得更好的稳定性和可维护性。

2. gpio-keys驱动核心原理

2.1 设备树配置解析

gpio-keys驱动的核心配置通过设备树（Device Tree）完成。一个典型的配置示例如下：

dts复制gpio-keys {
    compatible = "gpio-keys";
    #address-cells = <1>;
    #size-cells = <0>;
    autorepeat;

    button@1 {
        label = "Power Button";
        linux,code = <116>;  /* KEY_POWER */
        gpios = <&gpio0 5 GPIO_ACTIVE_LOW>;
        debounce-interval = <100>;
    };
};

关键参数说明：

• compatible：必须包含"gpio-keys"以匹配驱动
• autorepeat：启用按键长按重复触发功能
• linux,code：对应input子系统的键值编码
• gpios：指定GPIO控制器、引脚号和有效电平
• debounce-interval：消抖时间（毫秒）

实际项目中，我曾遇到因消抖时间设置不当导致的按键误触发问题。对于机械按键，建议debounce-interval至少设置为50ms以上。

2.2 驱动工作流程

gpio-keys驱动的核心工作流程可以分为以下几个阶段：

1. 初始化阶段：
   • 解析设备树节