[linux-2.6-block.git] / include / sound / pcm_params.h

#ifndef __SOUND_PCM_PARAMS_H
#define __SOUND_PCM_PARAMS_H

/*
 *  PCM params helpers
 *  Copyright (c) by Abramo Bagnara <abramo@alsa-project.org>
 *
 *
 *   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
 *
 */

extern int snd_pcm_hw_param_mask(struct snd_pcm_substream *pcm, struct snd_pcm_hw_params *params,
				 snd_pcm_hw_param_t var, const struct snd_mask *val);
extern unsigned int snd_pcm_hw_param_value_min(const struct snd_pcm_hw_params *params,
					       snd_pcm_hw_param_t var, int *dir);
extern unsigned int snd_pcm_hw_param_value_max(const struct snd_pcm_hw_params *params,
					       snd_pcm_hw_param_t var, int *dir);
extern int _snd_pcm_hw_param_min(struct snd_pcm_hw_params *params,
				 snd_pcm_hw_param_t var, unsigned int val, int dir);
extern int _snd_pcm_hw_param_setinteger(struct snd_pcm_hw_params *params,
					snd_pcm_hw_param_t var);
extern int _snd_pcm_hw_param_set(struct snd_pcm_hw_params *params,
				 snd_pcm_hw_param_t var, unsigned int val, int dir);

#define SNDRV_MASK_BITS	64	/* we use so far 64bits only */
#define SNDRV_MASK_SIZE	(SNDRV_MASK_BITS / 32)
#define MASK_OFS(i)	((i) >> 5)
#define MASK_BIT(i)	(1U << ((i) & 31))

static inline unsigned int ld2(u_int32_t v)
{
        unsigned r = 0;

        if (v >= 0x10000) {
                v >>= 16;
                r += 16;
        }
        if (v >= 0x100) {
                v >>= 8;
                r += 8;
        }
        if (v >= 0x10) {
                v >>= 4;
                r += 4;
        }
        if (v >= 4) {
                v >>= 2;
                r += 2;
        }
        if (v >= 2)
                r++;
        return r;
}

static inline size_t snd_mask_sizeof(void)
{
	return sizeof(struct snd_mask);
}

static inline void snd_mask_none(struct snd_mask *mask)
{
	memset(mask, 0, sizeof(*mask));
}

static inline void snd_mask_any(struct snd_mask *mask)
{
	memset(mask, 0xff, SNDRV_MASK_SIZE * sizeof(u_int32_t));
}

static inline int snd_mask_empty(const struct snd_mask *mask)
{
	int i;
	for (i = 0; i < SNDRV_MASK_SIZE; i++)
		if (mask->bits[i])
			return 0;
	return 1;
}

static inline unsigned int snd_mask_min(const struct snd_mask *mask)
{
	int i;
	for (i = 0; i < SNDRV_MASK_SIZE; i++) {
		if (mask->bits[i])
			return ffs(mask->bits[i]) - 1 + (i << 5);
	}
	return 0;
}

static inline unsigned int snd_mask_max(const struct snd_mask *mask)
{
	int i;
	for (i = SNDRV_MASK_SIZE - 1; i >= 0; i--) {
		if (mask->bits[i])
			return ld2(mask->bits[i]) + (i << 5);
	}
	return 0;
}

static inline void snd_mask_set(struct snd_mask *mask, unsigned int val)
{
	mask->bits[MASK_OFS(val)] |= MASK_BIT(val);
}

static inline void snd_mask_reset(struct snd_mask *mask, unsigned int val)
{
	mask->bits[MASK_OFS(val)] &= ~MASK_BIT(val);
}

static inline void snd_mask_set_range(struct snd_mask *mask,
				      unsigned int from, unsigned int to)
{
	unsigned int i;
	for (i = from; i <= to; i++)
		mask->bits[MASK_OFS(i)] |= MASK_BIT(i);
}

static inline void snd_mask_reset_range(struct snd_mask *mask,
					unsigned int from, unsigned int to)
{
	unsigned int i;
	for (i = from; i <= to; i++)
		mask->bits[MASK_OFS(i)] &= ~MASK_BIT(i);
}

static inline void snd_mask_leave(struct snd_mask *mask, unsigned int val)
{
	unsigned int v;
	v = mask->bits[MASK_OFS(val)] & MASK_BIT(val);
	snd_mask_none(mask);
	mask->bits[MASK_OFS(val)] = v;
}

static inline void snd_mask_intersect(struct snd_mask *mask,
				      const struct snd_mask *v)
{
	int i;
	for (i = 0; i < SNDRV_MASK_SIZE; i++)
		mask->bits[i] &= v->bits[i];
}

static inline int snd_mask_eq(const struct snd_mask *mask,
			      const struct snd_mask *v)
{
	return ! memcmp(mask, v, SNDRV_MASK_SIZE * sizeof(u_int32_t));
}

static inline void snd_mask_copy(struct snd_mask *mask,
				 const struct snd_mask *v)
{
	*mask = *v;
}

static inline int snd_mask_test(const struct snd_mask *mask, unsigned int val)
{
	return mask->bits[MASK_OFS(val)] & MASK_BIT(val);
}

static inline int snd_mask_single(const struct snd_mask *mask)
{
	int i, c = 0;
	for (i = 0; i < SNDRV_MASK_SIZE; i++) {
		if (! mask->bits[i])
			continue;
		if (mask->bits[i] & (mask->bits[i] - 1))
			return 0;
		if (c)
			return 0;
		c++;
	}
	return 1;
}

static inline int snd_mask_refine(struct snd_mask *mask,
				  const struct snd_mask *v)
{
	struct snd_mask old;
	snd_mask_copy(&old, mask);
	snd_mask_intersect(mask, v);
	if (snd_mask_empty(mask))
		return -EINVAL;
	return !snd_mask_eq(mask, &old);
}

static inline int snd_mask_refine_first(struct snd_mask *mask)
{
	if (snd_mask_single(mask))
		return 0;
	snd_mask_leave(mask, snd_mask_min(mask));
	return 1;
}

static inline int snd_mask_refine_last(struct snd_mask *mask)
{
	if (snd_mask_single(mask))
		return 0;
	snd_mask_leave(mask, snd_mask_max(mask));
	return 1;
}

static inline int snd_mask_refine_min(struct snd_mask *mask, unsigned int val)
{
	if (snd_mask_min(mask) >= val)
		return 0;
	snd_mask_reset_range(mask, 0, val - 1);
	if (snd_mask_empty(mask))
		return -EINVAL;
	return 1;
}

static inline int snd_mask_refine_max(struct snd_mask *mask, unsigned int val)
{
	if (snd_mask_max(mask) <= val)
		return 0;
	snd_mask_reset_range(mask, val + 1, SNDRV_MASK_BITS);
	if (snd_mask_empty(mask))
		return -EINVAL;
	return 1;
}

static inline int snd_mask_refine_set(struct snd_mask *mask, unsigned int val)
{
	int changed;
	changed = !snd_mask_single(mask);
	snd_mask_leave(mask, val);
	if (snd_mask_empty(mask))
		return -EINVAL;
	return changed;
}

static inline int snd_mask_value(const struct snd_mask *mask)
{
	return snd_mask_min(mask);
}

static inline void snd_interval_any(struct snd_interval *i)
{
	i->min = 0;
	i->openmin = 0;
	i->max = UINT_MAX;
	i->openmax = 0;
	i->integer = 0;
	i->empty = 0;
}

static inline void snd_interval_none(struct snd_interval *i)
{
	i->empty = 1;
}

static inline int snd_interval_checkempty(const struct snd_interval *i)
{
	return (i->min > i->max ||
		(i->min == i->max && (i->openmin || i->openmax)));
}

static inline int snd_interval_empty(const struct snd_interval *i)
{
	return i->empty;
}

static inline int snd_interval_single(const struct snd_interval *i)
{
	return (i->min == i->max || 
		(i->min + 1 == i->max && i->openmax));
}

static inline int snd_interval_value(const struct snd_interval *i)
{
	return i->min;
}

static inline int snd_interval_min(const struct snd_interval *i)
{
	return i->min;
}

static inline int snd_interval_max(const struct snd_interval *i)
{
	unsigned int v;
	v = i->max;
	if (i->openmax)
		v--;
	return v;
}

static inline int snd_interval_test(const struct snd_interval *i, unsigned int val)
{
	return !((i->min > val || (i->min == val && i->openmin) ||
		  i->max < val || (i->max == val && i->openmax)));
}

static inline void snd_interval_copy(struct snd_interval *d, const struct snd_interval *s)
{
	*d = *s;
}

static inline int snd_interval_setinteger(struct snd_interval *i)
{
	if (i->integer)
		return 0;
	if (i->openmin && i->openmax && i->min == i->max)
		return -EINVAL;
	i->integer = 1;
	return 1;
}

static inline int snd_interval_eq(const struct snd_interval *i1, const struct snd_interval *i2)
{
	if (i1->empty)
		return i2->empty;
	if (i2->empty)
		return i1->empty;
	return i1->min == i2->min && i1->openmin == i2->openmin &&
		i1->max == i2->max && i1->openmax == i2->openmax;
}

static inline unsigned int add(unsigned int a, unsigned int b)
{
	if (a >= UINT_MAX - b)
		return UINT_MAX;
	return a + b;
}

static inline unsigned int sub(unsigned int a, unsigned int b)
{
	if (a > b)
		return a - b;
	return 0;
}

#endif /* __SOUND_PCM_PARAMS_H */
Commit	Line	Data
1da177e4 LT	1	#ifndef __SOUND_PCM_PARAMS_H
	2	#define __SOUND_PCM_PARAMS_H
	3
	4	/*
	5	* PCM params helpers
	6	* Copyright (c) by Abramo Bagnara <abramo@alsa-project.org>
	7	*
	8	*
	9	* This program is free software; you can redistribute it and/or modify
	10	* it under the terms of the GNU General Public License as published by
	11	* the Free Software Foundation; either version 2 of the License, or
	12	* (at your option) any later version.
	13	*
	14	* This program is distributed in the hope that it will be useful,
	15	* but WITHOUT ANY WARRANTY; without even the implied warranty of
	16	* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
	17	* GNU General Public License for more details.
	18	*
	19	* You should have received a copy of the GNU General Public License
	20	* along with this program; if not, write to the Free Software
	21	* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
	22	*
	23	*/
	24
877211f5 TI	25	extern int snd_pcm_hw_param_mask(struct snd_pcm_substream pcm, struct snd_pcm_hw_params params,
	26	snd_pcm_hw_param_t var, const struct snd_mask *val);
	27	extern unsigned int snd_pcm_hw_param_value_min(const struct snd_pcm_hw_params *params,
1da177e4	28	snd_pcm_hw_param_t var, int *dir);
877211f5	29	extern unsigned int snd_pcm_hw_param_value_max(const struct snd_pcm_hw_params *params,
1da177e4	30	snd_pcm_hw_param_t var, int *dir);
877211f5	31	extern int _snd_pcm_hw_param_min(struct snd_pcm_hw_params *params,
1da177e4	32	snd_pcm_hw_param_t var, unsigned int val, int dir);
877211f5	33	extern int _snd_pcm_hw_param_setinteger(struct snd_pcm_hw_params *params,
1da177e4	34	snd_pcm_hw_param_t var);
877211f5	35	extern int _snd_pcm_hw_param_set(struct snd_pcm_hw_params *params,
1da177e4 LT	36	snd_pcm_hw_param_t var, unsigned int val, int dir);
1da177e4 LT	37
1da177e4 LT	38	#define SNDRV_MASK_BITS 64 /* we use so far 64bits only */
	39	#define SNDRV_MASK_SIZE (SNDRV_MASK_BITS / 32)
	40	#define MASK_OFS(i) ((i) >> 5)
	41	#define MASK_BIT(i) (1U << ((i) & 31))
	42
9bb22e21	43	static inline unsigned int ld2(u_int32_t v)
1da177e4 LT	44	{
	45	unsigned r = 0;
	46
	47	if (v >= 0x10000) {
	48	v >>= 16;
	49	r += 16;
	50	}
	51	if (v >= 0x100) {
	52	v >>= 8;
	53	r += 8;
	54	}
	55	if (v >= 0x10) {
	56	v >>= 4;
	57	r += 4;
	58	}
	59	if (v >= 4) {
	60	v >>= 2;
	61	r += 2;
	62	}
	63	if (v >= 2)
	64	r++;
	65	return r;
	66	}
	67
9bb22e21	68	static inline size_t snd_mask_sizeof(void)
1da177e4	69	{
877211f5	70	return sizeof(struct snd_mask);
1da177e4 LT	71	}
1da177e4 LT	72
9bb22e21	73	static inline void snd_mask_none(struct snd_mask *mask)
1da177e4 LT	74	{
	75	memset(mask, 0, sizeof(*mask));
	76	}
	77
9bb22e21	78	static inline void snd_mask_any(struct snd_mask *mask)
1da177e4 LT	79	{
	80	memset(mask, 0xff, SNDRV_MASK_SIZE * sizeof(u_int32_t));
	81	}
	82
9bb22e21	83	static inline int snd_mask_empty(const struct snd_mask *mask)
1da177e4 LT	84	{
	85	int i;
	86	for (i = 0; i < SNDRV_MASK_SIZE; i++)
	87	if (mask->bits[i])
	88	return 0;
	89	return 1;
	90	}
	91
9bb22e21	92	static inline unsigned int snd_mask_min(const struct snd_mask *mask)
1da177e4 LT	93	{
1da177e4 LT	94	int i;
1da177e4 LT	95	for (i = 0; i < SNDRV_MASK_SIZE; i++) {
	96	if (mask->bits[i])
	97	return ffs(mask->bits[i]) - 1 + (i << 5);
	98	}
	99	return 0;
	100	}
	101
9bb22e21	102	static inline unsigned int snd_mask_max(const struct snd_mask *mask)
1da177e4 LT	103	{
1da177e4 LT	104	int i;
1da177e4 LT	105	for (i = SNDRV_MASK_SIZE - 1; i >= 0; i--) {
	106	if (mask->bits[i])
	107	return ld2(mask->bits[i]) + (i << 5);
	108	}
	109	return 0;
	110	}
	111
9bb22e21	112	static inline void snd_mask_set(struct snd_mask *mask, unsigned int val)
1da177e4	113	{
1da177e4 LT	114	mask->bits[MASK_OFS(val)] \|= MASK_BIT(val);
	115	}
	116
9bb22e21	117	static inline void snd_mask_reset(struct snd_mask *mask, unsigned int val)
1da177e4	118	{
1da177e4 LT	119	mask->bits[MASK_OFS(val)] &= ~MASK_BIT(val);
	120	}
	121
9bb22e21 TI	122	static inline void snd_mask_set_range(struct snd_mask *mask,
9bb22e21 TI	123	unsigned int from, unsigned int to)
1da177e4 LT	124	{
1da177e4 LT	125	unsigned int i;
1da177e4 LT	126	for (i = from; i <= to; i++)
	127	mask->bits[MASK_OFS(i)] \|= MASK_BIT(i);
	128	}
	129
9bb22e21 TI	130	static inline void snd_mask_reset_range(struct snd_mask *mask,
9bb22e21 TI	131	unsigned int from, unsigned int to)
1da177e4 LT	132	{
1da177e4 LT	133	unsigned int i;
1da177e4 LT	134	for (i = from; i <= to; i++)
	135	mask->bits[MASK_OFS(i)] &= ~MASK_BIT(i);
	136	}
	137
9bb22e21	138	static inline void snd_mask_leave(struct snd_mask *mask, unsigned int val)
1da177e4 LT	139	{
1da177e4 LT	140	unsigned int v;
1da177e4 LT	141	v = mask->bits[MASK_OFS(val)] & MASK_BIT(val);
	142	snd_mask_none(mask);
	143	mask->bits[MASK_OFS(val)] = v;
	144	}
	145
9bb22e21 TI	146	static inline void snd_mask_intersect(struct snd_mask *mask,
9bb22e21 TI	147	const struct snd_mask *v)
1da177e4 LT	148	{
	149	int i;
	150	for (i = 0; i < SNDRV_MASK_SIZE; i++)
	151	mask->bits[i] &= v->bits[i];
	152	}
	153
9bb22e21 TI	154	static inline int snd_mask_eq(const struct snd_mask *mask,
9bb22e21 TI	155	const struct snd_mask *v)
1da177e4 LT	156	{
	157	return ! memcmp(mask, v, SNDRV_MASK_SIZE * sizeof(u_int32_t));
	158	}
	159
9bb22e21 TI	160	static inline void snd_mask_copy(struct snd_mask *mask,
9bb22e21 TI	161	const struct snd_mask *v)
1da177e4 LT	162	{
	163	mask = v;
	164	}
	165
9bb22e21	166	static inline int snd_mask_test(const struct snd_mask *mask, unsigned int val)
1da177e4	167	{
1da177e4 LT	168	return mask->bits[MASK_OFS(val)] & MASK_BIT(val);
	169	}
	170
9bb22e21	171	static inline int snd_mask_single(const struct snd_mask *mask)
1da177e4 LT	172	{
1da177e4 LT	173	int i, c = 0;
1da177e4 LT	174	for (i = 0; i < SNDRV_MASK_SIZE; i++) {
	175	if (! mask->bits[i])
	176	continue;
	177	if (mask->bits[i] & (mask->bits[i] - 1))
	178	return 0;
	179	if (c)
	180	return 0;
	181	c++;
	182	}
	183	return 1;
	184	}
	185
9bb22e21 TI	186	static inline int snd_mask_refine(struct snd_mask *mask,
9bb22e21 TI	187	const struct snd_mask *v)
1da177e4	188	{
877211f5	189	struct snd_mask old;
1da177e4 LT	190	snd_mask_copy(&old, mask);
	191	snd_mask_intersect(mask, v);
	192	if (snd_mask_empty(mask))
	193	return -EINVAL;
	194	return !snd_mask_eq(mask, &old);
	195	}
	196
9bb22e21	197	static inline int snd_mask_refine_first(struct snd_mask *mask)
1da177e4	198	{
1da177e4 LT	199	if (snd_mask_single(mask))
	200	return 0;
	201	snd_mask_leave(mask, snd_mask_min(mask));
	202	return 1;
	203	}
	204
9bb22e21	205	static inline int snd_mask_refine_last(struct snd_mask *mask)
1da177e4	206	{
1da177e4 LT	207	if (snd_mask_single(mask))
	208	return 0;
	209	snd_mask_leave(mask, snd_mask_max(mask));
	210	return 1;
	211	}
	212
9bb22e21	213	static inline int snd_mask_refine_min(struct snd_mask *mask, unsigned int val)
1da177e4	214	{
1da177e4 LT	215	if (snd_mask_min(mask) >= val)
	216	return 0;
	217	snd_mask_reset_range(mask, 0, val - 1);
	218	if (snd_mask_empty(mask))
	219	return -EINVAL;
	220	return 1;
	221	}
	222
9bb22e21	223	static inline int snd_mask_refine_max(struct snd_mask *mask, unsigned int val)
1da177e4	224	{
1da177e4 LT	225	if (snd_mask_max(mask) <= val)
	226	return 0;
	227	snd_mask_reset_range(mask, val + 1, SNDRV_MASK_BITS);
	228	if (snd_mask_empty(mask))
	229	return -EINVAL;
	230	return 1;
	231	}
	232
9bb22e21	233	static inline int snd_mask_refine_set(struct snd_mask *mask, unsigned int val)
1da177e4 LT	234	{
1da177e4 LT	235	int changed;
1da177e4 LT	236	changed = !snd_mask_single(mask);
	237	snd_mask_leave(mask, val);
	238	if (snd_mask_empty(mask))
	239	return -EINVAL;
	240	return changed;
	241	}
	242
9bb22e21	243	static inline int snd_mask_value(const struct snd_mask *mask)
1da177e4	244	{
1da177e4 LT	245	return snd_mask_min(mask);
	246	}
	247
9bb22e21	248	static inline void snd_interval_any(struct snd_interval *i)
1da177e4 LT	249	{
	250	i->min = 0;
	251	i->openmin = 0;
	252	i->max = UINT_MAX;
	253	i->openmax = 0;
	254	i->integer = 0;
	255	i->empty = 0;
	256	}
	257
9bb22e21	258	static inline void snd_interval_none(struct snd_interval *i)
1da177e4 LT	259	{
	260	i->empty = 1;
	261	}
	262
9bb22e21	263	static inline int snd_interval_checkempty(const struct snd_interval *i)
1da177e4 LT	264	{
	265	return (i->min > i->max \|\|
	266	(i->min == i->max && (i->openmin \|\| i->openmax)));
	267	}
	268
9bb22e21	269	static inline int snd_interval_empty(const struct snd_interval *i)
1da177e4 LT	270	{
	271	return i->empty;
	272	}
	273
9bb22e21	274	static inline int snd_interval_single(const struct snd_interval *i)
1da177e4	275	{
1da177e4 LT	276	return (i->min == i->max \|\|
	277	(i->min + 1 == i->max && i->openmax));
	278	}
	279
9bb22e21	280	static inline int snd_interval_value(const struct snd_interval *i)
1da177e4	281	{
1da177e4 LT	282	return i->min;
	283	}
	284
9bb22e21	285	static inline int snd_interval_min(const struct snd_interval *i)
1da177e4	286	{
1da177e4 LT	287	return i->min;
	288	}
	289
9bb22e21	290	static inline int snd_interval_max(const struct snd_interval *i)
1da177e4 LT	291	{
1da177e4 LT	292	unsigned int v;
1da177e4 LT	293	v = i->max;
	294	if (i->openmax)
	295	v--;
	296	return v;
	297	}
	298
9bb22e21	299	static inline int snd_interval_test(const struct snd_interval *i, unsigned int val)
1da177e4 LT	300	{
	301	return !((i->min > val \|\| (i->min == val && i->openmin) \|\|
	302	i->max < val \|\| (i->max == val && i->openmax)));
	303	}
	304
9bb22e21	305	static inline void snd_interval_copy(struct snd_interval d, const struct snd_interval s)
1da177e4 LT	306	{
	307	d = s;
	308	}
	309
9bb22e21	310	static inline int snd_interval_setinteger(struct snd_interval *i)
1da177e4 LT	311	{
	312	if (i->integer)
	313	return 0;
	314	if (i->openmin && i->openmax && i->min == i->max)
	315	return -EINVAL;
	316	i->integer = 1;
	317	return 1;
	318	}
	319
9bb22e21	320	static inline int snd_interval_eq(const struct snd_interval i1, const struct snd_interval i2)
1da177e4 LT	321	{
	322	if (i1->empty)
	323	return i2->empty;
	324	if (i2->empty)
	325	return i1->empty;
	326	return i1->min == i2->min && i1->openmin == i2->openmin &&
	327	i1->max == i2->max && i1->openmax == i2->openmax;
	328	}
	329
	330	static inline unsigned int add(unsigned int a, unsigned int b)
	331	{
	332	if (a >= UINT_MAX - b)
	333	return UINT_MAX;
	334	return a + b;
	335	}
	336
	337	static inline unsigned int sub(unsigned int a, unsigned int b)
	338	{
	339	if (a > b)
	340	return a - b;
	341	return 0;
	342	}
	343
1da177e4 LT	344	#endif /* __SOUND_PCM_PARAMS_H */
1da177e4 LT	345