4. pinctrl 子系统：pinctrl 框架、pinmux、pinconf、pinctrl-0/pinctrl-names

pinctrl 子系统是 Linux 内核中负责管理 SoC 引脚复用（Pin Multiplexing）与引脚配置（Pin Configuration）的核心框架。在骁龙平台上，Sensor 设备的上电时序往往依赖特定 GPIO 的初始状态（高/低电平、上下拉、驱动强度），而这些状态正是通过 pinctrl 子系统在设备驱动 probe 阶段自动完成的。理解 pinctrl 的框架结构、pinmux 与 pinconf 的分工，以及设备树中 pinctrl-0 / pinctrl-names 的绑定机制，是调试 GPIO 配置影响上电时序的前提。

4.1 pinctrl 框架三层结构

pinctrl 子系统采用“核心层 + 引脚控制器驱动 + 设备绑定”的三层架构，每一层职责清晰，便于跨平台移植。

4.2 pinmux 与 pinconf：功能分工

pinctrl 子系统将引脚控制拆分为两个独立的概念：pinmux（引脚复用）和 pinconf（引脚配置）。在调试 Sensor 上电时序时，两者缺一不可。

4.3 pinctrl-0 与 pinctrl-names：状态绑定机制

设备树中通过 pinctrl-0、pinctrl-1 等属性定义设备的多个引脚状态，pinctrl-names 为这些状态赋予语义名称。驱动在 probe 时自动切换到 default 状态，在 suspend/resume 时切换到 sleep / active 状态。

/* 设备树示例：Sensor 设备的 pinctrl 绑定 */
sensor@48 {
    compatible = "vendor,sensor";
    reg = <0x48>;
    interrupt-parent = <&tlmm>;
    interrupts = <42 IRQ_TYPE_EDGE_RISING>;

    pinctrl-names = "default", "sleep", "active";
    pinctrl-0 = <&sensor_default>;
    pinctrl-1 = <&sensor_sleep>;
    pinctrl-2 = <&sensor_active>;
};

对应的引脚控制器节点中，需要定义 sensor_default、sensor_sleep、sensor_active 三个状态组：

/* 引脚控制器节点中的状态定义 */
sensor_default: sensor_default {
    mux {
        pins = "gpio42", "gpio43";
        function = "gpio";
    };
    config {
        pins = "gpio42", "gpio43";
        drive-strength = <8>;
        bias-pull-up;
        output-high;   /* 上电时 GPIO42/43 输出高电平 */
    };
};

sensor_sleep: sensor_sleep {
    mux {
        pins = "gpio42", "gpio43";
        function = "gpio";
    };
    config {
        pins = "gpio42", "gpio43";
        bias-pull-down;  /* 休眠时拉低，节省功耗 */
        output-low;
    };
};

4.4 状态切换流程与上电时序关系

驱动 probe 过程中，pinctrl 子系统按以下顺序切换引脚状态，直接影响 Sensor 的上电时序：

1. 设备匹配：内核解析设备树节点，找到 pinctrl-0 引用的状态组。
2. 申请引脚：pinctrl core 调用 pinmux 申请引脚，确保引脚未被其他设备占用。
3. 应用 pinconf：根据 config 子节点设置上下拉、驱动强度、输出电平。
4. 状态切换完成：驱动继续执行 probe 剩余逻辑（如复位 Sensor、启动电源）。

4.5 调试检查清单

在骁龙平台上调试 Sensor 上电时序时，建议按以下清单检查 pinctrl 配置：