Skip to content

apc-hid: map shutdown.return for APC Back-UPS BX*MI units [#2683] #3566

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
jimklimov merged 2 commits into from
Aug 17, 2026
+21 −1
Merged

apc-hid: map shutdown.return for APC Back-UPS BX*MI units [#2683] #3566

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
baee2b0
apc-hid: map shutdown.return for APC Back-UPS BX*MI units [#2683]
faluc-dev Aug 12, 2026
a917367
Merge branch 'master' into apc-hid-bxmi-shutdown-return
jimklimov Aug 17, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 12 additions & 0 deletions NEWS.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -177,6 +177,18 @@ https://github.com/networkupstools/nut/milestone/13
- `usbhid-ups` driver updates:
* When reconnecting, report success more visibly (not only in debug), and
do not reset driver state to "quiet" when it will loop trying. [PR #3423]
* `apc-hid` subdriver: mapped `shutdown.return` to
`UPS.APCGeneralCollection.APCDelayBeforeReboot` with value "1", for
newer APC Back-UPS devices (e.g. Back-UPS BX750MI) where that usage
is the only shutdown-capable one. Their firmware accepts but never
executes the value "10" written by the previously only matching
command `shutdown.reboot`, so the built-in shutdown sequence reported
success without ever powering the load off. The value "1" is what APC
PowerChute writes (confirmed by decoding USB captures of the vendor
software, and by live tests on another unit): the load is cycled after
a fixed ~2 minute grace, the command is executed only while on battery,
and output returns when wall power is present, even if AC came back
during the grace period. [issue #2683, PR #3566]
* `idowell-hid` subdriver now also supports GoldenMate 1000VA/800W LiFePO4
battery packs (`0x06da:0xffff`), which carry the same `-BMS-` firmware and
HID descriptor as the existing `0x075d:0x0300` device. The shared
Expand Down
3 changes: 2 additions & 1 deletion docs/nut.dict
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
personal_ws-1.1 en 3805 utf-8
personal_ws-1.1 en 3806 utf-8
AAC
AAS
ABI
Expand Down Expand Up @@ -1053,6 +1053,7 @@ PowerPC
PowerPS
PowerPal
PowerPanel
PowerChute
PowerShare
PowerShell
PowerShield
Expand Down
7 changes: 7 additions & 0 deletions drivers/apc-hid.c
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -457,6 +457,13 @@ static hid_info_t apc_hid2nut[] = {
{ "load.on.delay", 0, 0, "UPS.APCGeneralCollection.APCDelayBeforeStartup", NULL, DEFAULT_ONDELAY, HU_TYPE_CMD, NULL },
{ "shutdown.stop", 0, 0, "UPS.APCGeneralCollection.APCDelayBeforeShutdown", NULL, "-1", HU_TYPE_CMD, NULL },
{ "shutdown.reboot", 0, 0, "UPS.APCGeneralCollection.APCDelayBeforeReboot", NULL, "10", HU_TYPE_CMD, NULL },
/* used by APC Back-UPS BX series (e.g. BX750MI), where this usage is the
* only shutdown-capable one: value "1" is what APC PowerChute writes
* (fixed ~2 min grace, executed only while on battery, output returns
* when wall power is present, even if AC came back during the grace);
* the "10" written by shutdown.reboot above is ACKed but never executed
* by that firmware. See issue #2683. */
{ "shutdown.return", 0, 0, "UPS.APCGeneralCollection.APCDelayBeforeReboot", NULL, "1", HU_TYPE_CMD, NULL },
/* used by APC BackUPS CS */
{ "shutdown.return", 0, 0, "UPS.Output.APCDelayBeforeReboot", NULL, "1", HU_TYPE_CMD, NULL },

Expand Down
Loading