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 #define snd_pcm_substream_chip(substream) ((substream)->private_data)
32 #define snd_pcm_chip(pcm) ((pcm)->private_data)
34 #if defined(CONFIG_SND_PCM_OSS) || defined(CONFIG_SND_PCM_OSS_MODULE)
39 * Hardware (lowlevel) section
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 */
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
);
84 #define SNDRV_PCM_DEVICES 8
86 #define SNDRV_PCM_IOCTL1_FALSE ((void *)0)
87 #define SNDRV_PCM_IOCTL1_TRUE ((void *)1)
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
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
101 #define SNDRV_PCM_POS_XRUN ((snd_pcm_uframes_t)-1)
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 */
118 #define SNDRV_PCM_RATE_CONTINUOUS (1<<30) /* continuous range */
119 #define SNDRV_PCM_RATE_KNOT (1<<31) /* supports more non-continuos rates */
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)
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
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
191 struct snd_pcm_file
{
192 struct snd_pcm_substream
*substream
;
193 struct snd_pcm_file
*next
;
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
);
200 struct snd_pcm_hw_rule
{
202 snd_pcm_hw_rule_func_t func
;
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
;
218 static inline struct snd_mask
*constrs_mask(struct snd_pcm_hw_constraints
*constrs
,
219 snd_pcm_hw_param_t var
)
221 return &constrs
->masks
[var
- SNDRV_PCM_HW_PARAM_FIRST_MASK
];
224 static inline struct snd_interval
*constrs_interval(struct snd_pcm_hw_constraints
*constrs
,
225 snd_pcm_hw_param_t var
)
227 return &constrs
->intervals
[var
- SNDRV_PCM_HW_PARAM_FIRST_INTERVAL
];
232 unsigned int den_min
, den_max
, den_step
;
236 unsigned int num_min
, num_max
, num_step
;
240 struct snd_pcm_hw_constraint_ratnums
{
242 struct snd_ratnum
*rats
;
245 struct snd_pcm_hw_constraint_ratdens
{
247 struct snd_ratden
*rats
;
250 struct snd_pcm_hw_constraint_list
{
256 struct snd_pcm_runtime
{
258 struct snd_pcm_substream
*trigger_master
;
259 struct timespec trigger_tstamp
; /* trigger timestamp */
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*/
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 */
277 unsigned int frame_bits
;
278 unsigned int sample_bits
;
280 unsigned int rate_num
;
281 unsigned int rate_den
;
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 */
295 snd_pcm_uframes_t silence_start
; /* starting pointer to silence area */
296 snd_pcm_uframes_t silence_filled
; /* size filled with silence */
298 union snd_pcm_sync_id sync
; /* hardware synchronization ID */
301 volatile struct snd_pcm_mmap_status
*status
;
302 volatile struct snd_pcm_mmap_control
*control
;
305 /* -- locking / scheduling -- */
306 wait_queue_head_t sleep
;
307 struct timer_list tick_timer
;
308 struct fasync_struct
*fasync
;
310 /* -- private section -- */
312 void (*private_free
)(struct snd_pcm_runtime
*runtime
);
314 /* -- hardware description -- */
315 struct snd_pcm_hardware hw
;
316 struct snd_pcm_hw_constraints hw_constraints
;
318 /* -- interrupt callbacks -- */
319 void (*transfer_ack_begin
)(struct snd_pcm_substream
*substream
);
320 void (*transfer_ack_end
)(struct snd_pcm_substream
*substream
);
323 unsigned int timer_resolution
; /* timer resolution */
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 */
330 struct snd_dma_buffer
*dma_buffer_p
; /* allocated buffer */
332 #if defined(CONFIG_SND_PCM_OSS) || defined(CONFIG_SND_PCM_OSS_MODULE)
333 /* -- OSS things -- */
334 struct snd_pcm_oss_runtime oss
;
338 struct snd_pcm_group
{ /* keep linked substreams */
340 struct list_head substreams
;
344 struct snd_pcm_substream
{
346 struct snd_pcm_str
*pstr
;
347 void *private_data
; /* copied from pcm->private_data */
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
;
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 -- */
372 void (*pcm_release
)(struct snd_pcm_substream
*);
373 #if defined(CONFIG_SND_PCM_OSS) || defined(CONFIG_SND_PCM_OSS_MODULE)
374 /* -- OSS things -- */
375 struct snd_pcm_oss_substream oss
;
377 #ifdef CONFIG_SND_VERBOSE_PROCFS
378 struct snd_info_entry
*proc_root
;
379 struct snd_info_entry
*proc_info_entry
;
380 struct snd_info_entry
*proc_hw_params_entry
;
381 struct snd_info_entry
*proc_sw_params_entry
;
382 struct snd_info_entry
*proc_status_entry
;
383 struct snd_info_entry
*proc_prealloc_entry
;
386 unsigned int no_mmap_ctrl
: 1;
387 unsigned int hw_opened
: 1;
390 #define SUBSTREAM_BUSY(substream) ((substream)->file != NULL)
394 int stream
; /* stream (direction) */
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
;
404 struct snd_pcm_file
*files
;
405 #ifdef CONFIG_SND_VERBOSE_PROCFS
406 struct snd_info_entry
*proc_root
;
407 struct snd_info_entry
*proc_info_entry
;
408 #ifdef CONFIG_SND_PCM_XRUN_DEBUG
409 unsigned int xrun_debug
; /* 0 = disabled, 1 = verbose, 2 = stacktrace */
410 struct snd_info_entry
*proc_xrun_debug_entry
;
416 struct snd_card
*card
;
417 struct list_head list
;
418 unsigned int device
; /* device number */
419 unsigned int info_flags
;
420 unsigned short dev_class
;
421 unsigned short dev_subclass
;
424 struct snd_pcm_str streams
[2];
425 struct mutex open_mutex
;
426 wait_queue_head_t open_wait
;
428 void (*private_free
) (struct snd_pcm
*pcm
);
429 #if defined(CONFIG_SND_PCM_OSS) || defined(CONFIG_SND_PCM_OSS_MODULE)
430 struct snd_pcm_oss oss
;
434 struct snd_pcm_notify
{
435 int (*n_register
) (struct snd_pcm
* pcm
);
436 int (*n_disconnect
) (struct snd_pcm
* pcm
);
437 int (*n_unregister
) (struct snd_pcm
* pcm
);
438 struct list_head list
;
445 extern struct file_operations snd_pcm_f_ops
[2];
447 int snd_pcm_new(struct snd_card
*card
, char *id
, int device
,
448 int playback_count
, int capture_count
,
449 struct snd_pcm
**rpcm
);
450 int snd_pcm_new_stream(struct snd_pcm
*pcm
, int stream
, int substream_count
);
452 int snd_pcm_notify(struct snd_pcm_notify
*notify
, int nfree
);
458 extern rwlock_t snd_pcm_link_rwlock
;
460 int snd_pcm_info(struct snd_pcm_substream
*substream
, struct snd_pcm_info
*info
);
461 int snd_pcm_info_user(struct snd_pcm_substream
*substream
,
462 struct snd_pcm_info __user
*info
);
463 int snd_pcm_status(struct snd_pcm_substream
*substream
,
464 struct snd_pcm_status
*status
);
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
);
469 int snd_pcm_suspend(struct snd_pcm_substream
*substream
);
470 int snd_pcm_suspend_all(struct snd_pcm
*pcm
);
472 int snd_pcm_kernel_ioctl(struct snd_pcm_substream
*substream
, unsigned int cmd
, void *arg
);
473 int snd_pcm_open_substream(struct snd_pcm
*pcm
, int stream
, struct file
*file
,
474 struct snd_pcm_substream
**rsubstream
);
475 void snd_pcm_release_substream(struct snd_pcm_substream
*substream
);
476 int snd_pcm_attach_substream(struct snd_pcm
*pcm
, int stream
, struct file
*file
,
477 struct snd_pcm_substream
**rsubstream
);
478 void snd_pcm_detach_substream(struct snd_pcm_substream
*substream
);
479 void snd_pcm_vma_notify_data(void *client
, void *data
);
480 int snd_pcm_mmap_data(struct snd_pcm_substream
*substream
, struct file
*file
, struct vm_area_struct
*area
);
482 #if BITS_PER_LONG >= 64
484 static inline void div64_32(u_int64_t
*n
, u_int32_t div
, u_int32_t
*rem
)
492 static inline void div64_32(u_int64_t
*n
, u_int32_t div
, u_int32_t
*rem
)
495 low
= *n
& 0xffffffff;
498 u_int32_t high1
= high
% div
;
500 asm("divl %2":"=a" (low
), "=d" (*rem
):"rm" (div
), "a" (low
), "d" (high1
));
501 *n
= (u_int64_t
)high
<< 32 | low
;
509 static inline void divl(u_int32_t high
, u_int32_t low
,
511 u_int32_t
*q
, u_int32_t
*r
)
513 u_int64_t n
= (u_int64_t
)high
<< 32 | low
;
514 u_int64_t d
= (u_int64_t
)div
<< 31;
517 while (n
> 0xffffffffU
) {
529 *q
= q1
| (low
/ div
);
538 static inline void div64_32(u_int64_t
*n
, u_int32_t div
, u_int32_t
*rem
)
541 low
= *n
& 0xffffffff;
544 u_int32_t high1
= high
% div
;
545 u_int32_t low1
= low
;
547 divl(high1
, low1
, div
, &low
, rem
);
548 *n
= (u_int64_t
)high
<< 32 | low
;
560 static inline int snd_pcm_stream_linked(struct snd_pcm_substream
*substream
)
562 return substream
->group
!= &substream
->self_group
;
565 static inline void snd_pcm_stream_lock(struct snd_pcm_substream
*substream
)
567 read_lock(&snd_pcm_link_rwlock
);
568 spin_lock(&substream
->self_group
.lock
);
571 static inline void snd_pcm_stream_unlock(struct snd_pcm_substream
*substream
)
573 spin_unlock(&substream
->self_group
.lock
);
574 read_unlock(&snd_pcm_link_rwlock
);
577 static inline void snd_pcm_stream_lock_irq(struct snd_pcm_substream
*substream
)
579 read_lock_irq(&snd_pcm_link_rwlock
);
580 spin_lock(&substream
->self_group
.lock
);
583 static inline void snd_pcm_stream_unlock_irq(struct snd_pcm_substream
*substream
)
585 spin_unlock(&substream
->self_group
.lock
);
586 read_unlock_irq(&snd_pcm_link_rwlock
);
589 #define snd_pcm_stream_lock_irqsave(substream, flags) \
591 read_lock_irqsave(&snd_pcm_link_rwlock, (flags)); \
592 spin_lock(&substream->self_group.lock); \
595 #define snd_pcm_stream_unlock_irqrestore(substream, flags) \
597 spin_unlock(&substream->self_group.lock); \
598 read_unlock_irqrestore(&snd_pcm_link_rwlock, (flags)); \
601 #define snd_pcm_group_for_each(pos, substream) \
602 list_for_each(pos, &substream->group->substreams)
604 #define snd_pcm_group_substream_entry(pos) \
605 list_entry(pos, struct snd_pcm_substream, link_list)
607 static inline int snd_pcm_running(struct snd_pcm_substream
*substream
)
609 return (substream
->runtime
->status
->state
== SNDRV_PCM_STATE_RUNNING
||
610 (substream
->runtime
->status
->state
== SNDRV_PCM_STATE_DRAINING
&&
611 substream
->stream
== SNDRV_PCM_STREAM_PLAYBACK
));
614 static inline ssize_t
bytes_to_samples(struct snd_pcm_runtime
*runtime
, ssize_t size
)
616 return size
* 8 / runtime
->sample_bits
;
619 static inline snd_pcm_sframes_t
bytes_to_frames(struct snd_pcm_runtime
*runtime
, ssize_t size
)
621 return size
* 8 / runtime
->frame_bits
;
624 static inline ssize_t
samples_to_bytes(struct snd_pcm_runtime
*runtime
, ssize_t size
)
626 return size
* runtime
->sample_bits
/ 8;
629 static inline ssize_t
frames_to_bytes(struct snd_pcm_runtime
*runtime
, snd_pcm_sframes_t size
)
631 return size
* runtime
->frame_bits
/ 8;
634 static inline int frame_aligned(struct snd_pcm_runtime
*runtime
, ssize_t bytes
)
636 return bytes
% runtime
->byte_align
== 0;
639 static inline size_t snd_pcm_lib_buffer_bytes(struct snd_pcm_substream
*substream
)
641 struct snd_pcm_runtime
*runtime
= substream
->runtime
;
642 return frames_to_bytes(runtime
, runtime
->buffer_size
);
645 static inline size_t snd_pcm_lib_period_bytes(struct snd_pcm_substream
*substream
)
647 struct snd_pcm_runtime
*runtime
= substream
->runtime
;
648 return frames_to_bytes(runtime
, runtime
->period_size
);
652 * result is: 0 ... (boundary - 1)
654 static inline snd_pcm_uframes_t
snd_pcm_playback_avail(struct snd_pcm_runtime
*runtime
)
656 snd_pcm_sframes_t avail
= runtime
->status
->hw_ptr
+ runtime
->buffer_size
- runtime
->control
->appl_ptr
;
658 avail
+= runtime
->boundary
;
659 else if ((snd_pcm_uframes_t
) avail
>= runtime
->boundary
)
660 avail
-= runtime
->boundary
;
665 * result is: 0 ... (boundary - 1)
667 static inline snd_pcm_uframes_t
snd_pcm_capture_avail(struct snd_pcm_runtime
*runtime
)
669 snd_pcm_sframes_t avail
= runtime
->status
->hw_ptr
- runtime
->control
->appl_ptr
;
671 avail
+= runtime
->boundary
;
675 static inline snd_pcm_sframes_t
snd_pcm_playback_hw_avail(struct snd_pcm_runtime
*runtime
)
677 return runtime
->buffer_size
- snd_pcm_playback_avail(runtime
);
680 static inline snd_pcm_sframes_t
snd_pcm_capture_hw_avail(struct snd_pcm_runtime
*runtime
)
682 return runtime
->buffer_size
- snd_pcm_capture_avail(runtime
);
686 * snd_pcm_playback_ready - check whether the playback buffer is available
687 * @substream: the pcm substream instance
689 * Checks whether enough free space is available on the playback buffer.
691 * Returns non-zero if available, or zero if not.
693 static inline int snd_pcm_playback_ready(struct snd_pcm_substream
*substream
)
695 struct snd_pcm_runtime
*runtime
= substream
->runtime
;
696 return snd_pcm_playback_avail(runtime
) >= runtime
->control
->avail_min
;
700 * snd_pcm_capture_ready - check whether the capture buffer is available
701 * @substream: the pcm substream instance
703 * Checks whether enough capture data is available on the capture buffer.
705 * Returns non-zero if available, or zero if not.
707 static inline int snd_pcm_capture_ready(struct snd_pcm_substream
*substream
)
709 struct snd_pcm_runtime
*runtime
= substream
->runtime
;
710 return snd_pcm_capture_avail(runtime
) >= runtime
->control
->avail_min
;
714 * snd_pcm_playback_data - check whether any data exists on the playback buffer
715 * @substream: the pcm substream instance
717 * Checks whether any data exists on the playback buffer. If stop_threshold
718 * is bigger or equal to boundary, then this function returns always non-zero.
720 * Returns non-zero if exists, or zero if not.
722 static inline int snd_pcm_playback_data(struct snd_pcm_substream
*substream
)
724 struct snd_pcm_runtime
*runtime
= substream
->runtime
;
726 if (runtime
->stop_threshold
>= runtime
->boundary
)
728 return snd_pcm_playback_avail(runtime
) < runtime
->buffer_size
;
732 * snd_pcm_playback_empty - check whether the playback buffer is empty
733 * @substream: the pcm substream instance
735 * Checks whether the playback buffer is empty.
737 * Returns non-zero if empty, or zero if not.
739 static inline int snd_pcm_playback_empty(struct snd_pcm_substream
*substream
)
741 struct snd_pcm_runtime
*runtime
= substream
->runtime
;
742 return snd_pcm_playback_avail(runtime
) >= runtime
->buffer_size
;
746 * snd_pcm_capture_empty - check whether the capture buffer is empty
747 * @substream: the pcm substream instance
749 * Checks whether the capture buffer is empty.
751 * Returns non-zero if empty, or zero if not.
753 static inline int snd_pcm_capture_empty(struct snd_pcm_substream
*substream
)
755 struct snd_pcm_runtime
*runtime
= substream
->runtime
;
756 return snd_pcm_capture_avail(runtime
) == 0;
759 static inline void snd_pcm_trigger_done(struct snd_pcm_substream
*substream
,
760 struct snd_pcm_substream
*master
)
762 substream
->runtime
->trigger_master
= master
;
765 static inline int hw_is_mask(int var
)
767 return var
>= SNDRV_PCM_HW_PARAM_FIRST_MASK
&&
768 var
<= SNDRV_PCM_HW_PARAM_LAST_MASK
;
771 static inline int hw_is_interval(int var
)
773 return var
>= SNDRV_PCM_HW_PARAM_FIRST_INTERVAL
&&
774 var
<= SNDRV_PCM_HW_PARAM_LAST_INTERVAL
;
777 static inline struct snd_mask
*hw_param_mask(struct snd_pcm_hw_params
*params
,
778 snd_pcm_hw_param_t var
)
780 return ¶ms
->masks
[var
- SNDRV_PCM_HW_PARAM_FIRST_MASK
];
783 static inline struct snd_interval
*hw_param_interval(struct snd_pcm_hw_params
*params
,
784 snd_pcm_hw_param_t var
)
786 return ¶ms
->intervals
[var
- SNDRV_PCM_HW_PARAM_FIRST_INTERVAL
];
789 static inline const struct snd_mask
*hw_param_mask_c(const struct snd_pcm_hw_params
*params
,
790 snd_pcm_hw_param_t var
)
792 return (const struct snd_mask
*)hw_param_mask((struct snd_pcm_hw_params
*) params
, var
);
795 static inline const struct snd_interval
*hw_param_interval_c(const struct snd_pcm_hw_params
*params
,
796 snd_pcm_hw_param_t var
)
798 return (const struct snd_interval
*)hw_param_interval((struct snd_pcm_hw_params
*) params
, var
);
801 #define params_access(p) snd_mask_min(hw_param_mask((p), SNDRV_PCM_HW_PARAM_ACCESS))
802 #define params_format(p) snd_mask_min(hw_param_mask((p), SNDRV_PCM_HW_PARAM_FORMAT))
803 #define params_subformat(p) snd_mask_min(hw_param_mask((p), SNDRV_PCM_HW_PARAM_SUBFORMAT))
804 #define params_channels(p) hw_param_interval((p), SNDRV_PCM_HW_PARAM_CHANNELS)->min
805 #define params_rate(p) hw_param_interval((p), SNDRV_PCM_HW_PARAM_RATE)->min
806 #define params_period_size(p) hw_param_interval((p), SNDRV_PCM_HW_PARAM_PERIOD_SIZE)->min
807 #define params_period_bytes(p) ((params_period_size(p)*snd_pcm_format_physical_width(params_format(p))*params_channels(p))/8)
808 #define params_periods(p) hw_param_interval((p), SNDRV_PCM_HW_PARAM_PERIODS)->min
809 #define params_buffer_size(p) hw_param_interval((p), SNDRV_PCM_HW_PARAM_BUFFER_SIZE)->min
810 #define params_buffer_bytes(p) hw_param_interval((p), SNDRV_PCM_HW_PARAM_BUFFER_BYTES)->min
811 #define params_tick_time(p) hw_param_interval((p), SNDRV_PCM_HW_PARAM_TICK_TIME)->min
814 int snd_interval_refine(struct snd_interval
*i
, const struct snd_interval
*v
);
815 void snd_interval_mul(const struct snd_interval
*a
, const struct snd_interval
*b
, struct snd_interval
*c
);
816 void snd_interval_div(const struct snd_interval
*a
, const struct snd_interval
*b
, struct snd_interval
*c
);
817 void snd_interval_muldivk(const struct snd_interval
*a
, const struct snd_interval
*b
,
818 unsigned int k
, struct snd_interval
*c
);
819 void snd_interval_mulkdiv(const struct snd_interval
*a
, unsigned int k
,
820 const struct snd_interval
*b
, struct snd_interval
*c
);
821 int snd_interval_list(struct snd_interval
*i
, unsigned int count
, unsigned int *list
, unsigned int mask
);
822 int snd_interval_ratnum(struct snd_interval
*i
,
823 unsigned int rats_count
, struct snd_ratnum
*rats
,
824 unsigned int *nump
, unsigned int *denp
);
826 void _snd_pcm_hw_params_any(struct snd_pcm_hw_params
*params
);
827 void _snd_pcm_hw_param_setempty(struct snd_pcm_hw_params
*params
, snd_pcm_hw_param_t var
);
828 int snd_pcm_hw_param_near(struct snd_pcm_substream
*substream
,
829 struct snd_pcm_hw_params
*params
,
830 snd_pcm_hw_param_t var
,
831 unsigned int val
, int *dir
);
832 int snd_pcm_hw_param_set(struct snd_pcm_substream
*pcm
,
833 struct snd_pcm_hw_params
*params
,
834 snd_pcm_hw_param_t var
,
835 unsigned int val
, int dir
);
836 int snd_pcm_hw_params_choose(struct snd_pcm_substream
*substream
, struct snd_pcm_hw_params
*params
);
838 int snd_pcm_hw_refine(struct snd_pcm_substream
*substream
, struct snd_pcm_hw_params
*params
);
840 int snd_pcm_hw_constraints_init(struct snd_pcm_substream
*substream
);
841 int snd_pcm_hw_constraints_complete(struct snd_pcm_substream
*substream
);
843 int snd_pcm_hw_constraint_mask(struct snd_pcm_runtime
*runtime
, snd_pcm_hw_param_t var
,
845 int snd_pcm_hw_constraint_mask64(struct snd_pcm_runtime
*runtime
, snd_pcm_hw_param_t var
,
847 int snd_pcm_hw_constraint_minmax(struct snd_pcm_runtime
*runtime
, snd_pcm_hw_param_t var
,
848 unsigned int min
, unsigned int max
);
849 int snd_pcm_hw_constraint_integer(struct snd_pcm_runtime
*runtime
, snd_pcm_hw_param_t var
);
850 int snd_pcm_hw_constraint_list(struct snd_pcm_runtime
*runtime
,
852 snd_pcm_hw_param_t var
,
853 struct snd_pcm_hw_constraint_list
*l
);
854 int snd_pcm_hw_constraint_ratnums(struct snd_pcm_runtime
*runtime
,
856 snd_pcm_hw_param_t var
,
857 struct snd_pcm_hw_constraint_ratnums
*r
);
858 int snd_pcm_hw_constraint_ratdens(struct snd_pcm_runtime
*runtime
,
860 snd_pcm_hw_param_t var
,
861 struct snd_pcm_hw_constraint_ratdens
*r
);
862 int snd_pcm_hw_constraint_msbits(struct snd_pcm_runtime
*runtime
,
865 unsigned int msbits
);
866 int snd_pcm_hw_constraint_step(struct snd_pcm_runtime
*runtime
,
868 snd_pcm_hw_param_t var
,
870 int snd_pcm_hw_constraint_pow2(struct snd_pcm_runtime
*runtime
,
872 snd_pcm_hw_param_t var
);
873 int snd_pcm_hw_rule_add(struct snd_pcm_runtime
*runtime
,
876 snd_pcm_hw_rule_func_t func
, void *private,
879 int snd_pcm_format_signed(snd_pcm_format_t format
);
880 int snd_pcm_format_unsigned(snd_pcm_format_t format
);
881 int snd_pcm_format_linear(snd_pcm_format_t format
);
882 int snd_pcm_format_little_endian(snd_pcm_format_t format
);
883 int snd_pcm_format_big_endian(snd_pcm_format_t format
);
884 #if 0 /* just for DocBook */
886 * snd_pcm_format_cpu_endian - Check the PCM format is CPU-endian
887 * @format: the format to check
889 * Returns 1 if the given PCM format is CPU-endian, 0 if
890 * opposite, or a negative error code if endian not specified.
892 int snd_pcm_format_cpu_endian(snd_pcm_format_t format
);
894 #ifdef SNDRV_LITTLE_ENDIAN
895 #define snd_pcm_format_cpu_endian(format) snd_pcm_format_little_endian(format)
897 #define snd_pcm_format_cpu_endian(format) snd_pcm_format_big_endian(format)
899 int snd_pcm_format_width(snd_pcm_format_t format
); /* in bits */
900 int snd_pcm_format_physical_width(snd_pcm_format_t format
); /* in bits */
901 ssize_t
snd_pcm_format_size(snd_pcm_format_t format
, size_t samples
);
902 const unsigned char *snd_pcm_format_silence_64(snd_pcm_format_t format
);
903 int snd_pcm_format_set_silence(snd_pcm_format_t format
, void *buf
, unsigned int frames
);
904 snd_pcm_format_t
snd_pcm_build_linear_format(int width
, int unsignd
, int big_endian
);
906 void snd_pcm_set_ops(struct snd_pcm
* pcm
, int direction
, struct snd_pcm_ops
*ops
);
907 void snd_pcm_set_sync(struct snd_pcm_substream
*substream
);
908 int snd_pcm_lib_interleave_len(struct snd_pcm_substream
*substream
);
909 int snd_pcm_lib_ioctl(struct snd_pcm_substream
*substream
,
910 unsigned int cmd
, void *arg
);
911 int snd_pcm_update_hw_ptr(struct snd_pcm_substream
*substream
);
912 int snd_pcm_playback_xrun_check(struct snd_pcm_substream
*substream
);
913 int snd_pcm_capture_xrun_check(struct snd_pcm_substream
*substream
);
914 int snd_pcm_playback_xrun_asap(struct snd_pcm_substream
*substream
);
915 int snd_pcm_capture_xrun_asap(struct snd_pcm_substream
*substream
);
916 void snd_pcm_playback_silence(struct snd_pcm_substream
*substream
, snd_pcm_uframes_t new_hw_ptr
);
917 void snd_pcm_tick_prepare(struct snd_pcm_substream
*substream
);
918 void snd_pcm_tick_set(struct snd_pcm_substream
*substream
, unsigned long ticks
);
919 void snd_pcm_tick_elapsed(struct snd_pcm_substream
*substream
);
920 void snd_pcm_period_elapsed(struct snd_pcm_substream
*substream
);
921 snd_pcm_sframes_t
snd_pcm_lib_write(struct snd_pcm_substream
*substream
,
922 const void __user
*buf
,
923 snd_pcm_uframes_t frames
);
924 snd_pcm_sframes_t
snd_pcm_lib_read(struct snd_pcm_substream
*substream
,
925 void __user
*buf
, snd_pcm_uframes_t frames
);
926 snd_pcm_sframes_t
snd_pcm_lib_writev(struct snd_pcm_substream
*substream
,
927 void __user
**bufs
, snd_pcm_uframes_t frames
);
928 snd_pcm_sframes_t
snd_pcm_lib_readv(struct snd_pcm_substream
*substream
,
929 void __user
**bufs
, snd_pcm_uframes_t frames
);
931 int snd_pcm_limit_hw_rates(struct snd_pcm_runtime
*runtime
);
933 static inline void snd_pcm_set_runtime_buffer(struct snd_pcm_substream
*substream
,
934 struct snd_dma_buffer
*bufp
)
936 struct snd_pcm_runtime
*runtime
= substream
->runtime
;
938 runtime
->dma_buffer_p
= bufp
;
939 runtime
->dma_area
= bufp
->area
;
940 runtime
->dma_addr
= bufp
->addr
;
941 runtime
->dma_bytes
= bufp
->bytes
;
943 runtime
->dma_buffer_p
= NULL
;
944 runtime
->dma_area
= NULL
;
945 runtime
->dma_addr
= 0;
946 runtime
->dma_bytes
= 0;
954 void snd_pcm_timer_resolution_change(struct snd_pcm_substream
*substream
);
955 void snd_pcm_timer_init(struct snd_pcm_substream
*substream
);
956 void snd_pcm_timer_done(struct snd_pcm_substream
*substream
);
962 int snd_pcm_lib_preallocate_free(struct snd_pcm_substream
*substream
);
963 int snd_pcm_lib_preallocate_free_for_all(struct snd_pcm
*pcm
);
964 int snd_pcm_lib_preallocate_pages(struct snd_pcm_substream
*substream
,
965 int type
, struct device
*data
,
966 size_t size
, size_t max
);
967 int snd_pcm_lib_preallocate_pages_for_all(struct snd_pcm
*pcm
,
968 int type
, void *data
,
969 size_t size
, size_t max
);
970 int snd_pcm_lib_malloc_pages(struct snd_pcm_substream
*substream
, size_t size
);
971 int snd_pcm_lib_free_pages(struct snd_pcm_substream
*substream
);
973 #define snd_pcm_substream_sgbuf(substream) ((substream)->runtime->dma_buffer_p->private_data)
974 #define snd_pcm_sgbuf_pages(size) snd_sgbuf_aligned_pages(size)
975 #define snd_pcm_sgbuf_get_addr(sgbuf,ofs) snd_sgbuf_get_addr(sgbuf,ofs)
976 struct page
*snd_pcm_sgbuf_ops_page(struct snd_pcm_substream
*substream
, unsigned long offset
);
978 /* handle mmap counter - PCM mmap callback should handle this counter properly */
979 static inline void snd_pcm_mmap_data_open(struct vm_area_struct
*area
)
981 struct snd_pcm_substream
*substream
= (struct snd_pcm_substream
*)area
->vm_private_data
;
982 atomic_inc(&substream
->runtime
->mmap_count
);
985 static inline void snd_pcm_mmap_data_close(struct vm_area_struct
*area
)
987 struct snd_pcm_substream
*substream
= (struct snd_pcm_substream
*)area
->vm_private_data
;
988 atomic_dec(&substream
->runtime
->mmap_count
);
991 /* mmap for io-memory area */
992 #if defined(CONFIG_X86) || defined(CONFIG_PPC) || defined(CONFIG_ALPHA)
993 #define SNDRV_PCM_INFO_MMAP_IOMEM SNDRV_PCM_INFO_MMAP
994 int snd_pcm_lib_mmap_iomem(struct snd_pcm_substream
*substream
, struct vm_area_struct
*area
);
996 #define SNDRV_PCM_INFO_MMAP_IOMEM 0
997 #define snd_pcm_lib_mmap_iomem NULL
1000 static inline void snd_pcm_limit_isa_dma_size(int dma
, size_t *max
)
1002 *max
= dma
< 4 ? 64 * 1024 : 128 * 1024;
1009 #define SNDRV_PCM_DEFAULT_CON_SPDIF (IEC958_AES0_CON_EMPHASIS_NONE|\
1010 (IEC958_AES1_CON_ORIGINAL<<8)|\
1011 (IEC958_AES1_CON_PCM_CODER<<8)|\
1012 (IEC958_AES3_CON_FS_48000<<24))
1014 #endif /* __SOUND_PCM_H */