IT87 硬件监控驱动（飞牛 fnOS FPK）
为 飞牛私有云 (fnOS) 提供 ITE IT87xx / IT86xx / IT879x 系列 Super I/O 芯片 的硬件监控（温度、风扇转速、电压）内核模块支持，打包为飞牛应用中心可直接安装的 .fpk。
解决什么问题
飞牛内核升级后，系统自带或旧编译的 it87 内核模块常因版本不匹配而失效，导致 Fan Control Server 等风扇控制 / 温度监控应用读不到传感器数据。本应用通过 DKMS 方式在安装时针对当前内核现场编译 it87 模块，并在内核升级后自动重编、自动加载，彻底解决该问题。
特性
- ✅ 零依赖：打包完整源码，安装时由 DKMS 现场编译，不下载任何外部包；不依赖 Python / Go / Nginx 等运行时。
- ✅ 内核升级自愈：DKMS
AUTOINSTALL=yes，内核更新后自动重新编译加载，无需手动干预。
- ✅ 开机自启：通过
modules-load.d 配置开机自动加载。
- ✅ 无 UI / 纯驱动：后台服务，应用中心显示为「运行中」，传感器数据供其他监控应用读取。
- ✅ 适用所有飞牛 x86 设备：使用 ITE 芯片主板（如 IT8613，
force_id=0x8613）的机器均可安装。
安装
- 在 Releases 下载
it87-kmod_1.0.0_x86.fpk；
- 飞牛 OS → 应用中心 → 手动安装 → 选择该
.fpk；
- 安装完成后应用显示为「运行中」，即可在终端用
sensors 查看风扇 / 温度 / 电压。
安装需要系统已具备当前内核头文件（飞牛默认提供）。
验证
lsmod | grep it87 # 应看到 it87 模块
sensors | grep -iE "it8613|fan|in[0-9]" # 应看到风扇转速与电压
dkms status | grep it87 # 应显示 installed
构建
bash build.sh # 生成 it87-kmod_1.0.0_x86.fpk
目录结构
.
**── manifest # FPK 元信息（应用中心展示）
**── build.sh # 打包容脚本
**── gen_icon.py # 图标生成脚本
**── fnos/
** **── manifest # 应用元数据
** **── config/ # privilege / resource
** **── cmd/ # 生命周期脚本（install / start / stop / status ...）
** **── bin/ # 驱动状态服务
** **── ui/ # 应用图标
** **── wizard/ # 安装向导
** **── app/it87-src/ # it87 驱动源码（DKMS 编译用）
**── it87-kmod_1.0.0_x86.fpk
致谢 / 开源协议
- 原始驱动作者：Christophe Gauthron、Jean Delvare（SUSE）、Guenter R某RK3566k。本模块源自 lm_sensors / Linux hwmon
it87 驱动。
- DKMS 封装维护：Frank Crawford（github.com/frankcrawford/it87），本项目使用的源码即来自此仓库。
- FPK 打包发布：Panda（https://www.aykeji.cn）。
驱动源码基于 GPL-2.0（Linux 内核模块标准协议）。本项目按相同协议开源。
仓库地址
https://github.com/IamAyang233/fnos-it87-kmod
