Skip to content

Commit

Permalink
docs/man/usbhid-ups.txt: document troubleshooting Linux USB quirk vs.…
Browse files Browse the repository at this point in the history
… Eaton devices [#630]

Signed-off-by: Jim Klimov <[email protected]>
  • Loading branch information
jimklimov committed Sep 24, 2024
1 parent 79623e6 commit 78e0525
Showing 1 changed file with 9 additions and 0 deletions.
9 changes: 9 additions & 0 deletions docs/man/usbhid-ups.txt
Original file line number Diff line number Diff line change
Expand Up @@ -307,6 +307,15 @@ value (such as 10 seconds). This should solve the issue.
Note that if you increase "pollinterval" beyond 10 or 15 seconds, you might
also want to increase "pollfreq" by the same factor.

With certain devices and operating systems, notably MGE/Eaton USB Vendor ID
(`0x0463`) on some versions of the Linux kernel, you might encounter poor
interaction with the "USB HID quirk" mechanism, which precludes Linux from
seeing the device as a `hid-generic` first, to hand it over to a NUT driver
later. For more details, see the NUT FAQ document. This particular quirk can
be tuned with a kernel boot parameter (via GRUB etc.):

usbhid.quirks=0x0463:0xffff:0x08

Got EPERM: Operation not permitted upon driver startup
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Expand Down

0 comments on commit 78e0525

Please sign in to comment.