RK3528 OpenWrt DTS如何配置GPIO引脚？

Question

在基于RK3528的OpenWrt系统中，如何通过DTS（Device Tree Source）正确配置GPIO引脚为输入或输出模式，并确保其在系统启动时被正确初始化？常见问题包括：GPIO编号如何映射到DTS中的pinmux定义、如何设置pull-up/pull-down电阻、如何避免与其他外设引脚冲突，以及如何在驱动或用户空间通过sysfs访问该GPIO。特别是在rk3528.dtsi与板级DTS文件之间，如何正确覆写pin control节点以实现自定义GPIO功能，是开发过程中常遇到的技术难点。

Answer 1

基于RK3528的OpenWrt系统中DTS配置GPIO详解

1. GPIO基础概念与RK3528架构概述

Rockchip RK3528是一款面向边缘计算和网关设备的SoC，集成四核Cortex-A53处理器，支持丰富的外设接口。其GPIO功能由多个GPIO控制器（如gpio0~gpio4）管理，每个控制器负责一组物理引脚。在OpenWrt系统中，设备树（Device Tree）是描述硬件资源的核心机制，通过.dts和.dtsi文件定义引脚复用（pinmux）、电气属性及初始化状态。

RK3528的GPIO编号遵循标准Linux GPIO子系统规则：全局编号 = 控制器基号 + 引脚偏移。例如，GPIO4_C7 的基号为 4×32 = 128，C组第7位对应偏移7，故其全局编号为 135。

2. DTS中的Pinmux映射机制

在RK3528中，引脚复用由pinctrl子系统控制，需在板级DTS文件中覆写rk3528.dtsi中定义的节点。以下为常见pinmux命名格式：

• gpioX_YZ：表示GPIO模式，X为控制器编号，Y为组名（A/B/C/D），Z为组内序号
• funcX：表示复用功能，如I2C、SPI等

示例：将PIN12配置为GPIO输出：

/ {
    pinctrl: pinctrl {
        led_pins: led-pins {
            rockchip,pins =
                /* PIN12 -> GPIO4_C1 */
                ;
        };
    };
};

3. GPIO方向与上下拉配置方法

通过pinctrl-include头文件定义的标准宏可设置电气特性：

参数	说明
&pinctrl_gpio_input	输入模式，高阻态
&pinctrl_gpio_output	输出模式，默认低电平
&pinctrl_pull_up	启用上拉电阻
&pinctrl_pull_down	启用下拉电阻
&pinctrl_no_pull	禁止上下拉

组合使用示例如下：

button_pins: button-pins {
    rockchip,pins =
        ;
};

4. 覆写rk3528.dtsi中的Pinctrl节点

开发过程中常需在板级DTS中覆写SoC级定义。采用标签引用+局部更新策略：

&uart2 {
    status = "disabled";
};

&pinctrl {
    custom_gpio: custom-gpio {
        rockchip,pins =
            <RK3528_PIN_GPIO2_B3 &pinctrl_gpio_output &pinctrl_no_pull>;
    };
};

确保在设备节点中正确引用：

led_device {
    compatible = "gpio-leds";
    pinctrl-names = "default";
    pinctrl-0 = <&custom_gpio>;
    led@0 {
        label = "status_led";
        gpios = <&gpio4 1 GPIO_ACTIVE_HIGH>;
        default-state = "off";
    };
};

5. 避免引脚冲突的分析流程

多外设共享引脚时易发生冲突，建议按以下流程排查：

1. 查阅《RK3528 TRM》确定目标引脚的复用选项
2. 搜索rk3528.dtsi中该引脚是否已被UART/I2C等占用
3. 检查对应外设的status属性是否为"okay"
4. 若存在冲突，disable原外设或选择替代引脚
5. 使用dtc工具反编译生成的dtb验证最终配置
6. 通过debugfs查看实际pinmux状态：cat /sys/kernel/debug/pinctrl/*/pins | grep gpio

6. 用户空间通过sysfs访问GPIO

系统启动后可通过/sys/class/gpio接口操作：

# 导出GPIO135
echo 135 > /sys/class/gpio/export

# 设置方向
echo out > /sys/class/gpio/gpio135/direction

# 写入电平
echo 1 > /sys/class/gpio/gpio135/value

# 读取输入值
cat /sys/class/gpio/gpio135/value

注意：需确保udev规则允许非root访问，或在应用中以特权运行。

7. 驱动层GPIO使用最佳实践

内核模块应使用gpiod_* API而非旧式gpio_*：

struct gpio_desc *desc;

desc = devm_gpiod_get(&pdev->dev, "enable", GPIOD_OUT_LOW);
if (IS_ERR(desc))
    return PTR_ERR(desc);

gpiod_set_value(desc, 1);

DT中绑定方式：

your_device {
    your_gpio = <&gpio4 1 GPIO_ACTIVE_HIGH>;
};

8. 常见问题诊断流程图

graph TD
            A[GPIO未正常工作] --> B{检查DTS配置}
            B -->|否| C[修正pinmux定义]
            B -->|是| D{查看/sys/class/gpio}
            D -->|不存在| E[确认gpios属性存在]
            D -->|存在| F{电平异常?}
            F -->|是| G[检查pull-up/down配置]
            F -->|否| H[验证物理连接]
            C --> I[重新编译并刷写dtb]
            E --> I
            G --> I
            H --> J[使用万用表测量]

9. 编译与调试技巧

OpenWrt环境下关键步骤：

• 修改target/linux/rockchip/files-5.10/arch/arm64/boot/dts/rockchip/rk3528-*.dts
• 执行make target/compile单独编译内核
• 提取Image和.dtb文件烧录
• 通过串口日志观察pinctrl驱动加载情况
• 利用of_node_put()调试路径定位设备树节点解析错误

10. 安全性与稳定性考量

生产环境需注意：

风险点	应对措施
误配置为输出导致短路	审查所有GPIO默认状态
上下拉缺失引起漂浮电平	明确指定pull行为
与其他外设时序冲突	延迟初始化关键GPIO
DTS版本管理混乱	建立板级DTS独立分支