| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 1 | #ifndef __SOUND_PCM_H | 
|  | 2 | #define __SOUND_PCM_H | 
|  | 3 |  | 
|  | 4 | /* | 
|  | 5 | *  Digital Audio (PCM) abstract layer | 
| Jaroslav Kysela | c1017a4 | 2007-10-15 09:50:19 +0200 | [diff] [blame] | 6 | *  Copyright (c) by Jaroslav Kysela <perex@perex.cz> | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 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> | 
| Pawel MOLL | f90c06a | 2008-07-30 12:46:40 +0100 | [diff] [blame] | 28 | #include <sound/minors.h> | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 29 | #include <linux/poll.h> | 
| Al Viro | f23f6e0 | 2006-10-20 15:17:02 -0400 | [diff] [blame] | 30 | #include <linux/mm.h> | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 31 | #include <linux/bitops.h> | 
| Mark Gross | ed77134 | 2010-05-06 01:59:26 +0200 | [diff] [blame] | 32 | #include <linux/pm_qos_params.h> | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 33 |  | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 34 | #define snd_pcm_substream_chip(substream) ((substream)->private_data) | 
|  | 35 | #define snd_pcm_chip(pcm) ((pcm)->private_data) | 
|  | 36 |  | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 37 | #if defined(CONFIG_SND_PCM_OSS) || defined(CONFIG_SND_PCM_OSS_MODULE) | 
|  | 38 | #include "pcm_oss.h" | 
|  | 39 | #endif | 
|  | 40 |  | 
|  | 41 | /* | 
|  | 42 | *  Hardware (lowlevel) section | 
|  | 43 | */ | 
|  | 44 |  | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 45 | struct snd_pcm_hardware { | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 46 | unsigned int info;		/* SNDRV_PCM_INFO_* */ | 
|  | 47 | u64 formats;			/* SNDRV_PCM_FMTBIT_* */ | 
|  | 48 | unsigned int rates;		/* SNDRV_PCM_RATE_* */ | 
|  | 49 | unsigned int rate_min;		/* min rate */ | 
|  | 50 | unsigned int rate_max;		/* max rate */ | 
|  | 51 | unsigned int channels_min;	/* min channels */ | 
|  | 52 | unsigned int channels_max;	/* max channels */ | 
|  | 53 | size_t buffer_bytes_max;	/* max buffer size */ | 
|  | 54 | size_t period_bytes_min;	/* min period size */ | 
|  | 55 | size_t period_bytes_max;	/* max period size */ | 
|  | 56 | unsigned int periods_min;	/* min # of periods */ | 
|  | 57 | unsigned int periods_max;	/* max # of periods */ | 
|  | 58 | size_t fifo_size;		/* fifo size in bytes */ | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 59 | }; | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 60 |  | 
| Randy Dunlap | e0e6ce0 | 2006-12-07 08:22:50 +0100 | [diff] [blame] | 61 | struct snd_pcm_substream; | 
|  | 62 |  | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 63 | struct snd_pcm_ops { | 
|  | 64 | int (*open)(struct snd_pcm_substream *substream); | 
|  | 65 | int (*close)(struct snd_pcm_substream *substream); | 
|  | 66 | int (*ioctl)(struct snd_pcm_substream * substream, | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 67 | unsigned int cmd, void *arg); | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 68 | int (*hw_params)(struct snd_pcm_substream *substream, | 
|  | 69 | struct snd_pcm_hw_params *params); | 
|  | 70 | int (*hw_free)(struct snd_pcm_substream *substream); | 
|  | 71 | int (*prepare)(struct snd_pcm_substream *substream); | 
|  | 72 | int (*trigger)(struct snd_pcm_substream *substream, int cmd); | 
|  | 73 | snd_pcm_uframes_t (*pointer)(struct snd_pcm_substream *substream); | 
|  | 74 | int (*copy)(struct snd_pcm_substream *substream, int channel, | 
|  | 75 | snd_pcm_uframes_t pos, | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 76 | void __user *buf, snd_pcm_uframes_t count); | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 77 | int (*silence)(struct snd_pcm_substream *substream, int channel, | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 78 | snd_pcm_uframes_t pos, snd_pcm_uframes_t count); | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 79 | struct page *(*page)(struct snd_pcm_substream *substream, | 
|  | 80 | unsigned long offset); | 
|  | 81 | int (*mmap)(struct snd_pcm_substream *substream, struct vm_area_struct *vma); | 
|  | 82 | int (*ack)(struct snd_pcm_substream *substream); | 
|  | 83 | }; | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 84 |  | 
|  | 85 | /* | 
|  | 86 | * | 
|  | 87 | */ | 
|  | 88 |  | 
| Pawel MOLL | f90c06a | 2008-07-30 12:46:40 +0100 | [diff] [blame] | 89 | #if defined(CONFIG_SND_DYNAMIC_MINORS) | 
|  | 90 | #define SNDRV_PCM_DEVICES	(SNDRV_OS_MINORS-2) | 
|  | 91 | #else | 
|  | 92 | #define SNDRV_PCM_DEVICES	8 | 
|  | 93 | #endif | 
| Jaroslav Kysela | 896e6cc | 2008-08-01 13:36:04 +0200 | [diff] [blame] | 94 |  | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 95 | #define SNDRV_PCM_IOCTL1_FALSE		((void *)0) | 
|  | 96 | #define SNDRV_PCM_IOCTL1_TRUE		((void *)1) | 
|  | 97 |  | 
|  | 98 | #define SNDRV_PCM_IOCTL1_RESET		0 | 
|  | 99 | #define SNDRV_PCM_IOCTL1_INFO		1 | 
|  | 100 | #define SNDRV_PCM_IOCTL1_CHANNEL_INFO	2 | 
|  | 101 | #define SNDRV_PCM_IOCTL1_GSTATE		3 | 
| Jaroslav Kysela | 8bea869 | 2009-04-27 09:44:40 +0200 | [diff] [blame] | 102 | #define SNDRV_PCM_IOCTL1_FIFO_SIZE	4 | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 103 |  | 
|  | 104 | #define SNDRV_PCM_TRIGGER_STOP		0 | 
|  | 105 | #define SNDRV_PCM_TRIGGER_START		1 | 
|  | 106 | #define SNDRV_PCM_TRIGGER_PAUSE_PUSH	3 | 
|  | 107 | #define SNDRV_PCM_TRIGGER_PAUSE_RELEASE	4 | 
|  | 108 | #define SNDRV_PCM_TRIGGER_SUSPEND	5 | 
|  | 109 | #define SNDRV_PCM_TRIGGER_RESUME	6 | 
|  | 110 |  | 
|  | 111 | #define SNDRV_PCM_POS_XRUN		((snd_pcm_uframes_t)-1) | 
|  | 112 |  | 
|  | 113 | /* If you change this don't forget to change rates[] table in pcm_native.c */ | 
|  | 114 | #define SNDRV_PCM_RATE_5512		(1<<0)		/* 5512Hz */ | 
|  | 115 | #define SNDRV_PCM_RATE_8000		(1<<1)		/* 8000Hz */ | 
|  | 116 | #define SNDRV_PCM_RATE_11025		(1<<2)		/* 11025Hz */ | 
|  | 117 | #define SNDRV_PCM_RATE_16000		(1<<3)		/* 16000Hz */ | 
|  | 118 | #define SNDRV_PCM_RATE_22050		(1<<4)		/* 22050Hz */ | 
|  | 119 | #define SNDRV_PCM_RATE_32000		(1<<5)		/* 32000Hz */ | 
|  | 120 | #define SNDRV_PCM_RATE_44100		(1<<6)		/* 44100Hz */ | 
|  | 121 | #define SNDRV_PCM_RATE_48000		(1<<7)		/* 48000Hz */ | 
|  | 122 | #define SNDRV_PCM_RATE_64000		(1<<8)		/* 64000Hz */ | 
|  | 123 | #define SNDRV_PCM_RATE_88200		(1<<9)		/* 88200Hz */ | 
|  | 124 | #define SNDRV_PCM_RATE_96000		(1<<10)		/* 96000Hz */ | 
|  | 125 | #define SNDRV_PCM_RATE_176400		(1<<11)		/* 176400Hz */ | 
|  | 126 | #define SNDRV_PCM_RATE_192000		(1<<12)		/* 192000Hz */ | 
|  | 127 |  | 
|  | 128 | #define SNDRV_PCM_RATE_CONTINUOUS	(1<<30)		/* continuous range */ | 
|  | 129 | #define SNDRV_PCM_RATE_KNOT		(1<<31)		/* supports more non-continuos rates */ | 
|  | 130 |  | 
|  | 131 | #define SNDRV_PCM_RATE_8000_44100	(SNDRV_PCM_RATE_8000|SNDRV_PCM_RATE_11025|\ | 
|  | 132 | SNDRV_PCM_RATE_16000|SNDRV_PCM_RATE_22050|\ | 
|  | 133 | SNDRV_PCM_RATE_32000|SNDRV_PCM_RATE_44100) | 
|  | 134 | #define SNDRV_PCM_RATE_8000_48000	(SNDRV_PCM_RATE_8000_44100|SNDRV_PCM_RATE_48000) | 
|  | 135 | #define SNDRV_PCM_RATE_8000_96000	(SNDRV_PCM_RATE_8000_48000|SNDRV_PCM_RATE_64000|\ | 
|  | 136 | SNDRV_PCM_RATE_88200|SNDRV_PCM_RATE_96000) | 
|  | 137 | #define SNDRV_PCM_RATE_8000_192000	(SNDRV_PCM_RATE_8000_96000|SNDRV_PCM_RATE_176400|\ | 
|  | 138 | SNDRV_PCM_RATE_192000) | 
| Clemens Ladisch | fea952e | 2011-02-14 11:00:47 +0100 | [diff] [blame] | 139 | #define _SNDRV_PCM_FMTBIT(fmt)		(1ULL << (__force int)SNDRV_PCM_FORMAT_##fmt) | 
|  | 140 | #define SNDRV_PCM_FMTBIT_S8		_SNDRV_PCM_FMTBIT(S8) | 
|  | 141 | #define SNDRV_PCM_FMTBIT_U8		_SNDRV_PCM_FMTBIT(U8) | 
|  | 142 | #define SNDRV_PCM_FMTBIT_S16_LE		_SNDRV_PCM_FMTBIT(S16_LE) | 
|  | 143 | #define SNDRV_PCM_FMTBIT_S16_BE		_SNDRV_PCM_FMTBIT(S16_BE) | 
|  | 144 | #define SNDRV_PCM_FMTBIT_U16_LE		_SNDRV_PCM_FMTBIT(U16_LE) | 
|  | 145 | #define SNDRV_PCM_FMTBIT_U16_BE		_SNDRV_PCM_FMTBIT(U16_BE) | 
|  | 146 | #define SNDRV_PCM_FMTBIT_S24_LE		_SNDRV_PCM_FMTBIT(S24_LE) | 
|  | 147 | #define SNDRV_PCM_FMTBIT_S24_BE		_SNDRV_PCM_FMTBIT(S24_BE) | 
|  | 148 | #define SNDRV_PCM_FMTBIT_U24_LE		_SNDRV_PCM_FMTBIT(U24_LE) | 
|  | 149 | #define SNDRV_PCM_FMTBIT_U24_BE		_SNDRV_PCM_FMTBIT(U24_BE) | 
|  | 150 | #define SNDRV_PCM_FMTBIT_S32_LE		_SNDRV_PCM_FMTBIT(S32_LE) | 
|  | 151 | #define SNDRV_PCM_FMTBIT_S32_BE		_SNDRV_PCM_FMTBIT(S32_BE) | 
|  | 152 | #define SNDRV_PCM_FMTBIT_U32_LE		_SNDRV_PCM_FMTBIT(U32_LE) | 
|  | 153 | #define SNDRV_PCM_FMTBIT_U32_BE		_SNDRV_PCM_FMTBIT(U32_BE) | 
|  | 154 | #define SNDRV_PCM_FMTBIT_FLOAT_LE	_SNDRV_PCM_FMTBIT(FLOAT_LE) | 
|  | 155 | #define SNDRV_PCM_FMTBIT_FLOAT_BE	_SNDRV_PCM_FMTBIT(FLOAT_BE) | 
|  | 156 | #define SNDRV_PCM_FMTBIT_FLOAT64_LE	_SNDRV_PCM_FMTBIT(FLOAT64_LE) | 
|  | 157 | #define SNDRV_PCM_FMTBIT_FLOAT64_BE	_SNDRV_PCM_FMTBIT(FLOAT64_BE) | 
|  | 158 | #define SNDRV_PCM_FMTBIT_IEC958_SUBFRAME_LE _SNDRV_PCM_FMTBIT(IEC958_SUBFRAME_LE) | 
|  | 159 | #define SNDRV_PCM_FMTBIT_IEC958_SUBFRAME_BE _SNDRV_PCM_FMTBIT(IEC958_SUBFRAME_BE) | 
|  | 160 | #define SNDRV_PCM_FMTBIT_MU_LAW		_SNDRV_PCM_FMTBIT(MU_LAW) | 
|  | 161 | #define SNDRV_PCM_FMTBIT_A_LAW		_SNDRV_PCM_FMTBIT(A_LAW) | 
|  | 162 | #define SNDRV_PCM_FMTBIT_IMA_ADPCM	_SNDRV_PCM_FMTBIT(IMA_ADPCM) | 
|  | 163 | #define SNDRV_PCM_FMTBIT_MPEG		_SNDRV_PCM_FMTBIT(MPEG) | 
|  | 164 | #define SNDRV_PCM_FMTBIT_GSM		_SNDRV_PCM_FMTBIT(GSM) | 
|  | 165 | #define SNDRV_PCM_FMTBIT_SPECIAL	_SNDRV_PCM_FMTBIT(SPECIAL) | 
|  | 166 | #define SNDRV_PCM_FMTBIT_S24_3LE	_SNDRV_PCM_FMTBIT(S24_3LE) | 
|  | 167 | #define SNDRV_PCM_FMTBIT_U24_3LE	_SNDRV_PCM_FMTBIT(U24_3LE) | 
|  | 168 | #define SNDRV_PCM_FMTBIT_S24_3BE	_SNDRV_PCM_FMTBIT(S24_3BE) | 
|  | 169 | #define SNDRV_PCM_FMTBIT_U24_3BE	_SNDRV_PCM_FMTBIT(U24_3BE) | 
|  | 170 | #define SNDRV_PCM_FMTBIT_S20_3LE	_SNDRV_PCM_FMTBIT(S20_3LE) | 
|  | 171 | #define SNDRV_PCM_FMTBIT_U20_3LE	_SNDRV_PCM_FMTBIT(U20_3LE) | 
|  | 172 | #define SNDRV_PCM_FMTBIT_S20_3BE	_SNDRV_PCM_FMTBIT(S20_3BE) | 
|  | 173 | #define SNDRV_PCM_FMTBIT_U20_3BE	_SNDRV_PCM_FMTBIT(U20_3BE) | 
|  | 174 | #define SNDRV_PCM_FMTBIT_S18_3LE	_SNDRV_PCM_FMTBIT(S18_3LE) | 
|  | 175 | #define SNDRV_PCM_FMTBIT_U18_3LE	_SNDRV_PCM_FMTBIT(U18_3LE) | 
|  | 176 | #define SNDRV_PCM_FMTBIT_S18_3BE	_SNDRV_PCM_FMTBIT(S18_3BE) | 
|  | 177 | #define SNDRV_PCM_FMTBIT_U18_3BE	_SNDRV_PCM_FMTBIT(U18_3BE) | 
|  | 178 | #define SNDRV_PCM_FMTBIT_G723_24	_SNDRV_PCM_FMTBIT(G723_24) | 
|  | 179 | #define SNDRV_PCM_FMTBIT_G723_24_1B	_SNDRV_PCM_FMTBIT(G723_24_1B) | 
|  | 180 | #define SNDRV_PCM_FMTBIT_G723_40	_SNDRV_PCM_FMTBIT(G723_40) | 
|  | 181 | #define SNDRV_PCM_FMTBIT_G723_40_1B	_SNDRV_PCM_FMTBIT(G723_40_1B) | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 182 |  | 
|  | 183 | #ifdef SNDRV_LITTLE_ENDIAN | 
|  | 184 | #define SNDRV_PCM_FMTBIT_S16		SNDRV_PCM_FMTBIT_S16_LE | 
|  | 185 | #define SNDRV_PCM_FMTBIT_U16		SNDRV_PCM_FMTBIT_U16_LE | 
|  | 186 | #define SNDRV_PCM_FMTBIT_S24		SNDRV_PCM_FMTBIT_S24_LE | 
|  | 187 | #define SNDRV_PCM_FMTBIT_U24		SNDRV_PCM_FMTBIT_U24_LE | 
|  | 188 | #define SNDRV_PCM_FMTBIT_S32		SNDRV_PCM_FMTBIT_S32_LE | 
|  | 189 | #define SNDRV_PCM_FMTBIT_U32		SNDRV_PCM_FMTBIT_U32_LE | 
|  | 190 | #define SNDRV_PCM_FMTBIT_FLOAT		SNDRV_PCM_FMTBIT_FLOAT_LE | 
|  | 191 | #define SNDRV_PCM_FMTBIT_FLOAT64	SNDRV_PCM_FMTBIT_FLOAT64_LE | 
|  | 192 | #define SNDRV_PCM_FMTBIT_IEC958_SUBFRAME SNDRV_PCM_FMTBIT_IEC958_SUBFRAME_LE | 
|  | 193 | #endif | 
|  | 194 | #ifdef SNDRV_BIG_ENDIAN | 
|  | 195 | #define SNDRV_PCM_FMTBIT_S16		SNDRV_PCM_FMTBIT_S16_BE | 
|  | 196 | #define SNDRV_PCM_FMTBIT_U16		SNDRV_PCM_FMTBIT_U16_BE | 
|  | 197 | #define SNDRV_PCM_FMTBIT_S24		SNDRV_PCM_FMTBIT_S24_BE | 
|  | 198 | #define SNDRV_PCM_FMTBIT_U24		SNDRV_PCM_FMTBIT_U24_BE | 
|  | 199 | #define SNDRV_PCM_FMTBIT_S32		SNDRV_PCM_FMTBIT_S32_BE | 
|  | 200 | #define SNDRV_PCM_FMTBIT_U32		SNDRV_PCM_FMTBIT_U32_BE | 
|  | 201 | #define SNDRV_PCM_FMTBIT_FLOAT		SNDRV_PCM_FMTBIT_FLOAT_BE | 
|  | 202 | #define SNDRV_PCM_FMTBIT_FLOAT64	SNDRV_PCM_FMTBIT_FLOAT64_BE | 
|  | 203 | #define SNDRV_PCM_FMTBIT_IEC958_SUBFRAME SNDRV_PCM_FMTBIT_IEC958_SUBFRAME_BE | 
|  | 204 | #endif | 
|  | 205 |  | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 206 | struct snd_pcm_file { | 
|  | 207 | struct snd_pcm_substream *substream; | 
| Takashi Iwai | 548a648 | 2006-07-31 16:51:51 +0200 | [diff] [blame] | 208 | int no_compat_mmap; | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 209 | }; | 
|  | 210 |  | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 211 | struct snd_pcm_hw_rule; | 
|  | 212 | typedef int (*snd_pcm_hw_rule_func_t)(struct snd_pcm_hw_params *params, | 
|  | 213 | struct snd_pcm_hw_rule *rule); | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 214 |  | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 215 | struct snd_pcm_hw_rule { | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 216 | unsigned int cond; | 
|  | 217 | snd_pcm_hw_rule_func_t func; | 
|  | 218 | int var; | 
|  | 219 | int deps[4]; | 
|  | 220 | void *private; | 
|  | 221 | }; | 
|  | 222 |  | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 223 | struct snd_pcm_hw_constraints { | 
|  | 224 | struct snd_mask masks[SNDRV_PCM_HW_PARAM_LAST_MASK - | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 225 | SNDRV_PCM_HW_PARAM_FIRST_MASK + 1]; | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 226 | struct snd_interval intervals[SNDRV_PCM_HW_PARAM_LAST_INTERVAL - | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 227 | SNDRV_PCM_HW_PARAM_FIRST_INTERVAL + 1]; | 
|  | 228 | unsigned int rules_num; | 
|  | 229 | unsigned int rules_all; | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 230 | struct snd_pcm_hw_rule *rules; | 
|  | 231 | }; | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 232 |  | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 233 | static inline struct snd_mask *constrs_mask(struct snd_pcm_hw_constraints *constrs, | 
|  | 234 | snd_pcm_hw_param_t var) | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 235 | { | 
|  | 236 | return &constrs->masks[var - SNDRV_PCM_HW_PARAM_FIRST_MASK]; | 
|  | 237 | } | 
|  | 238 |  | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 239 | static inline struct snd_interval *constrs_interval(struct snd_pcm_hw_constraints *constrs, | 
|  | 240 | snd_pcm_hw_param_t var) | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 241 | { | 
|  | 242 | return &constrs->intervals[var - SNDRV_PCM_HW_PARAM_FIRST_INTERVAL]; | 
|  | 243 | } | 
|  | 244 |  | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 245 | struct snd_ratnum { | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 246 | unsigned int num; | 
|  | 247 | unsigned int den_min, den_max, den_step; | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 248 | }; | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 249 |  | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 250 | struct snd_ratden { | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 251 | unsigned int num_min, num_max, num_step; | 
|  | 252 | unsigned int den; | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 253 | }; | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 254 |  | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 255 | struct snd_pcm_hw_constraint_ratnums { | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 256 | int nrats; | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 257 | struct snd_ratnum *rats; | 
|  | 258 | }; | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 259 |  | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 260 | struct snd_pcm_hw_constraint_ratdens { | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 261 | int nrats; | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 262 | struct snd_ratden *rats; | 
|  | 263 | }; | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 264 |  | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 265 | struct snd_pcm_hw_constraint_list { | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 266 | unsigned int count; | 
|  | 267 | unsigned int *list; | 
|  | 268 | unsigned int mask; | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 269 | }; | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 270 |  | 
| Jaroslav Kysela | 4d96eb2 | 2009-12-20 11:47:57 +0100 | [diff] [blame] | 271 | struct snd_pcm_hwptr_log; | 
|  | 272 |  | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 273 | struct snd_pcm_runtime { | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 274 | /* -- Status -- */ | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 275 | struct snd_pcm_substream *trigger_master; | 
| Takashi Iwai | 07799e7 | 2005-10-10 11:49:49 +0200 | [diff] [blame] | 276 | struct timespec trigger_tstamp;	/* trigger timestamp */ | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 277 | int overrange; | 
|  | 278 | snd_pcm_uframes_t avail_max; | 
|  | 279 | snd_pcm_uframes_t hw_ptr_base;	/* Position at buffer restart */ | 
| Jaroslav Kysela | e763692 | 2010-01-26 17:08:24 +0100 | [diff] [blame] | 280 | snd_pcm_uframes_t hw_ptr_interrupt; /* Position at interrupt time */ | 
| Jaroslav Kysela | bbf6ad1 | 2009-04-10 12:28:58 +0200 | [diff] [blame] | 281 | unsigned long hw_ptr_jiffies;	/* Time when hw_ptr is updated */ | 
| Jaroslav Kysela | bd76af0 | 2010-08-18 14:16:54 +0200 | [diff] [blame] | 282 | unsigned long hw_ptr_buffer_jiffies; /* buffer time in jiffies */ | 
| Takashi Iwai | 4bbe1dd | 2008-10-13 03:07:14 +0200 | [diff] [blame] | 283 | snd_pcm_sframes_t delay;	/* extra delay; typically FIFO size */ | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 284 |  | 
|  | 285 | /* -- HW params -- */ | 
|  | 286 | snd_pcm_access_t access;	/* access mode */ | 
|  | 287 | snd_pcm_format_t format;	/* SNDRV_PCM_FORMAT_* */ | 
|  | 288 | snd_pcm_subformat_t subformat;	/* subformat */ | 
|  | 289 | unsigned int rate;		/* rate in Hz */ | 
|  | 290 | unsigned int channels;		/* channels */ | 
|  | 291 | snd_pcm_uframes_t period_size;	/* period size */ | 
|  | 292 | unsigned int periods;		/* periods */ | 
|  | 293 | snd_pcm_uframes_t buffer_size;	/* buffer size */ | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 294 | snd_pcm_uframes_t min_align;	/* Min alignment for the format */ | 
|  | 295 | size_t byte_align; | 
|  | 296 | unsigned int frame_bits; | 
|  | 297 | unsigned int sample_bits; | 
|  | 298 | unsigned int info; | 
|  | 299 | unsigned int rate_num; | 
|  | 300 | unsigned int rate_den; | 
| Clemens Ladisch | ab69a49 | 2010-11-15 10:46:23 +0100 | [diff] [blame] | 301 | unsigned int no_period_wakeup: 1; | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 302 |  | 
|  | 303 | /* -- SW params -- */ | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 304 | int tstamp_mode;		/* mmap timestamp is updated */ | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 305 | unsigned int period_step; | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 306 | snd_pcm_uframes_t start_threshold; | 
|  | 307 | snd_pcm_uframes_t stop_threshold; | 
|  | 308 | snd_pcm_uframes_t silence_threshold; /* Silence filling happens when | 
|  | 309 | noise is nearest than this */ | 
|  | 310 | snd_pcm_uframes_t silence_size;	/* Silence filling size */ | 
|  | 311 | snd_pcm_uframes_t boundary;	/* pointers wrap point */ | 
|  | 312 |  | 
|  | 313 | snd_pcm_uframes_t silence_start; /* starting pointer to silence area */ | 
|  | 314 | snd_pcm_uframes_t silence_filled; /* size filled with silence */ | 
|  | 315 |  | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 316 | union snd_pcm_sync_id sync;	/* hardware synchronization ID */ | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 317 |  | 
|  | 318 | /* -- mmap -- */ | 
| Takashi Iwai | 503fc85 | 2007-09-11 00:35:06 +0200 | [diff] [blame] | 319 | struct snd_pcm_mmap_status *status; | 
|  | 320 | struct snd_pcm_mmap_control *control; | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 321 |  | 
|  | 322 | /* -- locking / scheduling -- */ | 
| David Dillow | 5daeba3 | 2010-06-27 00:13:20 +0200 | [diff] [blame] | 323 | snd_pcm_uframes_t twake; 	/* do transfer (!poll) wakeup if non-zero */ | 
| Jaroslav Kysela | c91a988 | 2010-01-21 10:32:15 +0100 | [diff] [blame] | 324 | wait_queue_head_t sleep;	/* poll sleep */ | 
|  | 325 | wait_queue_head_t tsleep;	/* transfer sleep */ | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 326 | struct fasync_struct *fasync; | 
|  | 327 |  | 
|  | 328 | /* -- private section -- */ | 
|  | 329 | void *private_data; | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 330 | void (*private_free)(struct snd_pcm_runtime *runtime); | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 331 |  | 
|  | 332 | /* -- hardware description -- */ | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 333 | struct snd_pcm_hardware hw; | 
|  | 334 | struct snd_pcm_hw_constraints hw_constraints; | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 335 |  | 
|  | 336 | /* -- interrupt callbacks -- */ | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 337 | void (*transfer_ack_begin)(struct snd_pcm_substream *substream); | 
|  | 338 | void (*transfer_ack_end)(struct snd_pcm_substream *substream); | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 339 |  | 
|  | 340 | /* -- timer -- */ | 
|  | 341 | unsigned int timer_resolution;	/* timer resolution */ | 
| Jaroslav Kysela | b751eef | 2007-12-13 10:19:42 +0100 | [diff] [blame] | 342 | int tstamp_type;		/* timestamp type */ | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 343 |  | 
|  | 344 | /* -- DMA -- */ | 
|  | 345 | unsigned char *dma_area;	/* DMA area */ | 
|  | 346 | dma_addr_t dma_addr;		/* physical bus address (not accessible from main CPU) */ | 
|  | 347 | size_t dma_bytes;		/* size of DMA area */ | 
|  | 348 |  | 
|  | 349 | struct snd_dma_buffer *dma_buffer_p;	/* allocated buffer */ | 
|  | 350 |  | 
|  | 351 | #if defined(CONFIG_SND_PCM_OSS) || defined(CONFIG_SND_PCM_OSS_MODULE) | 
|  | 352 | /* -- OSS things -- */ | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 353 | struct snd_pcm_oss_runtime oss; | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 354 | #endif | 
| Jaroslav Kysela | 4d96eb2 | 2009-12-20 11:47:57 +0100 | [diff] [blame] | 355 |  | 
|  | 356 | #ifdef CONFIG_SND_PCM_XRUN_DEBUG | 
|  | 357 | struct snd_pcm_hwptr_log *hwptr_log; | 
|  | 358 | #endif | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 359 | }; | 
|  | 360 |  | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 361 | struct snd_pcm_group {		/* keep linked substreams */ | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 362 | spinlock_t lock; | 
|  | 363 | struct list_head substreams; | 
|  | 364 | int count; | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 365 | }; | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 366 |  | 
| Clemens Ladisch | e7373b7 | 2009-11-10 10:13:30 +0100 | [diff] [blame] | 367 | struct pid; | 
|  | 368 |  | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 369 | struct snd_pcm_substream { | 
|  | 370 | struct snd_pcm *pcm; | 
|  | 371 | struct snd_pcm_str *pstr; | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 372 | void *private_data;		/* copied from pcm->private_data */ | 
|  | 373 | int number; | 
|  | 374 | char name[32];			/* substream name */ | 
|  | 375 | int stream;			/* stream (direction) */ | 
| James Bottomley | 82f6825 | 2010-07-05 22:53:06 +0200 | [diff] [blame] | 376 | struct pm_qos_request_list latency_pm_qos_req; /* pm_qos request */ | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 377 | size_t buffer_bytes_max;	/* limit ring buffer size */ | 
|  | 378 | struct snd_dma_buffer dma_buffer; | 
|  | 379 | unsigned int dma_buf_id; | 
|  | 380 | size_t dma_max; | 
|  | 381 | /* -- hardware operations -- */ | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 382 | struct snd_pcm_ops *ops; | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 383 | /* -- runtime information -- */ | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 384 | struct snd_pcm_runtime *runtime; | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 385 | /* -- timer section -- */ | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 386 | struct snd_timer *timer;		/* timer */ | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 387 | unsigned timer_running: 1;	/* time is running */ | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 388 | /* -- next substream -- */ | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 389 | struct snd_pcm_substream *next; | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 390 | /* -- linked substreams -- */ | 
|  | 391 | struct list_head link_list;	/* linked list member */ | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 392 | struct snd_pcm_group self_group;	/* fake group for non linked substream (with substream lock inside) */ | 
|  | 393 | struct snd_pcm_group *group;		/* pointer to current group */ | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 394 | /* -- assigned files -- */ | 
| Takashi Iwai | 1576274 | 2006-04-06 19:47:42 +0200 | [diff] [blame] | 395 | void *file; | 
| Takashi Iwai | 0df63e4 | 2006-04-28 15:13:41 +0200 | [diff] [blame] | 396 | int ref_count; | 
| Takashi Iwai | 9c323fc | 2006-04-28 15:13:41 +0200 | [diff] [blame] | 397 | atomic_t mmap_count; | 
| Takashi Iwai | 0df63e4 | 2006-04-28 15:13:41 +0200 | [diff] [blame] | 398 | unsigned int f_flags; | 
| Takashi Iwai | 3bf75f9 | 2006-03-27 16:40:49 +0200 | [diff] [blame] | 399 | void (*pcm_release)(struct snd_pcm_substream *); | 
| Clemens Ladisch | e7373b7 | 2009-11-10 10:13:30 +0100 | [diff] [blame] | 400 | struct pid *pid; | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 401 | #if defined(CONFIG_SND_PCM_OSS) || defined(CONFIG_SND_PCM_OSS_MODULE) | 
|  | 402 | /* -- OSS things -- */ | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 403 | struct snd_pcm_oss_substream oss; | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 404 | #endif | 
| Takashi Iwai | b7d90a3 | 2006-04-25 12:56:04 +0200 | [diff] [blame] | 405 | #ifdef CONFIG_SND_VERBOSE_PROCFS | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 406 | struct snd_info_entry *proc_root; | 
|  | 407 | struct snd_info_entry *proc_info_entry; | 
|  | 408 | struct snd_info_entry *proc_hw_params_entry; | 
|  | 409 | struct snd_info_entry *proc_sw_params_entry; | 
|  | 410 | struct snd_info_entry *proc_status_entry; | 
|  | 411 | struct snd_info_entry *proc_prealloc_entry; | 
| Jaroslav Kysela | c7132ae | 2006-10-06 15:12:29 +0200 | [diff] [blame] | 412 | struct snd_info_entry *proc_prealloc_max_entry; | 
| Takashi Iwai | b7d90a3 | 2006-04-25 12:56:04 +0200 | [diff] [blame] | 413 | #endif | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 414 | /* misc flags */ | 
| Takashi Iwai | 3bf75f9 | 2006-03-27 16:40:49 +0200 | [diff] [blame] | 415 | unsigned int hw_opened: 1; | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 416 | }; | 
|  | 417 |  | 
| Takashi Iwai | 0df63e4 | 2006-04-28 15:13:41 +0200 | [diff] [blame] | 418 | #define SUBSTREAM_BUSY(substream) ((substream)->ref_count > 0) | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 419 |  | 
|  | 420 |  | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 421 | struct snd_pcm_str { | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 422 | int stream;				/* stream (direction) */ | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 423 | struct snd_pcm *pcm; | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 424 | /* -- substreams -- */ | 
|  | 425 | unsigned int substream_count; | 
|  | 426 | unsigned int substream_opened; | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 427 | struct snd_pcm_substream *substream; | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 428 | #if defined(CONFIG_SND_PCM_OSS) || defined(CONFIG_SND_PCM_OSS_MODULE) | 
|  | 429 | /* -- OSS things -- */ | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 430 | struct snd_pcm_oss_stream oss; | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 431 | #endif | 
| Takashi Iwai | b7d90a3 | 2006-04-25 12:56:04 +0200 | [diff] [blame] | 432 | #ifdef CONFIG_SND_VERBOSE_PROCFS | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 433 | struct snd_info_entry *proc_root; | 
|  | 434 | struct snd_info_entry *proc_info_entry; | 
| Takashi Iwai | b7d90a3 | 2006-04-25 12:56:04 +0200 | [diff] [blame] | 435 | #ifdef CONFIG_SND_PCM_XRUN_DEBUG | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 436 | unsigned int xrun_debug;	/* 0 = disabled, 1 = verbose, 2 = stacktrace */ | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 437 | struct snd_info_entry *proc_xrun_debug_entry; | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 438 | #endif | 
| Takashi Iwai | b7d90a3 | 2006-04-25 12:56:04 +0200 | [diff] [blame] | 439 | #endif | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 440 | }; | 
|  | 441 |  | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 442 | struct snd_pcm { | 
|  | 443 | struct snd_card *card; | 
| Clemens Ladisch | f87135f | 2005-11-20 14:06:59 +0100 | [diff] [blame] | 444 | struct list_head list; | 
| Pawel MOLL | f90c06a | 2008-07-30 12:46:40 +0100 | [diff] [blame] | 445 | int device; /* device number */ | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 446 | unsigned int info_flags; | 
|  | 447 | unsigned short dev_class; | 
|  | 448 | unsigned short dev_subclass; | 
|  | 449 | char id[64]; | 
|  | 450 | char name[80]; | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 451 | struct snd_pcm_str streams[2]; | 
| Ingo Molnar | 1a60d4c | 2006-01-16 16:29:08 +0100 | [diff] [blame] | 452 | struct mutex open_mutex; | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 453 | wait_queue_head_t open_wait; | 
|  | 454 | void *private_data; | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 455 | void (*private_free) (struct snd_pcm *pcm); | 
| Johannes Berg | c78085f | 2006-10-05 15:06:34 +0200 | [diff] [blame] | 456 | struct device *dev; /* actual hw device this belongs to */ | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 457 | #if defined(CONFIG_SND_PCM_OSS) || defined(CONFIG_SND_PCM_OSS_MODULE) | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 458 | struct snd_pcm_oss oss; | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 459 | #endif | 
|  | 460 | }; | 
|  | 461 |  | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 462 | struct snd_pcm_notify { | 
|  | 463 | int (*n_register) (struct snd_pcm * pcm); | 
|  | 464 | int (*n_disconnect) (struct snd_pcm * pcm); | 
|  | 465 | int (*n_unregister) (struct snd_pcm * pcm); | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 466 | struct list_head list; | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 467 | }; | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 468 |  | 
|  | 469 | /* | 
|  | 470 | *  Registering | 
|  | 471 | */ | 
|  | 472 |  | 
| Arjan van de Ven | 5404732 | 2007-02-12 00:55:28 -0800 | [diff] [blame] | 473 | extern const struct file_operations snd_pcm_f_ops[2]; | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 474 |  | 
| Tim Blechmann | e616165 | 2009-02-05 13:01:54 +0100 | [diff] [blame] | 475 | int snd_pcm_new(struct snd_card *card, const char *id, int device, | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 476 | int playback_count, int capture_count, | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 477 | struct snd_pcm **rpcm); | 
|  | 478 | int snd_pcm_new_stream(struct snd_pcm *pcm, int stream, int substream_count); | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 479 |  | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 480 | int snd_pcm_notify(struct snd_pcm_notify *notify, int nfree); | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 481 |  | 
|  | 482 | /* | 
|  | 483 | *  Native I/O | 
|  | 484 | */ | 
|  | 485 |  | 
|  | 486 | extern rwlock_t snd_pcm_link_rwlock; | 
|  | 487 |  | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 488 | int snd_pcm_info(struct snd_pcm_substream *substream, struct snd_pcm_info *info); | 
|  | 489 | int snd_pcm_info_user(struct snd_pcm_substream *substream, | 
|  | 490 | struct snd_pcm_info __user *info); | 
|  | 491 | int snd_pcm_status(struct snd_pcm_substream *substream, | 
|  | 492 | struct snd_pcm_status *status); | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 493 | int snd_pcm_start(struct snd_pcm_substream *substream); | 
| Clemens Ladisch | fea952e | 2011-02-14 11:00:47 +0100 | [diff] [blame] | 494 | int snd_pcm_stop(struct snd_pcm_substream *substream, snd_pcm_state_t status); | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 495 | int snd_pcm_drain_done(struct snd_pcm_substream *substream); | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 496 | #ifdef CONFIG_PM | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 497 | int snd_pcm_suspend(struct snd_pcm_substream *substream); | 
|  | 498 | int snd_pcm_suspend_all(struct snd_pcm *pcm); | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 499 | #endif | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 500 | int snd_pcm_kernel_ioctl(struct snd_pcm_substream *substream, unsigned int cmd, void *arg); | 
| Takashi Iwai | 3bf75f9 | 2006-03-27 16:40:49 +0200 | [diff] [blame] | 501 | int snd_pcm_open_substream(struct snd_pcm *pcm, int stream, struct file *file, | 
|  | 502 | struct snd_pcm_substream **rsubstream); | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 503 | void snd_pcm_release_substream(struct snd_pcm_substream *substream); | 
| Takashi Iwai | 3bf75f9 | 2006-03-27 16:40:49 +0200 | [diff] [blame] | 504 | int snd_pcm_attach_substream(struct snd_pcm *pcm, int stream, struct file *file, | 
|  | 505 | struct snd_pcm_substream **rsubstream); | 
|  | 506 | void snd_pcm_detach_substream(struct snd_pcm_substream *substream); | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 507 | void snd_pcm_vma_notify_data(void *client, void *data); | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 508 | int snd_pcm_mmap_data(struct snd_pcm_substream *substream, struct file *file, struct vm_area_struct *area); | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 509 |  | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 510 | /* | 
|  | 511 | *  PCM library | 
|  | 512 | */ | 
|  | 513 |  | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 514 | static inline int snd_pcm_stream_linked(struct snd_pcm_substream *substream) | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 515 | { | 
|  | 516 | return substream->group != &substream->self_group; | 
|  | 517 | } | 
|  | 518 |  | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 519 | static inline void snd_pcm_stream_lock(struct snd_pcm_substream *substream) | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 520 | { | 
|  | 521 | read_lock(&snd_pcm_link_rwlock); | 
|  | 522 | spin_lock(&substream->self_group.lock); | 
|  | 523 | } | 
|  | 524 |  | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 525 | static inline void snd_pcm_stream_unlock(struct snd_pcm_substream *substream) | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 526 | { | 
|  | 527 | spin_unlock(&substream->self_group.lock); | 
|  | 528 | read_unlock(&snd_pcm_link_rwlock); | 
|  | 529 | } | 
|  | 530 |  | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 531 | static inline void snd_pcm_stream_lock_irq(struct snd_pcm_substream *substream) | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 532 | { | 
|  | 533 | read_lock_irq(&snd_pcm_link_rwlock); | 
|  | 534 | spin_lock(&substream->self_group.lock); | 
|  | 535 | } | 
|  | 536 |  | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 537 | static inline void snd_pcm_stream_unlock_irq(struct snd_pcm_substream *substream) | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 538 | { | 
|  | 539 | spin_unlock(&substream->self_group.lock); | 
|  | 540 | read_unlock_irq(&snd_pcm_link_rwlock); | 
|  | 541 | } | 
|  | 542 |  | 
|  | 543 | #define snd_pcm_stream_lock_irqsave(substream, flags) \ | 
|  | 544 | do { \ | 
|  | 545 | read_lock_irqsave(&snd_pcm_link_rwlock, (flags)); \ | 
|  | 546 | spin_lock(&substream->self_group.lock); \ | 
|  | 547 | } while (0) | 
|  | 548 |  | 
|  | 549 | #define snd_pcm_stream_unlock_irqrestore(substream, flags) \ | 
|  | 550 | do { \ | 
|  | 551 | spin_unlock(&substream->self_group.lock); \ | 
|  | 552 | read_unlock_irqrestore(&snd_pcm_link_rwlock, (flags)); \ | 
|  | 553 | } while (0) | 
|  | 554 |  | 
| Takashi Iwai | ef991b9 | 2007-02-22 12:52:53 +0100 | [diff] [blame] | 555 | #define snd_pcm_group_for_each_entry(s, substream) \ | 
|  | 556 | list_for_each_entry(s, &substream->group->substreams, link_list) | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 557 |  | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 558 | static inline int snd_pcm_running(struct snd_pcm_substream *substream) | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 559 | { | 
|  | 560 | return (substream->runtime->status->state == SNDRV_PCM_STATE_RUNNING || | 
|  | 561 | (substream->runtime->status->state == SNDRV_PCM_STATE_DRAINING && | 
|  | 562 | substream->stream == SNDRV_PCM_STREAM_PLAYBACK)); | 
|  | 563 | } | 
|  | 564 |  | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 565 | static inline ssize_t bytes_to_samples(struct snd_pcm_runtime *runtime, ssize_t size) | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 566 | { | 
|  | 567 | return size * 8 / runtime->sample_bits; | 
|  | 568 | } | 
|  | 569 |  | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 570 | static inline snd_pcm_sframes_t bytes_to_frames(struct snd_pcm_runtime *runtime, ssize_t size) | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 571 | { | 
|  | 572 | return size * 8 / runtime->frame_bits; | 
|  | 573 | } | 
|  | 574 |  | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 575 | static inline ssize_t samples_to_bytes(struct snd_pcm_runtime *runtime, ssize_t size) | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 576 | { | 
|  | 577 | return size * runtime->sample_bits / 8; | 
|  | 578 | } | 
|  | 579 |  | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 580 | static inline ssize_t frames_to_bytes(struct snd_pcm_runtime *runtime, snd_pcm_sframes_t size) | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 581 | { | 
|  | 582 | return size * runtime->frame_bits / 8; | 
|  | 583 | } | 
|  | 584 |  | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 585 | static inline int frame_aligned(struct snd_pcm_runtime *runtime, ssize_t bytes) | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 586 | { | 
|  | 587 | return bytes % runtime->byte_align == 0; | 
|  | 588 | } | 
|  | 589 |  | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 590 | static inline size_t snd_pcm_lib_buffer_bytes(struct snd_pcm_substream *substream) | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 591 | { | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 592 | struct snd_pcm_runtime *runtime = substream->runtime; | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 593 | return frames_to_bytes(runtime, runtime->buffer_size); | 
|  | 594 | } | 
|  | 595 |  | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 596 | static inline size_t snd_pcm_lib_period_bytes(struct snd_pcm_substream *substream) | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 597 | { | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 598 | struct snd_pcm_runtime *runtime = substream->runtime; | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 599 | return frames_to_bytes(runtime, runtime->period_size); | 
|  | 600 | } | 
|  | 601 |  | 
|  | 602 | /* | 
|  | 603 | *  result is: 0 ... (boundary - 1) | 
|  | 604 | */ | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 605 | static inline snd_pcm_uframes_t snd_pcm_playback_avail(struct snd_pcm_runtime *runtime) | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 606 | { | 
|  | 607 | snd_pcm_sframes_t avail = runtime->status->hw_ptr + runtime->buffer_size - runtime->control->appl_ptr; | 
|  | 608 | if (avail < 0) | 
|  | 609 | avail += runtime->boundary; | 
|  | 610 | else if ((snd_pcm_uframes_t) avail >= runtime->boundary) | 
|  | 611 | avail -= runtime->boundary; | 
|  | 612 | return avail; | 
|  | 613 | } | 
|  | 614 |  | 
|  | 615 | /* | 
|  | 616 | *  result is: 0 ... (boundary - 1) | 
|  | 617 | */ | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 618 | static inline snd_pcm_uframes_t snd_pcm_capture_avail(struct snd_pcm_runtime *runtime) | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 619 | { | 
|  | 620 | snd_pcm_sframes_t avail = runtime->status->hw_ptr - runtime->control->appl_ptr; | 
|  | 621 | if (avail < 0) | 
|  | 622 | avail += runtime->boundary; | 
|  | 623 | return avail; | 
|  | 624 | } | 
|  | 625 |  | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 626 | static inline snd_pcm_sframes_t snd_pcm_playback_hw_avail(struct snd_pcm_runtime *runtime) | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 627 | { | 
|  | 628 | return runtime->buffer_size - snd_pcm_playback_avail(runtime); | 
|  | 629 | } | 
|  | 630 |  | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 631 | static inline snd_pcm_sframes_t snd_pcm_capture_hw_avail(struct snd_pcm_runtime *runtime) | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 632 | { | 
|  | 633 | return runtime->buffer_size - snd_pcm_capture_avail(runtime); | 
|  | 634 | } | 
|  | 635 |  | 
|  | 636 | /** | 
|  | 637 | * snd_pcm_playback_ready - check whether the playback buffer is available | 
|  | 638 | * @substream: the pcm substream instance | 
|  | 639 | * | 
|  | 640 | * Checks whether enough free space is available on the playback buffer. | 
|  | 641 | * | 
|  | 642 | * Returns non-zero if available, or zero if not. | 
|  | 643 | */ | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 644 | static inline int snd_pcm_playback_ready(struct snd_pcm_substream *substream) | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 645 | { | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 646 | struct snd_pcm_runtime *runtime = substream->runtime; | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 647 | return snd_pcm_playback_avail(runtime) >= runtime->control->avail_min; | 
|  | 648 | } | 
|  | 649 |  | 
|  | 650 | /** | 
|  | 651 | * snd_pcm_capture_ready - check whether the capture buffer is available | 
|  | 652 | * @substream: the pcm substream instance | 
|  | 653 | * | 
|  | 654 | * Checks whether enough capture data is available on the capture buffer. | 
|  | 655 | * | 
|  | 656 | * Returns non-zero if available, or zero if not. | 
|  | 657 | */ | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 658 | static inline int snd_pcm_capture_ready(struct snd_pcm_substream *substream) | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 659 | { | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 660 | struct snd_pcm_runtime *runtime = substream->runtime; | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 661 | return snd_pcm_capture_avail(runtime) >= runtime->control->avail_min; | 
|  | 662 | } | 
|  | 663 |  | 
|  | 664 | /** | 
|  | 665 | * snd_pcm_playback_data - check whether any data exists on the playback buffer | 
|  | 666 | * @substream: the pcm substream instance | 
|  | 667 | * | 
|  | 668 | * Checks whether any data exists on the playback buffer. If stop_threshold | 
|  | 669 | * is bigger or equal to boundary, then this function returns always non-zero. | 
|  | 670 | * | 
|  | 671 | * Returns non-zero if exists, or zero if not. | 
|  | 672 | */ | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 673 | static inline int snd_pcm_playback_data(struct snd_pcm_substream *substream) | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 674 | { | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 675 | struct snd_pcm_runtime *runtime = substream->runtime; | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 676 |  | 
|  | 677 | if (runtime->stop_threshold >= runtime->boundary) | 
|  | 678 | return 1; | 
|  | 679 | return snd_pcm_playback_avail(runtime) < runtime->buffer_size; | 
|  | 680 | } | 
|  | 681 |  | 
|  | 682 | /** | 
|  | 683 | * snd_pcm_playback_empty - check whether the playback buffer is empty | 
|  | 684 | * @substream: the pcm substream instance | 
|  | 685 | * | 
|  | 686 | * Checks whether the playback buffer is empty. | 
|  | 687 | * | 
|  | 688 | * Returns non-zero if empty, or zero if not. | 
|  | 689 | */ | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 690 | static inline int snd_pcm_playback_empty(struct snd_pcm_substream *substream) | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 691 | { | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 692 | struct snd_pcm_runtime *runtime = substream->runtime; | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 693 | return snd_pcm_playback_avail(runtime) >= runtime->buffer_size; | 
|  | 694 | } | 
|  | 695 |  | 
|  | 696 | /** | 
|  | 697 | * snd_pcm_capture_empty - check whether the capture buffer is empty | 
|  | 698 | * @substream: the pcm substream instance | 
|  | 699 | * | 
|  | 700 | * Checks whether the capture buffer is empty. | 
|  | 701 | * | 
|  | 702 | * Returns non-zero if empty, or zero if not. | 
|  | 703 | */ | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 704 | static inline int snd_pcm_capture_empty(struct snd_pcm_substream *substream) | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 705 | { | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 706 | struct snd_pcm_runtime *runtime = substream->runtime; | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 707 | return snd_pcm_capture_avail(runtime) == 0; | 
|  | 708 | } | 
|  | 709 |  | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 710 | static inline void snd_pcm_trigger_done(struct snd_pcm_substream *substream, | 
|  | 711 | struct snd_pcm_substream *master) | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 712 | { | 
|  | 713 | substream->runtime->trigger_master = master; | 
|  | 714 | } | 
|  | 715 |  | 
|  | 716 | static inline int hw_is_mask(int var) | 
|  | 717 | { | 
|  | 718 | return var >= SNDRV_PCM_HW_PARAM_FIRST_MASK && | 
|  | 719 | var <= SNDRV_PCM_HW_PARAM_LAST_MASK; | 
|  | 720 | } | 
|  | 721 |  | 
|  | 722 | static inline int hw_is_interval(int var) | 
|  | 723 | { | 
|  | 724 | return var >= SNDRV_PCM_HW_PARAM_FIRST_INTERVAL && | 
|  | 725 | var <= SNDRV_PCM_HW_PARAM_LAST_INTERVAL; | 
|  | 726 | } | 
|  | 727 |  | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 728 | static inline struct snd_mask *hw_param_mask(struct snd_pcm_hw_params *params, | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 729 | snd_pcm_hw_param_t var) | 
|  | 730 | { | 
|  | 731 | return ¶ms->masks[var - SNDRV_PCM_HW_PARAM_FIRST_MASK]; | 
|  | 732 | } | 
|  | 733 |  | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 734 | static inline struct snd_interval *hw_param_interval(struct snd_pcm_hw_params *params, | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 735 | snd_pcm_hw_param_t var) | 
|  | 736 | { | 
|  | 737 | return ¶ms->intervals[var - SNDRV_PCM_HW_PARAM_FIRST_INTERVAL]; | 
|  | 738 | } | 
|  | 739 |  | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 740 | static inline const struct snd_mask *hw_param_mask_c(const struct snd_pcm_hw_params *params, | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 741 | snd_pcm_hw_param_t var) | 
|  | 742 | { | 
| Takashi Iwai | b9f09a4 | 2007-09-11 00:33:48 +0200 | [diff] [blame] | 743 | return ¶ms->masks[var - SNDRV_PCM_HW_PARAM_FIRST_MASK]; | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 744 | } | 
|  | 745 |  | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 746 | static inline const struct snd_interval *hw_param_interval_c(const struct snd_pcm_hw_params *params, | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 747 | snd_pcm_hw_param_t var) | 
|  | 748 | { | 
| Takashi Iwai | b9f09a4 | 2007-09-11 00:33:48 +0200 | [diff] [blame] | 749 | return ¶ms->intervals[var - SNDRV_PCM_HW_PARAM_FIRST_INTERVAL]; | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 750 | } | 
|  | 751 |  | 
| Clemens Ladisch | fea952e | 2011-02-14 11:00:47 +0100 | [diff] [blame] | 752 | #define params_access(p) ((__force snd_pcm_access_t)snd_mask_min(hw_param_mask((p), SNDRV_PCM_HW_PARAM_ACCESS))) | 
|  | 753 | #define params_format(p) ((__force snd_pcm_format_t)snd_mask_min(hw_param_mask((p), SNDRV_PCM_HW_PARAM_FORMAT))) | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 754 | #define params_subformat(p) snd_mask_min(hw_param_mask((p), SNDRV_PCM_HW_PARAM_SUBFORMAT)) | 
|  | 755 | #define params_channels(p) hw_param_interval((p), SNDRV_PCM_HW_PARAM_CHANNELS)->min | 
|  | 756 | #define params_rate(p) hw_param_interval((p), SNDRV_PCM_HW_PARAM_RATE)->min | 
|  | 757 | #define params_period_size(p) hw_param_interval((p), SNDRV_PCM_HW_PARAM_PERIOD_SIZE)->min | 
|  | 758 | #define params_period_bytes(p) ((params_period_size(p)*snd_pcm_format_physical_width(params_format(p))*params_channels(p))/8) | 
|  | 759 | #define params_periods(p) hw_param_interval((p), SNDRV_PCM_HW_PARAM_PERIODS)->min | 
|  | 760 | #define params_buffer_size(p) hw_param_interval((p), SNDRV_PCM_HW_PARAM_BUFFER_SIZE)->min | 
|  | 761 | #define params_buffer_bytes(p) hw_param_interval((p), SNDRV_PCM_HW_PARAM_BUFFER_BYTES)->min | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 762 |  | 
|  | 763 |  | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 764 | int snd_interval_refine(struct snd_interval *i, const struct snd_interval *v); | 
|  | 765 | void snd_interval_mul(const struct snd_interval *a, const struct snd_interval *b, struct snd_interval *c); | 
|  | 766 | void snd_interval_div(const struct snd_interval *a, const struct snd_interval *b, struct snd_interval *c); | 
|  | 767 | void snd_interval_muldivk(const struct snd_interval *a, const struct snd_interval *b, | 
|  | 768 | unsigned int k, struct snd_interval *c); | 
|  | 769 | void snd_interval_mulkdiv(const struct snd_interval *a, unsigned int k, | 
|  | 770 | const struct snd_interval *b, struct snd_interval *c); | 
|  | 771 | int snd_interval_list(struct snd_interval *i, unsigned int count, unsigned int *list, unsigned int mask); | 
|  | 772 | int snd_interval_ratnum(struct snd_interval *i, | 
|  | 773 | unsigned int rats_count, struct snd_ratnum *rats, | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 774 | unsigned int *nump, unsigned int *denp); | 
|  | 775 |  | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 776 | void _snd_pcm_hw_params_any(struct snd_pcm_hw_params *params); | 
|  | 777 | void _snd_pcm_hw_param_setempty(struct snd_pcm_hw_params *params, snd_pcm_hw_param_t var); | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 778 | int snd_pcm_hw_params_choose(struct snd_pcm_substream *substream, struct snd_pcm_hw_params *params); | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 779 |  | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 780 | int snd_pcm_hw_refine(struct snd_pcm_substream *substream, struct snd_pcm_hw_params *params); | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 781 |  | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 782 | int snd_pcm_hw_constraints_init(struct snd_pcm_substream *substream); | 
|  | 783 | int snd_pcm_hw_constraints_complete(struct snd_pcm_substream *substream); | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 784 |  | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 785 | int snd_pcm_hw_constraint_mask(struct snd_pcm_runtime *runtime, snd_pcm_hw_param_t var, | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 786 | u_int32_t mask); | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 787 | int snd_pcm_hw_constraint_mask64(struct snd_pcm_runtime *runtime, snd_pcm_hw_param_t var, | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 788 | u_int64_t mask); | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 789 | int snd_pcm_hw_constraint_minmax(struct snd_pcm_runtime *runtime, snd_pcm_hw_param_t var, | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 790 | unsigned int min, unsigned int max); | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 791 | int snd_pcm_hw_constraint_integer(struct snd_pcm_runtime *runtime, snd_pcm_hw_param_t var); | 
|  | 792 | int snd_pcm_hw_constraint_list(struct snd_pcm_runtime *runtime, | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 793 | unsigned int cond, | 
|  | 794 | snd_pcm_hw_param_t var, | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 795 | struct snd_pcm_hw_constraint_list *l); | 
|  | 796 | int snd_pcm_hw_constraint_ratnums(struct snd_pcm_runtime *runtime, | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 797 | unsigned int cond, | 
|  | 798 | snd_pcm_hw_param_t var, | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 799 | struct snd_pcm_hw_constraint_ratnums *r); | 
|  | 800 | int snd_pcm_hw_constraint_ratdens(struct snd_pcm_runtime *runtime, | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 801 | unsigned int cond, | 
|  | 802 | snd_pcm_hw_param_t var, | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 803 | struct snd_pcm_hw_constraint_ratdens *r); | 
|  | 804 | int snd_pcm_hw_constraint_msbits(struct snd_pcm_runtime *runtime, | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 805 | unsigned int cond, | 
|  | 806 | unsigned int width, | 
|  | 807 | unsigned int msbits); | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 808 | int snd_pcm_hw_constraint_step(struct snd_pcm_runtime *runtime, | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 809 | unsigned int cond, | 
|  | 810 | snd_pcm_hw_param_t var, | 
|  | 811 | unsigned long step); | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 812 | int snd_pcm_hw_constraint_pow2(struct snd_pcm_runtime *runtime, | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 813 | unsigned int cond, | 
|  | 814 | snd_pcm_hw_param_t var); | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 815 | int snd_pcm_hw_rule_add(struct snd_pcm_runtime *runtime, | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 816 | unsigned int cond, | 
|  | 817 | int var, | 
|  | 818 | snd_pcm_hw_rule_func_t func, void *private, | 
|  | 819 | int dep, ...); | 
|  | 820 |  | 
|  | 821 | int snd_pcm_format_signed(snd_pcm_format_t format); | 
|  | 822 | int snd_pcm_format_unsigned(snd_pcm_format_t format); | 
|  | 823 | int snd_pcm_format_linear(snd_pcm_format_t format); | 
|  | 824 | int snd_pcm_format_little_endian(snd_pcm_format_t format); | 
|  | 825 | int snd_pcm_format_big_endian(snd_pcm_format_t format); | 
| Takashi Iwai | 1b44c28 | 2005-09-09 15:05:33 +0200 | [diff] [blame] | 826 | #if 0 /* just for DocBook */ | 
|  | 827 | /** | 
| Takashi Iwai | 9502dca | 2005-05-18 16:25:46 +0200 | [diff] [blame] | 828 | * snd_pcm_format_cpu_endian - Check the PCM format is CPU-endian | 
|  | 829 | * @format: the format to check | 
|  | 830 | * | 
|  | 831 | * Returns 1 if the given PCM format is CPU-endian, 0 if | 
|  | 832 | * opposite, or a negative error code if endian not specified. | 
|  | 833 | */ | 
| Takashi Iwai | 8cdfd25 | 2005-09-07 14:08:11 +0200 | [diff] [blame] | 834 | int snd_pcm_format_cpu_endian(snd_pcm_format_t format); | 
| Takashi Iwai | 1b44c28 | 2005-09-09 15:05:33 +0200 | [diff] [blame] | 835 | #endif /* DocBook */ | 
| Takashi Iwai | 9502dca | 2005-05-18 16:25:46 +0200 | [diff] [blame] | 836 | #ifdef SNDRV_LITTLE_ENDIAN | 
| Martin Waitz | 9d01a82 | 2005-09-09 13:10:17 -0700 | [diff] [blame] | 837 | #define snd_pcm_format_cpu_endian(format) snd_pcm_format_little_endian(format) | 
| Takashi Iwai | 9502dca | 2005-05-18 16:25:46 +0200 | [diff] [blame] | 838 | #else | 
| Martin Waitz | 9d01a82 | 2005-09-09 13:10:17 -0700 | [diff] [blame] | 839 | #define snd_pcm_format_cpu_endian(format) snd_pcm_format_big_endian(format) | 
| Takashi Iwai | 9502dca | 2005-05-18 16:25:46 +0200 | [diff] [blame] | 840 | #endif | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 841 | int snd_pcm_format_width(snd_pcm_format_t format);			/* in bits */ | 
|  | 842 | int snd_pcm_format_physical_width(snd_pcm_format_t format);		/* in bits */ | 
| Takashi Iwai | 9502dca | 2005-05-18 16:25:46 +0200 | [diff] [blame] | 843 | ssize_t snd_pcm_format_size(snd_pcm_format_t format, size_t samples); | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 844 | const unsigned char *snd_pcm_format_silence_64(snd_pcm_format_t format); | 
|  | 845 | int snd_pcm_format_set_silence(snd_pcm_format_t format, void *buf, unsigned int frames); | 
|  | 846 | snd_pcm_format_t snd_pcm_build_linear_format(int width, int unsignd, int big_endian); | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 847 |  | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 848 | void snd_pcm_set_ops(struct snd_pcm * pcm, int direction, struct snd_pcm_ops *ops); | 
|  | 849 | void snd_pcm_set_sync(struct snd_pcm_substream *substream); | 
|  | 850 | int snd_pcm_lib_interleave_len(struct snd_pcm_substream *substream); | 
|  | 851 | int snd_pcm_lib_ioctl(struct snd_pcm_substream *substream, | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 852 | unsigned int cmd, void *arg); | 
| Jaroslav Kysela | 1250932 | 2010-01-07 15:36:31 +0100 | [diff] [blame] | 853 | int snd_pcm_update_state(struct snd_pcm_substream *substream, | 
|  | 854 | struct snd_pcm_runtime *runtime); | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 855 | int snd_pcm_update_hw_ptr(struct snd_pcm_substream *substream); | 
|  | 856 | int snd_pcm_playback_xrun_check(struct snd_pcm_substream *substream); | 
|  | 857 | int snd_pcm_capture_xrun_check(struct snd_pcm_substream *substream); | 
|  | 858 | int snd_pcm_playback_xrun_asap(struct snd_pcm_substream *substream); | 
|  | 859 | int snd_pcm_capture_xrun_asap(struct snd_pcm_substream *substream); | 
|  | 860 | void snd_pcm_playback_silence(struct snd_pcm_substream *substream, snd_pcm_uframes_t new_hw_ptr); | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 861 | void snd_pcm_period_elapsed(struct snd_pcm_substream *substream); | 
|  | 862 | snd_pcm_sframes_t snd_pcm_lib_write(struct snd_pcm_substream *substream, | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 863 | const void __user *buf, | 
|  | 864 | snd_pcm_uframes_t frames); | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 865 | snd_pcm_sframes_t snd_pcm_lib_read(struct snd_pcm_substream *substream, | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 866 | void __user *buf, snd_pcm_uframes_t frames); | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 867 | snd_pcm_sframes_t snd_pcm_lib_writev(struct snd_pcm_substream *substream, | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 868 | void __user **bufs, snd_pcm_uframes_t frames); | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 869 | snd_pcm_sframes_t snd_pcm_lib_readv(struct snd_pcm_substream *substream, | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 870 | void __user **bufs, snd_pcm_uframes_t frames); | 
|  | 871 |  | 
| Clemens Ladisch | 7653d55 | 2007-08-13 17:38:54 +0200 | [diff] [blame] | 872 | extern const struct snd_pcm_hw_constraint_list snd_pcm_known_rates; | 
|  | 873 |  | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 874 | int snd_pcm_limit_hw_rates(struct snd_pcm_runtime *runtime); | 
| Clemens Ladisch | 918f3a0 | 2007-08-13 17:40:54 +0200 | [diff] [blame] | 875 | unsigned int snd_pcm_rate_to_rate_bit(unsigned int rate); | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 876 |  | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 877 | static inline void snd_pcm_set_runtime_buffer(struct snd_pcm_substream *substream, | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 878 | struct snd_dma_buffer *bufp) | 
|  | 879 | { | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 880 | struct snd_pcm_runtime *runtime = substream->runtime; | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 881 | if (bufp) { | 
|  | 882 | runtime->dma_buffer_p = bufp; | 
|  | 883 | runtime->dma_area = bufp->area; | 
|  | 884 | runtime->dma_addr = bufp->addr; | 
|  | 885 | runtime->dma_bytes = bufp->bytes; | 
|  | 886 | } else { | 
|  | 887 | runtime->dma_buffer_p = NULL; | 
|  | 888 | runtime->dma_area = NULL; | 
|  | 889 | runtime->dma_addr = 0; | 
|  | 890 | runtime->dma_bytes = 0; | 
|  | 891 | } | 
|  | 892 | } | 
|  | 893 |  | 
|  | 894 | /* | 
|  | 895 | *  Timer interface | 
|  | 896 | */ | 
|  | 897 |  | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 898 | void snd_pcm_timer_resolution_change(struct snd_pcm_substream *substream); | 
|  | 899 | void snd_pcm_timer_init(struct snd_pcm_substream *substream); | 
|  | 900 | void snd_pcm_timer_done(struct snd_pcm_substream *substream); | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 901 |  | 
| Jaroslav Kysela | b751eef | 2007-12-13 10:19:42 +0100 | [diff] [blame] | 902 | static inline void snd_pcm_gettime(struct snd_pcm_runtime *runtime, | 
|  | 903 | struct timespec *tv) | 
|  | 904 | { | 
|  | 905 | if (runtime->tstamp_type == SNDRV_PCM_TSTAMP_TYPE_MONOTONIC) | 
|  | 906 | do_posix_clock_monotonic_gettime(tv); | 
|  | 907 | else | 
|  | 908 | getnstimeofday(tv); | 
|  | 909 | } | 
|  | 910 |  | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 911 | /* | 
|  | 912 | *  Memory | 
|  | 913 | */ | 
|  | 914 |  | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 915 | int snd_pcm_lib_preallocate_free(struct snd_pcm_substream *substream); | 
|  | 916 | int snd_pcm_lib_preallocate_free_for_all(struct snd_pcm *pcm); | 
|  | 917 | int snd_pcm_lib_preallocate_pages(struct snd_pcm_substream *substream, | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 918 | int type, struct device *data, | 
|  | 919 | size_t size, size_t max); | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 920 | int snd_pcm_lib_preallocate_pages_for_all(struct snd_pcm *pcm, | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 921 | int type, void *data, | 
|  | 922 | size_t size, size_t max); | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 923 | int snd_pcm_lib_malloc_pages(struct snd_pcm_substream *substream, size_t size); | 
|  | 924 | int snd_pcm_lib_free_pages(struct snd_pcm_substream *substream); | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 925 |  | 
| Clemens Ladisch | 681b84e | 2009-12-18 09:29:00 +0100 | [diff] [blame] | 926 | int _snd_pcm_lib_alloc_vmalloc_buffer(struct snd_pcm_substream *substream, | 
|  | 927 | size_t size, gfp_t gfp_flags); | 
|  | 928 | int snd_pcm_lib_free_vmalloc_buffer(struct snd_pcm_substream *substream); | 
|  | 929 | struct page *snd_pcm_lib_get_vmalloc_page(struct snd_pcm_substream *substream, | 
|  | 930 | unsigned long offset); | 
|  | 931 | #if 0 /* for kernel-doc */ | 
|  | 932 | /** | 
|  | 933 | * snd_pcm_lib_alloc_vmalloc_buffer - allocate virtual DMA buffer | 
|  | 934 | * @substream: the substream to allocate the buffer to | 
|  | 935 | * @size: the requested buffer size, in bytes | 
|  | 936 | * | 
|  | 937 | * Allocates the PCM substream buffer using vmalloc(), i.e., the memory is | 
|  | 938 | * contiguous in kernel virtual space, but not in physical memory.  Use this | 
|  | 939 | * if the buffer is accessed by kernel code but not by device DMA. | 
|  | 940 | * | 
|  | 941 | * Returns 1 if the buffer was changed, 0 if not changed, or a negative error | 
|  | 942 | * code. | 
|  | 943 | */ | 
|  | 944 | static int snd_pcm_lib_alloc_vmalloc_buffer | 
|  | 945 | (struct snd_pcm_substream *substream, size_t size); | 
|  | 946 | /** | 
|  | 947 | * snd_pcm_lib_alloc_vmalloc_32_buffer - allocate 32-bit-addressable buffer | 
|  | 948 | * @substream: the substream to allocate the buffer to | 
|  | 949 | * @size: the requested buffer size, in bytes | 
|  | 950 | * | 
|  | 951 | * This function works like snd_pcm_lib_alloc_vmalloc_buffer(), but uses | 
|  | 952 | * vmalloc_32(), i.e., the pages are allocated from 32-bit-addressable memory. | 
|  | 953 | */ | 
|  | 954 | static int snd_pcm_lib_alloc_vmalloc_32_buffer | 
|  | 955 | (struct snd_pcm_substream *substream, size_t size); | 
|  | 956 | #endif | 
|  | 957 | #define snd_pcm_lib_alloc_vmalloc_buffer(subs, size) \ | 
|  | 958 | _snd_pcm_lib_alloc_vmalloc_buffer \ | 
|  | 959 | (subs, size, GFP_KERNEL | __GFP_HIGHMEM | __GFP_ZERO) | 
|  | 960 | #define snd_pcm_lib_alloc_vmalloc_32_buffer(subs, size) \ | 
|  | 961 | _snd_pcm_lib_alloc_vmalloc_buffer \ | 
|  | 962 | (subs, size, GFP_KERNEL | GFP_DMA32 | __GFP_ZERO) | 
|  | 963 |  | 
| Takashi Iwai | cc6a8ac | 2008-06-17 16:39:06 +0200 | [diff] [blame] | 964 | #ifdef CONFIG_SND_DMA_SGBUF | 
| Takashi Iwai | 77a23f2 | 2008-08-21 13:00:13 +0200 | [diff] [blame] | 965 | /* | 
|  | 966 | * SG-buffer handling | 
|  | 967 | */ | 
|  | 968 | #define snd_pcm_substream_sgbuf(substream) \ | 
|  | 969 | ((substream)->runtime->dma_buffer_p->private_data) | 
|  | 970 |  | 
|  | 971 | static inline dma_addr_t | 
|  | 972 | snd_pcm_sgbuf_get_addr(struct snd_pcm_substream *substream, unsigned int ofs) | 
|  | 973 | { | 
|  | 974 | struct snd_sg_buf *sg = snd_pcm_substream_sgbuf(substream); | 
|  | 975 | return snd_sgbuf_get_addr(sg, ofs); | 
|  | 976 | } | 
|  | 977 |  | 
|  | 978 | static inline void * | 
|  | 979 | snd_pcm_sgbuf_get_ptr(struct snd_pcm_substream *substream, unsigned int ofs) | 
|  | 980 | { | 
|  | 981 | struct snd_sg_buf *sg = snd_pcm_substream_sgbuf(substream); | 
|  | 982 | return snd_sgbuf_get_ptr(sg, ofs); | 
|  | 983 | } | 
|  | 984 |  | 
|  | 985 | struct page *snd_pcm_sgbuf_ops_page(struct snd_pcm_substream *substream, | 
|  | 986 | unsigned long offset); | 
| Takashi Iwai | 51e9f2e | 2008-07-30 15:13:33 +0200 | [diff] [blame] | 987 | unsigned int snd_pcm_sgbuf_get_chunk_size(struct snd_pcm_substream *substream, | 
|  | 988 | unsigned int ofs, unsigned int size); | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 989 |  | 
| Takashi Iwai | cc6a8ac | 2008-06-17 16:39:06 +0200 | [diff] [blame] | 990 | #else /* !SND_DMA_SGBUF */ | 
|  | 991 | /* | 
|  | 992 | * fake using a continuous buffer | 
|  | 993 | */ | 
|  | 994 | static inline dma_addr_t | 
|  | 995 | snd_pcm_sgbuf_get_addr(struct snd_pcm_substream *substream, unsigned int ofs) | 
|  | 996 | { | 
|  | 997 | return substream->runtime->dma_addr + ofs; | 
|  | 998 | } | 
|  | 999 |  | 
|  | 1000 | static inline void * | 
|  | 1001 | snd_pcm_sgbuf_get_ptr(struct snd_pcm_substream *substream, unsigned int ofs) | 
|  | 1002 | { | 
|  | 1003 | return substream->runtime->dma_area + ofs; | 
|  | 1004 | } | 
|  | 1005 |  | 
|  | 1006 | #define snd_pcm_sgbuf_ops_page	NULL | 
|  | 1007 |  | 
|  | 1008 | #define snd_pcm_sgbuf_get_chunk_size(subs, ofs, size)	(size) | 
|  | 1009 |  | 
|  | 1010 | #endif /* SND_DMA_SGBUF */ | 
|  | 1011 |  | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 1012 | /* handle mmap counter - PCM mmap callback should handle this counter properly */ | 
|  | 1013 | static inline void snd_pcm_mmap_data_open(struct vm_area_struct *area) | 
|  | 1014 | { | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 1015 | struct snd_pcm_substream *substream = (struct snd_pcm_substream *)area->vm_private_data; | 
| Takashi Iwai | 9c323fc | 2006-04-28 15:13:41 +0200 | [diff] [blame] | 1016 | atomic_inc(&substream->mmap_count); | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 1017 | } | 
|  | 1018 |  | 
|  | 1019 | static inline void snd_pcm_mmap_data_close(struct vm_area_struct *area) | 
|  | 1020 | { | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 1021 | struct snd_pcm_substream *substream = (struct snd_pcm_substream *)area->vm_private_data; | 
| Takashi Iwai | 9c323fc | 2006-04-28 15:13:41 +0200 | [diff] [blame] | 1022 | atomic_dec(&substream->mmap_count); | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 1023 | } | 
|  | 1024 |  | 
|  | 1025 | /* mmap for io-memory area */ | 
|  | 1026 | #if defined(CONFIG_X86) || defined(CONFIG_PPC) || defined(CONFIG_ALPHA) | 
|  | 1027 | #define SNDRV_PCM_INFO_MMAP_IOMEM	SNDRV_PCM_INFO_MMAP | 
| Takashi Iwai | 877211f | 2005-11-17 13:59:38 +0100 | [diff] [blame] | 1028 | int snd_pcm_lib_mmap_iomem(struct snd_pcm_substream *substream, struct vm_area_struct *area); | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 1029 | #else | 
|  | 1030 | #define SNDRV_PCM_INFO_MMAP_IOMEM	0 | 
|  | 1031 | #define snd_pcm_lib_mmap_iomem	NULL | 
|  | 1032 | #endif | 
|  | 1033 |  | 
| Benjamin Herrenschmidt | 3674f19 | 2011-03-25 17:51:54 +1100 | [diff] [blame] | 1034 | #define snd_pcm_lib_mmap_vmalloc NULL | 
| Takashi Iwai | c32d977 | 2010-01-18 14:58:57 +0100 | [diff] [blame] | 1035 |  | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 1036 | static inline void snd_pcm_limit_isa_dma_size(int dma, size_t *max) | 
|  | 1037 | { | 
|  | 1038 | *max = dma < 4 ? 64 * 1024 : 128 * 1024; | 
|  | 1039 | } | 
|  | 1040 |  | 
|  | 1041 | /* | 
|  | 1042 | *  Misc | 
|  | 1043 | */ | 
|  | 1044 |  | 
|  | 1045 | #define SNDRV_PCM_DEFAULT_CON_SPDIF	(IEC958_AES0_CON_EMPHASIS_NONE|\ | 
|  | 1046 | (IEC958_AES1_CON_ORIGINAL<<8)|\ | 
|  | 1047 | (IEC958_AES1_CON_PCM_CODER<<8)|\ | 
|  | 1048 | (IEC958_AES3_CON_FS_48000<<24)) | 
|  | 1049 |  | 
| Takashi Iwai | 7eaa943 | 2008-08-08 17:09:09 +0200 | [diff] [blame] | 1050 | #define PCM_RUNTIME_CHECK(sub) snd_BUG_ON(!(sub) || !(sub)->runtime) | 
|  | 1051 |  | 
| Takashi Iwai | 6e5265e | 2009-09-08 14:26:51 +0200 | [diff] [blame] | 1052 | const char *snd_pcm_format_name(snd_pcm_format_t format); | 
|  | 1053 |  | 
| Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 1054 | #endif /* __SOUND_PCM_H */ |