Ahoi OpenBSD,
My trackball reports two out of its four buttons in a non-standard way.
I've patched my kernel with a new USB quirk for this situation. [*]
I'd like to contribute this if you want it; please let me know if this
is the way to do it or if you'd like any changes.
--pesco
(sending from off-list)
[*] The buttons appear in the HID descriptor like normal, except with
their "usage" set to a vendor-reserved page. The quirk makes the driver
treat this page like the standard button page.
Index: sys/dev/usb/ums.c
===================================================================
RCS file: /cvs/src/sys/dev/usb/ums.c,v
retrieving revision 1.43
diff -u -p -r1.43 ums.c
--- sys/dev/usb/ums.c 12 Jan 2016 19:16:21 -0000 1.43
+++ sys/dev/usb/ums.c 20 Sep 2016 19:21:54 -0000
@@ -143,6 +143,8 @@ ums_attach(struct device *parent, struct
qflags |= HIDMS_MS_BAD_CLASS;
if (quirks & UQ_MS_LEADING_BYTE)
qflags |= HIDMS_LEADINGBYTE;
+ if (quirks & UQ_MS_VENDOR_BUTTONS)
+ qflags |= HIDMS_VENDOR_BUTTONS;
if (hidms_setup(self, ms, qflags, uha->reportid, desc, size) != 0)
return;
Index: sys/dev/usb/usb_quirks.c
===================================================================
RCS file: /cvs/src/sys/dev/usb/usb_quirks.c,v
retrieving revision 1.74
diff -u -p -r1.74 usb_quirks.c
--- sys/dev/usb/usb_quirks.c 27 Nov 2015 10:59:32 -0000 1.74
+++ sys/dev/usb/usb_quirks.c 20 Sep 2016 19:21:54 -0000
@@ -150,6 +150,9 @@ const struct usbd_quirk_entry {
{ USB_VENDOR_MICROSOFT, USB_PRODUCT_MICROSOFT_WLNOTEBOOK2,
ANY, { UQ_MS_BAD_CLASS | UQ_MS_LEADING_BYTE }},
+ { USB_VENDOR_KENSINGTON, USB_PRODUCT_KENSINGTON_SLIMBLADE,
+ ANY, { UQ_MS_VENDOR_BUTTONS }},
+
{ 0, 0, 0, { 0 } }
};
Index: sys/dev/usb/usb_quirks.h
===================================================================
RCS file: /cvs/src/sys/dev/usb/usb_quirks.h,v
retrieving revision 1.16
diff -u -p -r1.16 usb_quirks.h
--- sys/dev/usb/usb_quirks.h 19 Jul 2010 05:08:37 -0000 1.16
+++ sys/dev/usb/usb_quirks.h 20 Sep 2016 19:21:55 -0000
@@ -49,6 +49,8 @@ struct usbd_quirks {
#define UQ_MS_LEADING_BYTE 0x00010000 /* mouse sends unknown leading byte */
#define UQ_EHCI_NEEDTO_DISOWN 0x00020000 /* must hand device over to USB 1.1
if attached to EHCI */
+#define UQ_MS_VENDOR_BUTTONS 0x00040000 /* mouse reports extra buttons in
+ vendor page */
};
extern const struct usbd_quirks usbd_no_quirk;
Index: sys/dev/usb/usbdevs
===================================================================
RCS file: /cvs/src/sys/dev/usb/usbdevs,v
retrieving revision 1.668
diff -u -p -r1.668 usbdevs
--- sys/dev/usb/usbdevs 12 Sep 2016 07:55:33 -0000 1.668
+++ sys/dev/usb/usbdevs 20 Sep 2016 19:21:55 -0000
@@ -2397,6 +2397,7 @@ product KENSINGTON TURBOBALL 0x1005 Turb
product KENSINGTON ORBIT_MAC 0x1009 Orbit trackball for Mac
product KENSINGTON BT_EDR 0x105e Bluetooth
product KENSINGTON VIDEOCAM_VGA 0x5002 VideoCAM VGA
+product KENSINGTON SLIMBLADE 0x2041 Slimblade Trackball
/* Keyspan products */
product KEYSPAN USA28_NF 0x0101 USA-28 serial
Index: sys/dev/usb/usbdevs.h
===================================================================
RCS file: /cvs/src/sys/dev/usb/usbdevs.h,v
retrieving revision 1.680
diff -u -p -r1.680 usbdevs.h
--- sys/dev/usb/usbdevs.h 12 Sep 2016 07:56:29 -0000 1.680
+++ sys/dev/usb/usbdevs.h 20 Sep 2016 19:21:56 -0000
@@ -2404,6 +2404,7 @@
#define USB_PRODUCT_KENSINGTON_ORBIT_MAC 0x1009 /* Orbit trackball for Mac */
#define USB_PRODUCT_KENSINGTON_BT_EDR 0x105e /* Bluetooth */
#define USB_PRODUCT_KENSINGTON_VIDEOCAM_VGA 0x5002 /* VideoCAM VGA */
+#define USB_PRODUCT_KENSINGTON_SLIMBLADE 0x2041 /* Slimblade Trackball */
/* Keyspan products */
#define USB_PRODUCT_KEYSPAN_USA28_NF 0x0101 /* USA-28 serial */
Index: sys/dev/usb/usbdevs_data.h
===================================================================
RCS file: /cvs/src/sys/dev/usb/usbdevs_data.h,v
retrieving revision 1.674
diff -u -p -r1.674 usbdevs_data.h
--- sys/dev/usb/usbdevs_data.h 12 Sep 2016 07:56:29 -0000 1.674
+++ sys/dev/usb/usbdevs_data.h 20 Sep 2016 19:21:58 -0000
@@ -5166,6 +5166,10 @@ const struct usb_known_product usb_known
"VideoCAM VGA",
},
{
+ USB_VENDOR_KENSINGTON, USB_PRODUCT_KENSINGTON_SLIMBLADE,
+ "Slimblade Trackball",
+ },
+ {
USB_VENDOR_KEYSPAN, USB_PRODUCT_KEYSPAN_USA28_NF,
"USA-28 serial",
},
Index: sys/dev/hid/hidms.c
===================================================================
RCS file: /cvs/src/sys/dev/hid/hidms.c,v
retrieving revision 1.3
diff -u -p -r1.3 hidms.c
--- sys/dev/hid/hidms.c 22 May 2016 22:06:11 -0000 1.3
+++ sys/dev/hid/hidms.c 20 Sep 2016 19:22:44 -0000
@@ -191,6 +191,21 @@ hidms_setup(struct device *self, struct
break;
ms->sc_num_buttons = i - 1;
+ /*
+ * The Kensington Slimblade reports some of its buttons as binary
+ * inputs in the first vendor usage page (0xff00). Add such inputs
+ * as buttons if the device has this quirk.
+ */
+ if (ms->sc_flags & HIDMS_VENDOR_BUTTONS) {
+ const int b = ms->sc_num_buttons;
+ for (i = 1; b + i <= MAX_BUTTONS; i++)
+ if (!hid_locate(desc, dlen,
+ HID_USAGE2(HUP_MICROSOFT, i),
+ id, hid_input, &ms->sc_loc_btn[b + i - 1], NULL))
+ break;
+ ms->sc_num_buttons += i;
+ }
+
if (hid_locate(desc, dlen, HID_USAGE2(HUP_DIGITIZERS,
HUD_TIP_SWITCH), id, hid_input,
&ms->sc_loc_btn[ms->sc_num_buttons], NULL)){
Index: sys/dev/hid/hidmsvar.h
===================================================================
RCS file: /cvs/src/sys/dev/hid/hidmsvar.h,v
retrieving revision 1.1
diff -u -p -r1.1 hidmsvar.h
--- sys/dev/hid/hidmsvar.h 8 Jan 2016 15:54:13 -0000 1.1
+++ sys/dev/hid/hidmsvar.h 20 Sep 2016 19:22:44 -0000
@@ -43,18 +43,19 @@ struct tsscale {
struct hidms {
int sc_enabled;
int sc_flags; /* device configuration */
-#define HIDMS_SPUR_BUT_UP 0x001 /* spurious button up events */
-#define HIDMS_Z 0x002 /* Z direction available */
-#define HIDMS_REVZ 0x004 /* Z-axis is reversed */
-#define HIDMS_W 0x008 /* W direction available */
-#define HIDMS_REVW 0x010 /* W-axis is reversed */
-#define HIDMS_LEADINGBYTE 0x020 /* Unknown leading byte */
-#define HIDMS_ABSX 0x040 /* X-axis is absolute */
-#define HIDMS_ABSY 0x080 /* Y-axis is absolute */
-#define HIDMS_TIP 0x100 /* Tip switch on a digitiser pen */
-#define HIDMS_BARREL 0x200 /* Barrel switch on a digitiser pen */
-#define HIDMS_ERASER 0x400 /* Eraser switch on a digitiser pen */
-#define HIDMS_MS_BAD_CLASS 0x800 /* Mouse doesn't identify properly */
+#define HIDMS_SPUR_BUT_UP 0x0001 /* spurious button up events */
+#define HIDMS_Z 0x0002 /* Z direction available */
+#define HIDMS_REVZ 0x0004 /* Z-axis is reversed */
+#define HIDMS_W 0x0008 /* W direction available */
+#define HIDMS_REVW 0x0010 /* W-axis is reversed */
+#define HIDMS_LEADINGBYTE 0x0020 /* Unknown leading byte */
+#define HIDMS_ABSX 0x0040 /* X-axis is absolute */
+#define HIDMS_ABSY 0x0080 /* Y-axis is absolute */
+#define HIDMS_TIP 0x0100 /* Tip switch on a digitiser pen */
+#define HIDMS_BARREL 0x0200 /* Barrel switch on a digitiser pen */
+#define HIDMS_ERASER 0x0400 /* Eraser switch on a digitiser pen */
+#define HIDMS_MS_BAD_CLASS 0x0800 /* Mouse doesn't identify properly */
+#define HIDMS_VENDOR_BUTTONS 0x1000 /* extra buttons in vendor page */
int sc_num_buttons;
u_int32_t sc_buttons; /* mouse button status */