威联通NAS刷入飞牛后一键编译ITE8528控制器驱动并安装

权威x

权威x 发表于 2025-11-26 22:17
配合这个帖子，完美解决
https://club.fnnas.com/forum.php?mod=viewthread&tid=39606&highlight=
...

型号是TS451D

sdupjj

我刚在453bmini上面 尝试手动安装驱动。。好几个失败。。。。过来看看

_Ke0JY

这个驱动和飞牛商店的 ite-it87驱动程序有啥区别

shawn623

把依赖的包都装上就好了 要不老是提示

未检测到 qnap8528 传感器数据（可能驱动未正确加载）

财色兼收

财色兼收 发表于 2025-5-29 23:42
折腾了一下，小白没搞定！烧开水喝

根据大佬的教程，终于搞定了

qq454501511

vip_FZ3I1 发表于 2025-8-9 18:17
我也遇到这个问题，这个错误表明 Docker 在尝试拉取 debian:bookworm 镜像时遇到了 401 Unauthorized 认证 ...

👍感谢

_Ke0JY

昨天我更新了最新的v1.1.11系统，用手机软件点的更新，看到更新提示说有内核更新，更完之后比较晚，用软件看了下CPU温度还能接受就去睡觉了，今天想起来打开电脑看看状态，发现 coolcontrol无法控制风扇了，但是能看到风扇转速，然后查看内核版本是6.12.18-trim，/lib/modules/6.12.18-trim/extra路径下还有qnap8528.ko驱动，然后

mzydj@PingAn:/lib/modules/6.12.18-trim/extra$ lsmod | grep qnap8528
qnap8528 77824 0
mzydj@PingAn:/lib/modules/6.12.18-trim/extra$ systemctl status qnap8528-load-module.service
Unit qnap8528-load-module.service could not be found.

驱动状态是正常的，但是服务没有启动。

mzydj@PingAn:/lib/modules/6.12.18-trim/extra$ sensors
qnap8528-isa-0000
Adapter: ISA adapter
fan1: 733 RPM
temp1: +31.0°C
temp6: +29.0°C

acpitz-acpi-0
Adapter: ACPI interface
temp1: +38.0°C

coretemp-isa-0000
Adapter: ISA adapter
Package id 0: +38.0°C (high = +105.0°C, crit = +105.0°C)
Core 0: +36.0°C (high = +105.0°C, crit = +105.0°C)
Core 1: +36.0°C (high = +105.0°C, crit = +105.0°C)

现在我不知道我需要怎么做了，是删除掉 coolcontrol继续正常用吗还是要重新配置服务。

javen0223

mark,手头的威联通T451D试试去

云舟

感谢

EthanUnique.Wu

我的方法很简单，让AI处理就行了：

当然！这个 fnOS 风扇温控的实现从底层到上层分以下几个层次：

---

🧱 完整架构一览

**─────────────────────────────────────**
**  Docker: fnos-fan-webui (端口 8080)  ** ← Web UI 面板
**      Python http.server              **
**─────────────────────────────────────**
**  sysfs 接口                          ** ← 内核暴露的硬件接口
**  /sys/class/hwmon/hwmon3/           **
**─────────────────────────────────────**
**  内核模块 qnap8528.ko                ** ← 底层驱动
**  (控制 ITE8528E EC 芯片)            **
**─────────────────────────────────────**
**  硬件: iEi SA145 (QNAP QU-605)      **
**  ITE8528E EC @ ports 0x6c/0x68      **
**  2x 9cm 风扇                         **
**─────────────────────────────────────**

---

1️⃣ 底层：内核模块 qnap8528.ko

因为直接通过 /dev/port 写 EC 寄存器只能微调 ~300 RPM，效果很差。所以编译了一个内核模块 qnap8528.ko，它通过 ITE8528E EC 芯片暴露标准的 hwmon sysfs
接口，让上层可以像控制普通风扇一样读写：

sysfs 路径	作用
/sys/class/hwmon/hwmon3/pwm1	PWM 值 (0~255)
/sys/class/hwmon/hwmon3/fan1_input	风扇原始计数值
/sys/class/thermal/thermal_zone0/temp	CPU 温度/1000

RPM 换算公式： RPM = 3932160 / fan1_input

源码在 /root/qnap8528/，系统升级内核后需要重新编译。

---

2️⃣ 中间层：Docker 容器 fnos-fan-webui

关键启动参数（踩过坑的教训 ⚠️）：

docker run -d --name=fnos-fan-webui --restart=unless-stopped \
  --privileged \
  -v /sys/class/hwmon:/sys/class/hwmon:rw \
  -v /sys/class/thermal:/sys/class/thermal:ro \
  -v /root/fnan-webui/data:/data \
  -p 8080:8080 fnos-fan-webui

⚠️ 关键坑： 一开始没加 --privileged 而且 sysfs 挂载为 :ro，导致所有 PWM 写入静默失败，还以为在正常工作。最终方案是 --privileged + :rw
才能正常写入硬件。

---

3️⃣ 上层：Python Web UI

代码在 /root/fnan-webui/fan_webui.py，提供：

• 实时监控： CPU 温度、PWM、RPM
• 温控曲线： 拖拽式温度-PWM 曲线，持久化到 /data/curve-config.json
• 手动模式： 滑条调 PWM → 点 「✅ 确认应用」 按钮才生效（防止误操作）
• 自动/手动切换

API：

端点	功能
GET /api/status	温度/PWM/RPM/模式/曲线
POST /api/set-pwm-pending	暂存手动 PWM
POST /api/apply	确认应用到硬件
POST /api/curve	更新温控曲线

---

4️⃣ Web UI 界面效果