| 1 | #ifndef __SOUND_PCM_H
|
|---|
| 2 | #define __SOUND_PCM_H
|
|---|
| 3 |
|
|---|
| 4 | /*
|
|---|
| 5 | * Digital Audio (PCM) abstract layer
|
|---|
| 6 | * Copyright (c) by Jaroslav Kysela <perex@suse.cz>
|
|---|
| 7 | * Abramo Bagnara <abramo@alsa-project.org>
|
|---|
| 8 | *
|
|---|
| 9 | *
|
|---|
| 10 | * This program is free software; you can redistribute it and/or modify
|
|---|
| 11 | * it under the terms of the GNU General Public License as published by
|
|---|
| 12 | * the Free Software Foundation; either version 2 of the License, or
|
|---|
| 13 | * (at your option) any later version.
|
|---|
| 14 | *
|
|---|
| 15 | * This program is distributed in the hope that it will be useful,
|
|---|
| 16 | * but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|---|
| 17 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|---|
| 18 | * GNU General Public License for more details.
|
|---|
| 19 | *
|
|---|
| 20 | * You should have received a copy of the GNU General Public License
|
|---|
| 21 | * along with this program; if not, write to the Free Software
|
|---|
| 22 | * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
|
|---|
| 23 | *
|
|---|
| 24 | */
|
|---|
| 25 |
|
|---|
| 26 | #include <sound/asound.h>
|
|---|
| 27 | #include <sound/memalloc.h>
|
|---|
| 28 | #include <linux/poll.h>
|
|---|
| 29 | #include <linux/bitops.h>
|
|---|
| 30 |
|
|---|
| 31 | #define snd_pcm_substream_chip(substream) ((substream)->private_data)
|
|---|
| 32 | #define snd_pcm_chip(pcm) ((pcm)->private_data)
|
|---|
| 33 |
|
|---|
| 34 | #if defined(CONFIG_SND_PCM_OSS) || defined(CONFIG_SND_PCM_OSS_MODULE)
|
|---|
| 35 | #include "pcm_oss.h"
|
|---|
| 36 | #endif
|
|---|
| 37 |
|
|---|
| 38 | /*
|
|---|
| 39 | * Hardware (lowlevel) section
|
|---|
| 40 | */
|
|---|
| 41 |
|
|---|
| 42 | struct snd_pcm_hardware {
|
|---|
| 43 | unsigned int info; /* SNDRV_PCM_INFO_* */
|
|---|
| 44 | u64 formats; /* SNDRV_PCM_FMTBIT_* */
|
|---|
| 45 | unsigned int rates; /* SNDRV_PCM_RATE_* */
|
|---|
| 46 | unsigned int rate_min; /* min rate */
|
|---|
| 47 | unsigned int rate_max; /* max rate */
|
|---|
| 48 | unsigned int channels_min; /* min channels */
|
|---|
| 49 | unsigned int channels_max; /* max channels */
|
|---|
| 50 | size_t buffer_bytes_max; /* max buffer size */
|
|---|
| 51 | size_t period_bytes_min; /* min period size */
|
|---|
| 52 | size_t period_bytes_max; /* max period size */
|
|---|
| 53 | unsigned int periods_min; /* min # of periods */
|
|---|
| 54 | unsigned int periods_max; /* max # of periods */
|
|---|
| 55 | size_t fifo_size; /* fifo size in bytes */
|
|---|
| 56 | };
|
|---|
| 57 |
|
|---|
| 58 | struct snd_pcm_ops {
|
|---|
| 59 | int (*open)(struct snd_pcm_substream *substream);
|
|---|
| 60 | int (*close)(struct snd_pcm_substream *substream);
|
|---|
| 61 | int (*ioctl)(struct snd_pcm_substream * substream,
|
|---|
| 62 | unsigned int cmd, void *arg);
|
|---|
| 63 | int (*hw_params)(struct snd_pcm_substream *substream,
|
|---|
| 64 | struct snd_pcm_hw_params *params);
|
|---|
| 65 | int (*hw_free)(struct snd_pcm_substream *substream);
|
|---|
| 66 | int (*prepare)(struct snd_pcm_substream *substream);
|
|---|
| 67 | int (*trigger)(struct snd_pcm_substream *substream, int cmd);
|
|---|
| 68 | snd_pcm_uframes_t (*pointer)(struct snd_pcm_substream *substream);
|
|---|
| 69 | int (*copy)(struct snd_pcm_substream *substream, int channel,
|
|---|
| 70 | snd_pcm_uframes_t pos,
|
|---|
| 71 | void __user *buf, snd_pcm_uframes_t count);
|
|---|
| 72 | int (*silence)(struct snd_pcm_substream *substream, int channel,
|
|---|
| 73 | snd_pcm_uframes_t pos, snd_pcm_uframes_t count);
|
|---|
| 74 | struct page *(*page)(struct snd_pcm_substream *substream,
|
|---|
| 75 | unsigned long offset);
|
|---|
| 76 | int (*mmap)(struct snd_pcm_substream *substream, struct vm_area_struct *vma);
|
|---|
| 77 | int (*ack)(struct snd_pcm_substream *substream);
|
|---|
| 78 | };
|
|---|
| 79 |
|
|---|
| 80 | /*
|
|---|
| 81 | *
|
|---|
| 82 | */
|
|---|
| 83 |
|
|---|
| 84 | #define SNDRV_PCM_DEVICES 8
|
|---|
| 85 |
|
|---|
| 86 | #define SNDRV_PCM_IOCTL1_FALSE ((void *)0)
|
|---|
| 87 | #define SNDRV_PCM_IOCTL1_TRUE ((void *)1)
|
|---|
| 88 |
|
|---|
| 89 | #define SNDRV_PCM_IOCTL1_RESET 0
|
|---|
| 90 | #define SNDRV_PCM_IOCTL1_INFO 1
|
|---|
| 91 | #define SNDRV_PCM_IOCTL1_CHANNEL_INFO 2
|
|---|
| 92 | #define SNDRV_PCM_IOCTL1_GSTATE 3
|
|---|
| 93 |
|
|---|
| 94 | #define SNDRV_PCM_TRIGGER_STOP 0
|
|---|
| 95 | #define SNDRV_PCM_TRIGGER_START 1
|
|---|
| 96 | #define SNDRV_PCM_TRIGGER_PAUSE_PUSH 3
|
|---|
| 97 | #define SNDRV_PCM_TRIGGER_PAUSE_RELEASE 4
|
|---|
| 98 | #define SNDRV_PCM_TRIGGER_SUSPEND 5
|
|---|
| 99 | #define SNDRV_PCM_TRIGGER_RESUME 6
|
|---|
| 100 |
|
|---|
| 101 | #define SNDRV_PCM_POS_XRUN ((snd_pcm_uframes_t)-1)
|
|---|
| 102 |
|
|---|
| 103 | /* If you change this don't forget to change rates[] table in pcm_native.c */
|
|---|
| 104 | #define SNDRV_PCM_RATE_5512 (1<<0) /* 5512Hz */
|
|---|
| 105 | #define SNDRV_PCM_RATE_8000 (1<<1) /* 8000Hz */
|
|---|
| 106 | #define SNDRV_PCM_RATE_11025 (1<<2) /* 11025Hz */
|
|---|
| 107 | #define SNDRV_PCM_RATE_16000 (1<<3) /* 16000Hz */
|
|---|
| 108 | #define SNDRV_PCM_RATE_22050 (1<<4) /* 22050Hz */
|
|---|
| 109 | #define SNDRV_PCM_RATE_32000 (1<<5) /* 32000Hz */
|
|---|
| 110 | #define SNDRV_PCM_RATE_44100 (1<<6) /* 44100Hz */
|
|---|
| 111 | #define SNDRV_PCM_RATE_48000 (1<<7) /* 48000Hz */
|
|---|
| 112 | #define SNDRV_PCM_RATE_64000 (1<<8) /* 64000Hz */
|
|---|
| 113 | #define SNDRV_PCM_RATE_88200 (1<<9) /* 88200Hz */
|
|---|
| 114 | #define SNDRV_PCM_RATE_96000 (1<<10) /* 96000Hz */
|
|---|
| 115 | #define SNDRV_PCM_RATE_176400 (1<<11) /* 176400Hz */
|
|---|
| 116 | #define SNDRV_PCM_RATE_192000 (1<<12) /* 192000Hz */
|
|---|
| 117 |
|
|---|
| 118 | #define SNDRV_PCM_RATE_CONTINUOUS (1<<30) /* continuous range */
|
|---|
| 119 | #define SNDRV_PCM_RATE_KNOT (1<<31) /* supports more non-continuos rates */
|
|---|
| 120 |
|
|---|
| 121 | #define SNDRV_PCM_RATE_8000_44100 (SNDRV_PCM_RATE_8000|SNDRV_PCM_RATE_11025|\
|
|---|
| 122 | SNDRV_PCM_RATE_16000|SNDRV_PCM_RATE_22050|\
|
|---|
| 123 | SNDRV_PCM_RATE_32000|SNDRV_PCM_RATE_44100)
|
|---|
| 124 | #define SNDRV_PCM_RATE_8000_48000 (SNDRV_PCM_RATE_8000_44100|SNDRV_PCM_RATE_48000)
|
|---|
| 125 | #define SNDRV_PCM_RATE_8000_96000 (SNDRV_PCM_RATE_8000_48000|SNDRV_PCM_RATE_64000|\
|
|---|
| 126 | SNDRV_PCM_RATE_88200|SNDRV_PCM_RATE_96000)
|
|---|
| 127 | #define SNDRV_PCM_RATE_8000_192000 (SNDRV_PCM_RATE_8000_96000|SNDRV_PCM_RATE_176400|\
|
|---|
| 128 | SNDRV_PCM_RATE_192000)
|
|---|
| 129 | #define SNDRV_PCM_FMTBIT_S8 (1ULL << SNDRV_PCM_FORMAT_S8)
|
|---|
| 130 | #define SNDRV_PCM_FMTBIT_U8 (1ULL << SNDRV_PCM_FORMAT_U8)
|
|---|
| 131 | #define SNDRV_PCM_FMTBIT_S16_LE (1ULL << SNDRV_PCM_FORMAT_S16_LE)
|
|---|
| 132 | #define SNDRV_PCM_FMTBIT_S16_BE (1ULL << SNDRV_PCM_FORMAT_S16_BE)
|
|---|
| 133 | #define SNDRV_PCM_FMTBIT_U16_LE (1ULL << SNDRV_PCM_FORMAT_U16_LE)
|
|---|
| 134 | #define SNDRV_PCM_FMTBIT_U16_BE (1ULL << SNDRV_PCM_FORMAT_U16_BE)
|
|---|
| 135 | #define SNDRV_PCM_FMTBIT_S24_LE (1ULL << SNDRV_PCM_FORMAT_S24_LE)
|
|---|
| 136 | #define SNDRV_PCM_FMTBIT_S24_BE (1ULL << SNDRV_PCM_FORMAT_S24_BE)
|
|---|
| 137 | #define SNDRV_PCM_FMTBIT_U24_LE (1ULL << SNDRV_PCM_FORMAT_U24_LE)
|
|---|
| 138 | #define SNDRV_PCM_FMTBIT_U24_BE (1ULL << SNDRV_PCM_FORMAT_U24_BE)
|
|---|
| 139 | #define SNDRV_PCM_FMTBIT_S32_LE (1ULL << SNDRV_PCM_FORMAT_S32_LE)
|
|---|
| 140 | #define SNDRV_PCM_FMTBIT_S32_BE (1ULL << SNDRV_PCM_FORMAT_S32_BE)
|
|---|
| 141 | #define SNDRV_PCM_FMTBIT_U32_LE (1ULL << SNDRV_PCM_FORMAT_U32_LE)
|
|---|
| 142 | #define SNDRV_PCM_FMTBIT_U32_BE (1ULL << SNDRV_PCM_FORMAT_U32_BE)
|
|---|
| 143 | #define SNDRV_PCM_FMTBIT_FLOAT_LE (1ULL << SNDRV_PCM_FORMAT_FLOAT_LE)
|
|---|
| 144 | #define SNDRV_PCM_FMTBIT_FLOAT_BE (1ULL << SNDRV_PCM_FORMAT_FLOAT_BE)
|
|---|
| 145 | #define SNDRV_PCM_FMTBIT_FLOAT64_LE (1ULL << SNDRV_PCM_FORMAT_FLOAT64_LE)
|
|---|
| 146 | #define SNDRV_PCM_FMTBIT_FLOAT64_BE (1ULL << SNDRV_PCM_FORMAT_FLOAT64_BE)
|
|---|
| 147 | #define SNDRV_PCM_FMTBIT_IEC958_SUBFRAME_LE (1ULL << SNDRV_PCM_FORMAT_IEC958_SUBFRAME_LE)
|
|---|
| 148 | #define SNDRV_PCM_FMTBIT_IEC958_SUBFRAME_BE (1ULL << SNDRV_PCM_FORMAT_IEC958_SUBFRAME_BE)
|
|---|
| 149 | #define SNDRV_PCM_FMTBIT_MU_LAW (1ULL << SNDRV_PCM_FORMAT_MU_LAW)
|
|---|
| 150 | #define SNDRV_PCM_FMTBIT_A_LAW (1ULL << SNDRV_PCM_FORMAT_A_LAW)
|
|---|
| 151 | #define SNDRV_PCM_FMTBIT_IMA_ADPCM (1ULL << SNDRV_PCM_FORMAT_IMA_ADPCM)
|
|---|
| 152 | #define SNDRV_PCM_FMTBIT_MPEG (1ULL << SNDRV_PCM_FORMAT_MPEG)
|
|---|
| 153 | #define SNDRV_PCM_FMTBIT_GSM (1ULL << SNDRV_PCM_FORMAT_GSM)
|
|---|
| 154 | #define SNDRV_PCM_FMTBIT_SPECIAL (1ULL << SNDRV_PCM_FORMAT_SPECIAL)
|
|---|
| 155 | #define SNDRV_PCM_FMTBIT_S24_3LE (1ULL << SNDRV_PCM_FORMAT_S24_3LE)
|
|---|
| 156 | #define SNDRV_PCM_FMTBIT_U24_3LE (1ULL << SNDRV_PCM_FORMAT_U24_3LE)
|
|---|
| 157 | #define SNDRV_PCM_FMTBIT_S24_3BE (1ULL << SNDRV_PCM_FORMAT_S24_3BE)
|
|---|
| 158 | #define SNDRV_PCM_FMTBIT_U24_3BE (1ULL << SNDRV_PCM_FORMAT_U24_3BE)
|
|---|
| 159 | #define SNDRV_PCM_FMTBIT_S20_3LE (1ULL << SNDRV_PCM_FORMAT_S20_3LE)
|
|---|
| 160 | #define SNDRV_PCM_FMTBIT_U20_3LE (1ULL << SNDRV_PCM_FORMAT_U20_3LE)
|
|---|
| 161 | #define SNDRV_PCM_FMTBIT_S20_3BE (1ULL << SNDRV_PCM_FORMAT_S20_3BE)
|
|---|
| 162 | #define SNDRV_PCM_FMTBIT_U20_3BE (1ULL << SNDRV_PCM_FORMAT_U20_3BE)
|
|---|
| 163 | #define SNDRV_PCM_FMTBIT_S18_3LE (1ULL << SNDRV_PCM_FORMAT_S18_3LE)
|
|---|
| 164 | #define SNDRV_PCM_FMTBIT_U18_3LE (1ULL << SNDRV_PCM_FORMAT_U18_3LE)
|
|---|
| 165 | #define SNDRV_PCM_FMTBIT_S18_3BE (1ULL << SNDRV_PCM_FORMAT_S18_3BE)
|
|---|
| 166 | #define SNDRV_PCM_FMTBIT_U18_3BE (1ULL << SNDRV_PCM_FORMAT_U18_3BE)
|
|---|
| 167 |
|
|---|
| 168 | #ifdef SNDRV_LITTLE_ENDIAN
|
|---|
| 169 | #define SNDRV_PCM_FMTBIT_S16 SNDRV_PCM_FMTBIT_S16_LE
|
|---|
| 170 | #define SNDRV_PCM_FMTBIT_U16 SNDRV_PCM_FMTBIT_U16_LE
|
|---|
| 171 | #define SNDRV_PCM_FMTBIT_S24 SNDRV_PCM_FMTBIT_S24_LE
|
|---|
| 172 | #define SNDRV_PCM_FMTBIT_U24 SNDRV_PCM_FMTBIT_U24_LE
|
|---|
| 173 | #define SNDRV_PCM_FMTBIT_S32 SNDRV_PCM_FMTBIT_S32_LE
|
|---|
| 174 | #define SNDRV_PCM_FMTBIT_U32 SNDRV_PCM_FMTBIT_U32_LE
|
|---|
| 175 | #define SNDRV_PCM_FMTBIT_FLOAT SNDRV_PCM_FMTBIT_FLOAT_LE
|
|---|
| 176 | #define SNDRV_PCM_FMTBIT_FLOAT64 SNDRV_PCM_FMTBIT_FLOAT64_LE
|
|---|
| 177 | #define SNDRV_PCM_FMTBIT_IEC958_SUBFRAME SNDRV_PCM_FMTBIT_IEC958_SUBFRAME_LE
|
|---|
| 178 | #endif
|
|---|
| 179 | #ifdef SNDRV_BIG_ENDIAN
|
|---|
| 180 | #define SNDRV_PCM_FMTBIT_S16 SNDRV_PCM_FMTBIT_S16_BE
|
|---|
| 181 | #define SNDRV_PCM_FMTBIT_U16 SNDRV_PCM_FMTBIT_U16_BE
|
|---|
| 182 | #define SNDRV_PCM_FMTBIT_S24 SNDRV_PCM_FMTBIT_S24_BE
|
|---|
| 183 | #define SNDRV_PCM_FMTBIT_U24 SNDRV_PCM_FMTBIT_U24_BE
|
|---|
| 184 | #define SNDRV_PCM_FMTBIT_S32 SNDRV_PCM_FMTBIT_S32_BE
|
|---|
| 185 | #define SNDRV_PCM_FMTBIT_U32 SNDRV_PCM_FMTBIT_U32_BE
|
|---|
| 186 | #define SNDRV_PCM_FMTBIT_FLOAT SNDRV_PCM_FMTBIT_FLOAT_BE
|
|---|
| 187 | #define SNDRV_PCM_FMTBIT_FLOAT64 SNDRV_PCM_FMTBIT_FLOAT64_BE
|
|---|
| 188 | #define SNDRV_PCM_FMTBIT_IEC958_SUBFRAME SNDRV_PCM_FMTBIT_IEC958_SUBFRAME_BE
|
|---|
| 189 | #endif
|
|---|
| 190 |
|
|---|
| 191 | struct snd_pcm_file {
|
|---|
| 192 | struct snd_pcm_substream *substream;
|
|---|
| 193 | struct snd_pcm_file *next;
|
|---|
| 194 | };
|
|---|
| 195 |
|
|---|
| 196 | struct snd_pcm_hw_rule;
|
|---|
| 197 | typedef int (*snd_pcm_hw_rule_func_t)(struct snd_pcm_hw_params *params,
|
|---|
| 198 | struct snd_pcm_hw_rule *rule);
|
|---|
| 199 |
|
|---|
| 200 | struct snd_pcm_hw_rule {
|
|---|
| 201 | unsigned int cond;
|
|---|
| 202 | snd_pcm_hw_rule_func_t func;
|
|---|
| 203 | int var;
|
|---|
| 204 | int deps[4];
|
|---|
| 205 | void *private;
|
|---|
| 206 | };
|
|---|
| 207 |
|
|---|
| 208 | struct snd_pcm_hw_constraints {
|
|---|
| 209 | struct snd_mask masks[SNDRV_PCM_HW_PARAM_LAST_MASK -
|
|---|
| 210 | SNDRV_PCM_HW_PARAM_FIRST_MASK + 1];
|
|---|
| 211 | struct snd_interval intervals[SNDRV_PCM_HW_PARAM_LAST_INTERVAL -
|
|---|
| 212 | SNDRV_PCM_HW_PARAM_FIRST_INTERVAL + 1];
|
|---|
| 213 | unsigned int rules_num;
|
|---|
| 214 | unsigned int rules_all;
|
|---|
| 215 | struct snd_pcm_hw_rule *rules;
|
|---|
| 216 | };
|
|---|
| 217 |
|
|---|
| 218 | static inline struct snd_mask *constrs_mask(struct snd_pcm_hw_constraints *constrs,
|
|---|
| 219 | snd_pcm_hw_param_t var)
|
|---|
| 220 | {
|
|---|
| 221 | return &constrs->masks[var - SNDRV_PCM_HW_PARAM_FIRST_MASK];
|
|---|
| 222 | }
|
|---|
| 223 |
|
|---|
| 224 | static inline struct snd_interval *constrs_interval(struct snd_pcm_hw_constraints *constrs,
|
|---|
| 225 | snd_pcm_hw_param_t var)
|
|---|
| 226 | {
|
|---|
| 227 | return &constrs->intervals[var - SNDRV_PCM_HW_PARAM_FIRST_INTERVAL];
|
|---|
| 228 | }
|
|---|
| 229 |
|
|---|
| 230 | struct snd_ratnum {
|
|---|
| 231 | unsigned int num;
|
|---|
| 232 | unsigned int den_min, den_max, den_step;
|
|---|
| 233 | };
|
|---|
| 234 |
|
|---|
| 235 | struct snd_ratden {
|
|---|
| 236 | unsigned int num_min, num_max, num_step;
|
|---|
| 237 | unsigned int den;
|
|---|
| 238 | };
|
|---|
| 239 |
|
|---|
| 240 | struct snd_pcm_hw_constraint_ratnums {
|
|---|
| 241 | int nrats;
|
|---|
| 242 | struct snd_ratnum *rats;
|
|---|
| 243 | };
|
|---|
| 244 |
|
|---|
| 245 | struct snd_pcm_hw_constraint_ratdens {
|
|---|
| 246 | int nrats;
|
|---|
| 247 | struct snd_ratden *rats;
|
|---|
| 248 | };
|
|---|
| 249 |
|
|---|
| 250 | struct snd_pcm_hw_constraint_list {
|
|---|
| 251 | unsigned int count;
|
|---|
| 252 | unsigned int *list;
|
|---|
| 253 | unsigned int mask;
|
|---|
| 254 | };
|
|---|
| 255 |
|
|---|
| 256 | struct snd_pcm_runtime {
|
|---|
| 257 | /* -- Status -- */
|
|---|
| 258 | struct snd_pcm_substream *trigger_master;
|
|---|
| 259 | struct timespec trigger_tstamp; /* trigger timestamp */
|
|---|
| 260 | int overrange;
|
|---|
| 261 | snd_pcm_uframes_t avail_max;
|
|---|
| 262 | snd_pcm_uframes_t hw_ptr_base; /* Position at buffer restart */
|
|---|
| 263 | snd_pcm_uframes_t hw_ptr_interrupt; /* Position at interrupt time*/
|
|---|
| 264 |
|
|---|
| 265 | /* -- HW params -- */
|
|---|
| 266 | snd_pcm_access_t access; /* access mode */
|
|---|
| 267 | snd_pcm_format_t format; /* SNDRV_PCM_FORMAT_* */
|
|---|
| 268 | snd_pcm_subformat_t subformat; /* subformat */
|
|---|
| 269 | unsigned int rate; /* rate in Hz */
|
|---|
| 270 | unsigned int channels; /* channels */
|
|---|
| 271 | snd_pcm_uframes_t period_size; /* period size */
|
|---|
| 272 | unsigned int periods; /* periods */
|
|---|
| 273 | snd_pcm_uframes_t buffer_size; /* buffer size */
|
|---|
| 274 | unsigned int tick_time; /* tick time */
|
|---|
| 275 | snd_pcm_uframes_t min_align; /* Min alignment for the format */
|
|---|
| 276 | size_t byte_align;
|
|---|
| 277 | unsigned int frame_bits;
|
|---|
| 278 | unsigned int sample_bits;
|
|---|
| 279 | unsigned int info;
|
|---|
| 280 | unsigned int rate_num;
|
|---|
| 281 | unsigned int rate_den;
|
|---|
| 282 |
|
|---|
| 283 | /* -- SW params -- */
|
|---|
| 284 | int tstamp_mode; /* mmap timestamp is updated */
|
|---|
| 285 | unsigned int period_step;
|
|---|
| 286 | unsigned int sleep_min; /* min ticks to sleep */
|
|---|
| 287 | snd_pcm_uframes_t xfer_align; /* xfer size need to be a multiple */
|
|---|
| 288 | snd_pcm_uframes_t start_threshold;
|
|---|
| 289 | snd_pcm_uframes_t stop_threshold;
|
|---|
| 290 | snd_pcm_uframes_t silence_threshold; /* Silence filling happens when
|
|---|
| 291 | noise is nearest than this */
|
|---|
| 292 | snd_pcm_uframes_t silence_size; /* Silence filling size */
|
|---|
| 293 | snd_pcm_uframes_t boundary; /* pointers wrap point */
|
|---|
| 294 |
|
|---|
| 295 | snd_pcm_uframes_t silence_start; /* starting pointer to silence area */
|
|---|
| 296 | snd_pcm_uframes_t silence_filled; /* size filled with silence */
|
|---|
| 297 |
|
|---|
| 298 | union snd_pcm_sync_id sync; /* hardware synchronization ID */
|
|---|
| 299 |
|
|---|
| 300 | /* -- mmap -- */
|
|---|
| 301 | volatile struct snd_pcm_mmap_status *status;
|
|---|
| 302 | volatile struct snd_pcm_mmap_control *control;
|
|---|
| 303 | atomic_t mmap_count;
|
|---|
| 304 |
|
|---|
| 305 | /* -- locking / scheduling -- */
|
|---|
| 306 | wait_queue_head_t sleep;
|
|---|
| 307 | struct timer_list tick_timer;
|
|---|
| 308 | struct fasync_struct *fasync;
|
|---|
| 309 |
|
|---|
| 310 | /* -- private section -- */
|
|---|
| 311 | void *private_data;
|
|---|
| 312 | void (*private_free)(struct snd_pcm_runtime *runtime);
|
|---|
| 313 |
|
|---|
| 314 | /* -- hardware description -- */
|
|---|
| 315 | struct snd_pcm_hardware hw;
|
|---|
| 316 | struct snd_pcm_hw_constraints hw_constraints;
|
|---|
| 317 |
|
|---|
| 318 | /* -- interrupt callbacks -- */
|
|---|
| 319 | void (*transfer_ack_begin)(struct snd_pcm_substream *substream);
|
|---|
| 320 | void (*transfer_ack_end)(struct snd_pcm_substream *substream);
|
|---|
| 321 |
|
|---|
| 322 | /* -- timer -- */
|
|---|
| 323 | unsigned int timer_resolution; /* timer resolution */
|
|---|
| 324 |
|
|---|
| 325 | /* -- DMA -- */
|
|---|
| 326 | unsigned char *dma_area; /* DMA area */
|
|---|
| 327 | dma_addr_t dma_addr; /* physical bus address (not accessible from main CPU) */
|
|---|
| 328 | size_t dma_bytes; /* size of DMA area */
|
|---|
| 329 |
|
|---|
| 330 | struct snd_dma_buffer *dma_buffer_p; /* allocated buffer */
|
|---|
| 331 |
|
|---|
| 332 | #if defined(CONFIG_SND_PCM_OSS) || defined(CONFIG_SND_PCM_OSS_MODULE)
|
|---|
| 333 | /* -- OSS things -- */
|
|---|
| 334 | struct snd_pcm_oss_runtime oss;
|
|---|
| 335 | #endif
|
|---|
| 336 | };
|
|---|
| 337 |
|
|---|
| 338 | struct snd_pcm_group { /* keep linked substreams */
|
|---|
| 339 | spinlock_t lock;
|
|---|
| 340 | struct list_head substreams;
|
|---|
| 341 | int count;
|
|---|
| 342 | };
|
|---|
| 343 |
|
|---|
| 344 | struct snd_pcm_substream {
|
|---|
| 345 | struct snd_pcm *pcm;
|
|---|
| 346 | struct snd_pcm_str *pstr;
|
|---|
| 347 | void *private_data; /* copied from pcm->private_data */
|
|---|
| 348 | int number;
|
|---|
| 349 | char name[32]; /* substream name */
|
|---|
| 350 | int stream; /* stream (direction) */
|
|---|
| 351 | size_t buffer_bytes_max; /* limit ring buffer size */
|
|---|
| 352 | struct snd_dma_buffer dma_buffer;
|
|---|
| 353 | unsigned int dma_buf_id;
|
|---|
| 354 | size_t dma_max;
|
|---|
| 355 | /* -- hardware operations -- */
|
|---|
| 356 | struct snd_pcm_ops *ops;
|
|---|
| 357 | /* -- runtime information -- */
|
|---|
| 358 | struct snd_pcm_runtime *runtime;
|
|---|
| 359 | /* -- timer section -- */
|
|---|
| 360 | struct snd_timer *timer; /* timer */
|
|---|
| 361 | unsigned timer_running: 1; /* time is running */
|
|---|
| 362 | spinlock_t timer_lock;
|
|---|
| 363 | /* -- next substream -- */
|
|---|
| 364 | struct snd_pcm_substream *next;
|
|---|
| 365 | /* -- linked substreams -- */
|
|---|
| 366 | struct list_head link_list; /* linked list member */
|
|---|
| 367 | struct snd_pcm_group self_group; /* fake group for non linked substream (with substream lock inside) */
|
|---|
| 368 | struct snd_pcm_group *group; /* pointer to current group */
|
|---|
| 369 | /* -- assigned files -- */
|
|---|
| 370 | struct snd_pcm_file *file;
|
|---|
| 371 | struct file *ffile;
|
|---|
| 372 | #if defined(CONFIG_SND_PCM_OSS) || defined(CONFIG_SND_PCM_OSS_MODULE)
|
|---|
| 373 | /* -- OSS things -- */
|
|---|
| 374 | struct snd_pcm_oss_substream oss;
|
|---|
| 375 | #endif
|
|---|
| 376 | struct snd_info_entry *proc_root;
|
|---|
| 377 | struct snd_info_entry *proc_info_entry;
|
|---|
| 378 | struct snd_info_entry *proc_hw_params_entry;
|
|---|
| 379 | struct snd_info_entry *proc_sw_params_entry;
|
|---|
| 380 | struct snd_info_entry *proc_status_entry;
|
|---|
| 381 | struct snd_info_entry *proc_prealloc_entry;
|
|---|
| 382 | /* misc flags */
|
|---|
| 383 | unsigned int no_mmap_ctrl: 1;
|
|---|
| 384 | };
|
|---|
| 385 |
|
|---|
| 386 | #if defined(CONFIG_SND_PCM_OSS) || defined(CONFIG_SND_PCM_OSS_MODULE)
|
|---|
| 387 | #define SUBSTREAM_BUSY(substream) ((substream)->file != NULL || ((substream)->oss.file != NULL))
|
|---|
| 388 | #else
|
|---|
| 389 | #define SUBSTREAM_BUSY(substream) ((substream)->file != NULL)
|
|---|
| 390 | #endif
|
|---|
| 391 |
|
|---|
| 392 |
|
|---|
| 393 | struct snd_pcm_str {
|
|---|
| 394 | int stream; /* stream (direction) */
|
|---|
| 395 | struct snd_pcm *pcm;
|
|---|
| 396 | /* -- substreams -- */
|
|---|
| 397 | unsigned int substream_count;
|
|---|
| 398 | unsigned int substream_opened;
|
|---|
| 399 | struct snd_pcm_substream *substream;
|
|---|
| 400 | #if defined(CONFIG_SND_PCM_OSS) || defined(CONFIG_SND_PCM_OSS_MODULE)
|
|---|
| 401 | /* -- OSS things -- */
|
|---|
| 402 | struct snd_pcm_oss_stream oss;
|
|---|
| 403 | #endif
|
|---|
| 404 | struct snd_pcm_file *files;
|
|---|
| 405 | struct snd_minor *reg;
|
|---|
| 406 | struct snd_info_entry *proc_root;
|
|---|
| 407 | struct snd_info_entry *proc_info_entry;
|
|---|
| 408 | #ifdef CONFIG_SND_DEBUG
|
|---|
| 409 | unsigned int xrun_debug; /* 0 = disabled, 1 = verbose, 2 = stacktrace */
|
|---|
| 410 | struct snd_info_entry *proc_xrun_debug_entry;
|
|---|
| 411 | #endif
|
|---|
| 412 | };
|
|---|
| 413 |
|
|---|
| 414 | struct snd_pcm {
|
|---|
| 415 | struct snd_card *card;
|
|---|
| 416 | unsigned int device; /* device number */
|
|---|
| 417 | unsigned int info_flags;
|
|---|
| 418 | unsigned short dev_class;
|
|---|
| 419 | unsigned short dev_subclass;
|
|---|
| 420 | char id[64];
|
|---|
| 421 | char name[80];
|
|---|
| 422 | struct snd_pcm_str streams[2];
|
|---|
| 423 | struct semaphore open_mutex;
|
|---|
| 424 | wait_queue_head_t open_wait;
|
|---|
| 425 | void *private_data;
|
|---|
| 426 | void (*private_free) (struct snd_pcm *pcm);
|
|---|
| 427 | #if defined(CONFIG_SND_PCM_OSS) || defined(CONFIG_SND_PCM_OSS_MODULE)
|
|---|
| 428 | struct snd_pcm_oss oss;
|
|---|
| 429 | #endif
|
|---|
| 430 | };
|
|---|
| 431 |
|
|---|
| 432 | struct snd_pcm_notify {
|
|---|
| 433 | int (*n_register) (struct snd_pcm * pcm);
|
|---|
| 434 | int (*n_disconnect) (struct snd_pcm * pcm);
|
|---|
| 435 | int (*n_unregister) (struct snd_pcm * pcm);
|
|---|
| 436 | struct list_head list;
|
|---|
| 437 | };
|
|---|
| 438 |
|
|---|
| 439 | /*
|
|---|
| 440 | * Registering
|
|---|
| 441 | */
|
|---|
| 442 |
|
|---|
| 443 | extern struct snd_pcm *snd_pcm_devices[];
|
|---|
| 444 | extern struct snd_minor snd_pcm_reg[2];
|
|---|
| 445 |
|
|---|
| 446 | int snd_pcm_new(struct snd_card *card, char *id, int device,
|
|---|
| 447 | int playback_count, int capture_count,
|
|---|
| 448 | struct snd_pcm **rpcm);
|
|---|
| 449 | int snd_pcm_new_stream(struct snd_pcm *pcm, int stream, int substream_count);
|
|---|
| 450 |
|
|---|
| 451 | int snd_pcm_notify(struct snd_pcm_notify *notify, int nfree);
|
|---|
| 452 |
|
|---|
| 453 | /*
|
|---|
| 454 | * Native I/O
|
|---|
| 455 | */
|
|---|
| 456 |
|
|---|
| 457 | extern rwlock_t snd_pcm_link_rwlock;
|
|---|
| 458 |
|
|---|
| 459 | int snd_pcm_info(struct snd_pcm_substream *substream, struct snd_pcm_info *info);
|
|---|
| 460 | int snd_pcm_info_user(struct snd_pcm_substream *substream,
|
|---|
| 461 | struct snd_pcm_info __user *info);
|
|---|
| 462 | int snd_pcm_status(struct snd_pcm_substream *substream,
|
|---|
| 463 | struct snd_pcm_status *status);
|
|---|
| 464 | int snd_pcm_prepare(struct snd_pcm_substream *substream);
|
|---|
| 465 | int snd_pcm_start(struct snd_pcm_substream *substream);
|
|---|
| 466 | int snd_pcm_stop(struct snd_pcm_substream *substream, int status);
|
|---|
| 467 | int snd_pcm_drain_done(struct snd_pcm_substream *substream);
|
|---|
| 468 | #ifdef CONFIG_PM
|
|---|
| 469 | int snd_pcm_suspend(struct snd_pcm_substream *substream);
|
|---|
| 470 | int snd_pcm_suspend_all(struct snd_pcm *pcm);
|
|---|
| 471 | #endif
|
|---|
| 472 | int snd_pcm_kernel_playback_ioctl(struct snd_pcm_substream *substream, unsigned int cmd, void *arg);
|
|---|
| 473 | int snd_pcm_kernel_capture_ioctl(struct snd_pcm_substream *substream, unsigned int cmd, void *arg);
|
|---|
| 474 | int snd_pcm_kernel_ioctl(struct snd_pcm_substream *substream, unsigned int cmd, void *arg);
|
|---|
| 475 | int snd_pcm_open_substream(struct snd_pcm *pcm, int stream, struct snd_pcm_substream **rsubstream);
|
|---|
| 476 | void snd_pcm_release_substream(struct snd_pcm_substream *substream);
|
|---|
| 477 | void snd_pcm_vma_notify_data(void *client, void *data);
|
|---|
| 478 | int snd_pcm_mmap_data(struct snd_pcm_substream *substream, struct file *file, struct vm_area_struct *area);
|
|---|
| 479 |
|
|---|
| 480 | #if BITS_PER_LONG >= 64
|
|---|
| 481 |
|
|---|
| 482 | static inline void div64_32(u_int64_t *n, u_int32_t div, u_int32_t *rem)
|
|---|
| 483 | {
|
|---|
| 484 | *rem = *n % div;
|
|---|
| 485 | *n /= div;
|
|---|
| 486 | }
|
|---|
| 487 |
|
|---|
| 488 | #elif defined(i386)
|
|---|
| 489 |
|
|---|
| 490 | static inline void div64_32(u_int64_t *n, u_int32_t div, u_int32_t *rem)
|
|---|
| 491 | {
|
|---|
| 492 | u_int32_t low, high;
|
|---|
| 493 | low = *n & 0xffffffff;
|
|---|
| 494 | high = *n >> 32;
|
|---|
| 495 | if (high) {
|
|---|
| 496 | u_int32_t high1 = high % div;
|
|---|
| 497 | high /= div;
|
|---|
| 498 | asm("divl %2":"=a" (low), "=d" (*rem):"rm" (div), "a" (low), "d" (high1));
|
|---|
| 499 | *n = (u_int64_t)high << 32 | low;
|
|---|
| 500 | } else {
|
|---|
| 501 | *n = low / div;
|
|---|
| 502 | *rem = low % div;
|
|---|
| 503 | }
|
|---|
| 504 | }
|
|---|
| 505 | #else
|
|---|
| 506 |
|
|---|
| 507 | static inline void divl(u_int32_t high, u_int32_t low,
|
|---|
| 508 | u_int32_t div,
|
|---|
| 509 | u_int32_t *q, u_int32_t *r)
|
|---|
| 510 | {
|
|---|
| 511 | u_int64_t n = (u_int64_t)high << 32 | low;
|
|---|
| 512 | u_int64_t d = (u_int64_t)div << 31;
|
|---|
| 513 | u_int32_t q1 = 0;
|
|---|
| 514 | int c = 32;
|
|---|
| 515 | while (n > 0xffffffffU) {
|
|---|
| 516 | q1 <<= 1;
|
|---|
| 517 | if (n >= d) {
|
|---|
| 518 | n -= d;
|
|---|
| 519 | q1 |= 1;
|
|---|
| 520 | }
|
|---|
| 521 | d >>= 1;
|
|---|
| 522 | c--;
|
|---|
| 523 | }
|
|---|
| 524 | q1 <<= c;
|
|---|
| 525 | if (n) {
|
|---|
| 526 | low = n;
|
|---|
| 527 | *q = q1 | (low / div);
|
|---|
| 528 | *r = low % div;
|
|---|
| 529 | } else {
|
|---|
| 530 | *r = 0;
|
|---|
| 531 | *q = q1;
|
|---|
| 532 | }
|
|---|
| 533 | return;
|
|---|
| 534 | }
|
|---|
| 535 |
|
|---|
| 536 | static inline void div64_32(u_int64_t *n, u_int32_t div, u_int32_t *rem)
|
|---|
| 537 | {
|
|---|
| 538 | u_int32_t low, high;
|
|---|
| 539 | low = *n & 0xffffffff;
|
|---|
| 540 | high = *n >> 32;
|
|---|
| 541 | if (high) {
|
|---|
| 542 | u_int32_t high1 = high % div;
|
|---|
| 543 | u_int32_t low1 = low;
|
|---|
| 544 | high /= div;
|
|---|
| 545 | divl(high1, low1, div, &low, rem);
|
|---|
| 546 | *n = (u_int64_t)high << 32 | low;
|
|---|
| 547 | } else {
|
|---|
| 548 | *n = low / div;
|
|---|
| 549 | *rem = low % div;
|
|---|
| 550 | }
|
|---|
| 551 | }
|
|---|
| 552 | #endif
|
|---|
| 553 |
|
|---|
| 554 | /*
|
|---|
| 555 | * PCM library
|
|---|
| 556 | */
|
|---|
| 557 |
|
|---|
| 558 | static inline int snd_pcm_stream_linked(struct snd_pcm_substream *substream)
|
|---|
| 559 | {
|
|---|
| 560 | return substream->group != &substream->self_group;
|
|---|
| 561 | }
|
|---|
| 562 |
|
|---|
| 563 | static inline void snd_pcm_stream_lock(struct snd_pcm_substream *substream)
|
|---|
| 564 | {
|
|---|
| 565 | read_lock(&snd_pcm_link_rwlock);
|
|---|
| 566 | spin_lock(&substream->self_group.lock);
|
|---|
| 567 | }
|
|---|
| 568 |
|
|---|
| 569 | static inline void snd_pcm_stream_unlock(struct snd_pcm_substream *substream)
|
|---|
| 570 | {
|
|---|
| 571 | spin_unlock(&substream->self_group.lock);
|
|---|
| 572 | read_unlock(&snd_pcm_link_rwlock);
|
|---|
| 573 | }
|
|---|
| 574 |
|
|---|
| 575 | static inline void snd_pcm_stream_lock_irq(struct snd_pcm_substream *substream)
|
|---|
| 576 | {
|
|---|
| 577 | read_lock_irq(&snd_pcm_link_rwlock);
|
|---|
| 578 | spin_lock(&substream->self_group.lock);
|
|---|
| 579 | }
|
|---|
| 580 |
|
|---|
| 581 | static inline void snd_pcm_stream_unlock_irq(struct snd_pcm_substream *substream)
|
|---|
| 582 | {
|
|---|
| 583 | spin_unlock(&substream->self_group.lock);
|
|---|
| 584 | read_unlock_irq(&snd_pcm_link_rwlock);
|
|---|
| 585 | }
|
|---|
| 586 |
|
|---|
| 587 | #define snd_pcm_stream_lock_irqsave(substream, flags) \
|
|---|
| 588 | do { \
|
|---|
| 589 | read_lock_irqsave(&snd_pcm_link_rwlock, (flags)); \
|
|---|
| 590 | spin_lock(&substream->self_group.lock); \
|
|---|
| 591 | } while (0)
|
|---|
| 592 |
|
|---|
| 593 | #define snd_pcm_stream_unlock_irqrestore(substream, flags) \
|
|---|
| 594 | do { \
|
|---|
| 595 | spin_unlock(&substream->self_group.lock); \
|
|---|
| 596 | read_unlock_irqrestore(&snd_pcm_link_rwlock, (flags)); \
|
|---|
| 597 | } while (0)
|
|---|
| 598 |
|
|---|
| 599 | #define snd_pcm_group_for_each(pos, substream) \
|
|---|
| 600 | list_for_each(pos, &substream->group->substreams)
|
|---|
| 601 |
|
|---|
| 602 | #define snd_pcm_group_substream_entry(pos) \
|
|---|
| 603 | list_entry(pos, struct snd_pcm_substream, link_list)
|
|---|
| 604 |
|
|---|
| 605 | static inline int snd_pcm_running(struct snd_pcm_substream *substream)
|
|---|
| 606 | {
|
|---|
| 607 | return (substream->runtime->status->state == SNDRV_PCM_STATE_RUNNING ||
|
|---|
| 608 | (substream->runtime->status->state == SNDRV_PCM_STATE_DRAINING &&
|
|---|
| 609 | substream->stream == SNDRV_PCM_STREAM_PLAYBACK));
|
|---|
| 610 | }
|
|---|
| 611 |
|
|---|
| 612 | static inline ssize_t bytes_to_samples(struct snd_pcm_runtime *runtime, ssize_t size)
|
|---|
| 613 | {
|
|---|
| 614 | return size * 8 / runtime->sample_bits;
|
|---|
| 615 | }
|
|---|
| 616 |
|
|---|
| 617 | static inline snd_pcm_sframes_t bytes_to_frames(struct snd_pcm_runtime *runtime, ssize_t size)
|
|---|
| 618 | {
|
|---|
| 619 | return size * 8 / runtime->frame_bits;
|
|---|
| 620 | }
|
|---|
| 621 |
|
|---|
| 622 | static inline ssize_t samples_to_bytes(struct snd_pcm_runtime *runtime, ssize_t size)
|
|---|
| 623 | {
|
|---|
| 624 | return size * runtime->sample_bits / 8;
|
|---|
| 625 | }
|
|---|
| 626 |
|
|---|
| 627 | static inline ssize_t frames_to_bytes(struct snd_pcm_runtime *runtime, snd_pcm_sframes_t size)
|
|---|
| 628 | {
|
|---|
| 629 | return size * runtime->frame_bits / 8;
|
|---|
| 630 | }
|
|---|
| 631 |
|
|---|
| 632 | static inline int frame_aligned(struct snd_pcm_runtime *runtime, ssize_t bytes)
|
|---|
| 633 | {
|
|---|
| 634 | return bytes % runtime->byte_align == 0;
|
|---|
| 635 | }
|
|---|
| 636 |
|
|---|
| 637 | static inline size_t snd_pcm_lib_buffer_bytes(struct snd_pcm_substream *substream)
|
|---|
| 638 | {
|
|---|
| 639 | struct snd_pcm_runtime *runtime = substream->runtime;
|
|---|
| 640 | return frames_to_bytes(runtime, runtime->buffer_size);
|
|---|
| 641 | }
|
|---|
| 642 |
|
|---|
| 643 | static inline size_t snd_pcm_lib_period_bytes(struct snd_pcm_substream *substream)
|
|---|
| 644 | {
|
|---|
| 645 | struct snd_pcm_runtime *runtime = substream->runtime;
|
|---|
| 646 | return frames_to_bytes(runtime, runtime->period_size);
|
|---|
| 647 | }
|
|---|
| 648 |
|
|---|
| 649 | /*
|
|---|
| 650 | * result is: 0 ... (boundary - 1)
|
|---|
| 651 | */
|
|---|
| 652 | static inline snd_pcm_uframes_t snd_pcm_playback_avail(struct snd_pcm_runtime *runtime)
|
|---|
| 653 | {
|
|---|
| 654 | snd_pcm_sframes_t avail = runtime->status->hw_ptr + runtime->buffer_size - runtime->control->appl_ptr;
|
|---|
| 655 | if (avail < 0)
|
|---|
| 656 | avail += runtime->boundary;
|
|---|
| 657 | else if ((snd_pcm_uframes_t) avail >= runtime->boundary)
|
|---|
| 658 | avail -= runtime->boundary;
|
|---|
| 659 | return avail;
|
|---|
| 660 | }
|
|---|
| 661 |
|
|---|
| 662 | /*
|
|---|
| 663 | * result is: 0 ... (boundary - 1)
|
|---|
| 664 | */
|
|---|
| 665 | static inline snd_pcm_uframes_t snd_pcm_capture_avail(struct snd_pcm_runtime *runtime)
|
|---|
| 666 | {
|
|---|
| 667 | snd_pcm_sframes_t avail = runtime->status->hw_ptr - runtime->control->appl_ptr;
|
|---|
| 668 | if (avail < 0)
|
|---|
| 669 | avail += runtime->boundary;
|
|---|
| 670 | return avail;
|
|---|
| 671 | }
|
|---|
| 672 |
|
|---|
| 673 | static inline snd_pcm_sframes_t snd_pcm_playback_hw_avail(struct snd_pcm_runtime *runtime)
|
|---|
| 674 | {
|
|---|
| 675 | return runtime->buffer_size - snd_pcm_playback_avail(runtime);
|
|---|
| 676 | }
|
|---|
| 677 |
|
|---|
| 678 | static inline snd_pcm_sframes_t snd_pcm_capture_hw_avail(struct snd_pcm_runtime *runtime)
|
|---|
| 679 | {
|
|---|
| 680 | return runtime->buffer_size - snd_pcm_capture_avail(runtime);
|
|---|
| 681 | }
|
|---|
| 682 |
|
|---|
| 683 | /**
|
|---|
| 684 | * snd_pcm_playback_ready - check whether the playback buffer is available
|
|---|
| 685 | * @substream: the pcm substream instance
|
|---|
| 686 | *
|
|---|
| 687 | * Checks whether enough free space is available on the playback buffer.
|
|---|
| 688 | *
|
|---|
| 689 | * Returns non-zero if available, or zero if not.
|
|---|
| 690 | */
|
|---|
| 691 | static inline int snd_pcm_playback_ready(struct snd_pcm_substream *substream)
|
|---|
| 692 | {
|
|---|
| 693 | struct snd_pcm_runtime *runtime = substream->runtime;
|
|---|
| 694 | return snd_pcm_playback_avail(runtime) >= runtime->control->avail_min;
|
|---|
| 695 | }
|
|---|
| 696 |
|
|---|
| 697 | /**
|
|---|
| 698 | * snd_pcm_capture_ready - check whether the capture buffer is available
|
|---|
| 699 | * @substream: the pcm substream instance
|
|---|
| 700 | *
|
|---|
| 701 | * Checks whether enough capture data is available on the capture buffer.
|
|---|
| 702 | *
|
|---|
| 703 | * Returns non-zero if available, or zero if not.
|
|---|
| 704 | */
|
|---|
| 705 | static inline int snd_pcm_capture_ready(struct snd_pcm_substream *substream)
|
|---|
| 706 | {
|
|---|
| 707 | struct snd_pcm_runtime *runtime = substream->runtime;
|
|---|
| 708 | return snd_pcm_capture_avail(runtime) >= runtime->control->avail_min;
|
|---|
| 709 | }
|
|---|
| 710 |
|
|---|
| 711 | /**
|
|---|
| 712 | * snd_pcm_playback_data - check whether any data exists on the playback buffer
|
|---|
| 713 | * @substream: the pcm substream instance
|
|---|
| 714 | *
|
|---|
| 715 | * Checks whether any data exists on the playback buffer. If stop_threshold
|
|---|
| 716 | * is bigger or equal to boundary, then this function returns always non-zero.
|
|---|
| 717 | *
|
|---|
| 718 | * Returns non-zero if exists, or zero if not.
|
|---|
| 719 | */
|
|---|
| 720 | static inline int snd_pcm_playback_data(struct snd_pcm_substream *substream)
|
|---|
| 721 | {
|
|---|
| 722 | struct snd_pcm_runtime *runtime = substream->runtime;
|
|---|
| 723 |
|
|---|
| 724 | if (runtime->stop_threshold >= runtime->boundary)
|
|---|
| 725 | return 1;
|
|---|
| 726 | return snd_pcm_playback_avail(runtime) < runtime->buffer_size;
|
|---|
| 727 | }
|
|---|
| 728 |
|
|---|
| 729 | /**
|
|---|
| 730 | * snd_pcm_playback_empty - check whether the playback buffer is empty
|
|---|
| 731 | * @substream: the pcm substream instance
|
|---|
| 732 | *
|
|---|
| 733 | * Checks whether the playback buffer is empty.
|
|---|
| 734 | *
|
|---|
| 735 | * Returns non-zero if empty, or zero if not.
|
|---|
| 736 | */
|
|---|
| 737 | static inline int snd_pcm_playback_empty(struct snd_pcm_substream *substream)
|
|---|
| 738 | {
|
|---|
| 739 | struct snd_pcm_runtime *runtime = substream->runtime;
|
|---|
| 740 | return snd_pcm_playback_avail(runtime) >= runtime->buffer_size;
|
|---|
| 741 | }
|
|---|
| 742 |
|
|---|
| 743 | /**
|
|---|
| 744 | * snd_pcm_capture_empty - check whether the capture buffer is empty
|
|---|
| 745 | * @substream: the pcm substream instance
|
|---|
| 746 | *
|
|---|
| 747 | * Checks whether the capture buffer is empty.
|
|---|
| 748 | *
|
|---|
| 749 | * Returns non-zero if empty, or zero if not.
|
|---|
| 750 | */
|
|---|
| 751 | static inline int snd_pcm_capture_empty(struct snd_pcm_substream *substream)
|
|---|
| 752 | {
|
|---|
| 753 | struct snd_pcm_runtime *runtime = substream->runtime;
|
|---|
| 754 | return snd_pcm_capture_avail(runtime) == 0;
|
|---|
| 755 | }
|
|---|
| 756 |
|
|---|
| 757 | static inline void snd_pcm_trigger_done(struct snd_pcm_substream *substream,
|
|---|
| 758 | struct snd_pcm_substream *master)
|
|---|
| 759 | {
|
|---|
| 760 | substream->runtime->trigger_master = master;
|
|---|
| 761 | }
|
|---|
| 762 |
|
|---|
| 763 | static inline int hw_is_mask(int var)
|
|---|
| 764 | {
|
|---|
| 765 | return var >= SNDRV_PCM_HW_PARAM_FIRST_MASK &&
|
|---|
| 766 | var <= SNDRV_PCM_HW_PARAM_LAST_MASK;
|
|---|
| 767 | }
|
|---|
| 768 |
|
|---|
| 769 | static inline int hw_is_interval(int var)
|
|---|
| 770 | {
|
|---|
| 771 | return var >= SNDRV_PCM_HW_PARAM_FIRST_INTERVAL &&
|
|---|
| 772 | var <= SNDRV_PCM_HW_PARAM_LAST_INTERVAL;
|
|---|
| 773 | }
|
|---|
| 774 |
|
|---|
| 775 | static inline struct snd_mask *hw_param_mask(struct snd_pcm_hw_params *params,
|
|---|
| 776 | snd_pcm_hw_param_t var)
|
|---|
| 777 | {
|
|---|
| 778 | return ¶ms->masks[var - SNDRV_PCM_HW_PARAM_FIRST_MASK];
|
|---|
| 779 | }
|
|---|
| 780 |
|
|---|
| 781 | static inline struct snd_interval *hw_param_interval(struct snd_pcm_hw_params *params,
|
|---|
| 782 | snd_pcm_hw_param_t var)
|
|---|
| 783 | {
|
|---|
| 784 | return ¶ms->intervals[var - SNDRV_PCM_HW_PARAM_FIRST_INTERVAL];
|
|---|
| 785 | }
|
|---|
| 786 |
|
|---|
| 787 | static inline const struct snd_mask *hw_param_mask_c(const struct snd_pcm_hw_params *params,
|
|---|
| 788 | snd_pcm_hw_param_t var)
|
|---|
| 789 | {
|
|---|
| 790 | return (const struct snd_mask *)hw_param_mask((struct snd_pcm_hw_params*) params, var);
|
|---|
| 791 | }
|
|---|
| 792 |
|
|---|
| 793 | static inline const struct snd_interval *hw_param_interval_c(const struct snd_pcm_hw_params *params,
|
|---|
| 794 | snd_pcm_hw_param_t var)
|
|---|
| 795 | {
|
|---|
| 796 | return (const struct snd_interval *)hw_param_interval((struct snd_pcm_hw_params*) params, var);
|
|---|
| 797 | }
|
|---|
| 798 |
|
|---|
| 799 | #define params_access(p) snd_mask_min(hw_param_mask((p), SNDRV_PCM_HW_PARAM_ACCESS))
|
|---|
| 800 | #define params_format(p) snd_mask_min(hw_param_mask((p), SNDRV_PCM_HW_PARAM_FORMAT))
|
|---|
| 801 | #define params_subformat(p) snd_mask_min(hw_param_mask((p), SNDRV_PCM_HW_PARAM_SUBFORMAT))
|
|---|
| 802 | #define params_channels(p) hw_param_interval((p), SNDRV_PCM_HW_PARAM_CHANNELS)->min
|
|---|
| 803 | #define params_rate(p) hw_param_interval((p), SNDRV_PCM_HW_PARAM_RATE)->min
|
|---|
| 804 | #define params_period_size(p) hw_param_interval((p), SNDRV_PCM_HW_PARAM_PERIOD_SIZE)->min
|
|---|
| 805 | #define params_period_bytes(p) ((params_period_size(p)*snd_pcm_format_physical_width(params_format(p))*params_channels(p))/8)
|
|---|
| 806 | #define params_periods(p) hw_param_interval((p), SNDRV_PCM_HW_PARAM_PERIODS)->min
|
|---|
| 807 | #define params_buffer_size(p) hw_param_interval((p), SNDRV_PCM_HW_PARAM_BUFFER_SIZE)->min
|
|---|
| 808 | #define params_buffer_bytes(p) hw_param_interval((p), SNDRV_PCM_HW_PARAM_BUFFER_BYTES)->min
|
|---|
| 809 | #define params_tick_time(p) hw_param_interval((p), SNDRV_PCM_HW_PARAM_TICK_TIME)->min
|
|---|
| 810 |
|
|---|
| 811 |
|
|---|
| 812 | int snd_interval_refine(struct snd_interval *i, const struct snd_interval *v);
|
|---|
| 813 | void snd_interval_mul(const struct snd_interval *a, const struct snd_interval *b, struct snd_interval *c);
|
|---|
| 814 | void snd_interval_div(const struct snd_interval *a, const struct snd_interval *b, struct snd_interval *c);
|
|---|
| 815 | void snd_interval_muldivk(const struct snd_interval *a, const struct snd_interval *b,
|
|---|
| 816 | unsigned int k, struct snd_interval *c);
|
|---|
| 817 | void snd_interval_mulkdiv(const struct snd_interval *a, unsigned int k,
|
|---|
| 818 | const struct snd_interval *b, struct snd_interval *c);
|
|---|
| 819 | int snd_interval_list(struct snd_interval *i, unsigned int count, unsigned int *list, unsigned int mask);
|
|---|
| 820 | int snd_interval_ratnum(struct snd_interval *i,
|
|---|
| 821 | unsigned int rats_count, struct snd_ratnum *rats,
|
|---|
| 822 | unsigned int *nump, unsigned int *denp);
|
|---|
| 823 |
|
|---|
| 824 | void _snd_pcm_hw_params_any(struct snd_pcm_hw_params *params);
|
|---|
| 825 | void _snd_pcm_hw_param_setempty(struct snd_pcm_hw_params *params, snd_pcm_hw_param_t var);
|
|---|
| 826 | int snd_pcm_hw_param_near(struct snd_pcm_substream *substream,
|
|---|
| 827 | struct snd_pcm_hw_params *params,
|
|---|
| 828 | snd_pcm_hw_param_t var,
|
|---|
| 829 | unsigned int val, int *dir);
|
|---|
| 830 | int snd_pcm_hw_param_set(struct snd_pcm_substream *pcm,
|
|---|
| 831 | struct snd_pcm_hw_params *params,
|
|---|
| 832 | snd_pcm_hw_param_t var,
|
|---|
| 833 | unsigned int val, int dir);
|
|---|
| 834 | int snd_pcm_hw_params_choose(struct snd_pcm_substream *substream, struct snd_pcm_hw_params *params);
|
|---|
| 835 |
|
|---|
| 836 | int snd_pcm_hw_refine(struct snd_pcm_substream *substream, struct snd_pcm_hw_params *params);
|
|---|
| 837 |
|
|---|
| 838 | int snd_pcm_hw_constraints_init(struct snd_pcm_substream *substream);
|
|---|
| 839 | int snd_pcm_hw_constraints_complete(struct snd_pcm_substream *substream);
|
|---|
| 840 |
|
|---|
| 841 | int snd_pcm_hw_constraint_mask(struct snd_pcm_runtime *runtime, snd_pcm_hw_param_t var,
|
|---|
| 842 | u_int32_t mask);
|
|---|
| 843 | int snd_pcm_hw_constraint_mask64(struct snd_pcm_runtime *runtime, snd_pcm_hw_param_t var,
|
|---|
| 844 | u_int64_t mask);
|
|---|
| 845 | int snd_pcm_hw_constraint_minmax(struct snd_pcm_runtime *runtime, snd_pcm_hw_param_t var,
|
|---|
| 846 | unsigned int min, unsigned int max);
|
|---|
| 847 | int snd_pcm_hw_constraint_integer(struct snd_pcm_runtime *runtime, snd_pcm_hw_param_t var);
|
|---|
| 848 | int snd_pcm_hw_constraint_list(struct snd_pcm_runtime *runtime,
|
|---|
| 849 | unsigned int cond,
|
|---|
| 850 | snd_pcm_hw_param_t var,
|
|---|
| 851 | struct snd_pcm_hw_constraint_list *l);
|
|---|
| 852 | int snd_pcm_hw_constraint_ratnums(struct snd_pcm_runtime *runtime,
|
|---|
| 853 | unsigned int cond,
|
|---|
| 854 | snd_pcm_hw_param_t var,
|
|---|
| 855 | struct snd_pcm_hw_constraint_ratnums *r);
|
|---|
| 856 | int snd_pcm_hw_constraint_ratdens(struct snd_pcm_runtime *runtime,
|
|---|
| 857 | unsigned int cond,
|
|---|
| 858 | snd_pcm_hw_param_t var,
|
|---|
| 859 | struct snd_pcm_hw_constraint_ratdens *r);
|
|---|
| 860 | int snd_pcm_hw_constraint_msbits(struct snd_pcm_runtime *runtime,
|
|---|
| 861 | unsigned int cond,
|
|---|
| 862 | unsigned int width,
|
|---|
| 863 | unsigned int msbits);
|
|---|
| 864 | int snd_pcm_hw_constraint_step(struct snd_pcm_runtime *runtime,
|
|---|
| 865 | unsigned int cond,
|
|---|
| 866 | snd_pcm_hw_param_t var,
|
|---|
| 867 | unsigned long step);
|
|---|
| 868 | int snd_pcm_hw_constraint_pow2(struct snd_pcm_runtime *runtime,
|
|---|
| 869 | unsigned int cond,
|
|---|
| 870 | snd_pcm_hw_param_t var);
|
|---|
| 871 | int snd_pcm_hw_rule_add(struct snd_pcm_runtime *runtime,
|
|---|
| 872 | unsigned int cond,
|
|---|
| 873 | int var,
|
|---|
| 874 | snd_pcm_hw_rule_func_t func, void *private,
|
|---|
| 875 | int dep, ...);
|
|---|
| 876 |
|
|---|
| 877 | int snd_pcm_format_signed(snd_pcm_format_t format);
|
|---|
| 878 | int snd_pcm_format_unsigned(snd_pcm_format_t format);
|
|---|
| 879 | int snd_pcm_format_linear(snd_pcm_format_t format);
|
|---|
| 880 | int snd_pcm_format_little_endian(snd_pcm_format_t format);
|
|---|
| 881 | int snd_pcm_format_big_endian(snd_pcm_format_t format);
|
|---|
| 882 | #if 0 /* just for DocBook */
|
|---|
| 883 | /**
|
|---|
| 884 | * snd_pcm_format_cpu_endian - Check the PCM format is CPU-endian
|
|---|
| 885 | * @format: the format to check
|
|---|
| 886 | *
|
|---|
| 887 | * Returns 1 if the given PCM format is CPU-endian, 0 if
|
|---|
| 888 | * opposite, or a negative error code if endian not specified.
|
|---|
| 889 | */
|
|---|
| 890 | int snd_pcm_format_cpu_endian(snd_pcm_format_t format);
|
|---|
| 891 | #endif /* DocBook */
|
|---|
| 892 | #ifdef SNDRV_LITTLE_ENDIAN
|
|---|
| 893 | #define snd_pcm_format_cpu_endian(format) snd_pcm_format_little_endian(format)
|
|---|
| 894 | #else
|
|---|
| 895 | #define snd_pcm_format_cpu_endian(format) snd_pcm_format_big_endian(format)
|
|---|
| 896 | #endif
|
|---|
| 897 | int snd_pcm_format_width(snd_pcm_format_t format); /* in bits */
|
|---|
| 898 | int snd_pcm_format_physical_width(snd_pcm_format_t format); /* in bits */
|
|---|
| 899 | ssize_t snd_pcm_format_size(snd_pcm_format_t format, size_t samples);
|
|---|
| 900 | const unsigned char *snd_pcm_format_silence_64(snd_pcm_format_t format);
|
|---|
| 901 | int snd_pcm_format_set_silence(snd_pcm_format_t format, void *buf, unsigned int frames);
|
|---|
| 902 | snd_pcm_format_t snd_pcm_build_linear_format(int width, int unsignd, int big_endian);
|
|---|
| 903 | const char *snd_pcm_format_name(snd_pcm_format_t format);
|
|---|
| 904 |
|
|---|
| 905 | void snd_pcm_set_ops(struct snd_pcm * pcm, int direction, struct snd_pcm_ops *ops);
|
|---|
| 906 | void snd_pcm_set_sync(struct snd_pcm_substream *substream);
|
|---|
| 907 | int snd_pcm_lib_interleave_len(struct snd_pcm_substream *substream);
|
|---|
| 908 | int snd_pcm_lib_ioctl(struct snd_pcm_substream *substream,
|
|---|
| 909 | unsigned int cmd, void *arg);
|
|---|
| 910 | int snd_pcm_update_hw_ptr(struct snd_pcm_substream *substream);
|
|---|
| 911 | int snd_pcm_playback_xrun_check(struct snd_pcm_substream *substream);
|
|---|
| 912 | int snd_pcm_capture_xrun_check(struct snd_pcm_substream *substream);
|
|---|
| 913 | int snd_pcm_playback_xrun_asap(struct snd_pcm_substream *substream);
|
|---|
| 914 | int snd_pcm_capture_xrun_asap(struct snd_pcm_substream *substream);
|
|---|
| 915 | void snd_pcm_playback_silence(struct snd_pcm_substream *substream, snd_pcm_uframes_t new_hw_ptr);
|
|---|
| 916 | void snd_pcm_tick_prepare(struct snd_pcm_substream *substream);
|
|---|
| 917 | void snd_pcm_tick_set(struct snd_pcm_substream *substream, unsigned long ticks);
|
|---|
| 918 | void snd_pcm_tick_elapsed(struct snd_pcm_substream *substream);
|
|---|
| 919 | void snd_pcm_period_elapsed(struct snd_pcm_substream *substream);
|
|---|
| 920 | snd_pcm_sframes_t snd_pcm_lib_write(struct snd_pcm_substream *substream,
|
|---|
| 921 | const void __user *buf,
|
|---|
| 922 | snd_pcm_uframes_t frames);
|
|---|
| 923 | snd_pcm_sframes_t snd_pcm_lib_read(struct snd_pcm_substream *substream,
|
|---|
| 924 | void __user *buf, snd_pcm_uframes_t frames);
|
|---|
| 925 | snd_pcm_sframes_t snd_pcm_lib_writev(struct snd_pcm_substream *substream,
|
|---|
| 926 | void __user **bufs, snd_pcm_uframes_t frames);
|
|---|
| 927 | snd_pcm_sframes_t snd_pcm_lib_readv(struct snd_pcm_substream *substream,
|
|---|
| 928 | void __user **bufs, snd_pcm_uframes_t frames);
|
|---|
| 929 |
|
|---|
| 930 | int snd_pcm_limit_hw_rates(struct snd_pcm_runtime *runtime);
|
|---|
| 931 |
|
|---|
| 932 | static inline void snd_pcm_set_runtime_buffer(struct snd_pcm_substream *substream,
|
|---|
| 933 | struct snd_dma_buffer *bufp)
|
|---|
| 934 | {
|
|---|
| 935 | struct snd_pcm_runtime *runtime = substream->runtime;
|
|---|
| 936 | if (bufp) {
|
|---|
| 937 | runtime->dma_buffer_p = bufp;
|
|---|
| 938 | runtime->dma_area = bufp->area;
|
|---|
| 939 | runtime->dma_addr = bufp->addr;
|
|---|
| 940 | runtime->dma_bytes = bufp->bytes;
|
|---|
| 941 | } else {
|
|---|
| 942 | runtime->dma_buffer_p = NULL;
|
|---|
| 943 | runtime->dma_area = NULL;
|
|---|
| 944 | runtime->dma_addr = 0;
|
|---|
| 945 | runtime->dma_bytes = 0;
|
|---|
| 946 | }
|
|---|
| 947 | }
|
|---|
| 948 |
|
|---|
| 949 | /*
|
|---|
| 950 | * Timer interface
|
|---|
| 951 | */
|
|---|
| 952 |
|
|---|
| 953 | void snd_pcm_timer_resolution_change(struct snd_pcm_substream *substream);
|
|---|
| 954 | void snd_pcm_timer_init(struct snd_pcm_substream *substream);
|
|---|
| 955 | void snd_pcm_timer_done(struct snd_pcm_substream *substream);
|
|---|
| 956 |
|
|---|
| 957 | /*
|
|---|
| 958 | * Memory
|
|---|
| 959 | */
|
|---|
| 960 |
|
|---|
| 961 | int snd_pcm_lib_preallocate_free(struct snd_pcm_substream *substream);
|
|---|
| 962 | int snd_pcm_lib_preallocate_free_for_all(struct snd_pcm *pcm);
|
|---|
| 963 | int snd_pcm_lib_preallocate_pages(struct snd_pcm_substream *substream,
|
|---|
| 964 | int type, struct device *data,
|
|---|
| 965 | size_t size, size_t max);
|
|---|
| 966 | int snd_pcm_lib_preallocate_pages_for_all(struct snd_pcm *pcm,
|
|---|
| 967 | int type, void *data,
|
|---|
| 968 | size_t size, size_t max);
|
|---|
| 969 | int snd_pcm_lib_malloc_pages(struct snd_pcm_substream *substream, size_t size);
|
|---|
| 970 | int snd_pcm_lib_free_pages(struct snd_pcm_substream *substream);
|
|---|
| 971 |
|
|---|
| 972 | #define snd_pcm_substream_sgbuf(substream) ((substream)->runtime->dma_buffer_p->private_data)
|
|---|
| 973 | #define snd_pcm_sgbuf_pages(size) snd_sgbuf_aligned_pages(size)
|
|---|
| 974 | #define snd_pcm_sgbuf_get_addr(sgbuf,ofs) snd_sgbuf_get_addr(sgbuf,ofs)
|
|---|
| 975 | struct page *snd_pcm_sgbuf_ops_page(struct snd_pcm_substream *substream, unsigned long offset);
|
|---|
| 976 |
|
|---|
| 977 | /* handle mmap counter - PCM mmap callback should handle this counter properly */
|
|---|
| 978 | static inline void snd_pcm_mmap_data_open(struct vm_area_struct *area)
|
|---|
| 979 | {
|
|---|
| 980 | struct snd_pcm_substream *substream = (struct snd_pcm_substream *)area->vm_private_data;
|
|---|
| 981 | atomic_inc(&substream->runtime->mmap_count);
|
|---|
| 982 | }
|
|---|
| 983 |
|
|---|
| 984 | static inline void snd_pcm_mmap_data_close(struct vm_area_struct *area)
|
|---|
| 985 | {
|
|---|
| 986 | struct snd_pcm_substream *substream = (struct snd_pcm_substream *)area->vm_private_data;
|
|---|
| 987 | atomic_dec(&substream->runtime->mmap_count);
|
|---|
| 988 | }
|
|---|
| 989 |
|
|---|
| 990 | /* mmap for io-memory area */
|
|---|
| 991 | #if defined(CONFIG_X86) || defined(CONFIG_PPC) || defined(CONFIG_ALPHA)
|
|---|
| 992 | #define SNDRV_PCM_INFO_MMAP_IOMEM SNDRV_PCM_INFO_MMAP
|
|---|
| 993 | int snd_pcm_lib_mmap_iomem(struct snd_pcm_substream *substream, struct vm_area_struct *area);
|
|---|
| 994 | #else
|
|---|
| 995 | #define SNDRV_PCM_INFO_MMAP_IOMEM 0
|
|---|
| 996 | #define snd_pcm_lib_mmap_iomem NULL
|
|---|
| 997 | #endif
|
|---|
| 998 |
|
|---|
| 999 | static inline void snd_pcm_limit_isa_dma_size(int dma, size_t *max)
|
|---|
| 1000 | {
|
|---|
| 1001 | *max = dma < 4 ? 64 * 1024 : 128 * 1024;
|
|---|
| 1002 | }
|
|---|
| 1003 |
|
|---|
| 1004 | /*
|
|---|
| 1005 | * Misc
|
|---|
| 1006 | */
|
|---|
| 1007 |
|
|---|
| 1008 | #define SNDRV_PCM_DEFAULT_CON_SPDIF (IEC958_AES0_CON_EMPHASIS_NONE|\
|
|---|
| 1009 | (IEC958_AES1_CON_ORIGINAL<<8)|\
|
|---|
| 1010 | (IEC958_AES1_CON_PCM_CODER<<8)|\
|
|---|
| 1011 | (IEC958_AES3_CON_FS_48000<<24))
|
|---|
| 1012 |
|
|---|
| 1013 | #endif /* __SOUND_PCM_H */
|
|---|