xref: /netbsd-src/sys/dev/usb/usb_subr.c (revision 16dce51364ebe8aeafbae46bc5aa167b8115bc45)
1 /*	$NetBSD: usb_subr.c,v 1.223 2017/12/26 18:44:52 khorben Exp $	*/
2 /*	$FreeBSD: src/sys/dev/usb/usb_subr.c,v 1.18 1999/11/17 22:33:47 n_hibma Exp $	*/
3 
4 /*
5  * Copyright (c) 1998, 2004 The NetBSD Foundation, Inc.
6  * All rights reserved.
7  *
8  * This code is derived from software contributed to The NetBSD Foundation
9  * by Lennart Augustsson (lennart@augustsson.net) at
10  * Carlstedt Research & Technology.
11  *
12  * Redistribution and use in source and binary forms, with or without
13  * modification, are permitted provided that the following conditions
14  * are met:
15  * 1. Redistributions of source code must retain the above copyright
16  *    notice, this list of conditions and the following disclaimer.
17  * 2. Redistributions in binary form must reproduce the above copyright
18  *    notice, this list of conditions and the following disclaimer in the
19  *    documentation and/or other materials provided with the distribution.
20  *
21  * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
22  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
23  * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
24  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
25  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
26  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
27  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
28  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
29  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
30  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
31  * POSSIBILITY OF SUCH DAMAGE.
32  */
33 
34 #include <sys/cdefs.h>
35 __KERNEL_RCSID(0, "$NetBSD: usb_subr.c,v 1.223 2017/12/26 18:44:52 khorben Exp $");
36 
37 #ifdef _KERNEL_OPT
38 #include "opt_compat_netbsd.h"
39 #include "opt_usb.h"
40 #include "opt_usbverbose.h"
41 #endif
42 
43 #include <sys/param.h>
44 #include <sys/systm.h>
45 #include <sys/kernel.h>
46 #include <sys/kmem.h>
47 #include <sys/device.h>
48 #include <sys/select.h>
49 #include <sys/proc.h>
50 
51 #include <sys/bus.h>
52 #include <sys/module.h>
53 
54 #include <dev/usb/usb.h>
55 
56 #include <dev/usb/usbdi.h>
57 #include <dev/usb/usbdi_util.h>
58 #include <dev/usb/usbdivar.h>
59 #include <dev/usb/usbdevs.h>
60 #include <dev/usb/usb_quirks.h>
61 #include <dev/usb/usb_verbose.h>
62 #include <dev/usb/usbhist.h>
63 
64 #include "locators.h"
65 
66 #define	DPRINTF(FMT,A,B,C,D)	USBHIST_LOG(usbdebug,FMT,A,B,C,D)
67 #define	DPRINTFN(N,FMT,A,B,C,D)	USBHIST_LOGN(usbdebug,N,FMT,A,B,C,D)
68 
69 Static usbd_status usbd_set_config(struct usbd_device *, int);
70 Static void usbd_devinfo(struct usbd_device *, int, char *, size_t);
71 Static void usbd_devinfo_vp(struct usbd_device *, char *, size_t, char *, size_t,
72     int, int);
73 Static int usbd_getnewaddr(struct usbd_bus *);
74 Static int usbd_print(void *, const char *);
75 Static int usbd_ifprint(void *, const char *);
76 Static void usbd_free_iface_data(struct usbd_device *, int);
77 
78 uint32_t usb_cookie_no = 0;
79 
80 Static const char * const usbd_error_strs[] = {
81 	"NORMAL_COMPLETION",
82 	"IN_PROGRESS",
83 	"PENDING_REQUESTS",
84 	"NOT_STARTED",
85 	"INVAL",
86 	"NOMEM",
87 	"CANCELLED",
88 	"BAD_ADDRESS",
89 	"IN_USE",
90 	"NO_ADDR",
91 	"SET_ADDR_FAILED",
92 	"NO_POWER",
93 	"TOO_DEEP",
94 	"IOERROR",
95 	"NOT_CONFIGURED",
96 	"TIMEOUT",
97 	"SHORT_XFER",
98 	"STALLED",
99 	"INTERRUPTED",
100 	"XXX",
101 };
102 
103 DEV_VERBOSE_DEFINE(usb);
104 
105 const char *
106 usbd_errstr(usbd_status err)
107 {
108 	static char buffer[5];
109 
110 	if (err < USBD_ERROR_MAX) {
111 		return usbd_error_strs[err];
112 	} else {
113 		snprintf(buffer, sizeof(buffer), "%d", err);
114 		return buffer;
115 	}
116 }
117 
118 usbd_status
119 usbd_get_string_desc(struct usbd_device *dev, int sindex, int langid,
120 		     usb_string_descriptor_t *sdesc, int *sizep)
121 {
122 	USBHIST_FUNC(); USBHIST_CALLED(usbdebug);
123 	usb_device_request_t req;
124 	usbd_status err;
125 	int actlen;
126 
127 	req.bmRequestType = UT_READ_DEVICE;
128 	req.bRequest = UR_GET_DESCRIPTOR;
129 	USETW2(req.wValue, UDESC_STRING, sindex);
130 	USETW(req.wIndex, langid);
131 	USETW(req.wLength, 2);	/* only size byte first */
132 	err = usbd_do_request_flags(dev, &req, sdesc, USBD_SHORT_XFER_OK,
133 		&actlen, USBD_DEFAULT_TIMEOUT);
134 	if (err)
135 		return err;
136 
137 	if (actlen < 2)
138 		return USBD_SHORT_XFER;
139 
140 	USETW(req.wLength, sdesc->bLength);	/* the whole string */
141 	err = usbd_do_request_flags(dev, &req, sdesc, USBD_SHORT_XFER_OK,
142 		&actlen, USBD_DEFAULT_TIMEOUT);
143 	if (err)
144 		return err;
145 
146 	if (actlen != sdesc->bLength) {
147 		DPRINTF("expected %jd, got %jd", sdesc->bLength, actlen, 0, 0);
148 	}
149 
150 	*sizep = actlen;
151 	return USBD_NORMAL_COMPLETION;
152 }
153 
154 static void
155 usbd_trim_spaces(char *p)
156 {
157 	char *q, *e;
158 
159 	q = e = p;
160 	while (*q == ' ')		/* skip leading spaces */
161 		q++;
162 	while ((*p = *q++))		/* copy string */
163 		if (*p++ != ' ')	/* remember last non-space */
164 			e = p;
165 	*e = '\0';			/* kill trailing spaces */
166 }
167 
168 static void
169 usbd_get_device_string(struct usbd_device *ud, uByte index, char **buf)
170 {
171 	char *b;
172 	usbd_status err;
173 
174 	b = kmem_alloc(USB_MAX_ENCODED_STRING_LEN, KM_SLEEP);
175 	err = usbd_get_string0(ud, index, b, true);
176 	if (err != USBD_NORMAL_COMPLETION) {
177 		kmem_free(b, USB_MAX_ENCODED_STRING_LEN);
178 		b = NULL;
179 	} else {
180 		usbd_trim_spaces(b);
181 	}
182 
183 	*buf = b;
184 }
185 
186 void
187 usbd_get_device_strings(struct usbd_device *ud)
188 {
189 	usb_device_descriptor_t *udd = &ud->ud_ddesc;
190 
191 	usbd_get_device_string(ud, udd->iManufacturer, &ud->ud_vendor);
192 	usbd_get_device_string(ud, udd->iProduct, &ud->ud_product);
193 	usbd_get_device_string(ud, udd->iSerialNumber, &ud->ud_serial);
194 }
195 
196 
197 Static void
198 usbd_devinfo_vp(struct usbd_device *dev, char *v, size_t vl, char *p,
199     size_t pl, int usedev, int useencoded)
200 {
201 	usb_device_descriptor_t *udd = &dev->ud_ddesc;
202 	if (dev == NULL)
203 		return;
204 
205 	v[0] = p[0] = '\0';
206 
207 	if (usedev) {
208 		if (usbd_get_string0(dev, udd->iManufacturer, v, useencoded) ==
209 		    USBD_NORMAL_COMPLETION)
210 			usbd_trim_spaces(v);
211 		if (usbd_get_string0(dev, udd->iProduct, p, useencoded) ==
212 		    USBD_NORMAL_COMPLETION)
213 			usbd_trim_spaces(p);
214 	} else {
215 		if (dev->ud_vendor) {
216 			strlcpy(v, dev->ud_vendor, vl);
217 		}
218 		if (dev->ud_product) {
219 			strlcpy(p, dev->ud_product, pl);
220 		}
221 	}
222 	if (v[0] == '\0')
223 		usb_findvendor(v, vl, UGETW(udd->idVendor));
224 	if (p[0] == '\0')
225 		usb_findproduct(p, pl, UGETW(udd->idVendor),
226 		    UGETW(udd->idProduct));
227 }
228 
229 int
230 usbd_printBCD(char *cp, size_t l, int bcd)
231 {
232 	return snprintf(cp, l, "%x.%02x", bcd >> 8, bcd & 0xff);
233 }
234 
235 Static void
236 usbd_devinfo(struct usbd_device *dev, int showclass, char *cp, size_t l)
237 {
238 	usb_device_descriptor_t *udd = &dev->ud_ddesc;
239 	char *vendor, *product;
240 	int bcdDevice, bcdUSB;
241 	char *ep;
242 
243 	vendor = kmem_alloc(USB_MAX_ENCODED_STRING_LEN * 2, KM_SLEEP);
244 	product = &vendor[USB_MAX_ENCODED_STRING_LEN];
245 
246 	ep = cp + l;
247 
248 	usbd_devinfo_vp(dev, vendor, USB_MAX_ENCODED_STRING_LEN,
249 	    product, USB_MAX_ENCODED_STRING_LEN, 0, 1);
250 	cp += snprintf(cp, ep - cp, "%s (%#04x) %s (%#04x)", vendor,
251 	    UGETW(udd->idVendor), product, UGETW(udd->idProduct));
252 	if (showclass)
253 		cp += snprintf(cp, ep - cp, ", class %d/%d",
254 		    udd->bDeviceClass, udd->bDeviceSubClass);
255 	bcdUSB = UGETW(udd->bcdUSB);
256 	bcdDevice = UGETW(udd->bcdDevice);
257 	cp += snprintf(cp, ep - cp, ", rev ");
258 	cp += usbd_printBCD(cp, ep - cp, bcdUSB);
259 	*cp++ = '/';
260 	cp += usbd_printBCD(cp, ep - cp, bcdDevice);
261 	cp += snprintf(cp, ep - cp, ", addr %d", dev->ud_addr);
262 	*cp = 0;
263 	kmem_free(vendor, USB_MAX_ENCODED_STRING_LEN * 2);
264 }
265 
266 char *
267 usbd_devinfo_alloc(struct usbd_device *dev, int showclass)
268 {
269 	char *devinfop;
270 
271 	devinfop = kmem_alloc(DEVINFOSIZE, KM_SLEEP);
272 	usbd_devinfo(dev, showclass, devinfop, DEVINFOSIZE);
273 	return devinfop;
274 }
275 
276 void
277 usbd_devinfo_free(char *devinfop)
278 {
279 	kmem_free(devinfop, DEVINFOSIZE);
280 }
281 
282 /* Delay for a certain number of ms */
283 void
284 usb_delay_ms_locked(struct usbd_bus *bus, u_int ms, kmutex_t *lock)
285 {
286 	/* Wait at least two clock ticks so we know the time has passed. */
287 	if (bus->ub_usepolling || cold)
288 		delay((ms+1) * 1000);
289 	else
290 		kpause("usbdly", false, (ms*hz+999)/1000 + 1, lock);
291 }
292 
293 void
294 usb_delay_ms(struct usbd_bus *bus, u_int ms)
295 {
296 	usb_delay_ms_locked(bus, ms, NULL);
297 }
298 
299 /* Delay given a device handle. */
300 void
301 usbd_delay_ms_locked(struct usbd_device *dev, u_int ms, kmutex_t *lock)
302 {
303 	usb_delay_ms_locked(dev->ud_bus, ms, lock);
304 }
305 
306 /* Delay given a device handle. */
307 void
308 usbd_delay_ms(struct usbd_device *dev, u_int ms)
309 {
310 	usb_delay_ms_locked(dev->ud_bus, ms, NULL);
311 }
312 
313 usbd_status
314 usbd_reset_port(struct usbd_device *dev, int port, usb_port_status_t *ps)
315 {
316 	USBHIST_FUNC(); USBHIST_CALLED(usbdebug);
317 	usb_device_request_t req;
318 	usbd_status err;
319 	int n;
320 
321 	req.bmRequestType = UT_WRITE_CLASS_OTHER;
322 	req.bRequest = UR_SET_FEATURE;
323 	USETW(req.wValue, UHF_PORT_RESET);
324 	USETW(req.wIndex, port);
325 	USETW(req.wLength, 0);
326 	err = usbd_do_request(dev, &req, 0);
327 	DPRINTFN(1, "port %jd reset done, error=%jd", port, err, 0, 0);
328 	if (err)
329 		return err;
330 	n = 10;
331 	do {
332 		/* Wait for device to recover from reset. */
333 		usbd_delay_ms(dev, USB_PORT_RESET_DELAY);
334 		err = usbd_get_port_status(dev, port, ps);
335 		if (err) {
336 			DPRINTF("get status failed %jd", err, 0, 0, 0);
337 			return err;
338 		}
339 		/* If the device disappeared, just give up. */
340 		if (!(UGETW(ps->wPortStatus) & UPS_CURRENT_CONNECT_STATUS))
341 			return USBD_NORMAL_COMPLETION;
342 	} while ((UGETW(ps->wPortChange) & UPS_C_PORT_RESET) == 0 && --n > 0);
343 	if (n == 0)
344 		return USBD_TIMEOUT;
345 	err = usbd_clear_port_feature(dev, port, UHF_C_PORT_RESET);
346 #ifdef USB_DEBUG
347 	if (err)
348 		DPRINTF("clear port feature failed %jd", err, 0, 0, 0);
349 #endif
350 
351 	/* Wait for the device to recover from reset. */
352 	usbd_delay_ms(dev, USB_PORT_RESET_RECOVERY);
353 	return err;
354 }
355 
356 usb_interface_descriptor_t *
357 usbd_find_idesc(usb_config_descriptor_t *cd, int ifaceidx, int altidx)
358 {
359 	USBHIST_FUNC(); USBHIST_CALLED(usbdebug);
360 	char *p = (char *)cd;
361 	char *end = p + UGETW(cd->wTotalLength);
362 	usb_interface_descriptor_t *d;
363 	int curidx, lastidx, curaidx = 0;
364 
365 	for (curidx = lastidx = -1; p < end; ) {
366 		d = (usb_interface_descriptor_t *)p;
367 		DPRINTFN(4, "idx=%jd(%jd) altidx=%jd(%jd)", ifaceidx, curidx,
368 		    altidx, curaidx);
369 		DPRINTFN(4, "len=%jd type=%jd", d->bLength, d->bDescriptorType,
370 		    0, 0);
371 		if (d->bLength == 0) /* bad descriptor */
372 			break;
373 		p += d->bLength;
374 		if (p <= end && d->bDescriptorType == UDESC_INTERFACE) {
375 			if (d->bInterfaceNumber != lastidx) {
376 				lastidx = d->bInterfaceNumber;
377 				curidx++;
378 				curaidx = 0;
379 			} else
380 				curaidx++;
381 			if (ifaceidx == curidx && altidx == curaidx)
382 				return d;
383 		}
384 	}
385 	return NULL;
386 }
387 
388 usb_endpoint_descriptor_t *
389 usbd_find_edesc(usb_config_descriptor_t *cd, int ifaceidx, int altidx,
390 		int endptidx)
391 {
392 	char *p = (char *)cd;
393 	char *end = p + UGETW(cd->wTotalLength);
394 	usb_interface_descriptor_t *d;
395 	usb_endpoint_descriptor_t *e;
396 	int curidx;
397 
398 	d = usbd_find_idesc(cd, ifaceidx, altidx);
399 	if (d == NULL)
400 		return NULL;
401 	if (endptidx >= d->bNumEndpoints) /* quick exit */
402 		return NULL;
403 
404 	curidx = -1;
405 	for (p = (char *)d + d->bLength; p < end; ) {
406 		e = (usb_endpoint_descriptor_t *)p;
407 		if (e->bLength == 0) /* bad descriptor */
408 			break;
409 		p += e->bLength;
410 		if (p <= end && e->bDescriptorType == UDESC_INTERFACE)
411 			return NULL;
412 		if (p <= end && e->bDescriptorType == UDESC_ENDPOINT) {
413 			curidx++;
414 			if (curidx == endptidx)
415 				return e;
416 		}
417 	}
418 	return NULL;
419 }
420 
421 usbd_status
422 usbd_fill_iface_data(struct usbd_device *dev, int ifaceidx, int altidx)
423 {
424 	USBHIST_FUNC(); USBHIST_CALLED(usbdebug);
425 	struct usbd_interface *ifc = &dev->ud_ifaces[ifaceidx];
426 	usb_interface_descriptor_t *idesc;
427 	char *p, *end;
428 	int endpt, nendpt;
429 
430 	DPRINTFN(4, "ifaceidx=%jd altidx=%jd", ifaceidx, altidx, 0, 0);
431 	idesc = usbd_find_idesc(dev->ud_cdesc, ifaceidx, altidx);
432 	if (idesc == NULL)
433 		return USBD_INVAL;
434 	ifc->ui_dev = dev;
435 	ifc->ui_idesc = idesc;
436 	ifc->ui_index = ifaceidx;
437 	ifc->ui_altindex = altidx;
438 	nendpt = ifc->ui_idesc->bNumEndpoints;
439 	DPRINTFN(4, "found idesc nendpt=%jd", nendpt, 0, 0, 0);
440 	if (nendpt != 0) {
441 		ifc->ui_endpoints = kmem_alloc(nendpt * sizeof(struct usbd_endpoint),
442 				KM_SLEEP);
443 	} else
444 		ifc->ui_endpoints = NULL;
445 	ifc->ui_priv = NULL;
446 	p = (char *)ifc->ui_idesc + ifc->ui_idesc->bLength;
447 	end = (char *)dev->ud_cdesc + UGETW(dev->ud_cdesc->wTotalLength);
448 #define ed ((usb_endpoint_descriptor_t *)p)
449 	for (endpt = 0; endpt < nendpt; endpt++) {
450 		DPRINTFN(10, "endpt=%jd", endpt, 0, 0, 0);
451 		for (; p < end; p += ed->bLength) {
452 			DPRINTFN(10, "p=%#jx end=%#jx len=%jd type=%jd",
453 			    (uintptr_t)p, (uintptr_t)end, ed->bLength,
454 			    ed->bDescriptorType);
455 			if (p + ed->bLength <= end && ed->bLength != 0 &&
456 			    ed->bDescriptorType == UDESC_ENDPOINT)
457 				goto found;
458 			if (ed->bLength == 0 ||
459 			    ed->bDescriptorType == UDESC_INTERFACE)
460 				break;
461 		}
462 		/* passed end, or bad desc */
463 		printf("usbd_fill_iface_data: bad descriptor(s): %s\n",
464 		       ed->bLength == 0 ? "0 length" :
465 		       ed->bDescriptorType == UDESC_INTERFACE ? "iface desc":
466 		       "out of data");
467 		goto bad;
468 	found:
469 		ifc->ui_endpoints[endpt].ue_edesc = ed;
470 		if (dev->ud_speed == USB_SPEED_HIGH) {
471 			u_int mps;
472 			/* Control and bulk endpoints have max packet limits. */
473 			switch (UE_GET_XFERTYPE(ed->bmAttributes)) {
474 			case UE_CONTROL:
475 				mps = USB_2_MAX_CTRL_PACKET;
476 				goto check;
477 			case UE_BULK:
478 				mps = USB_2_MAX_BULK_PACKET;
479 			check:
480 				if (UGETW(ed->wMaxPacketSize) != mps) {
481 					USETW(ed->wMaxPacketSize, mps);
482 #ifdef DIAGNOSTIC
483 					printf("usbd_fill_iface_data: bad max "
484 					       "packet size\n");
485 #endif
486 				}
487 				break;
488 			default:
489 				break;
490 			}
491 		}
492 		ifc->ui_endpoints[endpt].ue_refcnt = 0;
493 		ifc->ui_endpoints[endpt].ue_toggle = 0;
494 		p += ed->bLength;
495 	}
496 #undef ed
497 	LIST_INIT(&ifc->ui_pipes);
498 	return USBD_NORMAL_COMPLETION;
499 
500  bad:
501 	if (ifc->ui_endpoints != NULL) {
502 		kmem_free(ifc->ui_endpoints, nendpt * sizeof(struct usbd_endpoint));
503 		ifc->ui_endpoints = NULL;
504 	}
505 	return USBD_INVAL;
506 }
507 
508 void
509 usbd_free_iface_data(struct usbd_device *dev, int ifcno)
510 {
511 	struct usbd_interface *ifc = &dev->ud_ifaces[ifcno];
512 	if (ifc->ui_endpoints) {
513 		int nendpt = ifc->ui_idesc->bNumEndpoints;
514 		size_t sz = nendpt * sizeof(struct usbd_endpoint);
515 		kmem_free(ifc->ui_endpoints, sz);
516 	}
517 }
518 
519 Static usbd_status
520 usbd_set_config(struct usbd_device *dev, int conf)
521 {
522 	USBHIST_FUNC(); USBHIST_CALLED(usbdebug);
523 	usb_device_request_t req;
524 
525 	DPRINTFN(5, "dev %#jx conf %jd", (uintptr_t)dev, conf, 0, 0);
526 
527 	req.bmRequestType = UT_WRITE_DEVICE;
528 	req.bRequest = UR_SET_CONFIG;
529 	USETW(req.wValue, conf);
530 	USETW(req.wIndex, 0);
531 	USETW(req.wLength, 0);
532 	return usbd_do_request(dev, &req, 0);
533 }
534 
535 usbd_status
536 usbd_set_config_no(struct usbd_device *dev, int no, int msg)
537 {
538 	USBHIST_FUNC(); USBHIST_CALLED(usbdebug);
539 	usb_config_descriptor_t cd;
540 	usbd_status err;
541 	int index;
542 
543 	if (no == USB_UNCONFIG_NO)
544 		return usbd_set_config_index(dev, USB_UNCONFIG_INDEX, msg);
545 
546 	DPRINTFN(5, "%jd", no, 0, 0, 0);
547 	/* Figure out what config index to use. */
548 	for (index = 0; index < dev->ud_ddesc.bNumConfigurations; index++) {
549 		err = usbd_get_config_desc(dev, index, &cd);
550 		if (err)
551 			return err;
552 		if (cd.bConfigurationValue == no)
553 			return usbd_set_config_index(dev, index, msg);
554 	}
555 	return USBD_INVAL;
556 }
557 
558 usbd_status
559 usbd_set_config_index(struct usbd_device *dev, int index, int msg)
560 {
561 	USBHIST_FUNC(); USBHIST_CALLED(usbdebug);
562 	usb_config_descriptor_t cd, *cdp;
563 	usb_bos_descriptor_t *bdp = NULL;
564 	usbd_status err;
565 	int i, ifcidx, nifc, len, selfpowered, power;
566 
567 	DPRINTFN(5, "dev=%#jx index=%jd", (uintptr_t)dev, index, 0, 0);
568 
569 	if (index >= dev->ud_ddesc.bNumConfigurations &&
570 	    index != USB_UNCONFIG_INDEX) {
571 		/* panic? */
572 		printf("usbd_set_config_index: illegal index\n");
573 		return USBD_INVAL;
574 	}
575 
576 	/* XXX check that all interfaces are idle */
577 	if (dev->ud_config != USB_UNCONFIG_NO) {
578 		DPRINTF("free old config", 0, 0, 0, 0);
579 		/* Free all configuration data structures. */
580 		nifc = dev->ud_cdesc->bNumInterface;
581 		for (ifcidx = 0; ifcidx < nifc; ifcidx++)
582 			usbd_free_iface_data(dev, ifcidx);
583 		kmem_free(dev->ud_ifaces, nifc * sizeof(struct usbd_interface));
584 		kmem_free(dev->ud_cdesc, UGETW(dev->ud_cdesc->wTotalLength));
585 		if (dev->ud_bdesc != NULL)
586 			kmem_free(dev->ud_bdesc,
587 			    UGETW(dev->ud_bdesc->wTotalLength));
588 		dev->ud_ifaces = NULL;
589 		dev->ud_cdesc = NULL;
590 		dev->ud_bdesc = NULL;
591 		dev->ud_config = USB_UNCONFIG_NO;
592 	}
593 
594 	if (index == USB_UNCONFIG_INDEX) {
595 		/* We are unconfiguring the device, so leave unallocated. */
596 		DPRINTF("set config 0", 0, 0, 0, 0);
597 		err = usbd_set_config(dev, USB_UNCONFIG_NO);
598 		if (err) {
599 			DPRINTF("setting config=0 failed, err = %jd", err,
600 			    0, 0, 0);
601 		}
602 		return err;
603 	}
604 
605 	/* Get the short descriptor. */
606 	err = usbd_get_config_desc(dev, index, &cd);
607 	if (err) {
608 		DPRINTF("get_config_desc=%jd", err, 0, 0, 0);
609 		return err;
610 	}
611 	len = UGETW(cd.wTotalLength);
612 	if (len == 0) {
613 		DPRINTF("empty short descriptor", 0, 0, 0, 0);
614 		return USBD_INVAL;
615 	}
616 	cdp = kmem_alloc(len, KM_SLEEP);
617 
618 	/* Get the full descriptor.  Try a few times for slow devices. */
619 	for (i = 0; i < 3; i++) {
620 		err = usbd_get_desc(dev, UDESC_CONFIG, index, len, cdp);
621 		if (!err)
622 			break;
623 		usbd_delay_ms(dev, 200);
624 	}
625 	if (err) {
626 		DPRINTF("get_desc=%jd", err, 0, 0, 0);
627 		goto bad;
628 	}
629 	if (cdp->bDescriptorType != UDESC_CONFIG) {
630 		DPRINTF("bad desc %jd", cdp->bDescriptorType, 0, 0, 0);
631 		err = USBD_INVAL;
632 		goto bad;
633 	}
634 
635 	if (USB_IS_SS(dev->ud_speed)) {
636 		usb_bos_descriptor_t bd;
637 
638 		/* get short bos desc */
639 		err = usbd_get_bos_desc(dev, index, &bd);
640 		if (!err) {
641 			int blen = UGETW(bd.wTotalLength);
642 			if (blen == 0) {
643 				DPRINTF("empty bos descriptor", 0, 0, 0, 0);
644 				err = USBD_INVAL;
645 				goto bad;
646 			}
647 			bdp = kmem_alloc(blen, KM_SLEEP);
648 
649 			/* Get the full desc */
650 			for (i = 0; i < 3; i++) {
651 				err = usbd_get_desc(dev, UDESC_BOS, index, blen,
652 				    bdp);
653 				if (!err)
654 					break;
655 				usbd_delay_ms(dev, 200);
656 			}
657 			if (err || bdp->bDescriptorType != UDESC_BOS) {
658 				DPRINTF("error %jd or bad desc %jd", err,
659 				    bdp->bDescriptorType, 0, 0);
660 				kmem_free(bdp, blen);
661 				bdp = NULL;
662 			}
663 		}
664 	}
665 	dev->ud_bdesc = bdp;
666 
667 	/*
668 	 * Figure out if the device is self or bus powered.
669 	 */
670 #if 0 /* XXX various devices don't report the power state correctly */
671 	selfpowered = 0;
672 	err = usbd_get_device_status(dev, &ds);
673 	if (!err && (UGETW(ds.wStatus) & UDS_SELF_POWERED))
674 		selfpowered = 1;
675 #endif
676 	/*
677 	 * Use the power state in the configuration we are going
678 	 * to set. This doesn't necessarily reflect the actual
679 	 * power state of the device; the driver can control this
680 	 * by choosing the appropriate configuration.
681 	 */
682 	selfpowered = !!(cdp->bmAttributes & UC_SELF_POWERED);
683 
684 	DPRINTF("addr %jd cno=%jd attr=%#02jx, selfpowered=%jd",
685 	    dev->ud_addr, cdp->bConfigurationValue, cdp->bmAttributes,
686 	    selfpowered);
687 	DPRINTF("max power=%jd", cdp->bMaxPower * 2, 0, 0, 0);
688 
689 	/* Check if we have enough power. */
690 #if 0 /* this is a no-op, see above */
691 	if ((cdp->bmAttributes & UC_SELF_POWERED) && !selfpowered) {
692 		if (msg)
693 			printf("%s: device addr %d (config %d): "
694 				 "can't set self powered configuration\n",
695 			       device_xname(dev->ud_bus->bdev), dev->ud_addr,
696 			       cdp->bConfigurationValue);
697 		err = USBD_NO_POWER;
698 		goto bad;
699 	}
700 #endif
701 #ifdef USB_DEBUG
702 	if (dev->ud_powersrc == NULL) {
703 		DPRINTF("No power source?", 0, 0, 0, 0);
704 		err = USBD_IOERROR;
705 		goto bad;
706 	}
707 #endif
708 	power = cdp->bMaxPower * 2;
709 	if (power > dev->ud_powersrc->up_power) {
710 		DPRINTF("power exceeded %jd %jd", power,
711 		    dev->ud_powersrc->up_power, 0, 0);
712 		/* XXX print nicer message. */
713 		if (msg)
714 			printf("%s: device addr %d (config %d) exceeds power "
715 				 "budget, %d mA > %d mA\n",
716 			       device_xname(dev->ud_bus->ub_usbctl), dev->ud_addr,
717 			       cdp->bConfigurationValue,
718 			       power, dev->ud_powersrc->up_power);
719 		err = USBD_NO_POWER;
720 		goto bad;
721 	}
722 	dev->ud_power = power;
723 	dev->ud_selfpowered = selfpowered;
724 
725 	/* Set the actual configuration value. */
726 	DPRINTF("set config %jd", cdp->bConfigurationValue, 0, 0, 0);
727 	err = usbd_set_config(dev, cdp->bConfigurationValue);
728 	if (err) {
729 		DPRINTF("setting config=%jd failed, error=%jd",
730 		    cdp->bConfigurationValue, err, 0, 0);
731 		goto bad;
732 	}
733 
734 	/* Allocate and fill interface data. */
735 	nifc = cdp->bNumInterface;
736 	if (nifc == 0) {
737 		DPRINTF("no interfaces", 0, 0, 0, 0);
738 		err = USBD_INVAL;
739 		goto bad;
740 	}
741 	dev->ud_ifaces = kmem_alloc(nifc * sizeof(struct usbd_interface),
742 	    KM_SLEEP);
743 	DPRINTFN(5, "dev=%#jx cdesc=%#jx", (uintptr_t)dev, (uintptr_t)cdp,
744 	    0, 0);
745 	dev->ud_cdesc = cdp;
746 	dev->ud_config = cdp->bConfigurationValue;
747 	for (ifcidx = 0; ifcidx < nifc; ifcidx++) {
748 		err = usbd_fill_iface_data(dev, ifcidx, 0);
749 		if (err) {
750 			while (--ifcidx >= 0)
751 				usbd_free_iface_data(dev, ifcidx);
752 			goto bad;
753 		}
754 	}
755 
756 	return USBD_NORMAL_COMPLETION;
757 
758  bad:
759 	kmem_free(cdp, len);
760 	if (bdp != NULL) {
761 		kmem_free(bdp, UGETW(bdp->wTotalLength));
762 		dev->ud_bdesc = NULL;
763 	}
764 	return err;
765 }
766 
767 /* XXX add function for alternate settings */
768 
769 usbd_status
770 usbd_setup_pipe(struct usbd_device *dev, struct usbd_interface *iface,
771 		struct usbd_endpoint *ep, int ival, struct usbd_pipe **pipe)
772 {
773 	return usbd_setup_pipe_flags(dev, iface, ep, ival, pipe, 0);
774 }
775 
776 usbd_status
777 usbd_setup_pipe_flags(struct usbd_device *dev, struct usbd_interface *iface,
778     struct usbd_endpoint *ep, int ival, struct usbd_pipe **pipe, uint8_t flags)
779 {
780 	USBHIST_FUNC(); USBHIST_CALLED(usbdebug);
781 	struct usbd_pipe *p;
782 	usbd_status err;
783 
784 	p = kmem_alloc(dev->ud_bus->ub_pipesize, KM_SLEEP);
785 	DPRINTFN(1, "dev=%#jx addr=%jd iface=%#jx ep=%#jx",
786 	    (uintptr_t)dev, dev->ud_addr, (uintptr_t)iface, (uintptr_t)ep);
787 	DPRINTFN(1, "pipe=%#jx", (uintptr_t)p, 0, 0, 0);
788 	p->up_dev = dev;
789 	p->up_iface = iface;
790 	p->up_endpoint = ep;
791 	ep->ue_refcnt++;
792 	p->up_intrxfer = NULL;
793 	p->up_running = 0;
794 	p->up_aborting = 0;
795 	p->up_serialise = true;
796 	p->up_repeat = 0;
797 	p->up_interval = ival;
798 	p->up_flags = flags;
799 	p->up_serialise = true;
800 	SIMPLEQ_INIT(&p->up_queue);
801 	err = dev->ud_bus->ub_methods->ubm_open(p);
802 	if (err) {
803 		DPRINTF("endpoint=%#jx failed, error=%jd",
804 		    (uintptr_t)ep->ue_edesc->bEndpointAddress, err, 0, 0);
805 		kmem_free(p, dev->ud_bus->ub_pipesize);
806 		return err;
807 	}
808 
809 	KASSERT(p->up_methods->upm_start || p->up_serialise == false);
810 
811 	usb_init_task(&p->up_async_task, usbd_clear_endpoint_stall_task, p,
812 	    USB_TASKQ_MPSAFE);
813 	DPRINTFN(1, "pipe=%#jx", (uintptr_t)p, 0, 0, 0);
814 	*pipe = p;
815 	return USBD_NORMAL_COMPLETION;
816 }
817 
818 /* Abort the device control pipe. */
819 void
820 usbd_kill_pipe(struct usbd_pipe *pipe)
821 {
822 	usbd_abort_pipe(pipe);
823 	usbd_lock_pipe(pipe);
824 	pipe->up_methods->upm_close(pipe);
825 	usbd_unlock_pipe(pipe);
826 	usb_rem_task(pipe->up_dev, &pipe->up_async_task);
827 	pipe->up_endpoint->ue_refcnt--;
828 	kmem_free(pipe, pipe->up_dev->ud_bus->ub_pipesize);
829 }
830 
831 int
832 usbd_getnewaddr(struct usbd_bus *bus)
833 {
834 	int addr;
835 
836 	for (addr = 1; addr < USB_MAX_DEVICES; addr++) {
837 		size_t dindex = usb_addr2dindex(addr);
838 		if (bus->ub_devices[dindex] == NULL)
839 			return addr;
840 	}
841 	return -1;
842 }
843 
844 usbd_status
845 usbd_attach_roothub(device_t parent, struct usbd_device *dev)
846 {
847 	struct usb_attach_arg uaa;
848 	usb_device_descriptor_t *dd = &dev->ud_ddesc;
849 	device_t dv;
850 
851 	uaa.uaa_device = dev;
852 	uaa.uaa_usegeneric = 0;
853 	uaa.uaa_port = 0;
854 	uaa.uaa_vendor = UGETW(dd->idVendor);
855 	uaa.uaa_product = UGETW(dd->idProduct);
856 	uaa.uaa_release = UGETW(dd->bcdDevice);
857 	uaa.uaa_class = dd->bDeviceClass;
858 	uaa.uaa_subclass = dd->bDeviceSubClass;
859 	uaa.uaa_proto = dd->bDeviceProtocol;
860 
861 	dv = config_found_ia(parent, "usbroothubif", &uaa, 0);
862 	if (dv) {
863 		dev->ud_subdevs = kmem_alloc(sizeof(dv), KM_SLEEP);
864 		dev->ud_subdevs[0] = dv;
865 		dev->ud_subdevlen = 1;
866 	}
867 	return USBD_NORMAL_COMPLETION;
868 }
869 
870 static void
871 usbd_serialnumber(device_t dv, struct usbd_device *dev)
872 {
873 	if (dev->ud_serial) {
874 		prop_dictionary_set_cstring(device_properties(dv),
875 		    "serialnumber", dev->ud_serial);
876 	}
877 }
878 
879 static usbd_status
880 usbd_attachwholedevice(device_t parent, struct usbd_device *dev, int port,
881 	int usegeneric)
882 {
883 	struct usb_attach_arg uaa;
884 	usb_device_descriptor_t *dd = &dev->ud_ddesc;
885 	device_t dv;
886 	int dlocs[USBDEVIFCF_NLOCS];
887 
888 	uaa.uaa_device = dev;
889 	uaa.uaa_usegeneric = usegeneric;
890 	uaa.uaa_port = port;
891 	uaa.uaa_vendor = UGETW(dd->idVendor);
892 	uaa.uaa_product = UGETW(dd->idProduct);
893 	uaa.uaa_release = UGETW(dd->bcdDevice);
894 	uaa.uaa_class = dd->bDeviceClass;
895 	uaa.uaa_subclass = dd->bDeviceSubClass;
896 	uaa.uaa_proto = dd->bDeviceProtocol;
897 
898 	dlocs[USBDEVIFCF_PORT] = uaa.uaa_port;
899 	dlocs[USBDEVIFCF_VENDOR] = uaa.uaa_vendor;
900 	dlocs[USBDEVIFCF_PRODUCT] = uaa.uaa_product;
901 	dlocs[USBDEVIFCF_RELEASE] = uaa.uaa_release;
902 	/* the rest is historical ballast */
903 	dlocs[USBDEVIFCF_CONFIGURATION] = -1;
904 	dlocs[USBDEVIFCF_INTERFACE] = -1;
905 
906 	KERNEL_LOCK(1, NULL);
907 	dv = config_found_sm_loc(parent, "usbdevif", dlocs, &uaa, usbd_print,
908 				 config_stdsubmatch);
909 	KERNEL_UNLOCK_ONE(NULL);
910 	if (dv) {
911 		dev->ud_subdevs = kmem_alloc(sizeof(dv), KM_SLEEP);
912 		dev->ud_subdevs[0] = dv;
913 		dev->ud_subdevlen = 1;
914 		dev->ud_nifaces_claimed = 1; /* XXX */
915 		usbd_serialnumber(dv, dev);
916 	}
917 	return USBD_NORMAL_COMPLETION;
918 }
919 
920 static usbd_status
921 usbd_attachinterfaces(device_t parent, struct usbd_device *dev,
922 		      int port, const int *locators)
923 {
924 	USBHIST_FUNC(); USBHIST_CALLED(usbdebug);
925 	struct usbif_attach_arg uiaa;
926 	int ilocs[USBIFIFCF_NLOCS];
927 	usb_device_descriptor_t *dd = &dev->ud_ddesc;
928 	int nifaces;
929 	struct usbd_interface **ifaces;
930 	int i, j, loc;
931 	device_t dv;
932 
933 	nifaces = dev->ud_cdesc->bNumInterface;
934 	ifaces = kmem_zalloc(nifaces * sizeof(*ifaces), KM_SLEEP);
935 	for (i = 0; i < nifaces; i++) {
936 		if (!dev->ud_subdevs[i]) {
937 			ifaces[i] = &dev->ud_ifaces[i];
938 		}
939 		DPRINTF("interface %jd %#jx", i, (uintptr_t)ifaces[i], 0, 0);
940 	}
941 
942 
943 	uiaa.uiaa_device = dev;
944 	uiaa.uiaa_port = port;
945 	uiaa.uiaa_vendor = UGETW(dd->idVendor);
946 	uiaa.uiaa_product = UGETW(dd->idProduct);
947 	uiaa.uiaa_release = UGETW(dd->bcdDevice);
948 	uiaa.uiaa_configno = dev->ud_cdesc->bConfigurationValue;
949 	uiaa.uiaa_ifaces = ifaces;
950 	uiaa.uiaa_nifaces = nifaces;
951 	ilocs[USBIFIFCF_PORT] = uiaa.uiaa_port;
952 	ilocs[USBIFIFCF_VENDOR] = uiaa.uiaa_vendor;
953 	ilocs[USBIFIFCF_PRODUCT] = uiaa.uiaa_product;
954 	ilocs[USBIFIFCF_RELEASE] = uiaa.uiaa_release;
955 	ilocs[USBIFIFCF_CONFIGURATION] = uiaa.uiaa_configno;
956 
957 	for (i = 0; i < nifaces; i++) {
958 		if (!ifaces[i]) {
959 			DPRINTF("interface %jd claimed", i, 0, 0, 0);
960 			continue; /* interface already claimed */
961 		}
962 		uiaa.uiaa_iface = ifaces[i];
963 		uiaa.uiaa_class = ifaces[i]->ui_idesc->bInterfaceClass;
964 		uiaa.uiaa_subclass = ifaces[i]->ui_idesc->bInterfaceSubClass;
965 		uiaa.uiaa_proto = ifaces[i]->ui_idesc->bInterfaceProtocol;
966 		uiaa.uiaa_ifaceno = ifaces[i]->ui_idesc->bInterfaceNumber;
967 
968 		DPRINTF("searching for interface %jd...", i, 0, 0, 0);
969 		DPRINTF("class %jx subclass %jx proto %jx ifaceno %jd",
970 		    uiaa.uiaa_class, uiaa.uiaa_subclass, uiaa.uiaa_proto,
971 		    uiaa.uiaa_ifaceno);
972 		ilocs[USBIFIFCF_INTERFACE] = uiaa.uiaa_ifaceno;
973 		if (locators != NULL) {
974 			loc = locators[USBIFIFCF_CONFIGURATION];
975 			if (loc != USBIFIFCF_CONFIGURATION_DEFAULT &&
976 			    loc != uiaa.uiaa_configno)
977 				continue;
978 			loc = locators[USBIFIFCF_INTERFACE];
979 			if (loc != USBIFIFCF_INTERFACE_DEFAULT &&
980 			    loc != uiaa.uiaa_ifaceno)
981 				continue;
982 		}
983 		KERNEL_LOCK(1, NULL);
984 		dv = config_found_sm_loc(parent, "usbifif", ilocs, &uiaa,
985 					 usbd_ifprint, config_stdsubmatch);
986 		KERNEL_UNLOCK_ONE(NULL);
987 		if (!dv)
988 			continue;
989 
990 		usbd_serialnumber(dv, dev);
991 
992 		/* claim */
993 		ifaces[i] = NULL;
994 		/* account for ifaces claimed by the driver behind our back */
995 		for (j = 0; j < nifaces; j++) {
996 
997 			if (!ifaces[j] && !dev->ud_subdevs[j]) {
998 				DPRINTF("interface %jd claimed behind our back",
999 				    j, 0, 0, 0);
1000 				dev->ud_subdevs[j] = dv;
1001 				dev->ud_nifaces_claimed++;
1002 			}
1003 		}
1004 	}
1005 
1006 	kmem_free(ifaces, nifaces * sizeof(*ifaces));
1007 	return USBD_NORMAL_COMPLETION;
1008 }
1009 
1010 usbd_status
1011 usbd_probe_and_attach(device_t parent, struct usbd_device *dev,
1012                       int port, int addr)
1013 {
1014 	USBHIST_FUNC(); USBHIST_CALLED(usbdebug);
1015 	usb_device_descriptor_t *dd = &dev->ud_ddesc;
1016 	int confi, nifaces;
1017 	usbd_status err;
1018 
1019 	/* First try with device specific drivers. */
1020 	DPRINTF("trying device specific drivers", 0, 0, 0, 0);
1021 	err = usbd_attachwholedevice(parent, dev, port, 0);
1022 	if (dev->ud_nifaces_claimed || err)
1023 		return err;
1024 	DPRINTF("no device specific driver found", 0, 0, 0, 0);
1025 
1026 	DPRINTF("looping over %jd configurations", dd->bNumConfigurations,
1027 	    0, 0, 0);
1028 	for (confi = 0; confi < dd->bNumConfigurations; confi++) {
1029 		DPRINTFN(1, "trying config idx=%jd", confi, 0, 0, 0);
1030 		err = usbd_set_config_index(dev, confi, 1);
1031 		if (err) {
1032 			DPRINTF("port %jd, set config at addr %jd failed, "
1033 			    "error=%d", port, addr, err, 0);
1034 			printf("%s: port %d, set config at addr %d failed\n",
1035 			    device_xname(parent), port, addr);
1036 			return err;
1037 		}
1038 		nifaces = dev->ud_cdesc->bNumInterface;
1039 		dev->ud_subdevs = kmem_zalloc(nifaces * sizeof(device_t),
1040 		    KM_SLEEP);
1041 		if (dev->ud_subdevs == NULL)
1042 			return USBD_NOMEM;
1043 		dev->ud_subdevlen = nifaces;
1044 
1045 		err = usbd_attachinterfaces(parent, dev, port, NULL);
1046 
1047 		if (!dev->ud_nifaces_claimed) {
1048 			kmem_free(dev->ud_subdevs,
1049 			    dev->ud_subdevlen * sizeof(device_t));
1050 			dev->ud_subdevs = 0;
1051 			dev->ud_subdevlen = 0;
1052 		}
1053 		if (dev->ud_nifaces_claimed || err)
1054 			return err;
1055 	}
1056 	/* No interfaces were attached in any of the configurations. */
1057 
1058 	if (dd->bNumConfigurations > 1) /* don't change if only 1 config */
1059 		usbd_set_config_index(dev, 0, 0);
1060 
1061 	DPRINTF("no interface drivers found", 0, 0, 0, 0);
1062 
1063 	/* Finally try the generic driver. */
1064 	err = usbd_attachwholedevice(parent, dev, port, 1);
1065 
1066 	/*
1067 	 * The generic attach failed, but leave the device as it is.
1068 	 * We just did not find any drivers, that's all.  The device is
1069 	 * fully operational and not harming anyone.
1070 	 */
1071 	DPRINTF("generic attach failed", 0, 0, 0, 0);
1072 
1073 	return USBD_NORMAL_COMPLETION;
1074 }
1075 
1076 /**
1077  * Called from uhub_rescan().  usbd_new_device() for the target dev must be
1078  * called before calling this.
1079  */
1080 usbd_status
1081 usbd_reattach_device(device_t parent, struct usbd_device *dev,
1082                      int port, const int *locators)
1083 {
1084 	int i, loc;
1085 
1086 	if (locators != NULL) {
1087 		loc = locators[USBIFIFCF_PORT];
1088 		if (loc != USBIFIFCF_PORT_DEFAULT && loc != port)
1089 			return USBD_NORMAL_COMPLETION;
1090 		loc = locators[USBIFIFCF_VENDOR];
1091 		if (loc != USBIFIFCF_VENDOR_DEFAULT &&
1092 		    loc != UGETW(dev->ud_ddesc.idVendor))
1093 			return USBD_NORMAL_COMPLETION;
1094 		loc = locators[USBIFIFCF_PRODUCT];
1095 		if (loc != USBIFIFCF_PRODUCT_DEFAULT &&
1096 		    loc != UGETW(dev->ud_ddesc.idProduct))
1097 			return USBD_NORMAL_COMPLETION;
1098 		loc = locators[USBIFIFCF_RELEASE];
1099 		if (loc != USBIFIFCF_RELEASE_DEFAULT &&
1100 		    loc != UGETW(dev->ud_ddesc.bcdDevice))
1101 			return USBD_NORMAL_COMPLETION;
1102 	}
1103 	if (dev->ud_subdevlen == 0) {
1104 		/* XXX: check USBIFIFCF_CONFIGURATION and
1105 		 * USBIFIFCF_INTERFACE too */
1106 		return usbd_probe_and_attach(parent, dev, port, dev->ud_addr);
1107 	} else if (dev->ud_subdevlen != dev->ud_cdesc->bNumInterface) {
1108 		/* device-specific or generic driver is already attached. */
1109 		return USBD_NORMAL_COMPLETION;
1110 	}
1111 	/* Does the device have unconfigured interfaces? */
1112 	for (i = 0; i < dev->ud_subdevlen; i++) {
1113 		if (dev->ud_subdevs[i] == NULL) {
1114 			break;
1115 		}
1116 	}
1117 	if (i >= dev->ud_subdevlen)
1118 		return USBD_NORMAL_COMPLETION;
1119 	return usbd_attachinterfaces(parent, dev, port, locators);
1120 }
1121 
1122 /*
1123  * Get the first 8 bytes of the device descriptor.
1124  * Do as Windows does: try to read 64 bytes -- there are devices which
1125  * recognize the initial descriptor fetch (before the control endpoint's
1126  * MaxPacketSize is known by the host) by exactly this length.
1127  */
1128 usbd_status
1129 usbd_get_initial_ddesc(struct usbd_device *dev, usb_device_descriptor_t *desc)
1130 {
1131 	USBHIST_FUNC(); USBHIST_CALLED(usbdebug);
1132 	usb_device_request_t req;
1133 	char buf[64];
1134 	int res, actlen;
1135 
1136 	DPRINTFN(5, "dev %#jx", (uintptr_t)dev, 0, 0, 0);
1137 
1138 	req.bmRequestType = UT_READ_DEVICE;
1139 	req.bRequest = UR_GET_DESCRIPTOR;
1140 	USETW2(req.wValue, UDESC_DEVICE, 0);
1141 	USETW(req.wIndex, 0);
1142 	USETW(req.wLength, 64);
1143 	res = usbd_do_request_flags(dev, &req, buf, USBD_SHORT_XFER_OK,
1144 		&actlen, USBD_DEFAULT_TIMEOUT);
1145 	if (res)
1146 		return res;
1147 	if (actlen < 8)
1148 		return USBD_SHORT_XFER;
1149 	memcpy(desc, buf, 8);
1150 	return USBD_NORMAL_COMPLETION;
1151 }
1152 
1153 /*
1154  * Called when a new device has been put in the powered state,
1155  * but not yet in the addressed state.
1156  * Get initial descriptor, set the address, get full descriptor,
1157  * and attach a driver.
1158  */
1159 usbd_status
1160 usbd_new_device(device_t parent, struct usbd_bus *bus, int depth, int speed,
1161     int port, struct usbd_port *up)
1162 {
1163 	USBHIST_FUNC(); USBHIST_CALLED(usbdebug);
1164 	struct usbd_device *dev, *adev;
1165 	struct usbd_device *hub;
1166 	usb_device_descriptor_t *dd;
1167 	usb_port_status_t ps;
1168 	usbd_status err;
1169 	int addr;
1170 	int i;
1171 	int p;
1172 
1173 	DPRINTF("bus=%#jx port=%jd depth=%jd speed=%jd",
1174 	    (uintptr_t)bus, port, depth, speed);
1175 
1176 	if (bus->ub_methods->ubm_newdev != NULL)
1177 		return (bus->ub_methods->ubm_newdev)(parent, bus, depth, speed,
1178 		    port, up);
1179 
1180 	addr = usbd_getnewaddr(bus);
1181 	if (addr < 0) {
1182 		printf("%s: No free USB addresses, new device ignored.\n",
1183 		       device_xname(bus->ub_usbctl));
1184 		return USBD_NO_ADDR;
1185 	}
1186 
1187 	dev = kmem_zalloc(sizeof(*dev), KM_SLEEP);
1188 	dev->ud_bus = bus;
1189 
1190 	/* Set up default endpoint handle. */
1191 	dev->ud_ep0.ue_edesc = &dev->ud_ep0desc;
1192 
1193 	/* Set up default endpoint descriptor. */
1194 	dev->ud_ep0desc.bLength = USB_ENDPOINT_DESCRIPTOR_SIZE;
1195 	dev->ud_ep0desc.bDescriptorType = UDESC_ENDPOINT;
1196 	dev->ud_ep0desc.bEndpointAddress = USB_CONTROL_ENDPOINT;
1197 	dev->ud_ep0desc.bmAttributes = UE_CONTROL;
1198 	/*
1199 	 * temporary, will be fixed after first descriptor fetch
1200 	 * (which uses 64 bytes so it shouldn't be less),
1201 	 * highspeed devices must support 64 byte packets anyway
1202 	 */
1203 	if (speed == USB_SPEED_HIGH || speed == USB_SPEED_FULL)
1204 		USETW(dev->ud_ep0desc.wMaxPacketSize, 64);
1205 	else
1206 		USETW(dev->ud_ep0desc.wMaxPacketSize, USB_MAX_IPACKET);
1207 
1208 	dev->ud_ep0desc.bInterval = 0;
1209 
1210 	/* doesn't matter, just don't leave it uninitialized */
1211 	dev->ud_ep0.ue_toggle = 0;
1212 
1213 	dev->ud_quirks = &usbd_no_quirk;
1214 	dev->ud_addr = USB_START_ADDR;
1215 	dev->ud_ddesc.bMaxPacketSize = 0;
1216 	dev->ud_depth = depth;
1217 	dev->ud_powersrc = up;
1218 	dev->ud_myhub = up->up_parent;
1219 
1220 	up->up_dev = dev;
1221 
1222 	/* Locate port on upstream high speed hub */
1223 	for (adev = dev, hub = up->up_parent;
1224 	     hub != NULL && hub->ud_speed != USB_SPEED_HIGH;
1225 	     adev = hub, hub = hub->ud_myhub)
1226 		;
1227 	if (hub) {
1228 		for (p = 0; p < hub->ud_hub->uh_hubdesc.bNbrPorts; p++) {
1229 			if (hub->ud_hub->uh_ports[p].up_dev == adev) {
1230 				dev->ud_myhsport = &hub->ud_hub->uh_ports[p];
1231 				goto found;
1232 			}
1233 		}
1234 		panic("usbd_new_device: cannot find HS port");
1235 	found:
1236 		DPRINTFN(1, "high speed port %jd", p, 0, 0, 0);
1237 	} else {
1238 		dev->ud_myhsport = NULL;
1239 	}
1240 	dev->ud_speed = speed;
1241 	dev->ud_langid = USBD_NOLANG;
1242 	dev->ud_cookie.cookie = ++usb_cookie_no;
1243 
1244 	/* Establish the default pipe. */
1245 	err = usbd_setup_pipe_flags(dev, 0, &dev->ud_ep0, USBD_DEFAULT_INTERVAL,
1246 	    &dev->ud_pipe0, USBD_MPSAFE);
1247 	if (err) {
1248 		usbd_remove_device(dev, up);
1249 		return err;
1250 	}
1251 
1252 	dd = &dev->ud_ddesc;
1253 	/* Try a few times in case the device is slow (i.e. outside specs.) */
1254 	for (i = 0; i < 10; i++) {
1255 		/* Get the first 8 bytes of the device descriptor. */
1256 		err = usbd_get_initial_ddesc(dev, dd);
1257 		if (!err)
1258 			break;
1259 		/*
1260 		 * The root hub can never fail to give the initial descriptor,
1261 		 * but assert it just in case.
1262 		 */
1263 		KASSERT(up->up_parent);
1264 		usbd_delay_ms(dev, 200);
1265 		if ((i & 3) == 3)
1266 			usbd_reset_port(up->up_parent, port, &ps);
1267 	}
1268 	if (err) {
1269 		DPRINTF("addr=%jd, getting first desc failed: %jd", addr, err,
1270 		    0, 0);
1271 		usbd_remove_device(dev, up);
1272 		return err;
1273 	}
1274 
1275 	/* Windows resets the port here, do likewise */
1276 	if (up->up_parent)
1277 		usbd_reset_port(up->up_parent, port, &ps);
1278 
1279 	if (speed == USB_SPEED_HIGH) {
1280 		/* Max packet size must be 64 (sec 5.5.3). */
1281 		if (dd->bMaxPacketSize != USB_2_MAX_CTRL_PACKET) {
1282 #ifdef DIAGNOSTIC
1283 			printf("usbd_new_device: addr=%d bad max packet "
1284 			    "size=%d. adjusting to %d.\n",
1285 			    addr, dd->bMaxPacketSize, USB_2_MAX_CTRL_PACKET);
1286 #endif
1287 			dd->bMaxPacketSize = USB_2_MAX_CTRL_PACKET;
1288 		}
1289 	}
1290 
1291 	DPRINTF("adding unit addr=%jd, rev=%02jx, class=%jd, subclass=%jd",
1292 	    addr, UGETW(dd->bcdUSB), dd->bDeviceClass, dd->bDeviceSubClass);
1293 	DPRINTF("protocol=%jd, maxpacket=%jd, len=%jd, speed=%jd",
1294 	    dd->bDeviceProtocol, dd->bMaxPacketSize, dd->bLength, dev->ud_speed);
1295 
1296 	if (dd->bDescriptorType != UDESC_DEVICE) {
1297 		/* Illegal device descriptor */
1298 		DPRINTF("illegal descriptor %jd", dd->bDescriptorType, 0, 0, 0);
1299 		usbd_remove_device(dev, up);
1300 		return USBD_INVAL;
1301 	}
1302 
1303 	if (dd->bLength < USB_DEVICE_DESCRIPTOR_SIZE) {
1304 		DPRINTF("bad length %jd", dd->bLength, 0, 0, 0);
1305 		usbd_remove_device(dev, up);
1306 		return USBD_INVAL;
1307 	}
1308 
1309 	USETW(dev->ud_ep0desc.wMaxPacketSize, dd->bMaxPacketSize);
1310 
1311 	/* Re-establish the default pipe with the new MPS. */
1312 	usbd_kill_pipe(dev->ud_pipe0);
1313 	err = usbd_setup_pipe_flags(dev, 0, &dev->ud_ep0, USBD_DEFAULT_INTERVAL,
1314 	    &dev->ud_pipe0, USBD_MPSAFE);
1315 	if (err) {
1316 		DPRINTF("setup default pipe failed err %jd", err, 0, 0, 0);
1317 		usbd_remove_device(dev, up);
1318 		return err;
1319 	}
1320 
1321 	/* Set the address */
1322 	DPRINTFN(5, "setting device address=%jd", addr, 0, 0, 0);
1323 	err = usbd_set_address(dev, addr);
1324 	if (err) {
1325 		DPRINTF("set address %jd failed, err = %jd", addr, err, 0, 0);
1326 		err = USBD_SET_ADDR_FAILED;
1327 		usbd_remove_device(dev, up);
1328 		return err;
1329 	}
1330 
1331 	/* Allow device time to set new address */
1332 	usbd_delay_ms(dev, USB_SET_ADDRESS_SETTLE);
1333 	dev->ud_addr = addr;	/* new device address now */
1334 	bus->ub_devices[usb_addr2dindex(addr)] = dev;
1335 
1336 	/* Re-establish the default pipe with the new address. */
1337 	usbd_kill_pipe(dev->ud_pipe0);
1338 	err = usbd_setup_pipe_flags(dev, 0, &dev->ud_ep0, USBD_DEFAULT_INTERVAL,
1339 	    &dev->ud_pipe0, USBD_MPSAFE);
1340 	if (err) {
1341 		DPRINTF("setup default pipe failed, err = %jd", err, 0, 0, 0);
1342 		usbd_remove_device(dev, up);
1343 		return err;
1344 	}
1345 
1346 	err = usbd_reload_device_desc(dev);
1347 	if (err) {
1348 		DPRINTF("addr=%jd, getting full desc failed, err = %jd", addr,
1349 		    err, 0, 0);
1350 		usbd_remove_device(dev, up);
1351 		return err;
1352 	}
1353 
1354 	/* Assume 100mA bus powered for now. Changed when configured. */
1355 	dev->ud_power = USB_MIN_POWER;
1356 	dev->ud_selfpowered = 0;
1357 
1358 	DPRINTF("new dev (addr %jd), dev=%#jx, parent=%#jx",
1359 	    addr, (uintptr_t)dev, (uintptr_t)parent, 0);
1360 
1361 	usbd_get_device_strings(dev);
1362 
1363 	usbd_add_dev_event(USB_EVENT_DEVICE_ATTACH, dev);
1364 
1365 	if (port == 0) { /* root hub */
1366 		KASSERT(addr == 1);
1367 		usbd_attach_roothub(parent, dev);
1368 		return USBD_NORMAL_COMPLETION;
1369 	}
1370 
1371 	err = usbd_probe_and_attach(parent, dev, port, addr);
1372 	if (err) {
1373 		usbd_remove_device(dev, up);
1374 		return err;
1375 	}
1376 
1377 	return USBD_NORMAL_COMPLETION;
1378 }
1379 
1380 usbd_status
1381 usbd_reload_device_desc(struct usbd_device *dev)
1382 {
1383 	USBHIST_FUNC(); USBHIST_CALLED(usbdebug);
1384 	usb_device_descriptor_t *udd = &dev->ud_ddesc;
1385 	usbd_status err;
1386 
1387 	/* Get the full device descriptor. */
1388 	err = usbd_get_device_desc(dev, udd);
1389 	if (err)
1390 		return err;
1391 
1392 	DPRINTFN(15, "bLength             %5ju", udd->bLength, 0, 0, 0);
1393 	DPRINTFN(15, "bDescriptorType     %5ju", udd->bDescriptorType, 0, 0, 0);
1394 	DPRINTFN(15, "bcdUSB              %2jx.%02jx", udd->bcdUSB[1],
1395 	    udd->bcdUSB[0], 0, 0);
1396 	DPRINTFN(15, "bDeviceClass        %5ju", udd->bDeviceClass, 0, 0, 0);
1397 	DPRINTFN(15, "bDeviceSubClass     %5ju", udd->bDeviceSubClass, 0, 0, 0);
1398 	DPRINTFN(15, "bDeviceProtocol     %5ju", udd->bDeviceProtocol, 0, 0, 0);
1399 	DPRINTFN(15, "bMaxPacketSize0     %5ju", udd->bMaxPacketSize, 0, 0, 0);
1400 	DPRINTFN(15, "idVendor            %#02jx %#02jx",
1401 						    udd->idVendor[0],
1402 						    udd->idVendor[1], 0, 0);
1403 	DPRINTFN(15, "idProduct           %#02jx %#02jx",
1404 						    udd->idProduct[0],
1405 						    udd->idProduct[1], 0, 0);
1406 	DPRINTFN(15, "bcdDevice           %2jx.%02jx", udd->bcdDevice[1],
1407 	    udd->bcdDevice[0], 0, 0);
1408 	DPRINTFN(15, "iManufacturer       %5ju", udd->iManufacturer, 0, 0, 0);
1409 	DPRINTFN(15, "iProduct            %5ju", udd->iProduct, 0, 0, 0);
1410 	DPRINTFN(15, "iSerial             %5ju", udd->iSerialNumber, 0, 0, 0);
1411 	DPRINTFN(15, "bNumConfigurations  %5ju", udd->bNumConfigurations, 0, 0,
1412 	    0);
1413 
1414 	/* Figure out what's wrong with this device. */
1415 	dev->ud_quirks = usbd_find_quirk(udd);
1416 
1417 	return USBD_NORMAL_COMPLETION;
1418 }
1419 
1420 void
1421 usbd_remove_device(struct usbd_device *dev, struct usbd_port *up)
1422 {
1423 
1424 	USBHIST_FUNC(); USBHIST_CALLED(usbdebug);
1425 
1426 	DPRINTF("dev %#jx up %#jx", (uintptr_t)dev, (uintptr_t)up, 0, 0);
1427 
1428 	if (dev->ud_pipe0 != NULL)
1429 		usbd_kill_pipe(dev->ud_pipe0);
1430 	up->up_dev = NULL;
1431 	dev->ud_bus->ub_devices[usb_addr2dindex(dev->ud_addr)] = NULL;
1432 
1433 	kmem_free(dev, sizeof(*dev));
1434 }
1435 
1436 int
1437 usbd_print(void *aux, const char *pnp)
1438 {
1439 	struct usb_attach_arg *uaa = aux;
1440 
1441 	if (pnp) {
1442 #define USB_DEVINFO 1024
1443 		char *devinfo;
1444 		if (!uaa->uaa_usegeneric)
1445 			return QUIET;
1446 		devinfo = kmem_alloc(USB_DEVINFO, KM_SLEEP);
1447 		usbd_devinfo(uaa->uaa_device, 1, devinfo, USB_DEVINFO);
1448 		aprint_normal("%s, %s", devinfo, pnp);
1449 		kmem_free(devinfo, USB_DEVINFO);
1450 	}
1451 	aprint_normal(" port %d", uaa->uaa_port);
1452 #if 0
1453 	/*
1454 	 * It gets very crowded with these locators on the attach line.
1455 	 * They are not really needed since they are printed in the clear
1456 	 * by each driver.
1457 	 */
1458 	if (uaa->uaa_vendor != UHUB_UNK_VENDOR)
1459 		aprint_normal(" vendor %#04x", uaa->uaa_vendor);
1460 	if (uaa->uaa_product != UHUB_UNK_PRODUCT)
1461 		aprint_normal(" product %#04x", uaa->uaa_product);
1462 	if (uaa->uaa_release != UHUB_UNK_RELEASE)
1463 		aprint_normal(" release %#04x", uaa->uaa_release);
1464 #endif
1465 	return UNCONF;
1466 }
1467 
1468 int
1469 usbd_ifprint(void *aux, const char *pnp)
1470 {
1471 	struct usbif_attach_arg *uiaa = aux;
1472 
1473 	if (pnp)
1474 		return QUIET;
1475 	aprint_normal(" port %d", uiaa->uiaa_port);
1476 	aprint_normal(" configuration %d", uiaa->uiaa_configno);
1477 	aprint_normal(" interface %d", uiaa->uiaa_ifaceno);
1478 #if 0
1479 	/*
1480 	 * It gets very crowded with these locators on the attach line.
1481 	 * They are not really needed since they are printed in the clear
1482 	 * by each driver.
1483 	 */
1484 	if (uaa->uaa_vendor != UHUB_UNK_VENDOR)
1485 		aprint_normal(" vendor %#04x", uaa->uaa_vendor);
1486 	if (uaa->uaa_product != UHUB_UNK_PRODUCT)
1487 		aprint_normal(" product %#04x", uaa->uaa_product);
1488 	if (uaa->uaa_release != UHUB_UNK_RELEASE)
1489 		aprint_normal(" release %#04x", uaa->uaa_release);
1490 #endif
1491 	return UNCONF;
1492 }
1493 
1494 void
1495 usbd_fill_deviceinfo(struct usbd_device *dev, struct usb_device_info *di,
1496 		     int usedev)
1497 {
1498 	struct usbd_port *p;
1499 	int i, j, err;
1500 
1501 	di->udi_bus = device_unit(dev->ud_bus->ub_usbctl);
1502 	di->udi_addr = dev->ud_addr;
1503 	di->udi_cookie = dev->ud_cookie;
1504 	usbd_devinfo_vp(dev, di->udi_vendor, sizeof(di->udi_vendor),
1505 	    di->udi_product, sizeof(di->udi_product), usedev, 1);
1506 	usbd_printBCD(di->udi_release, sizeof(di->udi_release),
1507 	    UGETW(dev->ud_ddesc.bcdDevice));
1508 	if (usedev) {
1509 		usbd_status uerr = usbd_get_string(dev,
1510 		    dev->ud_ddesc.iSerialNumber, di->udi_serial);
1511 		if (uerr != USBD_NORMAL_COMPLETION) {
1512 			di->udi_serial[0] = '\0';
1513 		} else {
1514 			usbd_trim_spaces(di->udi_serial);
1515 		}
1516 	} else {
1517 		di->udi_serial[0] = '\0';
1518 		if (dev->ud_serial) {
1519 			strlcpy(di->udi_serial, dev->ud_serial,
1520 			    sizeof(di->udi_serial));
1521 		}
1522 	}
1523 
1524 	di->udi_vendorNo = UGETW(dev->ud_ddesc.idVendor);
1525 	di->udi_productNo = UGETW(dev->ud_ddesc.idProduct);
1526 	di->udi_releaseNo = UGETW(dev->ud_ddesc.bcdDevice);
1527 	di->udi_class = dev->ud_ddesc.bDeviceClass;
1528 	di->udi_subclass = dev->ud_ddesc.bDeviceSubClass;
1529 	di->udi_protocol = dev->ud_ddesc.bDeviceProtocol;
1530 	di->udi_config = dev->ud_config;
1531 	di->udi_power = dev->ud_selfpowered ? 0 : dev->ud_power;
1532 	di->udi_speed = dev->ud_speed;
1533 
1534 	if (dev->ud_subdevlen > 0) {
1535 		for (i = 0, j = 0; i < dev->ud_subdevlen &&
1536 			     j < USB_MAX_DEVNAMES; i++) {
1537 			if (!dev->ud_subdevs[i])
1538 				continue;
1539 			strncpy(di->udi_devnames[j],
1540 			    device_xname(dev->ud_subdevs[i]), USB_MAX_DEVNAMELEN);
1541 			di->udi_devnames[j][USB_MAX_DEVNAMELEN-1] = '\0';
1542 			j++;
1543 		}
1544 	} else {
1545 		j = 0;
1546 	}
1547 	for (/* j is set */; j < USB_MAX_DEVNAMES; j++)
1548 		di->udi_devnames[j][0] = 0;                 /* empty */
1549 
1550 	if (!dev->ud_hub) {
1551 		di->udi_nports = 0;
1552 		return;
1553 	}
1554 
1555 	const int nports = dev->ud_hub->uh_hubdesc.bNbrPorts;
1556 	for (i = 0; i < __arraycount(di->udi_ports) && i < nports; i++) {
1557 		p = &dev->ud_hub->uh_ports[i];
1558 		if (p->up_dev)
1559 			err = p->up_dev->ud_addr;
1560 		else {
1561 			const int s = UGETW(p->up_status.wPortStatus);
1562 			const bool sshub_p = USB_IS_SS(dev->ud_speed);
1563 			if (s & UPS_PORT_ENABLED)
1564 				err = USB_PORT_ENABLED;
1565 			else if (s & UPS_SUSPEND)
1566 				err = USB_PORT_SUSPENDED;
1567 			/*
1568 			 * Note: UPS_PORT_POWER_SS is available only
1569 			 * on 3.x, and UPS_PORT_POWER is available
1570 			 * only on 2.0 or 1.1.
1571 			 */
1572 			else if (sshub_p && (s & UPS_PORT_POWER_SS))
1573 				err = USB_PORT_POWERED;
1574 			else if (!sshub_p && (s & UPS_PORT_POWER))
1575 				err = USB_PORT_POWERED;
1576 			else
1577 				err = USB_PORT_DISABLED;
1578 		}
1579 		di->udi_ports[i] = err;
1580 	}
1581 	di->udi_nports = nports;
1582 }
1583 
1584 #ifdef COMPAT_30
1585 void
1586 usbd_fill_deviceinfo_old(struct usbd_device *dev, struct usb_device_info_old *di,
1587                          int usedev)
1588 {
1589 	struct usbd_port *p;
1590 	int i, j, err;
1591 
1592 	di->udi_bus = device_unit(dev->ud_bus->ub_usbctl);
1593 	di->udi_addr = dev->ud_addr;
1594 	di->udi_cookie = dev->ud_cookie;
1595 	usbd_devinfo_vp(dev, di->udi_vendor, sizeof(di->udi_vendor),
1596 	    di->udi_product, sizeof(di->udi_product), usedev, 0);
1597 	usbd_printBCD(di->udi_release, sizeof(di->udi_release),
1598 	    UGETW(dev->ud_ddesc.bcdDevice));
1599 	di->udi_vendorNo = UGETW(dev->ud_ddesc.idVendor);
1600 	di->udi_productNo = UGETW(dev->ud_ddesc.idProduct);
1601 	di->udi_releaseNo = UGETW(dev->ud_ddesc.bcdDevice);
1602 	di->udi_class = dev->ud_ddesc.bDeviceClass;
1603 	di->udi_subclass = dev->ud_ddesc.bDeviceSubClass;
1604 	di->udi_protocol = dev->ud_ddesc.bDeviceProtocol;
1605 	di->udi_config = dev->ud_config;
1606 	di->udi_power = dev->ud_selfpowered ? 0 : dev->ud_power;
1607 	di->udi_speed = dev->ud_speed;
1608 
1609 	if (dev->ud_subdevlen > 0) {
1610 		for (i = 0, j = 0; i < dev->ud_subdevlen &&
1611 			     j < USB_MAX_DEVNAMES; i++) {
1612 			if (!dev->ud_subdevs[i])
1613 				continue;
1614 			strncpy(di->udi_devnames[j],
1615 			    device_xname(dev->ud_subdevs[i]), USB_MAX_DEVNAMELEN);
1616 			di->udi_devnames[j][USB_MAX_DEVNAMELEN-1] = '\0';
1617 			j++;
1618 		}
1619 	} else {
1620 		j = 0;
1621 	}
1622 	for (/* j is set */; j < USB_MAX_DEVNAMES; j++)
1623 		di->udi_devnames[j][0] = 0;		 /* empty */
1624 
1625 	if (!dev->ud_hub) {
1626 		di->udi_nports = 0;
1627 		return;
1628 	}
1629 
1630 	const int nports = dev->ud_hub->uh_hubdesc.bNbrPorts;
1631 	for (i = 0; i < __arraycount(di->udi_ports) && i < nports;
1632 	     i++) {
1633 		p = &dev->ud_hub->uh_ports[i];
1634 		if (p->up_dev)
1635 			err = p->up_dev->ud_addr;
1636 		else {
1637 			const int s = UGETW(p->up_status.wPortStatus);
1638 			if (s & UPS_PORT_ENABLED)
1639 				err = USB_PORT_ENABLED;
1640 			else if (s & UPS_SUSPEND)
1641 				err = USB_PORT_SUSPENDED;
1642 			else if (s & UPS_PORT_POWER)
1643 				err = USB_PORT_POWERED;
1644 			else
1645 				err = USB_PORT_DISABLED;
1646 		}
1647 		di->udi_ports[i] = err;
1648 	}
1649 	di->udi_nports = nports;
1650 }
1651 #endif
1652 
1653 
1654 void
1655 usb_free_device(struct usbd_device *dev)
1656 {
1657 	int ifcidx, nifc;
1658 
1659 	if (dev->ud_pipe0 != NULL)
1660 		usbd_kill_pipe(dev->ud_pipe0);
1661 	if (dev->ud_ifaces != NULL) {
1662 		nifc = dev->ud_cdesc->bNumInterface;
1663 		for (ifcidx = 0; ifcidx < nifc; ifcidx++)
1664 			usbd_free_iface_data(dev, ifcidx);
1665 		kmem_free(dev->ud_ifaces,
1666 		    nifc * sizeof(struct usbd_interface));
1667 	}
1668 	if (dev->ud_cdesc != NULL)
1669 		kmem_free(dev->ud_cdesc, UGETW(dev->ud_cdesc->wTotalLength));
1670 	if (dev->ud_bdesc != NULL)
1671 		kmem_free(dev->ud_bdesc, UGETW(dev->ud_bdesc->wTotalLength));
1672 	if (dev->ud_subdevlen > 0) {
1673 		kmem_free(dev->ud_subdevs,
1674 		    dev->ud_subdevlen * sizeof(device_t));
1675 		dev->ud_subdevlen = 0;
1676 	}
1677 	if (dev->ud_vendor) {
1678 		kmem_free(dev->ud_vendor, USB_MAX_ENCODED_STRING_LEN);
1679 	}
1680 	if (dev->ud_product) {
1681 		kmem_free(dev->ud_product, USB_MAX_ENCODED_STRING_LEN);
1682 	}
1683 	if (dev->ud_serial) {
1684 		kmem_free(dev->ud_serial, USB_MAX_ENCODED_STRING_LEN);
1685 	}
1686 	kmem_free(dev, sizeof(*dev));
1687 }
1688 
1689 /*
1690  * The general mechanism for detaching drivers works as follows: Each
1691  * driver is responsible for maintaining a reference count on the
1692  * number of outstanding references to its softc (e.g.  from
1693  * processing hanging in a read or write).  The detach method of the
1694  * driver decrements this counter and flags in the softc that the
1695  * driver is dying and then wakes any sleepers.  It then sleeps on the
1696  * softc.  Each place that can sleep must maintain the reference
1697  * count.  When the reference count drops to -1 (0 is the normal value
1698  * of the reference count) then a wakeup on the softc is performed
1699  * signaling to the detach waiter that all references are gone.
1700  */
1701 
1702 /*
1703  * Called from process context when we discover that a port has
1704  * been disconnected.
1705  */
1706 int
1707 usb_disconnect_port(struct usbd_port *up, device_t parent, int flags)
1708 {
1709 	USBHIST_FUNC(); USBHIST_CALLED(usbdebug);
1710 	struct usbd_device *dev = up->up_dev;
1711 	device_t subdev;
1712 	char subdevname[16];
1713 	const char *hubname = device_xname(parent);
1714 	int i, rc;
1715 
1716 	DPRINTFN(3, "up=%#jx dev=%#jx port=%jd", (uintptr_t)up, (uintptr_t)dev,
1717 	    up->up_portno, 0);
1718 
1719 	if (dev == NULL) {
1720 		return 0;
1721 	}
1722 
1723 	if (dev->ud_subdevlen > 0) {
1724 		DPRINTFN(3, "disconnect subdevs", 0, 0, 0, 0);
1725 		for (i = 0; i < dev->ud_subdevlen; i++) {
1726 			if ((subdev = dev->ud_subdevs[i]) == NULL)
1727 				continue;
1728 			strlcpy(subdevname, device_xname(subdev),
1729 			    sizeof(subdevname));
1730 			if ((rc = config_detach(subdev, flags)) != 0)
1731 				return rc;
1732 			printf("%s: at %s", subdevname, hubname);
1733 			if (up->up_portno != 0)
1734 				printf(" port %d", up->up_portno);
1735 			printf(" (addr %d) disconnected\n", dev->ud_addr);
1736 		}
1737 		KASSERT(!dev->ud_nifaces_claimed);
1738 	}
1739 
1740 	mutex_enter(dev->ud_bus->ub_lock);
1741 	dev->ud_bus->ub_devices[usb_addr2dindex(dev->ud_addr)] = NULL;
1742 	up->up_dev = NULL;
1743 	mutex_exit(dev->ud_bus->ub_lock);
1744 
1745 	usbd_add_dev_event(USB_EVENT_DEVICE_DETACH, dev);
1746 
1747 	usb_free_device(dev);
1748 
1749 	return 0;
1750 }
1751