MICROSOL-APC(8)

💖 MICROSOL-APC 💖

okay bestie, gather round, because this is microsol-apc, the driver for APC Back-UPS BR UPS equipment, and it lives in section 8 of the NUT Manual. she's niche, she's specific, and she knows exactly what she's about. let's get into it 🎀

---

✨ NAME ✨

microsol-apc — the driver that talks to APC Back-UPS BR UPS equipment. yes, that's her whole job and she does it beautifully 💅

---

✨ SYNOPSIS ✨

microsol-apc -a UPS_NAME [OPTIONS]

📌 real talk: this page only covers the hardware-specific stuff for the microsol-apc driver. the core driver lore? that's in nutupsdrv(8), go read her too 🫶

---

✨ SUPPORTED HARDWARE ✨

she's picky (as she should be 👑). here's the UPS models she supports:

• APC Back-UPS BZ1500-BR
• APC Back-UPS BZ2200I-BR
• APC Back-UPS BZ2200BI-BR

now for the lore drop 🍓: back in 2009, Schneider Electric acquired Microsol Technologies, and by 2012 the entire Microsol line was being sold under the APC brand. so this driver is the one holding it down for these newer, APC-branded models. got older equipment? no problem, that's solis(8)'s moment ✨

---

✨ EXTRA ARGUMENTS ✨

these are the extra optional settings she takes in ups.conf(5). lowkey important, highkey useful:

• battext=n — Default = 0, no extra battery, where n = Ampere*hour. 🔋
• prgshut=n — Default = 0, no programmable shutdown; set it to 1 to enable one.

---

✨ COMMANDS ✨

the two things you can ask her to do, and she does them on a schedule:

• shutdown.return — Shut down in .3 minutes and restart in .3 minutes after that. she leaves, she comes back, it's giving healthy relationship 💖
• shutdown.stayoff — Shut down in .3 minutes and do not return. she's gone, gone. periodt 💀

---

✨ ISSUES ✨

okay so listen, this part matters 😭

for other APC-Microsol models, the reported voltages, currents and power will be incorrect, because the communication protocol reports unprocessed data instead of real values — it needs model-specific post-processing by the driver to make sense of any of it. monitoring of UPS state (on-battery/on-line, critical battery) should work for other models, but bestie, it is untested. no cap. don't come for her if it's weird 🙈

---

✨ AUTHORS ✨

the icons who made this happen 👑✨

• Ygor A. S. Regados <ygorre@tutanota.com>
• Roberto P. Velloso <rvelloso@gmail.com>
• Silvino B. Magalhães <sbm2yk@gmail.com>

---

✨ SEE ALSO ✨

🌸 The core driver:

• nutupsdrv(8)

🌸 Driver for older devices under same brand:

• solis(8)

🌸 Internet resources:

The NUT (Network UPS Tools) home page:

• https://www.networkupstools.org/historic/v2.8.5/

---

and that's the whole vibe check, bestie 🦋 this was Network UPS Tools 2.8.5, dated 10/07/2026 — go forth, monitor your UPS, and slay 💅💜