1. GPIO 子系统概述：角色、概念与 Pin Control 关系

GPIO（General Purpose Input/Output，通用输入输出）是嵌入式系统中最基础、最常用的外设接口。在 Linux 内核中，GPIO 子系统承担着统一管理 SoC 引脚复用、方向控制、电平读写及中断触发的核心职责。本章从宏观视角梳理 GPIO 子系统的定位、基本概念及其与 Pin Control 子系统的协作关系，为后续的驱动开发打下理论基础。

1.1 GPIO 子系统在内核中的角色

Linux 内核采用分层、模块化的设计思想，GPIO 子系统位于硬件与内核其他子系统之间，主要承担以下角色：

1.2 基本概念与术语

在深入代码之前，必须厘清 GPIO 子系统中的核心概念：

• GPIO 控制器（gpio_chip）：代表一个硬件 GPIO 控制器实例，包含一组引脚（通常 8/16/32 个），提供方向设置、电平读写、中断控制等底层操作函数。
• GPIO 描述符（gpio_desc）：内核内部对单个 GPIO 引脚的抽象描述，包含所属控制器、偏移量、标志位（方向、已申请、中断使能等）。
• GPIO 编号（gpio number）：全局唯一的整数标识符，早期内核使用静态编号（0~MAX），现代内核推荐使用描述符 API 避免编号混乱。
• GPIO 映射（gpio mapping）：通过设备树（Device Tree）或 ACPI 将物理引脚与驱动需要的逻辑名称绑定。
• GPIO 中断（gpio interrupt）：将 GPIO 引脚配置为中断源，支持上升沿、下降沿、高电平、低电平触发模式。

1.3 GPIO 子系统与 Pin Control 子系统的关系

Pin Control 子系统（pinctrl）是 GPIO 子系统的“前置依赖”。一个物理引脚在作为 GPIO 使用之前，必须先通过 Pin Control 子系统完成引脚复用（pinmux）和电气属性（pinconf）配置。两者的协作关系可以用下图清晰表达：

上图展示了两个子系统的典型协作流程：

1. 设备树解析阶段：内核解析设备树节点中的 pinctrl-0、pinctrl-names 属性，Pin Control 子系统将引脚配置为 GPIO 功能。
2. GPIO 控制器注册：SoC 的 GPIO 驱动调用 gpiochip_add_data() 注册 gpio_chip，此时引脚已处于 GPIO 复用状态。
3. 驱动请求 GPIO：外设驱动通过 gpiod_get() 获取描述符，Pin Control 子系统确保引脚状态正确。
4. 运行时切换：若驱动需要动态切换引脚功能（如 GPIO 模拟 I2C），需通过 pinctrl_select_state() 重新配置。

1.4 内核中的 GPIO 软件架构

从软件分层角度看，GPIO 子系统在内核中的位置如下：

各层职责简述：

• 用户空间：通过 libgpiod 库或直接操作 /dev/gpiochipX 字符设备访问 GPIO，适用于快速原型或调试。
• 系统调用接口：字符设备驱动层将用户空间的 ioctl、read、write 转换为内核 GPIO API 调用。
• GPIO 核心层：实现描述符分配、引用计数、中断映射、设备树解析、sysfs/cdev 接口等通用逻辑，是 gpiolib 的主体。
• 控制器驱动：由 SoC 厂商实现，填充 gpio_chip 结构体的操作函数，直接操作硬件寄存器。
• 硬件层：物理 GPIO 引脚对应的寄存器组，通常包含方向寄存器、数据寄存器、中断控制寄存器。

1.5 设备树中的 GPIO 与 Pin Control 绑定示例

实际开发中，GPIO 与 Pin Control 的协作通过设备树描述。以下是一个典型示例：

/* 设备树节点：GPIO 控制器 */
gpio0: gpio@ff310000 {
    compatible = "rockchip,gpio-bank";
    reg = <0xff310000 0x1000>;
    interrupts = <GIC_SPI 64 IRQ_TYPE_LEVEL_HIGH>;
    clocks = <&clk_gpio0>;
    gpio-controller;
    #gpio-cells = <2>;
    interrupt-controller;
    #interrupt-cells = <2>;
};

/* 设备树节点：使用 GPIO 的外设 */
led_user {
    compatible = "gpio-leds";
    pinctrl-names = "default";
    pinctrl-0 = <&led_pin>;          /* 引用 Pin Control 配置 */
    
    led0 {
        label = "user_led";
        gpios = <&gpio0 RK_PA5 GPIO_ACTIVE_HIGH>;  /* GPIO 0, pin A5 */
        linux,default-trigger = "heartbeat";
    };
};

/* Pin Control 子节点：将引脚配置为 GPIO 功能 */
&pinctrl {
    led_pin: led-pin {
        rockchip,pins = <0 RK_PA5 &fun_gpio>;  /* bank0, pinA5, 功能=GPIO */
    };
};

1.6 本章小结