RICHCOMM_USB(8)

📦
version 2.8.5 · 18 versions
, in fedora 43, fedora 44

💖 RICHCOMM_USB 💖

okay bestie, gather round, because we're about to talk about richcomm_usb — that's the driver (it lives in section 8 of the manual, the NUT Manual, and the page header literally reads RICHCOMM_USB(8)) that handles UPS equipment using the Richcomm dry-contact to USB solution. yes, the name is a mouthful. no, we're not changing it. it's iconic. 🎀

✨ NAME ✨

richcomm_usb — the driver for UPS equipment that talks through the Richcomm dry-contact to USB solution. 💅

🦋 SYNOPSIS 🦋

richcomm_usb -h

richcomm_usb -a UPS_NAME [OPTIONS]
note (and it's an important one, bestie): this man page only documents the specific features of the richcomm_usb driver. for all the core driver tea, you gotta go read nutupsdrv(8). 🫶

🌸 SUPPORTED HARDWARE 🌸

so here's the vibe: the Richcomm dry-contact to USB solution is a generic interface — like, it's the glow-up adapter that takes an existing (RS-232) contact closure UPS interface and makes it USB. periodt. 💫

but — and this is the part where I hold your hand — because it's still a contact closure interface underneath, all the limitations of the underlying contact closure interface apply. it's giving "you get what you get." 😭

which means: the only essentials you're getting in ups.status are:

  • OL
  • OB
  • LB

that's it. that's the whole menu. also go see genericups(8) for the full picture. ✨

💀 BUGS 💀

ngl, there's some stuff you need to know, and I'm not gonna sugarcoat it:

  • most contact-closure UPSes will not power down the load if the line power is present. fr fr. and that can create a race when you're using secondary upsmon(8) systems. 👀 head to the upsmon(8) man page for more on that.
  • the solution to both of these problems is to upgrade to a smart protocol UPS of some kind — one that allows detection and proper load cycling on command. that's the move. that's the main character energy you deserve. 👑

👑 AUTHORS 👑

the legends who made this happen:

  • Peter van Valderen <p.v.valderen at probu.nl>
  • Dirk Teurlings <dirk at upexia.nl>

🌈 SEE ALSO 🌈

🧚 The core driver:

🍓 The generic serial driver:

⭐ Internet resources:

okay that's the whole page, you ate it, I'm obsessed. 💖 this was the Network UPS Tools 2.8.5 era of the manual, dated 10/07/2026, and the page itself signs off as RICHCOMM_USB(8) — slay, bye bestie! 🎀✨🦋

📦 where this page comes from