Network UPS Tools (NUT) 中关于USB HID驱动轮询频率的配置解析

在UPS电源监控领域，Network UPS Tools（简称NUT）是一个广泛使用的开源解决方案。本文将深入探讨其USB HID驱动（usbhid-ups）中轮询频率的配置要点，帮助用户优化监控响应速度。

核心概念：两种轮询频率参数

NUT系统中存在两个容易混淆的轮询参数：

1. 驱动层轮询（pollfreq）
   配置路径：ups.conf中的设备配置段
   作用：控制USB HID驱动与物理UPS设备之间的通信频率
   默认值：30秒
   关键影响：直接决定状态变化（如市电断电）的检测延迟

2. 监控层轮询（POLLFREQ）
   配置路径：upsmon.conf
   作用：控制upsmon守护进程检查UPS状态的频率
   默认值：5秒
   关键影响：影响状态通知的传递速度（但受限于驱动层数据）

典型配置误区

许多用户容易犯的一个配置错误是：

• 仅在upsmon.conf中设置POLLFREQ
• 忽略ups.conf中的驱动层配置

这会导致实际响应延迟仍保持30秒的默认值，因为监控层只能基于驱动层提供的数据工作。

正确配置方法

要实现5-10秒的快速响应，需要双管齐下：

1. 驱动层配置
   编辑/etc/nut/ups.conf，在对应设备段添加：

   pollfreq = 5
   

2. 监控层配置
   编辑/etc/nut/upsmon.conf，确保有：

   POLLFREQ 5
   

3. 服务重启
   修改后需重启相关服务：

   systemctl restart nut-driver nut-server nut-monitor
   

技术原理深度解析

USB HID驱动的工作机制决定了：

• 驱动层轮询是硬件通信的基础频率
• 过高的频率（如<2秒）可能导致USB设备过载
• 多数USB HID UPS支持的最低安全值为5秒
• 监控层轮询必须≥驱动层轮询才有效

最佳实践建议

1. 工业环境建议采用5-15秒的平衡值
2. 测试环境可尝试5秒，但需观察USB稳定性
3. 对于关键业务系统，建议配合NOTIFYFLAG配置即时告警
4. 修改配置后，可通过upsc命令验证实际生效值

通过正确理解这两个层级的轮询机制，用户可以显著提升UPS状态监控的实时性，为业务系统提供更可靠的安全保障。