5 * Digital Audio (PCM) abstract layer
6 * Copyright (c) by Jaroslav Kysela <perex@suse.cz>
7 * Abramo Bagnara <abramo@alsa-project.org>
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.
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.
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
26 #include <sound/asound.h>
27 #include <sound/memalloc.h>
28 #include <linux/poll.h>
29 #include <linux/bitops.h>
31 typedef sndrv_pcm_uframes_t snd_pcm_uframes_t;
32 typedef sndrv_pcm_sframes_t snd_pcm_sframes_t;
33 typedef enum sndrv_pcm_class snd_pcm_class_t;
34 typedef enum sndrv_pcm_subclass snd_pcm_subclass_t;
35 typedef enum sndrv_pcm_stream snd_pcm_stream_t;
36 typedef enum sndrv_pcm_access snd_pcm_access_t;
37 typedef enum sndrv_pcm_format snd_pcm_format_t;
38 typedef enum sndrv_pcm_subformat snd_pcm_subformat_t;
39 typedef enum sndrv_pcm_state snd_pcm_state_t;
40 typedef union sndrv_pcm_sync_id snd_pcm_sync_id_t;
41 typedef struct sndrv_pcm_info snd_pcm_info_t;
42 typedef enum sndrv_pcm_hw_param snd_pcm_hw_param_t;
43 typedef struct sndrv_pcm_hw_params snd_pcm_hw_params_t;
44 typedef enum sndrv_pcm_start snd_pcm_start_t;
45 typedef enum sndrv_pcm_xrun snd_pcm_xrun_t;
46 typedef enum sndrv_pcm_tstamp snd_pcm_tstamp_t;
47 typedef struct sndrv_pcm_sw_params snd_pcm_sw_params_t;
48 typedef struct sndrv_pcm_channel_info snd_pcm_channel_info_t;
49 typedef struct sndrv_pcm_status snd_pcm_status_t;
50 typedef struct sndrv_pcm_mmap_status snd_pcm_mmap_status_t;
51 typedef struct sndrv_pcm_mmap_control snd_pcm_mmap_control_t;
52 typedef struct sndrv_mask snd_mask_t;
53 typedef struct snd_sg_buf snd_pcm_sgbuf_t;
55 #define _snd_pcm_substream_chip(substream) ((substream)->private_data)
56 #define snd_pcm_substream_chip(substream) snd_magic_cast1(chip_t, _snd_pcm_substream_chip(substream), return -ENXIO)
57 #define _snd_pcm_chip(pcm) ((pcm)->private_data)
58 #define snd_pcm_chip(pcm) snd_magic_cast1(chip_t, _snd_pcm_chip(pcm), return -ENXIO)
60 typedef struct _snd_pcm_file snd_pcm_file_t;
61 typedef struct _snd_pcm_runtime snd_pcm_runtime_t;
63 #if defined(CONFIG_SND_PCM_OSS) || defined(CONFIG_SND_PCM_OSS_MODULE)
68 * Hardware (lowlevel) section
71 typedef struct _snd_pcm_hardware {
72 unsigned int info; /* SNDRV_PCM_INFO_* */
73 u64 formats; /* SNDRV_PCM_FMTBIT_* */
74 unsigned int rates; /* SNDRV_PCM_RATE_* */
75 unsigned int rate_min; /* min rate */
76 unsigned int rate_max; /* max rate */
77 unsigned int channels_min; /* min channels */
78 unsigned int channels_max; /* max channels */
79 size_t buffer_bytes_max; /* max buffer size */
80 size_t period_bytes_min; /* min period size */
81 size_t period_bytes_max; /* max period size */
82 unsigned int periods_min; /* min # of periods */
83 unsigned int periods_max; /* max # of periods */
84 size_t fifo_size; /* fifo size in bytes */
87 typedef struct _snd_pcm_ops {
88 int (*open)(snd_pcm_substream_t *substream);
89 int (*close)(snd_pcm_substream_t *substream);
90 int (*ioctl)(snd_pcm_substream_t * substream,
91 unsigned int cmd, void *arg);
92 int (*hw_params)(snd_pcm_substream_t * substream, snd_pcm_hw_params_t * params);
93 int (*hw_free)(snd_pcm_substream_t *substream);
94 int (*prepare)(snd_pcm_substream_t * substream);
95 int (*trigger)(snd_pcm_substream_t * substream, int cmd);
96 snd_pcm_uframes_t (*pointer)(snd_pcm_substream_t * substream);
97 int (*copy)(snd_pcm_substream_t *substream, int channel, snd_pcm_uframes_t pos,
98 void *buf, snd_pcm_uframes_t count);
99 int (*silence)(snd_pcm_substream_t *substream, int channel,
100 snd_pcm_uframes_t pos, snd_pcm_uframes_t count);
101 struct page *(*page)(snd_pcm_substream_t *substream, unsigned long offset);
102 int (*ack)(snd_pcm_substream_t *substream);
109 #define SNDRV_PCM_DEVICES 8
111 #define SNDRV_PCM_IOCTL1_FALSE ((void *)0)
112 #define SNDRV_PCM_IOCTL1_TRUE ((void *)1)
114 #define SNDRV_PCM_IOCTL1_RESET 0
115 #define SNDRV_PCM_IOCTL1_INFO 1
116 #define SNDRV_PCM_IOCTL1_CHANNEL_INFO 2
117 #define SNDRV_PCM_IOCTL1_GSTATE 3
119 #define SNDRV_PCM_TRIGGER_STOP 0
120 #define SNDRV_PCM_TRIGGER_START 1
121 #define SNDRV_PCM_TRIGGER_PAUSE_PUSH 3
122 #define SNDRV_PCM_TRIGGER_PAUSE_RELEASE 4
123 #define SNDRV_PCM_TRIGGER_SUSPEND 5
124 #define SNDRV_PCM_TRIGGER_RESUME 6
126 /* If you change this don't forget to change rates[] table in pcm_native.c */
127 #define SNDRV_PCM_RATE_5512 (1<<0) /* 5512Hz */
128 #define SNDRV_PCM_RATE_8000 (1<<1) /* 8000Hz */
129 #define SNDRV_PCM_RATE_11025 (1<<2) /* 11025Hz */
130 #define SNDRV_PCM_RATE_16000 (1<<3) /* 16000Hz */
131 #define SNDRV_PCM_RATE_22050 (1<<4) /* 22050Hz */
132 #define SNDRV_PCM_RATE_32000 (1<<5) /* 32000Hz */
133 #define SNDRV_PCM_RATE_44100 (1<<6) /* 44100Hz */
134 #define SNDRV_PCM_RATE_48000 (1<<7) /* 48000Hz */
135 #define SNDRV_PCM_RATE_64000 (1<<8) /* 64000Hz */
136 #define SNDRV_PCM_RATE_88200 (1<<9) /* 88200Hz */
137 #define SNDRV_PCM_RATE_96000 (1<<10) /* 96000Hz */
138 #define SNDRV_PCM_RATE_176400 (1<<11) /* 176400Hz */
139 #define SNDRV_PCM_RATE_192000 (1<<12) /* 192000Hz */
141 #define SNDRV_PCM_RATE_CONTINUOUS (1<<30) /* continuous range */
142 #define SNDRV_PCM_RATE_KNOT (1<<31) /* supports more non-continuos rates */
144 #define SNDRV_PCM_RATE_8000_44100 (SNDRV_PCM_RATE_8000|SNDRV_PCM_RATE_11025|\
145 SNDRV_PCM_RATE_16000|SNDRV_PCM_RATE_22050|\
146 SNDRV_PCM_RATE_32000|SNDRV_PCM_RATE_44100)
147 #define SNDRV_PCM_RATE_8000_48000 (SNDRV_PCM_RATE_8000_44100|SNDRV_PCM_RATE_48000)
148 #define SNDRV_PCM_RATE_8000_96000 (SNDRV_PCM_RATE_8000_48000|SNDRV_PCM_RATE_64000|\
149 SNDRV_PCM_RATE_88200|SNDRV_PCM_RATE_96000)
150 #define SNDRV_PCM_RATE_8000_192000 (SNDRV_PCM_RATE_8000_96000|SNDRV_PCM_RATE_176400|\
151 SNDRV_PCM_RATE_192000)
152 #define SNDRV_PCM_FMTBIT_S8 (1ULL << SNDRV_PCM_FORMAT_S8)
153 #define SNDRV_PCM_FMTBIT_U8 (1ULL << SNDRV_PCM_FORMAT_U8)
154 #define SNDRV_PCM_FMTBIT_S16_LE (1ULL << SNDRV_PCM_FORMAT_S16_LE)
155 #define SNDRV_PCM_FMTBIT_S16_BE (1ULL << SNDRV_PCM_FORMAT_S16_BE)
156 #define SNDRV_PCM_FMTBIT_U16_LE (1ULL << SNDRV_PCM_FORMAT_U16_LE)
157 #define SNDRV_PCM_FMTBIT_U16_BE (1ULL << SNDRV_PCM_FORMAT_U16_BE)
158 #define SNDRV_PCM_FMTBIT_S24_LE (1ULL << SNDRV_PCM_FORMAT_S24_LE)
159 #define SNDRV_PCM_FMTBIT_S24_BE (1ULL << SNDRV_PCM_FORMAT_S24_BE)
160 #define SNDRV_PCM_FMTBIT_U24_LE (1ULL << SNDRV_PCM_FORMAT_U24_LE)
161 #define SNDRV_PCM_FMTBIT_U24_BE (1ULL << SNDRV_PCM_FORMAT_U24_BE)
162 #define SNDRV_PCM_FMTBIT_S32_LE (1ULL << SNDRV_PCM_FORMAT_S32_LE)
163 #define SNDRV_PCM_FMTBIT_S32_BE (1ULL << SNDRV_PCM_FORMAT_S32_BE)
164 #define SNDRV_PCM_FMTBIT_U32_LE (1ULL << SNDRV_PCM_FORMAT_U32_LE)
165 #define SNDRV_PCM_FMTBIT_U32_BE (1ULL << SNDRV_PCM_FORMAT_U32_BE)
166 #define SNDRV_PCM_FMTBIT_FLOAT_LE (1ULL << SNDRV_PCM_FORMAT_FLOAT_LE)
167 #define SNDRV_PCM_FMTBIT_FLOAT_BE (1ULL << SNDRV_PCM_FORMAT_FLOAT_BE)
168 #define SNDRV_PCM_FMTBIT_FLOAT64_LE (1ULL << SNDRV_PCM_FORMAT_FLOAT64_LE)
169 #define SNDRV_PCM_FMTBIT_FLOAT64_BE (1ULL << SNDRV_PCM_FORMAT_FLOAT64_BE)
170 #define SNDRV_PCM_FMTBIT_IEC958_SUBFRAME_LE (1ULL << SNDRV_PCM_FORMAT_IEC958_SUBFRAME_LE)
171 #define SNDRV_PCM_FMTBIT_IEC958_SUBFRAME_BE (1ULL << SNDRV_PCM_FORMAT_IEC958_SUBFRAME_BE)
172 #define SNDRV_PCM_FMTBIT_MU_LAW (1ULL << SNDRV_PCM_FORMAT_MU_LAW)
173 #define SNDRV_PCM_FMTBIT_A_LAW (1ULL << SNDRV_PCM_FORMAT_A_LAW)
174 #define SNDRV_PCM_FMTBIT_IMA_ADPCM (1ULL << SNDRV_PCM_FORMAT_IMA_ADPCM)
175 #define SNDRV_PCM_FMTBIT_MPEG (1ULL << SNDRV_PCM_FORMAT_MPEG)
176 #define SNDRV_PCM_FMTBIT_GSM (1ULL << SNDRV_PCM_FORMAT_GSM)
177 #define SNDRV_PCM_FMTBIT_SPECIAL (1ULL << SNDRV_PCM_FORMAT_SPECIAL)
178 #define SNDRV_PCM_FMTBIT_S24_3LE (1ULL << SNDRV_PCM_FORMAT_S24_3LE)
179 #define SNDRV_PCM_FMTBIT_U24_3LE (1ULL << SNDRV_PCM_FORMAT_U24_3LE)
180 #define SNDRV_PCM_FMTBIT_S24_3BE (1ULL << SNDRV_PCM_FORMAT_S24_3BE)
181 #define SNDRV_PCM_FMTBIT_U24_3BE (1ULL << SNDRV_PCM_FORMAT_U24_3BE)
182 #define SNDRV_PCM_FMTBIT_S20_3LE (1ULL << SNDRV_PCM_FORMAT_S20_3LE)
183 #define SNDRV_PCM_FMTBIT_U20_3LE (1ULL << SNDRV_PCM_FORMAT_U20_3LE)
184 #define SNDRV_PCM_FMTBIT_S20_3BE (1ULL << SNDRV_PCM_FORMAT_S20_3BE)
185 #define SNDRV_PCM_FMTBIT_U20_3BE (1ULL << SNDRV_PCM_FORMAT_U20_3BE)
186 #define SNDRV_PCM_FMTBIT_S18_3LE (1ULL << SNDRV_PCM_FORMAT_S18_3LE)
187 #define SNDRV_PCM_FMTBIT_U18_3LE (1ULL << SNDRV_PCM_FORMAT_U18_3LE)
188 #define SNDRV_PCM_FMTBIT_S18_3BE (1ULL << SNDRV_PCM_FORMAT_S18_3BE)
189 #define SNDRV_PCM_FMTBIT_U18_3BE (1ULL << SNDRV_PCM_FORMAT_U18_3BE)
191 #ifdef SNDRV_LITTLE_ENDIAN
192 #define SNDRV_PCM_FMTBIT_S16 SNDRV_PCM_FMTBIT_S16_LE
193 #define SNDRV_PCM_FMTBIT_U16 SNDRV_PCM_FMTBIT_U16_LE
194 #define SNDRV_PCM_FMTBIT_S24 SNDRV_PCM_FMTBIT_S24_LE
195 #define SNDRV_PCM_FMTBIT_U24 SNDRV_PCM_FMTBIT_U24_LE
196 #define SNDRV_PCM_FMTBIT_S32 SNDRV_PCM_FMTBIT_S32_LE
197 #define SNDRV_PCM_FMTBIT_U32 SNDRV_PCM_FMTBIT_U32_LE
198 #define SNDRV_PCM_FMTBIT_FLOAT SNDRV_PCM_FMTBIT_FLOAT_LE
199 #define SNDRV_PCM_FMTBIT_FLOAT64 SNDRV_PCM_FMTBIT_FLOAT64_LE
200 #define SNDRV_PCM_FMTBIT_IEC958_SUBFRAME SNDRV_PCM_FMTBIT_IEC958_SUBFRAME_LE
202 #ifdef SNDRV_BIG_ENDIAN
203 #define SNDRV_PCM_FMTBIT_S16 SNDRV_PCM_FMTBIT_S16_BE
204 #define SNDRV_PCM_FMTBIT_U16 SNDRV_PCM_FMTBIT_U16_BE
205 #define SNDRV_PCM_FMTBIT_S24 SNDRV_PCM_FMTBIT_S24_BE
206 #define SNDRV_PCM_FMTBIT_U24 SNDRV_PCM_FMTBIT_U24_BE
207 #define SNDRV_PCM_FMTBIT_S32 SNDRV_PCM_FMTBIT_S32_BE
208 #define SNDRV_PCM_FMTBIT_U32 SNDRV_PCM_FMTBIT_U32_BE
209 #define SNDRV_PCM_FMTBIT_FLOAT SNDRV_PCM_FMTBIT_FLOAT_BE
210 #define SNDRV_PCM_FMTBIT_FLOAT64 SNDRV_PCM_FMTBIT_FLOAT64_BE
211 #define SNDRV_PCM_FMTBIT_IEC958_SUBFRAME SNDRV_PCM_FMTBIT_IEC958_SUBFRAME_BE
214 struct _snd_pcm_file {
215 snd_pcm_substream_t * substream;
216 struct _snd_pcm_file * next;
219 typedef struct _snd_pcm_hw_rule snd_pcm_hw_rule_t;
221 typedef int (*snd_pcm_hw_rule_func_t)(snd_pcm_hw_params_t *params,
222 snd_pcm_hw_rule_t *rule);
224 struct _snd_pcm_hw_rule {
226 snd_pcm_hw_rule_func_t func;
232 typedef struct _snd_pcm_hw_constraints {
233 snd_mask_t masks[SNDRV_PCM_HW_PARAM_LAST_MASK -
234 SNDRV_PCM_HW_PARAM_FIRST_MASK + 1];
235 snd_interval_t intervals[SNDRV_PCM_HW_PARAM_LAST_INTERVAL -
236 SNDRV_PCM_HW_PARAM_FIRST_INTERVAL + 1];
237 unsigned int rules_num;
238 unsigned int rules_all;
239 snd_pcm_hw_rule_t *rules;
240 } snd_pcm_hw_constraints_t;
242 static inline snd_mask_t *constrs_mask(snd_pcm_hw_constraints_t *constrs,
243 snd_pcm_hw_param_t var)
245 return &constrs->masks[var - SNDRV_PCM_HW_PARAM_FIRST_MASK];
248 static inline snd_interval_t *constrs_interval(snd_pcm_hw_constraints_t *constrs,
249 snd_pcm_hw_param_t var)
251 return &constrs->intervals[var - SNDRV_PCM_HW_PARAM_FIRST_INTERVAL];
256 unsigned int den_min, den_max, den_step;
260 unsigned int num_min, num_max, num_step;
267 } snd_pcm_hw_constraint_ratnums_t;
272 } snd_pcm_hw_constraint_ratdens_t;
278 } snd_pcm_hw_constraint_list_t;
280 struct _snd_pcm_runtime {
282 snd_pcm_substream_t *trigger_master;
283 snd_timestamp_t trigger_tstamp; /* trigger timestamp */
285 snd_pcm_uframes_t avail_max;
286 snd_pcm_uframes_t hw_ptr_base; /* Position at buffer restart */
287 snd_pcm_uframes_t hw_ptr_interrupt; /* Position at interrupt time*/
289 /* -- HW params -- */
290 snd_pcm_access_t access; /* access mode */
291 snd_pcm_format_t format; /* SNDRV_PCM_FORMAT_* */
292 snd_pcm_subformat_t subformat; /* subformat */
293 unsigned int rate; /* rate in Hz */
294 unsigned int channels; /* channels */
295 snd_pcm_uframes_t period_size; /* period size */
296 unsigned int periods; /* periods */
297 snd_pcm_uframes_t buffer_size; /* buffer size */
298 unsigned int tick_time; /* tick time */
299 snd_pcm_uframes_t min_align; /* Min alignment for the format */
301 unsigned int frame_bits;
302 unsigned int sample_bits;
304 unsigned int rate_num;
305 unsigned int rate_den;
307 /* -- SW params -- */
308 int tstamp_timespec; /* use timeval (0) or timespec (1) */
309 snd_pcm_tstamp_t tstamp_mode; /* mmap timestamp is updated */
310 unsigned int period_step;
311 unsigned int sleep_min; /* min ticks to sleep */
312 snd_pcm_uframes_t xfer_align; /* xfer size need to be a multiple */
313 snd_pcm_uframes_t start_threshold;
314 snd_pcm_uframes_t stop_threshold;
315 snd_pcm_uframes_t silence_threshold; /* Silence filling happens when
316 noise is nearest than this */
317 snd_pcm_uframes_t silence_size; /* Silence filling size */
318 snd_pcm_uframes_t boundary; /* pointers wrap point */
320 snd_pcm_uframes_t silence_start; /* starting pointer to silence area */
321 snd_pcm_uframes_t silence_filled; /* size filled with silence */
323 snd_pcm_sync_id_t sync; /* hardware synchronization ID */
326 volatile snd_pcm_mmap_status_t *status;
327 volatile snd_pcm_mmap_control_t *control;
330 /* -- locking / scheduling -- */
331 wait_queue_head_t sleep;
332 struct timer_list tick_timer;
333 struct fasync_struct *fasync;
335 /* -- private section -- */
337 void (*private_free)(snd_pcm_runtime_t *runtime);
339 /* -- hardware description -- */
340 snd_pcm_hardware_t hw;
341 snd_pcm_hw_constraints_t hw_constraints;
343 /* -- interrupt callbacks -- */
344 void (*transfer_ack_begin)(snd_pcm_substream_t *substream);
345 void (*transfer_ack_end)(snd_pcm_substream_t *substream);
348 unsigned int timer_resolution; /* timer resolution */
351 unsigned char *dma_area; /* DMA area */
352 dma_addr_t dma_addr; /* physical bus address (not accessible from main CPU) */
353 size_t dma_bytes; /* size of DMA area */
354 void *dma_private; /* private DMA data for the memory allocator */
356 #if defined(CONFIG_SND_PCM_OSS) || defined(CONFIG_SND_PCM_OSS_MODULE)
357 /* -- OSS things -- */
358 snd_pcm_oss_runtime_t oss;
362 typedef struct _snd_pcm_group { /* keep linked substreams */
364 struct list_head substreams;
367 struct _snd_pcm_substream {
370 void *private_data; /* copied from pcm->private_data */
372 char name[32]; /* substream name */
373 int stream; /* stream (direction) */
374 size_t buffer_bytes_max; /* limit ring buffer size */
375 struct snd_dma_device dma_device;
376 struct snd_dma_buffer dma_buffer;
378 /* -- hardware operations -- */
379 unsigned int open_flag: 1; /* lowlevel device has been opened */
381 /* -- runtime information -- */
382 snd_pcm_runtime_t *runtime;
383 /* -- timer section -- */
384 snd_timer_t *timer; /* timer */
385 int timer_running: 1; /* time is running */
386 spinlock_t timer_lock;
387 /* -- next substream -- */
388 snd_pcm_substream_t *next;
389 /* -- linked substreams -- */
390 struct list_head link_list; /* linked list member */
391 snd_pcm_group_t self_group; /* fake group for non linked substream (with substream lock inside) */
392 snd_pcm_group_t *group; /* pointer to current group */
393 /* -- assigned files -- */
394 snd_pcm_file_t *file;
396 #if defined(CONFIG_SND_PCM_OSS) || defined(CONFIG_SND_PCM_OSS_MODULE)
397 /* -- OSS things -- */
398 snd_pcm_oss_substream_t oss;
400 snd_info_entry_t *proc_root;
401 snd_info_entry_t *proc_info_entry;
402 snd_info_entry_t *proc_hw_params_entry;
403 snd_info_entry_t *proc_sw_params_entry;
404 snd_info_entry_t *proc_status_entry;
405 snd_info_entry_t *proc_prealloc_entry;
408 #if defined(CONFIG_SND_PCM_OSS) || defined(CONFIG_SND_PCM_OSS_MODULE)
409 #define SUBSTREAM_BUSY(substream) ((substream)->file != NULL || ((substream)->oss.file != NULL))
411 #define SUBSTREAM_BUSY(substream) ((substream)->file != NULL)
415 struct _snd_pcm_str {
416 int stream; /* stream (direction) */
418 /* -- substreams -- */
419 unsigned int substream_count;
420 unsigned int substream_opened;
421 snd_pcm_substream_t *substream;
422 #if defined(CONFIG_SND_PCM_OSS) || defined(CONFIG_SND_PCM_OSS_MODULE)
423 /* -- OSS things -- */
424 snd_pcm_oss_stream_t oss;
426 snd_pcm_file_t *files;
428 snd_info_entry_t *proc_root;
429 snd_info_entry_t *proc_info_entry;
430 #ifdef CONFIG_SND_DEBUG
431 unsigned int xrun_debug; /* 0 = disabled, 1 = verbose, 2 = stacktrace */
432 snd_info_entry_t *proc_xrun_debug_entry;
438 unsigned int device; /* device number */
439 unsigned int info_flags;
440 unsigned short dev_class;
441 unsigned short dev_subclass;
444 snd_pcm_str_t streams[2];
445 struct semaphore open_mutex;
446 wait_queue_head_t open_wait;
448 void (*private_free) (snd_pcm_t *pcm);
449 #if defined(CONFIG_SND_PCM_OSS) || defined(CONFIG_SND_PCM_OSS_MODULE)
454 typedef struct _snd_pcm_notify {
455 int (*n_register) (snd_pcm_t * pcm);
456 int (*n_disconnect) (snd_pcm_t * pcm);
457 int (*n_unregister) (snd_pcm_t * pcm);
458 struct list_head list;
465 extern snd_pcm_t *snd_pcm_devices[];
466 extern snd_minor_t snd_pcm_reg[2];
468 int snd_pcm_new(snd_card_t * card, char *id, int device,
469 int playback_count, int capture_count,
471 int snd_pcm_new_stream(snd_pcm_t *pcm, int stream, int substream_count);
473 int snd_pcm_notify(snd_pcm_notify_t *notify, int nfree);
479 extern rwlock_t snd_pcm_link_rwlock;
481 int snd_pcm_info(snd_pcm_substream_t * substream, snd_pcm_info_t *info);
482 int snd_pcm_info_user(snd_pcm_substream_t * substream, snd_pcm_info_t *info);
483 int snd_pcm_status(snd_pcm_substream_t * substream, snd_pcm_status_t *status);
484 int snd_pcm_prepare(snd_pcm_substream_t *substream);
485 int snd_pcm_start(snd_pcm_substream_t *substream);
486 int snd_pcm_stop(snd_pcm_substream_t *substream, int status);
488 int snd_pcm_suspend(snd_pcm_substream_t *substream);
489 int snd_pcm_suspend_all(snd_pcm_t *pcm);
491 int snd_pcm_kernel_playback_ioctl(snd_pcm_substream_t *substream, unsigned int cmd, void *arg);
492 int snd_pcm_kernel_capture_ioctl(snd_pcm_substream_t *substream, unsigned int cmd, void *arg);
493 int snd_pcm_kernel_ioctl(snd_pcm_substream_t *substream, unsigned int cmd, void *arg);
494 int snd_pcm_open(struct inode *inode, struct file *file);
495 int snd_pcm_release(struct inode *inode, struct file *file);
496 unsigned int snd_pcm_playback_poll(struct file *file, poll_table * wait);
497 unsigned int snd_pcm_capture_poll(struct file *file, poll_table * wait);
498 int snd_pcm_open_substream(snd_pcm_t *pcm, int stream, snd_pcm_substream_t **rsubstream);
499 void snd_pcm_release_substream(snd_pcm_substream_t *substream);
500 void snd_pcm_vma_notify_data(void *client, void *data);
501 int snd_pcm_mmap_data(snd_pcm_substream_t *substream, struct file *file, struct vm_area_struct *area);
503 #if BITS_PER_LONG >= 64
505 static inline void div64_32(u_int64_t *n, u_int32_t div, u_int32_t *rem)
513 static inline void div64_32(u_int64_t *n, u_int32_t div, u_int32_t *rem)
516 low = *n & 0xffffffff;
519 u_int32_t high1 = high % div;
521 asm("divl %2":"=a" (low), "=d" (*rem):"rm" (div), "a" (low), "d" (high1));
522 *n = (u_int64_t)high << 32 | low;
530 static inline void divl(u_int32_t high, u_int32_t low,
532 u_int32_t *q, u_int32_t *r)
534 u_int64_t n = (u_int64_t)high << 32 | low;
535 u_int64_t d = (u_int64_t)div << 31;
538 while (n > 0xffffffffU) {
550 *q = q1 | (low / div);
559 static inline void div64_32(u_int64_t *n, u_int32_t div, u_int32_t *rem)
562 low = *n & 0xffffffff;
565 u_int32_t high1 = high % div;
566 u_int32_t low1 = low;
568 divl(high1, low1, div, &low, rem);
569 *n = (u_int64_t)high << 32 | low;
581 static inline int snd_pcm_stream_linked(snd_pcm_substream_t *substream)
583 return substream->group != &substream->self_group;
586 static inline void snd_pcm_stream_lock(snd_pcm_substream_t *substream)
588 read_lock(&snd_pcm_link_rwlock);
589 spin_lock(&substream->self_group.lock);
592 static inline void snd_pcm_stream_unlock(snd_pcm_substream_t *substream)
594 spin_unlock(&substream->self_group.lock);
595 read_unlock(&snd_pcm_link_rwlock);
598 static inline void snd_pcm_stream_lock_irq(snd_pcm_substream_t *substream)
600 read_lock_irq(&snd_pcm_link_rwlock);
601 spin_lock(&substream->self_group.lock);
604 static inline void snd_pcm_stream_unlock_irq(snd_pcm_substream_t *substream)
606 spin_unlock(&substream->self_group.lock);
607 read_unlock_irq(&snd_pcm_link_rwlock);
610 #define snd_pcm_stream_lock_irqsave(substream, flags) \
612 read_lock_irqsave(&snd_pcm_link_rwlock, (flags)); \
613 spin_lock(&substream->self_group.lock); \
616 #define snd_pcm_stream_unlock_irqrestore(substream, flags) \
618 spin_unlock(&substream->self_group.lock); \
619 read_unlock_irqrestore(&snd_pcm_link_rwlock, (flags)); \
622 #define snd_pcm_group_for_each(pos, substream) \
623 list_for_each(pos, &substream->group->substreams)
625 #define snd_pcm_group_substream_entry(pos) \
626 list_entry(pos, snd_pcm_substream_t, link_list)
628 static inline int snd_pcm_running(snd_pcm_substream_t *substream)
630 return (substream->runtime->status->state == SNDRV_PCM_STATE_RUNNING ||
631 (substream->runtime->status->state == SNDRV_PCM_STATE_DRAINING &&
632 substream->stream == SNDRV_PCM_STREAM_PLAYBACK));
635 static inline ssize_t bytes_to_samples(snd_pcm_runtime_t *runtime, ssize_t size)
637 return size * 8 / runtime->sample_bits;
640 static inline snd_pcm_sframes_t bytes_to_frames(snd_pcm_runtime_t *runtime, ssize_t size)
642 return size * 8 / runtime->frame_bits;
645 static inline ssize_t samples_to_bytes(snd_pcm_runtime_t *runtime, ssize_t size)
647 return size * runtime->sample_bits / 8;
650 static inline ssize_t frames_to_bytes(snd_pcm_runtime_t *runtime, snd_pcm_sframes_t size)
652 return size * runtime->frame_bits / 8;
655 static inline int frame_aligned(snd_pcm_runtime_t *runtime, ssize_t bytes)
657 return bytes % runtime->byte_align == 0;
660 static inline size_t snd_pcm_lib_buffer_bytes(snd_pcm_substream_t *substream)
662 snd_pcm_runtime_t *runtime = substream->runtime;
663 return frames_to_bytes(runtime, runtime->buffer_size);
666 static inline size_t snd_pcm_lib_period_bytes(snd_pcm_substream_t *substream)
668 snd_pcm_runtime_t *runtime = substream->runtime;
669 return frames_to_bytes(runtime, runtime->period_size);
673 * result is: 0 ... (boundary - 1)
675 static inline snd_pcm_uframes_t snd_pcm_playback_avail(snd_pcm_runtime_t *runtime)
677 snd_pcm_sframes_t avail = runtime->status->hw_ptr + runtime->buffer_size - runtime->control->appl_ptr;
679 avail += runtime->boundary;
680 else if ((snd_pcm_uframes_t) avail >= runtime->boundary)
681 avail -= runtime->boundary;
686 * result is: 0 ... (boundary - 1)
688 static inline snd_pcm_uframes_t snd_pcm_capture_avail(snd_pcm_runtime_t *runtime)
690 snd_pcm_sframes_t avail = runtime->status->hw_ptr - runtime->control->appl_ptr;
692 avail += runtime->boundary;
696 static inline snd_pcm_sframes_t snd_pcm_playback_hw_avail(snd_pcm_runtime_t *runtime)
698 return runtime->buffer_size - snd_pcm_playback_avail(runtime);
701 static inline snd_pcm_sframes_t snd_pcm_capture_hw_avail(snd_pcm_runtime_t *runtime)
703 return runtime->buffer_size - snd_pcm_capture_avail(runtime);
706 static inline void snd_pcm_trigger_done(snd_pcm_substream_t *substream,
707 snd_pcm_substream_t *master)
709 substream->runtime->trigger_master = master;
712 static inline int hw_is_mask(int var)
714 return var >= SNDRV_PCM_HW_PARAM_FIRST_MASK &&
715 var <= SNDRV_PCM_HW_PARAM_LAST_MASK;
718 static inline int hw_is_interval(int var)
720 return var >= SNDRV_PCM_HW_PARAM_FIRST_INTERVAL &&
721 var <= SNDRV_PCM_HW_PARAM_LAST_INTERVAL;
724 static inline snd_mask_t *hw_param_mask(snd_pcm_hw_params_t *params,
725 snd_pcm_hw_param_t var)
727 return ¶ms->masks[var - SNDRV_PCM_HW_PARAM_FIRST_MASK];
730 static inline snd_interval_t *hw_param_interval(snd_pcm_hw_params_t *params,
731 snd_pcm_hw_param_t var)
733 return ¶ms->intervals[var - SNDRV_PCM_HW_PARAM_FIRST_INTERVAL];
736 static inline const snd_mask_t *hw_param_mask_c(const snd_pcm_hw_params_t *params,
737 snd_pcm_hw_param_t var)
739 return (const snd_mask_t *)hw_param_mask((snd_pcm_hw_params_t*) params, var);
742 static inline const snd_interval_t *hw_param_interval_c(const snd_pcm_hw_params_t *params,
743 snd_pcm_hw_param_t var)
745 return (const snd_interval_t *)hw_param_interval((snd_pcm_hw_params_t*) params, var);
748 #define params_access(p) snd_mask_min(hw_param_mask((p), SNDRV_PCM_HW_PARAM_ACCESS))
749 #define params_format(p) snd_mask_min(hw_param_mask((p), SNDRV_PCM_HW_PARAM_FORMAT))
750 #define params_subformat(p) snd_mask_min(hw_param_mask((p), SNDRV_PCM_HW_PARAM_SUBFORMAT))
751 #define params_channels(p) hw_param_interval((p), SNDRV_PCM_HW_PARAM_CHANNELS)->min
752 #define params_rate(p) hw_param_interval((p), SNDRV_PCM_HW_PARAM_RATE)->min
753 #define params_period_size(p) hw_param_interval((p), SNDRV_PCM_HW_PARAM_PERIOD_SIZE)->min
754 #define params_period_bytes(p) ((params_period_size(p)*snd_pcm_format_physical_width(params_format(p))*params_channels(p))/8)
755 #define params_periods(p) hw_param_interval((p), SNDRV_PCM_HW_PARAM_PERIODS)->min
756 #define params_buffer_size(p) hw_param_interval((p), SNDRV_PCM_HW_PARAM_BUFFER_SIZE)->min
757 #define params_buffer_bytes(p) hw_param_interval((p), SNDRV_PCM_HW_PARAM_BUFFER_BYTES)->min
758 #define params_tick_time(p) hw_param_interval((p), SNDRV_PCM_HW_PARAM_TICK_TIME)->min
761 int snd_interval_refine(snd_interval_t *i, const snd_interval_t *v);
762 void snd_interval_mul(const snd_interval_t *a, const snd_interval_t *b, snd_interval_t *c);
763 void snd_interval_div(const snd_interval_t *a, const snd_interval_t *b, snd_interval_t *c);
764 void snd_interval_muldivk(const snd_interval_t *a, const snd_interval_t *b,
765 unsigned int k, snd_interval_t *c);
766 void snd_interval_mulkdiv(const snd_interval_t *a, unsigned int k,
767 const snd_interval_t *b, snd_interval_t *c);
768 int snd_interval_list(snd_interval_t *i, unsigned int count, unsigned int *list, unsigned int mask);
769 int snd_interval_step(snd_interval_t *i, unsigned int min, unsigned int step);
770 int snd_interval_ratnum(snd_interval_t *i,
771 unsigned int rats_count, ratnum_t *rats,
772 unsigned int *nump, unsigned int *denp);
773 int snd_interval_ratden(snd_interval_t *i,
774 unsigned int rats_count, ratden_t *rats,
775 unsigned int *nump, unsigned int *denp);
777 void _snd_pcm_hw_params_any(snd_pcm_hw_params_t *params);
778 void _snd_pcm_hw_param_setempty(snd_pcm_hw_params_t *params, snd_pcm_hw_param_t var);
779 int snd_pcm_hw_param_min(snd_pcm_substream_t *substream,
780 snd_pcm_hw_params_t *params,
781 snd_pcm_hw_param_t var,
782 unsigned int val, int *dir);
783 int snd_pcm_hw_param_max(snd_pcm_substream_t *substream,
784 snd_pcm_hw_params_t *params,
785 snd_pcm_hw_param_t var,
786 unsigned int val, int *dir);
787 int snd_pcm_hw_param_setinteger(snd_pcm_substream_t *substream,
788 snd_pcm_hw_params_t *params,
789 snd_pcm_hw_param_t var);
790 int snd_pcm_hw_param_first(snd_pcm_substream_t *substream,
791 snd_pcm_hw_params_t *params,
792 snd_pcm_hw_param_t var, int *dir);
793 int snd_pcm_hw_param_last(snd_pcm_substream_t *substream,
794 snd_pcm_hw_params_t *params,
795 snd_pcm_hw_param_t var, int *dir);
796 int snd_pcm_hw_param_near(snd_pcm_substream_t *substream,
797 snd_pcm_hw_params_t *params,
798 snd_pcm_hw_param_t var,
799 unsigned int val, int *dir);
800 int snd_pcm_hw_param_set(snd_pcm_substream_t *pcm,
801 snd_pcm_hw_params_t *params,
802 snd_pcm_hw_param_t var,
803 unsigned int val, int dir);
804 int snd_pcm_hw_params_choose(snd_pcm_substream_t *substream, snd_pcm_hw_params_t *params);
806 int snd_pcm_hw_refine(snd_pcm_substream_t *substream, snd_pcm_hw_params_t *params);
808 int snd_pcm_hw_constraints_init(snd_pcm_substream_t *substream);
809 int snd_pcm_hw_constraints_complete(snd_pcm_substream_t *substream);
811 int snd_pcm_hw_constraint_mask(snd_pcm_runtime_t *runtime, snd_pcm_hw_param_t var,
813 int snd_pcm_hw_constraint_mask64(snd_pcm_runtime_t *runtime, snd_pcm_hw_param_t var,
815 int snd_pcm_hw_constraint_minmax(snd_pcm_runtime_t *runtime, snd_pcm_hw_param_t var,
816 unsigned int min, unsigned int max);
817 int snd_pcm_hw_constraint_integer(snd_pcm_runtime_t *runtime, snd_pcm_hw_param_t var);
818 int snd_pcm_hw_constraint_list(snd_pcm_runtime_t *runtime,
820 snd_pcm_hw_param_t var,
821 snd_pcm_hw_constraint_list_t *l);
822 int snd_pcm_hw_constraint_ratnums(snd_pcm_runtime_t *runtime,
824 snd_pcm_hw_param_t var,
825 snd_pcm_hw_constraint_ratnums_t *r);
826 int snd_pcm_hw_constraint_ratdens(snd_pcm_runtime_t *runtime,
828 snd_pcm_hw_param_t var,
829 snd_pcm_hw_constraint_ratdens_t *r);
830 int snd_pcm_hw_constraint_msbits(snd_pcm_runtime_t *runtime,
833 unsigned int msbits);
834 int snd_pcm_hw_constraint_step(snd_pcm_runtime_t *runtime,
836 snd_pcm_hw_param_t var,
838 int snd_pcm_hw_constraint_pow2(snd_pcm_runtime_t *runtime,
840 snd_pcm_hw_param_t var);
841 int snd_pcm_hw_rule_add(snd_pcm_runtime_t *runtime,
844 snd_pcm_hw_rule_func_t func, void *private,
847 int snd_pcm_format_signed(snd_pcm_format_t format);
848 int snd_pcm_format_unsigned(snd_pcm_format_t format);
849 int snd_pcm_format_linear(snd_pcm_format_t format);
850 int snd_pcm_format_little_endian(snd_pcm_format_t format);
851 int snd_pcm_format_big_endian(snd_pcm_format_t format);
852 int snd_pcm_format_width(snd_pcm_format_t format); /* in bits */
853 int snd_pcm_format_physical_width(snd_pcm_format_t format); /* in bits */
854 u_int64_t snd_pcm_format_silence_64(snd_pcm_format_t format);
855 int snd_pcm_format_set_silence(snd_pcm_format_t format, void *buf, unsigned int frames);
856 snd_pcm_format_t snd_pcm_build_linear_format(int width, int unsignd, int big_endian);
857 ssize_t snd_pcm_format_size(snd_pcm_format_t format, size_t samples);
858 const char *snd_pcm_format_name(snd_pcm_format_t format);
859 const char *snd_pcm_subformat_name(snd_pcm_subformat_t subformat);
861 void snd_pcm_set_ops(snd_pcm_t * pcm, int direction, snd_pcm_ops_t *ops);
862 void snd_pcm_set_sync(snd_pcm_substream_t * substream);
863 int snd_pcm_lib_interleave_len(snd_pcm_substream_t *substream);
864 int snd_pcm_lib_ioctl(snd_pcm_substream_t *substream,
865 unsigned int cmd, void *arg);
866 int snd_pcm_update_hw_ptr(snd_pcm_substream_t *substream);
867 int snd_pcm_playback_xrun_check(snd_pcm_substream_t *substream);
868 int snd_pcm_capture_xrun_check(snd_pcm_substream_t *substream);
869 int snd_pcm_playback_xrun_asap(snd_pcm_substream_t *substream);
870 int snd_pcm_capture_xrun_asap(snd_pcm_substream_t *substream);
871 void snd_pcm_playback_silence(snd_pcm_substream_t *substream, snd_pcm_uframes_t new_hw_ptr);
872 int snd_pcm_playback_ready(snd_pcm_substream_t *substream);
873 int snd_pcm_capture_ready(snd_pcm_substream_t *substream);
874 long snd_pcm_playback_ready_jiffies(snd_pcm_substream_t *substream);
875 long snd_pcm_capture_ready_jiffies(snd_pcm_substream_t *substream);
876 int snd_pcm_playback_data(snd_pcm_substream_t *substream);
877 int snd_pcm_playback_empty(snd_pcm_substream_t *substream);
878 int snd_pcm_capture_empty(snd_pcm_substream_t *substream);
879 void snd_pcm_tick_prepare(snd_pcm_substream_t *substream);
880 void snd_pcm_tick_set(snd_pcm_substream_t *substream, unsigned long ticks);
881 void snd_pcm_tick_elapsed(snd_pcm_substream_t *substream);
882 void snd_pcm_period_elapsed(snd_pcm_substream_t *substream);
883 snd_pcm_sframes_t snd_pcm_lib_write(snd_pcm_substream_t *substream,
884 const void *buf, snd_pcm_uframes_t frames);
885 snd_pcm_sframes_t snd_pcm_lib_read(snd_pcm_substream_t *substream,
886 void *buf, snd_pcm_uframes_t frames);
887 snd_pcm_sframes_t snd_pcm_lib_writev(snd_pcm_substream_t *substream,
888 void **bufs, snd_pcm_uframes_t frames);
889 snd_pcm_sframes_t snd_pcm_lib_readv(snd_pcm_substream_t *substream,
890 void **bufs, snd_pcm_uframes_t frames);
892 int snd_pcm_limit_hw_rates(snd_pcm_runtime_t *runtime);
899 void snd_pcm_timer_resolution_change(snd_pcm_substream_t *substream);
900 void snd_pcm_timer_init(snd_pcm_substream_t * substream);
901 void snd_pcm_timer_done(snd_pcm_substream_t * substream);
907 int snd_pcm_lib_preallocate_free(snd_pcm_substream_t *substream);
908 int snd_pcm_lib_preallocate_free_for_all(snd_pcm_t *pcm);
909 int snd_pcm_lib_preallocate_pages(snd_pcm_substream_t *substream,
910 int type, struct device *data,
911 size_t size, size_t max);
912 int snd_pcm_lib_preallocate_pages_for_all(snd_pcm_t *pcm,
913 int type, void *data,
914 size_t size, size_t max);
915 int snd_pcm_lib_malloc_pages(snd_pcm_substream_t *substream, size_t size);
916 int snd_pcm_lib_free_pages(snd_pcm_substream_t *substream);
918 #define snd_pcm_substream_sgbuf(substream) ((substream)->runtime->dma_private)
919 #define snd_pcm_sgbuf_pages(size) snd_sgbuf_aligned_pages(size)
920 #define snd_pcm_sgbuf_get_addr(sgbuf,ofs) snd_sgbuf_get_addr(sgbuf,ofs)
921 struct page *snd_pcm_sgbuf_ops_page(snd_pcm_substream_t *substream, unsigned long offset);
923 static inline void snd_pcm_limit_isa_dma_size(int dma, size_t *max)
925 *max = dma < 4 ? 64 * 1024 : 128 * 1024;
932 #define SNDRV_PCM_DEFAULT_CON_SPDIF (IEC958_AES0_CON_EMPHASIS_NONE|\
933 (IEC958_AES1_CON_ORIGINAL<<8)|\
934 (IEC958_AES1_CON_PCM_CODER<<8)|\
935 (IEC958_AES3_CON_FS_48000<<24))
937 #endif /* __SOUND_PCM_H */