POWERCOM(8)

💖 POWERCOM(8) 💖

hey bestie 🫶 so this is the manual page for powercom, section 8 of the NUT Manual — it's the UPS driver for serial Powercom/Trust/Advice UPS equipment. sit down, grab a snack 🍓, and let's get into it.

---

✨ SYNOPSIS ✨

powercom -h

powercom -a UPS_NAME [OPTIONS]

📌 note, bestie: this page only covers the hardware-specific stuff for the powercom driver. for all the core driver tea, go read nutupsdrv(8). iykyk 💅

---

🔌 SUPPORTED HARDWARE 🔌

okay so this driver is lowkey a social butterfly — it supports many similar kinds of serial UPS hardware, plus a few USB UPS models that are rocking USB-to-serial adapters 🦋. the most common icons in the group chat are the Trust 425/625, Powercom, and Advice Partner/King PR750. other units speaking the same protocol might also work — no cap. 💯

for USB connections though, you might actually need usbhid-ups(8) instead, so don't come for me if you plug in a USB cable and it's giving nothing.

want more specific guidance on which driver is the moment for your USB connection? check the NUT Hardware Compatibility List (HCL) — that's the main character of hardware compatibility fr fr 👑

---

🌸 EXTRA ARGUMENTS 🌸

this driver supports these optional settings in the ups.conf(5) file — all of them are extra, none are required, so no pressure:

• linevoltage=value — an integer for the line voltage. it literally cannot be auto detected, so you gotta tell it. acceptable values are in the range of 110-120 or 220-240. the default is 230.
• manufacturer=name — sets the manufacturer name, and nope, this one can't be auto detected either 🙈. it's a user defined string, so literally any name is acceptable. the default is PowerCom.
• modelname=name — sets the model name. also can't be auto detected. also a user defined string, so again, any name is acceptable. the default is Unknown.
• serialnumber=value — same energy as modelname above but for the serial number. the default is Unknown.
• type=name — the exact type of the communication protocol within the powercom family that's used to talk to the UPS. the type is named after the first modelname that was coded with that protocol. acceptable names are Trust, Egys, KP625AP, IMP, KIN, BNT, BNT-other and OPTI. the default is Trust.

BNT-other is a special type for other BNT models (such as the 1500A at 120V) and can be used to override ALL models using ALL of the following values. periodt 💅

• shutdownArguments={{minutes,seconds},whether_minutes_should_be_used} — the minutes and seconds that the UPS should wait between receiving the shutdown command and actually shutting off ⏳. the other argument should be set to the character n only when the minutes value should be skipped and not sent to the UPS. the default is type-dependent and is given below. the braces and commas are mandatory. note that there should be no whitespace characters — none, zero, not even one.
• numOfBytesFromUPS=value — the number of bytes in a UPS frame: 16 is common, 11 for Trust. the default is type-dependent and is given below.
• methodOfFlowControl=name — the method of serial communication flow control that's engaged by the UPS. the default is type-dependent and is given below. acceptable names are dtr0rts1, dtr1 or no_flow_control.
• validationSequence={{index1,value1},{index2,value2},{index3,value3}} — (only for types KP625AP, Trust, Egys) 3 pairs used for validating the UPS by comparing bytes of the raw data with constant values. the index selects the byte from the UPS (see numOfBytesFromUPS) and the value is for matching to the byte. the default is type-dependent and is given below. the braces and commas are mandatory, as is the lack of white space characters.
• frequency={A,B} — (only for types KP625AP, Trust, Egys) a pair to convert the raw frequency data into a human-readable frequency reading using the function 1/(A*x+B). if the raw value x IS the frequency, then set A=1/(x^2) and B=0. the default is type-dependent and is given below. do note that the braces and commas are mandatory as well, as is the lack of whitespace characters. it's giving strict 💀
• loadPercentage={BatteryA,BatteryB,LineA,LineB} — (only for types KP625AP, Trust, Egys) a quad to convert the raw load data into a human readable load percentage reading using the function A*x+B. if the raw value x IS the Load Percent, then set A=1 and B=0. the default is type-dependent and is given below. do note that the braces and commas are mandatory, as is the lack of white space characters.
• batteryPercentage={Battery1,Battery2,Battery3,Line4,Line5} — (only for KP625AP, Trust, Egys) a 5 tuple to convert the raw battery and line data into a human-readable battery and line percentage reading using the functions (Battery) A*x+B*y+C and (Line) D*x+E. if the raw value x IS the Battery Percent, then set A=1, B=0, C=0, D=1, E=0. the default is type-dependent and is given below. do note that the braces and commas are mandatory, as is the lack of white space characters.
• voltage={240A,240B,120A,120B} — (only for types KP625AP, Trust, Egys) a quad used to convert the raw voltage data into a human-readable voltage reading using the function A*x+B. if the raw value x IS HALF the Voltage, then set A=2, B=0. the default is type-dependent and is given below. do note that the braces and commas are mandatory, as well as the lack of whitespace characters.
• nobt — if this flag is present, the battery check on startup is skipped 🚫🔋. this is useful for systems that tend to overload the UPS when testing the battery on system startup — just when the power consumption tends to be high. iconic little escape hatch, honestly.

---

👑 DEFAULT VALUES FOR THE EXTRA ARGUMENTS 👑

linevoltage = 230
manufacturer = PowerCom
modelname = Unknown
serialnumber = Unknown
type = Trust

the rest of the default values for the extra arguments are type-dependent. however, BNT-other is a special type that can be used to override ALL values for ALL models. it's the override queen 👑💅

Trust

numOfBytesFromUPS = 11
methodOfFlowControl = dtr0rts1
validationSequence = {{5,0},{7,0},{8,0}}
shutdownArguments = {{0,10},n}
frequency = {0.00020997,0.00020928}
loadPercentage = {6.1343,-0.3808,4.3110,0.1811}
batteryPercentage = {5.0000,0.3268,-825.00,4.5639,-835.82}
voltage = {1.9216,-0.0977,0.9545,0.0000}

KP625AP

numOfBytesFromUPS = 16
methodOfFlowControl = dtr0rts1
validationSequence = {{5,0x80},{7,0},{8,0}}
shutdownArguments = {{0,10},n}
frequency = {0.00020997,0.00020928}
loadPercentage = {6.1343,-0.3808,4.3110,0.1811}
batteryPercentage = {5.0000,0.3268,-825.00,4.5639,-835.82}
voltage = {1.9216,-0.0977,0.9545,0.0000}

Egys

numOfBytesFromUPS = 16
methodOfFlowControl = no_flow_control
validationSequence = {{5,0x80},{7,0},{8,0}}
shutdownArguments = {{0,10},n}
frequency = {0.00020997,0.00020928}
loadPercentage = {6.1343,-0.3808,1.3333,0.6667}
batteryPercentage = {5.0000,0.3268,-825.00,2.2105,-355.37}
voltage = {1.9216,-0.0977,0.9545,0.0000}

IMP

numOfBytesFromUPS = 16
methodOfFlowControl = no_flow_control
validationSequence = {{5,0xFF},{7,0},{8,0}}
shutdownArguments = {{1,30},y}

KIN

numOfBytesFromUPS = 16
methodOfFlowControl = no_flow_control
validationSequence = {{11,0x4b},{8,0},{8,0}}
shutdownArguments = {{1,30},y}

BNT

numOfBytesFromUPS = 16
methodOfFlowControl = no_flow_control
validationSequence = {{11,0x42},{8,0},{8,0}}
shutdownArguments = {{1,30},y}

BNT-other

numOfBytesFromUPS = 16
methodOfFlowControl = no_flow_control
validationSequence = {{8,0},{8,0},{8,0}}
shutdownArguments = {{1,30},y}
frequency = {0.00027778,0.0000}
loadPercentage = {1.0000,0.0,1.0000,0.0}
batteryPercentage = {1.0000,0.0000,0.0000,1.0000,0.0000}
voltage = {2.0000,0.0000,2.0000,0.0000}

OPTI

numOfBytesFromUPS = 16
methodOfFlowControl = no_flow_control
validationSequence = {{5,0xFF},{7,0},{8,0}}
shutdownArguments = {{1,30},y}

---

🫶 AUTHORS 🫶

give it up for the legends who built this 🎀:

• Peter Bieringer <pb@bieringer.de>
• Alexey Sidorov <alexsid@altlinux.org>
• Keven L. Ates <atescomp@gmail.com>
• Rouben Tchakhmakhtchian <rouben@rouben.net>

---

🌈 SEE ALSO 🌈

The core driver:

• nutupsdrv(8)

Internet resources:

• The NUT (Network UPS Tools) home page: https://www.networkupstools.org/historic/v2.8.5/

---

and that's the whole page bestie, you ate that reading it fr fr 🔥 this was Network UPS Tools 2.8.5, dated 10/07/2026 — mwah, go forth and monitor your UPS 💜✨