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 the apcsmart-old driver. for the core driver deets β€” the general stuff that every driver shares β€” go read nutupsdrv(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 APC 940-0095B dual-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 status
    • 1 β€” soft shutdown followed by powerdown
    • 2 β€” instant power off
    • 3 β€” power off with grace period
    • 4 β€” "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