3 * Copyright (c) 2008 Hans Petter Selasky. All rights reserved.
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
8 * 1. Redistributions of source code must retain the above copyright
9 * notice, this list of conditions and the following disclaimer.
10 * 2. Redistributions in binary form must reproduce the above copyright
11 * notice, this list of conditions and the following disclaimer in the
12 * documentation and/or other materials provided with the distribution.
14 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
15 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
18 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
27 #ifdef USB_GLOBAL_INCLUDE_FILE
28 #include USB_GLOBAL_INCLUDE_FILE
30 #include <sys/stdint.h>
31 #include <sys/stddef.h>
32 #include <sys/param.h>
33 #include <sys/queue.h>
34 #include <sys/types.h>
35 #include <sys/systm.h>
36 #include <sys/kernel.h>
38 #include <sys/module.h>
40 #include <sys/mutex.h>
41 #include <sys/condvar.h>
42 #include <sys/sysctl.h>
44 #include <sys/unistd.h>
45 #include <sys/callout.h>
46 #include <sys/malloc.h>
49 #include <sys/fcntl.h>
51 #include <dev/usb/usb.h>
52 #include <dev/usb/usb_ioctl.h>
53 #include <dev/usb/usbdi.h>
54 #include <dev/usb/usbdi_util.h>
56 #define USB_DEBUG_VAR ugen_debug
58 #include <dev/usb/usb_core.h>
59 #include <dev/usb/usb_dev.h>
60 #include <dev/usb/usb_mbuf.h>
61 #include <dev/usb/usb_process.h>
62 #include <dev/usb/usb_device.h>
63 #include <dev/usb/usb_debug.h>
64 #include <dev/usb/usb_request.h>
65 #include <dev/usb/usb_busdma.h>
66 #include <dev/usb/usb_util.h>
67 #include <dev/usb/usb_hub.h>
68 #include <dev/usb/usb_generic.h>
69 #include <dev/usb/usb_transfer.h>
71 #include <dev/usb/usb_controller.h>
72 #include <dev/usb/usb_bus.h>
73 #endif /* USB_GLOBAL_INCLUDE_FILE */
79 #define UGEN_BULK_FS_BUFFER_SIZE (64*32) /* bytes */
80 #define UGEN_BULK_HS_BUFFER_SIZE (1024*32) /* bytes */
81 #define UGEN_HW_FRAMES 50 /* number of milliseconds per transfer */
83 /* function prototypes */
85 static usb_callback_t ugen_read_clear_stall_callback;
86 static usb_callback_t ugen_write_clear_stall_callback;
87 static usb_callback_t ugen_ctrl_read_callback;
88 static usb_callback_t ugen_ctrl_write_callback;
89 static usb_callback_t ugen_isoc_read_callback;
90 static usb_callback_t ugen_isoc_write_callback;
91 static usb_callback_t ugen_ctrl_fs_callback;
93 static usb_fifo_open_t ugen_open;
94 static usb_fifo_close_t ugen_close;
95 static usb_fifo_ioctl_t ugen_ioctl;
96 static usb_fifo_ioctl_t ugen_ioctl_post;
97 static usb_fifo_cmd_t ugen_start_read;
98 static usb_fifo_cmd_t ugen_start_write;
99 static usb_fifo_cmd_t ugen_stop_io;
101 static int ugen_transfer_setup(struct usb_fifo *,
102 const struct usb_config *, uint8_t);
103 static int ugen_open_pipe_write(struct usb_fifo *);
104 static int ugen_open_pipe_read(struct usb_fifo *);
105 static int ugen_set_config(struct usb_fifo *, uint8_t);
106 static int ugen_set_interface(struct usb_fifo *, uint8_t, uint8_t);
107 static int ugen_get_cdesc(struct usb_fifo *, struct usb_gen_descriptor *);
108 static int ugen_get_sdesc(struct usb_fifo *, struct usb_gen_descriptor *);
109 static int ugen_get_iface_driver(struct usb_fifo *f, struct usb_gen_descriptor *ugd);
110 static int usb_gen_fill_deviceinfo(struct usb_fifo *,
111 struct usb_device_info *);
112 static int ugen_re_enumerate(struct usb_fifo *);
113 static int ugen_iface_ioctl(struct usb_fifo *, u_long, void *, int);
114 static uint8_t ugen_fs_get_complete(struct usb_fifo *, uint8_t *);
115 static int ugen_fs_uninit(struct usb_fifo *f);
119 struct usb_fifo_methods usb_ugen_methods = {
120 .f_open = &ugen_open,
121 .f_close = &ugen_close,
122 .f_ioctl = &ugen_ioctl,
123 .f_ioctl_post = &ugen_ioctl_post,
124 .f_start_read = &ugen_start_read,
125 .f_stop_read = &ugen_stop_io,
126 .f_start_write = &ugen_start_write,
127 .f_stop_write = &ugen_stop_io,
131 static int ugen_debug = 0;
133 static SYSCTL_NODE(_hw_usb, OID_AUTO, ugen, CTLFLAG_RW, 0, "USB generic");
134 SYSCTL_INT(_hw_usb_ugen, OID_AUTO, debug, CTLFLAG_RW | CTLFLAG_TUN, &ugen_debug,
136 TUNABLE_INT("hw.usb.ugen.debug", &ugen_debug);
143 ugen_transfer_setup(struct usb_fifo *f,
144 const struct usb_config *setup, uint8_t n_setup)
146 struct usb_endpoint *ep = usb_fifo_softc(f);
147 struct usb_device *udev = f->udev;
148 uint8_t iface_index = ep->iface_index;
151 mtx_unlock(f->priv_mtx);
154 * "usbd_transfer_setup()" can sleep so one needs to make a wrapper,
155 * exiting the mutex and checking things
157 error = usbd_transfer_setup(udev, &iface_index, f->xfer,
158 setup, n_setup, f, f->priv_mtx);
161 if (f->xfer[0]->nframes == 1) {
162 error = usb_fifo_alloc_buffer(f,
163 f->xfer[0]->max_data_length, 2);
165 error = usb_fifo_alloc_buffer(f,
166 f->xfer[0]->max_frame_size,
167 2 * f->xfer[0]->nframes);
170 usbd_transfer_unsetup(f->xfer, n_setup);
173 mtx_lock(f->priv_mtx);
179 ugen_open(struct usb_fifo *f, int fflags)
181 struct usb_endpoint *ep = usb_fifo_softc(f);
182 struct usb_endpoint_descriptor *ed = ep->edesc;
185 DPRINTFN(6, "flag=0x%x\n", fflags);
187 mtx_lock(f->priv_mtx);
188 switch (usbd_get_speed(f->udev)) {
191 f->nframes = UGEN_HW_FRAMES;
192 f->bufsize = UGEN_BULK_FS_BUFFER_SIZE;
195 f->nframes = UGEN_HW_FRAMES * 8;
196 f->bufsize = UGEN_BULK_HS_BUFFER_SIZE;
200 type = ed->bmAttributes & UE_XFERTYPE;
201 if (type == UE_INTERRUPT) {
202 f->bufsize = 0; /* use "wMaxPacketSize" */
204 f->timeout = USB_NO_TIMEOUT;
207 mtx_unlock(f->priv_mtx);
213 ugen_close(struct usb_fifo *f, int fflags)
215 DPRINTFN(6, "flag=0x%x\n", fflags);
219 mtx_lock(f->priv_mtx);
220 usbd_transfer_stop(f->xfer[0]);
221 usbd_transfer_stop(f->xfer[1]);
222 mtx_unlock(f->priv_mtx);
224 usbd_transfer_unsetup(f->xfer, 2);
225 usb_fifo_free_buffer(f);
227 if (ugen_fs_uninit(f)) {
228 /* ignore any errors - we are closing */
229 DPRINTFN(6, "no FIFOs\n");
234 ugen_open_pipe_write(struct usb_fifo *f)
236 struct usb_config usb_config[2];
237 struct usb_endpoint *ep = usb_fifo_softc(f);
238 struct usb_endpoint_descriptor *ed = ep->edesc;
240 mtx_assert(f->priv_mtx, MA_OWNED);
242 if (f->xfer[0] || f->xfer[1]) {
243 /* transfers are already opened */
246 memset(usb_config, 0, sizeof(usb_config));
248 usb_config[1].type = UE_CONTROL;
249 usb_config[1].endpoint = 0;
250 usb_config[1].direction = UE_DIR_ANY;
251 usb_config[1].timeout = 1000; /* 1 second */
252 usb_config[1].interval = 50;/* 50 milliseconds */
253 usb_config[1].bufsize = sizeof(struct usb_device_request);
254 usb_config[1].callback = &ugen_write_clear_stall_callback;
255 usb_config[1].usb_mode = USB_MODE_HOST;
257 usb_config[0].type = ed->bmAttributes & UE_XFERTYPE;
258 usb_config[0].endpoint = ed->bEndpointAddress & UE_ADDR;
259 usb_config[0].stream_id = 0; /* XXX support more stream ID's */
260 usb_config[0].direction = UE_DIR_TX;
261 usb_config[0].interval = USB_DEFAULT_INTERVAL;
262 usb_config[0].flags.proxy_buffer = 1;
263 usb_config[0].usb_mode = USB_MODE_DUAL; /* both modes */
265 switch (ed->bmAttributes & UE_XFERTYPE) {
269 usb_config[0].flags.force_short_xfer = 1;
271 usb_config[0].callback = &ugen_ctrl_write_callback;
272 usb_config[0].timeout = f->timeout;
273 usb_config[0].frames = 1;
274 usb_config[0].bufsize = f->bufsize;
275 if (ugen_transfer_setup(f, usb_config, 2)) {
278 /* first transfer does not clear stall */
283 usb_config[0].flags.short_xfer_ok = 1;
284 usb_config[0].bufsize = 0; /* use default */
285 usb_config[0].frames = f->nframes;
286 usb_config[0].callback = &ugen_isoc_write_callback;
287 usb_config[0].timeout = 0;
289 /* clone configuration */
290 usb_config[1] = usb_config[0];
292 if (ugen_transfer_setup(f, usb_config, 2)) {
303 ugen_open_pipe_read(struct usb_fifo *f)
305 struct usb_config usb_config[2];
306 struct usb_endpoint *ep = usb_fifo_softc(f);
307 struct usb_endpoint_descriptor *ed = ep->edesc;
309 mtx_assert(f->priv_mtx, MA_OWNED);
311 if (f->xfer[0] || f->xfer[1]) {
312 /* transfers are already opened */
315 memset(usb_config, 0, sizeof(usb_config));
317 usb_config[1].type = UE_CONTROL;
318 usb_config[1].endpoint = 0;
319 usb_config[1].direction = UE_DIR_ANY;
320 usb_config[1].timeout = 1000; /* 1 second */
321 usb_config[1].interval = 50;/* 50 milliseconds */
322 usb_config[1].bufsize = sizeof(struct usb_device_request);
323 usb_config[1].callback = &ugen_read_clear_stall_callback;
324 usb_config[1].usb_mode = USB_MODE_HOST;
326 usb_config[0].type = ed->bmAttributes & UE_XFERTYPE;
327 usb_config[0].endpoint = ed->bEndpointAddress & UE_ADDR;
328 usb_config[0].stream_id = 0; /* XXX support more stream ID's */
329 usb_config[0].direction = UE_DIR_RX;
330 usb_config[0].interval = USB_DEFAULT_INTERVAL;
331 usb_config[0].flags.proxy_buffer = 1;
332 usb_config[0].usb_mode = USB_MODE_DUAL; /* both modes */
334 switch (ed->bmAttributes & UE_XFERTYPE) {
338 usb_config[0].flags.short_xfer_ok = 1;
340 usb_config[0].timeout = f->timeout;
341 usb_config[0].frames = 1;
342 usb_config[0].callback = &ugen_ctrl_read_callback;
343 usb_config[0].bufsize = f->bufsize;
345 if (ugen_transfer_setup(f, usb_config, 2)) {
348 /* first transfer does not clear stall */
353 usb_config[0].flags.short_xfer_ok = 1;
354 usb_config[0].bufsize = 0; /* use default */
355 usb_config[0].frames = f->nframes;
356 usb_config[0].callback = &ugen_isoc_read_callback;
357 usb_config[0].timeout = 0;
359 /* clone configuration */
360 usb_config[1] = usb_config[0];
362 if (ugen_transfer_setup(f, usb_config, 2)) {
374 ugen_start_read(struct usb_fifo *f)
376 /* check that pipes are open */
377 if (ugen_open_pipe_read(f)) {
379 usb_fifo_put_data_error(f);
381 /* start transfers */
382 usbd_transfer_start(f->xfer[0]);
383 usbd_transfer_start(f->xfer[1]);
387 ugen_start_write(struct usb_fifo *f)
389 /* check that pipes are open */
390 if (ugen_open_pipe_write(f)) {
392 usb_fifo_get_data_error(f);
394 /* start transfers */
395 usbd_transfer_start(f->xfer[0]);
396 usbd_transfer_start(f->xfer[1]);
400 ugen_stop_io(struct usb_fifo *f)
403 usbd_transfer_stop(f->xfer[0]);
404 usbd_transfer_stop(f->xfer[1]);
408 ugen_ctrl_read_callback(struct usb_xfer *xfer, usb_error_t error)
410 struct usb_fifo *f = usbd_xfer_softc(xfer);
413 DPRINTFN(4, "actlen=%u, aframes=%u\n", xfer->actlen, xfer->aframes);
415 switch (USB_GET_STATE(xfer)) {
416 case USB_ST_TRANSFERRED:
417 if (xfer->actlen == 0) {
418 if (f->fifo_zlp != 4) {
422 * Throttle a little bit we have multiple ZLPs
425 xfer->interval = 64; /* ms */
432 usb_fifo_put_data(f, xfer->frbuffers, 0,
437 usbd_transfer_start(f->xfer[1]);
440 USB_IF_POLL(&f->free_q, m);
442 usbd_xfer_set_frame_len(xfer, 0, usbd_xfer_max_len(xfer));
443 usbd_transfer_submit(xfer);
448 if (xfer->error != USB_ERR_CANCELLED) {
449 /* send a zero length packet to userland */
450 usb_fifo_put_data(f, xfer->frbuffers, 0, 0, 1);
453 usbd_transfer_start(f->xfer[1]);
460 ugen_ctrl_write_callback(struct usb_xfer *xfer, usb_error_t error)
462 struct usb_fifo *f = usbd_xfer_softc(xfer);
463 usb_frlength_t actlen;
465 DPRINTFN(4, "actlen=%u, aframes=%u\n", xfer->actlen, xfer->aframes);
467 switch (USB_GET_STATE(xfer)) {
469 case USB_ST_TRANSFERRED:
471 * If writing is in stall, just jump to clear stall
472 * callback and solve the situation.
475 usbd_transfer_start(f->xfer[1]);
479 * Write data, setup and perform hardware transfer.
481 if (usb_fifo_get_data(f, xfer->frbuffers, 0,
482 xfer->max_data_length, &actlen, 0)) {
483 usbd_xfer_set_frame_len(xfer, 0, actlen);
484 usbd_transfer_submit(xfer);
489 if (xfer->error != USB_ERR_CANCELLED) {
491 usbd_transfer_start(f->xfer[1]);
498 ugen_read_clear_stall_callback(struct usb_xfer *xfer, usb_error_t error)
500 struct usb_fifo *f = usbd_xfer_softc(xfer);
501 struct usb_xfer *xfer_other = f->xfer[0];
503 if (f->flag_stall == 0) {
507 if (usbd_clear_stall_callback(xfer, xfer_other)) {
508 DPRINTFN(5, "f=%p: stall cleared\n", f);
510 usbd_transfer_start(xfer_other);
515 ugen_write_clear_stall_callback(struct usb_xfer *xfer, usb_error_t error)
517 struct usb_fifo *f = usbd_xfer_softc(xfer);
518 struct usb_xfer *xfer_other = f->xfer[0];
520 if (f->flag_stall == 0) {
524 if (usbd_clear_stall_callback(xfer, xfer_other)) {
525 DPRINTFN(5, "f=%p: stall cleared\n", f);
527 usbd_transfer_start(xfer_other);
532 ugen_isoc_read_callback(struct usb_xfer *xfer, usb_error_t error)
534 struct usb_fifo *f = usbd_xfer_softc(xfer);
535 usb_frlength_t offset;
538 DPRINTFN(4, "actlen=%u, aframes=%u\n", xfer->actlen, xfer->aframes);
540 switch (USB_GET_STATE(xfer)) {
541 case USB_ST_TRANSFERRED:
543 DPRINTFN(6, "actlen=%d\n", xfer->actlen);
547 for (n = 0; n != xfer->aframes; n++) {
548 usb_fifo_put_data(f, xfer->frbuffers, offset,
549 xfer->frlengths[n], 1);
550 offset += xfer->max_frame_size;
555 for (n = 0; n != xfer->nframes; n++) {
556 /* setup size for next transfer */
557 usbd_xfer_set_frame_len(xfer, n, xfer->max_frame_size);
559 usbd_transfer_submit(xfer);
563 if (xfer->error == USB_ERR_CANCELLED) {
571 ugen_isoc_write_callback(struct usb_xfer *xfer, usb_error_t error)
573 struct usb_fifo *f = usbd_xfer_softc(xfer);
574 usb_frlength_t actlen;
575 usb_frlength_t offset;
578 DPRINTFN(4, "actlen=%u, aframes=%u\n", xfer->actlen, xfer->aframes);
580 switch (USB_GET_STATE(xfer)) {
581 case USB_ST_TRANSFERRED:
585 for (n = 0; n != xfer->nframes; n++) {
586 if (usb_fifo_get_data(f, xfer->frbuffers, offset,
587 xfer->max_frame_size, &actlen, 1)) {
588 usbd_xfer_set_frame_len(xfer, n, actlen);
595 for (; n != xfer->nframes; n++) {
596 /* fill in zero frames */
597 usbd_xfer_set_frame_len(xfer, n, 0);
599 usbd_transfer_submit(xfer);
603 if (xfer->error == USB_ERR_CANCELLED) {
611 ugen_set_config(struct usb_fifo *f, uint8_t index)
613 DPRINTFN(2, "index %u\n", index);
615 if (f->udev->flags.usb_mode != USB_MODE_HOST) {
616 /* not possible in device side mode */
620 /* make sure all FIFO's are gone */
621 /* else there can be a deadlock */
622 if (ugen_fs_uninit(f)) {
623 /* ignore any errors */
624 DPRINTFN(6, "no FIFOs\n");
627 if (usbd_start_set_config(f->udev, index) != 0)
634 ugen_set_interface(struct usb_fifo *f,
635 uint8_t iface_index, uint8_t alt_index)
637 DPRINTFN(2, "%u, %u\n", iface_index, alt_index);
639 if (f->udev->flags.usb_mode != USB_MODE_HOST) {
640 /* not possible in device side mode */
643 /* make sure all FIFO's are gone */
644 /* else there can be a deadlock */
645 if (ugen_fs_uninit(f)) {
646 /* ignore any errors */
647 DPRINTFN(6, "no FIFOs\n");
649 /* change setting - will free generic FIFOs, if any */
650 if (usbd_set_alt_interface_index(f->udev, iface_index, alt_index)) {
653 /* probe and attach */
654 if (usb_probe_and_attach(f->udev, iface_index)) {
660 /*------------------------------------------------------------------------*
663 * This function will retrieve the complete configuration descriptor
664 * at the given index.
665 *------------------------------------------------------------------------*/
667 ugen_get_cdesc(struct usb_fifo *f, struct usb_gen_descriptor *ugd)
669 struct usb_config_descriptor *cdesc;
670 struct usb_device *udev = f->udev;
677 if (ugd->ugd_data == NULL) {
678 /* userland pointer should not be zero */
681 if ((ugd->ugd_config_index == USB_UNCONFIG_INDEX) ||
682 (ugd->ugd_config_index == udev->curr_config_index)) {
683 cdesc = usbd_get_config_descriptor(udev);
689 #if (USB_HAVE_FIXED_CONFIG == 0)
690 if (usbd_req_get_config_desc_full(udev,
691 NULL, &cdesc, ugd->ugd_config_index)) {
696 /* configuration descriptor data is shared */
701 len = UGETW(cdesc->wTotalLength);
702 if (len > ugd->ugd_maxlen) {
703 len = ugd->ugd_maxlen;
705 DPRINTFN(6, "len=%u\n", len);
707 ugd->ugd_actlen = len;
710 error = copyout(cdesc, ugd->ugd_data, len);
713 usbd_free_config_desc(udev, cdesc);
719 * This function is called having the enumeration SX locked which
720 * protects the scratch area used.
723 ugen_get_sdesc(struct usb_fifo *f, struct usb_gen_descriptor *ugd)
729 ptr = f->udev->scratch.data;
730 size = sizeof(f->udev->scratch.data);
732 if (usbd_req_get_string_desc(f->udev, NULL, ptr,
733 size, ugd->ugd_lang_id, ugd->ugd_string_index)) {
737 if (size > ((uint8_t *)ptr)[0]) {
738 size = ((uint8_t *)ptr)[0];
740 if (size > ugd->ugd_maxlen) {
741 size = ugd->ugd_maxlen;
743 ugd->ugd_actlen = size;
746 error = copyout(ptr, ugd->ugd_data, size);
751 /*------------------------------------------------------------------------*
752 * ugen_get_iface_driver
754 * This function generates an USB interface description for userland.
759 *------------------------------------------------------------------------*/
761 ugen_get_iface_driver(struct usb_fifo *f, struct usb_gen_descriptor *ugd)
763 struct usb_device *udev = f->udev;
764 struct usb_interface *iface;
774 if ((ugd->ugd_data == NULL) || (ugd->ugd_maxlen == 0)) {
775 /* userland pointer should not be zero */
779 iface = usbd_get_iface(udev, ugd->ugd_iface_index);
780 if ((iface == NULL) || (iface->idesc == NULL)) {
781 /* invalid interface index */
785 /* read out device nameunit string, if any */
786 if ((iface->subdev != NULL) &&
787 device_is_attached(iface->subdev) &&
788 (ptr = device_get_nameunit(iface->subdev)) &&
789 (desc = device_get_desc(iface->subdev))) {
791 /* print description */
792 snprintf(buf, sizeof(buf), "%s: <%s>", ptr, desc);
795 maxlen = ugd->ugd_maxlen - 1;
800 /* update actual length, including terminating zero */
801 ugd->ugd_actlen = len + 1;
803 /* copy out interface description */
804 error = copyout(buf, ugd->ugd_data, ugd->ugd_actlen);
806 /* zero length string is default */
807 error = copyout("", ugd->ugd_data, 1);
812 /*------------------------------------------------------------------------*
813 * usb_gen_fill_deviceinfo
815 * This function dumps information about an USB device to the
816 * structure pointed to by the "di" argument.
821 *------------------------------------------------------------------------*/
823 usb_gen_fill_deviceinfo(struct usb_fifo *f, struct usb_device_info *di)
825 struct usb_device *udev;
826 struct usb_device *hub;
830 bzero(di, sizeof(di[0]));
832 di->udi_bus = device_get_unit(udev->bus->bdev);
833 di->udi_addr = udev->address;
834 di->udi_index = udev->device_index;
835 strlcpy(di->udi_serial, usb_get_serial(udev), sizeof(di->udi_serial));
836 strlcpy(di->udi_vendor, usb_get_manufacturer(udev), sizeof(di->udi_vendor));
837 strlcpy(di->udi_product, usb_get_product(udev), sizeof(di->udi_product));
838 usb_printbcd(di->udi_release, sizeof(di->udi_release),
839 UGETW(udev->ddesc.bcdDevice));
840 di->udi_vendorNo = UGETW(udev->ddesc.idVendor);
841 di->udi_productNo = UGETW(udev->ddesc.idProduct);
842 di->udi_releaseNo = UGETW(udev->ddesc.bcdDevice);
843 di->udi_class = udev->ddesc.bDeviceClass;
844 di->udi_subclass = udev->ddesc.bDeviceSubClass;
845 di->udi_protocol = udev->ddesc.bDeviceProtocol;
846 di->udi_config_no = udev->curr_config_no;
847 di->udi_config_index = udev->curr_config_index;
848 di->udi_power = udev->flags.self_powered ? 0 : udev->power;
849 di->udi_speed = udev->speed;
850 di->udi_mode = udev->flags.usb_mode;
851 di->udi_power_mode = udev->power_mode;
852 di->udi_suspended = udev->flags.peer_suspended;
854 hub = udev->parent_hub;
856 di->udi_hubaddr = hub->address;
857 di->udi_hubindex = hub->device_index;
858 di->udi_hubport = udev->port_no;
863 /*------------------------------------------------------------------------*
869 *------------------------------------------------------------------------*/
871 ugen_check_request(struct usb_device *udev, struct usb_device_request *req)
873 struct usb_endpoint *ep;
877 * Avoid requests that would damage the bus integrity:
879 if (((req->bmRequestType == UT_WRITE_DEVICE) &&
880 (req->bRequest == UR_SET_ADDRESS)) ||
881 ((req->bmRequestType == UT_WRITE_DEVICE) &&
882 (req->bRequest == UR_SET_CONFIG)) ||
883 ((req->bmRequestType == UT_WRITE_INTERFACE) &&
884 (req->bRequest == UR_SET_INTERFACE))) {
886 * These requests can be useful for testing USB drivers.
888 error = priv_check(curthread, PRIV_DRIVER);
894 * Special case - handle clearing of stall
896 if (req->bmRequestType == UT_WRITE_ENDPOINT) {
898 ep = usbd_get_ep_by_addr(udev, req->wIndex[0]);
902 if ((req->bRequest == UR_CLEAR_FEATURE) &&
903 (UGETW(req->wValue) == UF_ENDPOINT_HALT)) {
904 usbd_clear_data_toggle(udev, ep);
907 /* TODO: add more checks to verify the interface index */
913 ugen_do_request(struct usb_fifo *f, struct usb_ctl_request *ur)
919 if (ugen_check_request(f->udev, &ur->ucr_request)) {
922 len = UGETW(ur->ucr_request.wLength);
924 /* check if "ucr_data" is valid */
926 if (ur->ucr_data == NULL) {
930 /* do the USB request */
931 error = usbd_do_request_flags
932 (f->udev, NULL, &ur->ucr_request, ur->ucr_data,
933 (ur->ucr_flags & USB_SHORT_XFER_OK) |
934 USB_USER_DATA_PTR, &actlen,
935 USB_DEFAULT_TIMEOUT);
937 ur->ucr_actlen = actlen;
945 /*------------------------------------------------------------------------
947 *------------------------------------------------------------------------*/
949 ugen_re_enumerate(struct usb_fifo *f)
951 struct usb_device *udev = f->udev;
955 * This request can be useful for testing USB drivers:
957 error = priv_check(curthread, PRIV_DRIVER);
961 if (udev->flags.usb_mode != USB_MODE_HOST) {
962 /* not possible in device side mode */
963 DPRINTFN(6, "device mode\n");
966 /* make sure all FIFO's are gone */
967 /* else there can be a deadlock */
968 if (ugen_fs_uninit(f)) {
969 /* ignore any errors */
970 DPRINTFN(6, "no FIFOs\n");
972 /* start re-enumeration of device */
973 usbd_start_re_enumerate(udev);
978 ugen_fs_uninit(struct usb_fifo *f)
980 if (f->fs_xfer == NULL) {
983 usbd_transfer_unsetup(f->fs_xfer, f->fs_ep_max);
984 free(f->fs_xfer, M_USB);
988 f->flag_iscomplete = 0;
989 usb_fifo_free_buffer(f);
994 ugen_fs_get_complete(struct usb_fifo *f, uint8_t *pindex)
998 USB_IF_DEQUEUE(&f->used_q, m);
1001 *pindex = *((uint8_t *)(m->cur_data_ptr));
1003 USB_IF_ENQUEUE(&f->free_q, m);
1005 return (0); /* success */
1008 *pindex = 0; /* fix compiler warning */
1010 f->flag_iscomplete = 0;
1012 return (1); /* failure */
1016 ugen_fs_set_complete(struct usb_fifo *f, uint8_t index)
1020 USB_IF_DEQUEUE(&f->free_q, m);
1023 /* can happen during close */
1024 DPRINTF("out of buffers\n");
1029 *((uint8_t *)(m->cur_data_ptr)) = index;
1031 USB_IF_ENQUEUE(&f->used_q, m);
1033 f->flag_iscomplete = 1;
1039 ugen_fs_copy_in(struct usb_fifo *f, uint8_t ep_index)
1041 struct usb_device_request *req;
1042 struct usb_xfer *xfer;
1043 struct usb_fs_endpoint fs_ep;
1044 void *uaddr; /* userland pointer */
1046 usb_frlength_t offset;
1053 if (ep_index >= f->fs_ep_max) {
1056 xfer = f->fs_xfer[ep_index];
1060 mtx_lock(f->priv_mtx);
1061 if (usbd_transfer_pending(xfer)) {
1062 mtx_unlock(f->priv_mtx);
1063 return (EBUSY); /* should not happen */
1065 mtx_unlock(f->priv_mtx);
1067 error = copyin(f->fs_ep_ptr +
1068 ep_index, &fs_ep, sizeof(fs_ep));
1072 /* security checks */
1074 if (fs_ep.nFrames > xfer->max_frame_count) {
1075 xfer->error = USB_ERR_INVAL;
1078 if (fs_ep.nFrames == 0) {
1079 xfer->error = USB_ERR_INVAL;
1082 error = copyin(fs_ep.ppBuffer,
1083 &uaddr, sizeof(uaddr));
1087 /* reset first frame */
1088 usbd_xfer_set_frame_offset(xfer, 0, 0);
1090 if (xfer->flags_int.control_xfr) {
1092 req = xfer->frbuffers[0].buffer;
1094 error = copyin(fs_ep.pLength,
1095 &length, sizeof(length));
1099 if (length != sizeof(*req)) {
1100 xfer->error = USB_ERR_INVAL;
1104 error = copyin(uaddr, req, length);
1109 if (ugen_check_request(f->udev, req)) {
1110 xfer->error = USB_ERR_INVAL;
1113 usbd_xfer_set_frame_len(xfer, 0, length);
1115 /* Host mode only ! */
1116 if ((req->bmRequestType &
1117 (UT_READ | UT_WRITE)) == UT_READ) {
1123 offset = sizeof(*req);
1126 /* Device and Host mode */
1127 if (USB_GET_DATA_ISREAD(xfer)) {
1136 rem = usbd_xfer_max_len(xfer);
1137 xfer->nframes = fs_ep.nFrames;
1138 xfer->timeout = fs_ep.timeout;
1139 if (xfer->timeout > 65535) {
1140 xfer->timeout = 65535;
1142 if (fs_ep.flags & USB_FS_FLAG_SINGLE_SHORT_OK)
1143 xfer->flags.short_xfer_ok = 1;
1145 xfer->flags.short_xfer_ok = 0;
1147 if (fs_ep.flags & USB_FS_FLAG_MULTI_SHORT_OK)
1148 xfer->flags.short_frames_ok = 1;
1150 xfer->flags.short_frames_ok = 0;
1152 if (fs_ep.flags & USB_FS_FLAG_FORCE_SHORT)
1153 xfer->flags.force_short_xfer = 1;
1155 xfer->flags.force_short_xfer = 0;
1157 if (fs_ep.flags & USB_FS_FLAG_CLEAR_STALL)
1158 usbd_xfer_set_stall(xfer);
1160 xfer->flags.stall_pipe = 0;
1162 for (; n != xfer->nframes; n++) {
1164 error = copyin(fs_ep.pLength + n,
1165 &length, sizeof(length));
1169 usbd_xfer_set_frame_len(xfer, n, length);
1172 xfer->error = USB_ERR_INVAL;
1179 /* we need to know the source buffer */
1180 error = copyin(fs_ep.ppBuffer + n,
1181 &uaddr, sizeof(uaddr));
1185 if (xfer->flags_int.isochronous_xfr) {
1186 /* get kernel buffer address */
1187 kaddr = xfer->frbuffers[0].buffer;
1188 kaddr = USB_ADD_BYTES(kaddr, offset);
1190 /* set current frame offset */
1191 usbd_xfer_set_frame_offset(xfer, offset, n);
1193 /* get kernel buffer address */
1194 kaddr = xfer->frbuffers[n].buffer;
1198 error = copyin(uaddr, kaddr, length);
1208 mtx_lock(f->priv_mtx);
1209 ugen_fs_set_complete(f, ep_index);
1210 mtx_unlock(f->priv_mtx);
1215 ugen_fs_copy_out(struct usb_fifo *f, uint8_t ep_index)
1217 struct usb_device_request *req;
1218 struct usb_xfer *xfer;
1219 struct usb_fs_endpoint fs_ep;
1220 struct usb_fs_endpoint *fs_ep_uptr; /* userland ptr */
1221 void *uaddr; /* userland ptr */
1223 usb_frlength_t offset;
1231 if (ep_index >= f->fs_ep_max)
1234 xfer = f->fs_xfer[ep_index];
1238 mtx_lock(f->priv_mtx);
1239 if (usbd_transfer_pending(xfer)) {
1240 mtx_unlock(f->priv_mtx);
1241 return (EBUSY); /* should not happen */
1243 mtx_unlock(f->priv_mtx);
1245 fs_ep_uptr = f->fs_ep_ptr + ep_index;
1246 error = copyin(fs_ep_uptr, &fs_ep, sizeof(fs_ep));
1250 fs_ep.status = xfer->error;
1251 fs_ep.aFrames = xfer->aframes;
1252 fs_ep.isoc_time_complete = xfer->isoc_time_complete;
1256 if (xfer->flags_int.control_xfr) {
1257 req = xfer->frbuffers[0].buffer;
1259 /* Host mode only ! */
1260 if ((req->bmRequestType & (UT_READ | UT_WRITE)) == UT_READ) {
1265 if (xfer->nframes == 0)
1266 n = 0; /* should never happen */
1270 /* Device and Host mode */
1271 if (USB_GET_DATA_ISREAD(xfer)) {
1279 /* Update lengths and copy out data */
1281 rem = usbd_xfer_max_len(xfer);
1284 for (; n != xfer->nframes; n++) {
1286 /* get initial length into "temp" */
1287 error = copyin(fs_ep.pLength + n,
1288 &temp, sizeof(temp));
1293 /* the userland length has been corrupted */
1294 DPRINTF("corrupt userland length "
1295 "%u > %u\n", temp, rem);
1296 fs_ep.status = USB_ERR_INVAL;
1301 /* get actual transfer length */
1302 length = xfer->frlengths[n];
1303 if (length > temp) {
1305 fs_ep.status = USB_ERR_INVAL;
1306 DPRINTF("data overflow %u > %u\n",
1312 /* we need to know the destination buffer */
1313 error = copyin(fs_ep.ppBuffer + n,
1314 &uaddr, sizeof(uaddr));
1318 if (xfer->flags_int.isochronous_xfr) {
1319 /* only one frame buffer */
1320 kaddr = USB_ADD_BYTES(
1321 xfer->frbuffers[0].buffer, offset);
1323 /* multiple frame buffers */
1324 kaddr = xfer->frbuffers[n].buffer;
1328 error = copyout(kaddr, uaddr, length);
1334 * Update offset according to initial length, which is
1335 * needed by isochronous transfers!
1340 error = copyout(&length,
1341 fs_ep.pLength + n, sizeof(length));
1348 /* update "aFrames" */
1349 error = copyout(&fs_ep.aFrames, &fs_ep_uptr->aFrames,
1350 sizeof(fs_ep.aFrames));
1354 /* update "isoc_time_complete" */
1355 error = copyout(&fs_ep.isoc_time_complete,
1356 &fs_ep_uptr->isoc_time_complete,
1357 sizeof(fs_ep.isoc_time_complete));
1360 /* update "status" */
1361 error = copyout(&fs_ep.status, &fs_ep_uptr->status,
1362 sizeof(fs_ep.status));
1368 ugen_fifo_in_use(struct usb_fifo *f, int fflags)
1370 struct usb_fifo *f_rx;
1371 struct usb_fifo *f_tx;
1373 f_rx = f->udev->fifo[(f->fifo_index & ~1) + USB_FIFO_RX];
1374 f_tx = f->udev->fifo[(f->fifo_index & ~1) + USB_FIFO_TX];
1376 if ((fflags & FREAD) && f_rx &&
1377 (f_rx->xfer[0] || f_rx->xfer[1])) {
1378 return (1); /* RX FIFO in use */
1380 if ((fflags & FWRITE) && f_tx &&
1381 (f_tx->xfer[0] || f_tx->xfer[1])) {
1382 return (1); /* TX FIFO in use */
1384 return (0); /* not in use */
1388 ugen_ioctl(struct usb_fifo *f, u_long cmd, void *addr, int fflags)
1390 struct usb_config usb_config[1];
1391 struct usb_device_request req;
1393 struct usb_fs_complete *pcomp;
1394 struct usb_fs_start *pstart;
1395 struct usb_fs_stop *pstop;
1396 struct usb_fs_open *popen;
1397 struct usb_fs_open_stream *popen_stream;
1398 struct usb_fs_close *pclose;
1399 struct usb_fs_clear_stall_sync *pstall;
1402 struct usb_endpoint *ep;
1403 struct usb_endpoint_descriptor *ed;
1404 struct usb_xfer *xfer;
1406 uint8_t iface_index;
1413 DPRINTFN(6, "cmd=0x%08lx\n", cmd);
1416 case USB_FS_COMPLETE:
1417 mtx_lock(f->priv_mtx);
1418 error = ugen_fs_get_complete(f, &ep_index);
1419 mtx_unlock(f->priv_mtx);
1425 u.pcomp->ep_index = ep_index;
1426 error = ugen_fs_copy_out(f, u.pcomp->ep_index);
1430 error = ugen_fs_copy_in(f, u.pstart->ep_index);
1433 mtx_lock(f->priv_mtx);
1434 xfer = f->fs_xfer[u.pstart->ep_index];
1435 usbd_transfer_start(xfer);
1436 mtx_unlock(f->priv_mtx);
1440 if (u.pstop->ep_index >= f->fs_ep_max) {
1444 mtx_lock(f->priv_mtx);
1445 xfer = f->fs_xfer[u.pstart->ep_index];
1446 if (usbd_transfer_pending(xfer)) {
1447 usbd_transfer_stop(xfer);
1449 * Check if the USB transfer was stopped
1450 * before it was even started. Else a cancel
1451 * callback will be pending.
1453 if (!xfer->flags_int.transferring) {
1454 ugen_fs_set_complete(xfer->priv_sc,
1455 USB_P2U(xfer->priv_fifo));
1458 mtx_unlock(f->priv_mtx);
1462 case USB_FS_OPEN_STREAM:
1463 if (u.popen->ep_index >= f->fs_ep_max) {
1467 if (f->fs_xfer[u.popen->ep_index] != NULL) {
1471 if (u.popen->max_bufsize > USB_FS_MAX_BUFSIZE) {
1472 u.popen->max_bufsize = USB_FS_MAX_BUFSIZE;
1474 if (u.popen->max_frames & USB_FS_MAX_FRAMES_PRE_SCALE) {
1476 u.popen->max_frames &= ~USB_FS_MAX_FRAMES_PRE_SCALE;
1480 if (u.popen->max_frames > USB_FS_MAX_FRAMES) {
1481 u.popen->max_frames = USB_FS_MAX_FRAMES;
1484 if (u.popen->max_frames == 0) {
1488 ep = usbd_get_ep_by_addr(f->udev, u.popen->ep_no);
1498 iface_index = ep->iface_index;
1500 memset(usb_config, 0, sizeof(usb_config));
1502 usb_config[0].type = ed->bmAttributes & UE_XFERTYPE;
1503 usb_config[0].endpoint = ed->bEndpointAddress & UE_ADDR;
1504 usb_config[0].direction = ed->bEndpointAddress & (UE_DIR_OUT | UE_DIR_IN);
1505 usb_config[0].interval = USB_DEFAULT_INTERVAL;
1506 usb_config[0].flags.proxy_buffer = 1;
1508 usb_config[0].flags.pre_scale_frames = 1;
1509 usb_config[0].callback = &ugen_ctrl_fs_callback;
1510 usb_config[0].timeout = 0; /* no timeout */
1511 usb_config[0].frames = u.popen->max_frames;
1512 usb_config[0].bufsize = u.popen->max_bufsize;
1513 usb_config[0].usb_mode = USB_MODE_DUAL; /* both modes */
1514 if (cmd == USB_FS_OPEN_STREAM)
1515 usb_config[0].stream_id = u.popen_stream->stream_id;
1517 if (usb_config[0].type == UE_CONTROL) {
1518 if (f->udev->flags.usb_mode != USB_MODE_HOST) {
1524 isread = ((usb_config[0].endpoint &
1525 (UE_DIR_IN | UE_DIR_OUT)) == UE_DIR_IN);
1527 if (f->udev->flags.usb_mode != USB_MODE_HOST) {
1530 /* check permissions */
1532 if (!(fflags & FREAD)) {
1537 if (!(fflags & FWRITE)) {
1543 error = usbd_transfer_setup(f->udev, &iface_index,
1544 f->fs_xfer + u.popen->ep_index, usb_config, 1,
1547 /* update maximums */
1548 u.popen->max_packet_length =
1549 f->fs_xfer[u.popen->ep_index]->max_frame_size;
1550 u.popen->max_bufsize =
1551 f->fs_xfer[u.popen->ep_index]->max_data_length;
1552 /* update number of frames */
1553 u.popen->max_frames =
1554 f->fs_xfer[u.popen->ep_index]->nframes;
1555 /* store index of endpoint */
1556 f->fs_xfer[u.popen->ep_index]->priv_fifo =
1557 ((uint8_t *)0) + u.popen->ep_index;
1564 if (u.pclose->ep_index >= f->fs_ep_max) {
1568 if (f->fs_xfer[u.pclose->ep_index] == NULL) {
1572 usbd_transfer_unsetup(f->fs_xfer + u.pclose->ep_index, 1);
1575 case USB_FS_CLEAR_STALL_SYNC:
1576 if (u.pstall->ep_index >= f->fs_ep_max) {
1580 if (f->fs_xfer[u.pstall->ep_index] == NULL) {
1584 if (f->udev->flags.usb_mode != USB_MODE_HOST) {
1588 mtx_lock(f->priv_mtx);
1589 error = usbd_transfer_pending(f->fs_xfer[u.pstall->ep_index]);
1590 mtx_unlock(f->priv_mtx);
1595 ep = f->fs_xfer[u.pstall->ep_index]->endpoint;
1597 /* setup a clear-stall packet */
1598 req.bmRequestType = UT_WRITE_ENDPOINT;
1599 req.bRequest = UR_CLEAR_FEATURE;
1600 USETW(req.wValue, UF_ENDPOINT_HALT);
1601 req.wIndex[0] = ep->edesc->bEndpointAddress;
1603 USETW(req.wLength, 0);
1605 error = usbd_do_request(f->udev, NULL, &req, NULL);
1607 usbd_clear_data_toggle(f->udev, ep);
1618 DPRINTFN(6, "error=%d\n", error);
1624 ugen_set_short_xfer(struct usb_fifo *f, void *addr)
1633 if (f->flag_short == t) {
1634 /* same value like before - accept */
1637 if (f->xfer[0] || f->xfer[1]) {
1638 /* cannot change this during transfer */
1646 ugen_set_timeout(struct usb_fifo *f, void *addr)
1648 f->timeout = *(int *)addr;
1649 if (f->timeout > 65535) {
1650 /* limit user input */
1657 ugen_get_frame_size(struct usb_fifo *f, void *addr)
1660 *(int *)addr = f->xfer[0]->max_frame_size;
1668 ugen_set_buffer_size(struct usb_fifo *f, void *addr)
1672 if (*(int *)addr < 0)
1673 t = 0; /* use "wMaxPacketSize" */
1674 else if (*(int *)addr < (256 * 1024))
1679 if (f->bufsize == t) {
1680 /* same value like before - accept */
1683 if (f->xfer[0] || f->xfer[1]) {
1684 /* cannot change this during transfer */
1692 ugen_get_buffer_size(struct usb_fifo *f, void *addr)
1694 *(int *)addr = f->bufsize;
1699 ugen_get_iface_desc(struct usb_fifo *f,
1700 struct usb_interface_descriptor *idesc)
1702 struct usb_interface *iface;
1704 iface = usbd_get_iface(f->udev, f->iface_index);
1705 if (iface && iface->idesc) {
1706 *idesc = *(iface->idesc);
1714 ugen_get_endpoint_desc(struct usb_fifo *f,
1715 struct usb_endpoint_descriptor *ed)
1717 struct usb_endpoint *ep;
1719 ep = usb_fifo_softc(f);
1721 if (ep && ep->edesc) {
1730 ugen_set_power_mode(struct usb_fifo *f, int mode)
1732 struct usb_device *udev = f->udev;
1736 if ((udev == NULL) ||
1737 (udev->parent_hub == NULL)) {
1740 err = priv_check(curthread, PRIV_DRIVER);
1744 /* get old power mode */
1745 old_mode = udev->power_mode;
1747 /* if no change, then just return */
1748 if (old_mode == mode)
1752 case USB_POWER_MODE_OFF:
1753 if (udev->flags.usb_mode == USB_MODE_HOST &&
1754 udev->re_enumerate_wait == USB_RE_ENUM_DONE) {
1755 udev->re_enumerate_wait = USB_RE_ENUM_PWR_OFF;
1757 /* set power mode will wake up the explore thread */
1760 case USB_POWER_MODE_ON:
1761 case USB_POWER_MODE_SAVE:
1764 case USB_POWER_MODE_RESUME:
1766 /* let USB-powerd handle resume */
1767 USB_BUS_LOCK(udev->bus);
1768 udev->pwr_save.write_refs++;
1769 udev->pwr_save.last_xfer_time = ticks;
1770 USB_BUS_UNLOCK(udev->bus);
1772 /* set new power mode */
1773 usbd_set_power_mode(udev, USB_POWER_MODE_SAVE);
1775 /* wait for resume to complete */
1776 usb_pause_mtx(NULL, hz / 4);
1778 /* clear write reference */
1779 USB_BUS_LOCK(udev->bus);
1780 udev->pwr_save.write_refs--;
1781 USB_BUS_UNLOCK(udev->bus);
1783 mode = USB_POWER_MODE_SAVE;
1786 case USB_POWER_MODE_SUSPEND:
1788 /* let USB-powerd handle suspend */
1789 USB_BUS_LOCK(udev->bus);
1790 udev->pwr_save.last_xfer_time = ticks - (256 * hz);
1791 USB_BUS_UNLOCK(udev->bus);
1793 mode = USB_POWER_MODE_SAVE;
1801 return (ENXIO); /* I/O failure */
1803 /* if we are powered off we need to re-enumerate first */
1804 if (old_mode == USB_POWER_MODE_OFF) {
1805 if (udev->flags.usb_mode == USB_MODE_HOST &&
1806 udev->re_enumerate_wait == USB_RE_ENUM_DONE) {
1807 udev->re_enumerate_wait = USB_RE_ENUM_START;
1809 /* set power mode will wake up the explore thread */
1812 /* set new power mode */
1813 usbd_set_power_mode(udev, mode);
1815 return (0); /* success */
1819 ugen_get_power_mode(struct usb_fifo *f)
1821 struct usb_device *udev = f->udev;
1824 return (USB_POWER_MODE_ON);
1826 return (udev->power_mode);
1830 ugen_get_port_path(struct usb_fifo *f, struct usb_device_port_path *dpp)
1832 struct usb_device *udev = f->udev;
1833 struct usb_device *next;
1834 unsigned int nlevel = 0;
1839 dpp->udp_bus = device_get_unit(udev->bus->bdev);
1840 dpp->udp_index = udev->device_index;
1842 /* count port levels */
1844 while (next->parent_hub != NULL) {
1846 next = next->parent_hub;
1849 /* check if too many levels */
1850 if (nlevel > USB_DEVICE_PORT_PATH_MAX)
1853 /* store total level of ports */
1854 dpp->udp_port_level = nlevel;
1856 /* store port index array */
1858 while (next->parent_hub != NULL) {
1859 dpp->udp_port_no[--nlevel] = next->port_no;
1860 next = next->parent_hub;
1862 return (0); /* success */
1865 return (EINVAL); /* failure */
1869 ugen_get_power_usage(struct usb_fifo *f)
1871 struct usb_device *udev = f->udev;
1876 return (udev->power);
1880 ugen_do_port_feature(struct usb_fifo *f, uint8_t port_no,
1881 uint8_t set, uint16_t feature)
1883 struct usb_device *udev = f->udev;
1884 struct usb_hub *hub;
1887 err = priv_check(curthread, PRIV_DRIVER);
1894 if ((udev == NULL) ||
1895 (udev->hub == NULL)) {
1900 if (port_no > hub->nports) {
1904 err = usbd_req_set_port_feature(udev,
1905 NULL, port_no, feature);
1907 err = usbd_req_clear_port_feature(udev,
1908 NULL, port_no, feature);
1911 return (ENXIO); /* failure */
1913 return (0); /* success */
1917 ugen_iface_ioctl(struct usb_fifo *f, u_long cmd, void *addr, int fflags)
1919 struct usb_fifo *f_rx;
1920 struct usb_fifo *f_tx;
1923 f_rx = f->udev->fifo[(f->fifo_index & ~1) + USB_FIFO_RX];
1924 f_tx = f->udev->fifo[(f->fifo_index & ~1) + USB_FIFO_TX];
1927 case USB_SET_RX_SHORT_XFER:
1928 if (fflags & FREAD) {
1929 error = ugen_set_short_xfer(f_rx, addr);
1935 case USB_SET_TX_FORCE_SHORT:
1936 if (fflags & FWRITE) {
1937 error = ugen_set_short_xfer(f_tx, addr);
1943 case USB_SET_RX_TIMEOUT:
1944 if (fflags & FREAD) {
1945 error = ugen_set_timeout(f_rx, addr);
1951 case USB_SET_TX_TIMEOUT:
1952 if (fflags & FWRITE) {
1953 error = ugen_set_timeout(f_tx, addr);
1959 case USB_GET_RX_FRAME_SIZE:
1960 if (fflags & FREAD) {
1961 error = ugen_get_frame_size(f_rx, addr);
1967 case USB_GET_TX_FRAME_SIZE:
1968 if (fflags & FWRITE) {
1969 error = ugen_get_frame_size(f_tx, addr);
1975 case USB_SET_RX_BUFFER_SIZE:
1976 if (fflags & FREAD) {
1977 error = ugen_set_buffer_size(f_rx, addr);
1983 case USB_SET_TX_BUFFER_SIZE:
1984 if (fflags & FWRITE) {
1985 error = ugen_set_buffer_size(f_tx, addr);
1991 case USB_GET_RX_BUFFER_SIZE:
1992 if (fflags & FREAD) {
1993 error = ugen_get_buffer_size(f_rx, addr);
1999 case USB_GET_TX_BUFFER_SIZE:
2000 if (fflags & FWRITE) {
2001 error = ugen_get_buffer_size(f_tx, addr);
2007 case USB_GET_RX_INTERFACE_DESC:
2008 if (fflags & FREAD) {
2009 error = ugen_get_iface_desc(f_rx, addr);
2015 case USB_GET_TX_INTERFACE_DESC:
2016 if (fflags & FWRITE) {
2017 error = ugen_get_iface_desc(f_tx, addr);
2023 case USB_GET_RX_ENDPOINT_DESC:
2024 if (fflags & FREAD) {
2025 error = ugen_get_endpoint_desc(f_rx, addr);
2031 case USB_GET_TX_ENDPOINT_DESC:
2032 if (fflags & FWRITE) {
2033 error = ugen_get_endpoint_desc(f_tx, addr);
2039 case USB_SET_RX_STALL_FLAG:
2040 if ((fflags & FREAD) && (*(int *)addr)) {
2041 f_rx->flag_stall = 1;
2045 case USB_SET_TX_STALL_FLAG:
2046 if ((fflags & FWRITE) && (*(int *)addr)) {
2047 f_tx->flag_stall = 1;
2059 ugen_ioctl_post(struct usb_fifo *f, u_long cmd, void *addr, int fflags)
2062 struct usb_interface_descriptor *idesc;
2063 struct usb_alt_interface *ai;
2064 struct usb_device_descriptor *ddesc;
2065 struct usb_config_descriptor *cdesc;
2066 struct usb_device_stats *stat;
2067 struct usb_fs_init *pinit;
2068 struct usb_fs_uninit *puninit;
2069 struct usb_device_port_path *dpp;
2074 struct usb_device_descriptor *dtemp;
2075 struct usb_config_descriptor *ctemp;
2076 struct usb_interface *iface;
2082 DPRINTFN(6, "cmd=0x%08lx\n", cmd);
2086 usb_needs_explore_all();
2090 if (!(fflags & FWRITE)) {
2094 usb_debug = *(int *)addr;
2097 case USB_GET_CONFIG:
2098 *(int *)addr = f->udev->curr_config_index;
2101 case USB_SET_CONFIG:
2102 if (!(fflags & FWRITE)) {
2106 error = ugen_set_config(f, *(int *)addr);
2109 case USB_GET_ALTINTERFACE:
2110 iface = usbd_get_iface(f->udev,
2111 u.ai->uai_interface_index);
2112 if (iface && iface->idesc) {
2113 u.ai->uai_alt_index = iface->alt_index;
2119 case USB_SET_ALTINTERFACE:
2120 if (!(fflags & FWRITE)) {
2124 error = ugen_set_interface(f,
2125 u.ai->uai_interface_index, u.ai->uai_alt_index);
2128 case USB_GET_DEVICE_DESC:
2129 dtemp = usbd_get_device_descriptor(f->udev);
2137 case USB_GET_CONFIG_DESC:
2138 ctemp = usbd_get_config_descriptor(f->udev);
2146 case USB_GET_FULL_DESC:
2147 error = ugen_get_cdesc(f, addr);
2150 case USB_GET_STRING_DESC:
2151 error = ugen_get_sdesc(f, addr);
2154 case USB_GET_IFACE_DRIVER:
2155 error = ugen_get_iface_driver(f, addr);
2159 case USB_DO_REQUEST:
2160 if (!(fflags & FWRITE)) {
2164 error = ugen_do_request(f, addr);
2167 case USB_DEVICEINFO:
2168 case USB_GET_DEVICEINFO:
2169 error = usb_gen_fill_deviceinfo(f, addr);
2172 case USB_DEVICESTATS:
2173 for (n = 0; n != 4; n++) {
2175 u.stat->uds_requests_fail[n] =
2176 f->udev->bus->stats_err.uds_requests[n];
2178 u.stat->uds_requests_ok[n] =
2179 f->udev->bus->stats_ok.uds_requests[n];
2183 case USB_DEVICEENUMERATE:
2184 error = ugen_re_enumerate(f);
2187 case USB_GET_PLUGTIME:
2188 *u.ptime = f->udev->plugtime;
2191 case USB_CLAIM_INTERFACE:
2192 case USB_RELEASE_INTERFACE:
2196 case USB_IFACE_DRIVER_ACTIVE:
2200 iface = usbd_get_iface(f->udev, n);
2202 if (iface && iface->subdev)
2208 case USB_IFACE_DRIVER_DETACH:
2210 error = priv_check(curthread, PRIV_DRIVER);
2217 if (n == USB_IFACE_INDEX_ANY) {
2223 * Detach the currently attached driver.
2225 usb_detach_device(f->udev, n, 0);
2228 * Set parent to self, this should keep attach away
2229 * until the next set configuration event.
2231 usbd_set_parent_iface(f->udev, n, n);
2234 case USB_SET_POWER_MODE:
2235 error = ugen_set_power_mode(f, *u.pint);
2238 case USB_GET_POWER_MODE:
2239 *u.pint = ugen_get_power_mode(f);
2242 case USB_GET_DEV_PORT_PATH:
2243 error = ugen_get_port_path(f, u.dpp);
2246 case USB_GET_POWER_USAGE:
2247 *u.pint = ugen_get_power_usage(f);
2250 case USB_SET_PORT_ENABLE:
2251 error = ugen_do_port_feature(f,
2252 *u.pint, 1, UHF_PORT_ENABLE);
2255 case USB_SET_PORT_DISABLE:
2256 error = ugen_do_port_feature(f,
2257 *u.pint, 0, UHF_PORT_ENABLE);
2261 /* verify input parameters */
2262 if (u.pinit->pEndpoints == NULL) {
2266 if (u.pinit->ep_index_max > 127) {
2270 if (u.pinit->ep_index_max == 0) {
2274 if (f->fs_xfer != NULL) {
2278 if (f->dev_ep_index != 0) {
2282 if (ugen_fifo_in_use(f, fflags)) {
2286 error = usb_fifo_alloc_buffer(f, 1, u.pinit->ep_index_max);
2290 f->fs_xfer = malloc(sizeof(f->fs_xfer[0]) *
2291 u.pinit->ep_index_max, M_USB, M_WAITOK | M_ZERO);
2292 if (f->fs_xfer == NULL) {
2293 usb_fifo_free_buffer(f);
2297 f->fs_ep_max = u.pinit->ep_index_max;
2298 f->fs_ep_ptr = u.pinit->pEndpoints;
2302 if (u.puninit->dummy != 0) {
2306 error = ugen_fs_uninit(f);
2310 mtx_lock(f->priv_mtx);
2311 error = ugen_iface_ioctl(f, cmd, addr, fflags);
2312 mtx_unlock(f->priv_mtx);
2315 DPRINTFN(6, "error=%d\n", error);
2320 ugen_ctrl_fs_callback(struct usb_xfer *xfer, usb_error_t error)
2322 ; /* workaround for a bug in "indent" */
2324 DPRINTF("st=%u alen=%u aframes=%u\n",
2325 USB_GET_STATE(xfer), xfer->actlen, xfer->aframes);
2327 switch (USB_GET_STATE(xfer)) {
2329 usbd_transfer_submit(xfer);
2332 ugen_fs_set_complete(xfer->priv_sc, USB_P2U(xfer->priv_fifo));
2336 #endif /* USB_HAVE_UGEN */