绿联 LED 灯控 v1.5.0：应用介绍与更新说明
适用于飞牛 fnOS 的绿联 NAS 机箱 LED 控制应用，支持硬盘灯、网络灯和电源灯的状态显示、颜色配置与活动闪动。
一段话介绍
绿联 LED 灯控是一款面向飞牛 fnOS 的原生应用，用于接管绿联 DXP4800 Plus、DX4600 等系列机箱的 LED 灯光。应用提供关闭全部、开启全部和智能模式，可根据硬盘活动、休眠、离线状态以及网络连接状态自动切换颜色，并支持磁盘读写和网络流量速度闪动。最新的 v1.5.0 还加入了实验室硬盘位置自定义绑定、应用内更新检查和 GitHub 自动发布能力。
v1.5.0 更新亮点
1. 新增实验室硬盘位置自定义绑定
部分 6 盘位、8 盘位机型的物理硬盘灯顺序可能与系统 HCTL 探测顺序不一致。v1.5.0 新增“实验室功能”，可以通过实际闪灯确认物理盘位，再将硬盘绑定到正确的 LED。
操作流程：
- 点亮全部硬盘灯，确认硬件灯位可正常控制。
- 选择一个物理盘位，让对应 LED 单独闪烁。
- 根据硬盘型号、容量、序列号和 HCTL 选择对应硬盘。
- 完成盘位绑定后保存，自定义映射立即生效。
自定义规则使用稳定的 HCTL 保存，不依赖可能在重启或热插拔后变化的 /dev/sdX 名称。页面会拦截重复绑定、无效盘位和已经变化的硬盘信息，也可以随时恢复自动映射。
实验室功能尚未在全部机型上完成验证。检测期间会临时接管硬盘灯；保存、取消或会话超时后，应用会恢复正常后台灯效。网络灯和电源灯不会参与盘位绑定。
2. 盘位映射扩展到 disk1–disk8
自动 HCTL 映射能力由原来的 4 个盘位扩展到最多 8 个盘位，并继续支持：
- 应用启动时自动探测硬盘。
- 硬盘热插拔后重新检测映射。
- 硬盘拔出后自动关闭对应盘位灯。
- 自动映射与自定义映射之间自由切换。
3. 修复速度闪动被常亮命令覆盖
修复磁盘读写和网络速度闪动可能被后续常亮命令覆盖的问题。启用活动提示后，LED 会根据实际速度稳定使用低、中、高三档闪动频率。
4. 新增应用内更新检查
“设备与高级”页面新增应用更新区域：
- 打开管理页面时自动检查 GitHub 最新 Release。
- 支持手动点击“检查更新”。
- 显示当前版本和公开版本。
- 可查看 Release 更新说明。
- 发现新版本后可直接下载 FPK 安装包。
- 网络不可用时不会影响灯控服务运行。
为了避免依赖 fnOS 未公开的内部安装接口，应用不会静默安装更新。下载新版 FPK 后，仍需在 fnOS 应用中心手动确认升级。
5. 自动构建与发布 Release
项目现在具备完整的自动发布流程：
- 推送版本标签后，GitHub Actions 自动构建 FPK。
- 自动校验标签与
manifest 版本是否一致。
- 自动生成 GitHub Release。
- 同时上传版本安装包、固定名称安装包和 SHA256 校验文件。
- 构建过程不需要连接 NAS，也不需要在 GitHub 保存 NAS 密码。
FPK 构建器会生成内部 app.tgz，写入对应 MD5 校验值，并在完成后重新解包检查安装包结构。
应用主要功能
三种灯光模式
| 模式 |
行为 |
| 关闭全部 |
关闭电源灯、网络灯和全部硬盘灯 |
| 开启全部 |
所有可用 LED 保持常亮 |
| 智能模式 |
根据硬盘、网络和系统状态自动控制颜色与灯效 |
硬盘状态灯
每种硬盘状态都可以配置独立颜色和亮度：
- 活动：硬盘正在工作或发生读写。
- 空闲：硬盘在线，但当前没有明显活动。
- 休眠：硬盘进入待机状态。
- 深度睡眠：硬盘进入更低功耗状态。
- 离线或拔出：自动关闭对应盘位灯。
应用从 /proc/diskstats 获取磁盘活动信息，并通过 hdparm -C 按设定周期查询硬盘电源状态。
磁盘读写闪动
可以独立启用磁盘活动闪动，并设置触发阈值，单位为 KB/s。读写速度超过阈值后，LED 会根据速度自动选择不同闪动频率：
- 刚刚超过阈值：低速闪动。
- 达到阈值约 4 倍：中速闪动。
- 达到阈值约 16 倍：高速闪动。
网络状态灯
网络灯支持三种状态：
- 外网：海外检测点可达。
- 联网：国内检测点可达，但海外检测点不可达。
- 断网：网络检测点均不可达。
三种网络状态可以分别配置颜色和亮度。
网络速度闪动
网络上传和下载总速度超过设定阈值后，网络灯可以按实时速度闪动。磁盘闪动和网络闪动互相独立，可以分别开启或关闭。
电源灯配置
电源灯支持独立设置：
配色预设
Web 管理页面提供多套内置配色方案：
套用预设后仍然可以继续调整每一种状态的颜色和亮度。
低唤醒监测设置
为了在状态更新速度和硬盘低功耗之间取得平衡，可以分别配置：
- 硬盘电源状态查询间隔，默认 60 秒。
- 热插拔扫描间隔，默认 30 秒。
适当增加查询间隔，可以减少后台对硬盘和控制器的访问频率。
后台服务与诊断
管理页面支持：
- 启动或停止 LED 守护进程。
- 查看实时网络上传、下载速度。
- 查看硬盘读写速度和当前状态。
- 查看硬盘与 LED 盘位映射。
- 重新执行自动 HCTL 映射。
- 查看 LED 原始诊断状态。
安装与升级
新安装
- 前往 v1.5.0 Release。
- 下载
App.Native.UGreenLED-1.5.0.fpk 或 App.Native.UGreenLED.fpk。
- 打开 fnOS 应用中心。
- 选择“手动安装”，上传下载的 FPK 文件。
- 完成安装后，从 fnOS 桌面打开“绿联 LED 灯控”。
从旧版本升级
- 在应用内进入“设备与高级 → 应用更新”。
- 点击“检查更新”或“下载升级包”。
- 在 fnOS 应用中心选择手动安装新版 FPK。
- 按系统提示确认升级。
升级过程会保留原有 settings.conf 配置。首次使用实验室盘位绑定前，建议先记录当前自动映射状态。
v1.5.0 安装包校验
官方版本安装包 SHA256：
04b793259e5cc8f43dbedb25f15c25735a6d03274d0e956b29a2389689afc63b
适用范围与注意事项
- 当前主要面向绿联 DXP4800 Plus、DX4600 系列以及使用相同 LED 控制方案的设备。
- fnOS 版本需要不低于 0.9.27。
- 安装需要 root 权限，以访问 I2C 设备并加载
i2c-dev。
- 请勿同时运行 LLLED 命令行版或其他会抢占 LED 控制权的程序。
- LED 关闭时不能直接修改颜色，应用会自动先开启 LED，再应用颜色和亮度。
- 不同机型的 HCTL 和物理盘位关系可能不同，请以实际闪灯结果为准。
- 实验室功能未经全部 6 盘位、8 盘位机型验证，使用前请确认没有人员正在维护或更换硬盘。
开源与反馈
项目采用 GNU Affero General Public License v3.0 only 开源。
如果你的机型出现硬盘灯顺序不一致、灯效异常或网络状态判断不准确，反馈时建议附上机型、fnOS 版本、硬盘数量、HCTL 信息以及应用诊断页面内容。
