NetworkUpstools(NUT)对CyberPower UPS设备UT系列的支持与优化

背景介绍

NetworkUpstools(NUT)是一个开源的UPS监控管理工具套件，支持多种品牌和型号的不间断电源设备。近期社区针对CyberPower公司UT系列UPS设备（包括UT1050EG、UT1050EIG、UT1200EG、UT1200EIG和UT650EG等型号）的支持情况进行了深入测试和优化。

设备特性与支持现状

这些CyberPower UPS设备通过USB HID协议与主机通信，NUT通过usbhid-ups驱动提供支持。测试显示设备能够正确报告以下关键参数：

• 电池状态（电量、电压、剩余运行时间）
• 输入/输出电压
• 负载百分比
• UPS运行状态
• 各种阈值设置（如低电量告警点）

驱动支持丰富的控制命令，包括：

• 蜂鸣器控制
• 负载开关
• 电池测试
• 关机延迟设置等

发现的问题与解决方案

在测试过程中发现了一个关键问题：输入频率显示异常。原生UPS管理工具和NUT都报告了约499Hz的频率值，这明显高于正常电网频率（50Hz或60Hz）。

经过分析，确认这是固件报告的数值存在10倍放大的问题。NUT开发团队提出了修复方案：

1. 在驱动代码中添加频率值修正逻辑
2. 当检测到频率值在480-620范围内时自动除以10

测试表明，该修复成功将显示的频率值从499.0Hz修正为50.0Hz，与实际电网频率相符。

使用建议

对于使用CyberPower UT系列UPS的用户：

1. 建议使用NUT 2.8.2或更新版本
2. 如需频率显示修正，可应用相关补丁
3. 配置时建议指定明确的vendorid(0764)和productid(0501)
4. 可通过upsc命令验证各项参数是否正常

总结

NUT项目持续改进对各种UPS设备的支持，这次对CyberPower UT系列的优化解决了频率显示异常问题，提升了监控数据的准确性。这体现了开源社区对硬件兼容性的持续关注和改进，为用户提供了更可靠的不间断电源监控解决方案。