APCSMART-OLD(8)
β¨ APCSMART-OLD(8) β¨
okay bestie, so this is a page from the NUT Manual (Network UPS Tools, the whole shebang) and it's all about apcsmart-old β the driver that talks to American Power Conversion Smart Protocol UPS equipment. yes, the big beige bricks that keep your homelab alive. π
πΈ NAME πΈ
apcsmart-old β driver for American Power Conversion Smart Protocol UPS equipment. it's giving "your UPS, but make it vintage." π
π SYNOPSIS π
apcsmart-old -h
apcsmart-old -a UPS_NAME [OPTIONS]
heads up, bestie: this man page only spills the tea on the hardware-specific stuff for theapcsmart-olddriver. for the core driver deets β the general stuff that every driver shares β go readnutupsdrv(8). π«Ά
π¦ SUPPORTED HARDWARE π¦
apcsmart-old should recognize all recent APC models that use a serial protocol at 2400 bps. lowkey iconic speed, i know. that's mainly the Smart-UPS, Matrix-UPS and Back-UPS Pro lines. π
the driver attempts to support every bell and whistle of the APC reporting interface β whether or not this is strictly sensible. and honestly? respect. it's giving overachiever energy. β¨
some older hardware may only report a handful of variables. that's usually not a bug β they just don't support anything else, bestie. it's not them being lazy, it's them being old. π§
π CABLING π
by default, this driver expects to see a 940-0024C cable, or a clone of one. periodt. π
you can switch over to the 940-0095B dual-mode cable support with the cable= definition described below (it's in EXTRA ARGUMENTS, keep scrolling bestie). π
if your 940-0024C cable is broken or missing (rip π), use this diagram to build a clone:
https://www.networkupstools.org/cables/940-0024C.jpg
diagram said "build your own." crafty queen behavior. π οΈ
π EXTRA ARGUMENTS π
this driver supports the following optional settings in the ups.conf(5):
cable=940-0095Bβ configure the serial port for the APC940-0095Bdual-mode cable. that's it, that's the setting. β¨sdtype=numβ use shutdown type num, according to this table:0β soft shutdown or powerdown, depending on battery status1β soft shutdown followed by powerdown2β instant power off3β power off with grace period4β "force OB" hack method for CS 350
okay so the vibes of these modes matter, so listen up:
modes 0 and 1 will power up the load when power returns. π modes 2 and 3 will keep the load turned off when the power returns. π so like, pick wisely, because one of these is "welcome back bb" and the other is "we're not doing that again."
mode 4 exploits an oddity in the CS 350 models, since they only seem to support the S command β but then only when running on battery. as a result, the driver will force the UPS to go on battery if necessary before sending the shutdown command. this ensures that the load gets reset. it's a whole hack, no cap, and it's working. π₯
π BUGS π
some older APC UPS models return bogus data in the status register during a front panel test. this is usually detected and discarded, but some other unexpected values have occasionally slipped through. π not me trusting a status register that lies during tests, i guess.
APC UPS models with both USB and serial ports require a power cycle when switching from USB communication to serial β and perhaps vice versa. so yeah, unplug and plug it back in, bestie. that's the fix. that's always the fix. π
π AUTHORS AND HISTORY π
Nigel Metheringham <Nigel.Metheringham@Intechnology.co.uk> β drawing heavily on the original apcsmart driver by Russell Kroll. shoutout to the OGs, fr fr. π«Ά
this driver was called newapc for a time, and was renamed in the 1.5 series. glow-up era. β¨
in 2.6.2 the driver was renamed to apcsmart-old, being superseded by an updated version with new features which currently holds the apcsmart name. so yes, this one is literally the old one β the name is not subtle, and honestly? we love a driver that knows what it is. π
β SEE ALSO β
The core driver:
Internet resources:
- The NUT (Network UPS Tools) home page:
https://www.networkupstools.org/historic/v2.8.5/
and that's the whole page, bestie!! π this was Network UPS Tools 2.8.5, dated 10/07/2026, and it lives at APCSMART-OLD(8) in the NUT Manual β old name, immaculate vibes, still out here shutting down UPSes with grace periods. slay. πΈππ¦
π¦ 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