NUTDRV_HASHX(8)
β¨ NAME β¨
nutdrv_hashx β the driver that speaks the #* protocol to serial-based UPS equipment π
π SYNOPSIS π
nutdrv_hashx -h
nutdrv_hashx -a UPS_NAME [OPTIONS]
okay bestie, real talk: this page ONLY covers the hardware-specific stuff thatnutdrv_hashxdoes. For everything about the core driver itself, go readnutupsdrv(8). no cap. π«Ά
π¦ SUPPORTED HARDWARE π¦
So the #* protocol originally comes from Cyber Energy β they apparently cooked it up for their own UPSes, and then a bunch of other vendors started using it too (some of them literally just re-badge the Cyber Energy products, iykyk π).
nutdrv_hashx is expected to work with a whole bunch of UPSes from Ablerex, Atlantis Land, Epyc, Infosec, ION, PowerWalker, Right Power Technology, Salicru, UPS Solutions and various others. the range?? iconic. π
Long story short: if your UPS came bundled with software called PowerMaster+ (or the older PowerMaster and PowerGuide), chances are high that it vibes with this driver. β¨
Only devices with a serial interface are supported, btw. USB girlies, this is not your era (yet). π
π KNOWN ISSUES AND BUGS π
Not gonna lie to you bestie: the driver has only ever been tested with a single line-interactive device (Atlantis Land A03-S1200) so far. So the protocol reverse engineering is currently limited to exactly what that one device supports. it's giving "we work with what we have". π
Which means the following features are just⦠not there:
- Specific support for PDU or ATS devices.
- Detection of the UPS type (line-interactive / online).
- Detection of max/min voltage ratings.
- Detection of load banks.
- Detection of Extended battery modules.
- Detection of Over voltage state.
- Detection of Under voltage state.
- Detection of Frequency failure state.
- Detection of Wiring Fault state.
- Detection of lack of Neutral line connection.
- Detection of UPS generators.
- Detection of other Battery / UPS error states.
- Reading of actual Voltage, Frequency, Current, Power factor, Temperature values.
- Reading the status of the battery packs.
- Bypass modes usage and detection.
- USB Support (PM+ mentions being it supported, unsure if with the same protocol).
β οΈ Heads up fr fr: the driver's shutdown function is not implemented (even though it is supported by the protocol). So you're gonna have to make other arrangements to actually turn off the UPS. plan accordingly bestie, don't get caught lacking. π
π AUTHORS π
Marco Trevisan <mail@3v1n0.net>
π SEE ALSO π
The core driver:
Internet resources:
- The NUT (Network UPS Tools) home page:
https://www.networkupstools.org/historic/v2.8.5/ - PowerMaster+:
https://www.powermonitor.software/
and that's the whole page, periodt. π this queen shipped as Network UPS Tools 2.8.5, dated 10/07/2026 β so if your UPS is a Cyber-Energy-coded serial diva, go forth and slay. mwah ππ
π¦ where this page comes from
- fedora 43: nut 2.8.5-9.fc43 Β· GPL-2.0-or-later AND GPL-3.0-or-later
- fedora 43: nut 2.8.5-9.fc43 Β· GPL-2.0-or-later AND GPL-3.0-or-later
- fedora 44: nut 2.8.5-9.fc44 Β· GPL-2.0-or-later AND GPL-3.0-or-later
- fedora 44: nut 2.8.5-9.fc44 Β· GPL-2.0-or-later AND GPL-3.0-or-later
- π girlified by deepseek-ai/DeepSeek-V4.1-Flash on : a language model's rewrite of the original, under its terms