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 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); 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 41 static inline size_t snd_mask_sizeof(void) 42 { 43 return sizeof(struct snd_mask); 44 } 45 46 static inline void snd_mask_none(struct snd_mask *mask) 47 { 48 memset(mask, 0, sizeof(*mask)); 49 } 50 51 static inline void snd_mask_any(struct snd_mask *mask) 52 { 53 memset(mask, 0xff, SNDRV_MASK_SIZE * sizeof(u_int32_t)); 54 } 55 56 static 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 65 static 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 75 static 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 85 static inline void snd_mask_set(struct snd_mask *mask, unsigned int val) 86 { 87 mask->bits[MASK_OFS(val)] |= MASK_BIT(val); 88 } 89 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 97 static inline void snd_mask_reset(struct snd_mask *mask, unsigned int val) 98 { 99 mask->bits[MASK_OFS(val)] &= ~MASK_BIT(val); 100 } 101 102 static inline void snd_mask_set_range(struct snd_mask *mask, 103 unsigned int from, unsigned int to) 104 { 105 unsigned int i; 106 for (i = from; i <= to; i++) 107 mask->bits[MASK_OFS(i)] |= MASK_BIT(i); 108 } 109 110 static inline void snd_mask_reset_range(struct snd_mask *mask, 111 unsigned int from, unsigned int to) 112 { 113 unsigned int i; 114 for (i = from; i <= to; i++) 115 mask->bits[MASK_OFS(i)] &= ~MASK_BIT(i); 116 } 117 118 static inline void snd_mask_leave(struct snd_mask *mask, unsigned int val) 119 { 120 unsigned int v; 121 v = mask->bits[MASK_OFS(val)] & MASK_BIT(val); 122 snd_mask_none(mask); 123 mask->bits[MASK_OFS(val)] = v; 124 } 125 126 static inline void snd_mask_intersect(struct snd_mask *mask, 127 const struct snd_mask *v) 128 { 129 int i; 130 for (i = 0; i < SNDRV_MASK_SIZE; i++) 131 mask->bits[i] &= v->bits[i]; 132 } 133 134 static inline int snd_mask_eq(const struct snd_mask *mask, 135 const struct snd_mask *v) 136 { 137 return ! memcmp(mask, v, SNDRV_MASK_SIZE * sizeof(u_int32_t)); 138 } 139 140 static inline void snd_mask_copy(struct snd_mask *mask, 141 const struct snd_mask *v) 142 { 143 *mask = *v; 144 } 145 146 static inline int snd_mask_test(const struct snd_mask *mask, unsigned int val) 147 { 148 return mask->bits[MASK_OFS(val)] & MASK_BIT(val); 149 } 150 151 static inline int snd_mask_single(const struct snd_mask *mask) 152 { 153 int i, c = 0; 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 166 static inline int snd_mask_refine(struct snd_mask *mask, 167 const struct snd_mask *v) 168 { 169 struct snd_mask old; 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 177 static inline int snd_mask_refine_first(struct snd_mask *mask) 178 { 179 if (snd_mask_single(mask)) 180 return 0; 181 snd_mask_leave(mask, snd_mask_min(mask)); 182 return 1; 183 } 184 185 static inline int snd_mask_refine_last(struct snd_mask *mask) 186 { 187 if (snd_mask_single(mask)) 188 return 0; 189 snd_mask_leave(mask, snd_mask_max(mask)); 190 return 1; 191 } 192 193 static inline int snd_mask_refine_min(struct snd_mask *mask, unsigned int val) 194 { 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 203 static inline int snd_mask_refine_max(struct snd_mask *mask, unsigned int val) 204 { 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 213 static inline int snd_mask_refine_set(struct snd_mask *mask, unsigned int val) 214 { 215 int changed; 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 223 static inline int snd_mask_value(const struct snd_mask *mask) 224 { 225 return snd_mask_min(mask); 226 } 227 228 static inline void snd_interval_any(struct snd_interval *i) 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 238 static inline void snd_interval_none(struct snd_interval *i) 239 { 240 i->empty = 1; 241 } 242 243 static inline int snd_interval_checkempty(const struct snd_interval *i) 244 { 245 return (i->min > i->max || 246 (i->min == i->max && (i->openmin || i->openmax))); 247 } 248 249 static inline int snd_interval_empty(const struct snd_interval *i) 250 { 251 return i->empty; 252 } 253 254 static inline int snd_interval_single(const struct snd_interval *i) 255 { 256 return (i->min == i->max || 257 (i->min + 1 == i->max && i->openmax)); 258 } 259 260 static inline int snd_interval_value(const struct snd_interval *i) 261 { 262 return i->min; 263 } 264 265 static inline int snd_interval_min(const struct snd_interval *i) 266 { 267 return i->min; 268 } 269 270 static inline int snd_interval_max(const struct snd_interval *i) 271 { 272 unsigned int v; 273 v = i->max; 274 if (i->openmax) 275 v--; 276 return v; 277 } 278 279 static inline int snd_interval_test(const struct snd_interval *i, unsigned int val) 280 { 281 return !((i->min > val || (i->min == val && i->openmin) || 282 i->max < val || (i->max == val && i->openmax))); 283 } 284 285 static inline void snd_interval_copy(struct snd_interval *d, const struct snd_interval *s) 286 { 287 *d = *s; 288 } 289 290 static inline int snd_interval_setinteger(struct snd_interval *i) 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 300 static inline int snd_interval_eq(const struct snd_interval *i1, const struct snd_interval *i2) 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 310 /** 311 * params_access - get the access type from the hw params 312 * @p: hw params 313 */ 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 320 /** 321 * params_format - get the sample format from the hw params 322 * @p: hw params 323 */ 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 330 /** 331 * params_subformat - get the sample subformat from the hw params 332 * @p: hw params 333 */ 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 } 340 341 /** 342 * params_period_bytes - get the period size (in bytes) from the hw params 343 * @p: hw params 344 */ 345 static inline unsigned int 346 params_period_bytes(const struct snd_pcm_hw_params *p) 347 { 348 return hw_param_interval_c(p, SNDRV_PCM_HW_PARAM_PERIOD_BYTES)->min; 349 } 350 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) 359 { 360 return snd_pcm_format_width(params_format(p)); 361 } 362 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) 372 { 373 return snd_pcm_format_physical_width(params_format(p)); 374 } 375 376 static inline void 377 params_set_format(struct snd_pcm_hw_params *p, snd_pcm_format_t fmt) 378 { 379 snd_mask_set_format(hw_param_mask(p, SNDRV_PCM_HW_PARAM_FORMAT), fmt); 380 } 381 382 #endif /* __SOUND_PCM_PARAMS_H */ 383