Network UPS Tools (NUT) 对 PowerWalker VFI 1000 AT 的支持分析与问题解决

Network UPS Tools (NUT) 是一个开源的UPS电源管理工具套件，它支持多种UPS设备。本文主要探讨NUT对PowerWalker VFI 1000 AT型号UPS的支持情况，以及在2.8.1版本中遇到的两个关键问题：输出电压显示异常和关机延迟参数失效。

设备支持概况

PowerWalker VFI 1000 AT是一款在线式UPS，通过USB HID协议与主机通信。NUT通过usbhid-ups驱动支持该设备，能够获取以下关键信息：

• 电池状态：充电状态(94%)、电压(27.4V)、剩余运行时间(58740秒)
• 输入参数：电压(210.5V)、频率(50Hz)
• 输出参数：电压(24.8V)、频率(49.9Hz)
• UPS状态：在线充电(OL CHRG)

设备支持多种控制命令，包括：

• 蜂鸣器控制(启用/禁用/静音)
• 负载控制(立即开启/关闭，延迟开启/关闭)
• 电池测试(快速测试/深度测试)
• 关机控制(立即关机/延迟关机)

2.8.1版本中的已知问题

输出电压显示异常

在NUT 2.8.1版本中，输出电压(output.voltage)显示为24.8V，这与设备实际输出电压不符。经测试发现：

1. 该值实际上反映的是UPS设置中的"输出电压选择"参数
2. 当修改UPS的0bP参数(输出电压选择)时，output.voltage值会相应变化
3. 在2.7.4版本中此问题不存在

这个问题与NUT内部对HID报告描述符的处理方式有关。虽然尝试使用disable_fix_report_desc参数来规避，但未能解决问题。最终通过完全卸载并重新安装最新Git版本解决了此问题。

关机延迟参数失效

配置中的关机延迟参数(offdelay/ondelay)似乎未被正确应用：

1. 执行upsmon -c fsd命令后，系统开始关机
2. 约15秒后UPS显示器出现倒计时
3. 又10秒后UPS关闭输出端口
4. 但UPS完全关机需要额外2分钟

这表明：

• UPS内部可能有自己的延迟计时机制
• NUT发送的延迟参数可能未被设备正确解析
• 或者设备固件对HID命令的实现与驱动预期不符

配置建议

基于测试经验，建议使用以下配置参数：

[nutdev1]
    driver = "usbhid-ups"
    port = "auto"
    desc = "PowerWalker VFI 1000 AT"
    vendorid = "0764"
    productid = "0601"
    pollfreq = 5
    offdelay = 20
    ondelay = 30
    default.ups.timer.shutdown = 20
    default.ups.timer.start = 30

总结

PowerWalker VFI 1000 AT与NUT的兼容性总体良好，但在特定版本中可能存在输出电压显示和延迟参数应用的问题。建议用户：

1. 使用最新版本的NUT以获得最佳兼容性
2. 注意输出电压参数的实际含义
3. 了解UPS自身的延迟机制可能与NUT配置不完全一致
4. 必要时完全重新安装驱动以解决异常问题

对于关键应用环境，建议在实际部署前进行全面测试，确保UPS行为符合预期。