当前位置：首页 > news >正文

别再乱改设备树了！手把手教你用sysfs和debugfs排查RK3588 GPIO复用冲突

news 2026/4/30 9:56:58

实战指南：用sysfs和debugfs精准定位RK3588 GPIO冲突问题

当你在RK3588开发板上修改设备树后，发现某个GPIO始终无法正常控制——无论设置输出高低电平还是读取输入状态都失效，这很可能是因为该引脚被其他外设复用了。本文将带你用Linux系统自带的sysfs和debugfs工具，像侦探一样层层排查，找到真正的"元凶"。

1. 快速验证GPIO基础功能

在深入排查之前，先确认GPIO的基本操作流程是否正确。假设我们要测试GPIO3_D4（全局编号116）：

# 导出GPIO echo 116 > /sys/class/gpio/export # 设置为输出模式 echo out > /sys/class/gpio/gpio116/direction # 尝试拉高 echo 1 > /sys/class/gpio/gpio116/value # 读取当前状态 cat /sys/class/gpio/gpio116/value

如果这些操作都失败，特别是出现Device or resource busy错误，就说明该GPIO可能被其他功能占用。此时需要更深入的诊断工具。

2. 使用debugfs查看引脚复用状态

Linux内核的debugfs提供了pinmux-pins文件，可以显示所有引脚的当前复用状态：

cat /sys/kernel/debug/pinctrl/pinctrl-rockchip-pinctrl/pinmux-pins

输出示例（关键部分）：

pin 116 (gpio3-20): (MUX UNCLAIMED) (GPIO UNCLAIMED) function hdmi group hdmim1-rx pin 117 (gpio3-21): function gpio group gpio3-21

解读技巧：

MUX UNCLAIMED：没有驱动声明控制该引脚
GPIO UNCLAIMED：未被GPIO子系统使用
function/group：显示当前实际功能

当看到类似function hdmi group hdmim1-rx的信息时，说明该引脚被HDMI功能占用。

3. 定位设备树中的冲突配置

通过debugfs获取的信息，我们可以精准定位到设备树中的相关配置。以HDMI占用为例：

在设备树源文件中搜索hdmim1-rx（通常在rk3588s-pinctrl.dtsi）
找到对应的控制器节点（如hdmirx_ctrler）
检查其状态是否为okay：

&hdmirx_ctrler { status = "okay"; // 改为"disabled"可释放GPIO ... };

常见需要检查的外设节点：

显示接口：hdmi,dp,edp
视频输入：csi,isp
高速接口：usbdp_phy,pcie
音频：i2s,spdif

4. 安全修改设备树的实践建议

直接禁用外设可能影响系统其他功能，建议采用以下安全流程：

备份当前配置：

cp /boot/extlinux/extlinux.conf /boot/extlinux/extlinux.conf.bak

创建叠加层(overlay)：

/dts-v1/; /plugin/; &hdmirx_ctrler { status = "disabled"; }; &gpio3 { pinctrl-names = "default"; pinctrl-0 = <&gpio3_d4_default>; gpio3_d4_default: gpio3-d4-default { rockchip,pins = <3 RK_PD4 RK_FUNC_GPIO &pcfg_pull_none>; }; };

编译和应用叠加层：

dtc -@ -I dts -O dtb -o disable_hdmi.dtbo disable_hdmi.dts cp disable_hdmi.dtbo /boot/overlays/ # 在extlinux.conf中添加fdtoverlays=disable_hdmi.dtbo

5. 特殊情况的处理技巧

有些GPIO看似可用但无法控制，常见于以下场景：

案例1：被USB Type-C PHY占用的GPIO

&usbdp_phy0 { sbu1-dc-gpios = <&gpio4 RK_PA6 GPIO_ACTIVE_HIGH>; sbu2-dc-gpios = <&gpio4 RK_PA7 GPIO_ACTIVE_HIGH>; };

即使显示为GPIO功能，这些引脚实际由PHY控制器管理，需要禁用整个PHY节点才能释放。

案例2：复用为GPIO的特殊功能

# 查看gpiochip信息 ls /sys/class/gpio/

如果目标GPIO不在主控制器(gpiochip0-4)范围内，可能需要通过专用接口控制。

6. 自动化排查脚本

以下脚本可快速检查GPIO状态：

#!/bin/bash GPIO_NUM=$1 # 检查导出状态 echo $GPIO_NUM > /sys/class/gpio/export 2>&1 | grep -q "busy" && { echo "[ERROR] GPIO $GPIO_NUM is busy" echo "Checking pinmux status..." grep "pin $GPIO_NUM" /sys/kernel/debug/pinctrl/pinctrl-rockchip-pinctrl/pinmux-pins exit 1 } # 测试基本功能 echo out > /sys/class/gpio/gpio$GPIO_NUM/direction for val in 1 0 1; do echo $val > /sys/class/gpio/gpio$GPIO_NUM/value read_val=$(cat /sys/class/gpio/gpio$GPIO_NUM/value) [ "$val" != "$read_val" ] && { echo "[WARN] GPIO $GPIO_NUM write $val but read $read_val" } sleep 0.1 done # 清理 echo $GPIO_NUM > /sys/class/gpio/unexport

使用方式：./check_gpio.sh 116