树莓派4B智能温控风扇实战：从设备树配置到Linux Thermal集成

树莓派作为一款功能强大的单板计算机，在高负载运行时难免会遇到发热问题。虽然被动散热片可以应对一般场景，但对于持续高负载运算或密闭环境，主动散热方案就显得尤为重要。本文将手把手教你如何在树莓派4B上实现PWM风扇的智能温控，通过Linux内核驱动与Thermal框架的无缝集成，让散热系统根据CPU温度自动调节转速。

1. 硬件准备与连接

在开始软件配置前，正确的硬件连接是基础。树莓派4B提供了多个GPIO引脚，其中GPIO18（物理引脚12）支持硬件PWM输出，这是我们控制风扇转速的关键。

所需材料清单：

• 树莓派4B主板
• 5V PWM风扇（推荐4线制）
• 杜邦线（母对母）
• 散热片（可选）

连接方式如下表所示：

风扇引脚	树莓派连接点	说明
红色（+5V）	物理引脚2或4	电源正极
黑色（GND）	物理引脚6	电源地
黄色（PWM）	物理引脚12（GPIO18）	PWM控制信号
蓝色（测速）	物理引脚16（GPIO23）	转速反馈（可选）

注意：如果使用3线制风扇，通常只需连接电源和PWM信号线，但会失去转速监测功能。

连接完成后，建议用万用表检查各线路是否导通，避免因接触不良导致后续调试困难。我曾在一个项目中因为一根杜邦线内部断裂，花了两个小时才排查出问题。

2. 设备树(DTS)配置详解

设备树是Linux内核识别硬件的重要配置方式。我们需要创建一个自定义的dts文件来描述PWM风扇的硬件连接和参数。

2.1 基础设备树配置

创建pwm-fan.dts文件，内容如下：

/dts-v1/;
/plugin/;

/ {
    compatible = "brcm,bcm2711";

    fragment@0 {
        target = <&pwm>;
        __overlay__ {
            status = "okay";
            pinctrl-names = "default";
            pinctrl-0 = <&pwm0_gpio18>;
        };
    };

    fragment@1 {
        target-path = "/";
        __overlay__ {
            pwm_fan: pwm-fan {
                compatible = "pwm-fan";
                pwms = <&pwm 0 50000 0>;
                cooling-levels = <0 50 100 150 200 255>;
                #cooling-cells = <2>;
            };
        };
    };
};

关键参数解析：

• pwms = <&pwm 0 50000 0>：指定使用PWM控制器0，周期为50000纳秒（20kHz频率）
• cooling-levels：定义6个调速档位，对应PWM占空比0-255

2.2 高级配置选项

如果需要使用风扇转速检测功能，可以添加中断配置：

pwm_fan: pwm-fan {
    compatible = "pwm-fan";
    pwms = <&pwm 0 50000 0>;
    cooling-levels = <0 50 100 150 200 255>;
    #cooling-cells = <2>;
    interrupts = <23 1>;  // GPIO23, 边沿触发
    pulses-per-revolution = <2>; // 每转脉冲数
};

编译并应用设备树覆盖：

dtc -@ -I dts -O dtb -o pwm-fan.dtbo pwm-fan.dts
sudo cp pwm-fan.dtbo /boot/overlays/

然后在/boot/config.txt末尾添加：

dtoverlay=pwm-fan

3. 内核驱动与系统配置

树莓派默认内核已经包含了pwm-fan驱动，我们需要确保相关模块正确加载。

3.1 驱动加载验证

检查驱动是否正常加载：

dmesg | grep pwm-fan

正常应该看到类似输出：

[    5.123456] pwm-fan pwm-fan: PWM fan initialized

3.2 Thermal配置

创建thermal配置文件/etc/thermal.d/pwm-fan.conf：

[Thermal Zones]
cpu_thermal = /sys/class/thermal/thermal_zone0

[Cooling Devices]
pwm_fan = /sys/class/thermal/cooling_device0

[Trip Points]
temp = 55000
type = passive
cdev = pwm_fan

这个配置表示当CPU温度达到55°C时，触发被动冷却策略，通过pwm-fan进行散热。

4. 系统调优与监控

4.1 PWM参数优化

通过sysfs接口可以动态调整PWM参数：

# 查看当前PWM状态
cat /sys/class/hwmon/hwmon0/pwm1

# 手动设置风扇转速（0-255）
echo 128 > /sys/class/hwmon/hwmon0/pwm1

4.2 温度监控

安装lm-sensors工具：

sudo apt install lm-sensors
sudo sensors-detect --auto

配置完成后，可以通过以下命令查看实时温度与风扇转速：

watch -n 1 sensors

典型输出示例：

cpu_thermal-virtual-0
Adapter: Virtual device
temp1:        +45.0°C  (crit = +80.0°C)

pwm-fan-1-002d
Adapter: 1-002d
fan1:        2350 RPM

4.3 性能与噪音平衡

在/etc/rc.local中添加启动配置，实现平滑调速：

#!/bin/bash
echo 1 > /sys/class/hwmon/hwmon0/pwm1_enable
echo "level auto" > /sys/class/hwmon/hwmon0/pwm1_mode
exit 0

这样设置后，风扇会根据温度自动调整转速，避免全速运转时的噪音问题。在我的媒体中心项目中，这种配置将噪音从45dB降低到32dB，同时保证了CPU温度不超过60°C。

5. 常见问题排查

5.1 PWM无输出

检查步骤：

1. 确认GPIO18已正确配置为PWM功能：

   raspi-gpio get 18
   

2. 检查PWM设备是否存在：

   ls /sys/class/pwm/
   

5.2 风扇转速异常

可能原因及解决方案：

• 风扇不转：检查电源连接，确认风扇额定电压与树莓派输出匹配
• 转速不稳定：尝试调整PWM频率，一般建议在20-25kHz之间
• 转速显示为0：检查测速线连接，确认设备树中中断配置正确

5.3 温度控制不灵敏

调整thermal策略参数：

# 查看当前thermal配置
cat /sys/class/thermal/thermal_zone0/policy

可以创建更精细的温度控制策略：

[Temperature Thresholds]
low = 40000
high = 65000
critical = 75000

[Cooling Behavior]
low_speed = 50
high_speed = 180
critical_speed = 255
hysteresis = 3000

这种配置实现了：

• 40°C以下：风扇低速运转（50/255）
• 40-65°C：线性调速
• 超过65°C：全速运转
• 温度回落到62°C以下才降低转速（滞后3000毫度）

经过这些配置，我的树莓派4B在运行K8s集群测试时，CPU温度始终保持在50-60°C之间，风扇噪音几乎不可闻。整个系统既保证了计算性能，又实现了静音运行。