2. Linux GPIO 子系统架构：gpiolib 框架、pin control 子系统、硬件抽象层

在嵌入式 Linux 系统中，GPIO 驱动开发并非直接操作寄存器，而是通过一套分层的软件架构来管理。这套架构的核心是 gpiolib 框架、pin control 子系统 以及底层的 硬件抽象层。理解这三层的关系，是编写可移植、可维护 GPIO 驱动的关键。

2.1 整体架构分层

下图展示了 GPIO 子系统在 Linux 内核中的位置与分层关系。从顶层的用户空间接口到底层的硬件寄存器，每一层都承担着明确的职责。

2.2 gpiolib 框架详解

gpiolib 是 GPIO 子系统的核心，它定义了一套标准的数据结构和 API，用于管理 GPIO 引脚。其主要组件包括：

• gpio_chip：代表一个 GPIO 控制器，包含操作函数集（如 .direction_input、.direction_output、.get、.set）和私有数据。
• gpio_desc：GPIO 描述符，是内核内部对某个 GPIO 引脚的抽象表示，包含引用计数、标志位等信息。
• GPIO 号分配：系统为每个 GPIO 引脚分配一个全局唯一的整数编号（或基于 ACPI/设备树的描述符）。
• 消费者接口：其他内核模块（如 LED、按键、I2C 设备）通过 gpiod_get()/gpiod_set_value() 等 API 使用 GPIO。

2.3 pin control 子系统

pin control 子系统（pinctrl）负责管理 SoC 引脚的复用功能（muxing）和电气特性（如上下拉、驱动强度、施密特触发）。它与 gpiolib 协同工作，但职责不同：

• 引脚复用：将一个物理引脚配置为 GPIO、UART TX、I2C SCL 等不同功能。
• 引脚配置：设置引脚的电气属性，如内部上拉/下拉电阻、驱动能力、电压阈值。
• 引脚分组：将多个引脚定义为一个组，便于批量配置（如 I2C 的两根线）。
• 状态管理：通过设备树中的 pinctrl-0、pinctrl-1 等属性，在设备不同运行状态（default、sleep、idle）下切换引脚配置。

2.4 硬件抽象层 (HAL)

硬件抽象层是 GPIO 子系统中最接近硬件的部分。它由 SoC 厂商或板级开发者实现，负责将 gpiolib 和 pinctrl 的通用操作映射到具体的寄存器读写。HAL 通常包含以下内容：

• GPIO 控制器驱动：实现 gpio_chip 结构体中的回调函数，如 .direction_output 会写某个寄存器位，.get 会读数据寄存器。
• pinctrl 驱动：实现引脚复用和配置的底层操作，如写复用选择寄存器、设置上拉电阻。
• 设备树绑定：定义 SoC 的 GPIO 控制器和 pinctrl 控制器在设备树中的描述方式，包括寄存器地址、中断号、引脚数量等。

2.5 设备树中的 GPIO 与 pinctrl 描述

设备树是连接硬件描述与驱动框架的桥梁。一个典型的 GPIO 设备树节点包含以下关键属性：

// GPIO 控制器节点（由 SoC dtsi 文件提供）
gpio1: gpio@0209c000 {
    compatible = "fsl,imx6ul-gpio", "fsl,imx35-gpio";
    reg = <0x0209c000 0x4000>;
    interrupts = <GIC_SPI 66 IRQ_TYPE_LEVEL_HIGH>;
    gpio-controller;
    #gpio-cells = <2>;  // 第一个 cell 是引脚号，第二个是标志
    interrupt-controller;
    #interrupt-cells = <2>;
};

// pinctrl 控制器节点
iomuxc: iomuxc@020e0000 {
    compatible = "fsl,imx6ul-iomuxc";
    reg = <0x020e0000 0x4000>;

    // 板级引脚复用配置（由板级 dts 文件提供）
    pinctrl_led: ledgrp {
        fsl,pins = <
            MX6UL_PAD_GPIO1_IO03__GPIO1_IO03  0x10b0  // 配置为 GPIO 功能，设置电气属性
        >;
    };
};

// 消费者设备节点（如 LED）
leds {
    compatible = "gpio-leds";
    pinctrl-names = "default";
    pinctrl-0 = <&pinctrl_led>;  // 引用 pinctrl 配置

    led0 {
        label = "heartbeat";
        gpios = <&gpio1 3 GPIO_ACTIVE_LOW>;  // 使用 gpio1 的第 3 号引脚
        linux,default-trigger = "heartbeat";
    };
};

2.6 架构总结与对比