usb.c revision 1.164.2.1 1 /* $NetBSD: usb.c,v 1.164.2.1 2017/04/21 16:53:53 bouyer Exp $ */
2
3 /*
4 * Copyright (c) 1998, 2002, 2008, 2012 The NetBSD Foundation, Inc.
5 * All rights reserved.
6 *
7 * This code is derived from software contributed to The NetBSD Foundation
8 * by Lennart Augustsson (lennart (at) augustsson.net) at
9 * Carlstedt Research & Technology and Matthew R. Green (mrg (at) eterna.com.au).
10 *
11 * Redistribution and use in source and binary forms, with or without
12 * modification, are permitted provided that the following conditions
13 * are met:
14 * 1. Redistributions of source code must retain the above copyright
15 * notice, this list of conditions and the following disclaimer.
16 * 2. Redistributions in binary form must reproduce the above copyright
17 * notice, this list of conditions and the following disclaimer in the
18 * documentation and/or other materials provided with the distribution.
19 *
20 * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
21 * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
22 * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
23 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
24 * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
25 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
26 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
27 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
28 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
29 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
30 * POSSIBILITY OF SUCH DAMAGE.
31 */
32
33 /*
34 * USB specifications and other documentation can be found at
35 * http://www.usb.org/developers/docs/ and
36 * http://www.usb.org/developers/devclass_docs/
37 */
38
39 #include <sys/cdefs.h>
40 __KERNEL_RCSID(0, "$NetBSD: usb.c,v 1.164.2.1 2017/04/21 16:53:53 bouyer Exp $");
41
42 #ifdef _KERNEL_OPT
43 #include "opt_usb.h"
44 #include "opt_compat_netbsd.h"
45 #endif
46
47 #include <sys/param.h>
48 #include <sys/systm.h>
49 #include <sys/kernel.h>
50 #include <sys/kmem.h>
51 #include <sys/device.h>
52 #include <sys/kthread.h>
53 #include <sys/proc.h>
54 #include <sys/conf.h>
55 #include <sys/fcntl.h>
56 #include <sys/poll.h>
57 #include <sys/select.h>
58 #include <sys/vnode.h>
59 #include <sys/signalvar.h>
60 #include <sys/intr.h>
61 #include <sys/module.h>
62 #include <sys/mutex.h>
63 #include <sys/bus.h>
64 #include <sys/once.h>
65 #include <sys/atomic.h>
66 #include <sys/sysctl.h>
67
68 #include <dev/usb/usb.h>
69 #include <dev/usb/usbdi.h>
70 #include <dev/usb/usbdi_util.h>
71 #include <dev/usb/usbdivar.h>
72 #include <dev/usb/usb_verbose.h>
73 #include <dev/usb/usb_quirks.h>
74 #include <dev/usb/usbhist.h>
75
76 #if defined(USB_DEBUG)
77
78 #ifndef USBHIST_SIZE
79 #define USBHIST_SIZE 50000
80 #endif
81
82 static struct kern_history_ent usbhistbuf[USBHIST_SIZE];
83 USBHIST_DEFINE(usbhist) = KERNHIST_INITIALIZER(usbhist, usbhistbuf);
84
85 #endif
86
87 #define USB_DEV_MINOR 255
88
89 #ifdef USB_DEBUG
90 /*
91 * 0 - do usual exploration
92 * 1 - do not use timeout exploration
93 * >1 - do no exploration
94 */
95 int usb_noexplore = 0;
96
97 int usbdebug = 0;
98 SYSCTL_SETUP(sysctl_hw_usb_setup, "sysctl hw.usb setup")
99 {
100 int err;
101 const struct sysctlnode *rnode;
102 const struct sysctlnode *cnode;
103
104 err = sysctl_createv(clog, 0, NULL, &rnode,
105 CTLFLAG_PERMANENT, CTLTYPE_NODE, "usb",
106 SYSCTL_DESCR("usb global controls"),
107 NULL, 0, NULL, 0, CTL_HW, CTL_CREATE, CTL_EOL);
108
109 if (err)
110 goto fail;
111
112 /* control debugging printfs */
113 err = sysctl_createv(clog, 0, &rnode, &cnode,
114 CTLFLAG_PERMANENT|CTLFLAG_READWRITE, CTLTYPE_INT,
115 "debug", SYSCTL_DESCR("Enable debugging output"),
116 NULL, 0, &usbdebug, sizeof(usbdebug), CTL_CREATE, CTL_EOL);
117 if (err)
118 goto fail;
119
120 return;
121 fail:
122 aprint_error("%s: sysctl_createv failed (err = %d)\n", __func__, err);
123 }
124 #else
125 #define usb_noexplore 0
126 #endif
127
128 #define DPRINTF(FMT,A,B,C,D) USBHIST_LOG(usbdebug,FMT,A,B,C,D)
129 #define DPRINTFN(N,FMT,A,B,C,D) USBHIST_LOGN(usbdebug,N,FMT,A,B,C,D)
130
131 struct usb_softc {
132 #if 0
133 device_t sc_dev; /* base device */
134 #endif
135 struct usbd_bus *sc_bus; /* USB controller */
136 struct usbd_port sc_port; /* dummy port for root hub */
137
138 struct lwp *sc_event_thread;
139
140 char sc_dying;
141 };
142
143 struct usb_taskq {
144 TAILQ_HEAD(, usb_task) tasks;
145 kmutex_t lock;
146 kcondvar_t cv;
147 struct lwp *task_thread_lwp;
148 const char *name;
149 };
150
151 static struct usb_taskq usb_taskq[USB_NUM_TASKQS];
152
153 dev_type_open(usbopen);
154 dev_type_close(usbclose);
155 dev_type_read(usbread);
156 dev_type_ioctl(usbioctl);
157 dev_type_poll(usbpoll);
158 dev_type_kqfilter(usbkqfilter);
159
160 const struct cdevsw usb_cdevsw = {
161 .d_open = usbopen,
162 .d_close = usbclose,
163 .d_read = usbread,
164 .d_write = nowrite,
165 .d_ioctl = usbioctl,
166 .d_stop = nostop,
167 .d_tty = notty,
168 .d_poll = usbpoll,
169 .d_mmap = nommap,
170 .d_kqfilter = usbkqfilter,
171 .d_discard = nodiscard,
172 .d_flag = D_OTHER
173 };
174
175 Static void usb_discover(struct usb_softc *);
176 Static void usb_create_event_thread(device_t);
177 Static void usb_event_thread(void *);
178 Static void usb_task_thread(void *);
179
180 #define USB_MAX_EVENTS 100
181 struct usb_event_q {
182 struct usb_event ue;
183 SIMPLEQ_ENTRY(usb_event_q) next;
184 };
185 Static SIMPLEQ_HEAD(, usb_event_q) usb_events =
186 SIMPLEQ_HEAD_INITIALIZER(usb_events);
187 Static int usb_nevents = 0;
188 Static struct selinfo usb_selevent;
189 Static kmutex_t usb_event_lock;
190 Static kcondvar_t usb_event_cv;
191 Static proc_t *usb_async_proc; /* process that wants USB SIGIO */
192 Static void *usb_async_sih;
193 Static int usb_dev_open = 0;
194 Static struct usb_event *usb_alloc_event(void);
195 Static void usb_free_event(struct usb_event *);
196 Static void usb_add_event(int, struct usb_event *);
197 Static int usb_get_next_event(struct usb_event *);
198 Static void usb_async_intr(void *);
199 Static void usb_soft_intr(void *);
200
201 #ifdef COMPAT_30
202 Static void usb_copy_old_devinfo(struct usb_device_info_old *, const struct usb_device_info *);
203 #endif
204
205 Static const char *usbrev_str[] = USBREV_STR;
206
207 static int usb_match(device_t, cfdata_t, void *);
208 static void usb_attach(device_t, device_t, void *);
209 static int usb_detach(device_t, int);
210 static int usb_activate(device_t, enum devact);
211 static void usb_childdet(device_t, device_t);
212 static int usb_once_init(void);
213 static void usb_doattach(device_t);
214
215 extern struct cfdriver usb_cd;
216
217 CFATTACH_DECL3_NEW(usb, sizeof(struct usb_softc),
218 usb_match, usb_attach, usb_detach, usb_activate, NULL, usb_childdet,
219 DVF_DETACH_SHUTDOWN);
220
221 static const char *taskq_names[] = USB_TASKQ_NAMES;
222
223 int
224 usb_match(device_t parent, cfdata_t match, void *aux)
225 {
226 USBHIST_FUNC(); USBHIST_CALLED(usbdebug);
227
228 return UMATCH_GENERIC;
229 }
230
231 void
232 usb_attach(device_t parent, device_t self, void *aux)
233 {
234 static ONCE_DECL(init_control);
235 struct usb_softc *sc = device_private(self);
236 int usbrev;
237
238 sc->sc_bus = aux;
239 usbrev = sc->sc_bus->ub_revision;
240
241 aprint_naive("\n");
242 aprint_normal(": USB revision %s", usbrev_str[usbrev]);
243 switch (usbrev) {
244 case USBREV_1_0:
245 case USBREV_1_1:
246 case USBREV_2_0:
247 case USBREV_3_0:
248 break;
249 default:
250 aprint_error(", not supported\n");
251 sc->sc_dying = 1;
252 return;
253 }
254 aprint_normal("\n");
255
256 /* XXX we should have our own level */
257 sc->sc_bus->ub_soft = softint_establish(SOFTINT_USB | SOFTINT_MPSAFE,
258 usb_soft_intr, sc->sc_bus);
259 if (sc->sc_bus->ub_soft == NULL) {
260 aprint_error("%s: can't register softintr\n",
261 device_xname(self));
262 sc->sc_dying = 1;
263 return;
264 }
265
266 sc->sc_bus->ub_methods->ubm_getlock(sc->sc_bus, &sc->sc_bus->ub_lock);
267 KASSERT(sc->sc_bus->ub_lock != NULL);
268
269 RUN_ONCE(&init_control, usb_once_init);
270 config_interrupts(self, usb_doattach);
271 }
272
273 static int
274 usb_once_init(void)
275 {
276 struct usb_taskq *taskq;
277 int i;
278
279 USBHIST_LINK_STATIC(usbhist);
280
281 selinit(&usb_selevent);
282 mutex_init(&usb_event_lock, MUTEX_DEFAULT, IPL_NONE);
283 cv_init(&usb_event_cv, "usbrea");
284
285 for (i = 0; i < USB_NUM_TASKQS; i++) {
286 taskq = &usb_taskq[i];
287
288 TAILQ_INIT(&taskq->tasks);
289 /*
290 * Since USB task methods usb_{add,rem}_task are callable
291 * from any context, we have to make this lock a spinlock.
292 */
293 mutex_init(&taskq->lock, MUTEX_DEFAULT, IPL_USB);
294 cv_init(&taskq->cv, "usbtsk");
295 taskq->name = taskq_names[i];
296 if (kthread_create(PRI_NONE, KTHREAD_MPSAFE, NULL,
297 usb_task_thread, taskq, &taskq->task_thread_lwp,
298 "%s", taskq->name)) {
299 printf("unable to create task thread: %s\n", taskq->name);
300 panic("usb_create_event_thread task");
301 }
302 /*
303 * XXX we should make sure these threads are alive before
304 * end up using them in usb_doattach().
305 */
306 }
307 return 0;
308 }
309
310 static void
311 usb_doattach(device_t self)
312 {
313 struct usb_softc *sc = device_private(self);
314 struct usbd_device *dev;
315 usbd_status err;
316 int speed;
317 struct usb_event *ue;
318
319 USBHIST_FUNC(); USBHIST_CALLED(usbdebug);
320
321 sc->sc_bus->ub_usbctl = self;
322 sc->sc_port.up_power = USB_MAX_POWER;
323
324 switch (sc->sc_bus->ub_revision) {
325 case USBREV_1_0:
326 case USBREV_1_1:
327 speed = USB_SPEED_FULL;
328 break;
329 case USBREV_2_0:
330 speed = USB_SPEED_HIGH;
331 break;
332 case USBREV_3_0:
333 speed = USB_SPEED_SUPER;
334 break;
335 default:
336 panic("usb_doattach");
337 }
338
339 cv_init(&sc->sc_bus->ub_needsexplore_cv, "usbevt");
340
341 ue = usb_alloc_event();
342 ue->u.ue_ctrlr.ue_bus = device_unit(self);
343 usb_add_event(USB_EVENT_CTRLR_ATTACH, ue);
344
345 err = usbd_new_device(self, sc->sc_bus, 0, speed, 0,
346 &sc->sc_port);
347 if (!err) {
348 dev = sc->sc_port.up_dev;
349 if (dev->ud_hub == NULL) {
350 sc->sc_dying = 1;
351 aprint_error("%s: root device is not a hub\n",
352 device_xname(self));
353 return;
354 }
355 sc->sc_bus->ub_roothub = dev;
356 usb_create_event_thread(self);
357 #if 1
358 /*
359 * Turning this code off will delay attachment of USB devices
360 * until the USB event thread is running, which means that
361 * the keyboard will not work until after cold boot.
362 */
363 if (cold && (device_cfdata(self)->cf_flags & 1))
364 dev->ud_hub->uh_explore(sc->sc_bus->ub_roothub);
365 #endif
366 } else {
367 aprint_error("%s: root hub problem, error=%s\n",
368 device_xname(self), usbd_errstr(err));
369 sc->sc_dying = 1;
370 }
371
372 config_pending_incr(self);
373
374 if (!pmf_device_register(self, NULL, NULL))
375 aprint_error_dev(self, "couldn't establish power handler\n");
376
377 usb_async_sih = softint_establish(SOFTINT_CLOCK | SOFTINT_MPSAFE,
378 usb_async_intr, NULL);
379
380 return;
381 }
382
383 void
384 usb_create_event_thread(device_t self)
385 {
386 struct usb_softc *sc = device_private(self);
387
388 if (kthread_create(PRI_NONE, KTHREAD_MPSAFE, NULL,
389 usb_event_thread, sc, &sc->sc_event_thread,
390 "%s", device_xname(self))) {
391 printf("%s: unable to create event thread for\n",
392 device_xname(self));
393 panic("usb_create_event_thread");
394 }
395 }
396
397 /*
398 * Add a task to be performed by the task thread. This function can be
399 * called from any context and the task will be executed in a process
400 * context ASAP.
401 */
402 void
403 usb_add_task(struct usbd_device *dev, struct usb_task *task, int queue)
404 {
405 struct usb_taskq *taskq;
406
407 USBHIST_FUNC(); USBHIST_CALLED(usbdebug);
408
409 KASSERT(0 <= queue);
410 KASSERT(queue < USB_NUM_TASKQS);
411 taskq = &usb_taskq[queue];
412 mutex_enter(&taskq->lock);
413 if (atomic_cas_uint(&task->queue, USB_NUM_TASKQS, queue) ==
414 USB_NUM_TASKQS) {
415 DPRINTFN(2, "task=%p", task, 0, 0, 0);
416 TAILQ_INSERT_TAIL(&taskq->tasks, task, next);
417 cv_signal(&taskq->cv);
418 } else {
419 DPRINTFN(2, "task=%p on q", task, 0, 0, 0);
420 }
421 mutex_exit(&taskq->lock);
422 }
423
424 /*
425 * XXX This does not wait for completion! Most uses need such an
426 * operation. Urgh...
427 */
428 void
429 usb_rem_task(struct usbd_device *dev, struct usb_task *task)
430 {
431 unsigned queue;
432
433 USBHIST_FUNC(); USBHIST_CALLED(usbdebug);
434
435 while ((queue = task->queue) != USB_NUM_TASKQS) {
436 struct usb_taskq *taskq = &usb_taskq[queue];
437 mutex_enter(&taskq->lock);
438 if (__predict_true(task->queue == queue)) {
439 TAILQ_REMOVE(&taskq->tasks, task, next);
440 task->queue = USB_NUM_TASKQS;
441 mutex_exit(&taskq->lock);
442 break;
443 }
444 mutex_exit(&taskq->lock);
445 }
446 }
447
448 void
449 usb_event_thread(void *arg)
450 {
451 struct usb_softc *sc = arg;
452
453 USBHIST_FUNC(); USBHIST_CALLED(usbdebug);
454
455 /*
456 * In case this controller is a companion controller to an
457 * EHCI controller we need to wait until the EHCI controller
458 * has grabbed the port.
459 * XXX It would be nicer to do this with a tsleep(), but I don't
460 * know how to synchronize the creation of the threads so it
461 * will work.
462 */
463 usb_delay_ms(sc->sc_bus, 500);
464
465 /* Make sure first discover does something. */
466 mutex_enter(sc->sc_bus->ub_lock);
467 sc->sc_bus->ub_needsexplore = 1;
468 usb_discover(sc);
469 mutex_exit(sc->sc_bus->ub_lock);
470 config_pending_decr(sc->sc_bus->ub_usbctl);
471
472 mutex_enter(sc->sc_bus->ub_lock);
473 while (!sc->sc_dying) {
474 if (usb_noexplore < 2)
475 usb_discover(sc);
476
477 cv_timedwait(&sc->sc_bus->ub_needsexplore_cv,
478 sc->sc_bus->ub_lock, usb_noexplore ? 0 : hz * 60);
479
480 DPRINTFN(2, "sc %p woke up", sc, 0, 0, 0);
481 }
482 sc->sc_event_thread = NULL;
483
484 /* In case parent is waiting for us to exit. */
485 cv_signal(&sc->sc_bus->ub_needsexplore_cv);
486 mutex_exit(sc->sc_bus->ub_lock);
487
488 DPRINTF("sc %p exit", sc, 0, 0, 0);
489 kthread_exit(0);
490 }
491
492 void
493 usb_task_thread(void *arg)
494 {
495 struct usb_task *task;
496 struct usb_taskq *taskq;
497 bool mpsafe;
498
499 USBHIST_FUNC(); USBHIST_CALLED(usbdebug);
500
501 taskq = arg;
502 DPRINTF("start taskq %p", taskq, 0, 0, 0);
503
504 mutex_enter(&taskq->lock);
505 for (;;) {
506 task = TAILQ_FIRST(&taskq->tasks);
507 if (task == NULL) {
508 cv_wait(&taskq->cv, &taskq->lock);
509 task = TAILQ_FIRST(&taskq->tasks);
510 }
511 DPRINTFN(2, "woke up task=%p", task, 0, 0, 0);
512 if (task != NULL) {
513 mpsafe = ISSET(task->flags, USB_TASKQ_MPSAFE);
514 TAILQ_REMOVE(&taskq->tasks, task, next);
515 task->queue = USB_NUM_TASKQS;
516 mutex_exit(&taskq->lock);
517
518 if (!mpsafe)
519 KERNEL_LOCK(1, curlwp);
520 task->fun(task->arg);
521 /* Can't dereference task after this point. */
522 if (!mpsafe)
523 KERNEL_UNLOCK_ONE(curlwp);
524
525 mutex_enter(&taskq->lock);
526 }
527 }
528 mutex_exit(&taskq->lock);
529 }
530
531 int
532 usbctlprint(void *aux, const char *pnp)
533 {
534 /* only "usb"es can attach to host controllers */
535 if (pnp)
536 aprint_normal("usb at %s", pnp);
537
538 return UNCONF;
539 }
540
541 int
542 usbopen(dev_t dev, int flag, int mode, struct lwp *l)
543 {
544 int unit = minor(dev);
545 struct usb_softc *sc;
546
547 if (unit == USB_DEV_MINOR) {
548 if (usb_dev_open)
549 return EBUSY;
550 usb_dev_open = 1;
551 mutex_enter(proc_lock);
552 usb_async_proc = 0;
553 mutex_exit(proc_lock);
554 return 0;
555 }
556
557 sc = device_lookup_private(&usb_cd, unit);
558 if (!sc)
559 return ENXIO;
560
561 if (sc->sc_dying)
562 return EIO;
563
564 return 0;
565 }
566
567 int
568 usbread(dev_t dev, struct uio *uio, int flag)
569 {
570 struct usb_event *ue;
571 #ifdef COMPAT_30
572 struct usb_event_old *ueo = NULL; /* XXXGCC */
573 int useold = 0;
574 #endif
575 int error, n;
576
577 if (minor(dev) != USB_DEV_MINOR)
578 return ENXIO;
579
580 switch (uio->uio_resid) {
581 #ifdef COMPAT_30
582 case sizeof(struct usb_event_old):
583 ueo = kmem_zalloc(sizeof(struct usb_event_old), KM_SLEEP);
584 useold = 1;
585 /* FALLTHRU */
586 #endif
587 case sizeof(struct usb_event):
588 ue = usb_alloc_event();
589 break;
590 default:
591 return EINVAL;
592 }
593
594 error = 0;
595 mutex_enter(&usb_event_lock);
596 for (;;) {
597 n = usb_get_next_event(ue);
598 if (n != 0)
599 break;
600 if (flag & IO_NDELAY) {
601 error = EWOULDBLOCK;
602 break;
603 }
604 error = cv_wait_sig(&usb_event_cv, &usb_event_lock);
605 if (error)
606 break;
607 }
608 mutex_exit(&usb_event_lock);
609 if (!error) {
610 #ifdef COMPAT_30
611 if (useold) { /* copy fields to old struct */
612 ueo->ue_type = ue->ue_type;
613 memcpy(&ueo->ue_time, &ue->ue_time,
614 sizeof(struct timespec));
615 switch (ue->ue_type) {
616 case USB_EVENT_DEVICE_ATTACH:
617 case USB_EVENT_DEVICE_DETACH:
618 usb_copy_old_devinfo(&ueo->u.ue_device, &ue->u.ue_device);
619 break;
620
621 case USB_EVENT_CTRLR_ATTACH:
622 case USB_EVENT_CTRLR_DETACH:
623 ueo->u.ue_ctrlr.ue_bus=ue->u.ue_ctrlr.ue_bus;
624 break;
625
626 case USB_EVENT_DRIVER_ATTACH:
627 case USB_EVENT_DRIVER_DETACH:
628 ueo->u.ue_driver.ue_cookie=ue->u.ue_driver.ue_cookie;
629 memcpy(ueo->u.ue_driver.ue_devname,
630 ue->u.ue_driver.ue_devname,
631 sizeof(ue->u.ue_driver.ue_devname));
632 break;
633 default:
634 ;
635 }
636
637 error = uiomove((void *)ueo, sizeof(*ueo), uio);
638 } else
639 #endif
640 error = uiomove((void *)ue, sizeof(*ue), uio);
641 }
642 usb_free_event(ue);
643 #ifdef COMPAT_30
644 if (useold)
645 kmem_free(ueo, sizeof(struct usb_event_old));
646 #endif
647
648 return error;
649 }
650
651 int
652 usbclose(dev_t dev, int flag, int mode,
653 struct lwp *l)
654 {
655 int unit = minor(dev);
656
657 if (unit == USB_DEV_MINOR) {
658 mutex_enter(proc_lock);
659 usb_async_proc = 0;
660 mutex_exit(proc_lock);
661 usb_dev_open = 0;
662 }
663
664 return 0;
665 }
666
667 int
668 usbioctl(dev_t devt, u_long cmd, void *data, int flag, struct lwp *l)
669 {
670 struct usb_softc *sc;
671 int unit = minor(devt);
672
673 USBHIST_FUNC(); USBHIST_CALLED(usbdebug);
674
675 if (unit == USB_DEV_MINOR) {
676 switch (cmd) {
677 case FIONBIO:
678 /* All handled in the upper FS layer. */
679 return 0;
680
681 case FIOASYNC:
682 mutex_enter(proc_lock);
683 if (*(int *)data)
684 usb_async_proc = l->l_proc;
685 else
686 usb_async_proc = 0;
687 mutex_exit(proc_lock);
688 return 0;
689
690 default:
691 return EINVAL;
692 }
693 }
694
695 sc = device_lookup_private(&usb_cd, unit);
696
697 if (sc->sc_dying)
698 return EIO;
699
700 int error = 0;
701 DPRINTF("cmd %#x", cmd, 0, 0, 0);
702 switch (cmd) {
703 #ifdef USB_DEBUG
704 case USB_SETDEBUG:
705 if (!(flag & FWRITE))
706 return EBADF;
707 usbdebug = ((*(int *)data) & 0x000000ff);
708 break;
709 #endif /* USB_DEBUG */
710 case USB_REQUEST:
711 {
712 struct usb_ctl_request *ur = (void *)data;
713 int len = UGETW(ur->ucr_request.wLength);
714 struct iovec iov;
715 struct uio uio;
716 void *ptr = 0;
717 int addr = ur->ucr_addr;
718 usbd_status err;
719
720 if (!(flag & FWRITE)) {
721 error = EBADF;
722 goto fail;
723 }
724
725 DPRINTF("USB_REQUEST addr=%d len=%d", addr, len, 0, 0);
726 if (len < 0 || len > 32768) {
727 error = EINVAL;
728 goto fail;
729 }
730 if (addr < 0 || addr >= USB_MAX_DEVICES) {
731 error = EINVAL;
732 goto fail;
733 }
734 size_t dindex = usb_addr2dindex(addr);
735 if (sc->sc_bus->ub_devices[dindex] == NULL) {
736 error = EINVAL;
737 goto fail;
738 }
739 if (len != 0) {
740 iov.iov_base = (void *)ur->ucr_data;
741 iov.iov_len = len;
742 uio.uio_iov = &iov;
743 uio.uio_iovcnt = 1;
744 uio.uio_resid = len;
745 uio.uio_offset = 0;
746 uio.uio_rw =
747 ur->ucr_request.bmRequestType & UT_READ ?
748 UIO_READ : UIO_WRITE;
749 uio.uio_vmspace = l->l_proc->p_vmspace;
750 ptr = kmem_alloc(len, KM_SLEEP);
751 if (uio.uio_rw == UIO_WRITE) {
752 error = uiomove(ptr, len, &uio);
753 if (error)
754 goto ret;
755 }
756 }
757 err = usbd_do_request_flags(sc->sc_bus->ub_devices[dindex],
758 &ur->ucr_request, ptr, ur->ucr_flags, &ur->ucr_actlen,
759 USBD_DEFAULT_TIMEOUT);
760 if (err) {
761 error = EIO;
762 goto ret;
763 }
764 if (len > ur->ucr_actlen)
765 len = ur->ucr_actlen;
766 if (len != 0) {
767 if (uio.uio_rw == UIO_READ) {
768 error = uiomove(ptr, len, &uio);
769 if (error)
770 goto ret;
771 }
772 }
773 ret:
774 if (ptr) {
775 len = UGETW(ur->ucr_request.wLength);
776 kmem_free(ptr, len);
777 }
778 }
779
780 case USB_DEVICEINFO:
781 {
782 struct usbd_device *dev;
783 struct usb_device_info *di = (void *)data;
784 int addr = di->udi_addr;
785
786 if (addr < 0 || addr >= USB_MAX_DEVICES) {
787 error = EINVAL;
788 goto fail;
789 }
790 size_t dindex = usb_addr2dindex(addr);
791 if ((dev = sc->sc_bus->ub_devices[dindex]) == NULL) {
792 error = ENXIO;
793 goto fail;
794 }
795 usbd_fill_deviceinfo(dev, di, 1);
796 break;
797 }
798
799 #ifdef COMPAT_30
800 case USB_DEVICEINFO_OLD:
801 {
802 struct usbd_device *dev;
803 struct usb_device_info_old *di = (void *)data;
804 int addr = di->udi_addr;
805
806 if (addr < 1 || addr >= USB_MAX_DEVICES) {
807 error = EINVAL;
808 goto fail;
809 }
810 size_t dindex = usb_addr2dindex(addr);
811 if ((dev = sc->sc_bus->ub_devices[dindex]) == NULL) {
812 error = ENXIO;
813 goto fail;
814 }
815 usbd_fill_deviceinfo_old(dev, di, 1);
816 break;
817 }
818 #endif
819
820 case USB_DEVICESTATS:
821 *(struct usb_device_stats *)data = sc->sc_bus->ub_stats;
822 break;
823
824 default:
825 error = EINVAL;
826 }
827
828 fail:
829
830 DPRINTF("... done (error = %d)", error, 0, 0, 0);
831
832 return error;
833 }
834
835 int
836 usbpoll(dev_t dev, int events, struct lwp *l)
837 {
838 int revents, mask;
839
840 if (minor(dev) == USB_DEV_MINOR) {
841 revents = 0;
842 mask = POLLIN | POLLRDNORM;
843
844 mutex_enter(&usb_event_lock);
845 if (events & mask && usb_nevents > 0)
846 revents |= events & mask;
847 if (revents == 0 && events & mask)
848 selrecord(l, &usb_selevent);
849 mutex_exit(&usb_event_lock);
850
851 return revents;
852 } else {
853 return 0;
854 }
855 }
856
857 static void
858 filt_usbrdetach(struct knote *kn)
859 {
860
861 mutex_enter(&usb_event_lock);
862 SLIST_REMOVE(&usb_selevent.sel_klist, kn, knote, kn_selnext);
863 mutex_exit(&usb_event_lock);
864 }
865
866 static int
867 filt_usbread(struct knote *kn, long hint)
868 {
869
870 if (usb_nevents == 0)
871 return 0;
872
873 kn->kn_data = sizeof(struct usb_event);
874 return 1;
875 }
876
877 static const struct filterops usbread_filtops =
878 { 1, NULL, filt_usbrdetach, filt_usbread };
879
880 int
881 usbkqfilter(dev_t dev, struct knote *kn)
882 {
883 struct klist *klist;
884
885 switch (kn->kn_filter) {
886 case EVFILT_READ:
887 if (minor(dev) != USB_DEV_MINOR)
888 return 1;
889 klist = &usb_selevent.sel_klist;
890 kn->kn_fop = &usbread_filtops;
891 break;
892
893 default:
894 return EINVAL;
895 }
896
897 kn->kn_hook = NULL;
898
899 mutex_enter(&usb_event_lock);
900 SLIST_INSERT_HEAD(klist, kn, kn_selnext);
901 mutex_exit(&usb_event_lock);
902
903 return 0;
904 }
905
906 /* Explore device tree from the root. */
907 Static void
908 usb_discover(struct usb_softc *sc)
909 {
910
911 USBHIST_FUNC(); USBHIST_CALLED(usbdebug);
912
913 KASSERT(mutex_owned(sc->sc_bus->ub_lock));
914
915 if (usb_noexplore > 1)
916 return;
917 /*
918 * We need mutual exclusion while traversing the device tree,
919 * but this is guaranteed since this function is only called
920 * from the event thread for the controller.
921 *
922 * Also, we now have sc_bus->ub_lock held.
923 */
924 while (sc->sc_bus->ub_needsexplore && !sc->sc_dying) {
925 sc->sc_bus->ub_needsexplore = 0;
926 mutex_exit(sc->sc_bus->ub_lock);
927 sc->sc_bus->ub_roothub->ud_hub->uh_explore(sc->sc_bus->ub_roothub);
928 mutex_enter(sc->sc_bus->ub_lock);
929 }
930 }
931
932 void
933 usb_needs_explore(struct usbd_device *dev)
934 {
935
936 USBHIST_FUNC(); USBHIST_CALLED(usbdebug);
937
938 mutex_enter(dev->ud_bus->ub_lock);
939 dev->ud_bus->ub_needsexplore = 1;
940 cv_signal(&dev->ud_bus->ub_needsexplore_cv);
941 mutex_exit(dev->ud_bus->ub_lock);
942 }
943
944 void
945 usb_needs_reattach(struct usbd_device *dev)
946 {
947
948 USBHIST_FUNC(); USBHIST_CALLED(usbdebug);
949
950 mutex_enter(dev->ud_bus->ub_lock);
951 dev->ud_powersrc->up_reattach = 1;
952 dev->ud_bus->ub_needsexplore = 1;
953 cv_signal(&dev->ud_bus->ub_needsexplore_cv);
954 mutex_exit(dev->ud_bus->ub_lock);
955 }
956
957 /* Called at with usb_event_lock held. */
958 int
959 usb_get_next_event(struct usb_event *ue)
960 {
961 struct usb_event_q *ueq;
962
963 KASSERT(mutex_owned(&usb_event_lock));
964
965 if (usb_nevents <= 0)
966 return 0;
967 ueq = SIMPLEQ_FIRST(&usb_events);
968 #ifdef DIAGNOSTIC
969 if (ueq == NULL) {
970 printf("usb: usb_nevents got out of sync! %d\n", usb_nevents);
971 usb_nevents = 0;
972 return 0;
973 }
974 #endif
975 if (ue)
976 *ue = ueq->ue;
977 SIMPLEQ_REMOVE_HEAD(&usb_events, next);
978 usb_free_event((struct usb_event *)(void *)ueq);
979 usb_nevents--;
980 return 1;
981 }
982
983 void
984 usbd_add_dev_event(int type, struct usbd_device *udev)
985 {
986 struct usb_event *ue = usb_alloc_event();
987
988 usbd_fill_deviceinfo(udev, &ue->u.ue_device, false);
989 usb_add_event(type, ue);
990 }
991
992 void
993 usbd_add_drv_event(int type, struct usbd_device *udev, device_t dev)
994 {
995 struct usb_event *ue = usb_alloc_event();
996
997 ue->u.ue_driver.ue_cookie = udev->ud_cookie;
998 strncpy(ue->u.ue_driver.ue_devname, device_xname(dev),
999 sizeof(ue->u.ue_driver.ue_devname));
1000 usb_add_event(type, ue);
1001 }
1002
1003 Static struct usb_event *
1004 usb_alloc_event(void)
1005 {
1006 /* Yes, this is right; we allocate enough so that we can use it later */
1007 return kmem_zalloc(sizeof(struct usb_event_q), KM_SLEEP);
1008 }
1009
1010 Static void
1011 usb_free_event(struct usb_event *uep)
1012 {
1013 kmem_free(uep, sizeof(struct usb_event_q));
1014 }
1015
1016 Static void
1017 usb_add_event(int type, struct usb_event *uep)
1018 {
1019 struct usb_event_q *ueq;
1020 struct timeval thetime;
1021
1022 USBHIST_FUNC(); USBHIST_CALLED(usbdebug);
1023
1024 microtime(&thetime);
1025 /* Don't want to wait here with usb_event_lock held */
1026 ueq = (struct usb_event_q *)(void *)uep;
1027 ueq->ue = *uep;
1028 ueq->ue.ue_type = type;
1029 TIMEVAL_TO_TIMESPEC(&thetime, &ueq->ue.ue_time);
1030
1031 mutex_enter(&usb_event_lock);
1032 if (++usb_nevents >= USB_MAX_EVENTS) {
1033 /* Too many queued events, drop an old one. */
1034 DPRINTF("event dropped", 0, 0, 0, 0);
1035 (void)usb_get_next_event(0);
1036 }
1037 SIMPLEQ_INSERT_TAIL(&usb_events, ueq, next);
1038 cv_signal(&usb_event_cv);
1039 selnotify(&usb_selevent, 0, 0);
1040 if (usb_async_proc != NULL) {
1041 kpreempt_disable();
1042 softint_schedule(usb_async_sih);
1043 kpreempt_enable();
1044 }
1045 mutex_exit(&usb_event_lock);
1046 }
1047
1048 Static void
1049 usb_async_intr(void *cookie)
1050 {
1051 proc_t *proc;
1052
1053 mutex_enter(proc_lock);
1054 if ((proc = usb_async_proc) != NULL)
1055 psignal(proc, SIGIO);
1056 mutex_exit(proc_lock);
1057 }
1058
1059 Static void
1060 usb_soft_intr(void *arg)
1061 {
1062 struct usbd_bus *bus = arg;
1063
1064 mutex_enter(bus->ub_lock);
1065 bus->ub_methods->ubm_softint(bus);
1066 mutex_exit(bus->ub_lock);
1067 }
1068
1069 void
1070 usb_schedsoftintr(struct usbd_bus *bus)
1071 {
1072
1073 USBHIST_FUNC(); USBHIST_CALLED(usbdebug);
1074
1075 DPRINTFN(10, "polling=%d", bus->ub_usepolling, 0, 0, 0);
1076
1077 if (bus->ub_usepolling) {
1078 bus->ub_methods->ubm_softint(bus);
1079 } else {
1080 kpreempt_disable();
1081 softint_schedule(bus->ub_soft);
1082 kpreempt_enable();
1083 }
1084 }
1085
1086 int
1087 usb_activate(device_t self, enum devact act)
1088 {
1089 struct usb_softc *sc = device_private(self);
1090
1091 switch (act) {
1092 case DVACT_DEACTIVATE:
1093 sc->sc_dying = 1;
1094 return 0;
1095 default:
1096 return EOPNOTSUPP;
1097 }
1098 }
1099
1100 void
1101 usb_childdet(device_t self, device_t child)
1102 {
1103 int i;
1104 struct usb_softc *sc = device_private(self);
1105 struct usbd_device *dev;
1106
1107 if ((dev = sc->sc_port.up_dev) == NULL || dev->ud_subdevlen == 0)
1108 return;
1109
1110 for (i = 0; i < dev->ud_subdevlen; i++)
1111 if (dev->ud_subdevs[i] == child)
1112 dev->ud_subdevs[i] = NULL;
1113 }
1114
1115 int
1116 usb_detach(device_t self, int flags)
1117 {
1118 struct usb_softc *sc = device_private(self);
1119 struct usb_event *ue;
1120 int rc;
1121
1122 USBHIST_FUNC(); USBHIST_CALLED(usbdebug);
1123
1124 /* Make all devices disconnect. */
1125 if (sc->sc_port.up_dev != NULL &&
1126 (rc = usb_disconnect_port(&sc->sc_port, self, flags)) != 0)
1127 return rc;
1128
1129 pmf_device_deregister(self);
1130 /* Kill off event thread. */
1131 sc->sc_dying = 1;
1132 while (sc->sc_event_thread != NULL) {
1133 mutex_enter(sc->sc_bus->ub_lock);
1134 cv_signal(&sc->sc_bus->ub_needsexplore_cv);
1135 cv_timedwait(&sc->sc_bus->ub_needsexplore_cv,
1136 sc->sc_bus->ub_lock, hz * 60);
1137 mutex_exit(sc->sc_bus->ub_lock);
1138 }
1139 DPRINTF("event thread dead", 0, 0, 0, 0);
1140
1141 if (sc->sc_bus->ub_soft != NULL) {
1142 softint_disestablish(sc->sc_bus->ub_soft);
1143 sc->sc_bus->ub_soft = NULL;
1144 }
1145
1146 ue = usb_alloc_event();
1147 ue->u.ue_ctrlr.ue_bus = device_unit(self);
1148 usb_add_event(USB_EVENT_CTRLR_DETACH, ue);
1149
1150 cv_destroy(&sc->sc_bus->ub_needsexplore_cv);
1151
1152 return 0;
1153 }
1154
1155 #ifdef COMPAT_30
1156 Static void
1157 usb_copy_old_devinfo(struct usb_device_info_old *uo,
1158 const struct usb_device_info *ue)
1159 {
1160 const unsigned char *p;
1161 unsigned char *q;
1162 int i, n;
1163
1164 uo->udi_bus = ue->udi_bus;
1165 uo->udi_addr = ue->udi_addr;
1166 uo->udi_cookie = ue->udi_cookie;
1167 for (i = 0, p = (const unsigned char *)ue->udi_product,
1168 q = (unsigned char *)uo->udi_product;
1169 *p && i < USB_MAX_STRING_LEN - 1; p++) {
1170 if (*p < 0x80)
1171 q[i++] = *p;
1172 else {
1173 q[i++] = '?';
1174 if ((*p & 0xe0) == 0xe0)
1175 p++;
1176 p++;
1177 }
1178 }
1179 q[i] = 0;
1180
1181 for (i = 0, p = ue->udi_vendor, q = uo->udi_vendor;
1182 *p && i < USB_MAX_STRING_LEN - 1; p++) {
1183 if (* p < 0x80)
1184 q[i++] = *p;
1185 else {
1186 q[i++] = '?';
1187 p++;
1188 if ((*p & 0xe0) == 0xe0)
1189 p++;
1190 }
1191 }
1192 q[i] = 0;
1193
1194 memcpy(uo->udi_release, ue->udi_release, sizeof(uo->udi_release));
1195
1196 uo->udi_productNo = ue->udi_productNo;
1197 uo->udi_vendorNo = ue->udi_vendorNo;
1198 uo->udi_releaseNo = ue->udi_releaseNo;
1199 uo->udi_class = ue->udi_class;
1200 uo->udi_subclass = ue->udi_subclass;
1201 uo->udi_protocol = ue->udi_protocol;
1202 uo->udi_config = ue->udi_config;
1203 uo->udi_speed = ue->udi_speed;
1204 uo->udi_power = ue->udi_power;
1205 uo->udi_nports = ue->udi_nports;
1206
1207 for (n=0; n<USB_MAX_DEVNAMES; n++)
1208 memcpy(uo->udi_devnames[n],
1209 ue->udi_devnames[n], USB_MAX_DEVNAMELEN);
1210 memcpy(uo->udi_ports, ue->udi_ports, sizeof(uo->udi_ports));
1211 }
1212 #endif
1213