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