2 .\" Copyright (c) 2003,2006 Yuriy Tsibizov,
3 .\" All rights reserved.
5 .\" Redistribution and use in source and binary forms, with or without
6 .\" modification, are permitted provided that the following conditions
8 .\" 1. Redistributions of source code must retain the above copyright
9 .\" notice, this list of conditions and the following disclaimer.
10 .\" 2. Redistributions in binary form must reproduce the above copyright
11 .\" notice, this list of conditions and the following disclaimer in the
12 .\" documentation and/or other materials provided with the distribution.
14 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
15 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17 .\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
18 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
26 .\" $Id: snd_emu10kx.4,v 1.19 2006/06/07 11:18:57 chibis Exp $
34 .Nd Creative SoundBlaster Live! and Audigy sound cards device driver
36 To compile this driver into the kernel, place the following lines in your
37 kernel configuration file:
38 .Bd -ragged -offset indent
40 .Cd "device snd_emu10kx"
42 For additional options:
43 .Cd "options EMU10KX_MULTICHANNEL"
44 .Cd "options EMU10KX_DEBUG"
47 Alternatively, to load the driver as a module at boot time, place the
50 .Bd -literal -offset indent
51 snd_emu10kx_load="YES"
56 bridge driver allows the generic audio driver
58 to attach to the Creative sound cards based on EMU10K1, CA0100, CA0101, CA0102
62 sound cards have a PCM part, which is accessible through one to five
65 .Sx MULTICHANNEL PLAYBACK
66 for details), and MPU401-compatible MIDI I/O controller, which is accessible
67 through the midi device.
68 Wave table synthesizer is not supported.
72 driver supports the following sound cards:
76 Creative Sound Blaster Live!\& (EMU10K1 Chipset).
77 Both PCM and MIDI interfaces are available.
79 Creative Sound Blaster Audigy (CA0100 and CA0101 Chipset).
80 PCM and two MIDI interfaces available.
82 Creative Sound Blaster Audigy 2 and Creative Sound Blaster Audigy 4 (CA0102
84 PCM support is limited to 48kHz/16 bit stereo (192kHz/24 bit part
85 of this chipset is not supported).
87 Creative Sound Blaster Audigy 2 Value (CA0108 Chipset).
88 PCM support is limited
89 to 48kHz/16 bit stereo (192kHz/24 bit part of this chipset is not supported).\&
90 There is no MIDI support for this card.
97 support the following sound cards (although they are named
98 similar to some supported ones):
102 Creative Sound Blaster Live!\& 24-Bit, identified by FreeBSD as
103 .Li Qq emu10k1x Soundblaster Live! 5.1 .
105 Creative Sound Blaster Audigy LS / ES, identified by FreeBSD as
106 .Li Qq CA0106-DAT Audigy LS .
108 All other cards with -DAT chipsets.
110 .Sh MULTICHANNEL PLAYBACK
112 It is possible to build this driver with multichannel playback capabilites.
114 .Dq Dv EMU10KX_MULTICHANNEL
115 option in your kernel configuration (or
116 build it as a module) you will get up to five DSP devices, one for each sound
120 output can play and record sound from external
121 sources (like line or S/PDIF inputs).
122 .Sh OSS MIXER CONTROLS
124 These are controls available through the standard OSS programming interface.
129 On EMU10K1-based cards the OSS mixer directly controls the AC97 codec on card.
130 On newer cards the OSS mixer controls some parameters of the AC97 codec and
131 some DSP-based mixer controls.
133 "vol" mixer control is overall sound volume.
135 "pcm" mixer control is PCM playback volume.
136 It controls only front output
137 volume in multichannel mode and all output volume in single chennel mode.
139 "rec" mixer control acts very different on EMU10K1 and other cards.
140 On EMU10K1 cards it controls the AC97 codec recording level.
142 it controls the amount of AC97 "stereo mix" entering the DSP.
143 AC97 recording level and AC97 recording source are fixed
144 on CA0100, CA0101, CA0102 and CA0108 cards.
145 AC97 recording level are always set to
146 maximum and recording source is always "stereo mix".
148 Other OSS mixer controls do not work.
149 .Sh PRIVATE DEVICE CONTROLS
151 You can control most of EMU10Kx operation and configuration parameters through
152 dev.emu10kx.X sysctls.
155 values are temporary and should not be relied
157 .Sh DRIVER CONFIGURATION
158 .Ss Kernel Configuration Options
159 The following kernel configuration options control the
162 .Bl -tag -width EMU10KX_MULTICHANNEL
163 .It Em EMU10KX_MULTICHANNEL
165 .Sx MULTICHANNEL PLAYBACK
166 for all instances of the
170 This option enables additional debug messages.
174 .Bl -tag -width /dev/emu10kx? -compact
176 emu10kx management interface
183 device driver first appeared in
186 The PCM part of the driver is based on the
188 SB Live! driver by Cameron Grant.
189 The MIDI interface is based on the
191 MIDI interface code by Mathew Kanner.
194 device driver and this manual page were written by
197 8kHz/8bit/mono recording does not work.
198 8kHz recording was removed from the driver capabilites.
200 The Driver does not detect lost S/PDIF signal and produces noise when S/PDIF
201 is not connected and S/PDIF volume is not zero.
203 The PCM driver cannot detect the presence of Live!Drive or AudigyDrive
205 and tries to use them (and list their connectors in the mixer).
207 The MIDI driver cannot detect the presence of Live!Drive or AudigyDrive
208 breakout boxes and tries to enable the IR receiver on them anyway.