嵌入式 Linux 与 RTOS / 系统课时

用 pinctrl 配置引脚复用

用 pinctrl 配置引脚复用

同一颗 SoC 的物理引脚常能在 GPIO、UART、SPI 等功能之间切换。pinctrl 的目标不是“给设备分配一个引脚号”,而是把复用功能、电气属性和运行状态绑定到设备,确保驱动启用、休眠和恢复时都选择正确配置,并避免两个设备同时抢占同一组引脚。

学习目标

  • 能读懂 pinctrl-names、pinctrl-0、pinctrl-1 与状态组之间的对应关系。
  • 能把复用功能和上拉、驱动能力等电气属性放进 SoC 的 pinctrl 节点。
  • 能用 debugfs 检查当前复用归属,定位 GPIO 与外设功能冲突。

把复用、电气属性和状态分开看

pinctrl 状态由一组或多组 pin configuration 组成。复用决定某个焊盘接到 UART、SPI 还是 GPIO;电气属性决定上下拉、驱动能力、slew rate 等;状态则把这些配置组织成 default、sleep 等可切换集合。

设备节点通过 pinctrl-names 给状态命名,再用 pinctrl-0、pinctrl-1 按索引引用对应组。pinctrl-0 并不固定代表某种语义,它只对应 pinctrl-names 中索引为 0 的名字。

定义 default 与 sleep 状态

下面以 NXP i.MX8M Mini 风格为例,展示同一 UART 在运行态复用为 UART,在休眠态改回 GPIO。它是片段示例,依赖当前内核中的 i.MX8MM pinfunc 宏、&iomuxc 和 &uart2 节点。

dts
&iomuxc {
    pinctrl_uart2: uart2grp {
        fsl,pins = <
            MX8MM_IOMUXC_UART2_RXD_UART2_DCE_RX 0x140
            MX8MM_IOMUXC_UART2_TXD_UART2_DCE_TX 0x140
        >;
    };

    pinctrl_uart2_sleep: uart2-sleep-grp {
        fsl,pins = <
            MX8MM_IOMUXC_UART2_RXD_GPIO5_IO26 0x140
            MX8MM_IOMUXC_UART2_TXD_GPIO5_IO25 0x140
        >;
    };
};

&uart2 {
    pinctrl-names = "default", "sleep";
    pinctrl-0 = <&pinctrl_uart2>;
    pinctrl-1 = <&pinctrl_uart2_sleep>;
    status = "okay";
};

这段配置生效后,设备进入 default 状态时选择 pinctrl_uart2,进入 sleep 状态时选择 pinctrl_uart2_sleep。具体由设备核心、驱动或 PM 回调何时选择 sleep,取决于驱动实现,不能只因为设备树里写了 sleep 就假设一定会自动切换。

pinctrl 状态与引脚复用关系

排查引脚抢占和配置未生效

最常见的问题不是语法错误,而是两个已启用设备把同一焊盘配置成不同功能。例如 UART 节点仍为 okay,另一个 GPIO 驱动又尝试申请同一引脚,就可能出现申请失败,或板上信号与预期不一致。

确认内核已挂载 debugfs,并检查 pinctrl 的当前归属。下面命令中的 <CONTROLLER> 替换为实际控制器目录名,可先用 ls /sys/kernel/debug/pinctrl 查看。

bash
mountpoint -q /sys/kernel/debug || sudo mount -t debugfs debugfs /sys/kernel/debug
grep -E 'uart2|UART2|GPIO5_IO2[56]' /sys/kernel/debug/pinctrl/<CONTROLLER>/pinmux-pins

预期输出会包含相关引脚、当前 function 或 group;具体字段顺序因 pinctrl 驱动而异。

text
pin <ID> (<PIN>) ... function uart2 ... group uart2grp
pin <ID> (<PIN>) ... function uart2 ... group uart2grp

如果输出显示目标焊盘仍属于 GPIO,先检查 status、pinctrl-names 索引是否匹配,再检查 pin group 的 phandle 是否引用正确;如果同一物理引脚同时出现在两个启用设备的活动状态中,应关闭其中一个设备或重新规划复用,而不是靠调整驱动加载顺序碰运气。

pinctrl 的关键是把“谁使用这根引脚、在什么状态下使用、以什么电气参数使用”写成可追踪的状态关系。只要先确认绑定语法,再核对状态索引和当前 pinmux 归属,大多数板级复用问题都能在进入驱动寄存器调试之前定位。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用 pinctrl 配置引脚复用

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通