OpenWRT中RK3568平台PWM风扇驱动异常问题分析与解决

问题背景

在OpenWRT项目中，基于Rockchip RK3568平台的H69K开发板遇到了PWM风扇控制异常的问题。具体表现为风扇持续高速运转，无法通过系统接口进行调速控制。通过内核日志分析发现，系统未能正确加载PWM风扇驱动模块。

技术分析

PWM风扇驱动机制

PWM(脉宽调制)风扇控制是现代计算机系统中常见的散热解决方案。在Linux系统中，PWM风扇驱动通常涉及以下几个关键组件：

1. PWM控制器驱动：负责底层PWM信号的生成
2. PWM风扇驱动：将PWM信号与风扇设备关联
3. 温控子系统：根据温度传感器数据动态调整PWM占空比

RK3568平台的PWM实现

Rockchip RK3568芯片内置了多个PWM控制器，在设备树中通常定义为：

pwm0: pwm@fdd70000 {
    compatible = "rockchip,rk3568-pwm";
    reg = <0x0 0xfdd70000 0x0 0x10>;
    clocks = <&cru CLK_PWM0>;
    clock-names = "pwm";
    pinctrl-names = "default";
    pinctrl-0 = <&pwm0_pins>;
    #pwm-cells = <3>;
    status = "disabled";
};

问题根源

经过深入分析，发现问题源于设备树(DTS)文件的组织方式。原始实现将PWM风扇的定义放在了父级DTSI文件中，这导致了：

1. 驱动加载时机不正确
2. 设备树节点初始化顺序问题
3. 硬件资源分配冲突

解决方案

设备树结构调整

正确的做法是将PWM风扇的定义移至具体的板级DTS文件中：

&pwm0 {
    status = "okay";
    pinctrl-names = "default";
    pinctrl-0 = <&pwm0m0_pins>;
};

pwm-fan {
    compatible = "pwm-fan";
    pwms = <&pwm0 0 40000 0>;
    cooling-levels = <0 50 100 150 192 255>;
};

内核配置要求

同时需要确保内核配置中包含以下选项：

CONFIG_SENSORS_PWM_FAN=y
CONFIG_PWM=y
CONFIG_PWM_ROCKCHIP=y

验证方法

问题解决后，可以通过以下方式验证PWM风扇驱动是否正常工作：

1. 检查内核日志中PWM驱动加载情况
2. 查看/sys/class/thermal/cooling_device0/目录下的控制文件
3. 直接修改cur_state值观察风扇转速变化

经验总结

在嵌入式Linux开发中，设备树的组织方式对驱动加载有重要影响。对于外设驱动，特别是与硬件紧密相关的PWM设备，应当注意：

1. 设备树节点的放置位置
2. 驱动加载的依赖关系
3. 硬件资源的正确分配

通过这次问题的解决，我们更加理解了OpenWRT系统中设备树与驱动加载的关联机制，为后续类似问题的排查提供了宝贵经验。

扩展知识

对于嵌入式开发者，理解PWM风扇的工作原理有助于更好地进行系统设计：

1. PWM频率选择：通常选择20-25kHz以避免可听噪声
2. 占空比与转速关系：非线性，需通过实验校准
3. 温控策略：可采用PID算法实现平滑调速

这些知识在实际项目开发中都具有重要参考价值。