4. 设备树中复用配置：pinctrl-0/pinctrl-names属性详解、复用状态切换、多状态配置示例

在嵌入式Linux系统中，引脚复用（Pin Muxing）是GPIO子系统与外部设备交互前的关键步骤。设备树（Device Tree）通过 pinctrl-* 属性体系，将引脚复用配置从驱动代码中解耦，实现了“配置即数据”的设计思想。本章深入解析 pinctrl-0、pinctrl-names 的核心语义、复用状态切换机制以及多状态配置的典型实践。

4.1 pinctrl-* 属性体系概述

设备树中，任何需要引脚复用控制的设备节点都可以通过 pinctrl- 属性引用一个或多个引脚控制状态（pin control state）。每个状态对应一组引脚复用配置，由 pin controller 节点定义。核心属性如下：

4.2 pinctrl-names 属性详解

pinctrl-names 是连接设备驱动与引脚配置的“语义桥梁”。它允许驱动使用可读的字符串（如 "default"）来请求特定的引脚复用状态，而不必关心底层硬件细节。常见的命名约定包括：

• default：设备正常工作时使用的引脚复用配置，驱动初始化时自动应用。
• sleep：设备进入低功耗模式时的引脚配置，通常将引脚设置为输入、上拉或高阻态以节省功耗。
• idle：设备空闲时的引脚状态，介于 default 和 sleep 之间。
• active：设备从休眠唤醒后切换回工作状态的配置。
• init：仅用于初始化阶段的临时配置，之后会被其他状态覆盖。

以下是一个典型的设备树片段，展示了 pinctrl-names 与 pinctrl-0/pinctrl-1 的配对关系：

&uart0 {
    pinctrl-names = "default", "sleep";
    pinctrl-0 = &uart0_default_pins;
    pinctrl-1 = &uart0_sleep_pins;
    status = "okay";
};

在这个例子中，pinctrl-names 的第一个字符串 "default" 对应 pinctrl-0，第二个字符串 "sleep" 对应 pinctrl-1。驱动可以通过 devm_pinctrl_get_select() 或 pinctrl_lookup_state() 按名称切换状态。

4.3 复用状态切换机制

内核的 pinctrl 子系统在设备驱动生命周期中自动管理状态切换。下图展示了从设备初始化到运行再到休眠的完整状态流转：

状态切换的核心机制由 drivers/pinctrl/core.c 中的 pinctrl_select_state() 函数实现。驱动可以通过以下 API 进行手动控制：

• devm_pinctrl_get_select(struct device *dev, const char *name)：获取并立即切换到指定名称的状态。
• pinctrl_lookup_state(struct pinctrl *p, const char *name)：查找状态但不切换。
• pinctrl_select_state(struct pinctrl *p, struct pinctrl_state *state)：切换到已查找的状态。

4.4 多状态配置示例

实际项目中，一个设备往往需要多个引脚复用状态来应对不同工作场景。以下是一个完整的 SPI 控制器多状态配置示例，包含 default、sleep 和 high_speed 三种状态：

/* 在 pin controller 节点中定义引脚组 */
&pinctrl {
    spi0_default_pins: spi0_default {
        function = "spi0";
        pins = "PIO0_10", "PIO0_11", "PIO0_12", "PIO0_13";
        bias-pull-up;
        drive-strength = <4>;
        slew-rate = <0>;
    };

    spi0_sleep_pins: spi0_sleep {
        function = "gpio";
        pins = "PIO0_10", "PIO0_11", "PIO0_12", "PIO0_13";
        bias-high-impedance;
    };

    spi0_high_speed_pins: spi0_high_speed {
        function = "spi0";
        pins = "PIO0_10", "PIO0_11", "PIO0_12", "PIO0_13";
        drive-strength = <8>;
        slew-rate = <1>;
    };
};

/* 在 SPI 控制器节点中引用 */
&spi0 {
    pinctrl-names = "default", "sleep", "high_speed";
    pinctrl-0 = &spi0_default_pins;
    pinctrl-1 = &spi0_sleep_pins;
    pinctrl-2 = &spi0_high_speed_pins;
    status = "okay";
};

上述配置中，三种状态分别对应：

驱动代码中，可以通过以下方式在运行时动态切换状态：

#include <linux/pinctrl/consumer.h>

struct spi_device *spi;
struct pinctrl *pinctrl;
struct pinctrl_state *high_speed_state;

pinctrl = devm_pinctrl_get(&spi->dev);
if (IS_ERR(pinctrl))
    return PTR_ERR(pinctrl);

high_speed_state = pinctrl_lookup_state(pinctrl, "high_speed");
if (IS_ERR(high_speed_state))
    dev_warn(&spi->dev, "high_speed state not available\n");
else
    pinctrl_select_state(pinctrl, high_speed_state);

/* 执行高速传输... */

/* 切回默认状态 */
pinctrl_select_state(pinctrl, pinctrl_lookup_state(pinctrl, "default"));

4.5 多状态配置的典型应用场景

多状态配置不仅限于电源管理，在以下场景中同样发挥重要作用：

• 动态电压频率调整（DVFS）：根据 CPU 频率切换引脚驱动强度，避免信号过冲。
• 音频编解码器：播放时配置为 I2S 功能，静音时切换为 GPIO 以关闭时钟输出。
• 触摸屏控制器：工作状态使用专用接口，休眠时释放总线供其他设备使用。
• 复用调试接口：正常运行时为 UART 控制台，调试模式下切换为 JTAG/SWD 功能。

4.6 常见问题与排查方法

在配置 pinctrl 多状态时，开发者常遇到以下问题：

通过 /sys/kernel/debug/pinctrl 下的调试接口，可以实时查看每个引脚的当前复用功能和所属设备，是排查引脚冲突的首选工具。