[linux-2.6-block.git] / sound / usb / format.c

/*
 *   This program is free software; you can redistribute it and/or modify
 *   it under the terms of the GNU General Public License as published by
 *   the Free Software Foundation; either version 2 of the License, or
 *   (at your option) any later version.
 *
 *   This program is distributed in the hope that it will be useful,
 *   but WITHOUT ANY WARRANTY; without even the implied warranty of
 *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 *   GNU General Public License for more details.
 *
 *   You should have received a copy of the GNU General Public License
 *   along with this program; if not, write to the Free Software
 *   Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA
 *
 */

#include <linux/init.h>
#include <linux/slab.h>
#include <linux/usb.h>
#include <linux/usb/audio.h>
#include <linux/usb/audio-v2.h>

#include <sound/core.h>
#include <sound/pcm.h>

#include "usbaudio.h"
#include "card.h"
#include "quirks.h"
#include "helper.h"
#include "debug.h"
#include "clock.h"
#include "format.h"

/*
 * parse the audio format type I descriptor
 * and returns the corresponding pcm format
 *
 * @dev: usb device
 * @fp: audioformat record
 * @format: the format tag (wFormatTag)
 * @fmt: the format type descriptor
 */
static u64 parse_audio_format_i_type(struct snd_usb_audio *chip,
				     struct audioformat *fp,
				     unsigned int format, void *_fmt,
				     int protocol)
{
	int sample_width, sample_bytes;
	u64 pcm_formats = 0;

	switch (protocol) {
	case UAC_VERSION_1:
	default: {
		struct uac_format_type_i_discrete_descriptor *fmt = _fmt;
		sample_width = fmt->bBitResolution;
		sample_bytes = fmt->bSubframeSize;
		format = 1 << format;
		break;
	}

	case UAC_VERSION_2: {
		struct uac_format_type_i_ext_descriptor *fmt = _fmt;
		sample_width = fmt->bBitResolution;
		sample_bytes = fmt->bSubslotSize;

		if (format & UAC2_FORMAT_TYPE_I_RAW_DATA)
			pcm_formats |= SNDRV_PCM_FMTBIT_SPECIAL;

		format <<= 1;
		break;
	}
	}

	if ((pcm_formats == 0) &&
	    (format == 0 || format == (1 << UAC_FORMAT_TYPE_I_UNDEFINED))) {
		/* some devices don't define this correctly... */
		snd_printdd(KERN_INFO "%d:%u:%d : format type 0 is detected, processed as PCM\n",
			    chip->dev->devnum, fp->iface, fp->altsetting);
		format = 1 << UAC_FORMAT_TYPE_I_PCM;
	}
	if (format & (1 << UAC_FORMAT_TYPE_I_PCM)) {
		if (chip->usb_id == USB_ID(0x0582, 0x0016) /* Edirol SD-90 */ &&
		    sample_width == 24 && sample_bytes == 2)
			sample_bytes = 3;
		else if (sample_width > sample_bytes * 8) {
			snd_printk(KERN_INFO "%d:%u:%d : sample bitwidth %d in over sample bytes %d\n",
				   chip->dev->devnum, fp->iface, fp->altsetting,
				   sample_width, sample_bytes);
		}
		/* check the format byte size */
		switch (sample_bytes) {
		case 1:
			pcm_formats |= SNDRV_PCM_FMTBIT_S8;
			break;
		case 2:
			if (snd_usb_is_big_endian_format(chip, fp))
				pcm_formats |= SNDRV_PCM_FMTBIT_S16_BE; /* grrr, big endian!! */
			else
				pcm_formats |= SNDRV_PCM_FMTBIT_S16_LE;
			break;
		case 3:
			if (snd_usb_is_big_endian_format(chip, fp))
				pcm_formats |= SNDRV_PCM_FMTBIT_S24_3BE; /* grrr, big endian!! */
			else
				pcm_formats |= SNDRV_PCM_FMTBIT_S24_3LE;
			break;
		case 4:
			pcm_formats |= SNDRV_PCM_FMTBIT_S32_LE;
			break;
		default:
			snd_printk(KERN_INFO "%d:%u:%d : unsupported sample bitwidth %d in %d bytes\n",
				   chip->dev->devnum, fp->iface, fp->altsetting,
				   sample_width, sample_bytes);
			break;
		}
	}
	if (format & (1 << UAC_FORMAT_TYPE_I_PCM8)) {
		/* Dallas DS4201 workaround: it advertises U8 format, but really
		   supports S8. */
		if (chip->usb_id == USB_ID(0x04fa, 0x4201))
			pcm_formats |= SNDRV_PCM_FMTBIT_S8;
		else
			pcm_formats |= SNDRV_PCM_FMTBIT_U8;
	}
	if (format & (1 << UAC_FORMAT_TYPE_I_IEEE_FLOAT)) {
		pcm_formats |= SNDRV_PCM_FMTBIT_FLOAT_LE;
	}
	if (format & (1 << UAC_FORMAT_TYPE_I_ALAW)) {
		pcm_formats |= SNDRV_PCM_FMTBIT_A_LAW;
	}
	if (format & (1 << UAC_FORMAT_TYPE_I_MULAW)) {
		pcm_formats |= SNDRV_PCM_FMTBIT_MU_LAW;
	}
	if (format & ~0x3f) {
		snd_printk(KERN_INFO "%d:%u:%d : unsupported format bits %#x\n",
			   chip->dev->devnum, fp->iface, fp->altsetting, format);
	}
	return pcm_formats;
}


/*
 * parse the format descriptor and stores the possible sample rates
 * on the audioformat table (audio class v1).
 *
 * @dev: usb device
 * @fp: audioformat record
 * @fmt: the format descriptor
 * @offset: the start offset of descriptor pointing the rate type
 *          (7 for type I and II, 8 for type II)
 */
static int parse_audio_format_rates_v1(struct snd_usb_audio *chip, struct audioformat *fp,
				       unsigned char *fmt, int offset)
{
	int nr_rates = fmt[offset];

	if (fmt[0] < offset + 1 + 3 * (nr_rates ? nr_rates : 2)) {
		snd_printk(KERN_ERR "%d:%u:%d : invalid UAC_FORMAT_TYPE desc\n",
				   chip->dev->devnum, fp->iface, fp->altsetting);
		return -EINVAL;
	}

	if (nr_rates) {
		/*
		 * build the rate table and bitmap flags
		 */
		int r, idx;

		fp->rate_table = kmalloc(sizeof(int) * nr_rates, GFP_KERNEL);
		if (fp->rate_table == NULL) {
			snd_printk(KERN_ERR "cannot malloc\n");
			return -ENOMEM;
		}

		fp->nr_rates = 0;
		fp->rate_min = fp->rate_max = 0;
		for (r = 0, idx = offset + 1; r < nr_rates; r++, idx += 3) {
			unsigned int rate = combine_triple(&fmt[idx]);
			if (!rate)
				continue;
			/* C-Media CM6501 mislabels its 96 kHz altsetting */
			/* Terratec Aureon 7.1 USB C-Media 6206, too */
			if (rate == 48000 && nr_rates == 1 &&
			    (chip->usb_id == USB_ID(0x0d8c, 0x0201) ||
			     chip->usb_id == USB_ID(0x0d8c, 0x0102) ||
			     chip->usb_id == USB_ID(0x0ccd, 0x00b1)) &&
			    fp->altsetting == 5 && fp->maxpacksize == 392)
				rate = 96000;
			/* Creative VF0470 Live Cam reports 16 kHz instead of 8kHz */
			if (rate == 16000 && chip->usb_id == USB_ID(0x041e, 0x4068))
				rate = 8000;

			fp->rate_table[fp->nr_rates] = rate;
			if (!fp->rate_min || rate < fp->rate_min)
				fp->rate_min = rate;
			if (!fp->rate_max || rate > fp->rate_max)
				fp->rate_max = rate;
			fp->rates |= snd_pcm_rate_to_rate_bit(rate);
			fp->nr_rates++;
		}
		if (!fp->nr_rates) {
			hwc_debug("All rates were zero. Skipping format!\n");
			return -EINVAL;
		}
	} else {
		/* continuous rates */
		fp->rates = SNDRV_PCM_RATE_CONTINUOUS;
		fp->rate_min = combine_triple(&fmt[offset + 1]);
		fp->rate_max = combine_triple(&fmt[offset + 4]);
	}
	return 0;
}

/*
 * Helper function to walk the array of sample rate triplets reported by
 * the device. The problem is that we need to parse whole array first to
 * get to know how many sample rates we have to expect.
 * Then fp->rate_table can be allocated and filled.
 */
static int parse_uac2_sample_rate_range(struct audioformat *fp, int nr_triplets,
					const unsigned char *data)
{
	int i, nr_rates = 0;

	fp->rates = fp->rate_min = fp->rate_max = 0;

	for (i = 0; i < nr_triplets; i++) {
		int min = combine_quad(&data[2 + 12 * i]);
		int max = combine_quad(&data[6 + 12 * i]);
		int res = combine_quad(&data[10 + 12 * i]);
		unsigned int rate;

		if ((max < 0) || (min < 0) || (res < 0) || (max < min))
			continue;

		/*
		 * for ranges with res == 1, we announce a continuous sample
		 * rate range, and this function should return 0 for no further
		 * parsing.
		 */
		if (res == 1) {
			fp->rate_min = min;
			fp->rate_max = max;
			fp->rates = SNDRV_PCM_RATE_CONTINUOUS;
			return 0;
		}

		for (rate = min; rate <= max; rate += res) {
			if (fp->rate_table)
				fp->rate_table[nr_rates] = rate;
			if (!fp->rate_min || rate < fp->rate_min)
				fp->rate_min = rate;
			if (!fp->rate_max || rate > fp->rate_max)
				fp->rate_max = rate;
			fp->rates |= snd_pcm_rate_to_rate_bit(rate);

			nr_rates++;
			if (nr_rates >= MAX_NR_RATES) {
				snd_printk(KERN_ERR "invalid uac2 rates\n");
				break;
			}

			/* avoid endless loop */
			if (res == 0)
				break;
		}
	}

	return nr_rates;
}

/*
 * parse the format descriptor and stores the possible sample rates
 * on the audioformat table (audio class v2).
 */
static int parse_audio_format_rates_v2(struct snd_usb_audio *chip,
				       struct audioformat *fp)
{
	struct usb_device *dev = chip->dev;
	unsigned char tmp[2], *data;
	int nr_triplets, data_size, ret = 0;
	int clock = snd_usb_clock_find_source(chip, fp->clock, false);

	if (clock < 0) {
		snd_printk(KERN_ERR "%s(): unable to find clock source (clock %d)\n",
				__func__, clock);
		goto err;
	}

	/* get the number of sample rates first by only fetching 2 bytes */
	ret = snd_usb_ctl_msg(dev, usb_rcvctrlpipe(dev, 0), UAC2_CS_RANGE,
			      USB_TYPE_CLASS | USB_RECIP_INTERFACE | USB_DIR_IN,
			      UAC2_CS_CONTROL_SAM_FREQ << 8,
			      snd_usb_ctrl_intf(chip) | (clock << 8),
			      tmp, sizeof(tmp));

	if (ret < 0) {
		snd_printk(KERN_ERR "%s(): unable to retrieve number of sample rates (clock %d)\n",
				__func__, clock);
		goto err;
	}

	nr_triplets = (tmp[1] << 8) | tmp[0];
	data_size = 2 + 12 * nr_triplets;
	data = kzalloc(data_size, GFP_KERNEL);
	if (!data) {
		ret = -ENOMEM;
		goto err;
	}

	/* now get the full information */
	ret = snd_usb_ctl_msg(dev, usb_rcvctrlpipe(dev, 0), UAC2_CS_RANGE,
			      USB_TYPE_CLASS | USB_RECIP_INTERFACE | USB_DIR_IN,
			      UAC2_CS_CONTROL_SAM_FREQ << 8,
			      snd_usb_ctrl_intf(chip) | (clock << 8),
			      data, data_size);

	if (ret < 0) {
		snd_printk(KERN_ERR "%s(): unable to retrieve sample rate range (clock %d)\n",
				__func__, clock);
		ret = -EINVAL;
		goto err_free;
	}

	/* Call the triplet parser, and make sure fp->rate_table is NULL.
	 * We just use the return value to know how many sample rates we
	 * will have to deal with. */
	kfree(fp->rate_table);
	fp->rate_table = NULL;
	fp->nr_rates = parse_uac2_sample_rate_range(fp, nr_triplets, data);

	if (fp->nr_rates == 0) {
		/* SNDRV_PCM_RATE_CONTINUOUS */
		ret = 0;
		goto err_free;
	}

	fp->rate_table = kmalloc(sizeof(int) * fp->nr_rates, GFP_KERNEL);
	if (!fp->rate_table) {
		ret = -ENOMEM;
		goto err_free;
	}

	/* Call the triplet parser again, but this time, fp->rate_table is
	 * allocated, so the rates will be stored */
	parse_uac2_sample_rate_range(fp, nr_triplets, data);

err_free:
	kfree(data);
err:
	return ret;
}

/*
 * parse the format type I and III descriptors
 */
static int parse_audio_format_i(struct snd_usb_audio *chip,
				struct audioformat *fp, unsigned int format,
				struct uac_format_type_i_continuous_descriptor *fmt,
				struct usb_host_interface *iface)
{
	struct usb_interface_descriptor *altsd = get_iface_desc(iface);
	int protocol = altsd->bInterfaceProtocol;
	int pcm_format, ret;

	if (fmt->bFormatType == UAC_FORMAT_TYPE_III) {
		/* FIXME: the format type is really IECxxx
		 *        but we give normal PCM format to get the existing
		 *        apps working...
		 */
		switch (chip->usb_id) {

		case USB_ID(0x0763, 0x2003): /* M-Audio Audiophile USB */
			if (chip->setup == 0x00 && 
			    fp->altsetting == 6)
				pcm_format = SNDRV_PCM_FORMAT_S16_BE;
			else
				pcm_format = SNDRV_PCM_FORMAT_S16_LE;
			break;
		default:
			pcm_format = SNDRV_PCM_FORMAT_S16_LE;
		}
		fp->formats = 1uLL << pcm_format;
	} else {
		fp->formats = parse_audio_format_i_type(chip, fp, format,
							fmt, protocol);
		if (!fp->formats)
			return -EINVAL;
	}

	/* gather possible sample rates */
	/* audio class v1 reports possible sample rates as part of the
	 * proprietary class specific descriptor.
	 * audio class v2 uses class specific EP0 range requests for that.
	 */
	switch (protocol) {
	default:
		snd_printdd(KERN_WARNING "%d:%u:%d : invalid protocol version %d, assuming v1\n",
			   chip->dev->devnum, fp->iface, fp->altsetting, protocol);
		/* fall through */
	case UAC_VERSION_1:
		fp->channels = fmt->bNrChannels;
		ret = parse_audio_format_rates_v1(chip, fp, (unsigned char *) fmt, 7);
		break;
	case UAC_VERSION_2:
		/* fp->channels is already set in this case */
		ret = parse_audio_format_rates_v2(chip, fp);
		break;
	}

	if (fp->channels < 1) {
		snd_printk(KERN_ERR "%d:%u:%d : invalid channels %d\n",
			   chip->dev->devnum, fp->iface, fp->altsetting, fp->channels);
		return -EINVAL;
	}

	return ret;
}

/*
 * parse the format type II descriptor
 */
static int parse_audio_format_ii(struct snd_usb_audio *chip,
				 struct audioformat *fp,
				 int format, void *_fmt,
				 struct usb_host_interface *iface)
{
	int brate, framesize, ret;
	struct usb_interface_descriptor *altsd = get_iface_desc(iface);
	int protocol = altsd->bInterfaceProtocol;

	switch (format) {
	case UAC_FORMAT_TYPE_II_AC3:
		/* FIXME: there is no AC3 format defined yet */
		// fp->formats = SNDRV_PCM_FMTBIT_AC3;
		fp->formats = SNDRV_PCM_FMTBIT_U8; /* temporary hack to receive byte streams */
		break;
	case UAC_FORMAT_TYPE_II_MPEG:
		fp->formats = SNDRV_PCM_FMTBIT_MPEG;
		break;
	default:
		snd_printd(KERN_INFO "%d:%u:%d : unknown format tag %#x is detected.  processed as MPEG.\n",
			   chip->dev->devnum, fp->iface, fp->altsetting, format);
		fp->formats = SNDRV_PCM_FMTBIT_MPEG;
		break;
	}

	fp->channels = 1;

	switch (protocol) {
	default:
		snd_printdd(KERN_WARNING "%d:%u:%d : invalid protocol version %d, assuming v1\n",
			   chip->dev->devnum, fp->iface, fp->altsetting, protocol);
		/* fall through */
	case UAC_VERSION_1: {
		struct uac_format_type_ii_discrete_descriptor *fmt = _fmt;
		brate = le16_to_cpu(fmt->wMaxBitRate);
		framesize = le16_to_cpu(fmt->wSamplesPerFrame);
		snd_printd(KERN_INFO "found format II with max.bitrate = %d, frame size=%d\n", brate, framesize);
		fp->frame_size = framesize;
		ret = parse_audio_format_rates_v1(chip, fp, _fmt, 8); /* fmt[8..] sample rates */
		break;
	}
	case UAC_VERSION_2: {
		struct uac_format_type_ii_ext_descriptor *fmt = _fmt;
		brate = le16_to_cpu(fmt->wMaxBitRate);
		framesize = le16_to_cpu(fmt->wSamplesPerFrame);
		snd_printd(KERN_INFO "found format II with max.bitrate = %d, frame size=%d\n", brate, framesize);
		fp->frame_size = framesize;
		ret = parse_audio_format_rates_v2(chip, fp);
		break;
	}
	}

	return ret;
}

int snd_usb_parse_audio_format(struct snd_usb_audio *chip,
			       struct audioformat *fp, unsigned int format,
			       struct uac_format_type_i_continuous_descriptor *fmt,
			       int stream, struct usb_host_interface *iface)
{
	int err;

	switch (fmt->bFormatType) {
	case UAC_FORMAT_TYPE_I:
	case UAC_FORMAT_TYPE_III:
		err = parse_audio_format_i(chip, fp, format, fmt, iface);
		break;
	case UAC_FORMAT_TYPE_II:
		err = parse_audio_format_ii(chip, fp, format, fmt, iface);
		break;
	default:
		snd_printd(KERN_INFO "%d:%u:%d : format type %d is not supported yet\n",
			   chip->dev->devnum, fp->iface, fp->altsetting,
			   fmt->bFormatType);
		return -ENOTSUPP;
	}
	fp->fmt_type = fmt->bFormatType;
	if (err < 0)
		return err;
#if 1
	/* FIXME: temporary hack for extigy/audigy 2 nx/zs */
	/* extigy apparently supports sample rates other than 48k
	 * but not in ordinary way.  so we enable only 48k atm.
	 */
	if (chip->usb_id == USB_ID(0x041e, 0x3000) ||
	    chip->usb_id == USB_ID(0x041e, 0x3020) ||
	    chip->usb_id == USB_ID(0x041e, 0x3061)) {
		if (fmt->bFormatType == UAC_FORMAT_TYPE_I &&
		    fp->rates != SNDRV_PCM_RATE_48000 &&
		    fp->rates != SNDRV_PCM_RATE_96000)
			return -ENOTSUPP;
	}
#endif
	return 0;
}
Commit	Line	Data
e5779998 DM	1	/*
	2	* This program is free software; you can redistribute it and/or modify
	3	* it under the terms of the GNU General Public License as published by
	4	* the Free Software Foundation; either version 2 of the License, or
	5	* (at your option) any later version.
	6	*
	7	* This program is distributed in the hope that it will be useful,
	8	* but WITHOUT ANY WARRANTY; without even the implied warranty of
	9	* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
	10	* GNU General Public License for more details.
	11	*
	12	* You should have received a copy of the GNU General Public License
	13	* along with this program; if not, write to the Free Software
	14	* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
	15	*
	16	*/
	17
	18	#include <linux/init.h>
36db0456	19	#include <linux/slab.h>
e5779998 DM	20	#include <linux/usb.h>
e5779998 DM	21	#include <linux/usb/audio.h>
7e847894	22	#include <linux/usb/audio-v2.h>
e5779998 DM	23
	24	#include <sound/core.h>
	25	#include <sound/pcm.h>
	26
	27	#include "usbaudio.h"
	28	#include "card.h"
	29	#include "quirks.h"
	30	#include "helper.h"
	31	#include "debug.h"
79f920fb	32	#include "clock.h"
ee95cb61	33	#include "format.h"
e5779998 DM	34
	35	/*
	36	* parse the audio format type I descriptor
	37	* and returns the corresponding pcm format
	38	*
	39	* @dev: usb device
	40	* @fp: audioformat record
	41	* @format: the format tag (wFormatTag)
	42	* @fmt: the format type descriptor
	43	*/
29088fef	44	static u64 parse_audio_format_i_type(struct snd_usb_audio *chip,
e5779998	45	struct audioformat *fp,
2fcdb06d	46	unsigned int format, void *_fmt,
e5779998 DM	47	int protocol)
e5779998 DM	48	{
e5779998	49	int sample_width, sample_bytes;
717bfb5f	50	u64 pcm_formats = 0;
e5779998 DM	51
e5779998 DM	52	switch (protocol) {
a2acad82 CL	53	case UAC_VERSION_1:
a2acad82 CL	54	default: {
e5779998 DM	55	struct uac_format_type_i_discrete_descriptor *fmt = _fmt;
	56	sample_width = fmt->bBitResolution;
	57	sample_bytes = fmt->bSubframeSize;
29088fef	58	format = 1 << format;
e5779998 DM	59	break;
	60	}
	61
	62	case UAC_VERSION_2: {
	63	struct uac_format_type_i_ext_descriptor *fmt = _fmt;
	64	sample_width = fmt->bBitResolution;
	65	sample_bytes = fmt->bSubslotSize;
717bfb5f DM	66
	67	if (format & UAC2_FORMAT_TYPE_I_RAW_DATA)
	68	pcm_formats \|= SNDRV_PCM_FMTBIT_SPECIAL;
	69
29088fef	70	format <<= 1;
e5779998 DM	71	break;
e5779998 DM	72	}
e5779998 DM	73	}
e5779998 DM	74
717bfb5f DM	75	if ((pcm_formats == 0) &&
717bfb5f DM	76	(format == 0 \|\| format == (1 << UAC_FORMAT_TYPE_I_UNDEFINED))) {
29088fef	77	/* some devices don't define this correctly... */
e5779998 DM	78	snd_printdd(KERN_INFO "%d:%u:%d : format type 0 is detected, processed as PCM\n",
e5779998 DM	79	chip->dev->devnum, fp->iface, fp->altsetting);
29088fef CL	80	format = 1 << UAC_FORMAT_TYPE_I_PCM;
	81	}
	82	if (format & (1 << UAC_FORMAT_TYPE_I_PCM)) {
061b869e CL	83	if (chip->usb_id == USB_ID(0x0582, 0x0016) /* Edirol SD-90 */ &&
	84	sample_width == 24 && sample_bytes == 2)
	85	sample_bytes = 3;
	86	else if (sample_width > sample_bytes * 8) {
e5779998 DM	87	snd_printk(KERN_INFO "%d:%u:%d : sample bitwidth %d in over sample bytes %d\n",
	88	chip->dev->devnum, fp->iface, fp->altsetting,
	89	sample_width, sample_bytes);
	90	}
	91	/* check the format byte size */
	92	switch (sample_bytes) {
	93	case 1:
29088fef	94	pcm_formats \|= SNDRV_PCM_FMTBIT_S8;
e5779998 DM	95	break;
	96	case 2:
	97	if (snd_usb_is_big_endian_format(chip, fp))
29088fef	98	pcm_formats \|= SNDRV_PCM_FMTBIT_S16_BE; /* grrr, big endian!! */
e5779998	99	else
29088fef	100	pcm_formats \|= SNDRV_PCM_FMTBIT_S16_LE;
e5779998 DM	101	break;
	102	case 3:
	103	if (snd_usb_is_big_endian_format(chip, fp))
29088fef	104	pcm_formats \|= SNDRV_PCM_FMTBIT_S24_3BE; /* grrr, big endian!! */
e5779998	105	else
29088fef	106	pcm_formats \|= SNDRV_PCM_FMTBIT_S24_3LE;
e5779998 DM	107	break;
e5779998 DM	108	case 4:
29088fef	109	pcm_formats \|= SNDRV_PCM_FMTBIT_S32_LE;
e5779998 DM	110	break;
	111	default:
	112	snd_printk(KERN_INFO "%d:%u:%d : unsupported sample bitwidth %d in %d bytes\n",
	113	chip->dev->devnum, fp->iface, fp->altsetting,
	114	sample_width, sample_bytes);
	115	break;
	116	}
29088fef CL	117	}
29088fef CL	118	if (format & (1 << UAC_FORMAT_TYPE_I_PCM8)) {
e5779998 DM	119	/* Dallas DS4201 workaround: it advertises U8 format, but really
	120	supports S8. */
	121	if (chip->usb_id == USB_ID(0x04fa, 0x4201))
29088fef CL	122	pcm_formats \|= SNDRV_PCM_FMTBIT_S8;
	123	else
	124	pcm_formats \|= SNDRV_PCM_FMTBIT_U8;
	125	}
	126	if (format & (1 << UAC_FORMAT_TYPE_I_IEEE_FLOAT)) {
	127	pcm_formats \|= SNDRV_PCM_FMTBIT_FLOAT_LE;
	128	}
	129	if (format & (1 << UAC_FORMAT_TYPE_I_ALAW)) {
	130	pcm_formats \|= SNDRV_PCM_FMTBIT_A_LAW;
	131	}
	132	if (format & (1 << UAC_FORMAT_TYPE_I_MULAW)) {
	133	pcm_formats \|= SNDRV_PCM_FMTBIT_MU_LAW;
	134	}
	135	if (format & ~0x3f) {
	136	snd_printk(KERN_INFO "%d:%u:%d : unsupported format bits %#x\n",
e5779998	137	chip->dev->devnum, fp->iface, fp->altsetting, format);
e5779998	138	}
29088fef	139	return pcm_formats;
e5779998 DM	140	}
	141
	142
	143	/*
	144	* parse the format descriptor and stores the possible sample rates
	145	* on the audioformat table (audio class v1).
	146	*
	147	* @dev: usb device
	148	* @fp: audioformat record
	149	* @fmt: the format descriptor
	150	* @offset: the start offset of descriptor pointing the rate type
	151	* (7 for type I and II, 8 for type II)
	152	*/
	153	static int parse_audio_format_rates_v1(struct snd_usb_audio chip, struct audioformat fp,
	154	unsigned char *fmt, int offset)
	155	{
	156	int nr_rates = fmt[offset];
	157
	158	if (fmt[0] < offset + 1 + 3 * (nr_rates ? nr_rates : 2)) {
	159	snd_printk(KERN_ERR "%d:%u:%d : invalid UAC_FORMAT_TYPE desc\n",
	160	chip->dev->devnum, fp->iface, fp->altsetting);
8ad10dc6	161	return -EINVAL;
e5779998 DM	162	}
	163
	164	if (nr_rates) {
	165	/*
	166	* build the rate table and bitmap flags
	167	*/
	168	int r, idx;
	169
	170	fp->rate_table = kmalloc(sizeof(int) * nr_rates, GFP_KERNEL);
	171	if (fp->rate_table == NULL) {
	172	snd_printk(KERN_ERR "cannot malloc\n");
8ad10dc6	173	return -ENOMEM;
e5779998 DM	174	}
	175
	176	fp->nr_rates = 0;
	177	fp->rate_min = fp->rate_max = 0;
	178	for (r = 0, idx = offset + 1; r < nr_rates; r++, idx += 3) {
	179	unsigned int rate = combine_triple(&fmt[idx]);
	180	if (!rate)
	181	continue;
	182	/* C-Media CM6501 mislabels its 96 kHz altsetting */
8129e79e	183	/* Terratec Aureon 7.1 USB C-Media 6206, too */
e5779998 DM	184	if (rate == 48000 && nr_rates == 1 &&
e5779998 DM	185	(chip->usb_id == USB_ID(0x0d8c, 0x0201) \|\|
8129e79e WB	186	chip->usb_id == USB_ID(0x0d8c, 0x0102) \|\|
8129e79e WB	187	chip->usb_id == USB_ID(0x0ccd, 0x00b1)) &&
e5779998 DM	188	fp->altsetting == 5 && fp->maxpacksize == 392)
	189	rate = 96000;
	190	/* Creative VF0470 Live Cam reports 16 kHz instead of 8kHz */
	191	if (rate == 16000 && chip->usb_id == USB_ID(0x041e, 0x4068))
	192	rate = 8000;
	193
	194	fp->rate_table[fp->nr_rates] = rate;
	195	if (!fp->rate_min \|\| rate < fp->rate_min)
	196	fp->rate_min = rate;
	197	if (!fp->rate_max \|\| rate > fp->rate_max)
	198	fp->rate_max = rate;
	199	fp->rates \|= snd_pcm_rate_to_rate_bit(rate);
	200	fp->nr_rates++;
	201	}
	202	if (!fp->nr_rates) {
	203	hwc_debug("All rates were zero. Skipping format!\n");
8ad10dc6	204	return -EINVAL;
e5779998 DM	205	}
	206	} else {
	207	/* continuous rates */
	208	fp->rates = SNDRV_PCM_RATE_CONTINUOUS;
	209	fp->rate_min = combine_triple(&fmt[offset + 1]);
	210	fp->rate_max = combine_triple(&fmt[offset + 4]);
	211	}
	212	return 0;
	213	}
	214
67c10366 DM	215	/*
	216	* Helper function to walk the array of sample rate triplets reported by
	217	* the device. The problem is that we need to parse whole array first to
	218	* get to know how many sample rates we have to expect.
	219	* Then fp->rate_table can be allocated and filled.
	220	*/
	221	static int parse_uac2_sample_rate_range(struct audioformat *fp, int nr_triplets,
	222	const unsigned char *data)
	223	{
	224	int i, nr_rates = 0;
	225
	226	fp->rates = fp->rate_min = fp->rate_max = 0;
	227
	228	for (i = 0; i < nr_triplets; i++) {
	229	int min = combine_quad(&data[2 + 12 * i]);
	230	int max = combine_quad(&data[6 + 12 * i]);
	231	int res = combine_quad(&data[10 + 12 * i]);
4fa0e81b	232	unsigned int rate;
67c10366 DM	233
	234	if ((max < 0) \|\| (min < 0) \|\| (res < 0) \|\| (max < min))
	235	continue;
	236
	237	/*
	238	* for ranges with res == 1, we announce a continuous sample
	239	* rate range, and this function should return 0 for no further
	240	* parsing.
	241	*/
	242	if (res == 1) {
	243	fp->rate_min = min;
	244	fp->rate_max = max;
	245	fp->rates = SNDRV_PCM_RATE_CONTINUOUS;
	246	return 0;
	247	}
	248
	249	for (rate = min; rate <= max; rate += res) {
	250	if (fp->rate_table)
	251	fp->rate_table[nr_rates] = rate;
	252	if (!fp->rate_min \|\| rate < fp->rate_min)
	253	fp->rate_min = rate;
	254	if (!fp->rate_max \|\| rate > fp->rate_max)
	255	fp->rate_max = rate;
	256	fp->rates \|= snd_pcm_rate_to_rate_bit(rate);
	257
	258	nr_rates++;
8866f405	259	if (nr_rates >= MAX_NR_RATES) {
4fa0e81b XW	260	snd_printk(KERN_ERR "invalid uac2 rates\n");
	261	break;
	262	}
67c10366 DM	263
	264	/* avoid endless loop */
	265	if (res == 0)
	266	break;
	267	}
	268	}
	269
	270	return nr_rates;
	271	}
	272
e5779998 DM	273	/*
	274	* parse the format descriptor and stores the possible sample rates
	275	* on the audioformat table (audio class v2).
	276	*/
	277	static int parse_audio_format_rates_v2(struct snd_usb_audio *chip,
3d8d4dcf	278	struct audioformat *fp)
e5779998 DM	279	{
	280	struct usb_device *dev = chip->dev;
	281	unsigned char tmp[2], *data;
67c10366	282	int nr_triplets, data_size, ret = 0;
06ffc1eb	283	int clock = snd_usb_clock_find_source(chip, fp->clock, false);
e5779998	284
d07140ba DM	285	if (clock < 0) {
	286	snd_printk(KERN_ERR "%s(): unable to find clock source (clock %d)\n",
	287	__func__, clock);
	288	goto err;
	289	}
	290
e5779998 DM	291	/* get the number of sample rates first by only fetching 2 bytes */
	292	ret = snd_usb_ctl_msg(dev, usb_rcvctrlpipe(dev, 0), UAC2_CS_RANGE,
	293	USB_TYPE_CLASS \| USB_RECIP_INTERFACE \| USB_DIR_IN,
11bcbc44 DM	294	UAC2_CS_CONTROL_SAM_FREQ << 8,
11bcbc44 DM	295	snd_usb_ctrl_intf(chip) \| (clock << 8),
17d900c4	296	tmp, sizeof(tmp));
e5779998 DM	297
e5779998 DM	298	if (ret < 0) {
79f920fb DM	299	snd_printk(KERN_ERR "%s(): unable to retrieve number of sample rates (clock %d)\n",
79f920fb DM	300	__func__, clock);
e5779998 DM	301	goto err;
	302	}
	303
67c10366 DM	304	nr_triplets = (tmp[1] << 8) \| tmp[0];
67c10366 DM	305	data_size = 2 + 12 * nr_triplets;
e5779998 DM	306	data = kzalloc(data_size, GFP_KERNEL);
	307	if (!data) {
	308	ret = -ENOMEM;
	309	goto err;
	310	}
	311
	312	/* now get the full information */
	313	ret = snd_usb_ctl_msg(dev, usb_rcvctrlpipe(dev, 0), UAC2_CS_RANGE,
79f920fb	314	USB_TYPE_CLASS \| USB_RECIP_INTERFACE \| USB_DIR_IN,
11bcbc44 DM	315	UAC2_CS_CONTROL_SAM_FREQ << 8,
11bcbc44 DM	316	snd_usb_ctrl_intf(chip) \| (clock << 8),
17d900c4	317	data, data_size);
e5779998 DM	318
e5779998 DM	319	if (ret < 0) {
79f920fb DM	320	snd_printk(KERN_ERR "%s(): unable to retrieve sample rate range (clock %d)\n",
79f920fb DM	321	__func__, clock);
e5779998 DM	322	ret = -EINVAL;
	323	goto err_free;
	324	}
	325
67c10366 DM	326	/* Call the triplet parser, and make sure fp->rate_table is NULL.
	327	* We just use the return value to know how many sample rates we
	328	* will have to deal with. */
	329	kfree(fp->rate_table);
	330	fp->rate_table = NULL;
	331	fp->nr_rates = parse_uac2_sample_rate_range(fp, nr_triplets, data);
	332
	333	if (fp->nr_rates == 0) {
	334	/* SNDRV_PCM_RATE_CONTINUOUS */
	335	ret = 0;
	336	goto err_free;
	337	}
	338
	339	fp->rate_table = kmalloc(sizeof(int) * fp->nr_rates, GFP_KERNEL);
e5779998 DM	340	if (!fp->rate_table) {
	341	ret = -ENOMEM;
	342	goto err_free;
	343	}
	344
67c10366 DM	345	/* Call the triplet parser again, but this time, fp->rate_table is
	346	* allocated, so the rates will be stored */
	347	parse_uac2_sample_rate_range(fp, nr_triplets, data);
e5779998 DM	348
	349	err_free:
	350	kfree(data);
	351	err:
	352	return ret;
	353	}
	354
	355	/*
	356	* parse the format type I and III descriptors
	357	*/
	358	static int parse_audio_format_i(struct snd_usb_audio *chip,
2fcdb06d	359	struct audioformat *fp, unsigned int format,
74754f97	360	struct uac_format_type_i_continuous_descriptor *fmt,
e5779998 DM	361	struct usb_host_interface *iface)
	362	{
	363	struct usb_interface_descriptor *altsd = get_iface_desc(iface);
e5779998 DM	364	int protocol = altsd->bInterfaceProtocol;
	365	int pcm_format, ret;
	366
	367	if (fmt->bFormatType == UAC_FORMAT_TYPE_III) {
	368	/* FIXME: the format type is really IECxxx
	369	* but we give normal PCM format to get the existing
	370	* apps working...
	371	*/
	372	switch (chip->usb_id) {
	373
	374	case USB_ID(0x0763, 0x2003): /* M-Audio Audiophile USB */
	375	if (chip->setup == 0x00 &&
	376	fp->altsetting == 6)
	377	pcm_format = SNDRV_PCM_FORMAT_S16_BE;
	378	else
	379	pcm_format = SNDRV_PCM_FORMAT_S16_LE;
	380	break;
	381	default:
	382	pcm_format = SNDRV_PCM_FORMAT_S16_LE;
	383	}
29088fef	384	fp->formats = 1uLL << pcm_format;
e5779998	385	} else {
29088fef CL	386	fp->formats = parse_audio_format_i_type(chip, fp, format,
	387	fmt, protocol);
	388	if (!fp->formats)
8ad10dc6	389	return -EINVAL;
e5779998 DM	390	}
e5779998 DM	391
e5779998 DM	392	/* gather possible sample rates */
	393	/* audio class v1 reports possible sample rates as part of the
	394	* proprietary class specific descriptor.
	395	* audio class v2 uses class specific EP0 range requests for that.
	396	*/
	397	switch (protocol) {
a2acad82 CL	398	default:
	399	snd_printdd(KERN_WARNING "%d:%u:%d : invalid protocol version %d, assuming v1\n",
	400	chip->dev->devnum, fp->iface, fp->altsetting, protocol);
	401	/* fall through */
e5779998 DM	402	case UAC_VERSION_1:
e5779998 DM	403	fp->channels = fmt->bNrChannels;
74754f97	404	ret = parse_audio_format_rates_v1(chip, fp, (unsigned char *) fmt, 7);
e5779998 DM	405	break;
	406	case UAC_VERSION_2:
	407	/* fp->channels is already set in this case */
3d8d4dcf	408	ret = parse_audio_format_rates_v2(chip, fp);
e5779998 DM	409	break;
	410	}
	411
	412	if (fp->channels < 1) {
	413	snd_printk(KERN_ERR "%d:%u:%d : invalid channels %d\n",
	414	chip->dev->devnum, fp->iface, fp->altsetting, fp->channels);
8ad10dc6	415	return -EINVAL;
e5779998 DM	416	}
	417
	418	return ret;
	419	}
	420
	421	/*
	422	* parse the format type II descriptor
	423	*/
	424	static int parse_audio_format_ii(struct snd_usb_audio *chip,
	425	struct audioformat *fp,
	426	int format, void *_fmt,
	427	struct usb_host_interface *iface)
	428	{
	429	int brate, framesize, ret;
	430	struct usb_interface_descriptor *altsd = get_iface_desc(iface);
	431	int protocol = altsd->bInterfaceProtocol;
	432
	433	switch (format) {
	434	case UAC_FORMAT_TYPE_II_AC3:
	435	/* FIXME: there is no AC3 format defined yet */
015eb0b0 CL	436	// fp->formats = SNDRV_PCM_FMTBIT_AC3;
015eb0b0 CL	437	fp->formats = SNDRV_PCM_FMTBIT_U8; /* temporary hack to receive byte streams */
e5779998 DM	438	break;
e5779998 DM	439	case UAC_FORMAT_TYPE_II_MPEG:
015eb0b0	440	fp->formats = SNDRV_PCM_FMTBIT_MPEG;
e5779998 DM	441	break;
	442	default:
	443	snd_printd(KERN_INFO "%d:%u:%d : unknown format tag %#x is detected. processed as MPEG.\n",
	444	chip->dev->devnum, fp->iface, fp->altsetting, format);
015eb0b0	445	fp->formats = SNDRV_PCM_FMTBIT_MPEG;
e5779998 DM	446	break;
	447	}
	448
	449	fp->channels = 1;
	450
	451	switch (protocol) {
a2acad82 CL	452	default:
	453	snd_printdd(KERN_WARNING "%d:%u:%d : invalid protocol version %d, assuming v1\n",
	454	chip->dev->devnum, fp->iface, fp->altsetting, protocol);
	455	/* fall through */
e5779998 DM	456	case UAC_VERSION_1: {
	457	struct uac_format_type_ii_discrete_descriptor *fmt = _fmt;
	458	brate = le16_to_cpu(fmt->wMaxBitRate);
	459	framesize = le16_to_cpu(fmt->wSamplesPerFrame);
	460	snd_printd(KERN_INFO "found format II with max.bitrate = %d, frame size=%d\n", brate, framesize);
	461	fp->frame_size = framesize;
	462	ret = parse_audio_format_rates_v1(chip, fp, _fmt, 8); /* fmt[8..] sample rates */
	463	break;
	464	}
	465	case UAC_VERSION_2: {
	466	struct uac_format_type_ii_ext_descriptor *fmt = _fmt;
	467	brate = le16_to_cpu(fmt->wMaxBitRate);
	468	framesize = le16_to_cpu(fmt->wSamplesPerFrame);
	469	snd_printd(KERN_INFO "found format II with max.bitrate = %d, frame size=%d\n", brate, framesize);
	470	fp->frame_size = framesize;
3d8d4dcf	471	ret = parse_audio_format_rates_v2(chip, fp);
e5779998 DM	472	break;
	473	}
	474	}
	475
	476	return ret;
	477	}
	478
2fcdb06d DM	479	int snd_usb_parse_audio_format(struct snd_usb_audio *chip,
	480	struct audioformat *fp, unsigned int format,
	481	struct uac_format_type_i_continuous_descriptor *fmt,
74754f97	482	int stream, struct usb_host_interface *iface)
e5779998 DM	483	{
	484	int err;
	485
74754f97	486	switch (fmt->bFormatType) {
e5779998 DM	487	case UAC_FORMAT_TYPE_I:
	488	case UAC_FORMAT_TYPE_III:
	489	err = parse_audio_format_i(chip, fp, format, fmt, iface);
	490	break;
	491	case UAC_FORMAT_TYPE_II:
	492	err = parse_audio_format_ii(chip, fp, format, fmt, iface);
	493	break;
	494	default:
	495	snd_printd(KERN_INFO "%d:%u:%d : format type %d is not supported yet\n",
74754f97 DM	496	chip->dev->devnum, fp->iface, fp->altsetting,
74754f97 DM	497	fmt->bFormatType);
8d091242	498	return -ENOTSUPP;
e5779998	499	}
74754f97	500	fp->fmt_type = fmt->bFormatType;
e5779998 DM	501	if (err < 0)
	502	return err;
	503	#if 1
	504	/* FIXME: temporary hack for extigy/audigy 2 nx/zs */
	505	/* extigy apparently supports sample rates other than 48k
	506	* but not in ordinary way. so we enable only 48k atm.
	507	*/
	508	if (chip->usb_id == USB_ID(0x041e, 0x3000) \|\|
	509	chip->usb_id == USB_ID(0x041e, 0x3020) \|\|
	510	chip->usb_id == USB_ID(0x041e, 0x3061)) {
74754f97	511	if (fmt->bFormatType == UAC_FORMAT_TYPE_I &&
e5779998 DM	512	fp->rates != SNDRV_PCM_RATE_48000 &&
e5779998 DM	513	fp->rates != SNDRV_PCM_RATE_96000)
8d091242	514	return -ENOTSUPP;
e5779998 DM	515	}
	516	#endif
	517	return 0;
	518	}
	519