============================================================
 FAN-HUB 命令行1.2版 - 使用帮助
============================================================

【基本用法】
  fanhub                       进入交互模式(连续操作)
  fanhub <命令> <参数>         单次执行一条命令
  fanhub -p /dev/ttyUSB0 <命令>  指定串口(自动扫描失败时用)

  启动无参数进入交互模式, 提示符 fanhub>, 输入 quit 或 exit 退出。

------------------------------------------------------------
【设备信息】
  -i        显示设备型号与唯一ID
            例: fanhub -i
            型号 FAN-HUB1.1, ID 为固件出厂唯一编号

  -l        显示风扇/温度传感器接入状态
            例: fanhub -l
            输出每路风扇与传感器: 已接入 / 未接入

  -n        读取原始ADC值(硬件调试用)
            例: fanhub -n

------------------------------------------------------------
【风扇转速监控】
  -t        查询全部风扇转速
            例: fanhub -t
            输出: 风扇名 转速(RPM)

  -t 00 03  查询指定风扇转速(可多个)
            例: fanhub -t 00 03
            风扇号可用: 00-05 或 fan0-fan5

  -s 00 50  设置单个风扇占空比(0-100)
            例: fanhub -s 00 100   # fan00 100% 火力全开
                fanhub -s 05 50    # fan05 50%

  -a 80     设置全部风扇占空比
            例: fanhub -a 80       # 全部风扇 80%

  说明: 占空比 0=停, 100=满速。某些风扇正反相接,
        表现为 100% 反而最慢, 属硬件接线/极性差异。

------------------------------------------------------------
【温度监控】
  -c        查询全部温度传感器
            例: fanhub -c
            未接传感器显示"未接入"

  -c 1 3    查询指定传感器(可多个)
            例: fanhub -c 1
            传感器号: 1-3 或 n1-n3

------------------------------------------------------------
【监控模式(核心功能)】
  -w        自动循环监控并应用温度规则
            例: fanhub -w          # Ctrl+C 退出
            每"刷新间隔"秒读取一次转速与温度, 自动调速。

------------------------------------------------------------
【后台服务(开机自启/无需连接设备)】
  start     后台启动监控服务
            例: fanhub start       # 等于 systemctl --user start fanhub
  stop      停止监控服务
            例: fanhub stop
  restart   重启监控服务(配置修改后使用)
            例: fanhub restart

  说明: 需先执行 bash install.sh 配置好服务。
        服务后台运行 fanhub -w, 设备未插时每 5 秒自动重试。
        手动管理: systemctl --user status fanhub

  80°C 全局保护(任何时候生效, 不受开关影响):
    - 任一传感器温度 >= 80°C, 所有已接入风扇强制 100%
    - 温度回落到 80°C 以下自动解除
    - 触发时终端红字报警, 请检查散热/传感器

------------------------------------------------------------
【配置管理】
  cfg                    查看全部当前配置

  cfg -d 60              设置默认转速(0-100)
                         例: fanhub cfg -d 60

  cfg -r 3               设置刷新/监控间隔(1-10秒)
                         例: fanhub cfg -r 5

  cfg on                 温度条件模式 开
  cfg off                温度条件模式 关
                         开启后 -w 才按规则自动调速

  cfg -n fan0 CPU风扇    风扇改名(全软件显示用新名字)
  cfg -n n1 机箱温度     传感器改名
                         例: fanhub cfg -n fan0 CPU风扇

  cfg -ra <传感器> <风扇列表> <温度:转速,...>   添加温度规则
                         例: fanhub cfg -ra n1 fan0,fan1 40:50,60:80
                         含义: n1 达到 40°C -> fan0/fan1 转 50%
                               达到 60°C -> fan0/fan1 转 80%
                               低于 40°C -> 回默认转速
                         档位按温度从低到高, 满足即取最高档。
                         同一传感器温度下所有绑定风扇转速相同。

  cfg -rl                列出全部规则
  cfg -rd 0              删除第 0 条规则(按列表序号)
  cfg -rc                清空全部规则

  cfg -h                 cfg 用法帮助

------------------------------------------------------------
【配置文件】
  目录: ~/.config/fanhub/
  device_<ID>.conf   设备信息(自动创建)
  set_<ID>.conf      用户配置(默认转速/刷新/模式/改名/规则)

  配置按设备唯一ID隔离: 换一块主板(不同ID)自动新建配置,
  旧设备配置保留。也可手动编辑配置文件, 下次启动生效。

------------------------------------------------------------
【安装与权限】
  一键安装: bash install.sh   (安装到 /usr/local/bin + 串口权限 + 开机自启)
  串口权限: 提示打不开串口时执行
            sudo usermod -aG dialout $USER   然后注销重登

【常见问题】
  Q: 提示"未找到 FAN-HUB 设备"
  A: 1) 确认 CH340 已插且 lsusb 可见 2) 确认权限(dialout)
     3) 确认固件波特率 57600 4) 用 -p 指定端口

  Q: 风扇转速读不到/显示 -1
  A: 固件转速缓存约 1 秒刷新一次, 调速后稍等再查

  Q: 调速没反应
  A: 确认风扇 4 线(转速+调速线都接), 检查占空比极性与虚焊

============================================================
 版本: 1.2 (Linux 版)
============================================================