Network UPS Tools (NUT) 对 Visench C1K UPS 的支持与配置指南

背景介绍

Network UPS Tools (NUT) 是一个开源的电源管理解决方案，用于监控和管理不间断电源(UPS)设备。本文将详细介绍如何为 Visench C1K UPS 设备配置 NUT 支持，该设备使用 Richcomm 控制芯片和 CH340 USB 转串口芯片。

设备特性分析

Visench C1K UPS 是一款经济型不间断电源设备，具有以下技术特点：

1. 采用 Richcomm 控制芯片
2. 使用 WCH CH340 USB 转串口芯片实现通信
3. 官方管理软件 PowerManager II 最后发布于 2006 年
4. 具备风扇自适应调速功能
5. 电池组由两个 12V 铅酸电池串联组成(24V 系统)

通信协议解析

通过逆向工程分析，该设备的通信协议具有以下特征：

1. 通过串口或 USB 虚拟串口进行通信
2. 使用类似 Megatec Qx 家族的协议格式
3. 响应数据中包含电压、负载、频率等关键参数
4. 设备信息返回值为一串"2"字符(厂商未正确实现该功能)

NUT 驱动配置步骤

1. 基础配置

在 /etc/nut/ups.conf 文件中添加以下配置：

[c1k]
driver = nutdrv_qx
port = /dev/ttyCH341USB0

2. 权限设置

由于设备节点权限问题，需要执行以下命令：

chown nut:nut /dev/ttyCH341USB0

若需持久化权限设置，可创建 systemd 服务配置文件：

# /etc/systemd/system/[e-mail].d/perms.conf
[Service]
ExecStartPre=/bin/chown nut:nut /dev/ttyCH341USB0

3. 协议选择

测试发现以下协议适配性最佳：

• ablerex 协议：提供完整的参数读取
• megatec 协议：基础功能支持
• q1 协议：基本参数读取

推荐配置：

protocol = ablerex

4. 电池参数调整

根据实际测试，电池电压范围建议设置为：

default.battery.voltage.high = 28.0
default.battery.voltage.low = 20.8

常见问题解决

1. 设备无法识别

解决方案：

• 确认 /dev/ttyCH341USB0 设备节点存在
• 检查 CH340 驱动是否正常加载
• 尝试以 root 用户临时运行驱动进行测试

2. 数据读取不完整

解决方案：

• 尝试不同的协议选项
• 增加调试级别查看原始通信数据
• 检查线缆连接质量

3. 权限问题

解决方案：

• 确保 nut 用户对设备节点有读写权限
• 考虑使用 udev 规则自动设置权限
• 在虚拟化环境中注意设备透传设置

技术细节深入

通信数据分析

设备返回数据示例：

(229.9 000.0 230.0 027 50.0 2.23 49.0 00100000

各字段含义：

1. 输入电压：229.9V
2. 故障电压：000.0V
3. 输出电压：230.0V
4. 负载百分比：27%
5. 输入频率：50.0Hz
6. 电池电压：2.23V(单节)
7. 设备温度：49.0°C
8. 状态标志：00100000

电池系统分析

该设备使用 24V 电池系统(2×12V)，实际测试中发现：

• 充满电时电压可达 28V
• 正常工作范围建议设为 20.8-28.0V
• 电池状态计算需要根据实际系统调整参数

最佳实践建议

1. 对于生产环境，建议使用 ablerex 协议配置
2. 定期检查设备连接状态和权限设置
3. 根据实际电池特性调整电压阈值
4. 在虚拟化环境中，考虑使用 USB 设备固定策略
5. 监控系统日志中的 UPS 状态变化

通过以上配置和优化，Visench C1K UPS 可以在 NUT 系统中稳定运行，提供可靠的电源监控功能。