2. GPIO子系统详解与实战：GPIO硬件原理、Linux GPIO子系统框架、用户空间与内核空间GPIO操作

2.1 GPIO硬件原理：从引脚到寄存器

GPIO，说白了就是通用输入输出引脚。你想想看，一颗SoC少则几十个，多则几百个这样的引脚。每个引脚都能独立配置成输入或输出，还能带上拉、下拉、中断功能。

我在项目中遇到过最典型的场景：一个按键接在GPIO上，按下时电平拉低，松开时电平拉高。就这么简单的一个动作，背后涉及的是引脚内部的上拉电阻、施密特触发器、输出驱动电路。

硬件上，GPIO模块通常包含以下几部分：

• 控制寄存器：配置方向（输入/输出）、驱动能力、上下拉
• 数据寄存器：读取输入电平或设置输出电平
• 中断寄存器：配置触发条件（上升沿、下降沿、高电平、低电平）
• 复用寄存器：将引脚分配给GPIO或其他外设功能

举个例子，STM32的GPIO输出操作：

// 设置GPIOB的Pin 0为输出
GPIOB->MODER |= (1 << 0);    // 01 = 通用输出模式
GPIOB->OTYPER &= ~(1 << 0); // 0 = 推挽输出
GPIOB->OSPEEDR |= (3 << 0); // 11 = 高速

// 输出高电平
GPIOB->BSRR = (1 << 0);     // 使用BSRR寄存器置位

嗯，这里要注意：直接操作寄存器虽然快，但可移植性差。Linux GPIO子系统就是来解决这个问题的。

2.2 Linux GPIO子系统框架：三层架构

Linux GPIO子系统分三层，我画了张图帮你理解：

这三层各司其职：

层级	职责	接口/组件
用户空间	应用程序直接操作GPIO	sysfs (旧)、libgpiod (新)、字符设备
内核空间	提供统一API，管理GPIO资源	gpiolib核心、pinctrl、中断子系统
硬件层	封装具体SoC的寄存器操作	gpio_chip结构体、regmap、mmio

2.3 内核空间GPIO操作：驱动开发实战

在内核里写GPIO驱动，核心就是实现一个gpio_chip结构体。我直接给你看一个简化版示例：

#include <linux/gpio/driver.h>

static struct gpio_chip my_gpio_chip = {
    .label          = "my-gpio-controller",
    .owner          = THIS_MODULE,
    .base           = -1,          // 动态分配编号
    .ngpio          = 8,           // 8个引脚
    .direction_input  = my_gpio_direction_input,
    .direction_output = my_gpio_direction_output,
    .get            = my_gpio_get,
    .set            = my_gpio_set,
    .request        = my_gpio_request,
    .free           = my_gpio_free,
};

static int __init my_gpio_init(void)
{
    return gpiochip_add_data(&my_gpio_chip, NULL);
}

static void __exit my_gpio_exit(void)
{
    gpiochip_remove(&my_gpio_chip);
}

每个回调函数对应一个硬件操作。比如my_gpio_set的实现：

static void my_gpio_set(struct gpio_chip *chip, unsigned int offset, int value)
{
    void __iomem *base = chip->priv;  // 私有数据指向寄存器基址
    u32 reg;

    reg = readl(base + GPIO_DATA_REG);
    if (value)
        reg |= BIT(offset);
    else
        reg &= ~BIT(offset);
    writel(reg, base + GPIO_DATA_REG);
}

内核里其他驱动怎么用你的GPIO？通过gpiod_系列API：

// 获取GPIO描述符
struct gpio_desc *gpio = gpiod_get(dev, "enable", GPIOD_OUT_LOW);
if (IS_ERR(gpio)) {
    dev_err(dev, "Failed to get GPIO\n");
    return PTR_ERR(gpio);
}

// 输出高电平
gpiod_set_value(gpio, 1);

// 读取输入
int val = gpiod_get_value(gpio);

// 请求中断
int irq = gpiod_to_irq(gpio);
ret = request_threaded_irq(irq, NULL, my_isr_thread,
                           IRQF_TRIGGER_RISING | IRQF_ONESHOT,
                           "my-device", dev);

// 释放
gpiod_put(gpio);

2.4 用户空间GPIO操作：libgpiod实战

用户空间操作GPIO，现在推荐用libgpiod。它通过字符设备/dev/gpiochipN与内核通信。命令行工具集很实用：

命令	功能	示例
gpiodetect	列出所有GPIO控制器	gpiodetect
gpioinfo	查看芯片引脚信息	gpioinfo gpiochip0
gpioget	读取引脚电平	gpioget gpiochip0 3
gpioset	设置引脚电平	gpioset gpiochip0 3=1
gpiomon	监控引脚中断事件	gpiomon gpiochip0 3

C语言编程示例：

#include <gpiod.h>

int main(void)
{
    struct gpiod_chip *chip;
    struct gpiod_line *line;
    int ret, val;

    // 打开GPIO芯片
    chip = gpiod_chip_open_by_name("gpiochip0");
    if (!chip) {
        perror("Open chip failed");
        return -1;
    }

    // 获取引脚3
    line = gpiod_chip_get_line(chip, 3);
    if (!line) {
        perror("Get line failed");
        gpiod_chip_close(chip);
        return -1;
    }

    // 配置为输出，初始高电平
    ret = gpiod_line_request_output(line, "my-app", 1);
    if (ret < 0) {
        perror("Request output failed");
        gpiod_chip_close(chip);
        return -1;
    }

    // 输出低电平
    gpiod_line_set_value(line, 0);
    usleep(100000);

    // 输出高电平
    gpiod_line_set_value(line, 1);

    // 释放资源
    gpiod_line_release(line);
    gpiod_chip_close(chip);

    return 0;
}

2.5 性能调优与调试技巧

GPIO操作看似简单，但在高频场景下性能差异巨大。我总结了几条实战经验：

• 批量操作：一次设置多个引脚，别一个一个来。用gpiod_line_set_value_bulk()代替循环调用
• 避免频繁切换：用户空间每次gpiod_line_set_value()都有一次系统调用。如果频率超过1kHz，建议移到内核驱动里做
• 中断合并：多个GPIO中断可以共享一个线程，减少上下文切换
• 缓存寄存器值：读-modify-write操作时，缓存寄存器值避免重复读内存

最后说个调试技巧：用逻辑分析仪抓GPIO波形，比任何printk都直观。我习惯在驱动里加一个GPIO toggling的调试点，用示波器看时序，一眼就能看出延迟在哪。