xref: /netbsd-src/sys/dev/usb/usb_subr.c (revision bdc22b2e01993381dcefeff2bc9b56ca75a4235c)
1 /*	$NetBSD: usb_subr.c,v 1.224 2018/04/30 05:04:34 mlelstv 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.224 2018/04/30 05:04:34 mlelstv 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 	KERNEL_LOCK(1, curlwp);
862 	dv = config_found_ia(parent, "usbroothubif", &uaa, 0);
863 	KERNEL_UNLOCK_ONE(curlwp);
864 	if (dv) {
865 		dev->ud_subdevs = kmem_alloc(sizeof(dv), KM_SLEEP);
866 		dev->ud_subdevs[0] = dv;
867 		dev->ud_subdevlen = 1;
868 	}
869 	return USBD_NORMAL_COMPLETION;
870 }
871 
872 static void
873 usbd_serialnumber(device_t dv, struct usbd_device *dev)
874 {
875 	if (dev->ud_serial) {
876 		prop_dictionary_set_cstring(device_properties(dv),
877 		    "serialnumber", dev->ud_serial);
878 	}
879 }
880 
881 static usbd_status
882 usbd_attachwholedevice(device_t parent, struct usbd_device *dev, int port,
883 	int usegeneric)
884 {
885 	struct usb_attach_arg uaa;
886 	usb_device_descriptor_t *dd = &dev->ud_ddesc;
887 	device_t dv;
888 	int dlocs[USBDEVIFCF_NLOCS];
889 
890 	uaa.uaa_device = dev;
891 	uaa.uaa_usegeneric = usegeneric;
892 	uaa.uaa_port = port;
893 	uaa.uaa_vendor = UGETW(dd->idVendor);
894 	uaa.uaa_product = UGETW(dd->idProduct);
895 	uaa.uaa_release = UGETW(dd->bcdDevice);
896 	uaa.uaa_class = dd->bDeviceClass;
897 	uaa.uaa_subclass = dd->bDeviceSubClass;
898 	uaa.uaa_proto = dd->bDeviceProtocol;
899 
900 	dlocs[USBDEVIFCF_PORT] = uaa.uaa_port;
901 	dlocs[USBDEVIFCF_VENDOR] = uaa.uaa_vendor;
902 	dlocs[USBDEVIFCF_PRODUCT] = uaa.uaa_product;
903 	dlocs[USBDEVIFCF_RELEASE] = uaa.uaa_release;
904 	/* the rest is historical ballast */
905 	dlocs[USBDEVIFCF_CONFIGURATION] = -1;
906 	dlocs[USBDEVIFCF_INTERFACE] = -1;
907 
908 	KERNEL_LOCK(1, curlwp);
909 	dv = config_found_sm_loc(parent, "usbdevif", dlocs, &uaa, usbd_print,
910 				 config_stdsubmatch);
911 	KERNEL_UNLOCK_ONE(curlwp);
912 	if (dv) {
913 		dev->ud_subdevs = kmem_alloc(sizeof(dv), KM_SLEEP);
914 		dev->ud_subdevs[0] = dv;
915 		dev->ud_subdevlen = 1;
916 		dev->ud_nifaces_claimed = 1; /* XXX */
917 		usbd_serialnumber(dv, dev);
918 	}
919 	return USBD_NORMAL_COMPLETION;
920 }
921 
922 static usbd_status
923 usbd_attachinterfaces(device_t parent, struct usbd_device *dev,
924 		      int port, const int *locators)
925 {
926 	USBHIST_FUNC(); USBHIST_CALLED(usbdebug);
927 	struct usbif_attach_arg uiaa;
928 	int ilocs[USBIFIFCF_NLOCS];
929 	usb_device_descriptor_t *dd = &dev->ud_ddesc;
930 	int nifaces;
931 	struct usbd_interface **ifaces;
932 	int i, j, loc;
933 	device_t dv;
934 
935 	nifaces = dev->ud_cdesc->bNumInterface;
936 	ifaces = kmem_zalloc(nifaces * sizeof(*ifaces), KM_SLEEP);
937 	for (i = 0; i < nifaces; i++) {
938 		if (!dev->ud_subdevs[i]) {
939 			ifaces[i] = &dev->ud_ifaces[i];
940 		}
941 		DPRINTF("interface %jd %#jx", i, (uintptr_t)ifaces[i], 0, 0);
942 	}
943 
944 
945 	uiaa.uiaa_device = dev;
946 	uiaa.uiaa_port = port;
947 	uiaa.uiaa_vendor = UGETW(dd->idVendor);
948 	uiaa.uiaa_product = UGETW(dd->idProduct);
949 	uiaa.uiaa_release = UGETW(dd->bcdDevice);
950 	uiaa.uiaa_configno = dev->ud_cdesc->bConfigurationValue;
951 	uiaa.uiaa_ifaces = ifaces;
952 	uiaa.uiaa_nifaces = nifaces;
953 	ilocs[USBIFIFCF_PORT] = uiaa.uiaa_port;
954 	ilocs[USBIFIFCF_VENDOR] = uiaa.uiaa_vendor;
955 	ilocs[USBIFIFCF_PRODUCT] = uiaa.uiaa_product;
956 	ilocs[USBIFIFCF_RELEASE] = uiaa.uiaa_release;
957 	ilocs[USBIFIFCF_CONFIGURATION] = uiaa.uiaa_configno;
958 
959 	for (i = 0; i < nifaces; i++) {
960 		if (!ifaces[i]) {
961 			DPRINTF("interface %jd claimed", i, 0, 0, 0);
962 			continue; /* interface already claimed */
963 		}
964 		uiaa.uiaa_iface = ifaces[i];
965 		uiaa.uiaa_class = ifaces[i]->ui_idesc->bInterfaceClass;
966 		uiaa.uiaa_subclass = ifaces[i]->ui_idesc->bInterfaceSubClass;
967 		uiaa.uiaa_proto = ifaces[i]->ui_idesc->bInterfaceProtocol;
968 		uiaa.uiaa_ifaceno = ifaces[i]->ui_idesc->bInterfaceNumber;
969 
970 		DPRINTF("searching for interface %jd...", i, 0, 0, 0);
971 		DPRINTF("class %jx subclass %jx proto %jx ifaceno %jd",
972 		    uiaa.uiaa_class, uiaa.uiaa_subclass, uiaa.uiaa_proto,
973 		    uiaa.uiaa_ifaceno);
974 		ilocs[USBIFIFCF_INTERFACE] = uiaa.uiaa_ifaceno;
975 		if (locators != NULL) {
976 			loc = locators[USBIFIFCF_CONFIGURATION];
977 			if (loc != USBIFIFCF_CONFIGURATION_DEFAULT &&
978 			    loc != uiaa.uiaa_configno)
979 				continue;
980 			loc = locators[USBIFIFCF_INTERFACE];
981 			if (loc != USBIFIFCF_INTERFACE_DEFAULT &&
982 			    loc != uiaa.uiaa_ifaceno)
983 				continue;
984 		}
985 		KERNEL_LOCK(1, curlwp);
986 		dv = config_found_sm_loc(parent, "usbifif", ilocs, &uiaa,
987 					 usbd_ifprint, config_stdsubmatch);
988 		KERNEL_UNLOCK_ONE(curlwp);
989 		if (!dv)
990 			continue;
991 
992 		usbd_serialnumber(dv, dev);
993 
994 		/* claim */
995 		ifaces[i] = NULL;
996 		/* account for ifaces claimed by the driver behind our back */
997 		for (j = 0; j < nifaces; j++) {
998 
999 			if (!ifaces[j] && !dev->ud_subdevs[j]) {
1000 				DPRINTF("interface %jd claimed behind our back",
1001 				    j, 0, 0, 0);
1002 				dev->ud_subdevs[j] = dv;
1003 				dev->ud_nifaces_claimed++;
1004 			}
1005 		}
1006 	}
1007 
1008 	kmem_free(ifaces, nifaces * sizeof(*ifaces));
1009 	return USBD_NORMAL_COMPLETION;
1010 }
1011 
1012 usbd_status
1013 usbd_probe_and_attach(device_t parent, struct usbd_device *dev,
1014                       int port, int addr)
1015 {
1016 	USBHIST_FUNC(); USBHIST_CALLED(usbdebug);
1017 	usb_device_descriptor_t *dd = &dev->ud_ddesc;
1018 	int confi, nifaces;
1019 	usbd_status err;
1020 
1021 	/* First try with device specific drivers. */
1022 	DPRINTF("trying device specific drivers", 0, 0, 0, 0);
1023 	err = usbd_attachwholedevice(parent, dev, port, 0);
1024 	if (dev->ud_nifaces_claimed || err)
1025 		return err;
1026 	DPRINTF("no device specific driver found", 0, 0, 0, 0);
1027 
1028 	DPRINTF("looping over %jd configurations", dd->bNumConfigurations,
1029 	    0, 0, 0);
1030 	for (confi = 0; confi < dd->bNumConfigurations; confi++) {
1031 		DPRINTFN(1, "trying config idx=%jd", confi, 0, 0, 0);
1032 		err = usbd_set_config_index(dev, confi, 1);
1033 		if (err) {
1034 			DPRINTF("port %jd, set config at addr %jd failed, "
1035 			    "error=%d", port, addr, err, 0);
1036 			printf("%s: port %d, set config at addr %d failed\n",
1037 			    device_xname(parent), port, addr);
1038 			return err;
1039 		}
1040 		nifaces = dev->ud_cdesc->bNumInterface;
1041 		dev->ud_subdevs = kmem_zalloc(nifaces * sizeof(device_t),
1042 		    KM_SLEEP);
1043 		if (dev->ud_subdevs == NULL)
1044 			return USBD_NOMEM;
1045 		dev->ud_subdevlen = nifaces;
1046 
1047 		err = usbd_attachinterfaces(parent, dev, port, NULL);
1048 
1049 		if (!dev->ud_nifaces_claimed) {
1050 			kmem_free(dev->ud_subdevs,
1051 			    dev->ud_subdevlen * sizeof(device_t));
1052 			dev->ud_subdevs = 0;
1053 			dev->ud_subdevlen = 0;
1054 		}
1055 		if (dev->ud_nifaces_claimed || err)
1056 			return err;
1057 	}
1058 	/* No interfaces were attached in any of the configurations. */
1059 
1060 	if (dd->bNumConfigurations > 1) /* don't change if only 1 config */
1061 		usbd_set_config_index(dev, 0, 0);
1062 
1063 	DPRINTF("no interface drivers found", 0, 0, 0, 0);
1064 
1065 	/* Finally try the generic driver. */
1066 	err = usbd_attachwholedevice(parent, dev, port, 1);
1067 
1068 	/*
1069 	 * The generic attach failed, but leave the device as it is.
1070 	 * We just did not find any drivers, that's all.  The device is
1071 	 * fully operational and not harming anyone.
1072 	 */
1073 	DPRINTF("generic attach failed", 0, 0, 0, 0);
1074 
1075 	return USBD_NORMAL_COMPLETION;
1076 }
1077 
1078 /**
1079  * Called from uhub_rescan().  usbd_new_device() for the target dev must be
1080  * called before calling this.
1081  */
1082 usbd_status
1083 usbd_reattach_device(device_t parent, struct usbd_device *dev,
1084                      int port, const int *locators)
1085 {
1086 	int i, loc;
1087 
1088 	if (locators != NULL) {
1089 		loc = locators[USBIFIFCF_PORT];
1090 		if (loc != USBIFIFCF_PORT_DEFAULT && loc != port)
1091 			return USBD_NORMAL_COMPLETION;
1092 		loc = locators[USBIFIFCF_VENDOR];
1093 		if (loc != USBIFIFCF_VENDOR_DEFAULT &&
1094 		    loc != UGETW(dev->ud_ddesc.idVendor))
1095 			return USBD_NORMAL_COMPLETION;
1096 		loc = locators[USBIFIFCF_PRODUCT];
1097 		if (loc != USBIFIFCF_PRODUCT_DEFAULT &&
1098 		    loc != UGETW(dev->ud_ddesc.idProduct))
1099 			return USBD_NORMAL_COMPLETION;
1100 		loc = locators[USBIFIFCF_RELEASE];
1101 		if (loc != USBIFIFCF_RELEASE_DEFAULT &&
1102 		    loc != UGETW(dev->ud_ddesc.bcdDevice))
1103 			return USBD_NORMAL_COMPLETION;
1104 	}
1105 	if (dev->ud_subdevlen == 0) {
1106 		/* XXX: check USBIFIFCF_CONFIGURATION and
1107 		 * USBIFIFCF_INTERFACE too */
1108 		return usbd_probe_and_attach(parent, dev, port, dev->ud_addr);
1109 	} else if (dev->ud_subdevlen != dev->ud_cdesc->bNumInterface) {
1110 		/* device-specific or generic driver is already attached. */
1111 		return USBD_NORMAL_COMPLETION;
1112 	}
1113 	/* Does the device have unconfigured interfaces? */
1114 	for (i = 0; i < dev->ud_subdevlen; i++) {
1115 		if (dev->ud_subdevs[i] == NULL) {
1116 			break;
1117 		}
1118 	}
1119 	if (i >= dev->ud_subdevlen)
1120 		return USBD_NORMAL_COMPLETION;
1121 	return usbd_attachinterfaces(parent, dev, port, locators);
1122 }
1123 
1124 /*
1125  * Get the first 8 bytes of the device descriptor.
1126  * Do as Windows does: try to read 64 bytes -- there are devices which
1127  * recognize the initial descriptor fetch (before the control endpoint's
1128  * MaxPacketSize is known by the host) by exactly this length.
1129  */
1130 usbd_status
1131 usbd_get_initial_ddesc(struct usbd_device *dev, usb_device_descriptor_t *desc)
1132 {
1133 	USBHIST_FUNC(); USBHIST_CALLED(usbdebug);
1134 	usb_device_request_t req;
1135 	char buf[64];
1136 	int res, actlen;
1137 
1138 	DPRINTFN(5, "dev %#jx", (uintptr_t)dev, 0, 0, 0);
1139 
1140 	req.bmRequestType = UT_READ_DEVICE;
1141 	req.bRequest = UR_GET_DESCRIPTOR;
1142 	USETW2(req.wValue, UDESC_DEVICE, 0);
1143 	USETW(req.wIndex, 0);
1144 	USETW(req.wLength, 64);
1145 	res = usbd_do_request_flags(dev, &req, buf, USBD_SHORT_XFER_OK,
1146 		&actlen, USBD_DEFAULT_TIMEOUT);
1147 	if (res)
1148 		return res;
1149 	if (actlen < 8)
1150 		return USBD_SHORT_XFER;
1151 	memcpy(desc, buf, 8);
1152 	return USBD_NORMAL_COMPLETION;
1153 }
1154 
1155 /*
1156  * Called when a new device has been put in the powered state,
1157  * but not yet in the addressed state.
1158  * Get initial descriptor, set the address, get full descriptor,
1159  * and attach a driver.
1160  */
1161 usbd_status
1162 usbd_new_device(device_t parent, struct usbd_bus *bus, int depth, int speed,
1163     int port, struct usbd_port *up)
1164 {
1165 	USBHIST_FUNC(); USBHIST_CALLED(usbdebug);
1166 	struct usbd_device *dev, *adev;
1167 	struct usbd_device *hub;
1168 	usb_device_descriptor_t *dd;
1169 	usb_port_status_t ps;
1170 	usbd_status err;
1171 	int addr;
1172 	int i;
1173 	int p;
1174 
1175 	DPRINTF("bus=%#jx port=%jd depth=%jd speed=%jd",
1176 	    (uintptr_t)bus, port, depth, speed);
1177 
1178 	if (bus->ub_methods->ubm_newdev != NULL)
1179 		return (bus->ub_methods->ubm_newdev)(parent, bus, depth, speed,
1180 		    port, up);
1181 
1182 	addr = usbd_getnewaddr(bus);
1183 	if (addr < 0) {
1184 		printf("%s: No free USB addresses, new device ignored.\n",
1185 		       device_xname(bus->ub_usbctl));
1186 		return USBD_NO_ADDR;
1187 	}
1188 
1189 	dev = kmem_zalloc(sizeof(*dev), KM_SLEEP);
1190 	dev->ud_bus = bus;
1191 
1192 	/* Set up default endpoint handle. */
1193 	dev->ud_ep0.ue_edesc = &dev->ud_ep0desc;
1194 
1195 	/* Set up default endpoint descriptor. */
1196 	dev->ud_ep0desc.bLength = USB_ENDPOINT_DESCRIPTOR_SIZE;
1197 	dev->ud_ep0desc.bDescriptorType = UDESC_ENDPOINT;
1198 	dev->ud_ep0desc.bEndpointAddress = USB_CONTROL_ENDPOINT;
1199 	dev->ud_ep0desc.bmAttributes = UE_CONTROL;
1200 	/*
1201 	 * temporary, will be fixed after first descriptor fetch
1202 	 * (which uses 64 bytes so it shouldn't be less),
1203 	 * highspeed devices must support 64 byte packets anyway
1204 	 */
1205 	if (speed == USB_SPEED_HIGH || speed == USB_SPEED_FULL)
1206 		USETW(dev->ud_ep0desc.wMaxPacketSize, 64);
1207 	else
1208 		USETW(dev->ud_ep0desc.wMaxPacketSize, USB_MAX_IPACKET);
1209 
1210 	dev->ud_ep0desc.bInterval = 0;
1211 
1212 	/* doesn't matter, just don't leave it uninitialized */
1213 	dev->ud_ep0.ue_toggle = 0;
1214 
1215 	dev->ud_quirks = &usbd_no_quirk;
1216 	dev->ud_addr = USB_START_ADDR;
1217 	dev->ud_ddesc.bMaxPacketSize = 0;
1218 	dev->ud_depth = depth;
1219 	dev->ud_powersrc = up;
1220 	dev->ud_myhub = up->up_parent;
1221 
1222 	up->up_dev = dev;
1223 
1224 	/* Locate port on upstream high speed hub */
1225 	for (adev = dev, hub = up->up_parent;
1226 	     hub != NULL && hub->ud_speed != USB_SPEED_HIGH;
1227 	     adev = hub, hub = hub->ud_myhub)
1228 		;
1229 	if (hub) {
1230 		for (p = 0; p < hub->ud_hub->uh_hubdesc.bNbrPorts; p++) {
1231 			if (hub->ud_hub->uh_ports[p].up_dev == adev) {
1232 				dev->ud_myhsport = &hub->ud_hub->uh_ports[p];
1233 				goto found;
1234 			}
1235 		}
1236 		panic("usbd_new_device: cannot find HS port");
1237 	found:
1238 		DPRINTFN(1, "high speed port %jd", p, 0, 0, 0);
1239 	} else {
1240 		dev->ud_myhsport = NULL;
1241 	}
1242 	dev->ud_speed = speed;
1243 	dev->ud_langid = USBD_NOLANG;
1244 	dev->ud_cookie.cookie = ++usb_cookie_no;
1245 
1246 	/* Establish the default pipe. */
1247 	err = usbd_setup_pipe_flags(dev, 0, &dev->ud_ep0, USBD_DEFAULT_INTERVAL,
1248 	    &dev->ud_pipe0, USBD_MPSAFE);
1249 	if (err) {
1250 		usbd_remove_device(dev, up);
1251 		return err;
1252 	}
1253 
1254 	dd = &dev->ud_ddesc;
1255 	/* Try a few times in case the device is slow (i.e. outside specs.) */
1256 	for (i = 0; i < 10; i++) {
1257 		/* Get the first 8 bytes of the device descriptor. */
1258 		err = usbd_get_initial_ddesc(dev, dd);
1259 		if (!err)
1260 			break;
1261 		/*
1262 		 * The root hub can never fail to give the initial descriptor,
1263 		 * but assert it just in case.
1264 		 */
1265 		KASSERT(up->up_parent);
1266 		usbd_delay_ms(dev, 200);
1267 		if ((i & 3) == 3)
1268 			usbd_reset_port(up->up_parent, port, &ps);
1269 	}
1270 	if (err) {
1271 		DPRINTF("addr=%jd, getting first desc failed: %jd", addr, err,
1272 		    0, 0);
1273 		usbd_remove_device(dev, up);
1274 		return err;
1275 	}
1276 
1277 	/* Windows resets the port here, do likewise */
1278 	if (up->up_parent)
1279 		usbd_reset_port(up->up_parent, port, &ps);
1280 
1281 	if (speed == USB_SPEED_HIGH) {
1282 		/* Max packet size must be 64 (sec 5.5.3). */
1283 		if (dd->bMaxPacketSize != USB_2_MAX_CTRL_PACKET) {
1284 #ifdef DIAGNOSTIC
1285 			printf("usbd_new_device: addr=%d bad max packet "
1286 			    "size=%d. adjusting to %d.\n",
1287 			    addr, dd->bMaxPacketSize, USB_2_MAX_CTRL_PACKET);
1288 #endif
1289 			dd->bMaxPacketSize = USB_2_MAX_CTRL_PACKET;
1290 		}
1291 	}
1292 
1293 	DPRINTF("adding unit addr=%jd, rev=%02jx, class=%jd, subclass=%jd",
1294 	    addr, UGETW(dd->bcdUSB), dd->bDeviceClass, dd->bDeviceSubClass);
1295 	DPRINTF("protocol=%jd, maxpacket=%jd, len=%jd, speed=%jd",
1296 	    dd->bDeviceProtocol, dd->bMaxPacketSize, dd->bLength, dev->ud_speed);
1297 
1298 	if (dd->bDescriptorType != UDESC_DEVICE) {
1299 		/* Illegal device descriptor */
1300 		DPRINTF("illegal descriptor %jd", dd->bDescriptorType, 0, 0, 0);
1301 		usbd_remove_device(dev, up);
1302 		return USBD_INVAL;
1303 	}
1304 
1305 	if (dd->bLength < USB_DEVICE_DESCRIPTOR_SIZE) {
1306 		DPRINTF("bad length %jd", dd->bLength, 0, 0, 0);
1307 		usbd_remove_device(dev, up);
1308 		return USBD_INVAL;
1309 	}
1310 
1311 	USETW(dev->ud_ep0desc.wMaxPacketSize, dd->bMaxPacketSize);
1312 
1313 	/* Re-establish the default pipe with the new MPS. */
1314 	usbd_kill_pipe(dev->ud_pipe0);
1315 	err = usbd_setup_pipe_flags(dev, 0, &dev->ud_ep0, USBD_DEFAULT_INTERVAL,
1316 	    &dev->ud_pipe0, USBD_MPSAFE);
1317 	if (err) {
1318 		DPRINTF("setup default pipe failed err %jd", err, 0, 0, 0);
1319 		usbd_remove_device(dev, up);
1320 		return err;
1321 	}
1322 
1323 	/* Set the address */
1324 	DPRINTFN(5, "setting device address=%jd", addr, 0, 0, 0);
1325 	err = usbd_set_address(dev, addr);
1326 	if (err) {
1327 		DPRINTF("set address %jd failed, err = %jd", addr, err, 0, 0);
1328 		err = USBD_SET_ADDR_FAILED;
1329 		usbd_remove_device(dev, up);
1330 		return err;
1331 	}
1332 
1333 	/* Allow device time to set new address */
1334 	usbd_delay_ms(dev, USB_SET_ADDRESS_SETTLE);
1335 	dev->ud_addr = addr;	/* new device address now */
1336 	bus->ub_devices[usb_addr2dindex(addr)] = dev;
1337 
1338 	/* Re-establish the default pipe with the new address. */
1339 	usbd_kill_pipe(dev->ud_pipe0);
1340 	err = usbd_setup_pipe_flags(dev, 0, &dev->ud_ep0, USBD_DEFAULT_INTERVAL,
1341 	    &dev->ud_pipe0, USBD_MPSAFE);
1342 	if (err) {
1343 		DPRINTF("setup default pipe failed, err = %jd", err, 0, 0, 0);
1344 		usbd_remove_device(dev, up);
1345 		return err;
1346 	}
1347 
1348 	err = usbd_reload_device_desc(dev);
1349 	if (err) {
1350 		DPRINTF("addr=%jd, getting full desc failed, err = %jd", addr,
1351 		    err, 0, 0);
1352 		usbd_remove_device(dev, up);
1353 		return err;
1354 	}
1355 
1356 	/* Assume 100mA bus powered for now. Changed when configured. */
1357 	dev->ud_power = USB_MIN_POWER;
1358 	dev->ud_selfpowered = 0;
1359 
1360 	DPRINTF("new dev (addr %jd), dev=%#jx, parent=%#jx",
1361 	    addr, (uintptr_t)dev, (uintptr_t)parent, 0);
1362 
1363 	usbd_get_device_strings(dev);
1364 
1365 	usbd_add_dev_event(USB_EVENT_DEVICE_ATTACH, dev);
1366 
1367 	if (port == 0) { /* root hub */
1368 		KASSERT(addr == 1);
1369 		usbd_attach_roothub(parent, dev);
1370 		return USBD_NORMAL_COMPLETION;
1371 	}
1372 
1373 	err = usbd_probe_and_attach(parent, dev, port, addr);
1374 	if (err) {
1375 		usbd_remove_device(dev, up);
1376 		return err;
1377 	}
1378 
1379 	return USBD_NORMAL_COMPLETION;
1380 }
1381 
1382 usbd_status
1383 usbd_reload_device_desc(struct usbd_device *dev)
1384 {
1385 	USBHIST_FUNC(); USBHIST_CALLED(usbdebug);
1386 	usb_device_descriptor_t *udd = &dev->ud_ddesc;
1387 	usbd_status err;
1388 
1389 	/* Get the full device descriptor. */
1390 	err = usbd_get_device_desc(dev, udd);
1391 	if (err)
1392 		return err;
1393 
1394 	DPRINTFN(15, "bLength             %5ju", udd->bLength, 0, 0, 0);
1395 	DPRINTFN(15, "bDescriptorType     %5ju", udd->bDescriptorType, 0, 0, 0);
1396 	DPRINTFN(15, "bcdUSB              %2jx.%02jx", udd->bcdUSB[1],
1397 	    udd->bcdUSB[0], 0, 0);
1398 	DPRINTFN(15, "bDeviceClass        %5ju", udd->bDeviceClass, 0, 0, 0);
1399 	DPRINTFN(15, "bDeviceSubClass     %5ju", udd->bDeviceSubClass, 0, 0, 0);
1400 	DPRINTFN(15, "bDeviceProtocol     %5ju", udd->bDeviceProtocol, 0, 0, 0);
1401 	DPRINTFN(15, "bMaxPacketSize0     %5ju", udd->bMaxPacketSize, 0, 0, 0);
1402 	DPRINTFN(15, "idVendor            %#02jx %#02jx",
1403 						    udd->idVendor[0],
1404 						    udd->idVendor[1], 0, 0);
1405 	DPRINTFN(15, "idProduct           %#02jx %#02jx",
1406 						    udd->idProduct[0],
1407 						    udd->idProduct[1], 0, 0);
1408 	DPRINTFN(15, "bcdDevice           %2jx.%02jx", udd->bcdDevice[1],
1409 	    udd->bcdDevice[0], 0, 0);
1410 	DPRINTFN(15, "iManufacturer       %5ju", udd->iManufacturer, 0, 0, 0);
1411 	DPRINTFN(15, "iProduct            %5ju", udd->iProduct, 0, 0, 0);
1412 	DPRINTFN(15, "iSerial             %5ju", udd->iSerialNumber, 0, 0, 0);
1413 	DPRINTFN(15, "bNumConfigurations  %5ju", udd->bNumConfigurations, 0, 0,
1414 	    0);
1415 
1416 	/* Figure out what's wrong with this device. */
1417 	dev->ud_quirks = usbd_find_quirk(udd);
1418 
1419 	return USBD_NORMAL_COMPLETION;
1420 }
1421 
1422 void
1423 usbd_remove_device(struct usbd_device *dev, struct usbd_port *up)
1424 {
1425 
1426 	USBHIST_FUNC(); USBHIST_CALLED(usbdebug);
1427 
1428 	DPRINTF("dev %#jx up %#jx", (uintptr_t)dev, (uintptr_t)up, 0, 0);
1429 
1430 	if (dev->ud_pipe0 != NULL)
1431 		usbd_kill_pipe(dev->ud_pipe0);
1432 	up->up_dev = NULL;
1433 	dev->ud_bus->ub_devices[usb_addr2dindex(dev->ud_addr)] = NULL;
1434 
1435 	kmem_free(dev, sizeof(*dev));
1436 }
1437 
1438 int
1439 usbd_print(void *aux, const char *pnp)
1440 {
1441 	struct usb_attach_arg *uaa = aux;
1442 
1443 	if (pnp) {
1444 #define USB_DEVINFO 1024
1445 		char *devinfo;
1446 		if (!uaa->uaa_usegeneric)
1447 			return QUIET;
1448 		devinfo = kmem_alloc(USB_DEVINFO, KM_SLEEP);
1449 		usbd_devinfo(uaa->uaa_device, 1, devinfo, USB_DEVINFO);
1450 		aprint_normal("%s, %s", devinfo, pnp);
1451 		kmem_free(devinfo, USB_DEVINFO);
1452 	}
1453 	aprint_normal(" port %d", uaa->uaa_port);
1454 #if 0
1455 	/*
1456 	 * It gets very crowded with these locators on the attach line.
1457 	 * They are not really needed since they are printed in the clear
1458 	 * by each driver.
1459 	 */
1460 	if (uaa->uaa_vendor != UHUB_UNK_VENDOR)
1461 		aprint_normal(" vendor %#04x", uaa->uaa_vendor);
1462 	if (uaa->uaa_product != UHUB_UNK_PRODUCT)
1463 		aprint_normal(" product %#04x", uaa->uaa_product);
1464 	if (uaa->uaa_release != UHUB_UNK_RELEASE)
1465 		aprint_normal(" release %#04x", uaa->uaa_release);
1466 #endif
1467 	return UNCONF;
1468 }
1469 
1470 int
1471 usbd_ifprint(void *aux, const char *pnp)
1472 {
1473 	struct usbif_attach_arg *uiaa = aux;
1474 
1475 	if (pnp)
1476 		return QUIET;
1477 	aprint_normal(" port %d", uiaa->uiaa_port);
1478 	aprint_normal(" configuration %d", uiaa->uiaa_configno);
1479 	aprint_normal(" interface %d", uiaa->uiaa_ifaceno);
1480 #if 0
1481 	/*
1482 	 * It gets very crowded with these locators on the attach line.
1483 	 * They are not really needed since they are printed in the clear
1484 	 * by each driver.
1485 	 */
1486 	if (uaa->uaa_vendor != UHUB_UNK_VENDOR)
1487 		aprint_normal(" vendor %#04x", uaa->uaa_vendor);
1488 	if (uaa->uaa_product != UHUB_UNK_PRODUCT)
1489 		aprint_normal(" product %#04x", uaa->uaa_product);
1490 	if (uaa->uaa_release != UHUB_UNK_RELEASE)
1491 		aprint_normal(" release %#04x", uaa->uaa_release);
1492 #endif
1493 	return UNCONF;
1494 }
1495 
1496 void
1497 usbd_fill_deviceinfo(struct usbd_device *dev, struct usb_device_info *di,
1498 		     int usedev)
1499 {
1500 	struct usbd_port *p;
1501 	int i, j, err;
1502 
1503 	di->udi_bus = device_unit(dev->ud_bus->ub_usbctl);
1504 	di->udi_addr = dev->ud_addr;
1505 	di->udi_cookie = dev->ud_cookie;
1506 	usbd_devinfo_vp(dev, di->udi_vendor, sizeof(di->udi_vendor),
1507 	    di->udi_product, sizeof(di->udi_product), usedev, 1);
1508 	usbd_printBCD(di->udi_release, sizeof(di->udi_release),
1509 	    UGETW(dev->ud_ddesc.bcdDevice));
1510 	if (usedev) {
1511 		usbd_status uerr = usbd_get_string(dev,
1512 		    dev->ud_ddesc.iSerialNumber, di->udi_serial);
1513 		if (uerr != USBD_NORMAL_COMPLETION) {
1514 			di->udi_serial[0] = '\0';
1515 		} else {
1516 			usbd_trim_spaces(di->udi_serial);
1517 		}
1518 	} else {
1519 		di->udi_serial[0] = '\0';
1520 		if (dev->ud_serial) {
1521 			strlcpy(di->udi_serial, dev->ud_serial,
1522 			    sizeof(di->udi_serial));
1523 		}
1524 	}
1525 
1526 	di->udi_vendorNo = UGETW(dev->ud_ddesc.idVendor);
1527 	di->udi_productNo = UGETW(dev->ud_ddesc.idProduct);
1528 	di->udi_releaseNo = UGETW(dev->ud_ddesc.bcdDevice);
1529 	di->udi_class = dev->ud_ddesc.bDeviceClass;
1530 	di->udi_subclass = dev->ud_ddesc.bDeviceSubClass;
1531 	di->udi_protocol = dev->ud_ddesc.bDeviceProtocol;
1532 	di->udi_config = dev->ud_config;
1533 	di->udi_power = dev->ud_selfpowered ? 0 : dev->ud_power;
1534 	di->udi_speed = dev->ud_speed;
1535 
1536 	if (dev->ud_subdevlen > 0) {
1537 		for (i = 0, j = 0; i < dev->ud_subdevlen &&
1538 			     j < USB_MAX_DEVNAMES; i++) {
1539 			if (!dev->ud_subdevs[i])
1540 				continue;
1541 			strncpy(di->udi_devnames[j],
1542 			    device_xname(dev->ud_subdevs[i]), USB_MAX_DEVNAMELEN);
1543 			di->udi_devnames[j][USB_MAX_DEVNAMELEN-1] = '\0';
1544 			j++;
1545 		}
1546 	} else {
1547 		j = 0;
1548 	}
1549 	for (/* j is set */; j < USB_MAX_DEVNAMES; j++)
1550 		di->udi_devnames[j][0] = 0;                 /* empty */
1551 
1552 	if (!dev->ud_hub) {
1553 		di->udi_nports = 0;
1554 		return;
1555 	}
1556 
1557 	const int nports = dev->ud_hub->uh_hubdesc.bNbrPorts;
1558 	for (i = 0; i < __arraycount(di->udi_ports) && i < nports; i++) {
1559 		p = &dev->ud_hub->uh_ports[i];
1560 		if (p->up_dev)
1561 			err = p->up_dev->ud_addr;
1562 		else {
1563 			const int s = UGETW(p->up_status.wPortStatus);
1564 			const bool sshub_p = USB_IS_SS(dev->ud_speed);
1565 			if (s & UPS_PORT_ENABLED)
1566 				err = USB_PORT_ENABLED;
1567 			else if (s & UPS_SUSPEND)
1568 				err = USB_PORT_SUSPENDED;
1569 			/*
1570 			 * Note: UPS_PORT_POWER_SS is available only
1571 			 * on 3.x, and UPS_PORT_POWER is available
1572 			 * only on 2.0 or 1.1.
1573 			 */
1574 			else if (sshub_p && (s & UPS_PORT_POWER_SS))
1575 				err = USB_PORT_POWERED;
1576 			else if (!sshub_p && (s & UPS_PORT_POWER))
1577 				err = USB_PORT_POWERED;
1578 			else
1579 				err = USB_PORT_DISABLED;
1580 		}
1581 		di->udi_ports[i] = err;
1582 	}
1583 	di->udi_nports = nports;
1584 }
1585 
1586 #ifdef COMPAT_30
1587 void
1588 usbd_fill_deviceinfo_old(struct usbd_device *dev, struct usb_device_info_old *di,
1589                          int usedev)
1590 {
1591 	struct usbd_port *p;
1592 	int i, j, err;
1593 
1594 	di->udi_bus = device_unit(dev->ud_bus->ub_usbctl);
1595 	di->udi_addr = dev->ud_addr;
1596 	di->udi_cookie = dev->ud_cookie;
1597 	usbd_devinfo_vp(dev, di->udi_vendor, sizeof(di->udi_vendor),
1598 	    di->udi_product, sizeof(di->udi_product), usedev, 0);
1599 	usbd_printBCD(di->udi_release, sizeof(di->udi_release),
1600 	    UGETW(dev->ud_ddesc.bcdDevice));
1601 	di->udi_vendorNo = UGETW(dev->ud_ddesc.idVendor);
1602 	di->udi_productNo = UGETW(dev->ud_ddesc.idProduct);
1603 	di->udi_releaseNo = UGETW(dev->ud_ddesc.bcdDevice);
1604 	di->udi_class = dev->ud_ddesc.bDeviceClass;
1605 	di->udi_subclass = dev->ud_ddesc.bDeviceSubClass;
1606 	di->udi_protocol = dev->ud_ddesc.bDeviceProtocol;
1607 	di->udi_config = dev->ud_config;
1608 	di->udi_power = dev->ud_selfpowered ? 0 : dev->ud_power;
1609 	di->udi_speed = dev->ud_speed;
1610 
1611 	if (dev->ud_subdevlen > 0) {
1612 		for (i = 0, j = 0; i < dev->ud_subdevlen &&
1613 			     j < USB_MAX_DEVNAMES; i++) {
1614 			if (!dev->ud_subdevs[i])
1615 				continue;
1616 			strncpy(di->udi_devnames[j],
1617 			    device_xname(dev->ud_subdevs[i]), USB_MAX_DEVNAMELEN);
1618 			di->udi_devnames[j][USB_MAX_DEVNAMELEN-1] = '\0';
1619 			j++;
1620 		}
1621 	} else {
1622 		j = 0;
1623 	}
1624 	for (/* j is set */; j < USB_MAX_DEVNAMES; j++)
1625 		di->udi_devnames[j][0] = 0;		 /* empty */
1626 
1627 	if (!dev->ud_hub) {
1628 		di->udi_nports = 0;
1629 		return;
1630 	}
1631 
1632 	const int nports = dev->ud_hub->uh_hubdesc.bNbrPorts;
1633 	for (i = 0; i < __arraycount(di->udi_ports) && i < nports;
1634 	     i++) {
1635 		p = &dev->ud_hub->uh_ports[i];
1636 		if (p->up_dev)
1637 			err = p->up_dev->ud_addr;
1638 		else {
1639 			const int s = UGETW(p->up_status.wPortStatus);
1640 			if (s & UPS_PORT_ENABLED)
1641 				err = USB_PORT_ENABLED;
1642 			else if (s & UPS_SUSPEND)
1643 				err = USB_PORT_SUSPENDED;
1644 			else if (s & UPS_PORT_POWER)
1645 				err = USB_PORT_POWERED;
1646 			else
1647 				err = USB_PORT_DISABLED;
1648 		}
1649 		di->udi_ports[i] = err;
1650 	}
1651 	di->udi_nports = nports;
1652 }
1653 #endif
1654 
1655 
1656 void
1657 usb_free_device(struct usbd_device *dev)
1658 {
1659 	int ifcidx, nifc;
1660 
1661 	if (dev->ud_pipe0 != NULL)
1662 		usbd_kill_pipe(dev->ud_pipe0);
1663 	if (dev->ud_ifaces != NULL) {
1664 		nifc = dev->ud_cdesc->bNumInterface;
1665 		for (ifcidx = 0; ifcidx < nifc; ifcidx++)
1666 			usbd_free_iface_data(dev, ifcidx);
1667 		kmem_free(dev->ud_ifaces,
1668 		    nifc * sizeof(struct usbd_interface));
1669 	}
1670 	if (dev->ud_cdesc != NULL)
1671 		kmem_free(dev->ud_cdesc, UGETW(dev->ud_cdesc->wTotalLength));
1672 	if (dev->ud_bdesc != NULL)
1673 		kmem_free(dev->ud_bdesc, UGETW(dev->ud_bdesc->wTotalLength));
1674 	if (dev->ud_subdevlen > 0) {
1675 		kmem_free(dev->ud_subdevs,
1676 		    dev->ud_subdevlen * sizeof(device_t));
1677 		dev->ud_subdevlen = 0;
1678 	}
1679 	if (dev->ud_vendor) {
1680 		kmem_free(dev->ud_vendor, USB_MAX_ENCODED_STRING_LEN);
1681 	}
1682 	if (dev->ud_product) {
1683 		kmem_free(dev->ud_product, USB_MAX_ENCODED_STRING_LEN);
1684 	}
1685 	if (dev->ud_serial) {
1686 		kmem_free(dev->ud_serial, USB_MAX_ENCODED_STRING_LEN);
1687 	}
1688 	kmem_free(dev, sizeof(*dev));
1689 }
1690 
1691 /*
1692  * The general mechanism for detaching drivers works as follows: Each
1693  * driver is responsible for maintaining a reference count on the
1694  * number of outstanding references to its softc (e.g.  from
1695  * processing hanging in a read or write).  The detach method of the
1696  * driver decrements this counter and flags in the softc that the
1697  * driver is dying and then wakes any sleepers.  It then sleeps on the
1698  * softc.  Each place that can sleep must maintain the reference
1699  * count.  When the reference count drops to -1 (0 is the normal value
1700  * of the reference count) then a wakeup on the softc is performed
1701  * signaling to the detach waiter that all references are gone.
1702  */
1703 
1704 /*
1705  * Called from process context when we discover that a port has
1706  * been disconnected.
1707  */
1708 int
1709 usb_disconnect_port(struct usbd_port *up, device_t parent, int flags)
1710 {
1711 	USBHIST_FUNC(); USBHIST_CALLED(usbdebug);
1712 	struct usbd_device *dev = up->up_dev;
1713 	device_t subdev;
1714 	char subdevname[16];
1715 	const char *hubname = device_xname(parent);
1716 	int i, rc;
1717 
1718 	DPRINTFN(3, "up=%#jx dev=%#jx port=%jd", (uintptr_t)up, (uintptr_t)dev,
1719 	    up->up_portno, 0);
1720 
1721 	if (dev == NULL) {
1722 		return 0;
1723 	}
1724 
1725 	if (dev->ud_subdevlen > 0) {
1726 		DPRINTFN(3, "disconnect subdevs", 0, 0, 0, 0);
1727 		for (i = 0; i < dev->ud_subdevlen; i++) {
1728 			if ((subdev = dev->ud_subdevs[i]) == NULL)
1729 				continue;
1730 			strlcpy(subdevname, device_xname(subdev),
1731 			    sizeof(subdevname));
1732 			KERNEL_LOCK(1, curlwp);
1733 			rc = config_detach(subdev, flags);
1734 			KERNEL_UNLOCK_ONE(curlwp);
1735 			if (rc != 0)
1736 				return rc;
1737 			printf("%s: at %s", subdevname, hubname);
1738 			if (up->up_portno != 0)
1739 				printf(" port %d", up->up_portno);
1740 			printf(" (addr %d) disconnected\n", dev->ud_addr);
1741 		}
1742 		KASSERT(!dev->ud_nifaces_claimed);
1743 	}
1744 
1745 	mutex_enter(dev->ud_bus->ub_lock);
1746 	dev->ud_bus->ub_devices[usb_addr2dindex(dev->ud_addr)] = NULL;
1747 	up->up_dev = NULL;
1748 	mutex_exit(dev->ud_bus->ub_lock);
1749 
1750 	usbd_add_dev_event(USB_EVENT_DEVICE_DETACH, dev);
1751 
1752 	usb_free_device(dev);
1753 
1754 	return 0;
1755 }
1756