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）的机器均可安装。

安装

1. 在 Releases 下载 it87-kmod_1.0.0_x86.fpk；
2. 飞牛 OS → 应用中心 → 手动安装 → 选择该 .fpk；
3. 安装完成后应用显示为「运行中」，即可在终端用 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