xref: /openbmc/linux/sound/usb/caiaq/device.c (revision e8e0929d)
1 /*
2  * caiaq.c: ALSA driver for caiaq/NativeInstruments devices
3  *
4  *   Copyright (c) 2007 Daniel Mack <daniel@caiaq.de>
5  *                      Karsten Wiese <fzu@wemgehoertderstaat.de>
6  *
7  *   This program is free software; you can redistribute it and/or modify
8  *   it under the terms of the GNU General Public License as published by
9  *   the Free Software Foundation; either version 2 of the License, or
10  *   (at your option) any later version.
11  *
12  *   This program is distributed in the hope that it will be useful,
13  *   but WITHOUT ANY WARRANTY; without even the implied warranty of
14  *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
15  *   GNU General Public License for more details.
16  *
17  *   You should have received a copy of the GNU General Public License
18  *   along with this program; if not, write to the Free Software
19  *   Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA
20 */
21 
22 #include <linux/moduleparam.h>
23 #include <linux/interrupt.h>
24 #include <linux/module.h>
25 #include <linux/init.h>
26 #include <linux/usb.h>
27 #include <sound/initval.h>
28 #include <sound/core.h>
29 #include <sound/pcm.h>
30 
31 #include "device.h"
32 #include "audio.h"
33 #include "midi.h"
34 #include "control.h"
35 #include "input.h"
36 
37 MODULE_AUTHOR("Daniel Mack <daniel@caiaq.de>");
38 MODULE_DESCRIPTION("caiaq USB audio, version 1.3.19");
39 MODULE_LICENSE("GPL");
40 MODULE_SUPPORTED_DEVICE("{{Native Instruments, RigKontrol2},"
41 			 "{Native Instruments, RigKontrol3},"
42 			 "{Native Instruments, Kore Controller},"
43 			 "{Native Instruments, Kore Controller 2},"
44 			 "{Native Instruments, Audio Kontrol 1},"
45 			 "{Native Instruments, Audio 2 DJ},"
46 			 "{Native Instruments, Audio 4 DJ},"
47 			 "{Native Instruments, Audio 8 DJ},"
48 			 "{Native Instruments, Session I/O},"
49 			 "{Native Instruments, GuitarRig mobile}");
50 
51 static int index[SNDRV_CARDS] = SNDRV_DEFAULT_IDX; /* Index 0-max */
52 static char* id[SNDRV_CARDS] = SNDRV_DEFAULT_STR; /* Id for this card */
53 static int enable[SNDRV_CARDS] = SNDRV_DEFAULT_ENABLE_PNP; /* Enable this card */
54 static int snd_card_used[SNDRV_CARDS];
55 
56 module_param_array(index, int, NULL, 0444);
57 MODULE_PARM_DESC(index, "Index value for the caiaq sound device");
58 module_param_array(id, charp, NULL, 0444);
59 MODULE_PARM_DESC(id, "ID string for the caiaq soundcard.");
60 module_param_array(enable, bool, NULL, 0444);
61 MODULE_PARM_DESC(enable, "Enable the caiaq soundcard.");
62 
63 enum {
64 	SAMPLERATE_44100	= 0,
65 	SAMPLERATE_48000	= 1,
66 	SAMPLERATE_96000	= 2,
67 	SAMPLERATE_192000	= 3,
68 	SAMPLERATE_88200	= 4,
69 	SAMPLERATE_INVALID	= 0xff
70 };
71 
72 enum {
73 	DEPTH_NONE	= 0,
74 	DEPTH_16	= 1,
75 	DEPTH_24	= 2,
76 	DEPTH_32	= 3
77 };
78 
79 static struct usb_device_id snd_usb_id_table[] = {
80 	{
81 		.match_flags =	USB_DEVICE_ID_MATCH_DEVICE,
82 		.idVendor =	USB_VID_NATIVEINSTRUMENTS,
83 		.idProduct =	USB_PID_RIGKONTROL2
84 	},
85 	{
86 		.match_flags =	USB_DEVICE_ID_MATCH_DEVICE,
87 		.idVendor =	USB_VID_NATIVEINSTRUMENTS,
88 		.idProduct =	USB_PID_RIGKONTROL3
89 	},
90 	{
91 		.match_flags =	USB_DEVICE_ID_MATCH_DEVICE,
92 		.idVendor =	USB_VID_NATIVEINSTRUMENTS,
93 		.idProduct =	USB_PID_KORECONTROLLER
94 	},
95 	{
96 		.match_flags =	USB_DEVICE_ID_MATCH_DEVICE,
97 		.idVendor =	USB_VID_NATIVEINSTRUMENTS,
98 		.idProduct =	USB_PID_KORECONTROLLER2
99 	},
100 	{
101 		.match_flags =  USB_DEVICE_ID_MATCH_DEVICE,
102 		.idVendor =     USB_VID_NATIVEINSTRUMENTS,
103 		.idProduct =    USB_PID_AK1
104 	},
105 	{
106 		.match_flags =  USB_DEVICE_ID_MATCH_DEVICE,
107 		.idVendor =     USB_VID_NATIVEINSTRUMENTS,
108 		.idProduct =    USB_PID_AUDIO8DJ
109 	},
110 	{
111 		.match_flags =  USB_DEVICE_ID_MATCH_DEVICE,
112 		.idVendor =     USB_VID_NATIVEINSTRUMENTS,
113 		.idProduct =    USB_PID_SESSIONIO
114 	},
115 	{
116 		.match_flags =  USB_DEVICE_ID_MATCH_DEVICE,
117 		.idVendor =     USB_VID_NATIVEINSTRUMENTS,
118 		.idProduct =    USB_PID_GUITARRIGMOBILE
119 	},
120 	{
121 		.match_flags =  USB_DEVICE_ID_MATCH_DEVICE,
122 		.idVendor =     USB_VID_NATIVEINSTRUMENTS,
123 		.idProduct =    USB_PID_AUDIO4DJ
124 	},
125 	{
126 		.match_flags =  USB_DEVICE_ID_MATCH_DEVICE,
127 		.idVendor =     USB_VID_NATIVEINSTRUMENTS,
128 		.idProduct =    USB_PID_AUDIO2DJ
129 	},
130 	{ /* terminator */ }
131 };
132 
133 static void usb_ep1_command_reply_dispatch (struct urb* urb)
134 {
135 	int ret;
136 	struct snd_usb_caiaqdev *dev = urb->context;
137 	unsigned char *buf = urb->transfer_buffer;
138 
139 	if (urb->status || !dev) {
140 		log("received EP1 urb->status = %i\n", urb->status);
141 		return;
142 	}
143 
144 	switch(buf[0]) {
145 	case EP1_CMD_GET_DEVICE_INFO:
146 	 	memcpy(&dev->spec, buf+1, sizeof(struct caiaq_device_spec));
147 		dev->spec.fw_version = le16_to_cpu(dev->spec.fw_version);
148 		debug("device spec (firmware %d): audio: %d in, %d out, "
149 			"MIDI: %d in, %d out, data alignment %d\n",
150 			dev->spec.fw_version,
151 			dev->spec.num_analog_audio_in,
152 			dev->spec.num_analog_audio_out,
153 			dev->spec.num_midi_in,
154 			dev->spec.num_midi_out,
155 			dev->spec.data_alignment);
156 
157 		dev->spec_received++;
158 		wake_up(&dev->ep1_wait_queue);
159 		break;
160 	case EP1_CMD_AUDIO_PARAMS:
161 		dev->audio_parm_answer = buf[1];
162 		wake_up(&dev->ep1_wait_queue);
163 		break;
164 	case EP1_CMD_MIDI_READ:
165 		snd_usb_caiaq_midi_handle_input(dev, buf[1], buf + 3, buf[2]);
166 		break;
167 	case EP1_CMD_READ_IO:
168 		if (dev->chip.usb_id ==
169 			USB_ID(USB_VID_NATIVEINSTRUMENTS, USB_PID_AUDIO8DJ)) {
170 			if (urb->actual_length > sizeof(dev->control_state))
171 				urb->actual_length = sizeof(dev->control_state);
172 			memcpy(dev->control_state, buf + 1, urb->actual_length);
173 			wake_up(&dev->ep1_wait_queue);
174 			break;
175 		}
176 #ifdef CONFIG_SND_USB_CAIAQ_INPUT
177 	case EP1_CMD_READ_ERP:
178 	case EP1_CMD_READ_ANALOG:
179 		snd_usb_caiaq_input_dispatch(dev, buf, urb->actual_length);
180 #endif
181 		break;
182 	}
183 
184 	dev->ep1_in_urb.actual_length = 0;
185 	ret = usb_submit_urb(&dev->ep1_in_urb, GFP_ATOMIC);
186 	if (ret < 0)
187 		log("unable to submit urb. OOM!?\n");
188 }
189 
190 int snd_usb_caiaq_send_command(struct snd_usb_caiaqdev *dev,
191 			       unsigned char command,
192 			       const unsigned char *buffer,
193 			       int len)
194 {
195 	int actual_len;
196 	struct usb_device *usb_dev = dev->chip.dev;
197 
198 	if (!usb_dev)
199 		return -EIO;
200 
201 	if (len > EP1_BUFSIZE - 1)
202 		len = EP1_BUFSIZE - 1;
203 
204 	if (buffer && len > 0)
205 		memcpy(dev->ep1_out_buf+1, buffer, len);
206 
207 	dev->ep1_out_buf[0] = command;
208 	return usb_bulk_msg(usb_dev, usb_sndbulkpipe(usb_dev, 1),
209 			   dev->ep1_out_buf, len+1, &actual_len, 200);
210 }
211 
212 int snd_usb_caiaq_set_audio_params (struct snd_usb_caiaqdev *dev,
213 		   		    int rate, int depth, int bpp)
214 {
215 	int ret;
216 	char tmp[5];
217 
218 	switch (rate) {
219 	case 44100:	tmp[0] = SAMPLERATE_44100;   break;
220 	case 48000:	tmp[0] = SAMPLERATE_48000;   break;
221 	case 88200:	tmp[0] = SAMPLERATE_88200;   break;
222 	case 96000:	tmp[0] = SAMPLERATE_96000;   break;
223 	case 192000:	tmp[0] = SAMPLERATE_192000;  break;
224 	default:	return -EINVAL;
225 	}
226 
227 	switch (depth) {
228 	case 16:	tmp[1] = DEPTH_16;   break;
229 	case 24:	tmp[1] = DEPTH_24;   break;
230 	default:	return -EINVAL;
231 	}
232 
233 	tmp[2] = bpp & 0xff;
234 	tmp[3] = bpp >> 8;
235 	tmp[4] = 1; /* packets per microframe */
236 
237 	debug("setting audio params: %d Hz, %d bits, %d bpp\n",
238 		rate, depth, bpp);
239 
240 	dev->audio_parm_answer = -1;
241 	ret = snd_usb_caiaq_send_command(dev, EP1_CMD_AUDIO_PARAMS,
242 					 tmp, sizeof(tmp));
243 
244 	if (ret)
245 		return ret;
246 
247 	if (!wait_event_timeout(dev->ep1_wait_queue,
248 	    dev->audio_parm_answer >= 0, HZ))
249 		return -EPIPE;
250 
251 	if (dev->audio_parm_answer != 1)
252 		debug("unable to set the device's audio params\n");
253 	else
254 		dev->bpp = bpp;
255 
256 	return dev->audio_parm_answer == 1 ? 0 : -EINVAL;
257 }
258 
259 int snd_usb_caiaq_set_auto_msg(struct snd_usb_caiaqdev *dev,
260 			       int digital, int analog, int erp)
261 {
262 	char tmp[3] = { digital, analog, erp };
263 	return snd_usb_caiaq_send_command(dev, EP1_CMD_AUTO_MSG,
264 					  tmp, sizeof(tmp));
265 }
266 
267 static void __devinit setup_card(struct snd_usb_caiaqdev *dev)
268 {
269 	int ret;
270 	char val[4];
271 
272 	/* device-specific startup specials */
273 	switch (dev->chip.usb_id) {
274 	case USB_ID(USB_VID_NATIVEINSTRUMENTS, USB_PID_RIGKONTROL2):
275 		/* RigKontrol2 - display centered dash ('-') */
276 		val[0] = 0x00;
277 		val[1] = 0x00;
278 		val[2] = 0x01;
279 		snd_usb_caiaq_send_command(dev, EP1_CMD_WRITE_IO, val, 3);
280 		break;
281 	case USB_ID(USB_VID_NATIVEINSTRUMENTS, USB_PID_RIGKONTROL3):
282 		/* RigKontrol2 - display two centered dashes ('--') */
283 		val[0] = 0x00;
284 		val[1] = 0x40;
285 		val[2] = 0x40;
286 		val[3] = 0x00;
287 		snd_usb_caiaq_send_command(dev, EP1_CMD_WRITE_IO, val, 4);
288 		break;
289 	case USB_ID(USB_VID_NATIVEINSTRUMENTS, USB_PID_AK1):
290 		/* Audio Kontrol 1 - make USB-LED stop blinking */
291 		val[0] = 0x00;
292 		snd_usb_caiaq_send_command(dev, EP1_CMD_WRITE_IO, val, 1);
293 		break;
294 	case USB_ID(USB_VID_NATIVEINSTRUMENTS, USB_PID_AUDIO8DJ):
295 		/* Audio 8 DJ - trigger read of current settings */
296 		dev->control_state[0] = 0xff;
297 		snd_usb_caiaq_set_auto_msg(dev, 1, 0, 0);
298 		snd_usb_caiaq_send_command(dev, EP1_CMD_READ_IO, NULL, 0);
299 
300 		if (!wait_event_timeout(dev->ep1_wait_queue,
301 					dev->control_state[0] != 0xff, HZ))
302 			return;
303 
304 		/* fix up some defaults */
305 		if ((dev->control_state[1] != 2) ||
306 		    (dev->control_state[2] != 3) ||
307 		    (dev->control_state[4] != 2)) {
308 			dev->control_state[1] = 2;
309 			dev->control_state[2] = 3;
310 			dev->control_state[4] = 2;
311 			snd_usb_caiaq_send_command(dev,
312 				EP1_CMD_WRITE_IO, dev->control_state, 6);
313 		}
314 
315 		break;
316 	case USB_ID(USB_VID_NATIVEINSTRUMENTS, USB_PID_AUDIO4DJ):
317 		/* Audio 4 DJ - default input mode to phono */
318 		dev->control_state[0] = 2;
319 		snd_usb_caiaq_send_command(dev, EP1_CMD_WRITE_IO,
320 			dev->control_state, 1);
321 		break;
322 	}
323 
324 	if (dev->spec.num_analog_audio_out +
325 	    dev->spec.num_analog_audio_in +
326 	    dev->spec.num_digital_audio_out +
327 	    dev->spec.num_digital_audio_in > 0) {
328 		ret = snd_usb_caiaq_audio_init(dev);
329 		if (ret < 0)
330 			log("Unable to set up audio system (ret=%d)\n", ret);
331 	}
332 
333 	if (dev->spec.num_midi_in +
334 	    dev->spec.num_midi_out > 0) {
335 		ret = snd_usb_caiaq_midi_init(dev);
336 		if (ret < 0)
337 			log("Unable to set up MIDI system (ret=%d)\n", ret);
338 	}
339 
340 #ifdef CONFIG_SND_USB_CAIAQ_INPUT
341 	ret = snd_usb_caiaq_input_init(dev);
342 	if (ret < 0)
343 		log("Unable to set up input system (ret=%d)\n", ret);
344 #endif
345 
346 	/* finally, register the card and all its sub-instances */
347 	ret = snd_card_register(dev->chip.card);
348 	if (ret < 0) {
349 		log("snd_card_register() returned %d\n", ret);
350 		snd_card_free(dev->chip.card);
351 	}
352 
353 	ret = snd_usb_caiaq_control_init(dev);
354 	if (ret < 0)
355 		log("Unable to set up control system (ret=%d)\n", ret);
356 }
357 
358 static int create_card(struct usb_device *usb_dev,
359 		       struct usb_interface *intf,
360 		       struct snd_card **cardp)
361 {
362 	int devnum;
363 	int err;
364 	struct snd_card *card;
365 	struct snd_usb_caiaqdev *dev;
366 
367 	for (devnum = 0; devnum < SNDRV_CARDS; devnum++)
368 		if (enable[devnum] && !snd_card_used[devnum])
369 			break;
370 
371 	if (devnum >= SNDRV_CARDS)
372 		return -ENODEV;
373 
374 	err = snd_card_create(index[devnum], id[devnum], THIS_MODULE,
375 			      sizeof(struct snd_usb_caiaqdev), &card);
376 	if (err < 0)
377 		return err;
378 
379 	dev = caiaqdev(card);
380 	dev->chip.dev = usb_dev;
381 	dev->chip.card = card;
382 	dev->chip.usb_id = USB_ID(le16_to_cpu(usb_dev->descriptor.idVendor),
383 				  le16_to_cpu(usb_dev->descriptor.idProduct));
384 	spin_lock_init(&dev->spinlock);
385 	snd_card_set_dev(card, &intf->dev);
386 
387 	*cardp = card;
388 	return 0;
389 }
390 
391 static int __devinit init_card(struct snd_usb_caiaqdev *dev)
392 {
393 	char *c, usbpath[32];
394 	struct usb_device *usb_dev = dev->chip.dev;
395 	struct snd_card *card = dev->chip.card;
396 	int err, len;
397 
398 	if (usb_set_interface(usb_dev, 0, 1) != 0) {
399 		log("can't set alt interface.\n");
400 		return -EIO;
401 	}
402 
403 	usb_init_urb(&dev->ep1_in_urb);
404 	usb_init_urb(&dev->midi_out_urb);
405 
406 	usb_fill_bulk_urb(&dev->ep1_in_urb, usb_dev,
407 			  usb_rcvbulkpipe(usb_dev, 0x1),
408 			  dev->ep1_in_buf, EP1_BUFSIZE,
409 			  usb_ep1_command_reply_dispatch, dev);
410 
411 	usb_fill_bulk_urb(&dev->midi_out_urb, usb_dev,
412 			  usb_sndbulkpipe(usb_dev, 0x1),
413 			  dev->midi_out_buf, EP1_BUFSIZE,
414 			  snd_usb_caiaq_midi_output_done, dev);
415 
416 	init_waitqueue_head(&dev->ep1_wait_queue);
417 	init_waitqueue_head(&dev->prepare_wait_queue);
418 
419 	if (usb_submit_urb(&dev->ep1_in_urb, GFP_KERNEL) != 0)
420 		return -EIO;
421 
422 	err = snd_usb_caiaq_send_command(dev, EP1_CMD_GET_DEVICE_INFO, NULL, 0);
423 	if (err)
424 		return err;
425 
426 	if (!wait_event_timeout(dev->ep1_wait_queue, dev->spec_received, HZ))
427 		return -ENODEV;
428 
429 	usb_string(usb_dev, usb_dev->descriptor.iManufacturer,
430 		   dev->vendor_name, CAIAQ_USB_STR_LEN);
431 
432 	usb_string(usb_dev, usb_dev->descriptor.iProduct,
433 		   dev->product_name, CAIAQ_USB_STR_LEN);
434 
435 	strlcpy(card->driver, MODNAME, sizeof(card->driver));
436 	strlcpy(card->shortname, dev->product_name, sizeof(card->shortname));
437 	strlcpy(card->mixername, dev->product_name, sizeof(card->mixername));
438 
439 	/* if the id was not passed as module option, fill it with a shortened
440 	 * version of the product string which does not contain any
441 	 * whitespaces */
442 
443 	if (*card->id == '\0') {
444 		char id[sizeof(card->id)];
445 
446 		memset(id, 0, sizeof(id));
447 
448 		for (c = card->shortname, len = 0;
449 			*c && len < sizeof(card->id); c++)
450 			if (*c != ' ')
451 				id[len++] = *c;
452 
453 		snd_card_set_id(card, id);
454 	}
455 
456 	usb_make_path(usb_dev, usbpath, sizeof(usbpath));
457 	snprintf(card->longname, sizeof(card->longname),
458 		       "%s %s (%s)",
459 		       dev->vendor_name, dev->product_name, usbpath);
460 
461 	setup_card(dev);
462 	return 0;
463 }
464 
465 static int __devinit snd_probe(struct usb_interface *intf,
466 		     const struct usb_device_id *id)
467 {
468 	int ret;
469 	struct snd_card *card;
470 	struct usb_device *device = interface_to_usbdev(intf);
471 
472 	ret = create_card(device, intf, &card);
473 
474 	if (ret < 0)
475 		return ret;
476 
477 	usb_set_intfdata(intf, card);
478 	ret = init_card(caiaqdev(card));
479 	if (ret < 0) {
480 		log("unable to init card! (ret=%d)\n", ret);
481 		snd_card_free(card);
482 		return ret;
483 	}
484 
485 	return 0;
486 }
487 
488 static void snd_disconnect(struct usb_interface *intf)
489 {
490 	struct snd_usb_caiaqdev *dev;
491 	struct snd_card *card = usb_get_intfdata(intf);
492 
493 	debug("%s(%p)\n", __func__, intf);
494 
495 	if (!card)
496 		return;
497 
498 	dev = caiaqdev(card);
499 	snd_card_disconnect(card);
500 
501 #ifdef CONFIG_SND_USB_CAIAQ_INPUT
502 	snd_usb_caiaq_input_free(dev);
503 #endif
504 	snd_usb_caiaq_audio_free(dev);
505 
506 	usb_kill_urb(&dev->ep1_in_urb);
507 	usb_kill_urb(&dev->midi_out_urb);
508 
509 	snd_card_free(card);
510 	usb_reset_device(interface_to_usbdev(intf));
511 }
512 
513 
514 MODULE_DEVICE_TABLE(usb, snd_usb_id_table);
515 static struct usb_driver snd_usb_driver = {
516 	.name 		= MODNAME,
517 	.probe 		= snd_probe,
518 	.disconnect	= snd_disconnect,
519 	.id_table 	= snd_usb_id_table,
520 };
521 
522 static int __init snd_module_init(void)
523 {
524 	return usb_register(&snd_usb_driver);
525 }
526 
527 static void __exit snd_module_exit(void)
528 {
529 	usb_deregister(&snd_usb_driver);
530 }
531 
532 module_init(snd_module_init)
533 module_exit(snd_module_exit)
534 
535