1 # SPDX-License-Identifier: GPL-2.0-only 1 # SPDX-License-Identifier: GPL-2.0-only
2 # ALSA soundcard-configuration 2 # ALSA soundcard-configuration
3 config SND_TIMER 3 config SND_TIMER
4 tristate 4 tristate
5 5
6 config SND_PCM 6 config SND_PCM
7 tristate 7 tristate
8 select SND_TIMER if SND_PCM_TIMER 8 select SND_TIMER if SND_PCM_TIMER
9 9
10 config SND_PCM_ELD 10 config SND_PCM_ELD
11 bool 11 bool
12 12
13 config SND_PCM_IEC958 13 config SND_PCM_IEC958
14 bool 14 bool
15 15
16 config SND_DMAENGINE_PCM 16 config SND_DMAENGINE_PCM
17 tristate 17 tristate
18 18
19 config SND_HWDEP 19 config SND_HWDEP
20 tristate 20 tristate
21 21
22 config SND_SEQ_DEVICE 22 config SND_SEQ_DEVICE
23 tristate 23 tristate
24 24
25 config SND_RAWMIDI 25 config SND_RAWMIDI
26 tristate 26 tristate
27 select SND_SEQ_DEVICE if SND_SEQUENCER 27 select SND_SEQ_DEVICE if SND_SEQUENCER != n
28 28
29 config SND_UMP 29 config SND_UMP
30 tristate 30 tristate
31 select SND_RAWMIDI 31 select SND_RAWMIDI
32 32
33 config SND_UMP_LEGACY_RAWMIDI 33 config SND_UMP_LEGACY_RAWMIDI
34 bool "Legacy raw MIDI support for UMP 34 bool "Legacy raw MIDI support for UMP streams"
35 depends on SND_UMP 35 depends on SND_UMP
36 help 36 help
37 This option enables the legacy raw M 37 This option enables the legacy raw MIDI support for UMP streams.
38 When this option is set, an addition 38 When this option is set, an additional rawmidi device for the
39 legacy MIDI 1.0 byte streams is crea 39 legacy MIDI 1.0 byte streams is created for each UMP Endpoint.
40 The device contains 16 substreams co 40 The device contains 16 substreams corresponding to UMP groups.
41 41
42 config SND_CORE_TEST 42 config SND_CORE_TEST
43 tristate "Sound core KUnit test" 43 tristate "Sound core KUnit test"
44 depends on KUNIT 44 depends on KUNIT
45 select SND_PCM 45 select SND_PCM
46 default KUNIT_ALL_TESTS 46 default KUNIT_ALL_TESTS
47 help 47 help
48 This options enables the sound core 48 This options enables the sound core functions KUnit test.
49 49
50 KUnit tests run during boot and outp 50 KUnit tests run during boot and output the results to the debug
51 log in TAP format (https://testanyth 51 log in TAP format (https://testanything.org/). Only useful for
52 kernel devs running KUnit test harne 52 kernel devs running KUnit test harness and are not for inclusion
53 into a production build. 53 into a production build.
54 54
55 For more information on KUnit and un 55 For more information on KUnit and unit tests in general, refer
56 to the KUnit documentation in Docume 56 to the KUnit documentation in Documentation/dev-tools/kunit/.
57 57
58 58
59 config SND_COMPRESS_OFFLOAD 59 config SND_COMPRESS_OFFLOAD
60 tristate 60 tristate
61 61
62 config SND_JACK 62 config SND_JACK
63 bool 63 bool
64 64
65 # enable input device support in jack layer 65 # enable input device support in jack layer
66 config SND_JACK_INPUT_DEV 66 config SND_JACK_INPUT_DEV
67 bool 67 bool
68 depends on SND_JACK 68 depends on SND_JACK
69 default y if INPUT=y || INPUT=SND 69 default y if INPUT=y || INPUT=SND
70 70
71 config SND_OSSEMUL 71 config SND_OSSEMUL
72 bool "Enable OSS Emulation" 72 bool "Enable OSS Emulation"
73 select SOUND_OSS_CORE 73 select SOUND_OSS_CORE
74 help 74 help
75 This option enables the build of OSS 75 This option enables the build of OSS emulation layer.
76 76
77 config SND_MIXER_OSS 77 config SND_MIXER_OSS
78 tristate "OSS Mixer API" 78 tristate "OSS Mixer API"
79 depends on SND_OSSEMUL 79 depends on SND_OSSEMUL
80 help 80 help
81 To enable OSS mixer API emulation (/ 81 To enable OSS mixer API emulation (/dev/mixer*), say Y here
82 and read <file:Documentation/sound/d 82 and read <file:Documentation/sound/designs/oss-emulation.rst>.
83 83
84 Many programs still use the OSS API, 84 Many programs still use the OSS API, so say Y.
85 85
86 To compile this driver as a module, 86 To compile this driver as a module, choose M here: the module
87 will be called snd-mixer-oss. 87 will be called snd-mixer-oss.
88 88
89 config SND_PCM_OSS 89 config SND_PCM_OSS
90 tristate "OSS PCM (digital audio) API" 90 tristate "OSS PCM (digital audio) API"
91 depends on SND_OSSEMUL 91 depends on SND_OSSEMUL
92 select SND_PCM 92 select SND_PCM
93 help 93 help
94 To enable OSS digital audio (PCM) em 94 To enable OSS digital audio (PCM) emulation (/dev/dsp*), say Y
95 here and read <file:Documentation/so 95 here and read <file:Documentation/sound/designs/oss-emulation.rst>.
96 96
97 Many programs still use the OSS API, 97 Many programs still use the OSS API, so say Y.
98 98
99 To compile this driver as a module, 99 To compile this driver as a module, choose M here: the module
100 will be called snd-pcm-oss. 100 will be called snd-pcm-oss.
101 101
102 config SND_PCM_OSS_PLUGINS 102 config SND_PCM_OSS_PLUGINS
103 bool "OSS PCM (digital audio) API - In 103 bool "OSS PCM (digital audio) API - Include plugin system"
104 depends on SND_PCM_OSS 104 depends on SND_PCM_OSS
105 default y 105 default y
106 help 106 help
107 If you disable this option, the ALSA 107 If you disable this option, the ALSA's OSS PCM API will not
108 support conversion of channels, form 108 support conversion of channels, formats and rates. It will
109 behave like most of new OSS/Free dri 109 behave like most of new OSS/Free drivers in 2.4/2.6 kernels.
110 110
111 config SND_PCM_TIMER 111 config SND_PCM_TIMER
112 bool "PCM timer interface" if EXPERT 112 bool "PCM timer interface" if EXPERT
113 default y 113 default y
114 help 114 help
115 If you disable this option, pcm time 115 If you disable this option, pcm timer will be unavailable, so
116 those stubs that use pcm timer (e.g. 116 those stubs that use pcm timer (e.g. dmix, dsnoop & co) may work
117 incorrectly. 117 incorrectly.
118 118
119 For some embedded devices, we may di 119 For some embedded devices, we may disable it to reduce memory
120 footprint, about 20KB on x86_64 plat 120 footprint, about 20KB on x86_64 platform.
121 121
122 config SND_HRTIMER 122 config SND_HRTIMER
123 tristate "HR-timer backend support" 123 tristate "HR-timer backend support"
124 depends on HIGH_RES_TIMERS 124 depends on HIGH_RES_TIMERS
125 select SND_TIMER 125 select SND_TIMER
126 help 126 help
127 Say Y here to enable HR-timer backen 127 Say Y here to enable HR-timer backend for ALSA timer. ALSA uses
128 the hrtimer as a precise timing sour 128 the hrtimer as a precise timing source. The ALSA sequencer code
129 also can use this timing source. 129 also can use this timing source.
130 130
131 To compile this driver as a module, 131 To compile this driver as a module, choose M here: the module
132 will be called snd-hrtimer. 132 will be called snd-hrtimer.
133 133
134 config SND_DYNAMIC_MINORS 134 config SND_DYNAMIC_MINORS
135 bool "Dynamic device file minor number 135 bool "Dynamic device file minor numbers"
136 help 136 help
137 If you say Y here, the minor numbers 137 If you say Y here, the minor numbers of ALSA device files in
138 /dev/snd/ are allocated dynamically. 138 /dev/snd/ are allocated dynamically. This allows you to have
139 more than 8 sound cards, but require 139 more than 8 sound cards, but requires a dynamic device file
140 system like udev. 140 system like udev.
141 141
142 If you are unsure about this, say N 142 If you are unsure about this, say N here.
143 143
144 config SND_MAX_CARDS 144 config SND_MAX_CARDS
145 int "Max number of sound cards" 145 int "Max number of sound cards"
146 range 4 256 146 range 4 256
147 default 32 147 default 32
148 depends on SND_DYNAMIC_MINORS 148 depends on SND_DYNAMIC_MINORS
149 help 149 help
150 Specify the max number of sound card 150 Specify the max number of sound cards that can be assigned
151 on a single machine. 151 on a single machine.
152 152
153 config SND_SUPPORT_OLD_API 153 config SND_SUPPORT_OLD_API
154 bool "Support old ALSA API" 154 bool "Support old ALSA API"
155 default y 155 default y
156 help 156 help
157 Say Y here to support the obsolete A 157 Say Y here to support the obsolete ALSA PCM API (ver.0.9.0 rc3
158 or older). 158 or older).
159 159
160 config SND_PROC_FS 160 config SND_PROC_FS
161 bool "Sound Proc FS Support" if EXPERT 161 bool "Sound Proc FS Support" if EXPERT
162 depends on PROC_FS 162 depends on PROC_FS
163 default y 163 default y
164 help 164 help
165 Say 'N' to disable Sound proc FS, wh 165 Say 'N' to disable Sound proc FS, which may reduce code size about
166 9KB on x86_64 platform. 166 9KB on x86_64 platform.
167 If unsure say Y. 167 If unsure say Y.
168 168
169 config SND_VERBOSE_PROCFS 169 config SND_VERBOSE_PROCFS
170 bool "Verbose procfs contents" 170 bool "Verbose procfs contents"
171 depends on SND_PROC_FS 171 depends on SND_PROC_FS
172 default y 172 default y
173 help 173 help
174 Say Y here to include code for verbo 174 Say Y here to include code for verbose procfs contents (provides
175 useful information to developers whe 175 useful information to developers when a problem occurs). On the
176 other side, it makes the ALSA subsys 176 other side, it makes the ALSA subsystem larger.
177 177
>> 178 config SND_VERBOSE_PRINTK
>> 179 bool "Verbose printk"
>> 180 help
>> 181 Say Y here to enable verbose log messages. These messages
>> 182 will help to identify source file and position containing
>> 183 printed messages.
>> 184
>> 185 You don't need this unless you're debugging ALSA.
>> 186
178 config SND_CTL_FAST_LOOKUP 187 config SND_CTL_FAST_LOOKUP
179 bool "Fast lookup of control elements" 188 bool "Fast lookup of control elements" if EXPERT
180 default y 189 default y
181 select XARRAY_MULTI 190 select XARRAY_MULTI
182 help 191 help
183 This option enables the faster looku 192 This option enables the faster lookup of control elements.
184 It will consume more memory because 193 It will consume more memory because of the additional Xarray.
185 If you want to choose the memory foo 194 If you want to choose the memory footprint over the performance
186 inevitably, turn this off. 195 inevitably, turn this off.
187 196
188 config SND_DEBUG 197 config SND_DEBUG
189 bool "Debug" 198 bool "Debug"
190 help 199 help
191 Say Y here to enable ALSA debug code 200 Say Y here to enable ALSA debug code.
192 201
193 config SND_DEBUG_VERBOSE 202 config SND_DEBUG_VERBOSE
194 bool "More verbose debug" 203 bool "More verbose debug"
195 depends on SND_DEBUG 204 depends on SND_DEBUG
196 help 205 help
197 Say Y here to enable extra-verbose d 206 Say Y here to enable extra-verbose debugging messages.
198 207
199 Let me repeat: it enables EXTRA-VERB 208 Let me repeat: it enables EXTRA-VERBOSE DEBUGGING messages.
200 So, say Y only if you are ready to b 209 So, say Y only if you are ready to be annoyed.
201 210
202 config SND_PCM_XRUN_DEBUG 211 config SND_PCM_XRUN_DEBUG
203 bool "Enable PCM ring buffer overrun/u 212 bool "Enable PCM ring buffer overrun/underrun debugging"
204 default n 213 default n
205 depends on SND_DEBUG && SND_VERBOSE_PR 214 depends on SND_DEBUG && SND_VERBOSE_PROCFS
206 help 215 help
207 Say Y to enable the PCM ring buffer 216 Say Y to enable the PCM ring buffer overrun/underrun debugging.
208 It is usually not required, but if y 217 It is usually not required, but if you have trouble with
209 sound clicking when system is loaded 218 sound clicking when system is loaded, it may help to determine
210 the process or driver which causes t 219 the process or driver which causes the scheduling gaps.
211 220
212 config SND_CTL_INPUT_VALIDATION 221 config SND_CTL_INPUT_VALIDATION
213 bool "Validate input data to control A 222 bool "Validate input data to control API"
214 help 223 help
215 Say Y to enable the additional valid 224 Say Y to enable the additional validation for the input data to
216 each control element, including the 225 each control element, including the value range checks.
217 An error is returned from ALSA core 226 An error is returned from ALSA core for invalid inputs without
218 passing to the driver. This is a ki 227 passing to the driver. This is a kind of hardening for drivers
219 that have no proper error checks, at 228 that have no proper error checks, at the cost of a slight
220 performance overhead. 229 performance overhead.
221 230
222 config SND_CTL_DEBUG 231 config SND_CTL_DEBUG
223 bool "Enable debugging feature for con 232 bool "Enable debugging feature for control API"
224 depends on SND_DEBUG 233 depends on SND_DEBUG
225 help 234 help
226 Say Y to enable the debugging featur 235 Say Y to enable the debugging feature for ALSA control API.
227 It performs the additional sanity-ch 236 It performs the additional sanity-checks for each control element
228 read access, such as whether the val 237 read access, such as whether the values returned from the driver
229 are in the proper ranges or the chec 238 are in the proper ranges or the check of the invalid access at
230 out-of-array areas. The error is pr 239 out-of-array areas. The error is printed when the driver gives
231 such unexpected values. 240 such unexpected values.
232 When you develop a driver that deals 241 When you develop a driver that deals with control elements, it's
233 strongly recommended to try this one 242 strongly recommended to try this one once and verify whether you see
234 any relevant errors or not. 243 any relevant errors or not.
235 244
236 config SND_JACK_INJECTION_DEBUG 245 config SND_JACK_INJECTION_DEBUG
237 bool "Sound jack injection interface v 246 bool "Sound jack injection interface via debugfs"
238 depends on SND_JACK && SND_DEBUG && DE 247 depends on SND_JACK && SND_DEBUG && DEBUG_FS
239 help 248 help
240 This option can be used to enable or 249 This option can be used to enable or disable sound jack
241 software injection. 250 software injection.
242 Say Y if you are debugging via jack 251 Say Y if you are debugging via jack injection interface.
243 If unsure select "N". 252 If unsure select "N".
244 <<
245 config SND_UTIMER <<
246 bool "Enable support for userspace-con <<
247 depends on SND_TIMER <<
248 help <<
249 Say Y to enable the support of users <<
250 timers are purely virtual, and they <<
251 from userspace. They could be quite <<
252 sound timing with userspace applicat <<
253 data through snd-aloop). <<
254 253
255 config SND_VMASTER 254 config SND_VMASTER
256 bool 255 bool
257 256
258 config SND_DMA_SGBUF 257 config SND_DMA_SGBUF
259 def_bool y 258 def_bool y
260 depends on X86 259 depends on X86
261 260
262 config SND_CTL_LED 261 config SND_CTL_LED
263 tristate 262 tristate
264 select NEW_LEDS if SND_CTL_LED 263 select NEW_LEDS if SND_CTL_LED
265 select LEDS_TRIGGERS if SND_CTL_LED 264 select LEDS_TRIGGERS if SND_CTL_LED
266 265
267 source "sound/core/seq/Kconfig" 266 source "sound/core/seq/Kconfig"
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.