Home | History | Annotate | Line # | Download | only in usb
ums.c revision 1.99.2.1
      1 /*	$NetBSD: ums.c,v 1.99.2.1 2021/04/03 22:28:50 thorpej Exp $	*/
      2 
      3 /*
      4  * Copyright (c) 1998, 2017 The NetBSD Foundation, Inc.
      5  * All rights reserved.
      6  *
      7  * This code is derived from software contributed to The NetBSD Foundation
      8  * by Lennart Augustsson (lennart (at) augustsson.net) at
      9  * Carlstedt Research & Technology.
     10  *
     11  * Redistribution and use in source and binary forms, with or without
     12  * modification, are permitted provided that the following conditions
     13  * are met:
     14  * 1. Redistributions of source code must retain the above copyright
     15  *    notice, this list of conditions and the following disclaimer.
     16  * 2. Redistributions in binary form must reproduce the above copyright
     17  *    notice, this list of conditions and the following disclaimer in the
     18  *    documentation and/or other materials provided with the distribution.
     19  *
     20  * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
     21  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
     22  * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
     23  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
     24  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
     25  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
     26  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
     27  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
     28  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
     29  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
     30  * POSSIBILITY OF SUCH DAMAGE.
     31  */
     32 
     33 /*
     34  * HID spec: http://www.usb.org/developers/devclass_docs/HID1_11.pdf
     35  */
     36 
     37 #include <sys/cdefs.h>
     38 __KERNEL_RCSID(0, "$NetBSD: ums.c,v 1.99.2.1 2021/04/03 22:28:50 thorpej Exp $");
     39 
     40 #ifdef _KERNEL_OPT
     41 #include "opt_usb.h"
     42 #endif
     43 
     44 #include <sys/param.h>
     45 #include <sys/systm.h>
     46 #include <sys/kernel.h>
     47 #include <sys/device.h>
     48 #include <sys/ioctl.h>
     49 #include <sys/file.h>
     50 #include <sys/select.h>
     51 #include <sys/proc.h>
     52 #include <sys/vnode.h>
     53 #include <sys/poll.h>
     54 
     55 #include <dev/usb/usb.h>
     56 #include <dev/usb/usbhid.h>
     57 
     58 #include <dev/usb/usbdi.h>
     59 #include <dev/usb/usbdi_util.h>
     60 #include <dev/usb/usbdevs.h>
     61 #include <dev/usb/usb_quirks.h>
     62 #include <dev/usb/uhidev.h>
     63 #include <dev/hid/hid.h>
     64 #include <dev/hid/hidms.h>
     65 
     66 #ifdef UMS_DEBUG
     67 #define DPRINTF(x)	if (umsdebug) printf x
     68 #define DPRINTFN(n,x)	if (umsdebug>(n)) printf x
     69 int	umsdebug = 0;
     70 #else
     71 #define DPRINTF(x)
     72 #define DPRINTFN(n,x)
     73 #endif
     74 
     75 #define UMSUNIT(s)	(minor(s))
     76 
     77 struct ums_softc {
     78 	struct uhidev sc_hdev;
     79 	struct hidms sc_ms;
     80 
     81 	bool	sc_alwayson;
     82 
     83 	int	sc_enabled;
     84 	char	sc_dying;
     85 };
     86 
     87 Static void ums_intr(struct uhidev *, void *, u_int);
     88 
     89 Static int	ums_enable(void *);
     90 Static void	ums_disable(void *);
     91 Static int	ums_ioctl(void *, u_long, void *, int, struct lwp *);
     92 
     93 static const struct wsmouse_accessops ums_accessops = {
     94 	ums_enable,
     95 	ums_ioctl,
     96 	ums_disable,
     97 };
     98 
     99 static int ums_match(device_t, cfdata_t, void *);
    100 static void ums_attach(device_t, device_t, void *);
    101 static void ums_childdet(device_t, device_t);
    102 static int ums_detach(device_t, int);
    103 static int ums_activate(device_t, enum devact);
    104 
    105 CFATTACH_DECL2_NEW(ums, sizeof(struct ums_softc), ums_match, ums_attach,
    106     ums_detach, ums_activate, NULL, ums_childdet);
    107 
    108 static int
    109 ums_match(device_t parent, cfdata_t match, void *aux)
    110 {
    111 	struct uhidev_attach_arg *uha = aux;
    112 	int size;
    113 	void *desc;
    114 
    115 	/*
    116 	 * Some (older) Griffin PowerMate knobs may masquerade as a
    117 	 * mouse, avoid treating them as such, they have only one axis.
    118 	 */
    119 	if (uha->uiaa->uiaa_vendor == USB_VENDOR_GRIFFIN &&
    120 	    uha->uiaa->uiaa_product == USB_PRODUCT_GRIFFIN_POWERMATE)
    121 		return UMATCH_NONE;
    122 
    123 	uhidev_get_report_desc(uha->parent, &desc, &size);
    124 	if (!hid_is_collection(desc, size, uha->reportid,
    125 			       HID_USAGE2(HUP_GENERIC_DESKTOP, HUG_MOUSE)) &&
    126 	    !hid_is_collection(desc, size, uha->reportid,
    127 			       HID_USAGE2(HUP_GENERIC_DESKTOP, HUG_POINTER)) &&
    128 	    !hid_is_collection(desc, size, uha->reportid,
    129 			       HID_USAGE2(HUP_DIGITIZERS, 0x0002)))
    130 		return UMATCH_NONE;
    131 
    132 	return UMATCH_IFACECLASS;
    133 }
    134 
    135 static void
    136 ums_attach(device_t parent, device_t self, void *aux)
    137 {
    138 	struct ums_softc *sc = device_private(self);
    139 	struct uhidev_attach_arg *uha = aux;
    140 	struct hid_data *d;
    141 	struct hid_item item;
    142 	int size, error;
    143 	void *desc;
    144 	uint32_t quirks;
    145 
    146 	aprint_naive("\n");
    147 
    148 	sc->sc_hdev.sc_dev = self;
    149 	sc->sc_hdev.sc_intr = ums_intr;
    150 	sc->sc_hdev.sc_parent = uha->parent;
    151 	sc->sc_hdev.sc_report_id = uha->reportid;
    152 
    153 	quirks = usbd_get_quirks(uha->parent->sc_udev)->uq_flags;
    154 	if (quirks & UQ_MS_REVZ)
    155 		sc->sc_ms.flags |= HIDMS_REVZ;
    156 	if (quirks & UQ_SPUR_BUT_UP)
    157 		sc->sc_ms.flags |= HIDMS_SPUR_BUT_UP;
    158 
    159 	if (!pmf_device_register(self, NULL, NULL))
    160 		aprint_error_dev(self, "couldn't establish power handler\n");
    161 
    162 	uhidev_get_report_desc(uha->parent, &desc, &size);
    163 
    164 	if (!hidms_setup(self, &sc->sc_ms, uha->reportid, desc, size))
    165 		return;
    166 
    167 	if (uha->uiaa->uiaa_vendor == USB_VENDOR_MICROSOFT) {
    168 		int fixpos;
    169 		int woffset = 8;
    170 		/*
    171 		 * The Microsoft Wireless Laser Mouse 6000 v2.0 and the
    172 		 * Microsoft Comfort Mouse 2.0 report a bad position for
    173 		 * the wheel and wheel tilt controls -- should be in bytes
    174 		 * 3 & 4 of the report. Fix this if necessary.
    175 		 */
    176 		switch (uha->uiaa->uiaa_product) {
    177 		case USB_PRODUCT_MICROSOFT_24GHZ_XCVR10:
    178 		case USB_PRODUCT_MICROSOFT_24GHZ_XCVR20:
    179 		case USB_PRODUCT_MICROSOFT_NATURAL_6000:
    180 			fixpos = 24;
    181 			break;
    182 		case USB_PRODUCT_MICROSOFT_24GHZ_XCVR80:
    183 			fixpos = 40;
    184 			woffset = sc->sc_ms.hidms_loc_z.size;
    185 			break;
    186 		case USB_PRODUCT_MICROSOFT_CM6000:
    187 			fixpos = 40;
    188 			break;
    189 		default:
    190 			fixpos = 0;
    191 			break;
    192 		}
    193 		if (fixpos) {
    194 			if ((sc->sc_ms.flags & HIDMS_Z) &&
    195 			    sc->sc_ms.hidms_loc_z.pos == 0)
    196 				sc->sc_ms.hidms_loc_z.pos = fixpos;
    197 			if ((sc->sc_ms.flags & HIDMS_W) &&
    198 			    sc->sc_ms.hidms_loc_w.pos == 0)
    199 				sc->sc_ms.hidms_loc_w.pos =
    200 				    sc->sc_ms.hidms_loc_z.pos + woffset;
    201 		}
    202 	}
    203 
    204 	if (uha->uiaa->uiaa_vendor == USB_VENDOR_HAILUCK &&
    205 	    uha->uiaa->uiaa_product == USB_PRODUCT_HAILUCK_KEYBOARD) {
    206 		/*
    207 		 * The HAILUCK USB Keyboard has a built-in touchpad, which
    208 		 * needs to be active for the keyboard to function properly.
    209 		 */
    210 		sc->sc_alwayson = true;
    211 	}
    212 
    213 	if (uha->uiaa->uiaa_vendor == USB_VENDOR_CHICONY &&
    214 	    uha->uiaa->uiaa_product == USB_PRODUCT_CHICONY_OPTMOUSE0939) {
    215 		/*
    216 		 * This cheap mouse will disconnect after 60 seconds,
    217 		 * reconnect, and then disconnect again (ad nauseum)
    218 		 * unless it's kept open.
    219 		 */
    220 		sc->sc_alwayson = true;
    221 	}
    222 
    223 	tpcalib_init(&sc->sc_ms.sc_tpcalib);
    224 
    225 	/* calibrate the pointer if it reports absolute events */
    226 	if (sc->sc_ms.flags & HIDMS_ABS) {
    227 		memset(&sc->sc_ms.sc_calibcoords, 0, sizeof(sc->sc_ms.sc_calibcoords));
    228 		sc->sc_ms.sc_calibcoords.maxx = 0;
    229 		sc->sc_ms.sc_calibcoords.maxy = 0;
    230 		sc->sc_ms.sc_calibcoords.samplelen = WSMOUSE_CALIBCOORDS_RESET;
    231 		d = hid_start_parse(desc, size, hid_input);
    232 		if (d != NULL) {
    233 			while (hid_get_item(d, &item)) {
    234 				if (item.kind != hid_input
    235 				    || HID_GET_USAGE_PAGE(item.usage) != HUP_GENERIC_DESKTOP
    236 				    || item.report_ID != sc->sc_hdev.sc_report_id)
    237 					continue;
    238 				if (HID_GET_USAGE(item.usage) == HUG_X) {
    239 					sc->sc_ms.sc_calibcoords.minx = item.logical_minimum;
    240 					sc->sc_ms.sc_calibcoords.maxx = item.logical_maximum;
    241 				}
    242 				if (HID_GET_USAGE(item.usage) == HUG_Y) {
    243 					sc->sc_ms.sc_calibcoords.miny = item.logical_minimum;
    244 					sc->sc_ms.sc_calibcoords.maxy = item.logical_maximum;
    245 				}
    246 			}
    247 			hid_end_parse(d);
    248 		}
    249         	tpcalib_ioctl(&sc->sc_ms.sc_tpcalib, WSMOUSEIO_SCALIBCOORDS,
    250         	    (void *)&sc->sc_ms.sc_calibcoords, 0, 0);
    251 	}
    252 
    253 	hidms_attach(self, &sc->sc_ms, &ums_accessops);
    254 
    255 	if (sc->sc_alwayson) {
    256 		error = uhidev_open(&sc->sc_hdev);
    257 		if (error != 0) {
    258 			aprint_error_dev(self,
    259 			    "WARNING: couldn't open always-on device\n");
    260 			sc->sc_alwayson = false;
    261 		}
    262 	}
    263 }
    264 
    265 static int
    266 ums_activate(device_t self, enum devact act)
    267 {
    268 	struct ums_softc *sc = device_private(self);
    269 
    270 	switch (act) {
    271 	case DVACT_DEACTIVATE:
    272 		sc->sc_dying = 1;
    273 		return 0;
    274 	default:
    275 		return EOPNOTSUPP;
    276 	}
    277 }
    278 
    279 static void
    280 ums_childdet(device_t self, device_t child)
    281 {
    282 	struct ums_softc *sc = device_private(self);
    283 
    284 	KASSERT(sc->sc_ms.hidms_wsmousedev == child);
    285 	sc->sc_ms.hidms_wsmousedev = NULL;
    286 }
    287 
    288 static int
    289 ums_detach(device_t self, int flags)
    290 {
    291 	struct ums_softc *sc = device_private(self);
    292 	int rv = 0;
    293 
    294 	DPRINTF(("ums_detach: sc=%p flags=%d\n", sc, flags));
    295 
    296 	if (sc->sc_alwayson)
    297 		uhidev_close(&sc->sc_hdev);
    298 
    299 	/* No need to do reference counting of ums, wsmouse has all the goo. */
    300 	if (sc->sc_ms.hidms_wsmousedev != NULL)
    301 		rv = config_detach(sc->sc_ms.hidms_wsmousedev, flags);
    302 
    303 	pmf_device_deregister(self);
    304 
    305 	return rv;
    306 }
    307 
    308 Static void
    309 ums_intr(struct uhidev *addr, void *ibuf, u_int len)
    310 {
    311 	struct ums_softc *sc = (struct ums_softc *)addr;
    312 
    313 	if (sc->sc_enabled)
    314 		hidms_intr(&sc->sc_ms, ibuf, len);
    315 }
    316 
    317 Static int
    318 ums_enable(void *v)
    319 {
    320 	struct ums_softc *sc = v;
    321 	int error = 0;
    322 
    323 	DPRINTFN(1,("ums_enable: sc=%p\n", sc));
    324 
    325 	if (sc->sc_dying)
    326 		return EIO;
    327 
    328 	if (sc->sc_enabled)
    329 		return EBUSY;
    330 
    331 	sc->sc_enabled = 1;
    332 	sc->sc_ms.hidms_buttons = 0;
    333 
    334 	if (!sc->sc_alwayson) {
    335 		error = uhidev_open(&sc->sc_hdev);
    336 		if (error)
    337 			sc->sc_enabled = 0;
    338 	}
    339 
    340 	return error;
    341 }
    342 
    343 Static void
    344 ums_disable(void *v)
    345 {
    346 	struct ums_softc *sc = v;
    347 
    348 	DPRINTFN(1,("ums_disable: sc=%p\n", sc));
    349 #ifdef DIAGNOSTIC
    350 	if (!sc->sc_enabled) {
    351 		printf("ums_disable: not enabled\n");
    352 		return;
    353 	}
    354 #endif
    355 
    356 	if (sc->sc_enabled) {
    357 		sc->sc_enabled = 0;
    358 		if (!sc->sc_alwayson)
    359 			uhidev_close(&sc->sc_hdev);
    360 	}
    361 }
    362 
    363 Static int
    364 ums_ioctl(void *v, u_long cmd, void *data, int flag,
    365     struct lwp *l)
    366 
    367 {
    368 	struct ums_softc *sc = v;
    369 	int error;
    370 
    371 	if (sc->sc_ms.flags & HIDMS_ABS) {
    372 		error = tpcalib_ioctl(&sc->sc_ms.sc_tpcalib, cmd, data,
    373 		    flag, l);
    374 		if (error != EPASSTHROUGH)
    375 			return error;
    376 	}
    377 
    378 	switch (cmd) {
    379 	case WSMOUSEIO_GTYPE:
    380 		if (sc->sc_ms.flags & HIDMS_ABS)
    381 			*(u_int *)data = WSMOUSE_TYPE_TPANEL;
    382 		else
    383 			*(u_int *)data = WSMOUSE_TYPE_USB;
    384 		return 0;
    385 	}
    386 
    387 	return EPASSTHROUGH;
    388 }
    389