gmidi.c 5.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192
  1. /*
  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. /* #define VERBOSE_DEBUG */
  21. #include <linux/kernel.h>
  22. #include <linux/slab.h>
  23. #include <linux/utsname.h>
  24. #include <linux/module.h>
  25. #include <linux/device.h>
  26. #include <sound/core.h>
  27. #include <sound/initval.h>
  28. #include <sound/rawmidi.h>
  29. #include <linux/usb/ch9.h>
  30. #include <linux/usb/gadget.h>
  31. #include <linux/usb/audio.h>
  32. #include <linux/usb/midi.h>
  33. #include "gadget_chips.h"
  34. #include "composite.c"
  35. #include "f_midi.c"
  36. /*-------------------------------------------------------------------------*/
  37. MODULE_AUTHOR("Ben Williamson");
  38. MODULE_LICENSE("GPL v2");
  39. static const char shortname[] = "g_midi";
  40. static const char longname[] = "MIDI Gadget";
  41. USB_GADGET_COMPOSITE_OPTIONS();
  42. static int index = SNDRV_DEFAULT_IDX1;
  43. module_param(index, int, S_IRUGO);
  44. MODULE_PARM_DESC(index, "Index value for the USB MIDI Gadget adapter.");
  45. static char *id = SNDRV_DEFAULT_STR1;
  46. module_param(id, charp, S_IRUGO);
  47. MODULE_PARM_DESC(id, "ID string for the USB MIDI Gadget adapter.");
  48. static unsigned int buflen = 256;
  49. module_param(buflen, uint, S_IRUGO);
  50. MODULE_PARM_DESC(buflen, "MIDI buffer length");
  51. static unsigned int qlen = 32;
  52. module_param(qlen, uint, S_IRUGO);
  53. MODULE_PARM_DESC(qlen, "USB read request queue length");
  54. static unsigned int in_ports = 1;
  55. module_param(in_ports, uint, S_IRUGO);
  56. MODULE_PARM_DESC(in_ports, "Number of MIDI input ports");
  57. static unsigned int out_ports = 1;
  58. module_param(out_ports, uint, S_IRUGO);
  59. MODULE_PARM_DESC(out_ports, "Number of MIDI output ports");
  60. /* Thanks to Grey Innovation for donating this product ID.
  61. *
  62. * DO NOT REUSE THESE IDs with a protocol-incompatible driver!! Ever!!
  63. * Instead: allocate your own, using normal USB-IF procedures.
  64. */
  65. #define DRIVER_VENDOR_NUM 0x17b3 /* Grey Innovation */
  66. #define DRIVER_PRODUCT_NUM 0x0004 /* Linux-USB "MIDI Gadget" */
  67. /* string IDs are assigned dynamically */
  68. #define STRING_DESCRIPTION_IDX USB_GADGET_FIRST_AVAIL_IDX
  69. static struct usb_device_descriptor device_desc = {
  70. .bLength = USB_DT_DEVICE_SIZE,
  71. .bDescriptorType = USB_DT_DEVICE,
  72. .bcdUSB = __constant_cpu_to_le16(0x0200),
  73. .bDeviceClass = USB_CLASS_PER_INTERFACE,
  74. .idVendor = __constant_cpu_to_le16(DRIVER_VENDOR_NUM),
  75. .idProduct = __constant_cpu_to_le16(DRIVER_PRODUCT_NUM),
  76. /* .iManufacturer = DYNAMIC */
  77. /* .iProduct = DYNAMIC */
  78. .bNumConfigurations = 1,
  79. };
  80. static struct usb_string strings_dev[] = {
  81. [USB_GADGET_MANUFACTURER_IDX].s = "Grey Innovation",
  82. [USB_GADGET_PRODUCT_IDX].s = "MIDI Gadget",
  83. [USB_GADGET_SERIAL_IDX].s = "",
  84. [STRING_DESCRIPTION_IDX].s = "MIDI",
  85. { } /* end of list */
  86. };
  87. static struct usb_gadget_strings stringtab_dev = {
  88. .language = 0x0409, /* en-us */
  89. .strings = strings_dev,
  90. };
  91. static struct usb_gadget_strings *dev_strings[] = {
  92. &stringtab_dev,
  93. NULL,
  94. };
  95. static int __exit midi_unbind(struct usb_composite_dev *dev)
  96. {
  97. return 0;
  98. }
  99. static struct usb_configuration midi_config = {
  100. .label = "MIDI Gadget",
  101. .bConfigurationValue = 1,
  102. /* .iConfiguration = DYNAMIC */
  103. .bmAttributes = USB_CONFIG_ATT_ONE,
  104. .bMaxPower = CONFIG_USB_GADGET_VBUS_DRAW / 2,
  105. };
  106. static int __init midi_bind_config(struct usb_configuration *c)
  107. {
  108. return f_midi_bind_config(c, index, id,
  109. in_ports, out_ports,
  110. buflen, qlen);
  111. }
  112. static int __init midi_bind(struct usb_composite_dev *cdev)
  113. {
  114. struct usb_gadget *gadget = cdev->gadget;
  115. int gcnum, status;
  116. status = usb_string_ids_tab(cdev, strings_dev);
  117. if (status < 0)
  118. return status;
  119. device_desc.iManufacturer = strings_dev[USB_GADGET_MANUFACTURER_IDX].id;
  120. device_desc.iProduct = strings_dev[USB_GADGET_PRODUCT_IDX].id;
  121. midi_config.iConfiguration = strings_dev[STRING_DESCRIPTION_IDX].id;
  122. gcnum = usb_gadget_controller_number(gadget);
  123. if (gcnum < 0) {
  124. /* gmidi is so simple (no altsettings) that
  125. * it SHOULD NOT have problems with bulk-capable hardware.
  126. * so warn about unrecognized controllers, don't panic.
  127. */
  128. pr_warning("%s: controller '%s' not recognized\n",
  129. __func__, gadget->name);
  130. device_desc.bcdDevice = cpu_to_le16(0x9999);
  131. } else {
  132. device_desc.bcdDevice = cpu_to_le16(0x0200 + gcnum);
  133. }
  134. status = usb_add_config(cdev, &midi_config, midi_bind_config);
  135. if (status < 0)
  136. return status;
  137. usb_composite_overwrite_options(cdev, &coverwrite);
  138. pr_info("%s\n", longname);
  139. return 0;
  140. }
  141. static __refdata struct usb_composite_driver midi_driver = {
  142. .name = (char *) longname,
  143. .dev = &device_desc,
  144. .strings = dev_strings,
  145. .max_speed = USB_SPEED_HIGH,
  146. .bind = midi_bind,
  147. .unbind = __exit_p(midi_unbind),
  148. };
  149. static int __init midi_init(void)
  150. {
  151. return usb_composite_probe(&midi_driver);
  152. }
  153. module_init(midi_init);
  154. static void __exit midi_cleanup(void)
  155. {
  156. usb_composite_unregister(&midi_driver);
  157. }
  158. module_exit(midi_cleanup);