PVE fan control script
关于被动散热GPU风扇的脚本说明：
这里皮蛋熊针对群友的三个主板做了实验：
- 华擎 Z370M PRO4 -> NCT6683D
- MSI B460M MORTAR WIFI -> NCT6687
- 华硕B660M-PLUS D4 -> NCT6798D
这里不同主板的控制芯片不同，比如华擎的Z370M使用的是nct6683d芯片，也有使用IT87的，以下教程需要根据自己的不同，处理芯片驱动，同时确保内核开启了如下选项：
CONFIG_THERMAL=y
CONFIG_THERMAL_HWMON=y这里以MSI B460M MORTAR WIFI + PVE为例，进行说明。
我发现PVE的内核驱动目录中存在NCT的驱动：
/lib/modules/5.15.102-1-pve/kernel/drivers/hwmon/nct6683.ko可以强制插入内核中：
insmod /lib/modules/5.15.102-1-pve/kernel/drivers/hwmon/nct6683.ko force=1但会遇到pwm通道不可写的问题：
$ echo 1 > /sys/class/hwmon/hwmon2/pwm1
hwmon2/pwm1: Permission denied如果强制给写权限，也会出现IO错误导致无法写入。
注意： 这是因为nct6683的驱动并不兼容nct6687导致的。
我们需要重新编译一份nct6687的驱动，可以参考这个大佬的仓库 NCT6687D
编译好了过后，我们会得到nct6687.ko，此时将其插入到内核中，可正常驱动内核：
# 先 cd 到 nct6687.ko 所在目录
insmod nct6687.ko此时在/sys/class/hwmon/hwmonX中可以找到相关的控制文件
root@pve:/sys/class/hwmon/hwmon4# ls -al
total 0
drwxr-xr-x 3 root root 0 Nov 7 20:41 .
drwxr-xr-x 3 root root 0 Nov 7 20:41 ..
lrwxrwxrwx 1 root root 0 Nov 7 20:41 device -> ../../../nct6687.2592
-r--r--r-- 1 root root 4096 Nov 7 20:41 fan1_input
-r--r--r-- 1 root root 4096 Nov 7 20:41 fan1_label
-r--r--r-- 1 root root 4096 Nov 7 20:41 fan1_max
-r--r--r-- 1 root root 4096 Nov 7 20:41 fan1_min
***
-r--r--r-- 1 root root 4096 Nov 7 20:41 name
drwxr-xr-x 2 root root 0 Nov 11 20:23 power
-rw-r--r-- 1 root root 4096 Nov 11 20:23 pwm1
-rw-r--r-- 1 root root 4096 Nov 11 20:23 pwm2
-rw-r--r-- 1 root root 4096 Nov 11 20:23 pwm3
-rw-r--r-- 1 root root 4096 Nov 12 11:11 pwm4
***如果你不知道你的hwmon是哪一个，可以挨个目录切换进去 ，然后cat name，看看是否是你的输出，比如我这里输出：
root@pve:/sys/class/hwmon# cat ./hwmon1/name
nvme
root@pve:/sys/class/hwmon# cat ./hwmon2/name
coretemp
root@pve:/sys/class/hwmon# cat ./hwmon3/name
iwlwifi_1
root@pve:/sys/class/hwmon# cat ./hwmon4/name
nct6687可以看到这里是hwmon4是我们的nct6687的sys file目录。
注意：这里的hwmon4并不是固定的，是由hwmon驱动的加载顺序决定的。
比如我这里是hwmon4，如果设置了开机自动加载驱动，那有可能就变为hwmon2了。
此时，我们可以准备一个主板的4pin风扇，开始准备寻找通道了。
root@pve:/sys/class/hwmon/hwmon4# cat fan1_label
CPU Fan
root@pve:/sys/class/hwmon/hwmon4# cat fan2_label
Pump Fan
root@pve:/sys/class/hwmon/hwmon4# cat fan3_label
System Fan #1
root@pve:/sys/class/hwmon/hwmon4# cat fan4_label
System Fan #2
root@pve:/sys/class/hwmon/hwmon4# cat fan5_label
System Fan #3
root@pve:/sys/class/hwmon/hwmon4# cat fan6_label
System Fan #4可以看到fan1是CPU风扇，fan2是水冷风扇，fan3~fan8是机箱风扇。
注意：并不是所有主板都把这些通道引出了，比如大部分的可能只引出了两个机箱风扇，不过这也够我们用了。
这时候我们可以去观察下主板的标注：
![[Pasted image 20231112113657.png]]
红框处从左往右分别标注了CHA_FAN1,CHA_FAN2,CHA_FAN3，不同主板标注不一样，有的标注是sys_fan1,sys_fan2,sys_fan3等。
这里我们准备一个4Pin风扇，这里我以我买的的7530 pwm风扇为例:
![[Pasted image 20231112125615.png]]
![[Pasted image 20231112125621.png]]
将接线端插入主板的cha_fan中方便的那个，这里以cha_fan2 为例，
根据上面我们查询的知识知道fan4_label输出为System Fan #2，即是对应的cha_fan2。
如果你和我一样，是四线的风扇，正常的线序应该是GND,VCC,PWM,INPUT，最后一个INPUT是采集风扇转速的，你可以通过下面命令查看风扇转速：
# 具体的hwmon号，需要根据具体情况判断
cd /sys/class/hwmon/hwmon4
cat fan1_input
cat fan2_input # 这里可以取值根据你的驱动决定，这里我的是 fan1 ~ fan8有了上面的输出，我们可以判断在哪些通道上采集到了转速信号，便于确定我们的风扇接到了哪个通道上。为了进一步确定我们的通道选择是否正确，此时我们可以操作下面命令：
# 具体的hwmon号，需要根据具体情况判断
cd /sys/class/hwmon/hwmon4
# 判断风扇是否停转
echo 0 > pwm4
# 判断风扇是否满速运转
echo 255 > pwm4如果上面指令起到效果了（观察风扇转速），那证明我们的控制链路已经通了，我们已经明确知道pwm4和fan4对应到我们插入的主板cha_fan2了。
注意：不同的主板接线方式不同，比如华擎Z370M PRO4这个主板就接反了线，结果发现其fan4、PWM3是一组的，如果你没找到输出，建议从pwm1 ~ pwm8（不同控制芯片的通道数不同）挨个执行上面指令，判断是否起了效果。
现在假设你已经确定了你主板上的cha_fan2可以被hwmon4的fan4、pwm4所控制了，那么我们就可以固化一下我们的设置了。
我们先将内核驱动设置为开机自启动：
cp nct6687.ko /lib/modules/$(uname -r)/
depmod -a
# vim /etc/modules 添加下面模块
nct6687
# 更新 initramfs
update-initramfs -u -k all
# 重启电脑
reboot此时我们重启一下电脑，重新检查一下/sys/class/hwmon目录下是哪个hwmonx，这里重新启动后，驱动正常加载，hwmon号变为了2，也即是现在变为了/sys/class/hwmon/hwmon2是控制风扇转了。
知道这些信息后，我们还可以进一步针对不同的风扇，测量其启动转速，这个根据风扇的不同略有不同。
自此，调速的前置条件我们都满足了，接下来就可以写一个简单的调速脚本来做这个事了，为了方便各位，皮蛋熊在这里已经写好了，开源并打包为了一个DEB包。 gpufan-ctrl 安装：
dpkg -i gpufan_ctrl-amd64.deb修改配置文件：
# vim /etc/gpufan-ctrl/config.json
{
"interval" : "1", # 调控间隔
"hwmon" : "4", # hwmon号，根据上面的教程查询
"pwm_chan" : "4", # 控制风扇通道
"fan_chan" : "4", # 读取风扇转速通道，某些主板这里可能不是和pwm通道对应
"fan_min" : "25", # 开始风扇控制时候pwm占空比
"fan_max" : "70", # pwm占空比最高值
"tmp_start" : "45", # gpu温度超过这个值过后开始调控转速
"tmp_ratio" : "2", # 每升高1° pwm占比空升高比例
"tmp_high" : "82" # gpu温度超过这个值将全速运转
}配置文件修改完成后，可以试试输入:
gpufan-ctrl等待输出：
root@pve:~# gpufan-ctrl
| GPU Temp | Fan Speed | Fan RPM |
| 49° | 33% | 2758 |
| 49° | 33% | 2727 |
| 49° | 33% | 2603 |
| 49° | 33% | 2603 |
| 48° | 31% | 2614 |
| 48° | 31% | 2521 |
| 48° | 31% | 2448 |
| 47° | 29% | 2448 |
| 47° | 29% | 2343 |
| 47° | 29% | 2316 |
| 47° | 29% | 2298 |
| 46° | 27% | 2294 |
| 46° | 27% | 2307 |
| 46° | 27% | 2162 |可以看到随着GPU温度降低，风扇转速逐步降低。 此时我们输入以下指令，即可实现开机自动启动调速：
systemctl start gpufan-ctrl.service折腾之路并不会一帆风顺，或许你会遇到这样那样的问题，也或许你有更完美的方案，Q群：573116017 欢迎你到来一起探讨。