Kconfig: Remove useless and sometimes wrong comments
[linux-flexiantxendom0-natty.git] / sound / oss / Kconfig
1 # 18 Apr 1998, Michael Elizabeth Chastain, <mailto:mec@shout.net>
2 # More hacking for modularisation.
3 #
4 # Prompt user for primary drivers.
5
6 config SOUND_BCM_CS4297A
7         tristate "Crystal Sound CS4297a (for Swarm)"
8         depends on SIBYTE_SWARM
9         help
10           The BCM91250A has a Crystal CS4297a on synchronous serial
11           port B (in addition to the DB-9 serial port).  Say Y or M
12           here to enable the sound chip instead of the UART.  Also
13           note that CONFIG_KGDB should not be enabled at the same
14           time, since it also attempts to use this UART port.
15
16 config SOUND_VWSND
17         tristate "SGI Visual Workstation Sound"
18         depends on X86_VISWS
19         help
20           Say Y or M if you have an SGI Visual Workstation and you want to be
21           able to use its on-board audio.  Read
22           <file:Documentation/sound/oss/vwsnd> for more info on this driver's
23           capabilities.
24
25 config SOUND_AU1550_AC97
26         tristate "Au1550/Au1200 AC97 Sound"
27         depends on SOC_AU1550 || SOC_AU1200
28
29 config SOUND_MSNDCLAS
30         tristate "Support for Turtle Beach MultiSound Classic, Tahiti, Monterey"
31         depends on (m || !STANDALONE) && ISA
32         help
33           Say M here if you have a Turtle Beach MultiSound Classic, Tahiti or
34           Monterey (not for the Pinnacle or Fiji).
35
36           See <file:Documentation/sound/oss/MultiSound> for important information
37           about this driver.  Note that it has been discontinued, but the
38           Voyetra Turtle Beach knowledge base entry for it is still available
39           at <http://www.turtlebeach.com/site/kb_ftp/790.asp>.
40
41 comment "Compiled-in MSND Classic support requires firmware during compilation."
42         depends on SOUND_PRIME && SOUND_MSNDCLAS=y
43
44 config MSNDCLAS_HAVE_BOOT
45         bool
46         depends on SOUND_MSNDCLAS=y && !STANDALONE
47         default y
48
49 config MSNDCLAS_INIT_FILE
50         string "Full pathname of MSNDINIT.BIN firmware file"
51         depends on SOUND_MSNDCLAS
52         default "/etc/sound/msndinit.bin"
53         help
54           The MultiSound cards have two firmware files which are required for
55           operation, and are not currently included. These files can be
56           obtained from Turtle Beach. See
57           <file:Documentation/sound/oss/MultiSound> for information on how to
58           obtain this.
59
60 config MSNDCLAS_PERM_FILE
61         string "Full pathname of MSNDPERM.BIN firmware file"
62         depends on SOUND_MSNDCLAS
63         default "/etc/sound/msndperm.bin"
64         help
65           The MultiSound cards have two firmware files which are required for
66           operation, and are not currently included. These files can be
67           obtained from Turtle Beach. See
68           <file:Documentation/sound/oss/MultiSound> for information on how to
69           obtain this.
70
71 config MSNDCLAS_IRQ
72         int "MSND Classic IRQ 5, 7, 9, 10, 11, 12"
73         depends on SOUND_MSNDCLAS=y
74         default "5"
75         help
76           Interrupt Request line for the MultiSound Classic and related cards.
77
78 config MSNDCLAS_MEM
79         hex "MSND Classic memory B0000, C8000, D0000, D8000, E0000, E8000"
80         depends on SOUND_MSNDCLAS=y
81         default "D0000"
82         help
83           Memory-mapped I/O base address for the MultiSound Classic and
84           related cards.
85
86 config MSNDCLAS_IO
87         hex "MSND Classic I/O 210, 220, 230, 240, 250, 260, 290, 3E0"
88         depends on SOUND_MSNDCLAS=y
89         default "290"
90         help
91           I/O port address for the MultiSound Classic and related cards.
92
93 config SOUND_MSNDPIN
94         tristate "Support for Turtle Beach MultiSound Pinnacle, Fiji"
95         depends on (m || !STANDALONE) && ISA
96         help
97           Say M here if you have a Turtle Beach MultiSound Pinnacle or Fiji.
98           See <file:Documentation/sound/oss/MultiSound> for important information
99           about this driver. Note that it has been discontinued, but the
100           Voyetra Turtle Beach knowledge base entry for it is still available
101           at <http://www.turtlebeach.com/site/kb_ftp/600.asp>.
102
103 comment "Compiled-in MSND Pinnacle support requires firmware during compilation."
104         depends on SOUND_PRIME && SOUND_MSNDPIN=y
105
106 config MSNDPIN_HAVE_BOOT
107         bool
108         depends on SOUND_MSNDPIN=y
109         default y
110
111 config MSNDPIN_INIT_FILE
112         string "Full pathname of PNDSPINI.BIN firmware file"
113         depends on SOUND_MSNDPIN
114         default "/etc/sound/pndspini.bin"
115         help
116           The MultiSound cards have two firmware files which are required
117           for operation, and are not currently included. These files can be
118           obtained from Turtle Beach. See
119           <file:Documentation/sound/oss/MultiSound> for information on how to
120           obtain this.
121
122 config MSNDPIN_PERM_FILE
123         string "Full pathname of PNDSPERM.BIN firmware file"
124         depends on SOUND_MSNDPIN
125         default "/etc/sound/pndsperm.bin"
126         help
127           The MultiSound cards have two firmware files which are required for
128           operation, and are not currently included. These files can be
129           obtained from Turtle Beach. See
130           <file:Documentation/sound/oss/MultiSound> for information on how to
131           obtain this.
132
133 config MSNDPIN_IRQ
134         int "MSND Pinnacle IRQ 5, 7, 9, 10, 11, 12"
135         depends on SOUND_MSNDPIN=y
136         default "5"
137         help
138           Interrupt request line for the primary synthesizer on MultiSound
139           Pinnacle and Fiji sound cards.
140
141 config MSNDPIN_MEM
142         hex "MSND Pinnacle memory B0000, C8000, D0000, D8000, E0000, E8000"
143         depends on SOUND_MSNDPIN=y
144         default "D0000"
145         help
146           Memory-mapped I/O base address for the primary synthesizer on
147           MultiSound Pinnacle and Fiji sound cards.
148
149 config MSNDPIN_IO
150         hex "MSND Pinnacle I/O 210, 220, 230, 240, 250, 260, 290, 3E0"
151         depends on SOUND_MSNDPIN=y
152         default "290"
153         help
154           Memory-mapped I/O base address for the primary synthesizer on
155           MultiSound Pinnacle and Fiji sound cards.
156
157 config MSNDPIN_DIGITAL
158         bool "MSND Pinnacle has S/PDIF I/O"
159         depends on SOUND_MSNDPIN=y
160         help
161           If you have the S/PDIF daughter board for the Pinnacle or Fiji,
162           answer Y here; otherwise, say N. If you have this, you will be able
163           to play and record from the S/PDIF port (digital signal). See
164           <file:Documentation/sound/oss/MultiSound> for information on how to make
165           use of this capability.
166
167 config MSNDPIN_NONPNP
168         bool "MSND Pinnacle non-PnP Mode"
169         depends on SOUND_MSNDPIN=y
170         help
171           The Pinnacle and Fiji card resources can be configured either with
172           PnP, or through a configuration port. Say Y here if your card is NOT
173           in PnP mode. For the Pinnacle, configuration in non-PnP mode allows
174           use of the IDE and joystick peripherals on the card as well; these
175           do not show up when the card is in PnP mode. Specifying zero for any
176           resource of a device will disable the device. If you are running the
177           card in PnP mode, you must say N here and use isapnptools to
178           configure the card's resources.
179
180 comment "MSND Pinnacle DSP section will be configured to above parameters."
181         depends on SOUND_MSNDPIN=y && MSNDPIN_NONPNP
182
183 config MSNDPIN_CFG
184         hex "MSND Pinnacle config port 250,260,270"
185         depends on MSNDPIN_NONPNP
186         default "250"
187         help
188           This is the port which the Pinnacle and Fiji uses to configure the
189           card's resources when not in PnP mode. If your card is in PnP mode,
190           then be sure to say N to the previous option, "MSND Pinnacle Non-PnP
191           Mode".
192
193 comment "Pinnacle-specific Device Configuration (0 disables)"
194         depends on SOUND_MSNDPIN=y && MSNDPIN_NONPNP
195
196 config MSNDPIN_MPU_IO
197         hex "MSND Pinnacle MPU I/O (e.g. 330)"
198         depends on MSNDPIN_NONPNP
199         default "0"
200         help
201           Memory-mapped I/O base address for the Kurzweil daughterboard
202           synthesizer on MultiSound Pinnacle and Fiji sound cards.
203
204 config MSNDPIN_MPU_IRQ
205         int "MSND Pinnacle MPU IRQ (e.g. 9)"
206         depends on MSNDPIN_NONPNP
207         default "0"
208         help
209           Interrupt request number for the Kurzweil daughterboard
210           synthesizer on MultiSound Pinnacle and Fiji sound cards.
211
212 config MSNDPIN_IDE_IO0
213         hex "MSND Pinnacle IDE I/O 0 (e.g. 170)"
214         depends on MSNDPIN_NONPNP
215         default "0"
216         help
217           CD-ROM drive 0 memory-mapped I/O base address for the MultiSound
218           Pinnacle and Fiji sound cards.
219
220 config MSNDPIN_IDE_IO1
221         hex "MSND Pinnacle IDE I/O 1 (e.g. 376)"
222         depends on MSNDPIN_NONPNP
223         default "0"
224         help
225           CD-ROM drive 1 memory-mapped I/O base address for the MultiSound
226           Pinnacle and Fiji sound cards.
227
228 config MSNDPIN_IDE_IRQ
229         int "MSND Pinnacle IDE IRQ (e.g. 15)"
230         depends on MSNDPIN_NONPNP
231         default "0"
232         help
233           Interrupt request number for the IDE CD-ROM interface on the
234           MultiSound Pinnacle and Fiji sound cards.
235
236 config MSNDPIN_JOYSTICK_IO
237         hex "MSND Pinnacle joystick I/O (e.g. 200)"
238         depends on MSNDPIN_NONPNP
239         default "0"
240         help
241           Memory-mapped I/O base address for the joystick port on MultiSound
242           Pinnacle and Fiji sound cards.
243
244 config MSND_FIFOSIZE
245         int "MSND buffer size (kB)"
246         depends on SOUND_MSNDPIN=y || SOUND_MSNDCLAS=y
247         default "128"
248         help
249           Configures the size of each audio buffer, in kilobytes, for
250           recording and playing in the MultiSound drivers (both the Classic
251           and Pinnacle). Larger values reduce the chance of data overruns at
252           the expense of overall latency. If unsure, use the default.
253
254 menuconfig SOUND_OSS
255         tristate "OSS sound modules"
256         depends on ISA_DMA_API && VIRT_TO_BUS
257         help
258           OSS is the Open Sound System suite of sound card drivers.  They make
259           sound programming easier since they provide a common API.  Say Y or
260           M here (the module will be called sound) if you haven't found a
261           driver for your sound card above, then pick your driver from the
262           list below.
263
264 if SOUND_OSS
265
266 config SOUND_TRACEINIT
267         bool "Verbose initialisation"
268         help
269           Verbose soundcard initialization -- affects the format of autoprobe
270           and initialization messages at boot time.
271
272 config SOUND_DMAP
273         bool "Persistent DMA buffers"
274         ---help---
275           Linux can often have problems allocating DMA buffers for ISA sound
276           cards on machines with more than 16MB of RAM. This is because ISA
277           DMA buffers must exist below the 16MB boundary and it is quite
278           possible that a large enough free block in this region cannot be
279           found after the machine has been running for a while. If you say Y
280           here the DMA buffers (64Kb) will be allocated at boot time and kept
281           until the shutdown. This option is only useful if you said Y to
282           "OSS sound modules", above. If you said M to "OSS sound modules"
283           then you can get the persistent DMA buffer functionality by passing
284           the command-line argument "dmabuf=1" to the sound module.
285
286           Say Y unless you have 16MB or more RAM or a PCI sound card.
287
288 config SOUND_SSCAPE
289         tristate "Ensoniq SoundScape support"
290         help
291           Answer Y if you have a sound card based on the Ensoniq SoundScape
292           chipset. Such cards are being manufactured at least by Ensoniq, Spea
293           and Reveal (Reveal makes also other cards).
294
295           If you compile the driver into the kernel, you have to add
296           "sscape=<io>,<irq>,<dma>,<mpuio>,<mpuirq>" to the kernel command
297           line.
298
299
300 config SOUND_VMIDI
301         tristate "Loopback MIDI device support"
302         help
303           Support for MIDI loopback on port 1 or 2.
304
305 config SOUND_TRIX
306         tristate "MediaTrix AudioTrix Pro support"
307         help
308           Answer Y if you have the AudioTriX Pro sound card manufactured
309           by MediaTrix.
310
311 config TRIX_HAVE_BOOT
312         bool "Have TRXPRO.HEX firmware file"
313         depends on SOUND_TRIX=y && !STANDALONE
314         help
315           The MediaTrix AudioTrix Pro has an on-board microcontroller which
316           needs to be initialized by downloading the code from the file
317           TRXPRO.HEX in the DOS driver directory. If you don't have the
318           TRXPRO.HEX file handy you may skip this step. However, the SB and
319           MPU-401 modes of AudioTrix Pro will not work without this file!
320
321 config TRIX_BOOT_FILE
322         string "Full pathname of TRXPRO.HEX firmware file"
323         depends on TRIX_HAVE_BOOT
324         default "/etc/sound/trxpro.hex"
325         help
326           Enter the full pathname of your TRXPRO.HEX file, starting from /.
327
328 config SOUND_MSS
329         tristate "Microsoft Sound System support"
330         ---help---
331           Again think carefully before answering Y to this question.  It's
332           safe to answer Y if you have the original Windows Sound System card
333           made by Microsoft or Aztech SG 16 Pro (or NX16 Pro).  Also you may
334           say Y in case your card is NOT among these:
335
336           ATI Stereo F/X, AdLib, Audio Excell DSP16, Cardinal DSP16,
337           Ensoniq SoundScape (and compatibles made by Reveal and Spea),
338           Gravis Ultrasound, Gravis Ultrasound ACE, Gravis Ultrasound Max,
339           Gravis Ultrasound with 16 bit option, Logitech Sound Man 16,
340           Logitech SoundMan Games, Logitech SoundMan Wave, MAD16 Pro (OPTi
341           82C929), Media Vision Jazz16, MediaTriX AudioTriX Pro, Microsoft
342           Windows Sound System (MSS/WSS), Mozart (OAK OTI-601), Orchid
343           SW32, Personal Sound System (PSS), Pro Audio Spectrum 16, Pro
344           Audio Studio 16, Pro Sonic 16, Roland MPU-401 MIDI interface,
345           Sound Blaster 1.0, Sound Blaster 16, Sound Blaster 16ASP, Sound
346           Blaster 2.0, Sound Blaster AWE32, Sound Blaster Pro, TI TM4000M
347           notebook, ThunderBoard, Turtle Beach Tropez, Yamaha FM
348           synthesizers (OPL2, OPL3 and OPL4), 6850 UART MIDI Interface.
349
350           For cards having native support in VoxWare, consult the card
351           specific instructions in <file:Documentation/sound/oss/README.OSS>.
352           Some drivers have their own MSS support and saying Y to this option
353           will cause a conflict.
354
355           If you compile the driver into the kernel, you have to add
356           "ad1848=<io>,<irq>,<dma>,<dma2>[,<type>]" to the kernel command
357           line.
358
359 config SOUND_MPU401
360         tristate "MPU-401 support (NOT for SB16)"
361         ---help---
362           Be careful with this question.  The MPU401 interface is supported by
363           all sound cards.  However, some natively supported cards have their
364           own driver for MPU401.  Enabling this MPU401 option with these cards
365           will cause a conflict.  Also, enabling MPU401 on a system that
366           doesn't really have a MPU401 could cause some trouble.  If your card
367           was in the list of supported cards, look at the card specific
368           instructions in the <file:Documentation/sound/oss/README.OSS> file.  It
369           is safe to answer Y if you have a true MPU401 MIDI interface card.
370
371           If you compile the driver into the kernel, you have to add
372           "mpu401=<io>,<irq>" to the kernel command line.
373
374 config SOUND_PAS
375         tristate "ProAudioSpectrum 16 support"
376         ---help---
377           Answer Y only if you have a Pro Audio Spectrum 16, ProAudio Studio
378           16 or Logitech SoundMan 16 sound card. Answer N if you have some
379           other card made by Media Vision or Logitech since those are not
380           PAS16 compatible. Please read <file:Documentation/sound/oss/PAS16>.
381           It is not necessary to add Sound Blaster support separately; it
382           is included in PAS support.
383
384           If you compile the driver into the kernel, you have to add
385           "pas2=<io>,<irq>,<dma>,<dma2>,<sbio>,<sbirq>,<sbdma>,<sbdma2>
386           to the kernel command line.
387
388 config PAS_JOYSTICK
389         bool "Enable PAS16 joystick port"
390         depends on SOUND_PAS=y
391         help
392           Say Y here to enable the Pro Audio Spectrum 16's auxiliary joystick
393           port.
394
395 config SOUND_PSS
396         tristate "PSS (AD1848, ADSP-2115, ESC614) support"
397         help
398           Answer Y or M if you have an Orchid SW32, Cardinal DSP16, Beethoven
399           ADSP-16 or some other card based on the PSS chipset (AD1848 codec +
400           ADSP-2115 DSP chip + Echo ESC614 ASIC CHIP). For more information on
401           how to compile it into the kernel or as a module see the file
402           <file:Documentation/sound/oss/PSS>.
403
404           If you compile the driver into the kernel, you have to add
405           "pss=<io>,<mssio>,<mssirq>,<mssdma>,<mpuio>,<mpuirq>" to the kernel
406           command line.
407
408 config PSS_MIXER
409         bool "Enable PSS mixer (Beethoven ADSP-16 and other compatible)"
410         depends on SOUND_PSS
411         help
412           Answer Y for Beethoven ADSP-16. You may try to say Y also for other
413           cards if they have master volume, bass, treble, and you can't
414           control it under Linux. If you answer N for Beethoven ADSP-16, you
415           can't control master volume, bass, treble and synth volume.
416
417           If you said M to "PSS support" above, you may enable or disable this
418           PSS mixer with the module parameter pss_mixer. For more information
419           see the file <file:Documentation/sound/oss/PSS>.
420
421 config PSS_HAVE_BOOT
422         bool "Have DSPxxx.LD firmware file"
423         depends on SOUND_PSS && !STANDALONE
424         help
425           If you have the DSPxxx.LD file or SYNTH.LD file for you card, say Y
426           to include this file. Without this file the synth device (OPL) may
427           not work.
428
429 config PSS_BOOT_FILE
430         string "Full pathname of DSPxxx.LD firmware file"
431         depends on PSS_HAVE_BOOT
432         default "/etc/sound/dsp001.ld"
433         help
434           Enter the full pathname of your DSPxxx.LD file or SYNTH.LD file,
435           starting from /.
436
437 config SOUND_SB
438         tristate "100% Sound Blaster compatibles (SB16/32/64, ESS, Jazz16) support"
439         ---help---
440           Answer Y if you have an original Sound Blaster card made by Creative
441           Labs or a 100% hardware compatible clone (like the Thunderboard or
442           SM Games). For an unknown card you may answer Y if the card claims
443           to be Sound Blaster-compatible.
444
445           Please read the file <file:Documentation/sound/oss/Soundblaster>.
446
447           You should also say Y here for cards based on the Avance Logic
448           ALS-007 and ALS-1X0 chips (read <file:Documentation/sound/oss/ALS>) and
449           for cards based on ESS chips (read
450           <file:Documentation/sound/oss/ESS1868> and
451           <file:Documentation/sound/oss/ESS>). If you have an SB AWE 32 or SB AWE
452           64, say Y here and also to "AWE32 synth" below and read
453           <file:Documentation/sound/oss/INSTALL.awe>. If you have an IBM Mwave
454           card, say Y here and read <file:Documentation/sound/oss/mwave>.
455
456           If you compile the driver into the kernel and don't want to use
457           isapnp, you have to add "sb=<io>,<irq>,<dma>,<dma2>" to the kernel
458           command line.
459
460           You can say M here to compile this driver as a module; the module is
461           called sb.
462
463 config SOUND_YM3812
464         tristate "Yamaha FM synthesizer (YM3812/OPL-3) support"
465         ---help---
466           Answer Y if your card has a FM chip made by Yamaha (OPL2/OPL3/OPL4).
467           Answering Y is usually a safe and recommended choice, however some
468           cards may have software (TSR) FM emulation. Enabling FM support with
469           these cards may cause trouble (I don't currently know of any such
470           cards, however). Please read the file
471           <file:Documentation/sound/oss/OPL3> if your card has an OPL3 chip.
472
473           If you compile the driver into the kernel, you have to add
474           "opl3=<io>" to the kernel command line.
475
476           If unsure, say Y.
477
478 config SOUND_UART6850
479         tristate "6850 UART support"
480         help
481           This option enables support for MIDI interfaces based on the 6850
482           UART chip. This interface is rarely found on sound cards. It's safe
483           to answer N to this question.
484
485           If you compile the driver into the kernel, you have to add
486           "uart6850=<io>,<irq>" to the kernel command line.
487
488 config SOUND_AEDSP16
489         tristate "Gallant Audio Cards (SC-6000 and SC-6600 based)"
490         ---help---
491           Answer Y if you have a Gallant's Audio Excel DSP 16 card. This
492           driver supports Audio Excel DSP 16 but not the III nor PnP versions
493           of this card.
494
495           The Gallant's Audio Excel DSP 16 card can emulate either an SBPro or
496           a Microsoft Sound System card, so you should have said Y to either
497           "100% Sound Blaster compatibles (SB16/32/64, ESS, Jazz16) support"
498           or "Microsoft Sound System support", above, and you need to answer
499           the "MSS emulation" and "SBPro emulation" questions below
500           accordingly. You should say Y to one and only one of these two
501           questions.
502
503           Read the <file:Documentation/sound/oss/README.OSS> file and the head of
504           <file:sound/oss/aedsp16.c> as well as
505           <file:Documentation/sound/oss/AudioExcelDSP16> to get more information
506           about this driver and its configuration.
507
508 config SC6600
509         bool "SC-6600 based audio cards (new Audio Excel DSP 16)"
510         depends on SOUND_AEDSP16
511         help
512           The SC6600 is the new version of DSP mounted on the Audio Excel DSP
513           16 cards. Find in the manual the FCC ID of your audio card and
514           answer Y if you have an SC6600 DSP.
515
516 config SC6600_JOY
517         bool "Activate SC-6600 Joystick Interface"
518         depends on SC6600
519         help
520           Say Y here in order to use the joystick interface of the Audio Excel
521           DSP 16 card.
522
523 config SC6600_CDROM
524         int "SC-6600 CDROM Interface (4=None, 3=IDE, 1=Panasonic, 0=?Sony?)"
525         depends on SC6600
526         default "4"
527         help
528           This is used to activate the CD-ROM interface of the Audio Excel
529           DSP 16 card. Enter: 0 for Sony, 1 for Panasonic, 2 for IDE, 4 for no
530           CD-ROM present.
531
532 config SC6600_CDROMBASE
533         hex "SC-6600 CDROM Interface I/O Address"
534         depends on SC6600
535         default "0"
536         help
537           Base I/O port address for the CD-ROM interface of the Audio Excel
538           DSP 16 card.
539
540 config SOUND_VIDC
541         tristate "VIDC 16-bit sound"
542         depends on ARM && (ARCH_ACORN || ARCH_CLPS7500)
543         help
544           16-bit support for the VIDC onboard sound hardware found on Acorn
545           machines.
546
547 config SOUND_WAVEARTIST
548         tristate "Netwinder WaveArtist"
549         depends on ARM && ARCH_NETWINDER
550         help
551           Say Y here to include support for the Rockwell WaveArtist sound
552           system.  This driver is mainly for the NetWinder.
553
554 config SOUND_KAHLUA
555         tristate "XpressAudio Sound Blaster emulation"
556         depends on SOUND_SB
557
558 endif   # SOUND_OSS
559
560 config SOUND_SH_DAC_AUDIO
561         tristate "SuperH DAC audio support"
562         depends on CPU_SH3 && HIGH_RES_TIMERS
563
564 config SOUND_SH_DAC_AUDIO_CHANNEL
565         int "DAC channel"
566         default "1"
567         depends on SOUND_SH_DAC_AUDIO