RK3588 Pinctrl 调试、冲突排查与安全

1. Debugfs

挂载：

mount -t debugfs none /sys/kernel/debug
ls /sys/kernel/debug/pinctrl

常用文件：

pins
pingroups
pinmux-functions
pinmux-pins
pinconf-pins
pinconf-groups
pinctrl-maps

实际目录名由 controller device决定。

2. GPIO

gpioinfo
cat /sys/kernel/debug/gpio
cat /proc/interrupts

gpioinfo显示 consumer和方向，但不完整显示外设 mux；需结合 pinctrl debugfs。

3. DT

dtc -I fs -O dts /sys/firmware/devicetree/base > /tmp/running.dts
dmesg | grep -Ei 'pinctrl|gpio|defer|conflict'

核对运行 DTB，不只看源码目录中的某个板型。

4. 冲突排查

1.确定异常信号和物理 pin；
2.转换 bank/port/index；
3.查看 pinmux owner；
4.搜索最终 DTS全部引用；
5.确认两个 consumer是否均 enabled；
6.核对 M0/M1 route；
7.核对 pull/drive/VCCIO；
8.检查 bootloader与 sleep state；
9.示波器验证电平/边沿。

5. 常见现象

现象	可能原因
probe成功但总线无波形	pinctrl缺失/错误route
GPIO set无效	pin仍为外设mux或被占用
启动后串口消失	default state覆盖debug UART
suspend不能唤醒	sleep mux/pull或IRQ wake错误
GPIO IRQ风暴	floating/polarity/debounce错误
SD高速失败	drive、VCCIO、时序或布线
I2C卡低	mux错误、无外部上拉或设备拉低

6. 构建检查

make ARCH=arm64 dtbs_check
make ARCH=arm64 W=1 drivers/pinctrl/

本树 RK3588 mux 11/12与 binding最大10有已知不一致，schema告警应通过更新 binding解决并核对硬件。

7. 安全边界

Pinctrl不是访问控制系统。错误或恶意配置可：

-禁用 console/JTAG策略；
-拉动 reset/power-enable；
-争用总线；
-破坏存储访问；
-造成外部器件异常；
-绕过板级安全假设。

限制 /dev/mem、debugfs和GPIO设备权限；敏感 pins由 kernel driver占用并通过 locked-down DT/boot chain管理。

8. 量产原则

-以原理图和 TRM为准；
-每个 enabled外设明确 default/sleep；
-关键控制线定义安全上电状态；
-不要把开发板 pin group机械复制到不同PCB；
-对高速信号做电气测量；
-保留运行 DTB和 pinctrl dump作为版本证据。