[net-next-2.6.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
 *
 */

int snd_pcm_hw_param_first(struct snd_pcm_substream *pcm, 
			   struct snd_pcm_hw_params *params,
			   snd_pcm_hw_param_t var, int *dir);
int snd_pcm_hw_param_last(struct snd_pcm_substream *pcm, 
			  struct snd_pcm_hw_params *params,
			  snd_pcm_hw_param_t var, int *dir);
int snd_pcm_hw_param_value(const struct snd_pcm_hw_params *params,
			   snd_pcm_hw_param_t var, 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
e88e8ae6 TI	25	int snd_pcm_hw_param_first(struct snd_pcm_substream *pcm,
	26	struct snd_pcm_hw_params *params,
	27	snd_pcm_hw_param_t var, int *dir);
	28	int snd_pcm_hw_param_last(struct snd_pcm_substream *pcm,
	29	struct snd_pcm_hw_params *params,
	30	snd_pcm_hw_param_t var, int *dir);
	31	int snd_pcm_hw_param_value(const struct snd_pcm_hw_params *params,
	32	snd_pcm_hw_param_t var, int *dir);
1da177e4	33
1da177e4 LT	34	#define SNDRV_MASK_BITS 64 /* we use so far 64bits only */
	35	#define SNDRV_MASK_SIZE (SNDRV_MASK_BITS / 32)
	36	#define MASK_OFS(i) ((i) >> 5)
	37	#define MASK_BIT(i) (1U << ((i) & 31))
	38
9bb22e21	39	static inline unsigned int ld2(u_int32_t v)
1da177e4 LT	40	{
	41	unsigned r = 0;
	42
	43	if (v >= 0x10000) {
	44	v >>= 16;
	45	r += 16;
	46	}
	47	if (v >= 0x100) {
	48	v >>= 8;
	49	r += 8;
	50	}
	51	if (v >= 0x10) {
	52	v >>= 4;
	53	r += 4;
	54	}
	55	if (v >= 4) {
	56	v >>= 2;
	57	r += 2;
	58	}
	59	if (v >= 2)
	60	r++;
	61	return r;
	62	}
	63
9bb22e21	64	static inline size_t snd_mask_sizeof(void)
1da177e4	65	{
877211f5	66	return sizeof(struct snd_mask);
1da177e4 LT	67	}
1da177e4 LT	68
9bb22e21	69	static inline void snd_mask_none(struct snd_mask *mask)
1da177e4 LT	70	{
	71	memset(mask, 0, sizeof(*mask));
	72	}
	73
9bb22e21	74	static inline void snd_mask_any(struct snd_mask *mask)
1da177e4 LT	75	{
	76	memset(mask, 0xff, SNDRV_MASK_SIZE * sizeof(u_int32_t));
	77	}
	78
9bb22e21	79	static inline int snd_mask_empty(const struct snd_mask *mask)
1da177e4 LT	80	{
	81	int i;
	82	for (i = 0; i < SNDRV_MASK_SIZE; i++)
	83	if (mask->bits[i])
	84	return 0;
	85	return 1;
	86	}
	87
9bb22e21	88	static inline unsigned int snd_mask_min(const struct snd_mask *mask)
1da177e4 LT	89	{
1da177e4 LT	90	int i;
1da177e4 LT	91	for (i = 0; i < SNDRV_MASK_SIZE; i++) {
	92	if (mask->bits[i])
	93	return ffs(mask->bits[i]) - 1 + (i << 5);
	94	}
	95	return 0;
	96	}
	97
9bb22e21	98	static inline unsigned int snd_mask_max(const struct snd_mask *mask)
1da177e4 LT	99	{
1da177e4 LT	100	int i;
1da177e4 LT	101	for (i = SNDRV_MASK_SIZE - 1; i >= 0; i--) {
	102	if (mask->bits[i])
	103	return ld2(mask->bits[i]) + (i << 5);
	104	}
	105	return 0;
	106	}
	107
9bb22e21	108	static inline void snd_mask_set(struct snd_mask *mask, unsigned int val)
1da177e4	109	{
1da177e4 LT	110	mask->bits[MASK_OFS(val)] \|= MASK_BIT(val);
	111	}
	112
9bb22e21	113	static inline void snd_mask_reset(struct snd_mask *mask, unsigned int val)
1da177e4	114	{
1da177e4 LT	115	mask->bits[MASK_OFS(val)] &= ~MASK_BIT(val);
	116	}
	117
9bb22e21 TI	118	static inline void snd_mask_set_range(struct snd_mask *mask,
9bb22e21 TI	119	unsigned int from, unsigned int to)
1da177e4 LT	120	{
1da177e4 LT	121	unsigned int i;
1da177e4 LT	122	for (i = from; i <= to; i++)
	123	mask->bits[MASK_OFS(i)] \|= MASK_BIT(i);
	124	}
	125
9bb22e21 TI	126	static inline void snd_mask_reset_range(struct snd_mask *mask,
9bb22e21 TI	127	unsigned int from, unsigned int to)
1da177e4 LT	128	{
1da177e4 LT	129	unsigned int i;
1da177e4 LT	130	for (i = from; i <= to; i++)
	131	mask->bits[MASK_OFS(i)] &= ~MASK_BIT(i);
	132	}
	133
9bb22e21	134	static inline void snd_mask_leave(struct snd_mask *mask, unsigned int val)
1da177e4 LT	135	{
1da177e4 LT	136	unsigned int v;
1da177e4 LT	137	v = mask->bits[MASK_OFS(val)] & MASK_BIT(val);
	138	snd_mask_none(mask);
	139	mask->bits[MASK_OFS(val)] = v;
	140	}
	141
9bb22e21 TI	142	static inline void snd_mask_intersect(struct snd_mask *mask,
9bb22e21 TI	143	const struct snd_mask *v)
1da177e4 LT	144	{
	145	int i;
	146	for (i = 0; i < SNDRV_MASK_SIZE; i++)
	147	mask->bits[i] &= v->bits[i];
	148	}
	149
9bb22e21 TI	150	static inline int snd_mask_eq(const struct snd_mask *mask,
9bb22e21 TI	151	const struct snd_mask *v)
1da177e4 LT	152	{
	153	return ! memcmp(mask, v, SNDRV_MASK_SIZE * sizeof(u_int32_t));
	154	}
	155
9bb22e21 TI	156	static inline void snd_mask_copy(struct snd_mask *mask,
9bb22e21 TI	157	const struct snd_mask *v)
1da177e4 LT	158	{
	159	mask = v;
	160	}
	161
9bb22e21	162	static inline int snd_mask_test(const struct snd_mask *mask, unsigned int val)
1da177e4	163	{
1da177e4 LT	164	return mask->bits[MASK_OFS(val)] & MASK_BIT(val);
	165	}
	166
9bb22e21	167	static inline int snd_mask_single(const struct snd_mask *mask)
1da177e4 LT	168	{
1da177e4 LT	169	int i, c = 0;
1da177e4 LT	170	for (i = 0; i < SNDRV_MASK_SIZE; i++) {
	171	if (! mask->bits[i])
	172	continue;
	173	if (mask->bits[i] & (mask->bits[i] - 1))
	174	return 0;
	175	if (c)
	176	return 0;
	177	c++;
	178	}
	179	return 1;
	180	}
	181
9bb22e21 TI	182	static inline int snd_mask_refine(struct snd_mask *mask,
9bb22e21 TI	183	const struct snd_mask *v)
1da177e4	184	{
877211f5	185	struct snd_mask old;
1da177e4 LT	186	snd_mask_copy(&old, mask);
	187	snd_mask_intersect(mask, v);
	188	if (snd_mask_empty(mask))
	189	return -EINVAL;
	190	return !snd_mask_eq(mask, &old);
	191	}
	192
9bb22e21	193	static inline int snd_mask_refine_first(struct snd_mask *mask)
1da177e4	194	{
1da177e4 LT	195	if (snd_mask_single(mask))
	196	return 0;
	197	snd_mask_leave(mask, snd_mask_min(mask));
	198	return 1;
	199	}
	200
9bb22e21	201	static inline int snd_mask_refine_last(struct snd_mask *mask)
1da177e4	202	{
1da177e4 LT	203	if (snd_mask_single(mask))
	204	return 0;
	205	snd_mask_leave(mask, snd_mask_max(mask));
	206	return 1;
	207	}
	208
9bb22e21	209	static inline int snd_mask_refine_min(struct snd_mask *mask, unsigned int val)
1da177e4	210	{
1da177e4 LT	211	if (snd_mask_min(mask) >= val)
	212	return 0;
	213	snd_mask_reset_range(mask, 0, val - 1);
	214	if (snd_mask_empty(mask))
	215	return -EINVAL;
	216	return 1;
	217	}
	218
9bb22e21	219	static inline int snd_mask_refine_max(struct snd_mask *mask, unsigned int val)
1da177e4	220	{
1da177e4 LT	221	if (snd_mask_max(mask) <= val)
	222	return 0;
	223	snd_mask_reset_range(mask, val + 1, SNDRV_MASK_BITS);
	224	if (snd_mask_empty(mask))
	225	return -EINVAL;
	226	return 1;
	227	}
	228
9bb22e21	229	static inline int snd_mask_refine_set(struct snd_mask *mask, unsigned int val)
1da177e4 LT	230	{
1da177e4 LT	231	int changed;
1da177e4 LT	232	changed = !snd_mask_single(mask);
	233	snd_mask_leave(mask, val);
	234	if (snd_mask_empty(mask))
	235	return -EINVAL;
	236	return changed;
	237	}
	238
9bb22e21	239	static inline int snd_mask_value(const struct snd_mask *mask)
1da177e4	240	{
1da177e4 LT	241	return snd_mask_min(mask);
	242	}
	243
9bb22e21	244	static inline void snd_interval_any(struct snd_interval *i)
1da177e4 LT	245	{
	246	i->min = 0;
	247	i->openmin = 0;
	248	i->max = UINT_MAX;
	249	i->openmax = 0;
	250	i->integer = 0;
	251	i->empty = 0;
	252	}
	253
9bb22e21	254	static inline void snd_interval_none(struct snd_interval *i)
1da177e4 LT	255	{
	256	i->empty = 1;
	257	}
	258
9bb22e21	259	static inline int snd_interval_checkempty(const struct snd_interval *i)
1da177e4 LT	260	{
	261	return (i->min > i->max \|\|
	262	(i->min == i->max && (i->openmin \|\| i->openmax)));
	263	}
	264
9bb22e21	265	static inline int snd_interval_empty(const struct snd_interval *i)
1da177e4 LT	266	{
	267	return i->empty;
	268	}
	269
9bb22e21	270	static inline int snd_interval_single(const struct snd_interval *i)
1da177e4	271	{
1da177e4 LT	272	return (i->min == i->max \|\|
	273	(i->min + 1 == i->max && i->openmax));
	274	}
	275
9bb22e21	276	static inline int snd_interval_value(const struct snd_interval *i)
1da177e4	277	{
1da177e4 LT	278	return i->min;
	279	}
	280
9bb22e21	281	static inline int snd_interval_min(const struct snd_interval *i)
1da177e4	282	{
1da177e4 LT	283	return i->min;
	284	}
	285
9bb22e21	286	static inline int snd_interval_max(const struct snd_interval *i)
1da177e4 LT	287	{
1da177e4 LT	288	unsigned int v;
1da177e4 LT	289	v = i->max;
	290	if (i->openmax)
	291	v--;
	292	return v;
	293	}
	294
9bb22e21	295	static inline int snd_interval_test(const struct snd_interval *i, unsigned int val)
1da177e4 LT	296	{
	297	return !((i->min > val \|\| (i->min == val && i->openmin) \|\|
	298	i->max < val \|\| (i->max == val && i->openmax)));
	299	}
	300
9bb22e21	301	static inline void snd_interval_copy(struct snd_interval d, const struct snd_interval s)
1da177e4 LT	302	{
	303	d = s;
	304	}
	305
9bb22e21	306	static inline int snd_interval_setinteger(struct snd_interval *i)
1da177e4 LT	307	{
	308	if (i->integer)
	309	return 0;
	310	if (i->openmin && i->openmax && i->min == i->max)
	311	return -EINVAL;
	312	i->integer = 1;
	313	return 1;
	314	}
	315
9bb22e21	316	static inline int snd_interval_eq(const struct snd_interval i1, const struct snd_interval i2)
1da177e4 LT	317	{
	318	if (i1->empty)
	319	return i2->empty;
	320	if (i2->empty)
	321	return i1->empty;
	322	return i1->min == i2->min && i1->openmin == i2->openmin &&
	323	i1->max == i2->max && i1->openmax == i2->openmax;
	324	}
	325
	326	static inline unsigned int add(unsigned int a, unsigned int b)
	327	{
	328	if (a >= UINT_MAX - b)
	329	return UINT_MAX;
	330	return a + b;
	331	}
	332
	333	static inline unsigned int sub(unsigned int a, unsigned int b)
	334	{
	335	if (a > b)
	336	return a - b;
	337	return 0;
	338	}
	339
1da177e4 LT	340	#endif /* __SOUND_PCM_PARAMS_H */
1da177e4 LT	341