Linux Audio

Check our new training course

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