📚 课程目录第2章 Pin Control子系统基础

2. Pin Control 子系统基础：核心概念、驱动框架与设备树解析

Pin Control（引脚控制）子系统是嵌入式 Linux 中管理 SoC 引脚复用、电气属性和引脚分组的基础设施。在 GPIO 子系统的上层操作中，任何 GPIO 的输入/输出功能都依赖于 Pin Control 子系统对引脚的初始配置。本章将系统性地讲解 Pin Control 的核心概念、驱动框架结构以及设备树中的节点解析方法。

2.1 Pin Control 核心概念

Pin Control 子系统主要解决以下三个问题：

引脚复用（Pin Muxing）：将 SoC 的物理引脚配置为 GPIO、I2C、SPI、UART 等特定功能。
引脚配置（Pin Configuration）：设置引脚的电气特性，包括上拉/下拉、驱动强度、施密特触发、 slew rate 等。
引脚分组（Pin Grouping）：将多个引脚组合成一个逻辑组，便于批量配置和管理。

关键术语对照表

术语	英文	说明
引脚控制器	pinctrl	管理引脚复用和配置的硬件单元
引脚复用	pin muxing	将物理引脚映射到内部功能模块
引脚组	pin group	一组具有相同复用或配置的引脚
功能	function	引脚组所对应的复用功能（如 i2c0、uart1）
状态	state	设备在不同运行阶段（default、sleep、idle）的引脚配置

理解要点：Pin Control 是 GPIO 子系统的底层依赖。当你在设备树中为某个外设节点指定 pinctrl-0 时，内核会在该设备 probe 之前自动将引脚切换到对应的复用功能。如果 Pin Control 配置错误，GPIO 将无法正常工作。

2.2 pinctrl 驱动框架

Linux 内核的 pinctrl 驱动框架采用分层设计，主要分为三个层次：

核心层（pinctrl-core）：提供通用的 pin control 抽象接口，包括 pin 描述、pin group 管理、function 注册、状态切换等。
引脚控制器驱动层（pinctrl driver）：由 SoC 厂商实现，负责与硬件寄存器交互，完成实际的引脚复用和配置操作。
设备消费者层（consumer）：通过设备树或 API 调用 pinctrl 服务的设备驱动，如 I2C、SPI、GPIO 等。

在驱动实现层面，pinctrl 驱动需要向核心层注册以下回调函数：

回调函数	作用
`get_groups_count`	返回引脚组数量
`get_group_name`	获取指定引脚组的名称
`get_group_pins`	获取指定引脚组包含的引脚列表
`pinmux_enable_setting`	执行引脚复用设置
`pinconf_set_config`	设置引脚电气属性

常见误区：初学者常将 pinctrl 驱动与 GPIO 驱动混为一谈。实际上，pinctrl 驱动负责引脚功能切换，而 GPIO 驱动负责高低电平的读写。两者通过设备树中的 pinctrl-* 属性建立联系，但驱动代码是独立的。

2.3 设备树中 pinctrl 节点解析

设备树是描述 pinctrl 配置的主要手段。一个典型的 pinctrl 设备树节点包含以下结构：

/* 引脚控制器节点 */
pinctrl: pinctrl@10000000 {
    compatible = "vendor,soc-pinctrl";
    reg = <0x10000000 0x1000>;
    #pinctrl-cells = <2>;

    /* 定义引脚组和功能 */
    i2c0_pins: i2c0-pins {
        pins = "GPIO0", "GPIO1";
        function = "i2c0";
        bias-pull-up;
        drive-strength = <4>;
    };

    uart1_pins: uart1-pins {
        pins = "GPIO4", "GPIO5";
        function = "uart1";
        bias-disable;
    };
};

/* 消费者设备节点 */
i2c0: i2c@20000000 {
    compatible = "vendor,i2c";
    reg = <0x20000000 0x100>;
    pinctrl-0 = <&i2c0_pins>;
    pinctrl-1 = <&i2c0_sleep_pins>;
    pinctrl-names = "default", "sleep";
    status = "okay";
};

设备树中 pinctrl 属性的关键规则：

pinctrl-names：定义状态的名称列表，如 "default"、"sleep"、"idle"。顺序与 pinctrl-0、pinctrl-1 等对应。
pinctrl-N：指向引脚组节点的 phandle 列表，N 从 0 开始递增。
#pinctrl-cells：指定引脚控制器所需的额外参数单元数，通常为 1 或 2。
引脚组节点：可以包含 pins、groups、function 以及各种电气属性。

调试技巧：使用 cat /sys/kernel/debug/pinctrl/*/pins 可以查看当前所有引脚的复用状态；使用 cat /sys/kernel/debug/pinctrl/*/pinmux-pins 可以查看每个引脚当前被哪个设备使用。这是排查引脚冲突最直接的方法。

2.4 状态切换机制

pinctrl 支持设备在不同运行状态下切换引脚配置。常见的状态包括：

状态名称	典型场景	配置目标
default	设备正常工作	启用所需外设功能
sleep	系统进入低功耗模式	关闭外设，引脚置为高阻或固定电平
idle	CPU 空闲但外设保持	保持外设功能，降低功耗
init	早期初始化阶段	设置引导阶段所需的引脚

状态切换由核心层自动完成：设备 probe 时切换到 "default" 状态，系统进入 suspend 时切换到 "sleep" 状态，resume 时恢复。驱动开发者也可以调用 pinctrl_select_state() 手动切换。