Linux PWM风扇驱动：从设备树到Thermal集成的实战解析

1. 嵌入式Linux风扇控制基础

在嵌入式设备开发中，温度管理是个永恒的话题。想象一下你的开发板在炎炎夏日里持续工作，如果没有良好的散热系统，CPU可能会像煎锅上的鸡蛋一样"滋滋作响"。这就是为什么我们需要PWM风扇驱动——它就像给设备装上了智能空调，可以根据温度自动调节风速。

PWM（脉冲宽度调制）控制是风扇调速的黄金标准。不同于简单的开/关控制，PWM通过快速切换电源通断来精确控制转速。占空比（duty cycle）决定了风扇的"油门"大小——0%表示完全停止，100%则是全速运转。在Linux内核中，这套机制通过三个关键部分实现：

1. 硬件抽象层：设备树描述硬件连接
2. 驱动核心：处理PWM信号生成和转速计算
3. 温控集成：与Thermal子系统联动

我曾在RK3399开发板上调试风扇时，遇到过转速不稳定的问题。后来发现是设备树中PWM频率设置不当，导致风扇电机出现谐振。这个经历让我深刻理解到：一个稳健的风扇驱动需要硬件描述、驱动实现和系统集成三者的完美配合。

2. 设备树配置详解

设备树就像写给内核的"硬件说明书"，对于PWM风扇来说，这份说明书需要明确几个关键信息。先看一个典型的配置示例：

pwm-fan { compatible = "pwm-fan"; pwms = <&pwm0 0 40000>; // 使用PWM0，周期40kHz cooling-levels = <0 85 170 255>; // 四级调速 pulses-per-revolution = <2>; // 每转2个脉冲 interrupt-parent = <&gpio0>; interrupts = <5 IRQ_TYPE_EDGE_RISING>; // 转速反馈引脚 };

兼容性字段是驱动匹配的身份证，必须为"pwm-fan"。pwms参数尤其重要，第三个数字表示PWM周期（单位纳秒），40000对应的是25kHz频率——这是大多数4线PWM风扇的最佳工作频率。我曾见过有人设为1000000（1kHz），结果风扇发出刺耳的噪音。

cooling-levels定义了温度调控的"档位"，每个数字代表该档位的PWM占空比。例如<0 85 170 255>表示：

• 档位0：停转（0%）
• 档位1：约33%转速（85/255）
• 档位2：约67%转速（170/255）
• 档位3：全速（100%）

对于带转速反馈的风扇，pulses-per-revolution和中断配置必不可少。这个值表示风扇每转产生的脉冲数，通常2或4。错误设置会导致转速计算完全失准——我有次将其误设为1，系统显示的转速只有实际值的一半。

3. 驱动核心实现剖析

驱动代码就像风扇的"大脑"，主要处理三件事：初始化硬件、计算转速、响应温控指令。让我们深入probe函数的几个关键点：

static int pwm_fan_probe(struct platform_device *pdev) { struct pwm_fan_ctx *ctx; ctx = devm_kzalloc(dev, sizeof(*ctx), GFP_KERNEL); mutex_init(&ctx->lock); /* PWM配置 */ ctx->pwm = devm_of_pwm_get(dev, dev->of_node, NULL); pwm_init_state(ctx->pwm, &state); state.duty_cycle = ctx->pwm->args.period - 1; pwm_apply_state(ctx->pwm, &state); /* 转速测量 */ if (ctx->irq > 0) { devm_request_irq(dev, ctx->irq, pulse_handler, 0, pdev->name, ctx); timer_setup(&ctx->rpm_timer, sample_timer, 0); } /* 温控注册 */ cdev = devm_thermal_of_cooling_device_register(dev, dev->of_node, "pwm-fan", ctx, &pwm_fan_cooling_ops); }

内存管理使用devm_系列函数，确保驱动卸载时自动释放资源。我曾忘记使用devm_版本，导致模块卸载后内存泄漏，系统运行几天后就会OOM崩溃。

PWM初始化有个精妙之处：初始状态设置为最大占空比（period-1）。这是因为多数风扇需要全速启动才能克服静摩擦力，启动后再调速更为可靠。实践中发现，某些廉价风扇在低占空比下根本无法启动，这个设计正好规避了这个问题。

转速测量采用"中断+定时器"组合拳：

• 每个转速脉冲触发中断，计数器递增
• 定时器每秒统计脉冲数，计算RPM（转/分钟）

计算公式为：RPM = (脉冲数 × 60) / (每转脉冲数 × 定时秒数)

4. Thermal集成实战

让风扇根据温度自动调速才是终极目标。Linux Thermal子系统提供了标准化的温控框架，我们需要实现三个核心回调：

static const struct thermal_cooling_device_ops pwm_fan_cooling_ops = { .get_max_state = pwm_fan_get_max_state, .get_cur_state = pwm_fan_get_cur_state, .set_cur_state = pwm_fan_set_cur_state, };

状态转换是这里的重点。当Thermal核心调用set_cur_state时，驱动需要：

1. 检查请求的档位是否有效
2. 从cooling-levels获取对应占空比
3. 应用新的PWM设置

static int pwm_fan_set_cur_state(struct thermal_cooling_device *cdev, unsigned long state) { if (state > ctx->pwm_fan_max_state) return -EINVAL; mutex_lock(&ctx->lock); pwm_set_relative_duty_cycle(&state, ctx->cooling_levels[state], MAX_PWM); pwm_apply_state(ctx->pwm, &state); mutex_unlock(&ctx->lock); }

在实际项目中，我遇到过温控响应迟缓的问题。后来发现是因为Thermal governor的轮询间隔太长（默认5秒）。通过修改为1秒间隔并添加温度突变时的即时触发，系统响应速度显著提升。

调试时可以监控/sys/class/thermal/cooling_deviceX/目录：

• cur_state：当前档位
• max_state：最大档位
• type：应显示"pwm-fan"

5. 常见问题排查指南

调试PWM风扇就像医生问诊，需要系统性地检查每个环节。以下是几个"临床案例"：

案例1：风扇不转

• 检查电源：万用表测量风扇接口电压
• 验证PWM输出：示波器查看波形
• 确认设备树：pwm引脚配置是否正确
• 查看驱动日志：dmesg | grep pwm_fan

案例2：转速显示异常

• 检查pulses-per-revolution参数
• 用示波器验证转速脉冲信号
• 测试中断是否正常触发：cat /proc/interrupts

案例3：温控不生效

• 确认CONFIG_THERMAL配置已启用
• 检查thermal-zone设备树绑定
• 测试手动设置档位：echo 1 > /sys/class/thermal/cooling_device0/cur_state

有个特别隐蔽的bug我花了三天才解决：风扇偶尔会突然停转。最终发现是电源管理在空闲时关闭了PWM控制器。解决方法是在设备树添加：

&pwm0 { status = "okay"; pinctrl-names = "default"; pinctrl-0 = <&pwm0_pins>; /delete-property/ power-domains; // 禁止电源管理 };

6. 性能优化技巧

要让风扇控制既高效又安静，需要些"黑科技"。这里分享几个实战技巧：

动态调频：根据温度变化率预测趋势，提前调整转速。例如当温度快速上升时，可以提前升档，避免等到过热才全速运转。实现方法是在驱动中添加预测算法：

static int predict_next_state(int current_temp, int last_temp) { int delta = current_temp - last_temp; if (delta > 5) return current_state + 2; // 快速升温，跳档 if (delta < -3) return current_state - 1; // 降温，提前降档 return current_state + 1; }

转速平滑：突然的转速变化会产生噪音。可以通过逐步过渡实现软调速：

void gradual_adjust(struct pwm_fan_ctx *ctx, int target_duty) { int step = (target_duty - current_duty) / 10; for (int i = 0; i < 10; i++) { current_duty += step; pwm_set_duty_cycle(current_duty); msleep(100); } }

智能启停：低温时完全停转，避免不必要的噪音和磨损。但要注意设置合理的启停阈值，避免频繁启停。我的经验是：

• 停转阈值：低于50°C
• 启动阈值：高于55°C
• 最小运行时间：至少30秒

在RK3588平台上，经过这些优化后，风扇噪音降低了60%，而最高温度仅上升了3°C。系统安静得让我一度以为风扇坏了，直到看见温度曲线才确认优化生效。