1. 项目概述为边缘计算设备构建电力“哨兵”最近在折腾一台Jetson Orin NX平台的reComputer r1000准备把它部署到一个远程的工业数据采集点上。这个点位的市电供应不太稳定偶尔会有电压波动甚至短时断电。为了保证设备稳定运行和数据不丢失我给它配了一个支持USB通信的UPS不间断电源。硬件都接好了但光有UPS“默默守护”还不够我需要让r1000这个“大脑”能实时感知到外部供电的状态——比如市电输入电压是多少是否已经切换到了电池供电电池还能撑多久这就是今天要聊的核心如何在reComputer r1000上通过软件读取UPS的输入电压等关键信息。这不仅仅是接上线就能用的事儿它涉及到硬件接口识别、通信协议解析、数据获取与处理一整条链路。对于做边缘计算、工业物联网或者任何需要7x24小时稳定运行项目的朋友来说掌握这套方法就相当于给你的设备装上了一双监控电力健康的“眼睛”能提前预警、智能决策比如在电压过低时安全关机或者在电池供电时降低系统负载以延长运行时间。reComputer r1000作为一款基于NVIDIA Jetson Orin系列模块的紧凑型AI边缘计算机其应用场景非常广泛从智慧零售、机器人到自动驾驶数据记录。在这些场景中稳定的电力供应是基础中的基础。通过本项目你将能解锁设备的“电力感知”能力为你的边缘应用增加一层关键的可靠性保障。2. 核心思路与方案选型为什么是USB通信给UPS和主机通信常见的有几种方式串口RS-232/RS-485、网络SNMP、USB HID或者厂商私有协议。我手头这个UPS是消费级/轻工业级常见的型号它通过一根USB线连接到reComputer r1000在系统里被识别为一个USB设备。这通常意味着它采用了USB HID人机接口设备协议或者模拟串口CDC ACM的方式进行通信。为什么选择这个方案首先USB连接即插即用无需额外配置硬件对于reComputer r1000这种接口紧凑的设备来说非常友好。其次大多数现代UPS都支持通过USB上报状态协议相对标准例如部分遵循usbhid-ups驱动支持的规范社区资源和工具链比较成熟。最后我们的目标明确读取输入电压。这是一个关键参数能直接反映市电质量。电压正常时UPS通常处于“在线”模式设备由市电供电并给电池充电当输入电压低于或高于某个阈值比如170V或280VUPS会切换到电池供电模式。实时监控这个值就能第一时间知道外部电力环境的变化。因此我们的技术路线很清晰在reComputer r1000的Ubuntu系统上通过识别USB UPS设备利用开源工具如nut Network UPS Tools与其通信解析其上报的数据流从中提取出输入电压信息并最终通过脚本或服务的形式提供给我们自己的应用程序使用。注意不同品牌、型号的UPS其USB通信协议和数据格式可能不同。虽然nut支持非常多的型号但并非100%兼容。在开始前最好确认你的UPS是否在nut的兼容列表里或者其厂商是否提供了Linux下的驱动/工具。3. 环境准备与依赖安装我的reComputer r1000预装了JetPack 5.1.2底层是Ubuntu 20.04 LTS。整个项目我们将主要依赖一个久经考验的开源套件Network UPS Tools (NUT)。NUT是一个功能强大的UPS监控套件支持客户端-服务器架构能管理数百种不同型号的UPS。3.1 系统更新与基础检查首先通过SSH或直接连接显示器键盘登录到你的reComputer r1000。建议先更新软件包列表确保我们安装的是最新版本的软件。sudo apt update sudo apt upgrade -y接着插入UPS的USB线到r1000的任意一个USB端口USB 3.0或2.0均可。然后使用lsusb命令检查系统是否识别到了这个USB设备。lsusb你应该能在输出列表中看到一个与你的UPS品牌相关的设备。例如你可能看到类似“American Power Conversion”或“Eaton”或“CyberPower”的字样。记下它的ID格式如idVendor:idProduct例如051d:0002。这个ID非常重要它用于后续驱动匹配。3.2 安装Network UPS Tools (NUT)在Ubuntu中NUT的相关软件包通常直接存在于官方源中。我们将安装核心的驱动、服务器和客户端工具。sudo apt install nut nut-client nut-server -y这个命令会安装nut: 核心库和公共文件。nut-server: UPS驱动upsdrv和监控守护进程upsd。nut-client: 用于查询UPS状态的命令行工具如upsc和关机管理工具upsmon。安装完成后NUT服务默认是未启动的因为我们需要先进行配置。3.3 识别UPS驱动与匹配NUT通过驱动与UPS通信。驱动名通常与UPS型号或通信协议相关。我们需要知道该为我们的UPS使用哪个驱动。最可靠的方法是查阅NUT的硬件兼容性列表但一个快速的实践方法是使用nut-scanner工具如果已安装或尝试常见的驱动。首先检查nut-scanner是否可用sudo nut-scanner -U如果可用这个命令会扫描USB总线并尝试识别连接的UPS给出推荐的驱动名和配置信息。如果未安装nut-scanner可以尝试安装nut-doc包或直接根据品牌型号搜索。假设我的UPS是APC Back-UPS系列nut-scanner或经验告诉我常用的驱动是usbhid-ups。另一种可能是blazer_usb。我们需要在配置文件中指定。4. 核心配置详解让系统与UPS对话NUT的主要配置文件位于/etc/nut/目录下。我们需要配置三个关键文件nut.confups.conf和upsd.conf。4.1 配置运行模式 (nut.conf)文件/etc/nut/nut.conf非常简单它定义了NUT的运行模式。对于单机运行一台计算机监控一台UPS我们将其设置为standalone模式。sudo nano /etc/nut/nut.conf将内容修改为MODEstandalone保存并退出。这表示NUT组件驱动、守护进程将在本机独立运行。4.2 配置UPS设备 (ups.conf)这是核心配置文件它告诉NUT驱动如何连接和与你的UPS通信。文件是/etc/nut/ups.conf。sudo nano /etc/nut/ups.conf我们需要在文件中定义一个UPS实例。假设我给这个UPS起名叫myups驱动是usbhid-ups设备由USB总线自动发现。配置节如下[myups] driver usbhid-ups port auto desc My APC UPS connected to reComputer r1000[myups]: 这是你给这个UPS配置起的名字后续查询时会用到。driver usbhid-ups: 指定使用的驱动。请务必替换为你的UPS实际对应的驱动名。你可以从nut-scanner的输出、NUT文档或网络社区中查找。port auto: 让驱动自动搜索USB设备。如果自动搜索失败你可以指定具体的USB设备路径例如port /dev/usb/hiddev0这需要你通过dmesg | grep -i usb或ls /dev来查找。desc: 一段描述信息可选。重要驱动选择是成败关键。如果驱动不对将无法通信。一些常见组合许多APC型号usbhid-ups某些老款APC或其他品牌blazer_usb山特Santak、雷迪司等可能需要genericups驱动配合串口设置即使走USB也可能模拟串口。配置好后保存文件。4.3 配置UPS守护进程 (upsd.conf与用户认证)接下来配置守护进程upsd它负责提供UPS数据的网络服务即使在本机使用。编辑/etc/nut/upsd.confsudo nano /etc/nut/upsd.conf确保有以下行来监听本地连接LISTEN 127.0.0.1 3493 LISTEN ::1 34933493是NUT的默认端口。然后我们需要设置访问用户和密码。编辑/etc/nut/upsd.userssudo nano /etc/nut/upsd.users添加一个用户例如我们创建一个用于本地监控的用户monuser[monuser] password mysecretpassword actions SET instcmds ALLpassword: 设置一个强密码。actions SET: 允许执行设置命令如关机。instcmds ALL: 允许执行所有即时命令。为了简化本地测试你也可以配置一个无密码的“超级用户”但仅限于本地访问生产环境强烈不建议这样做。可以在upsd.users里添加[admin] password adminpass actions SET instcmds ALL upsmon masterupsmon master表示这个用户可以被upsmon守护进程用作master端控制关机。最后编辑/etc/nut/upsmon.conf配置监控端。我们以monuser为例sudo nano /etc/nut/upsmon.conf添加一行MONITOR myupslocalhost 1 monuser mysecretpassword master这表示监控本机localhost上名为myups的UPS如果有一个电源故障1则此节点是master负责执行关机命令。5. 启动服务与读取输入电压实操配置完成后就可以启动服务并测试了。5.1 启动驱动与守护进程首先启动UPS驱动它会尝试连接你的UPSsudo upsdrvctl start关键检查点运行上述命令后立刻查看日志这是排查问题的第一现场。sudo tail -f /var/log/nut/ups.log或者使用sudo systemctl status nut-driver你期望看到的成功信息是驱动找到设备并初始化成功例如“USB communication established”或“Driver connected to UPS”。如果看到“No supported devices found”或权限错误说明驱动不对或USB设备节点权限有问题。实操心得驱动启动失败最常见的原因有三个1. 驱动名不对2. USB设备被其他进程占用比如内核自带的usbhid驱动3. 权限不足需要将nut用户加入dialout组或者修改/dev下设备节点的权限。对于原因2可以尝试使用port auto或指定port /dev/usb/hiddevX并确保没有其他驱动绑定。对于原因3可以运行sudo usermod -a -G dialout nut然后重启服务。驱动启动成功后再启动UPS守护进程upsd和监控进程upsmonsudo systemctl start nut-server nut-monitor sudo systemctl enable nut-server nut-monitor # 设置开机自启检查它们的状态sudo systemctl status nut-server sudo systemctl status nut-monitor5.2 使用 upsc 命令读取关键参数现在激动人心的时刻到了。使用upsc命令查询UPS的状态。upsc是NUT客户端工具用于从upsd获取数据。查询我们配置的myups的所有可用变量upsc myupslocalhost你会看到一大堆输出其中就包含我们梦寐以求的输入电压信息输出是键值对形式你需要寻找类似以下的字段input.voltage:这就是交流输入电压的实时值单位通常是伏特V。例如input.voltage: 230.0。input.voltage.nominal: 额定输入电压例如 230。input.frequency: 输入频率例如 50.0。ups.status: UPS状态例如OL在线On Line、OB在线电池On Battery、LB电池电量低等。battery.charge: 电池剩余电量百分比。battery.runtime: 电池剩余运行时间秒。专门读取输入电压upsc myupslocalhost input.voltage这条命令会直接返回当前的输入电压数值例如228.5。这个值就是你的reComputer r1000从UPS读取到的市电电压。5.3 编写脚本实现定时监控与告警单纯手动查询不够自动化。我们可以写一个简单的Shell或Python脚本定时读取input.voltage并根据阈值进行判断和告警。下面是一个简单的Python脚本示例monitor_voltage.py#!/usr/bin/env python3 import subprocess import time import logging from datetime import datetime # 配置 UPS_NAME myupslocalhost VOLTAGE_THRESHOLD_LOW 200.0 # 低压告警阈值 (V) VOLTAGE_THRESHOLD_HIGH 250.0 # 高压告警阈值 (V) CHECK_INTERVAL 10 # 检查间隔秒 # 设置日志 logging.basicConfig( levellogging.INFO, format%(asctime)s - %(levelname)s - %(message)s, handlers[ logging.FileHandler(/var/log/ups_voltage_monitor.log), logging.StreamHandler() ] ) def get_ups_variable(var_name): 使用upsc命令获取指定UPS变量的值 try: cmd [upsc, UPS_NAME, var_name] result subprocess.run(cmd, capture_outputTrue, textTrue, timeout5) if result.returncode 0: return result.stdout.strip() else: logging.error(fFailed to get {var_name}: {result.stderr}) return None except subprocess.TimeoutExpired: logging.error(fTimeout while getting {var_name}) return None except Exception as e: logging.error(fError getting {var_name}: {e}) return None def main(): logging.info(UPS输入电压监控脚本启动) while True: voltage_str get_ups_variable(input.voltage) status_str get_ups_variable(ups.status) if voltage_str: try: voltage float(voltage_str) logging.info(f当前输入电压: {voltage} V, 状态: {status_str}) # 阈值判断 if voltage VOLTAGE_THRESHOLD_LOW: logging.warning(f⚠️ 输入电压过低: {voltage} V! 可能即将切换至电池。) # 此处可以添加触发告警的动作如发送邮件、HTTP请求等 elif voltage VOLTAGE_THRESHOLD_HIGH: logging.warning(f⚠️ 输入电压过高: {voltage} V!) else: logging.debug(输入电压正常。) except ValueError: logging.error(f无法解析电压值: {voltage_str}) else: logging.warning(无法读取输入电压UPS通信可能异常。) time.sleep(CHECK_INTERVAL) if __name__ __main__: main()给脚本执行权限并运行建议使用systemd服务管理以下为测试chmod x monitor_voltage.py sudo python3 monitor_voltage.py这个脚本会每10秒检查一次电压并在电压异常时记录警告日志。你可以扩展它集成邮件通知使用sendmail或SMTP库、Telegram Bot消息推送或者与你的主应用程序状态管理结合起来。6. 常见问题排查与实战技巧在实际部署中你几乎一定会遇到一些问题。下面是我踩过坑后总结的排查清单和技巧。6.1 驱动无法启动或找不到设备症状sudo upsdrvctl start失败日志显示“No supported devices found”。排查步骤确认USB识别再次运行lsusb确认UPS设备在列表中。如果看不到尝试更换USB线或USB端口。检查驱动匹配这是最常见的问题。运行sudo nut-scanner -U。如果不行去NUT官网的硬件兼容性列表HCL用你的UPS型号搜索。也可以尝试在ups.conf中换用blazer_usb、genericups等驱动。检查设备权限USB HID设备通常对应/dev/usb/hiddev0或/dev/hidraw0。运行ls -la /dev/usb/hiddev* /dev/hidraw*查看设备是否存在以及所属组。确保nut用户或你运行驱动的用户有读写权限。可以尝试sudo chmod 664 /dev/usb/hiddev0 # 临时修改权限 sudo usermod -a -G dialout nut # 将nut用户加入dialout组然后重启nut-driver服务。内核驱动冲突Linux内核可能已经用自带的usbhid驱动占用了设备。可以尝试让NUT驱动独占设备。在ups.conf中除了port auto可以尝试明确指定port /dev/usb/hiddev0。更彻底的方法是使用libusb通过总线-设备地址来定位但这更复杂。6.2 upsc命令连接被拒绝或超时症状运行upsc myupslocalhost提示“Connection refused”或长时间无响应。排查步骤确认upsd服务运行sudo systemctl status nut-server。检查端口监听sudo netstat -tlnp | grep 3493看是否有upsd进程在监听127.0.0.1:3493。检查配置文件语法特别是upsd.conf中的LISTEN指令和upsd.users中的用户配置。一个常见的错误是upsd.users中用户的权限设置不对导致upsmon无法连接。确保你在upsmon.conf中使用的用户名和密码与upsd.users中完全一致。查看upsd日志sudo tail -f /var/log/nut/upsd.log看是否有认证失败或连接错误信息。6.3 读取到的电压值不准或为0症状upsc能连接但input.voltage的值明显不对如0.0或远偏离220V/110V。可能原因与解决协议解析错误驱动能通信但对数据包的解析不准确。这通常意味着驱动不完全兼容你的UPS型号。可以尝试在ups.conf中为你的UPS配置节添加驱动特定参数。例如对于usbhid-ups驱动可以尝试添加vendorid 051d和productid 0002用你的lsusbID替换来帮助驱动识别。具体参数需要查阅驱动手册man usbhid-ups。UPS本身不支持报告输入电压有些非常基础的UPS型号其USB通信协议可能只报告状态在线/电池不提供详细的电压、频率等数据。你需要查阅UPS的说明书或联系厂商确认。单位问题确认单位是伏特V。有些值可能是以0.1V为单位的但NUT驱动通常会处理好转换。6.4 如何实现低电压自动安全关机这是UPS监控的终极目标之一。NUT已经通过upsmon提供了这个功能。我们在upsmon.conf中配置的MONITOR行其中的master标识意味着当UPS报告需要关机时如电池电量低LB状态持续一段时间upsmon会执行关机脚本。NUT预定义的关机行为在/etc/nut/upsmon.conf中通过SHUTDOWNCMD指定。通常它会调用/sbin/shutdown。你需要确保upsmon有正确的权限执行关机。测试关机流程模拟断电拔掉UPS的市电输入插头。UPS会切换到电池模式。观察状态upsc myupslocalhost ups.status应该会变成OB。等待电池耗尽或触发低电量当battery.charge低于阈值或在upsmon.conf中设置的BATTVOLTAGE等参数触发upsmon会开始关机倒计时默认可能30秒然后执行关机命令。重要在真正依赖此功能前务必在测试环境中模拟完整流程确认关机指令能正确执行并且你的应用程序有足够的时间保存数据。7. 进阶应用与性能考量对于reComputer r1000这样的边缘AI设备电力监控可以做得更智能。7.1 与边缘应用集成你的AI推理程序、数据采集服务或容器可以通过简单的HTTP API或本地Socket来获取我们脚本提供的电压数据。例如将上面的Python脚本改成一个Flask微服务from flask import Flask, jsonify import subprocess app Flask(__name__) UPS_NAME myupslocalhost app.route(/api/ups/status) def get_ups_status(): try: voltage subprocess.check_output([upsc, UPS_NAME, input.voltage], textTrue).strip() status subprocess.check_output([upsc, UPS_NAME, ups.status], textTrue).strip() return jsonify({input_voltage: float(voltage), status: status, error: None}) except Exception as e: return jsonify({error: str(e)}), 500 if __name__ __main__: app.run(host0.0.0.0, port5000)这样你的其他容器或进程就可以通过http://localhost:5000/api/ups/status来获取实时电力状态并据此调整自身行为比如在电压不稳时暂停非关键任务或提高数据保存频率。7.2 性能与资源开销在r1000上运行NUT套件和我们的监控脚本资源开销极小。upsdrv和upsd进程内存占用通常在几MB到十几MBCPU使用率几乎为0。我们的Python监控脚本如果检查间隔设为10秒其开销也可以忽略不计。这对于资源本就宝贵的边缘设备来说是完全可以接受的。关键在于它带来的可靠性提升是巨大的。7.3 数据记录与可视化长期记录输入电压数据可以帮助你分析供电质量。你可以将脚本读取的数据写入到SQLite数据库、CSV文件或者推送到像InfluxDB这样的时序数据库中结合Grafana进行可视化。这样你就能看到一天甚至一个月内电压的波动情况为站点电力评估提供数据支持。一个简单的日志记录示例集成到之前的监控脚本中import csv from datetime import datetime def log_to_csv(voltage, status): with open(/var/log/ups_voltage_history.csv, a, newline) as f: writer csv.writer(f) writer.writerow([datetime.now().isoformat(), voltage, status])在main函数的循环中调用log_to_csv(voltage, status_str)即可。通过这一整套从硬件连接到软件配置、从数据读取到应用集成的流程我们成功在reComputer r1000上建立了一套可靠的外部电力监控系统。它不仅解决了“读取输入电压”这个具体问题更构建了一个边缘设备电力健康管理的基础框架。当你下次再面对不稳定的供电环境时你的设备将不再是“盲人摸象”而是拥有了感知和应对风险的能力。
在reComputer r1000上通过NUT监控UPS输入电压的完整实践
发布时间：2026/8/2 11:09:19
1. 项目概述为边缘计算设备构建电力“哨兵”最近在折腾一台Jetson Orin NX平台的reComputer r1000准备把它部署到一个远程的工业数据采集点上。这个点位的市电供应不太稳定偶尔会有电压波动甚至短时断电。为了保证设备稳定运行和数据不丢失我给它配了一个支持USB通信的UPS不间断电源。硬件都接好了但光有UPS“默默守护”还不够我需要让r1000这个“大脑”能实时感知到外部供电的状态——比如市电输入电压是多少是否已经切换到了电池供电电池还能撑多久这就是今天要聊的核心如何在reComputer r1000上通过软件读取UPS的输入电压等关键信息。这不仅仅是接上线就能用的事儿它涉及到硬件接口识别、通信协议解析、数据获取与处理一整条链路。对于做边缘计算、工业物联网或者任何需要7x24小时稳定运行项目的朋友来说掌握这套方法就相当于给你的设备装上了一双监控电力健康的“眼睛”能提前预警、智能决策比如在电压过低时安全关机或者在电池供电时降低系统负载以延长运行时间。reComputer r1000作为一款基于NVIDIA Jetson Orin系列模块的紧凑型AI边缘计算机其应用场景非常广泛从智慧零售、机器人到自动驾驶数据记录。在这些场景中稳定的电力供应是基础中的基础。通过本项目你将能解锁设备的“电力感知”能力为你的边缘应用增加一层关键的可靠性保障。2. 核心思路与方案选型为什么是USB通信给UPS和主机通信常见的有几种方式串口RS-232/RS-485、网络SNMP、USB HID或者厂商私有协议。我手头这个UPS是消费级/轻工业级常见的型号它通过一根USB线连接到reComputer r1000在系统里被识别为一个USB设备。这通常意味着它采用了USB HID人机接口设备协议或者模拟串口CDC ACM的方式进行通信。为什么选择这个方案首先USB连接即插即用无需额外配置硬件对于reComputer r1000这种接口紧凑的设备来说非常友好。其次大多数现代UPS都支持通过USB上报状态协议相对标准例如部分遵循usbhid-ups驱动支持的规范社区资源和工具链比较成熟。最后我们的目标明确读取输入电压。这是一个关键参数能直接反映市电质量。电压正常时UPS通常处于“在线”模式设备由市电供电并给电池充电当输入电压低于或高于某个阈值比如170V或280VUPS会切换到电池供电模式。实时监控这个值就能第一时间知道外部电力环境的变化。因此我们的技术路线很清晰在reComputer r1000的Ubuntu系统上通过识别USB UPS设备利用开源工具如nut Network UPS Tools与其通信解析其上报的数据流从中提取出输入电压信息并最终通过脚本或服务的形式提供给我们自己的应用程序使用。注意不同品牌、型号的UPS其USB通信协议和数据格式可能不同。虽然nut支持非常多的型号但并非100%兼容。在开始前最好确认你的UPS是否在nut的兼容列表里或者其厂商是否提供了Linux下的驱动/工具。3. 环境准备与依赖安装我的reComputer r1000预装了JetPack 5.1.2底层是Ubuntu 20.04 LTS。整个项目我们将主要依赖一个久经考验的开源套件Network UPS Tools (NUT)。NUT是一个功能强大的UPS监控套件支持客户端-服务器架构能管理数百种不同型号的UPS。3.1 系统更新与基础检查首先通过SSH或直接连接显示器键盘登录到你的reComputer r1000。建议先更新软件包列表确保我们安装的是最新版本的软件。sudo apt update sudo apt upgrade -y接着插入UPS的USB线到r1000的任意一个USB端口USB 3.0或2.0均可。然后使用lsusb命令检查系统是否识别到了这个USB设备。lsusb你应该能在输出列表中看到一个与你的UPS品牌相关的设备。例如你可能看到类似“American Power Conversion”或“Eaton”或“CyberPower”的字样。记下它的ID格式如idVendor:idProduct例如051d:0002。这个ID非常重要它用于后续驱动匹配。3.2 安装Network UPS Tools (NUT)在Ubuntu中NUT的相关软件包通常直接存在于官方源中。我们将安装核心的驱动、服务器和客户端工具。sudo apt install nut nut-client nut-server -y这个命令会安装nut: 核心库和公共文件。nut-server: UPS驱动upsdrv和监控守护进程upsd。nut-client: 用于查询UPS状态的命令行工具如upsc和关机管理工具upsmon。安装完成后NUT服务默认是未启动的因为我们需要先进行配置。3.3 识别UPS驱动与匹配NUT通过驱动与UPS通信。驱动名通常与UPS型号或通信协议相关。我们需要知道该为我们的UPS使用哪个驱动。最可靠的方法是查阅NUT的硬件兼容性列表但一个快速的实践方法是使用nut-scanner工具如果已安装或尝试常见的驱动。首先检查nut-scanner是否可用sudo nut-scanner -U如果可用这个命令会扫描USB总线并尝试识别连接的UPS给出推荐的驱动名和配置信息。如果未安装nut-scanner可以尝试安装nut-doc包或直接根据品牌型号搜索。假设我的UPS是APC Back-UPS系列nut-scanner或经验告诉我常用的驱动是usbhid-ups。另一种可能是blazer_usb。我们需要在配置文件中指定。4. 核心配置详解让系统与UPS对话NUT的主要配置文件位于/etc/nut/目录下。我们需要配置三个关键文件nut.confups.conf和upsd.conf。4.1 配置运行模式 (nut.conf)文件/etc/nut/nut.conf非常简单它定义了NUT的运行模式。对于单机运行一台计算机监控一台UPS我们将其设置为standalone模式。sudo nano /etc/nut/nut.conf将内容修改为MODEstandalone保存并退出。这表示NUT组件驱动、守护进程将在本机独立运行。4.2 配置UPS设备 (ups.conf)这是核心配置文件它告诉NUT驱动如何连接和与你的UPS通信。文件是/etc/nut/ups.conf。sudo nano /etc/nut/ups.conf我们需要在文件中定义一个UPS实例。假设我给这个UPS起名叫myups驱动是usbhid-ups设备由USB总线自动发现。配置节如下[myups] driver usbhid-ups port auto desc My APC UPS connected to reComputer r1000[myups]: 这是你给这个UPS配置起的名字后续查询时会用到。driver usbhid-ups: 指定使用的驱动。请务必替换为你的UPS实际对应的驱动名。你可以从nut-scanner的输出、NUT文档或网络社区中查找。port auto: 让驱动自动搜索USB设备。如果自动搜索失败你可以指定具体的USB设备路径例如port /dev/usb/hiddev0这需要你通过dmesg | grep -i usb或ls /dev来查找。desc: 一段描述信息可选。重要驱动选择是成败关键。如果驱动不对将无法通信。一些常见组合许多APC型号usbhid-ups某些老款APC或其他品牌blazer_usb山特Santak、雷迪司等可能需要genericups驱动配合串口设置即使走USB也可能模拟串口。配置好后保存文件。4.3 配置UPS守护进程 (upsd.conf与用户认证)接下来配置守护进程upsd它负责提供UPS数据的网络服务即使在本机使用。编辑/etc/nut/upsd.confsudo nano /etc/nut/upsd.conf确保有以下行来监听本地连接LISTEN 127.0.0.1 3493 LISTEN ::1 34933493是NUT的默认端口。然后我们需要设置访问用户和密码。编辑/etc/nut/upsd.userssudo nano /etc/nut/upsd.users添加一个用户例如我们创建一个用于本地监控的用户monuser[monuser] password mysecretpassword actions SET instcmds ALLpassword: 设置一个强密码。actions SET: 允许执行设置命令如关机。instcmds ALL: 允许执行所有即时命令。为了简化本地测试你也可以配置一个无密码的“超级用户”但仅限于本地访问生产环境强烈不建议这样做。可以在upsd.users里添加[admin] password adminpass actions SET instcmds ALL upsmon masterupsmon master表示这个用户可以被upsmon守护进程用作master端控制关机。最后编辑/etc/nut/upsmon.conf配置监控端。我们以monuser为例sudo nano /etc/nut/upsmon.conf添加一行MONITOR myupslocalhost 1 monuser mysecretpassword master这表示监控本机localhost上名为myups的UPS如果有一个电源故障1则此节点是master负责执行关机命令。5. 启动服务与读取输入电压实操配置完成后就可以启动服务并测试了。5.1 启动驱动与守护进程首先启动UPS驱动它会尝试连接你的UPSsudo upsdrvctl start关键检查点运行上述命令后立刻查看日志这是排查问题的第一现场。sudo tail -f /var/log/nut/ups.log或者使用sudo systemctl status nut-driver你期望看到的成功信息是驱动找到设备并初始化成功例如“USB communication established”或“Driver connected to UPS”。如果看到“No supported devices found”或权限错误说明驱动不对或USB设备节点权限有问题。实操心得驱动启动失败最常见的原因有三个1. 驱动名不对2. USB设备被其他进程占用比如内核自带的usbhid驱动3. 权限不足需要将nut用户加入dialout组或者修改/dev下设备节点的权限。对于原因2可以尝试使用port auto或指定port /dev/usb/hiddevX并确保没有其他驱动绑定。对于原因3可以运行sudo usermod -a -G dialout nut然后重启服务。驱动启动成功后再启动UPS守护进程upsd和监控进程upsmonsudo systemctl start nut-server nut-monitor sudo systemctl enable nut-server nut-monitor # 设置开机自启检查它们的状态sudo systemctl status nut-server sudo systemctl status nut-monitor5.2 使用 upsc 命令读取关键参数现在激动人心的时刻到了。使用upsc命令查询UPS的状态。upsc是NUT客户端工具用于从upsd获取数据。查询我们配置的myups的所有可用变量upsc myupslocalhost你会看到一大堆输出其中就包含我们梦寐以求的输入电压信息输出是键值对形式你需要寻找类似以下的字段input.voltage:这就是交流输入电压的实时值单位通常是伏特V。例如input.voltage: 230.0。input.voltage.nominal: 额定输入电压例如 230。input.frequency: 输入频率例如 50.0。ups.status: UPS状态例如OL在线On Line、OB在线电池On Battery、LB电池电量低等。battery.charge: 电池剩余电量百分比。battery.runtime: 电池剩余运行时间秒。专门读取输入电压upsc myupslocalhost input.voltage这条命令会直接返回当前的输入电压数值例如228.5。这个值就是你的reComputer r1000从UPS读取到的市电电压。5.3 编写脚本实现定时监控与告警单纯手动查询不够自动化。我们可以写一个简单的Shell或Python脚本定时读取input.voltage并根据阈值进行判断和告警。下面是一个简单的Python脚本示例monitor_voltage.py#!/usr/bin/env python3 import subprocess import time import logging from datetime import datetime # 配置 UPS_NAME myupslocalhost VOLTAGE_THRESHOLD_LOW 200.0 # 低压告警阈值 (V) VOLTAGE_THRESHOLD_HIGH 250.0 # 高压告警阈值 (V) CHECK_INTERVAL 10 # 检查间隔秒 # 设置日志 logging.basicConfig( levellogging.INFO, format%(asctime)s - %(levelname)s - %(message)s, handlers[ logging.FileHandler(/var/log/ups_voltage_monitor.log), logging.StreamHandler() ] ) def get_ups_variable(var_name): 使用upsc命令获取指定UPS变量的值 try: cmd [upsc, UPS_NAME, var_name] result subprocess.run(cmd, capture_outputTrue, textTrue, timeout5) if result.returncode 0: return result.stdout.strip() else: logging.error(fFailed to get {var_name}: {result.stderr}) return None except subprocess.TimeoutExpired: logging.error(fTimeout while getting {var_name}) return None except Exception as e: logging.error(fError getting {var_name}: {e}) return None def main(): logging.info(UPS输入电压监控脚本启动) while True: voltage_str get_ups_variable(input.voltage) status_str get_ups_variable(ups.status) if voltage_str: try: voltage float(voltage_str) logging.info(f当前输入电压: {voltage} V, 状态: {status_str}) # 阈值判断 if voltage VOLTAGE_THRESHOLD_LOW: logging.warning(f⚠️ 输入电压过低: {voltage} V! 可能即将切换至电池。) # 此处可以添加触发告警的动作如发送邮件、HTTP请求等 elif voltage VOLTAGE_THRESHOLD_HIGH: logging.warning(f⚠️ 输入电压过高: {voltage} V!) else: logging.debug(输入电压正常。) except ValueError: logging.error(f无法解析电压值: {voltage_str}) else: logging.warning(无法读取输入电压UPS通信可能异常。) time.sleep(CHECK_INTERVAL) if __name__ __main__: main()给脚本执行权限并运行建议使用systemd服务管理以下为测试chmod x monitor_voltage.py sudo python3 monitor_voltage.py这个脚本会每10秒检查一次电压并在电压异常时记录警告日志。你可以扩展它集成邮件通知使用sendmail或SMTP库、Telegram Bot消息推送或者与你的主应用程序状态管理结合起来。6. 常见问题排查与实战技巧在实际部署中你几乎一定会遇到一些问题。下面是我踩过坑后总结的排查清单和技巧。6.1 驱动无法启动或找不到设备症状sudo upsdrvctl start失败日志显示“No supported devices found”。排查步骤确认USB识别再次运行lsusb确认UPS设备在列表中。如果看不到尝试更换USB线或USB端口。检查驱动匹配这是最常见的问题。运行sudo nut-scanner -U。如果不行去NUT官网的硬件兼容性列表HCL用你的UPS型号搜索。也可以尝试在ups.conf中换用blazer_usb、genericups等驱动。检查设备权限USB HID设备通常对应/dev/usb/hiddev0或/dev/hidraw0。运行ls -la /dev/usb/hiddev* /dev/hidraw*查看设备是否存在以及所属组。确保nut用户或你运行驱动的用户有读写权限。可以尝试sudo chmod 664 /dev/usb/hiddev0 # 临时修改权限 sudo usermod -a -G dialout nut # 将nut用户加入dialout组然后重启nut-driver服务。内核驱动冲突Linux内核可能已经用自带的usbhid驱动占用了设备。可以尝试让NUT驱动独占设备。在ups.conf中除了port auto可以尝试明确指定port /dev/usb/hiddev0。更彻底的方法是使用libusb通过总线-设备地址来定位但这更复杂。6.2 upsc命令连接被拒绝或超时症状运行upsc myupslocalhost提示“Connection refused”或长时间无响应。排查步骤确认upsd服务运行sudo systemctl status nut-server。检查端口监听sudo netstat -tlnp | grep 3493看是否有upsd进程在监听127.0.0.1:3493。检查配置文件语法特别是upsd.conf中的LISTEN指令和upsd.users中的用户配置。一个常见的错误是upsd.users中用户的权限设置不对导致upsmon无法连接。确保你在upsmon.conf中使用的用户名和密码与upsd.users中完全一致。查看upsd日志sudo tail -f /var/log/nut/upsd.log看是否有认证失败或连接错误信息。6.3 读取到的电压值不准或为0症状upsc能连接但input.voltage的值明显不对如0.0或远偏离220V/110V。可能原因与解决协议解析错误驱动能通信但对数据包的解析不准确。这通常意味着驱动不完全兼容你的UPS型号。可以尝试在ups.conf中为你的UPS配置节添加驱动特定参数。例如对于usbhid-ups驱动可以尝试添加vendorid 051d和productid 0002用你的lsusbID替换来帮助驱动识别。具体参数需要查阅驱动手册man usbhid-ups。UPS本身不支持报告输入电压有些非常基础的UPS型号其USB通信协议可能只报告状态在线/电池不提供详细的电压、频率等数据。你需要查阅UPS的说明书或联系厂商确认。单位问题确认单位是伏特V。有些值可能是以0.1V为单位的但NUT驱动通常会处理好转换。6.4 如何实现低电压自动安全关机这是UPS监控的终极目标之一。NUT已经通过upsmon提供了这个功能。我们在upsmon.conf中配置的MONITOR行其中的master标识意味着当UPS报告需要关机时如电池电量低LB状态持续一段时间upsmon会执行关机脚本。NUT预定义的关机行为在/etc/nut/upsmon.conf中通过SHUTDOWNCMD指定。通常它会调用/sbin/shutdown。你需要确保upsmon有正确的权限执行关机。测试关机流程模拟断电拔掉UPS的市电输入插头。UPS会切换到电池模式。观察状态upsc myupslocalhost ups.status应该会变成OB。等待电池耗尽或触发低电量当battery.charge低于阈值或在upsmon.conf中设置的BATTVOLTAGE等参数触发upsmon会开始关机倒计时默认可能30秒然后执行关机命令。重要在真正依赖此功能前务必在测试环境中模拟完整流程确认关机指令能正确执行并且你的应用程序有足够的时间保存数据。7. 进阶应用与性能考量对于reComputer r1000这样的边缘AI设备电力监控可以做得更智能。7.1 与边缘应用集成你的AI推理程序、数据采集服务或容器可以通过简单的HTTP API或本地Socket来获取我们脚本提供的电压数据。例如将上面的Python脚本改成一个Flask微服务from flask import Flask, jsonify import subprocess app Flask(__name__) UPS_NAME myupslocalhost app.route(/api/ups/status) def get_ups_status(): try: voltage subprocess.check_output([upsc, UPS_NAME, input.voltage], textTrue).strip() status subprocess.check_output([upsc, UPS_NAME, ups.status], textTrue).strip() return jsonify({input_voltage: float(voltage), status: status, error: None}) except Exception as e: return jsonify({error: str(e)}), 500 if __name__ __main__: app.run(host0.0.0.0, port5000)这样你的其他容器或进程就可以通过http://localhost:5000/api/ups/status来获取实时电力状态并据此调整自身行为比如在电压不稳时暂停非关键任务或提高数据保存频率。7.2 性能与资源开销在r1000上运行NUT套件和我们的监控脚本资源开销极小。upsdrv和upsd进程内存占用通常在几MB到十几MBCPU使用率几乎为0。我们的Python监控脚本如果检查间隔设为10秒其开销也可以忽略不计。这对于资源本就宝贵的边缘设备来说是完全可以接受的。关键在于它带来的可靠性提升是巨大的。7.3 数据记录与可视化长期记录输入电压数据可以帮助你分析供电质量。你可以将脚本读取的数据写入到SQLite数据库、CSV文件或者推送到像InfluxDB这样的时序数据库中结合Grafana进行可视化。这样你就能看到一天甚至一个月内电压的波动情况为站点电力评估提供数据支持。一个简单的日志记录示例集成到之前的监控脚本中import csv from datetime import datetime def log_to_csv(voltage, status): with open(/var/log/ups_voltage_history.csv, a, newline) as f: writer csv.writer(f) writer.writerow([datetime.now().isoformat(), voltage, status])在main函数的循环中调用log_to_csv(voltage, status_str)即可。通过这一整套从硬件连接到软件配置、从数据读取到应用集成的流程我们成功在reComputer r1000上建立了一套可靠的外部电力监控系统。它不仅解决了“读取输入电压”这个具体问题更构建了一个边缘设备电力健康管理的基础框架。当你下次再面对不稳定的供电环境时你的设备将不再是“盲人摸象”而是拥有了感知和应对风险的能力。
)
