blob: 31351826f2baddc7c18d17276016745f3d5c2491 [file] [log] [blame]
Ben Williamsonf2ebf92c2006-08-01 11:28:16 +10001/*
2 * gmidi.c -- USB MIDI Gadget Driver
3 *
4 * Copyright (C) 2006 Thumtronics Pty Ltd.
5 * Developed for Thumtronics by Grey Innovation
6 * Ben Williamson <ben.williamson@greyinnovation.com>
7 *
8 * This software is distributed under the terms of the GNU General Public
9 * License ("GPL") version 2, as published by the Free Software Foundation.
10 *
11 * This code is based in part on:
12 *
13 * Gadget Zero driver, Copyright (C) 2003-2004 David Brownell.
14 * USB Audio driver, Copyright (C) 2002 by Takashi Iwai.
15 * USB MIDI driver, Copyright (C) 2002-2005 Clemens Ladisch.
16 *
17 * Refer to the USB Device Class Definition for MIDI Devices:
18 * http://www.usb.org/developers/devclass_docs/midi10.pdf
19 */
20
21#define DEBUG 1
22// #define VERBOSE
23
Ben Williamsonf2ebf92c2006-08-01 11:28:16 +100024#include <linux/module.h>
25#include <linux/kernel.h>
26#include <linux/delay.h>
27#include <linux/errno.h>
28#include <linux/init.h>
29#include <linux/utsname.h>
30#include <linux/device.h>
31#include <linux/moduleparam.h>
32
33#include <sound/driver.h>
34#include <sound/core.h>
35#include <sound/initval.h>
36#include <sound/rawmidi.h>
37
38#include <linux/usb_ch9.h>
39#include <linux/usb_gadget.h>
40#include <linux/usb/audio.h>
41#include <linux/usb/midi.h>
42
43#include "gadget_chips.h"
44
45MODULE_AUTHOR("Ben Williamson");
46MODULE_LICENSE("GPL v2");
47
48#define DRIVER_VERSION "25 Jul 2006"
49
50static const char shortname[] = "g_midi";
51static const char longname[] = "MIDI Gadget";
52
53static int index = SNDRV_DEFAULT_IDX1;
54static char *id = SNDRV_DEFAULT_STR1;
55
56module_param(index, int, 0444);
57MODULE_PARM_DESC(index, "Index value for the USB MIDI Gadget adapter.");
58module_param(id, charp, 0444);
59MODULE_PARM_DESC(id, "ID string for the USB MIDI Gadget adapter.");
60
61/* Some systems will want different product identifers published in the
62 * device descriptor, either numbers or strings or both. These string
63 * parameters are in UTF-8 (superset of ASCII's 7 bit characters).
64 */
65
66static ushort idVendor;
67module_param(idVendor, ushort, S_IRUGO);
68MODULE_PARM_DESC(idVendor, "USB Vendor ID");
69
70static ushort idProduct;
71module_param(idProduct, ushort, S_IRUGO);
72MODULE_PARM_DESC(idProduct, "USB Product ID");
73
74static ushort bcdDevice;
75module_param(bcdDevice, ushort, S_IRUGO);
76MODULE_PARM_DESC(bcdDevice, "USB Device version (BCD)");
77
78static char *iManufacturer;
79module_param(iManufacturer, charp, S_IRUGO);
80MODULE_PARM_DESC(iManufacturer, "USB Manufacturer string");
81
82static char *iProduct;
83module_param(iProduct, charp, S_IRUGO);
84MODULE_PARM_DESC(iProduct, "USB Product string");
85
86static char *iSerialNumber;
87module_param(iSerialNumber, charp, S_IRUGO);
88MODULE_PARM_DESC(iSerialNumber, "SerialNumber");
89
90/*
91 * this version autoconfigures as much as possible,
92 * which is reasonable for most "bulk-only" drivers.
93 */
94static const char *EP_IN_NAME;
95static const char *EP_OUT_NAME;
96
97
98/* big enough to hold our biggest descriptor */
99#define USB_BUFSIZ 256
100
101
102/* This is a gadget, and the IN/OUT naming is from the host's perspective.
103 USB -> OUT endpoint -> rawmidi
104 USB <- IN endpoint <- rawmidi */
105struct gmidi_in_port {
106 struct gmidi_device* dev;
107 int active;
108 uint8_t cable; /* cable number << 4 */
109 uint8_t state;
110#define STATE_UNKNOWN 0
111#define STATE_1PARAM 1
112#define STATE_2PARAM_1 2
113#define STATE_2PARAM_2 3
114#define STATE_SYSEX_0 4
115#define STATE_SYSEX_1 5
116#define STATE_SYSEX_2 6
117 uint8_t data[2];
118};
119
120struct gmidi_device {
121 spinlock_t lock;
122 struct usb_gadget *gadget;
123 struct usb_request *req; /* for control responses */
124 u8 config;
125 struct usb_ep *in_ep, *out_ep;
126 struct snd_card *card;
127 struct snd_rawmidi *rmidi;
128 struct snd_rawmidi_substream *in_substream;
129 struct snd_rawmidi_substream *out_substream;
130
131 /* For the moment we only support one port in
132 each direction, but in_port is kept as a
133 separate struct so we can have more later. */
134 struct gmidi_in_port in_port;
135 unsigned long out_triggered;
136 struct tasklet_struct tasklet;
137};
138
139static void gmidi_transmit(struct gmidi_device* dev, struct usb_request* req);
140
141
142#define xprintk(d,level,fmt,args...) \
143 dev_printk(level , &(d)->gadget->dev , fmt , ## args)
144
145#ifdef DEBUG
146#define DBG(dev,fmt,args...) \
147 xprintk(dev , KERN_DEBUG , fmt , ## args)
148#else
149#define DBG(dev,fmt,args...) \
150 do { } while (0)
151#endif /* DEBUG */
152
153#ifdef VERBOSE
154#define VDBG DBG
155#else
156#define VDBG(dev,fmt,args...) \
157 do { } while (0)
158#endif /* VERBOSE */
159
160#define ERROR(dev,fmt,args...) \
161 xprintk(dev , KERN_ERR , fmt , ## args)
162#define WARN(dev,fmt,args...) \
163 xprintk(dev , KERN_WARNING , fmt , ## args)
164#define INFO(dev,fmt,args...) \
165 xprintk(dev , KERN_INFO , fmt , ## args)
166
167
168static unsigned buflen = 256;
169static unsigned qlen = 32;
170
171module_param(buflen, uint, S_IRUGO);
172module_param(qlen, uint, S_IRUGO);
173
174
175/* Thanks to Grey Innovation for donating this product ID.
176 *
177 * DO NOT REUSE THESE IDs with a protocol-incompatible driver!! Ever!!
178 * Instead: allocate your own, using normal USB-IF procedures.
179 */
180#define DRIVER_VENDOR_NUM 0x17b3 /* Grey Innovation */
181#define DRIVER_PRODUCT_NUM 0x0004 /* Linux-USB "MIDI Gadget" */
182
183
184/*
185 * DESCRIPTORS ... most are static, but strings and (full)
186 * configuration descriptors are built on demand.
187 */
188
189#define STRING_MANUFACTURER 25
190#define STRING_PRODUCT 42
191#define STRING_SERIAL 101
192#define STRING_MIDI_GADGET 250
193
194/* We only have the one configuration, it's number 1. */
195#define GMIDI_CONFIG 1
196
197/* We have two interfaces- AudioControl and MIDIStreaming */
198#define GMIDI_AC_INTERFACE 0
199#define GMIDI_MS_INTERFACE 1
200#define GMIDI_NUM_INTERFACES 2
201
202DECLARE_USB_AC_HEADER_DESCRIPTOR(1);
203DECLARE_USB_MIDI_OUT_JACK_DESCRIPTOR(1);
204DECLARE_USB_MS_ENDPOINT_DESCRIPTOR(1);
205
206/* B.1 Device Descriptor */
207static struct usb_device_descriptor device_desc = {
208 .bLength = USB_DT_DEVICE_SIZE,
209 .bDescriptorType = USB_DT_DEVICE,
210 .bcdUSB = __constant_cpu_to_le16(0x0200),
211 .bDeviceClass = USB_CLASS_PER_INTERFACE,
212 .idVendor = __constant_cpu_to_le16(DRIVER_VENDOR_NUM),
213 .idProduct = __constant_cpu_to_le16(DRIVER_PRODUCT_NUM),
214 .iManufacturer = STRING_MANUFACTURER,
215 .iProduct = STRING_PRODUCT,
216 .bNumConfigurations = 1,
217};
218
219/* B.2 Configuration Descriptor */
220static struct usb_config_descriptor config_desc = {
221 .bLength = USB_DT_CONFIG_SIZE,
222 .bDescriptorType = USB_DT_CONFIG,
223 /* compute wTotalLength on the fly */
224 .bNumInterfaces = GMIDI_NUM_INTERFACES,
225 .bConfigurationValue = GMIDI_CONFIG,
226 .iConfiguration = STRING_MIDI_GADGET,
227 /*
228 * FIXME: When embedding this driver in a device,
229 * these need to be set to reflect the actual
230 * power properties of the device. Is it selfpowered?
231 */
232 .bmAttributes = USB_CONFIG_ATT_ONE,
233 .bMaxPower = 1,
234};
235
236/* B.3.1 Standard AC Interface Descriptor */
237static const struct usb_interface_descriptor ac_interface_desc = {
238 .bLength = USB_DT_INTERFACE_SIZE,
239 .bDescriptorType = USB_DT_INTERFACE,
240 .bInterfaceNumber = GMIDI_AC_INTERFACE,
241 .bNumEndpoints = 0,
242 .bInterfaceClass = USB_CLASS_AUDIO,
243 .bInterfaceSubClass = USB_SUBCLASS_AUDIOCONTROL,
244 .iInterface = STRING_MIDI_GADGET,
245};
246
247/* B.3.2 Class-Specific AC Interface Descriptor */
248static const struct usb_ac_header_descriptor_1 ac_header_desc = {
249 .bLength = USB_DT_AC_HEADER_SIZE(1),
250 .bDescriptorType = USB_DT_CS_INTERFACE,
251 .bDescriptorSubtype = USB_MS_HEADER,
252 .bcdADC = __constant_cpu_to_le16(0x0100),
253 .wTotalLength = USB_DT_AC_HEADER_SIZE(1),
254 .bInCollection = 1,
255 .baInterfaceNr = {
256 [0] = GMIDI_MS_INTERFACE,
257 }
258};
259
260/* B.4.1 Standard MS Interface Descriptor */
261static const struct usb_interface_descriptor ms_interface_desc = {
262 .bLength = USB_DT_INTERFACE_SIZE,
263 .bDescriptorType = USB_DT_INTERFACE,
264 .bInterfaceNumber = GMIDI_MS_INTERFACE,
265 .bNumEndpoints = 2,
266 .bInterfaceClass = USB_CLASS_AUDIO,
267 .bInterfaceSubClass = USB_SUBCLASS_MIDISTREAMING,
268 .iInterface = STRING_MIDI_GADGET,
269};
270
271/* B.4.2 Class-Specific MS Interface Descriptor */
272static const struct usb_ms_header_descriptor ms_header_desc = {
273 .bLength = USB_DT_MS_HEADER_SIZE,
274 .bDescriptorType = USB_DT_CS_INTERFACE,
275 .bDescriptorSubtype = USB_MS_HEADER,
276 .bcdMSC = __constant_cpu_to_le16(0x0100),
277 .wTotalLength = USB_DT_MS_HEADER_SIZE
278 + 2*USB_DT_MIDI_IN_SIZE
279 + 2*USB_DT_MIDI_OUT_SIZE(1),
280};
281
282#define JACK_IN_EMB 1
283#define JACK_IN_EXT 2
284#define JACK_OUT_EMB 3
285#define JACK_OUT_EXT 4
286
287/* B.4.3 MIDI IN Jack Descriptors */
288static const struct usb_midi_in_jack_descriptor jack_in_emb_desc = {
289 .bLength = USB_DT_MIDI_IN_SIZE,
290 .bDescriptorType = USB_DT_CS_INTERFACE,
291 .bDescriptorSubtype = USB_MS_MIDI_IN_JACK,
292 .bJackType = USB_MS_EMBEDDED,
293 .bJackID = JACK_IN_EMB,
294};
295
296static const struct usb_midi_in_jack_descriptor jack_in_ext_desc = {
297 .bLength = USB_DT_MIDI_IN_SIZE,
298 .bDescriptorType = USB_DT_CS_INTERFACE,
299 .bDescriptorSubtype = USB_MS_MIDI_IN_JACK,
300 .bJackType = USB_MS_EXTERNAL,
301 .bJackID = JACK_IN_EXT,
302};
303
304/* B.4.4 MIDI OUT Jack Descriptors */
305static const struct usb_midi_out_jack_descriptor_1 jack_out_emb_desc = {
306 .bLength = USB_DT_MIDI_OUT_SIZE(1),
307 .bDescriptorType = USB_DT_CS_INTERFACE,
308 .bDescriptorSubtype = USB_MS_MIDI_OUT_JACK,
309 .bJackType = USB_MS_EMBEDDED,
310 .bJackID = JACK_OUT_EMB,
311 .bNrInputPins = 1,
312 .pins = {
313 [0] = {
314 .baSourceID = JACK_IN_EXT,
315 .baSourcePin = 1,
316 }
317 }
318};
319
320static const struct usb_midi_out_jack_descriptor_1 jack_out_ext_desc = {
321 .bLength = USB_DT_MIDI_OUT_SIZE(1),
322 .bDescriptorType = USB_DT_CS_INTERFACE,
323 .bDescriptorSubtype = USB_MS_MIDI_OUT_JACK,
324 .bJackType = USB_MS_EXTERNAL,
325 .bJackID = JACK_OUT_EXT,
326 .bNrInputPins = 1,
327 .pins = {
328 [0] = {
329 .baSourceID = JACK_IN_EMB,
330 .baSourcePin = 1,
331 }
332 }
333};
334
335/* B.5.1 Standard Bulk OUT Endpoint Descriptor */
336static struct usb_endpoint_descriptor bulk_out_desc = {
337 .bLength = USB_DT_ENDPOINT_AUDIO_SIZE,
338 .bDescriptorType = USB_DT_ENDPOINT,
339 .bEndpointAddress = USB_DIR_OUT,
340 .bmAttributes = USB_ENDPOINT_XFER_BULK,
341};
342
343/* B.5.2 Class-specific MS Bulk OUT Endpoint Descriptor */
344static const struct usb_ms_endpoint_descriptor_1 ms_out_desc = {
345 .bLength = USB_DT_MS_ENDPOINT_SIZE(1),
346 .bDescriptorType = USB_DT_CS_ENDPOINT,
347 .bDescriptorSubtype = USB_MS_GENERAL,
348 .bNumEmbMIDIJack = 1,
349 .baAssocJackID = {
350 [0] = JACK_IN_EMB,
351 }
352};
353
354/* B.6.1 Standard Bulk IN Endpoint Descriptor */
355static struct usb_endpoint_descriptor bulk_in_desc = {
356 .bLength = USB_DT_ENDPOINT_AUDIO_SIZE,
357 .bDescriptorType = USB_DT_ENDPOINT,
358 .bEndpointAddress = USB_DIR_IN,
359 .bmAttributes = USB_ENDPOINT_XFER_BULK,
360};
361
362/* B.6.2 Class-specific MS Bulk IN Endpoint Descriptor */
363static const struct usb_ms_endpoint_descriptor_1 ms_in_desc = {
364 .bLength = USB_DT_MS_ENDPOINT_SIZE(1),
365 .bDescriptorType = USB_DT_CS_ENDPOINT,
366 .bDescriptorSubtype = USB_MS_GENERAL,
367 .bNumEmbMIDIJack = 1,
368 .baAssocJackID = {
369 [0] = JACK_OUT_EMB,
370 }
371};
372
373static const struct usb_descriptor_header *gmidi_function [] = {
374 (struct usb_descriptor_header *)&ac_interface_desc,
375 (struct usb_descriptor_header *)&ac_header_desc,
376 (struct usb_descriptor_header *)&ms_interface_desc,
377
378 (struct usb_descriptor_header *)&ms_header_desc,
379 (struct usb_descriptor_header *)&jack_in_emb_desc,
380 (struct usb_descriptor_header *)&jack_in_ext_desc,
381 (struct usb_descriptor_header *)&jack_out_emb_desc,
382 (struct usb_descriptor_header *)&jack_out_ext_desc,
383 /* If you add more jacks, update ms_header_desc.wTotalLength */
384
385 (struct usb_descriptor_header *)&bulk_out_desc,
386 (struct usb_descriptor_header *)&ms_out_desc,
387 (struct usb_descriptor_header *)&bulk_in_desc,
388 (struct usb_descriptor_header *)&ms_in_desc,
389 NULL,
390};
391
392static char manufacturer[50];
393static char product_desc[40] = "MIDI Gadget";
394static char serial_number[20];
395
396/* static strings, in UTF-8 */
397static struct usb_string strings [] = {
398 { STRING_MANUFACTURER, manufacturer, },
399 { STRING_PRODUCT, product_desc, },
400 { STRING_SERIAL, serial_number, },
401 { STRING_MIDI_GADGET, longname, },
402 { } /* end of list */
403};
404
405static struct usb_gadget_strings stringtab = {
406 .language = 0x0409, /* en-us */
407 .strings = strings,
408};
409
410static int config_buf(struct usb_gadget *gadget,
411 u8 *buf, u8 type, unsigned index)
412{
413 int len;
414
415 /* only one configuration */
416 if (index != 0) {
417 return -EINVAL;
418 }
419 len = usb_gadget_config_buf(&config_desc,
420 buf, USB_BUFSIZ, gmidi_function);
421 if (len < 0) {
422 return len;
423 }
424 ((struct usb_config_descriptor *)buf)->bDescriptorType = type;
425 return len;
426}
427
428static struct usb_request* alloc_ep_req(struct usb_ep *ep, unsigned length)
429{
430 struct usb_request *req;
431
432 req = usb_ep_alloc_request(ep, GFP_ATOMIC);
433 if (req) {
434 req->length = length;
435 req->buf = kmalloc(length, GFP_ATOMIC);
436 if (!req->buf) {
437 usb_ep_free_request(ep, req);
438 req = NULL;
439 }
440 }
441 return req;
442}
443
444static void free_ep_req(struct usb_ep *ep, struct usb_request *req)
445{
446 kfree(req->buf);
447 usb_ep_free_request(ep, req);
448}
449
450static const uint8_t gmidi_cin_length[] = {
451 0, 0, 2, 3, 3, 1, 2, 3, 3, 3, 3, 3, 2, 2, 3, 1
452};
453
454/*
455 * Receives a chunk of MIDI data.
456 */
457static void gmidi_read_data(struct usb_ep *ep, int cable,
458 uint8_t* data, int length)
459{
460 struct gmidi_device *dev = ep->driver_data;
461 /* cable is ignored, because for now we only have one. */
462
463 if (!dev->out_substream) {
464 /* Nobody is listening - throw it on the floor. */
465 return;
466 }
467 if (!test_bit(dev->out_substream->number, &dev->out_triggered)) {
468 return;
469 }
470 snd_rawmidi_receive(dev->out_substream, data, length);
471}
472
473static void gmidi_handle_out_data(struct usb_ep *ep, struct usb_request *req)
474{
475 unsigned i;
476 u8 *buf = req->buf;
477
478 for (i = 0; i + 3 < req->actual; i += 4) {
479 if (buf[i] != 0) {
480 int cable = buf[i] >> 4;
481 int length = gmidi_cin_length[buf[i] & 0x0f];
482 gmidi_read_data(ep, cable, &buf[i + 1], length);
483 }
484 }
485}
486
487static void gmidi_complete(struct usb_ep *ep, struct usb_request *req)
488{
489 struct gmidi_device *dev = ep->driver_data;
490 int status = req->status;
491
492 switch (status) {
493 case 0: /* normal completion */
494 if (ep == dev->out_ep) {
495 /* we received stuff.
496 req is queued again, below */
497 gmidi_handle_out_data(ep, req);
498 } else if (ep == dev->in_ep) {
499 /* our transmit completed.
500 see if there's more to go.
501 gmidi_transmit eats req, don't queue it again. */
502 gmidi_transmit(dev, req);
503 return;
504 }
505 break;
506
507 /* this endpoint is normally active while we're configured */
508 case -ECONNABORTED: /* hardware forced ep reset */
509 case -ECONNRESET: /* request dequeued */
510 case -ESHUTDOWN: /* disconnect from host */
511 VDBG(dev, "%s gone (%d), %d/%d\n", ep->name, status,
512 req->actual, req->length);
513 if (ep == dev->out_ep) {
514 gmidi_handle_out_data(ep, req);
515 }
516 free_ep_req(ep, req);
517 return;
518
519 case -EOVERFLOW: /* buffer overrun on read means that
520 * we didn't provide a big enough
521 * buffer.
522 */
523 default:
524 DBG(dev, "%s complete --> %d, %d/%d\n", ep->name,
525 status, req->actual, req->length);
526 break;
527 case -EREMOTEIO: /* short read */
528 break;
529 }
530
531 status = usb_ep_queue(ep, req, GFP_ATOMIC);
532 if (status) {
533 ERROR(dev, "kill %s: resubmit %d bytes --> %d\n",
534 ep->name, req->length, status);
535 usb_ep_set_halt(ep);
536 /* FIXME recover later ... somehow */
537 }
538}
539
540static int set_gmidi_config(struct gmidi_device *dev, gfp_t gfp_flags)
541{
542 int err = 0;
543 struct usb_request *req;
544 struct usb_ep* ep;
545 unsigned i;
546
547 err = usb_ep_enable(dev->in_ep, &bulk_in_desc);
548 if (err) {
549 ERROR(dev, "can't start %s: %d\n", dev->in_ep->name, err);
550 goto fail;
551 }
552 dev->in_ep->driver_data = dev;
553
554 err = usb_ep_enable(dev->out_ep, &bulk_out_desc);
555 if (err) {
556 ERROR(dev, "can't start %s: %d\n", dev->out_ep->name, err);
557 goto fail;
558 }
559 dev->out_ep->driver_data = dev;
560
561 /* allocate a bunch of read buffers and queue them all at once. */
562 ep = dev->out_ep;
563 for (i = 0; i < qlen && err == 0; i++) {
564 req = alloc_ep_req(ep, buflen);
565 if (req) {
566 req->complete = gmidi_complete;
567 err = usb_ep_queue(ep, req, GFP_ATOMIC);
568 if (err) {
569 DBG(dev, "%s queue req: %d\n", ep->name, err);
570 }
571 } else {
572 err = -ENOMEM;
573 }
574 }
575fail:
576 /* caller is responsible for cleanup on error */
577 return err;
578}
579
580
581static void gmidi_reset_config(struct gmidi_device *dev)
582{
583 if (dev->config == 0) {
584 return;
585 }
586
587 DBG(dev, "reset config\n");
588
589 /* just disable endpoints, forcing completion of pending i/o.
590 * all our completion handlers free their requests in this case.
591 */
592 usb_ep_disable(dev->in_ep);
593 usb_ep_disable(dev->out_ep);
594 dev->config = 0;
595}
596
597/* change our operational config. this code must agree with the code
598 * that returns config descriptors, and altsetting code.
599 *
600 * it's also responsible for power management interactions. some
601 * configurations might not work with our current power sources.
602 *
603 * note that some device controller hardware will constrain what this
604 * code can do, perhaps by disallowing more than one configuration or
605 * by limiting configuration choices (like the pxa2xx).
606 */
607static int
608gmidi_set_config(struct gmidi_device *dev, unsigned number, gfp_t gfp_flags)
609{
610 int result = 0;
611 struct usb_gadget *gadget = dev->gadget;
612
613#if 0
614 /* FIXME */
615 /* Hacking this bit out fixes a bug where on receipt of two
616 USB_REQ_SET_CONFIGURATION messages, we end up with no
617 buffered OUT requests waiting for data. This is clearly
618 hiding a bug elsewhere, because if the config didn't
619 change then we really shouldn't do anything. */
620 /* Having said that, when we do "change" from config 1
621 to config 1, we at least gmidi_reset_config() which
622 clears out any requests on endpoints, so it's not like
623 we leak or anything. */
624 if (number == dev->config) {
625 return 0;
626 }
627#endif
628
629 if (gadget_is_sa1100(gadget) && dev->config) {
630 /* tx fifo is full, but we can't clear it...*/
631 INFO(dev, "can't change configurations\n");
632 return -ESPIPE;
633 }
634 gmidi_reset_config(dev);
635
636 switch (number) {
637 case GMIDI_CONFIG:
638 result = set_gmidi_config(dev, gfp_flags);
639 break;
640 default:
641 result = -EINVAL;
642 /* FALL THROUGH */
643 case 0:
644 return result;
645 }
646
647 if (!result && (!dev->in_ep || !dev->out_ep)) {
648 result = -ENODEV;
649 }
650 if (result) {
651 gmidi_reset_config(dev);
652 } else {
653 char *speed;
654
655 switch (gadget->speed) {
656 case USB_SPEED_LOW: speed = "low"; break;
657 case USB_SPEED_FULL: speed = "full"; break;
658 case USB_SPEED_HIGH: speed = "high"; break;
659 default: speed = "?"; break;
660 }
661
662 dev->config = number;
663 INFO(dev, "%s speed\n", speed);
664 }
665 return result;
666}
667
668
669static void gmidi_setup_complete(struct usb_ep *ep, struct usb_request *req)
670{
671 if (req->status || req->actual != req->length) {
672 DBG((struct gmidi_device *) ep->driver_data,
673 "setup complete --> %d, %d/%d\n",
674 req->status, req->actual, req->length);
675 }
676}
677
678/*
679 * The setup() callback implements all the ep0 functionality that's
680 * not handled lower down, in hardware or the hardware driver (like
681 * device and endpoint feature flags, and their status). It's all
682 * housekeeping for the gadget function we're implementing. Most of
683 * the work is in config-specific setup.
684 */
685static int gmidi_setup(struct usb_gadget *gadget,
686 const struct usb_ctrlrequest *ctrl)
687{
688 struct gmidi_device *dev = get_gadget_data(gadget);
689 struct usb_request *req = dev->req;
690 int value = -EOPNOTSUPP;
691 u16 w_index = le16_to_cpu(ctrl->wIndex);
692 u16 w_value = le16_to_cpu(ctrl->wValue);
693 u16 w_length = le16_to_cpu(ctrl->wLength);
694
695 /* usually this stores reply data in the pre-allocated ep0 buffer,
696 * but config change events will reconfigure hardware.
697 */
698 req->zero = 0;
699 switch (ctrl->bRequest) {
700
701 case USB_REQ_GET_DESCRIPTOR:
702 if (ctrl->bRequestType != USB_DIR_IN) {
703 goto unknown;
704 }
705 switch (w_value >> 8) {
706
707 case USB_DT_DEVICE:
708 value = min(w_length, (u16) sizeof(device_desc));
709 memcpy(req->buf, &device_desc, value);
710 break;
711 case USB_DT_CONFIG:
712 value = config_buf(gadget, req->buf,
713 w_value >> 8,
714 w_value & 0xff);
715 if (value >= 0) {
716 value = min(w_length, (u16)value);
717 }
718 break;
719
720 case USB_DT_STRING:
721 /* wIndex == language code.
722 * this driver only handles one language, you can
723 * add string tables for other languages, using
724 * any UTF-8 characters
725 */
726 value = usb_gadget_get_string(&stringtab,
727 w_value & 0xff, req->buf);
728 if (value >= 0) {
729 value = min(w_length, (u16)value);
730 }
731 break;
732 }
733 break;
734
735 /* currently two configs, two speeds */
736 case USB_REQ_SET_CONFIGURATION:
737 if (ctrl->bRequestType != 0) {
738 goto unknown;
739 }
740 if (gadget->a_hnp_support) {
741 DBG(dev, "HNP available\n");
742 } else if (gadget->a_alt_hnp_support) {
743 DBG(dev, "HNP needs a different root port\n");
744 } else {
745 VDBG(dev, "HNP inactive\n");
746 }
747 spin_lock(&dev->lock);
748 value = gmidi_set_config(dev, w_value, GFP_ATOMIC);
749 spin_unlock(&dev->lock);
750 break;
751 case USB_REQ_GET_CONFIGURATION:
752 if (ctrl->bRequestType != USB_DIR_IN) {
753 goto unknown;
754 }
755 *(u8 *)req->buf = dev->config;
756 value = min(w_length, (u16)1);
757 break;
758
759 /* until we add altsetting support, or other interfaces,
760 * only 0/0 are possible. pxa2xx only supports 0/0 (poorly)
761 * and already killed pending endpoint I/O.
762 */
763 case USB_REQ_SET_INTERFACE:
764 if (ctrl->bRequestType != USB_RECIP_INTERFACE) {
765 goto unknown;
766 }
767 spin_lock(&dev->lock);
768 if (dev->config && w_index < GMIDI_NUM_INTERFACES
769 && w_value == 0)
770 {
771 u8 config = dev->config;
772
773 /* resets interface configuration, forgets about
774 * previous transaction state (queued bufs, etc)
775 * and re-inits endpoint state (toggle etc)
776 * no response queued, just zero status == success.
777 * if we had more than one interface we couldn't
778 * use this "reset the config" shortcut.
779 */
780 gmidi_reset_config(dev);
781 gmidi_set_config(dev, config, GFP_ATOMIC);
782 value = 0;
783 }
784 spin_unlock(&dev->lock);
785 break;
786 case USB_REQ_GET_INTERFACE:
787 if (ctrl->bRequestType != (USB_DIR_IN|USB_RECIP_INTERFACE)) {
788 goto unknown;
789 }
790 if (!dev->config) {
791 break;
792 }
793 if (w_index >= GMIDI_NUM_INTERFACES) {
794 value = -EDOM;
795 break;
796 }
797 *(u8 *)req->buf = 0;
798 value = min(w_length, (u16)1);
799 break;
800
801 default:
802unknown:
803 VDBG(dev, "unknown control req%02x.%02x v%04x i%04x l%d\n",
804 ctrl->bRequestType, ctrl->bRequest,
805 w_value, w_index, w_length);
806 }
807
808 /* respond with data transfer before status phase? */
809 if (value >= 0) {
810 req->length = value;
811 req->zero = value < w_length;
812 value = usb_ep_queue(gadget->ep0, req, GFP_ATOMIC);
813 if (value < 0) {
814 DBG(dev, "ep_queue --> %d\n", value);
815 req->status = 0;
816 gmidi_setup_complete(gadget->ep0, req);
817 }
818 }
819
820 /* device either stalls (value < 0) or reports success */
821 return value;
822}
823
824static void gmidi_disconnect(struct usb_gadget *gadget)
825{
826 struct gmidi_device *dev = get_gadget_data(gadget);
827 unsigned long flags;
828
829 spin_lock_irqsave(&dev->lock, flags);
830 gmidi_reset_config(dev);
831
832 /* a more significant application might have some non-usb
833 * activities to quiesce here, saving resources like power
834 * or pushing the notification up a network stack.
835 */
836 spin_unlock_irqrestore(&dev->lock, flags);
837
838 /* next we may get setup() calls to enumerate new connections;
839 * or an unbind() during shutdown (including removing module).
840 */
841}
842
843static void /* __init_or_exit */ gmidi_unbind(struct usb_gadget *gadget)
844{
845 struct gmidi_device *dev = get_gadget_data(gadget);
846 struct snd_card* card;
847
848 DBG(dev, "unbind\n");
849
850 card = dev->card;
851 dev->card = NULL;
852 if (card) {
853 snd_card_free(card);
854 }
855
856 /* we've already been disconnected ... no i/o is active */
857 if (dev->req) {
858 dev->req->length = USB_BUFSIZ;
859 free_ep_req(gadget->ep0, dev->req);
860 }
861 kfree(dev);
862 set_gadget_data(gadget, NULL);
863}
864
865static int gmidi_snd_free(struct snd_device *device)
866{
867 return 0;
868}
869
870static void gmidi_transmit_packet(struct usb_request* req, uint8_t p0,
871 uint8_t p1, uint8_t p2, uint8_t p3)
872{
873 unsigned length = req->length;
874
875 uint8_t* buf = (uint8_t*)req->buf + length;
876 buf[0] = p0;
877 buf[1] = p1;
878 buf[2] = p2;
879 buf[3] = p3;
880 req->length = length + 4;
881}
882
883/*
884 * Converts MIDI commands to USB MIDI packets.
885 */
886static void gmidi_transmit_byte(struct usb_request* req,
887 struct gmidi_in_port* port, uint8_t b)
888{
889 uint8_t p0 = port->cable;
890
891 if (b >= 0xf8) {
892 gmidi_transmit_packet(req, p0 | 0x0f, b, 0, 0);
893 } else if (b >= 0xf0) {
894 switch (b) {
895 case 0xf0:
896 port->data[0] = b;
897 port->state = STATE_SYSEX_1;
898 break;
899 case 0xf1:
900 case 0xf3:
901 port->data[0] = b;
902 port->state = STATE_1PARAM;
903 break;
904 case 0xf2:
905 port->data[0] = b;
906 port->state = STATE_2PARAM_1;
907 break;
908 case 0xf4:
909 case 0xf5:
910 port->state = STATE_UNKNOWN;
911 break;
912 case 0xf6:
913 gmidi_transmit_packet(req, p0 | 0x05, 0xf6, 0, 0);
914 port->state = STATE_UNKNOWN;
915 break;
916 case 0xf7:
917 switch (port->state) {
918 case STATE_SYSEX_0:
919 gmidi_transmit_packet(req,
920 p0 | 0x05, 0xf7, 0, 0);
921 break;
922 case STATE_SYSEX_1:
923 gmidi_transmit_packet(req,
924 p0 | 0x06, port->data[0], 0xf7, 0);
925 break;
926 case STATE_SYSEX_2:
927 gmidi_transmit_packet(req,
928 p0 | 0x07, port->data[0],
929 port->data[1], 0xf7);
930 break;
931 }
932 port->state = STATE_UNKNOWN;
933 break;
934 }
935 } else if (b >= 0x80) {
936 port->data[0] = b;
937 if (b >= 0xc0 && b <= 0xdf)
938 port->state = STATE_1PARAM;
939 else
940 port->state = STATE_2PARAM_1;
941 } else { /* b < 0x80 */
942 switch (port->state) {
943 case STATE_1PARAM:
944 if (port->data[0] < 0xf0) {
945 p0 |= port->data[0] >> 4;
946 } else {
947 p0 |= 0x02;
948 port->state = STATE_UNKNOWN;
949 }
950 gmidi_transmit_packet(req, p0, port->data[0], b, 0);
951 break;
952 case STATE_2PARAM_1:
953 port->data[1] = b;
954 port->state = STATE_2PARAM_2;
955 break;
956 case STATE_2PARAM_2:
957 if (port->data[0] < 0xf0) {
958 p0 |= port->data[0] >> 4;
959 port->state = STATE_2PARAM_1;
960 } else {
961 p0 |= 0x03;
962 port->state = STATE_UNKNOWN;
963 }
964 gmidi_transmit_packet(req,
965 p0, port->data[0], port->data[1], b);
966 break;
967 case STATE_SYSEX_0:
968 port->data[0] = b;
969 port->state = STATE_SYSEX_1;
970 break;
971 case STATE_SYSEX_1:
972 port->data[1] = b;
973 port->state = STATE_SYSEX_2;
974 break;
975 case STATE_SYSEX_2:
976 gmidi_transmit_packet(req,
977 p0 | 0x04, port->data[0], port->data[1], b);
978 port->state = STATE_SYSEX_0;
979 break;
980 }
981 }
982}
983
984static void gmidi_transmit(struct gmidi_device* dev, struct usb_request* req)
985{
986 struct usb_ep* ep = dev->in_ep;
987 struct gmidi_in_port* port = &dev->in_port;
988
989 if (!ep) {
990 return;
991 }
992 if (!req) {
993 req = alloc_ep_req(ep, buflen);
994 }
995 if (!req) {
996 ERROR(dev, "gmidi_transmit: alloc_ep_request failed\n");
997 return;
998 }
999 req->length = 0;
1000 req->complete = gmidi_complete;
1001
1002 if (port->active) {
1003 while (req->length + 3 < buflen) {
1004 uint8_t b;
1005 if (snd_rawmidi_transmit(dev->in_substream, &b, 1)
1006 != 1)
1007 {
1008 port->active = 0;
1009 break;
1010 }
1011 gmidi_transmit_byte(req, port, b);
1012 }
1013 }
1014 if (req->length > 0) {
1015 usb_ep_queue(ep, req, GFP_ATOMIC);
1016 } else {
1017 free_ep_req(ep, req);
1018 }
1019}
1020
1021static void gmidi_in_tasklet(unsigned long data)
1022{
1023 struct gmidi_device* dev = (struct gmidi_device*)data;
1024
1025 gmidi_transmit(dev, NULL);
1026}
1027
1028static int gmidi_in_open(struct snd_rawmidi_substream *substream)
1029{
1030 struct gmidi_device* dev = substream->rmidi->private_data;
1031
1032 VDBG(dev, "gmidi_in_open\n");
1033 dev->in_substream = substream;
1034 dev->in_port.state = STATE_UNKNOWN;
1035 return 0;
1036}
1037
1038static int gmidi_in_close(struct snd_rawmidi_substream *substream)
1039{
1040 VDBG(dev, "gmidi_in_close\n");
1041 return 0;
1042}
1043
1044static void gmidi_in_trigger(struct snd_rawmidi_substream *substream, int up)
1045{
1046 struct gmidi_device* dev = substream->rmidi->private_data;
1047
1048 VDBG(dev, "gmidi_in_trigger %d\n", up);
1049 dev->in_port.active = up;
1050 if (up) {
1051 tasklet_hi_schedule(&dev->tasklet);
1052 }
1053}
1054
1055static int gmidi_out_open(struct snd_rawmidi_substream *substream)
1056{
1057 struct gmidi_device* dev = substream->rmidi->private_data;
1058
1059 VDBG(dev, "gmidi_out_open\n");
1060 dev->out_substream = substream;
1061 return 0;
1062}
1063
1064static int gmidi_out_close(struct snd_rawmidi_substream *substream)
1065{
1066 VDBG(dev, "gmidi_out_close\n");
1067 return 0;
1068}
1069
1070static void gmidi_out_trigger(struct snd_rawmidi_substream *substream, int up)
1071{
1072 struct gmidi_device* dev = substream->rmidi->private_data;
1073
1074 VDBG(dev, "gmidi_out_trigger %d\n", up);
1075 if (up) {
1076 set_bit(substream->number, &dev->out_triggered);
1077 } else {
1078 clear_bit(substream->number, &dev->out_triggered);
1079 }
1080}
1081
1082static struct snd_rawmidi_ops gmidi_in_ops = {
1083 .open = gmidi_in_open,
1084 .close = gmidi_in_close,
1085 .trigger = gmidi_in_trigger,
1086};
1087
1088static struct snd_rawmidi_ops gmidi_out_ops = {
1089 .open = gmidi_out_open,
1090 .close = gmidi_out_close,
1091 .trigger = gmidi_out_trigger
1092};
1093
1094/* register as a sound "card" */
1095static int gmidi_register_card(struct gmidi_device *dev)
1096{
1097 struct snd_card *card;
1098 struct snd_rawmidi *rmidi;
1099 int err;
1100 int out_ports = 1;
1101 int in_ports = 1;
1102 static struct snd_device_ops ops = {
1103 .dev_free = gmidi_snd_free,
1104 };
1105
1106 card = snd_card_new(index, id, THIS_MODULE, 0);
1107 if (!card) {
1108 ERROR(dev, "snd_card_new failed\n");
1109 err = -ENOMEM;
1110 goto fail;
1111 }
1112 dev->card = card;
1113
1114 err = snd_device_new(card, SNDRV_DEV_LOWLEVEL, dev, &ops);
1115 if (err < 0) {
1116 ERROR(dev, "snd_device_new failed: error %d\n", err);
1117 goto fail;
1118 }
1119
1120 strcpy(card->driver, longname);
1121 strcpy(card->longname, longname);
1122 strcpy(card->shortname, shortname);
1123
1124 /* Set up rawmidi */
1125 dev->in_port.dev = dev;
1126 dev->in_port.active = 0;
1127 snd_component_add(card, "MIDI");
1128 err = snd_rawmidi_new(card, "USB MIDI Gadget", 0,
1129 out_ports, in_ports, &rmidi);
1130 if (err < 0) {
1131 ERROR(dev, "snd_rawmidi_new failed: error %d\n", err);
1132 goto fail;
1133 }
1134 dev->rmidi = rmidi;
1135 strcpy(rmidi->name, card->shortname);
1136 rmidi->info_flags = SNDRV_RAWMIDI_INFO_OUTPUT |
1137 SNDRV_RAWMIDI_INFO_INPUT |
1138 SNDRV_RAWMIDI_INFO_DUPLEX;
1139 rmidi->private_data = dev;
1140
1141 /* Yes, rawmidi OUTPUT = USB IN, and rawmidi INPUT = USB OUT.
1142 It's an upside-down world being a gadget. */
1143 snd_rawmidi_set_ops(rmidi, SNDRV_RAWMIDI_STREAM_OUTPUT, &gmidi_in_ops);
1144 snd_rawmidi_set_ops(rmidi, SNDRV_RAWMIDI_STREAM_INPUT, &gmidi_out_ops);
1145
1146 snd_card_set_dev(card, &dev->gadget->dev);
1147
1148 /* register it - we're ready to go */
1149 err = snd_card_register(card);
1150 if (err < 0) {
1151 ERROR(dev, "snd_card_register failed\n");
1152 goto fail;
1153 }
1154
1155 VDBG(dev, "gmidi_register_card finished ok\n");
1156 return 0;
1157
1158fail:
1159 if (dev->card) {
1160 snd_card_free(dev->card);
1161 dev->card = NULL;
1162 }
1163 return err;
1164}
1165
1166/*
1167 * Creates an output endpoint, and initializes output ports.
1168 */
1169static int __devinit gmidi_bind(struct usb_gadget *gadget)
1170{
1171 struct gmidi_device *dev;
1172 struct usb_ep *in_ep, *out_ep;
1173 int gcnum, err = 0;
1174
1175 /* support optional vendor/distro customization */
1176 if (idVendor) {
1177 if (!idProduct) {
1178 printk(KERN_ERR "idVendor needs idProduct!\n");
1179 return -ENODEV;
1180 }
1181 device_desc.idVendor = cpu_to_le16(idVendor);
1182 device_desc.idProduct = cpu_to_le16(idProduct);
1183 if (bcdDevice) {
1184 device_desc.bcdDevice = cpu_to_le16(bcdDevice);
1185 }
1186 }
1187 if (iManufacturer) {
1188 strlcpy(manufacturer, iManufacturer, sizeof(manufacturer));
1189 } else {
1190 snprintf(manufacturer, sizeof(manufacturer), "%s %s with %s",
Serge E. Hallyn96b644b2006-10-02 02:18:13 -07001191 init_utsname()->sysname, init_utsname()->release,
Ben Williamsonf2ebf92c2006-08-01 11:28:16 +10001192 gadget->name);
1193 }
1194 if (iProduct) {
1195 strlcpy(product_desc, iProduct, sizeof(product_desc));
1196 }
1197 if (iSerialNumber) {
1198 device_desc.iSerialNumber = STRING_SERIAL,
1199 strlcpy(serial_number, iSerialNumber, sizeof(serial_number));
1200 }
1201
1202 /* Bulk-only drivers like this one SHOULD be able to
1203 * autoconfigure on any sane usb controller driver,
1204 * but there may also be important quirks to address.
1205 */
1206 usb_ep_autoconfig_reset(gadget);
1207 in_ep = usb_ep_autoconfig(gadget, &bulk_in_desc);
1208 if (!in_ep) {
1209autoconf_fail:
1210 printk(KERN_ERR "%s: can't autoconfigure on %s\n",
1211 shortname, gadget->name);
1212 return -ENODEV;
1213 }
1214 EP_IN_NAME = in_ep->name;
1215 in_ep->driver_data = in_ep; /* claim */
1216
1217 out_ep = usb_ep_autoconfig(gadget, &bulk_out_desc);
1218 if (!out_ep) {
1219 goto autoconf_fail;
1220 }
1221 EP_OUT_NAME = out_ep->name;
1222 out_ep->driver_data = out_ep; /* claim */
1223
1224 gcnum = usb_gadget_controller_number(gadget);
1225 if (gcnum >= 0) {
1226 device_desc.bcdDevice = cpu_to_le16(0x0200 + gcnum);
1227 } else {
1228 /* gmidi is so simple (no altsettings) that
1229 * it SHOULD NOT have problems with bulk-capable hardware.
1230 * so warn about unrecognized controllers, don't panic.
1231 */
1232 printk(KERN_WARNING "%s: controller '%s' not recognized\n",
1233 shortname, gadget->name);
1234 device_desc.bcdDevice = __constant_cpu_to_le16(0x9999);
1235 }
1236
1237
1238 /* ok, we made sense of the hardware ... */
Christoph Lametere94b1762006-12-06 20:33:17 -08001239 dev = kzalloc(sizeof(*dev), GFP_KERNEL);
Ben Williamsonf2ebf92c2006-08-01 11:28:16 +10001240 if (!dev) {
1241 return -ENOMEM;
1242 }
1243 spin_lock_init(&dev->lock);
1244 dev->gadget = gadget;
1245 dev->in_ep = in_ep;
1246 dev->out_ep = out_ep;
1247 set_gadget_data(gadget, dev);
1248 tasklet_init(&dev->tasklet, gmidi_in_tasklet, (unsigned long)dev);
1249
1250 /* preallocate control response and buffer */
1251 dev->req = usb_ep_alloc_request(gadget->ep0, GFP_KERNEL);
1252 if (!dev->req) {
1253 err = -ENOMEM;
1254 goto fail;
1255 }
1256 dev->req->buf = usb_ep_alloc_buffer(gadget->ep0, USB_BUFSIZ,
1257 &dev->req->dma, GFP_KERNEL);
1258 if (!dev->req->buf) {
1259 err = -ENOMEM;
1260 goto fail;
1261 }
1262
1263 dev->req->complete = gmidi_setup_complete;
1264
1265 device_desc.bMaxPacketSize0 = gadget->ep0->maxpacket;
1266
1267 gadget->ep0->driver_data = dev;
1268
1269 INFO(dev, "%s, version: " DRIVER_VERSION "\n", longname);
1270 INFO(dev, "using %s, OUT %s IN %s\n", gadget->name,
1271 EP_OUT_NAME, EP_IN_NAME);
1272
1273 /* register as an ALSA sound card */
1274 err = gmidi_register_card(dev);
1275 if (err < 0) {
1276 goto fail;
1277 }
1278
1279 VDBG(dev, "gmidi_bind finished ok\n");
1280 return 0;
1281
1282fail:
1283 gmidi_unbind(gadget);
1284 return err;
1285}
1286
1287
1288static void gmidi_suspend(struct usb_gadget *gadget)
1289{
1290 struct gmidi_device *dev = get_gadget_data(gadget);
1291
1292 if (gadget->speed == USB_SPEED_UNKNOWN) {
1293 return;
1294 }
1295
1296 DBG(dev, "suspend\n");
1297}
1298
1299static void gmidi_resume(struct usb_gadget *gadget)
1300{
1301 struct gmidi_device *dev = get_gadget_data(gadget);
1302
1303 DBG(dev, "resume\n");
1304}
1305
1306
1307static struct usb_gadget_driver gmidi_driver = {
1308 .speed = USB_SPEED_FULL,
1309 .function = (char *)longname,
1310 .bind = gmidi_bind,
1311 .unbind = __exit_p(gmidi_unbind),
1312
1313 .setup = gmidi_setup,
1314 .disconnect = gmidi_disconnect,
1315
1316 .suspend = gmidi_suspend,
1317 .resume = gmidi_resume,
1318
1319 .driver = {
1320 .name = (char *)shortname,
1321 .owner = THIS_MODULE,
1322 },
1323};
1324
1325static int __init gmidi_init(void)
1326{
1327 return usb_gadget_register_driver(&gmidi_driver);
1328}
1329module_init(gmidi_init);
1330
1331static void __exit gmidi_cleanup(void)
1332{
1333 usb_gadget_unregister_driver(&gmidi_driver);
1334}
1335module_exit(gmidi_cleanup);
1336