sound/usb/usx2y/usbusx2y.c

   1 /*
   2  * usbusy2y.c - ALSA USB US-428 Driver
   3  *
   4 2005-04-14 Karsten Wiese
   5         Version 0.8.7.2:
   6         Call snd_card_free() instead of snd_card_free_in_thread() to prevent oops with dead keyboard symptom.
   7         Tested ok with kernel 2.6.12-rc2.
   8
   9 2004-12-14 Karsten Wiese
  10         Version 0.8.7.1:
  11         snd_pcm_open for rawusb pcm-devices now returns -EBUSY if called without rawusb's hwdep device being open.
  12
  13 2004-12-02 Karsten Wiese
  14         Version 0.8.7:
  15         Use macro usb_maxpacket() for portability.
  16
  17 2004-10-26 Karsten Wiese
  18         Version 0.8.6:
  19         wake_up() process waiting in usX2Y_urbs_start() on error.
  20
  21 2004-10-21 Karsten Wiese
  22         Version 0.8.5:
  23         nrpacks is runtime or compiletime configurable now with tested values from 1 to 4.
  24
  25 2004-10-03 Karsten Wiese
  26         Version 0.8.2:
  27         Avoid any possible racing while in prepare callback.
  28
  29 2004-09-30 Karsten Wiese
  30         Version 0.8.0:
  31         Simplified things and made ohci work again.
  32
  33 2004-09-20 Karsten Wiese
  34         Version 0.7.3:
  35         Use usb_kill_urb() instead of deprecated (kernel 2.6.9) usb_unlink_urb().
  36
  37 2004-07-13 Karsten Wiese
  38         Version 0.7.1:
  39         Don't sleep in START/STOP callbacks anymore.
  40         us428 channels C/D not handled just for this version, sorry.
  41
  42 2004-06-21 Karsten Wiese
  43         Version 0.6.4:
  44         Temporarely suspend midi input
  45         to sanely call usb_set_interface() when setting format.
  46
  47 2004-06-12 Karsten Wiese
  48         Version 0.6.3:
  49         Made it thus the following rule is enforced:
  50         "All pcm substreams of one usX2Y have to operate at the same rate & format."
  51
  52 2004-04-06 Karsten Wiese
  53         Version 0.6.0:
  54         Runs on 2.6.5 kernel without any "--with-debug=" things.
  55         us224 reported running.
  56
  57 2004-01-14 Karsten Wiese
  58         Version 0.5.1:
  59         Runs with 2.6.1 kernel.
  60
  61 2003-12-30 Karsten Wiese
  62         Version 0.4.1:
  63         Fix 24Bit 4Channel capturing for the us428.
  64
  65 2003-11-27 Karsten Wiese, Martin Langer
  66         Version 0.4:
  67         us122 support.
  68         us224 could be tested by uncommenting the sections containing USB_ID_US224
  69
  70 2003-11-03 Karsten Wiese
  71         Version 0.3:
  72         24Bit support.
  73         "arecord -D hw:1 -c 2 -r 48000 -M -f S24_3LE|aplay -D hw:1 -c 2 -r 48000 -M -f S24_3LE" works.
  74
  75 2003-08-22 Karsten Wiese
  76         Version 0.0.8:
  77         Removed EZUSB Firmware. First Stage Firmwaredownload is now done by tascam-firmware downloader.
  78         See:
  79         http://usb-midi-fw.sourceforge.net/tascam-firmware.tar.gz
  80
  81 2003-06-18 Karsten Wiese
  82         Version 0.0.5:
  83         changed to compile with kernel 2.4.21 and alsa 0.9.4
  84
  85 2002-10-16 Karsten Wiese
  86         Version 0.0.4:
  87         compiles again with alsa-current.
  88         USB_ISO_ASAP not used anymore (most of the time), instead
  89         urb->start_frame is calculated here now, some calls inside usb-driver don't need to happen anymore.
  90
  91         To get the best out of this:
  92         Disable APM-support in the kernel as APM-BIOS calls (once each second) hard disable interrupt for many precious milliseconds.
  93         This helped me much on my slowish PII 400 & PIII 500.
  94         ACPI yet untested but might cause the same bad behaviour.
  95         Use a kernel with lowlatency and preemptiv patches applied.
  96         To autoload snd-usb-midi append a line
  97                 post-install snd-usb-us428 modprobe snd-usb-midi
  98         to /etc/modules.conf.
  99
 100         known problems:
 101         sliders, knobs, lights not yet handled except MASTER Volume slider.
 102         "pcm -c 2" doesn't work. "pcm -c 2 -m direct_interleaved" does.
 103         KDE3: "Enable full duplex operation" deadlocks.
 104
 105
 106 2002-08-31 Karsten Wiese
 107         Version 0.0.3: audio also simplex;
 108         simplifying: iso urbs only 1 packet, melted structs.
 109         ASYNC_UNLINK not used anymore: no more crashes so far.....
 110         for alsa 0.9 rc3.
 111
 112 2002-08-09 Karsten Wiese
 113         Version 0.0.2: midi works with snd-usb-midi, audio (only fullduplex now) with i.e. bristol.
 114         The firmware has been sniffed from win2k us-428 driver 3.09.
 115
 116  *   Copyright (c) 2002 - 2004 Karsten Wiese
 117  *
 118  *   This program is free software; you can redistribute it and/or modify
 119  *   it under the terms of the GNU General Public License as published by
 120  *   the Free Software Foundation; either version 2 of the License, or
 121  *   (at your option) any later version.
 122  *
 123  *   This program is distributed in the hope that it will be useful,
 124  *   but WITHOUT ANY WARRANTY; without even the implied warranty of
 125  *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 126  *   GNU General Public License for more details.
 127  *
 128  *   You should have received a copy of the GNU General Public License
 129  *   along with this program; if not, write to the Free Software
 130  *   Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA
 131 */
 132
 133 #include <sound/driver.h>
 134 #include <linux/init.h>
 135 #include <linux/module.h>
 136 #include <linux/moduleparam.h>
 137 #include <linux/interrupt.h>
 138 #include <linux/usb.h>
 139 #include <sound/core.h>
 140 #include <sound/initval.h>
 141 #include <sound/pcm.h>
 142
 143 #include <sound/rawmidi.h>
 144 #include "usx2y.h"
 145 #include "usbusx2y.h"
 146 #include "usX2Yhwdep.h"
 147
 148
 149
 150 MODULE_AUTHOR("Karsten Wiese <annabellesgarden@yahoo.de>");
 151 MODULE_DESCRIPTION("TASCAM "NAME_ALLCAPS" Version 0.8.7.2");
 152 MODULE_LICENSE("GPL");
 153 MODULE_SUPPORTED_DEVICE("{{TASCAM(0x1604), "NAME_ALLCAPS"(0x8001)(0x8005)(0x8007) }}");
 154
 155 static int index[SNDRV_CARDS] = SNDRV_DEFAULT_IDX; /* Index 0-max */
 156 static char* id[SNDRV_CARDS] = SNDRV_DEFAULT_STR; /* Id for this card */
 157 static int enable[SNDRV_CARDS] = SNDRV_DEFAULT_ENABLE_PNP; /* Enable this card */
 158
 159 module_param_array(index, int, NULL, 0444);
 160 MODULE_PARM_DESC(index, "Index value for "NAME_ALLCAPS".");
 161 module_param_array(id, charp, NULL, 0444);
 162 MODULE_PARM_DESC(id, "ID string for "NAME_ALLCAPS".");
 163 module_param_array(enable, bool, NULL, 0444);
 164 MODULE_PARM_DESC(enable, "Enable "NAME_ALLCAPS".");
 165
 166
 167 static int snd_usX2Y_card_used[SNDRV_CARDS];
 168
 169 static void usX2Y_usb_disconnect(struct usb_device* usb_device, void* ptr);
 170 static void snd_usX2Y_card_private_free(snd_card_t *card);
 171
 172 /*
 173  * pipe 4 is used for switching the lamps, setting samplerate, volumes ....
 174  */
 175 static void i_usX2Y_Out04Int(struct urb* urb, struct pt_regs *regs)
 176 {
 177 #ifdef CONFIG_SND_DEBUG
 178         if (urb->status) {
 179                 int             i;
 180                 usX2Ydev_t*     usX2Y = urb->context;
 181                 for (i = 0; i < 10 && usX2Y->AS04.urb[i] != urb; i++);
 182                 snd_printdd("i_usX2Y_Out04Int() urb %i status=%i\n", i, urb->status);
 183         }
 184 #endif
 185 }
 186
 187 static void i_usX2Y_In04Int(struct urb* urb, struct pt_regs *regs)
 188 {
 189         int                     err = 0;
 190         usX2Ydev_t              *usX2Y = urb->context;
 191         us428ctls_sharedmem_t   *us428ctls = usX2Y->us428ctls_sharedmem;
 192
 193         usX2Y->In04IntCalls++;
 194
 195         if (urb->status) {
 196                 snd_printdd("Interrupt Pipe 4 came back with status=%i\n", urb->status);
 197                 return;
 198         }
 199
 200         //      printk("%i:0x%02X ", 8, (int)((unsigned char*)usX2Y->In04Buf)[8]); Master volume shows 0 here if fader is at max during boot ?!?
 201         if (us428ctls) {
 202                 int diff = -1;
 203                 if (-2 == us428ctls->CtlSnapShotLast) {
 204                         diff = 0;
 205                         memcpy(usX2Y->In04Last, usX2Y->In04Buf, sizeof(usX2Y->In04Last));
 206                         us428ctls->CtlSnapShotLast = -1;
 207                 } else {
 208                         int i;
 209                         for (i = 0; i < 21; i++) {
 210                                 if (usX2Y->In04Last[i] != ((char*)usX2Y->In04Buf)[i]) {
 211                                         if (diff < 0)
 212                                                 diff = i;
 213                                         usX2Y->In04Last[i] = ((char*)usX2Y->In04Buf)[i];
 214                                 }
 215                         }
 216                 }
 217                 if (0 <= diff) {
 218                         int n = us428ctls->CtlSnapShotLast + 1;
 219                         if (n >= N_us428_ctl_BUFS  ||  n < 0)
 220                                 n = 0;
 221                         memcpy(us428ctls->CtlSnapShot + n, usX2Y->In04Buf, sizeof(us428ctls->CtlSnapShot[0]));
 222                         us428ctls->CtlSnapShotDiffersAt[n] = diff;
 223                         us428ctls->CtlSnapShotLast = n;
 224                         wake_up(&usX2Y->us428ctls_wait_queue_head);
 225                 }
 226         }
 227
 228
 229         if (usX2Y->US04) {
 230                 if (0 == usX2Y->US04->submitted)
 231                         do
 232                                 err = usb_submit_urb(usX2Y->US04->urb[usX2Y->US04->submitted++], GFP_ATOMIC);
 233                         while (!err && usX2Y->US04->submitted < usX2Y->US04->len);
 234         } else
 235                 if (us428ctls && us428ctls->p4outLast >= 0 && us428ctls->p4outLast < N_us428_p4out_BUFS) {
 236                         if (us428ctls->p4outLast != us428ctls->p4outSent) {
 237                                 int j, send = us428ctls->p4outSent + 1;
 238                                 if (send >= N_us428_p4out_BUFS)
 239                                         send = 0;
 240                                 for (j = 0; j < URBS_AsyncSeq  &&  !err; ++j)
 241                                         if (0 == usX2Y->AS04.urb[j]->status) {
 242                                                 us428_p4out_t *p4out = us428ctls->p4out + send; // FIXME if more then 1 p4out is new, 1 gets lost.
 243                                                 usb_fill_bulk_urb(usX2Y->AS04.urb[j], usX2Y->chip.dev,
 244                                                                   usb_sndbulkpipe(usX2Y->chip.dev, 0x04), &p4out->val.vol,
 245                                                                   p4out->type == eLT_Light ? sizeof(us428_lights_t) : 5,
 246                                                                   i_usX2Y_Out04Int, usX2Y);
 247                                                 err = usb_submit_urb(usX2Y->AS04.urb[j], GFP_ATOMIC);
 248                                                 us428ctls->p4outSent = send;
 249                                                 break;
 250                                         }
 251                         }
 252                 }
 253
 254         if (err) {
 255                 snd_printk("In04Int() usb_submit_urb err=%i\n", err);
 256         }
 257
 258         urb->dev = usX2Y->chip.dev;
 259         usb_submit_urb(urb, GFP_ATOMIC);
 260 }
 261
 262 /*
 263  * Prepare some urbs
 264  */
 265 int usX2Y_AsyncSeq04_init(usX2Ydev_t* usX2Y)
 266 {
 267         int     err = 0,
 268                 i;
 269
 270         if (NULL == (usX2Y->AS04.buffer = kmalloc(URB_DataLen_AsyncSeq*URBS_AsyncSeq, GFP_KERNEL))) {
 271                 err = -ENOMEM;
 272         } else
 273                 for (i = 0; i < URBS_AsyncSeq; ++i) {
 274                         if (NULL == (usX2Y->AS04.urb[i] = usb_alloc_urb(0, GFP_KERNEL))) {
 275                                 err = -ENOMEM;
 276                                 break;
 277                         }
 278                         usb_fill_bulk_urb(      usX2Y->AS04.urb[i], usX2Y->chip.dev,
 279                                                 usb_sndbulkpipe(usX2Y->chip.dev, 0x04),
 280                                                 usX2Y->AS04.buffer + URB_DataLen_AsyncSeq*i, 0,
 281                                                 i_usX2Y_Out04Int, usX2Y
 282                                 );
 283                 }
 284         return err;
 285 }
 286
 287 int usX2Y_In04_init(usX2Ydev_t* usX2Y)
 288 {
 289         int     err = 0;
 290         if (! (usX2Y->In04urb = usb_alloc_urb(0, GFP_KERNEL)))
 291                 return -ENOMEM;
 292
 293         if (! (usX2Y->In04Buf = kmalloc(21, GFP_KERNEL))) {
 294                 usb_free_urb(usX2Y->In04urb);
 295                 return -ENOMEM;
 296         }
 297
 298         init_waitqueue_head(&usX2Y->In04WaitQueue);
 299         usb_fill_int_urb(usX2Y->In04urb, usX2Y->chip.dev, usb_rcvintpipe(usX2Y->chip.dev, 0x4),
 300                          usX2Y->In04Buf, 21,
 301                          i_usX2Y_In04Int, usX2Y,
 302                          10);
 303         err = usb_submit_urb(usX2Y->In04urb, GFP_KERNEL);
 304         return err;
 305 }
 306
 307 static void usX2Y_unlinkSeq(snd_usX2Y_AsyncSeq_t* S)
 308 {
 309         int     i;
 310         for (i = 0; i < URBS_AsyncSeq; ++i) {
 311                 if (S[i].urb) {
 312                         usb_kill_urb(S->urb[i]);
 313                         usb_free_urb(S->urb[i]);
 314                         S->urb[i] = NULL;
 315                 }
 316         }
 317         kfree(S->buffer);
 318 }
 319
 320
 321 static struct usb_device_id snd_usX2Y_usb_id_table[] = {
 322         {
 323                 .match_flags =  USB_DEVICE_ID_MATCH_DEVICE,
 324                 .idVendor =     0x1604,
 325                 .idProduct =    USB_ID_US428
 326         },
 327         {
 328                 .match_flags =  USB_DEVICE_ID_MATCH_DEVICE,
 329                 .idVendor =     0x1604,
 330                 .idProduct =    USB_ID_US122
 331         },
 332         {
 333                 .match_flags =  USB_DEVICE_ID_MATCH_DEVICE,
 334                 .idVendor =     0x1604,
 335                 .idProduct =    USB_ID_US224
 336         },
 337         { /* terminator */ }
 338 };
 339
 340 static snd_card_t* usX2Y_create_card(struct usb_device* device)
 341 {
 342         int             dev;
 343         snd_card_t*     card;
 344         for (dev = 0; dev < SNDRV_CARDS; ++dev)
 345                 if (enable[dev] && !snd_usX2Y_card_used[dev])
 346                         break;
 347         if (dev >= SNDRV_CARDS)
 348                 return NULL;
 349         card = snd_card_new(index[dev], id[dev], THIS_MODULE, sizeof(usX2Ydev_t));
 350         if (!card)
 351                 return NULL;
 352         snd_usX2Y_card_used[usX2Y(card)->chip.index = dev] = 1;
 353         card->private_free = snd_usX2Y_card_private_free;
 354         usX2Y(card)->chip.dev = device;
 355         usX2Y(card)->chip.card = card;
 356         init_waitqueue_head(&usX2Y(card)->prepare_wait_queue);
 357         init_MUTEX (&usX2Y(card)->prepare_mutex);
 358         INIT_LIST_HEAD(&usX2Y(card)->chip.midi_list);
 359         strcpy(card->driver, "USB "NAME_ALLCAPS"");
 360         sprintf(card->shortname, "TASCAM "NAME_ALLCAPS"");
 361         sprintf(card->longname, "%s (%x:%x if %d at %03d/%03d)",
 362                 card->shortname,
 363                 le16_to_cpu(device->descriptor.idVendor),
 364                 le16_to_cpu(device->descriptor.idProduct),
 365                 0,//us428(card)->usbmidi.ifnum,
 366                 usX2Y(card)->chip.dev->bus->busnum, usX2Y(card)->chip.dev->devnum
 367                 );
 368         snd_card_set_dev(card, &device->dev);
 369         return card;
 370 }
 371
 372
 373 static void* usX2Y_usb_probe(struct usb_device* device, struct usb_interface *intf, const struct usb_device_id* device_id)
 374 {
 375         int             err;
 376         snd_card_t*     card;
 377         if (le16_to_cpu(device->descriptor.idVendor) != 0x1604 ||
 378             (le16_to_cpu(device->descriptor.idProduct) != USB_ID_US122 &&
 379              le16_to_cpu(device->descriptor.idProduct) != USB_ID_US224 &&
 380              le16_to_cpu(device->descriptor.idProduct) != USB_ID_US428) ||
 381             !(card = usX2Y_create_card(device)))
 382                 return NULL;
 383         if ((err = usX2Y_hwdep_new(card, device)) < 0  ||
 384             (err = snd_card_register(card)) < 0) {
 385                 snd_card_free(card);
 386                 return NULL;
 387         }
 388         return card;
 389 }
 390
 391 /*
 392  * new 2.5 USB kernel API
 393  */
 394 static int snd_usX2Y_probe(struct usb_interface *intf, const struct usb_device_id *id)
 395 {
 396         void *chip;
 397         chip = usX2Y_usb_probe(interface_to_usbdev(intf), intf, id);
 398         if (chip) {
 399                 dev_set_drvdata(&intf->dev, chip);
 400                 return 0;
 401         } else
 402                 return -EIO;
 403 }
 404
 405 static void snd_usX2Y_disconnect(struct usb_interface *intf)
 406 {
 407         usX2Y_usb_disconnect(interface_to_usbdev(intf),
 408                                  dev_get_drvdata(&intf->dev));
 409 }
 410
 411 MODULE_DEVICE_TABLE(usb, snd_usX2Y_usb_id_table);
 412 static struct usb_driver snd_usX2Y_usb_driver = {
 413         .owner =        THIS_MODULE,
 414         .name =         "snd-usb-usx2y",
 415         .probe =        snd_usX2Y_probe,
 416         .disconnect =   snd_usX2Y_disconnect,
 417         .id_table =     snd_usX2Y_usb_id_table,
 418 };
 419
 420 static void snd_usX2Y_card_private_free(snd_card_t *card)
 421 {
 422         kfree(usX2Y(card)->In04Buf);
 423         usb_free_urb(usX2Y(card)->In04urb);
 424         if (usX2Y(card)->us428ctls_sharedmem)
 425                 snd_free_pages(usX2Y(card)->us428ctls_sharedmem, sizeof(*usX2Y(card)->us428ctls_sharedmem));
 426         if (usX2Y(card)->chip.index >= 0  &&  usX2Y(card)->chip.index < SNDRV_CARDS)
 427                 snd_usX2Y_card_used[usX2Y(card)->chip.index] = 0;
 428 }
 429
 430 /*
 431  * Frees the device.
 432  */
 433 static void usX2Y_usb_disconnect(struct usb_device* device, void* ptr)
 434 {
 435         if (ptr) {
 436                 usX2Ydev_t* usX2Y = usX2Y((snd_card_t*)ptr);
 437                 struct list_head* p;
 438                 usX2Y->chip.shutdown = 1;
 439                 usX2Y->chip_status = USX2Y_STAT_CHIP_HUP;
 440                 usX2Y_unlinkSeq(&usX2Y->AS04);
 441                 usb_kill_urb(usX2Y->In04urb);
 442                 snd_card_disconnect((snd_card_t*)ptr);
 443                 /* release the midi resources */
 444                 list_for_each(p, &usX2Y->chip.midi_list) {
 445                         snd_usbmidi_disconnect(p, &snd_usX2Y_usb_driver);
 446                 }
 447                 if (usX2Y->us428ctls_sharedmem)
 448                         wake_up(&usX2Y->us428ctls_wait_queue_head);
 449                 snd_card_free((snd_card_t*)ptr);
 450         }
 451 }
 452
 453 static int __init snd_usX2Y_module_init(void)
 454 {
 455         return usb_register(&snd_usX2Y_usb_driver);
 456 }
 457
 458 static void __exit snd_usX2Y_module_exit(void)
 459 {
 460         usb_deregister(&snd_usX2Y_usb_driver);
 461 }
 462
 463 module_init(snd_usX2Y_module_init)
 464 module_exit(snd_usX2Y_module_exit)