3. GPIO驱动框架：pinctrl子系统、gpiolib库、中断请求API

在嵌入式Linux系统中，GPIO中断的实时性优化离不开对底层驱动框架的深刻理解。本章将剖析GPIO驱动三大核心组件：pinctrl子系统（引脚控制）、gpiolib库（通用GPIO接口）以及中断请求API（devm_request_irq）。这三者构成了从硬件引脚配置到中断响应链路的完整软件栈。

3.1 pinctrl子系统：引脚功能的多路复用与控制

pinctrl子系统是SoC引脚管理的核心，负责解决“一个物理引脚对应多个内部功能”的复用问题。在GPIO中断场景中，必须确保引脚被配置为GPIO模式，而非UART、I2C等外设功能。

3.1.1 pinctrl的核心职责

• 引脚复用（Pin Muxing）： 将物理引脚切换到GPIO功能。
• 引脚配置（Pin Configuration）： 设置上下拉、驱动强度、施密特触发等电气参数。
• 引脚分组（Pin Groups）： 将多个引脚作为一个组进行统一配置。

3.1.2 设备树中的pinctrl配置

在设备树（Device Tree）中，通过pinctrl-0和pinctrl-names属性将引脚状态绑定到设备节点。以下是一个典型的GPIO按键节点配置：

gpio_keys: gpio-keys {
    compatible = "gpio-keys";
    pinctrl-names = "default";
    pinctrl-0 = <&key_pins>;
    status = "okay";

    key_interrupt {
        label = "INT_KEY";
        gpios = <&gpio1 15 GPIO_ACTIVE_LOW>;
        linux,code = <KEY_ENTER>;
        interrupt-parent = <&gpio1>;
        interrupts = <15 IRQ_TYPE_EDGE_FALLING>;
    };
};

&pinmux {
    key_pins: key_pins {
        pinctrl-single,pins = <
            0x1C0 (PIN_INPUT | MUX_MODE_7)  /* GPIO1_15 */
        >;
    };
};

3.2 gpiolib库：统一的GPIO操作抽象层

gpiolib为内核驱动和用户空间提供了标准化的GPIO操作接口，屏蔽了不同SoC的硬件差异。在中断优化场景中，gpiolib负责将GPIO编号映射到具体的中断号，并提供中断触发类型的配置。

3.2.1 gpiolib的核心数据结构

3.2.2 gpio_to_irq() 映射机制

gpiolib通过gpio_to_irq()函数将GPIO编号转换为Linux中断号。该函数调用gpio_chip->to_irq()回调，最终映射到中断控制器的硬件中断线。映射流程如下：

int gpio_to_irq(unsigned int gpio)
{
    struct gpio_desc *desc = gpio_to_desc(gpio);
    if (!desc)
        return -EINVAL;
    /* 调用 gpio_chip 的 to_irq 回调 */
    return desc->chip->to_irq(desc->chip, gpio - desc->chip->base);
}

3.3 中断请求API：devm_request_irq 深度解析

devm_request_irq()是Linux内核推荐的托管式中断注册接口，它自动管理中断资源的释放，避免驱动卸载时的资源泄漏。在GPIO中断场景中，该API将中断处理函数绑定到由gpio_to_irq()获取的中断号上。

3.3.1 API原型与参数

int devm_request_irq(struct device *dev, unsigned int irq,
                     irq_handler_t handler, unsigned long irqflags,
                     const char *devname, void *dev_id);

3.3.2 中断触发类型选择

中断触发类型直接影响实时响应性能。下表对比了常见触发类型的适用场景：

3.4 GPIO中断请求与响应流程（SVG架构图）

下图展示了从硬件引脚中断信号产生到CPU执行中断处理函数的完整软件栈流程：

3.5 驱动代码示例：完整的GPIO中断注册流程

以下代码展示了在驱动probe函数中，如何结合pinctrl、gpiolib和devm_request_irq完成GPIO中断的完整注册：

#include <linux/module.h>
#include <linux/platform_device.h>
#include <linux/gpio.h>
#include <linux/interrupt.h>
#include <linux/of_gpio.h>
#include <linux/of_irq.h>

struct gpio_irq_data {
    int gpio;
    int irq;
    int trigger_type;
};

static irqreturn_t gpio_irq_handler(int irq, void *dev_id)
{
    struct gpio_irq_data *data = (struct gpio_irq_data *)dev_id;
    /* 极简处理：仅设置标志位，实际工作交给底半部 */
    /* 此处不可调用可能导致睡眠的函数 */
    return IRQ_WAKE_THREAD;  /* 唤醒线程化底半部 */
}

static irqreturn_t gpio_irq_thread_fn(int irq, void *dev_id)
{
    struct gpio_irq_data *data = (struct gpio_irq_data *)dev_id;
    int val = gpio_get_value(data->gpio);
    /* 执行实际的中断处理逻辑 */
    pr_info("GPIO %d interrupt triggered, value=%d\n", data->gpio, val);
    return IRQ_HANDLED;
}

static int my_gpio_probe(struct platform_device *pdev)
{
    struct device *dev = &pdev->dev;
    struct gpio_irq_data *data;
    int ret;

    data = devm_kzalloc(dev, sizeof(*data), GFP_KERNEL);
    if (!data)
        return -ENOMEM;

    /* 1. 从设备树获取GPIO编号 */
    data->gpio = of_get_named_gpio(dev->of_node, "interrupt-gpios", 0);
    if (!gpio_is_valid(data->gpio)) {
        dev_err(dev, "Failed to get GPIO\n");
        return -EINVAL;
    }

    /* 2. 请求GPIO并设置方向为输入 */
    ret = devm_gpio_request_one(dev, data->gpio, GPIOF_IN, "my_gpio_irq");
    if (ret) {
        dev_err(dev, "Failed to request GPIO %d\n", data->gpio);
        return ret;
    }

    /* 3. 将GPIO映射为中断号 */
    data->irq = gpio_to_irq(data->gpio);
    if (data->irq < 0) {
        dev_err(dev, "Failed to map GPIO to IRQ\n");
        return data->irq;
    }

    /* 4. 注册线程化中断处理函数 */
    ret = devm_request_threaded_irq(dev, data->irq,
                                    gpio_irq_handler,      /* 顶半部 */
                                    gpio_irq_thread_fn,    /* 底半部 */
                                    IRQF_TRIGGER_FALLING | IRQF_ONESHOT,
                                    "my_gpio_irq", data);
    if (ret) {
        dev_err(dev, "Failed to request IRQ %d\n", data->irq);
        return ret;
    }

    platform_set_drvdata(pdev, data);
    dev_info(dev, "GPIO IRQ driver initialized, gpio=%d, irq=%d\n",
             data->gpio, data->irq);
    return 0;
}

static const struct of_device_id my_gpio_of_match[] = {
    { .compatible = "my,gpio-irq-device" },
    { }
};
MODULE_DEVICE_TABLE(of, my_gpio_of_match);

static struct platform_driver my_gpio_driver = {
    .probe  = my_gpio_probe,
    .driver = {
        .name = "my_gpio_irq",
        .of_match_table = my_gpio_of_match,
    },
};
module_platform_driver(my_gpio_driver);

MODULE_LICENSE("GPL");
MODULE_DESCRIPTION("GPIO Interrupt Optimization Example");

3.6 实时性关键检查清单