【运维】给飞牛 NAS 装上风扇控制：一次 ITE IT8613E 驱动探索

$ uname -r
6.18.18.c1032-trim

/sys/class/hwmon/hwmon6/name  → k10temp    (Tctl       ≈ 81°C)
/sys/class/hwmon/hwmon5/name  → amdgpu     (edge)
... 还有 5 块 NVMe、spd5118 (DDR5 温度)

sudo modprobe it87 force_id=0x8620

$ ls /usr/src/
it87-1.0.63

sudo dkms build    it87/1.0.63 -k 6.18.18.c1032-trim
sudo dkms install  it87/1.0.63 -k 6.18.18.c1032-trim
# 产物落在
# /lib/modules/6.18.18.c1032-trim/updates/dkms/it87.ko.xz

# 1. force_id 不再需要，删掉模拟配置
sudo rm /etc/modprobe.d/it87.conf

# 2. 保留开机加载（只写模块名，不用参数）
echo 'it87' | sudo tee /etc/modules-load.d/it87.conf

$ cat /sys/class/hwmon/hwmon9/name
it8613

fan2_input  fan3_input  fan4_input

# 例：把 CPU 风扇(pwm2)设为 220/255 ≈ 86%
echo 0 > /sys/class/hwmon/hwmon9/pwm2_enable
echo 220 > /sys/class/hwmon/hwmon9/pwm2
echo 1 > /sys/class/hwmon/hwmon9/pwm2_enable

sudo systemctl restart coolercontrold

CoolerControl: detected device "it8613" with channels [fan2, fan3, fan4, fan5]

sudo dkms autoinstall -k $(uname -r)

#!/bin/sh
# IT8613E 风扇驱动开机自检兜底
# 逻辑：已绑定→静默退出；未绑定→dkms 模块直载→dkms autoinstall 重建→force_id=0x8620 主线兜底。
# 本脚本永远 exit 0，任何失败只记录与提示，绝不影响系统启动。

TAG="fan-recover"
K=$(uname -r)

log() { logger -t "$TAG" "$*"; }

bound() { grep -qs '^it8613$' /sys/class/hwmon/hwmon*/name; }

dkms_ko_present() { ls /lib/modules/$K/updates/dkms/it87.ko* >/dev/null 2>&1; }

# 1) 已绑定，无事可做
if bound; then
    log "IT8613E 已绑定，无需处理"
    exit 0
fi

log "IT8613E 未绑定（内核 $K），开始恢复"

# 2) dkms 模块已在但未加载（典型：新内核装好后 modules-load 先于 dkms 落地）
if dkms_ko_present; then
    log "发现 dkms 模块，尝试直接加载"
    depmod -a "$K" 2>/dev/null
    modprobe it87 2>/dev/null
fi

# 3) 尝试 dkms 自动构建
if ! bound && ! dkms_ko_present; then
    log "尝试 dkms autoinstall -k $K"
    if dkms autoinstall -k "$K" >/dev/null 2>&1 && dkms_ko_present; then
        depmod -a "$K" 2>/dev/null
        modprobe it87 2>/dev/null
    fi
fi

# 4) 成功路径
if bound; then
    log "恢复成功：IT8613E 已绑定"
    systemctl try-restart coolercontrold.service 2>/dev/null
    rm -f /run/it87-fan-alert
    exit 0
fi

# 5) 构建失败兜底：主线驱动 + force_id 模拟模式（基础控制可用）
log "WARN: dkms 构建失败/不可用，回退 force_id=0x8620 模拟模式"
modprobe -r it87 2>/dev/null
if modprobe it87 force_id=0x8620 2>/dev/null; then
    MODE="force_id=0x8620 兜底模式（仅 pwm2/pwm3 可靠可控）"
else
    MODE="完全失败（无风扇控制，BIOS 默认转速）"
fi

# 失败提示：wall 广播 + journal + 状态文件
MSG="[风扇驱动告警] IT8613E 原生驱动构建失败。当前: $MODE。请执行: sudo dkms autoinstall -k $(uname -r)"
echo "$MSG" > /run/it87-fan-alert
logger -t "$TAG" -p user.warning "$MSG"
wall "$MSG" 2>/dev/null

exit 0

[Unit]
Description=IT8613E fan driver auto-recovery (dkms fallback)
After=systemd-modules-load.service
After=local-fs.target

[Service]
Type=oneshot
ExecStart=/usr/local/sbin/it87-fan-recover.sh
RemainAfterExit=yes

[Install]
WantedBy=multi-user.target

sudo rmmod it87            # 模拟升级内核后的未绑定状态
sudo systemctl start it87-fan-recover.service

fan-recover: IT8613E 未绑定（内核 6.18.18.c1032-trim），开始恢复
fan-recover: 发现 dkms 模块，尝试直接加载
fan-recover: 恢复成功：IT8613E 已绑定