card.c 23 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879
  1. /*
  2. * (Tentative) USB Audio Driver for ALSA
  3. *
  4. * Copyright (c) 2002 by Takashi Iwai <tiwai@suse.de>
  5. *
  6. * Many codes borrowed from audio.c by
  7. * Alan Cox (alan@lxorguk.ukuu.org.uk)
  8. * Thomas Sailer (sailer@ife.ee.ethz.ch)
  9. *
  10. *
  11. * This program is free software; you can redistribute it and/or modify
  12. * it under the terms of the GNU General Public License as published by
  13. * the Free Software Foundation; either version 2 of the License, or
  14. * (at your option) any later version.
  15. *
  16. * This program is distributed in the hope that it will be useful,
  17. * but WITHOUT ANY WARRANTY; without even the implied warranty of
  18. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  19. * GNU General Public License for more details.
  20. *
  21. * You should have received a copy of the GNU General Public License
  22. * along with this program; if not, write to the Free Software
  23. * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
  24. *
  25. *
  26. * NOTES:
  27. *
  28. * - the linked URBs would be preferred but not used so far because of
  29. * the instability of unlinking.
  30. * - type II is not supported properly. there is no device which supports
  31. * this type *correctly*. SB extigy looks as if it supports, but it's
  32. * indeed an AC3 stream packed in SPDIF frames (i.e. no real AC3 stream).
  33. */
  34. #include <linux/bitops.h>
  35. #include <linux/init.h>
  36. #include <linux/list.h>
  37. #include <linux/slab.h>
  38. #include <linux/string.h>
  39. #include <linux/ctype.h>
  40. #include <linux/usb.h>
  41. #include <linux/moduleparam.h>
  42. #include <linux/mutex.h>
  43. #include <linux/usb/audio.h>
  44. #include <linux/usb/audio-v2.h>
  45. #include <linux/module.h>
  46. #include <sound/control.h>
  47. #include <sound/core.h>
  48. #include <sound/info.h>
  49. #include <sound/pcm.h>
  50. #include <sound/pcm_params.h>
  51. #include <sound/initval.h>
  52. #include "usbaudio.h"
  53. #include "card.h"
  54. #include "midi.h"
  55. #include "mixer.h"
  56. #include "proc.h"
  57. #include "quirks.h"
  58. #include "endpoint.h"
  59. #include "helper.h"
  60. #include "debug.h"
  61. #include "pcm.h"
  62. #include "format.h"
  63. #include "power.h"
  64. #include "stream.h"
  65. MODULE_AUTHOR("Takashi Iwai <tiwai@suse.de>");
  66. MODULE_DESCRIPTION("USB Audio");
  67. MODULE_LICENSE("GPL");
  68. MODULE_SUPPORTED_DEVICE("{{Generic,USB Audio}}");
  69. static int index[SNDRV_CARDS] = SNDRV_DEFAULT_IDX; /* Index 0-MAX */
  70. static char *id[SNDRV_CARDS] = SNDRV_DEFAULT_STR; /* ID for this card */
  71. static bool enable[SNDRV_CARDS] = SNDRV_DEFAULT_ENABLE_PNP;/* Enable this card */
  72. /* Vendor/product IDs for this card */
  73. static int vid[SNDRV_CARDS] = { [0 ... (SNDRV_CARDS-1)] = -1 };
  74. static int pid[SNDRV_CARDS] = { [0 ... (SNDRV_CARDS-1)] = -1 };
  75. static int device_setup[SNDRV_CARDS]; /* device parameter for this card */
  76. static bool ignore_ctl_error;
  77. static bool autoclock = true;
  78. static char *quirk_alias[SNDRV_CARDS];
  79. module_param_array(index, int, NULL, 0444);
  80. MODULE_PARM_DESC(index, "Index value for the USB audio adapter.");
  81. module_param_array(id, charp, NULL, 0444);
  82. MODULE_PARM_DESC(id, "ID string for the USB audio adapter.");
  83. module_param_array(enable, bool, NULL, 0444);
  84. MODULE_PARM_DESC(enable, "Enable USB audio adapter.");
  85. module_param_array(vid, int, NULL, 0444);
  86. MODULE_PARM_DESC(vid, "Vendor ID for the USB audio device.");
  87. module_param_array(pid, int, NULL, 0444);
  88. MODULE_PARM_DESC(pid, "Product ID for the USB audio device.");
  89. module_param_array(device_setup, int, NULL, 0444);
  90. MODULE_PARM_DESC(device_setup, "Specific device setup (if needed).");
  91. module_param(ignore_ctl_error, bool, 0444);
  92. MODULE_PARM_DESC(ignore_ctl_error,
  93. "Ignore errors from USB controller for mixer interfaces.");
  94. module_param(autoclock, bool, 0444);
  95. MODULE_PARM_DESC(autoclock, "Enable auto-clock selection for UAC2 devices (default: yes).");
  96. module_param_array(quirk_alias, charp, NULL, 0444);
  97. MODULE_PARM_DESC(quirk_alias, "Quirk aliases, e.g. 0123abcd:5678beef.");
  98. /*
  99. * we keep the snd_usb_audio_t instances by ourselves for merging
  100. * the all interfaces on the same card as one sound device.
  101. */
  102. static DEFINE_MUTEX(register_mutex);
  103. static struct snd_usb_audio *usb_chip[SNDRV_CARDS];
  104. static struct usb_driver usb_audio_driver;
  105. /*
  106. * disconnect streams
  107. * called from usb_audio_disconnect()
  108. */
  109. static void snd_usb_stream_disconnect(struct snd_usb_stream *as)
  110. {
  111. int idx;
  112. struct snd_usb_substream *subs;
  113. for (idx = 0; idx < 2; idx++) {
  114. subs = &as->substream[idx];
  115. if (!subs->num_formats)
  116. continue;
  117. subs->interface = -1;
  118. subs->data_endpoint = NULL;
  119. subs->sync_endpoint = NULL;
  120. }
  121. }
  122. static int snd_usb_create_stream(struct snd_usb_audio *chip, int ctrlif, int interface)
  123. {
  124. struct usb_device *dev = chip->dev;
  125. struct usb_host_interface *alts;
  126. struct usb_interface_descriptor *altsd;
  127. struct usb_interface *iface = usb_ifnum_to_if(dev, interface);
  128. if (!iface) {
  129. dev_err(&dev->dev, "%u:%d : does not exist\n",
  130. ctrlif, interface);
  131. return -EINVAL;
  132. }
  133. alts = &iface->altsetting[0];
  134. altsd = get_iface_desc(alts);
  135. /*
  136. * Android with both accessory and audio interfaces enabled gets the
  137. * interface numbers wrong.
  138. */
  139. if ((chip->usb_id == USB_ID(0x18d1, 0x2d04) ||
  140. chip->usb_id == USB_ID(0x18d1, 0x2d05)) &&
  141. interface == 0 &&
  142. altsd->bInterfaceClass == USB_CLASS_VENDOR_SPEC &&
  143. altsd->bInterfaceSubClass == USB_SUBCLASS_VENDOR_SPEC) {
  144. interface = 2;
  145. iface = usb_ifnum_to_if(dev, interface);
  146. if (!iface)
  147. return -EINVAL;
  148. alts = &iface->altsetting[0];
  149. altsd = get_iface_desc(alts);
  150. }
  151. if (usb_interface_claimed(iface)) {
  152. dev_dbg(&dev->dev, "%d:%d: skipping, already claimed\n",
  153. ctrlif, interface);
  154. return -EINVAL;
  155. }
  156. if ((altsd->bInterfaceClass == USB_CLASS_AUDIO ||
  157. altsd->bInterfaceClass == USB_CLASS_VENDOR_SPEC) &&
  158. altsd->bInterfaceSubClass == USB_SUBCLASS_MIDISTREAMING) {
  159. int err = __snd_usbmidi_create(chip->card, iface,
  160. &chip->midi_list, NULL,
  161. chip->usb_id);
  162. if (err < 0) {
  163. dev_err(&dev->dev,
  164. "%u:%d: cannot create sequencer device\n",
  165. ctrlif, interface);
  166. return -EINVAL;
  167. }
  168. return usb_driver_claim_interface(&usb_audio_driver, iface,
  169. USB_AUDIO_IFACE_UNUSED);
  170. }
  171. if ((altsd->bInterfaceClass != USB_CLASS_AUDIO &&
  172. altsd->bInterfaceClass != USB_CLASS_VENDOR_SPEC) ||
  173. altsd->bInterfaceSubClass != USB_SUBCLASS_AUDIOSTREAMING) {
  174. dev_dbg(&dev->dev,
  175. "%u:%d: skipping non-supported interface %d\n",
  176. ctrlif, interface, altsd->bInterfaceClass);
  177. /* skip non-supported classes */
  178. return -EINVAL;
  179. }
  180. if (snd_usb_get_speed(dev) == USB_SPEED_LOW) {
  181. dev_err(&dev->dev, "low speed audio streaming not supported\n");
  182. return -EINVAL;
  183. }
  184. if (! snd_usb_parse_audio_interface(chip, interface)) {
  185. usb_set_interface(dev, interface, 0); /* reset the current interface */
  186. return usb_driver_claim_interface(&usb_audio_driver, iface,
  187. USB_AUDIO_IFACE_UNUSED);
  188. }
  189. return 0;
  190. }
  191. /*
  192. * parse audio control descriptor and create pcm/midi streams
  193. */
  194. static int snd_usb_create_streams(struct snd_usb_audio *chip, int ctrlif)
  195. {
  196. struct usb_device *dev = chip->dev;
  197. struct usb_host_interface *host_iface;
  198. struct usb_interface_descriptor *altsd;
  199. void *control_header;
  200. int i, protocol;
  201. int rest_bytes;
  202. /* find audiocontrol interface */
  203. host_iface = &usb_ifnum_to_if(dev, ctrlif)->altsetting[0];
  204. control_header = snd_usb_find_csint_desc(host_iface->extra,
  205. host_iface->extralen,
  206. NULL, UAC_HEADER);
  207. altsd = get_iface_desc(host_iface);
  208. protocol = altsd->bInterfaceProtocol;
  209. if (!control_header) {
  210. dev_err(&dev->dev, "cannot find UAC_HEADER\n");
  211. return -EINVAL;
  212. }
  213. rest_bytes = (void *)(host_iface->extra + host_iface->extralen) -
  214. control_header;
  215. /* just to be sure -- this shouldn't hit at all */
  216. if (rest_bytes <= 0) {
  217. dev_err(&dev->dev, "invalid control header\n");
  218. return -EINVAL;
  219. }
  220. switch (protocol) {
  221. default:
  222. dev_warn(&dev->dev,
  223. "unknown interface protocol %#02x, assuming v1\n",
  224. protocol);
  225. /* fall through */
  226. case UAC_VERSION_1: {
  227. struct uac1_ac_header_descriptor *h1 = control_header;
  228. if (rest_bytes < sizeof(*h1)) {
  229. dev_err(&dev->dev, "too short v1 buffer descriptor\n");
  230. return -EINVAL;
  231. }
  232. if (!h1->bInCollection) {
  233. dev_info(&dev->dev, "skipping empty audio interface (v1)\n");
  234. return -EINVAL;
  235. }
  236. if (rest_bytes < h1->bLength) {
  237. dev_err(&dev->dev, "invalid buffer length (v1)\n");
  238. return -EINVAL;
  239. }
  240. if (h1->bLength < sizeof(*h1) + h1->bInCollection) {
  241. dev_err(&dev->dev, "invalid UAC_HEADER (v1)\n");
  242. return -EINVAL;
  243. }
  244. for (i = 0; i < h1->bInCollection; i++)
  245. snd_usb_create_stream(chip, ctrlif, h1->baInterfaceNr[i]);
  246. break;
  247. }
  248. case UAC_VERSION_2: {
  249. struct usb_interface_assoc_descriptor *assoc =
  250. usb_ifnum_to_if(dev, ctrlif)->intf_assoc;
  251. if (!assoc) {
  252. /*
  253. * Firmware writers cannot count to three. So to find
  254. * the IAD on the NuForce UDH-100, also check the next
  255. * interface.
  256. */
  257. struct usb_interface *iface =
  258. usb_ifnum_to_if(dev, ctrlif + 1);
  259. if (iface &&
  260. iface->intf_assoc &&
  261. iface->intf_assoc->bFunctionClass == USB_CLASS_AUDIO &&
  262. iface->intf_assoc->bFunctionProtocol == UAC_VERSION_2)
  263. assoc = iface->intf_assoc;
  264. }
  265. if (!assoc) {
  266. dev_err(&dev->dev, "Audio class v2 interfaces need an interface association\n");
  267. return -EINVAL;
  268. }
  269. for (i = 0; i < assoc->bInterfaceCount; i++) {
  270. int intf = assoc->bFirstInterface + i;
  271. if (intf != ctrlif)
  272. snd_usb_create_stream(chip, ctrlif, intf);
  273. }
  274. break;
  275. }
  276. }
  277. return 0;
  278. }
  279. /*
  280. * free the chip instance
  281. *
  282. * here we have to do not much, since pcm and controls are already freed
  283. *
  284. */
  285. static int snd_usb_audio_free(struct snd_usb_audio *chip)
  286. {
  287. struct snd_usb_endpoint *ep, *n;
  288. list_for_each_entry_safe(ep, n, &chip->ep_list, list)
  289. snd_usb_endpoint_free(ep);
  290. mutex_destroy(&chip->mutex);
  291. if (!atomic_read(&chip->shutdown))
  292. dev_set_drvdata(&chip->dev->dev, NULL);
  293. kfree(chip);
  294. return 0;
  295. }
  296. static int snd_usb_audio_dev_free(struct snd_device *device)
  297. {
  298. struct snd_usb_audio *chip = device->device_data;
  299. return snd_usb_audio_free(chip);
  300. }
  301. /*
  302. * create a chip instance and set its names.
  303. */
  304. static int snd_usb_audio_create(struct usb_interface *intf,
  305. struct usb_device *dev, int idx,
  306. const struct snd_usb_audio_quirk *quirk,
  307. unsigned int usb_id,
  308. struct snd_usb_audio **rchip)
  309. {
  310. struct snd_card *card;
  311. struct snd_usb_audio *chip;
  312. int err, len;
  313. char component[14];
  314. static struct snd_device_ops ops = {
  315. .dev_free = snd_usb_audio_dev_free,
  316. };
  317. *rchip = NULL;
  318. switch (snd_usb_get_speed(dev)) {
  319. case USB_SPEED_LOW:
  320. case USB_SPEED_FULL:
  321. case USB_SPEED_HIGH:
  322. case USB_SPEED_WIRELESS:
  323. case USB_SPEED_SUPER:
  324. case USB_SPEED_SUPER_PLUS:
  325. break;
  326. default:
  327. dev_err(&dev->dev, "unknown device speed %d\n", snd_usb_get_speed(dev));
  328. return -ENXIO;
  329. }
  330. err = snd_card_new(&intf->dev, index[idx], id[idx], THIS_MODULE,
  331. 0, &card);
  332. if (err < 0) {
  333. dev_err(&dev->dev, "cannot create card instance %d\n", idx);
  334. return err;
  335. }
  336. chip = kzalloc(sizeof(*chip), GFP_KERNEL);
  337. if (! chip) {
  338. snd_card_free(card);
  339. return -ENOMEM;
  340. }
  341. mutex_init(&chip->mutex);
  342. init_waitqueue_head(&chip->shutdown_wait);
  343. chip->index = idx;
  344. chip->dev = dev;
  345. chip->card = card;
  346. chip->setup = device_setup[idx];
  347. chip->autoclock = autoclock;
  348. atomic_set(&chip->active, 1); /* avoid autopm during probing */
  349. atomic_set(&chip->usage_count, 0);
  350. atomic_set(&chip->shutdown, 0);
  351. chip->usb_id = usb_id;
  352. INIT_LIST_HEAD(&chip->pcm_list);
  353. INIT_LIST_HEAD(&chip->ep_list);
  354. INIT_LIST_HEAD(&chip->midi_list);
  355. INIT_LIST_HEAD(&chip->mixer_list);
  356. if ((err = snd_device_new(card, SNDRV_DEV_LOWLEVEL, chip, &ops)) < 0) {
  357. snd_usb_audio_free(chip);
  358. snd_card_free(card);
  359. return err;
  360. }
  361. strcpy(card->driver, "USB-Audio");
  362. sprintf(component, "USB%04x:%04x",
  363. USB_ID_VENDOR(chip->usb_id), USB_ID_PRODUCT(chip->usb_id));
  364. snd_component_add(card, component);
  365. /* retrieve the device string as shortname */
  366. if (quirk && quirk->product_name && *quirk->product_name) {
  367. strlcpy(card->shortname, quirk->product_name, sizeof(card->shortname));
  368. } else {
  369. if (!dev->descriptor.iProduct ||
  370. usb_string(dev, dev->descriptor.iProduct,
  371. card->shortname, sizeof(card->shortname)) <= 0) {
  372. /* no name available from anywhere, so use ID */
  373. sprintf(card->shortname, "USB Device %#04x:%#04x",
  374. USB_ID_VENDOR(chip->usb_id),
  375. USB_ID_PRODUCT(chip->usb_id));
  376. }
  377. }
  378. strim(card->shortname);
  379. /* retrieve the vendor and device strings as longname */
  380. if (quirk && quirk->vendor_name && *quirk->vendor_name) {
  381. len = strlcpy(card->longname, quirk->vendor_name, sizeof(card->longname));
  382. } else {
  383. if (dev->descriptor.iManufacturer)
  384. len = usb_string(dev, dev->descriptor.iManufacturer,
  385. card->longname, sizeof(card->longname));
  386. else
  387. len = 0;
  388. /* we don't really care if there isn't any vendor string */
  389. }
  390. if (len > 0) {
  391. strim(card->longname);
  392. if (*card->longname)
  393. strlcat(card->longname, " ", sizeof(card->longname));
  394. }
  395. strlcat(card->longname, card->shortname, sizeof(card->longname));
  396. len = strlcat(card->longname, " at ", sizeof(card->longname));
  397. if (len < sizeof(card->longname))
  398. usb_make_path(dev, card->longname + len, sizeof(card->longname) - len);
  399. switch (snd_usb_get_speed(dev)) {
  400. case USB_SPEED_LOW:
  401. strlcat(card->longname, ", low speed", sizeof(card->longname));
  402. break;
  403. case USB_SPEED_FULL:
  404. strlcat(card->longname, ", full speed", sizeof(card->longname));
  405. break;
  406. case USB_SPEED_HIGH:
  407. strlcat(card->longname, ", high speed", sizeof(card->longname));
  408. break;
  409. case USB_SPEED_SUPER:
  410. strlcat(card->longname, ", super speed", sizeof(card->longname));
  411. break;
  412. case USB_SPEED_SUPER_PLUS:
  413. strlcat(card->longname, ", super speed plus", sizeof(card->longname));
  414. break;
  415. default:
  416. break;
  417. }
  418. snd_usb_audio_create_proc(chip);
  419. *rchip = chip;
  420. return 0;
  421. }
  422. /* look for a matching quirk alias id */
  423. static bool get_alias_id(struct usb_device *dev, unsigned int *id)
  424. {
  425. int i;
  426. unsigned int src, dst;
  427. for (i = 0; i < ARRAY_SIZE(quirk_alias); i++) {
  428. if (!quirk_alias[i] ||
  429. sscanf(quirk_alias[i], "%x:%x", &src, &dst) != 2 ||
  430. src != *id)
  431. continue;
  432. dev_info(&dev->dev,
  433. "device (%04x:%04x): applying quirk alias %04x:%04x\n",
  434. USB_ID_VENDOR(*id), USB_ID_PRODUCT(*id),
  435. USB_ID_VENDOR(dst), USB_ID_PRODUCT(dst));
  436. *id = dst;
  437. return true;
  438. }
  439. return false;
  440. }
  441. static const struct usb_device_id usb_audio_ids[]; /* defined below */
  442. /* look for the corresponding quirk */
  443. static const struct snd_usb_audio_quirk *
  444. get_alias_quirk(struct usb_device *dev, unsigned int id)
  445. {
  446. const struct usb_device_id *p;
  447. for (p = usb_audio_ids; p->match_flags; p++) {
  448. /* FIXME: this checks only vendor:product pair in the list */
  449. if ((p->match_flags & USB_DEVICE_ID_MATCH_DEVICE) ==
  450. USB_DEVICE_ID_MATCH_DEVICE &&
  451. p->idVendor == USB_ID_VENDOR(id) &&
  452. p->idProduct == USB_ID_PRODUCT(id))
  453. return (const struct snd_usb_audio_quirk *)p->driver_info;
  454. }
  455. return NULL;
  456. }
  457. /*
  458. * probe the active usb device
  459. *
  460. * note that this can be called multiple times per a device, when it
  461. * includes multiple audio control interfaces.
  462. *
  463. * thus we check the usb device pointer and creates the card instance
  464. * only at the first time. the successive calls of this function will
  465. * append the pcm interface to the corresponding card.
  466. */
  467. u32 id_usb;
  468. static int usb_audio_probe(struct usb_interface *intf,
  469. const struct usb_device_id *usb_id)
  470. {
  471. struct usb_device *dev = interface_to_usbdev(intf);
  472. const struct snd_usb_audio_quirk *quirk =
  473. (const struct snd_usb_audio_quirk *)usb_id->driver_info;
  474. struct snd_usb_audio *chip;
  475. int i, err;
  476. struct usb_host_interface *alts;
  477. int ifnum;
  478. u32 id;
  479. alts = &intf->altsetting[0];
  480. ifnum = get_iface_desc(alts)->bInterfaceNumber;
  481. id = USB_ID(le16_to_cpu(dev->descriptor.idVendor),
  482. le16_to_cpu(dev->descriptor.idProduct));
  483. id_usb = id;
  484. if (get_alias_id(dev, &id))
  485. quirk = get_alias_quirk(dev, id);
  486. if (quirk && quirk->ifnum >= 0 && ifnum != quirk->ifnum)
  487. return -ENXIO;
  488. err = snd_usb_apply_boot_quirk(dev, intf, quirk, id);
  489. if (err < 0)
  490. return err;
  491. /*
  492. * found a config. now register to ALSA
  493. */
  494. /* check whether it's already registered */
  495. chip = NULL;
  496. mutex_lock(&register_mutex);
  497. for (i = 0; i < SNDRV_CARDS; i++) {
  498. if (usb_chip[i] && usb_chip[i]->dev == dev) {
  499. if (atomic_read(&usb_chip[i]->shutdown)) {
  500. dev_err(&dev->dev, "USB device is in the shutdown state, cannot create a card instance\n");
  501. err = -EIO;
  502. goto __error;
  503. }
  504. chip = usb_chip[i];
  505. atomic_inc(&chip->active); /* avoid autopm */
  506. break;
  507. }
  508. }
  509. if (! chip) {
  510. /* it's a fresh one.
  511. * now look for an empty slot and create a new card instance
  512. */
  513. for (i = 0; i < SNDRV_CARDS; i++)
  514. if (enable[i] && ! usb_chip[i] &&
  515. (vid[i] == -1 || vid[i] == USB_ID_VENDOR(id)) &&
  516. (pid[i] == -1 || pid[i] == USB_ID_PRODUCT(id))) {
  517. err = snd_usb_audio_create(intf, dev, i, quirk,
  518. id, &chip);
  519. if (err < 0)
  520. goto __error;
  521. chip->pm_intf = intf;
  522. break;
  523. }
  524. if (!chip) {
  525. dev_err(&dev->dev, "no available usb audio device\n");
  526. err = -ENODEV;
  527. goto __error;
  528. }
  529. }
  530. dev_set_drvdata(&dev->dev, chip);
  531. /*
  532. * For devices with more than one control interface, we assume the
  533. * first contains the audio controls. We might need a more specific
  534. * check here in the future.
  535. */
  536. if (!chip->ctrl_intf)
  537. chip->ctrl_intf = alts;
  538. chip->txfr_quirk = 0;
  539. err = 1; /* continue */
  540. if (quirk && quirk->ifnum != QUIRK_NO_INTERFACE) {
  541. /* need some special handlings */
  542. err = snd_usb_create_quirk(chip, intf, &usb_audio_driver, quirk);
  543. if (err < 0)
  544. goto __error;
  545. }
  546. if (err > 0) {
  547. /* create normal USB audio interfaces */
  548. err = snd_usb_create_streams(chip, ifnum);
  549. if (err < 0)
  550. goto __error;
  551. err = snd_usb_create_mixer(chip, ifnum, ignore_ctl_error);
  552. if (err < 0)
  553. goto __error;
  554. }
  555. /* we are allowed to call snd_card_register() many times */
  556. err = snd_card_register(chip->card);
  557. if (err < 0)
  558. goto __error;
  559. usb_chip[chip->index] = chip;
  560. chip->num_interfaces++;
  561. usb_set_intfdata(intf, chip);
  562. /* enable auto suspend */
  563. usb_enable_autosuspend(dev);
  564. device_wakeup_enable(&dev->dev);
  565. atomic_dec(&chip->active);
  566. mutex_unlock(&register_mutex);
  567. return 0;
  568. __error:
  569. if (chip) {
  570. /* chip->active is inside the chip->card object,
  571. * decrement before memory is possibly returned.
  572. */
  573. atomic_dec(&chip->active);
  574. if (!chip->num_interfaces)
  575. snd_card_free(chip->card);
  576. }
  577. mutex_unlock(&register_mutex);
  578. return err;
  579. }
  580. /*
  581. * we need to take care of counter, since disconnection can be called also
  582. * many times as well as usb_audio_probe().
  583. */
  584. static void usb_audio_disconnect(struct usb_interface *intf)
  585. {
  586. struct snd_usb_audio *chip = usb_get_intfdata(intf);
  587. struct snd_card *card;
  588. struct list_head *p;
  589. if (chip == USB_AUDIO_IFACE_UNUSED)
  590. return;
  591. card = chip->card;
  592. id_usb = USB_ID(le16_to_cpu(0x0), le16_to_cpu(0x0));
  593. mutex_lock(&register_mutex);
  594. if (atomic_inc_return(&chip->shutdown) == 1) {
  595. struct snd_usb_stream *as;
  596. struct snd_usb_endpoint *ep;
  597. struct usb_mixer_interface *mixer;
  598. /* wait until all pending tasks done;
  599. * they are protected by snd_usb_lock_shutdown()
  600. */
  601. wait_event(chip->shutdown_wait,
  602. !atomic_read(&chip->usage_count));
  603. snd_card_disconnect(card);
  604. /* release the pcm resources */
  605. list_for_each_entry(as, &chip->pcm_list, list) {
  606. snd_usb_stream_disconnect(as);
  607. }
  608. /* release the endpoint resources */
  609. list_for_each_entry(ep, &chip->ep_list, list) {
  610. snd_usb_endpoint_release(ep);
  611. }
  612. /* release the midi resources */
  613. list_for_each(p, &chip->midi_list) {
  614. snd_usbmidi_disconnect(p);
  615. }
  616. /* release mixer resources */
  617. list_for_each_entry(mixer, &chip->mixer_list, list) {
  618. snd_usb_mixer_disconnect(mixer);
  619. }
  620. }
  621. chip->num_interfaces--;
  622. if (chip->num_interfaces <= 0) {
  623. usb_chip[chip->index] = NULL;
  624. mutex_unlock(&register_mutex);
  625. snd_card_free_when_closed(card);
  626. } else {
  627. mutex_unlock(&register_mutex);
  628. }
  629. }
  630. /* lock the shutdown (disconnect) task and autoresume */
  631. int snd_usb_lock_shutdown(struct snd_usb_audio *chip)
  632. {
  633. int err;
  634. atomic_inc(&chip->usage_count);
  635. if (atomic_read(&chip->shutdown)) {
  636. err = -EIO;
  637. goto error;
  638. }
  639. err = snd_usb_autoresume(chip);
  640. if (err < 0)
  641. goto error;
  642. return 0;
  643. error:
  644. if (atomic_dec_and_test(&chip->usage_count))
  645. wake_up(&chip->shutdown_wait);
  646. return err;
  647. }
  648. /* autosuspend and unlock the shutdown */
  649. void snd_usb_unlock_shutdown(struct snd_usb_audio *chip)
  650. {
  651. snd_usb_autosuspend(chip);
  652. if (atomic_dec_and_test(&chip->usage_count))
  653. wake_up(&chip->shutdown_wait);
  654. }
  655. #ifdef CONFIG_PM
  656. int snd_usb_autoresume(struct snd_usb_audio *chip)
  657. {
  658. if (atomic_read(&chip->shutdown))
  659. return -EIO;
  660. if (atomic_inc_return(&chip->active) == 1)
  661. return usb_autopm_get_interface(chip->pm_intf);
  662. return 0;
  663. }
  664. void snd_usb_autosuspend(struct snd_usb_audio *chip)
  665. {
  666. if (atomic_read(&chip->shutdown))
  667. return;
  668. if (atomic_dec_and_test(&chip->active))
  669. usb_autopm_put_interface(chip->pm_intf);
  670. }
  671. static int usb_audio_suspend(struct usb_interface *intf, pm_message_t message)
  672. {
  673. struct snd_usb_audio *chip = usb_get_intfdata(intf);
  674. struct snd_usb_stream *as;
  675. struct usb_mixer_interface *mixer;
  676. struct list_head *p;
  677. if (chip == USB_AUDIO_IFACE_UNUSED)
  678. return 0;
  679. if (!chip->num_suspended_intf++) {
  680. list_for_each_entry(as, &chip->pcm_list, list) {
  681. snd_pcm_suspend_all(as->pcm);
  682. as->substream[0].need_setup_ep =
  683. as->substream[1].need_setup_ep = true;
  684. }
  685. list_for_each(p, &chip->midi_list)
  686. snd_usbmidi_suspend(p);
  687. list_for_each_entry(mixer, &chip->mixer_list, list)
  688. snd_usb_mixer_suspend(mixer);
  689. }
  690. if (!PMSG_IS_AUTO(message) && !chip->system_suspend) {
  691. snd_power_change_state(chip->card, SNDRV_CTL_POWER_D3hot);
  692. chip->system_suspend = chip->num_suspended_intf;
  693. }
  694. return 0;
  695. }
  696. static int __usb_audio_resume(struct usb_interface *intf, bool reset_resume)
  697. {
  698. struct snd_usb_audio *chip = usb_get_intfdata(intf);
  699. struct usb_mixer_interface *mixer;
  700. struct list_head *p;
  701. int err = 0;
  702. if (chip == USB_AUDIO_IFACE_UNUSED)
  703. return 0;
  704. atomic_inc(&chip->active); /* avoid autopm */
  705. if (chip->num_suspended_intf > 1)
  706. goto out;
  707. /*
  708. * ALSA leaves material resumption to user space
  709. * we just notify and restart the mixers
  710. */
  711. list_for_each_entry(mixer, &chip->mixer_list, list) {
  712. err = snd_usb_mixer_resume(mixer, reset_resume);
  713. if (err < 0)
  714. goto err_out;
  715. }
  716. list_for_each(p, &chip->midi_list) {
  717. snd_usbmidi_resume(p);
  718. }
  719. out:
  720. if (chip->num_suspended_intf == chip->system_suspend) {
  721. snd_power_change_state(chip->card, SNDRV_CTL_POWER_D0);
  722. chip->system_suspend = 0;
  723. }
  724. chip->num_suspended_intf--;
  725. err_out:
  726. atomic_dec(&chip->active); /* allow autopm after this point */
  727. return err;
  728. }
  729. static int usb_audio_resume(struct usb_interface *intf)
  730. {
  731. return __usb_audio_resume(intf, false);
  732. }
  733. static int usb_audio_reset_resume(struct usb_interface *intf)
  734. {
  735. return __usb_audio_resume(intf, true);
  736. }
  737. #else
  738. #define usb_audio_suspend NULL
  739. #define usb_audio_resume NULL
  740. #define usb_audio_reset_resume NULL
  741. #endif /* CONFIG_PM */
  742. static const struct usb_device_id usb_audio_ids [] = {
  743. #include "quirks-table.h"
  744. { .match_flags = (USB_DEVICE_ID_MATCH_INT_CLASS | USB_DEVICE_ID_MATCH_INT_SUBCLASS),
  745. .bInterfaceClass = USB_CLASS_AUDIO,
  746. .bInterfaceSubClass = USB_SUBCLASS_AUDIOCONTROL },
  747. { } /* Terminating entry */
  748. };
  749. MODULE_DEVICE_TABLE(usb, usb_audio_ids);
  750. /*
  751. * entry point for linux usb interface
  752. */
  753. static struct usb_driver usb_audio_driver = {
  754. .name = "snd-usb-audio",
  755. .probe = usb_audio_probe,
  756. .disconnect = usb_audio_disconnect,
  757. .suspend = usb_audio_suspend,
  758. .resume = usb_audio_resume,
  759. .reset_resume = usb_audio_reset_resume,
  760. .id_table = usb_audio_ids,
  761. .supports_autosuspend = 1,
  762. };
  763. module_usb_driver(usb_audio_driver);