Skip to content

Experimental libwinhid backend for usbhid-ups (Windows only) #3335

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

Open
MysteryDove wants to merge 5 commits into
base: master
Choose a base branch
from
+3,258 −7
Open

Experimental libwinhid backend for usbhid-ups (Windows only) #3335

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
32a73d3
init version of POC
MysteryDove Mar 2, 2026
47665d3
Add HidD_GetFeature Data Processing, Padding under certain conditions…
MysteryDove Mar 3, 2026
1bc1c35
typo and indent fix, major enhancement on string descriptor reading
MysteryDove Mar 4, 2026
c775e93
Code Refactor
MysteryDove Mar 4, 2026
ffd6cff
dict fix
MysteryDove Mar 4, 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 docs/man/usbhid-ups.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -129,6 +129,18 @@ If this flag is set, the driver will not use Interrupt In transfers during the
shorter "pollinterval" cycles (not recommended, but needed if these reports
are broken on your UPS).

*experimentalhid*::
If this flag is set on Windows builds, use the experimental native Windows HID
backend instead of libusb.
+
This backend currently follows a read-focused scope. It supports
device discovery and matching by identifiers such as `vendorid` and
`productid`, input/feature reads, and interrupt-report fallback handling.
Feature-report writes are not implemented in this phase, so writable
`setvar`/`instcmd` operations may be unavailable.
+
This option is ignored on non-WIN32 builds.

*interrupt_pipe_no_events_tolerance*='num'::
Set the tolerance for how many times in a row could we have "Got 0 HID objects"
when using USB interrupt mode? This may normally be due to a device having
Expand Down
1 change: 1 addition & 0 deletions docs/nut.dict
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2103,6 +2103,7 @@ executables
executeCommand
execve
expandsize
experimentalhid
extapi
extern
externalConsole
Expand Down
7 changes: 5 additions & 2 deletions drivers/Makefile.am
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -331,6 +331,9 @@ endif WITH_LIBUSB_0_1
if WITH_LIBUSB_1_0
LIBUSB_IMPL = libusb1.c
endif WITH_LIBUSB_1_0
if HAVE_WINDOWS
WINHID_IMPL = libwinhid.c
endif HAVE_WINDOWS
USBHID_UPS_SUBDRIVERS = apc-hid.c arduino-hid.c belkin-hid.c cps-hid.c explore-hid.c \
liebert-hid.c mge-hid.c powercom-hid.c tripplite-hid.c idowell-hid.c \
openups-hid.c powervar-hid.c delta_ups-hid.c ecoflow-hid.c ever-hid.c \
Expand Down Expand Up @@ -526,7 +529,7 @@ dist_noinst_HEADERS = \
bcmxcp_io.h belkin.h belkin-hid.h bestpower-mib.h blazer.h cps-hid.h dstate.h \
dummy-ups.h explore-hid.h failover.h gamatronic.h genericups.h \
generic_gpio_common.h generic_gpio_libgpiod.h \
hidparser.h hidtypes.h ietf-mib.h libhid.h libshut.h nut_libusb.h liebert-hid.h \
hidparser.h hidtypes.h ietf-mib.h libhid.h libshut.h nut_libusb.h libwinhid.h liebert-hid.h \
main.h mge-hid.h mge-mib.h mge-utalk.h \
mge-xml.h microdowell.h microsol-apc.h microsol-common.h netvision-mib.h netxml-ups.h nut-ipmi.h oneac.h \
powercom.h powerpanel.h powerp-bin.h powerp-txt.h powervar_cx.h raritan-pdu-mib.h \
Expand Down Expand Up @@ -574,7 +577,7 @@ libdummy_main_stub_la_SOURCES = main-stub.c
libdummy_serial_la_SOURCES = serial.c
libdummy_upsdrvquery_la_SOURCES = upsdrvquery.c
# Note: no libhid/hidparser here!
libdummy_libusb_la_SOURCES = $(LIBUSB_IMPL) usb-common.c
libdummy_libusb_la_SOURCES = $(LIBUSB_IMPL) $(WINHID_IMPL) usb-common.c

if ENABLE_SHARED_PRIVATE_LIBS
libdummy_serial_la_LIBADD = $(top_builddir)/common/libnutprivate-@NUT_SOURCE_GITREV_SEMVER_UNDERSCORES@-common-all.la
Expand Down
Loading
Loading