Documentation/sound/cards/emu-mixer.rst

   1 ==================================================
   2 E-MU Digital Audio System mixer / default DSP code
   3 ==================================================
   4
   5 This document covers the E-MU 0404/1010/1212/1616/1820 PCI/PCI-e/CardBus
   6 cards.
   7
   8 These cards use regular EMU10K2 (SoundBlaster Audigy) chips, but with an
   9 alternative front-end geared towards semi-professional studio recording.
  10
  11 This document is based on audigy-mixer.rst.
  12
  13
  14 Hardware compatibility
  15 ======================
  16
  17 The EMU10K2 chips have a very short capture FIFO, which makes recording
  18 unreliable if the card's PCI bus requests are not handled with the
  19 appropriate priority.
  20 This is the case on more modern motherboards, where the PCI bus is only a
  21 secondary peripheral, rather than the actual arbiter of device access.
  22 In particular, I got recording glitches during simultaneous playback on an
  23 Intel DP55 board (memory controller in the CPU), but had success with an
  24 Intel DP45 board (memory controller in the north bridge).
  25
  26 The PCI Express variants of these cards (which have a PCI bridge on board,
  27 but are otherwise identical) may be less problematic.
  28
  29
  30 Driver capabilities
  31 ===================
  32
  33 This driver supports only 16-bit 44.1/48 kHz operation. The multi-channel
  34 device (see emu10k1-jack.rst) additionally supports 24-bit capture.
  35
  36 A patchset to enhance the driver is available from `a GitHub repository
  37 <https://github.com/ossilator/linux/tree/ossis-emu10k1>`_.
  38 Its multi-channel device supports 24-bit for both playback and capture,
  39 and also supports full 88.2/96/176.4/192 kHz operation.
  40 It is not going to be upstreamed due to a fundamental disagreement about
  41 what constitutes a good user experience.
  42
  43
  44 Digital mixer controls
  45 ======================
  46
  47 Note that the controls work as attenuators: the maximum value is the neutral
  48 position leaving the signal unchanged. Note that if the same destination is
  49 mentioned in multiple controls, the signal is accumulated and can be clipped
  50 (set to maximal or minimal value without checking for overflow).
  51
  52 Explanation of used abbreviations:
  53
  54 DAC
  55         digital to analog converter
  56 ADC
  57         analog to digital converter
  58 LFE
  59         low frequency effects (used as subwoofer signal)
  60 IEC958
  61         S/PDIF
  62 FX-bus
  63         the EMU10K2 chip has an effect bus containing 64 accumulators.
  64         Each of the synthesizer voices can feed its output to these accumulators
  65         and the DSP microcontroller can operate with the resulting sum.
  66
  67 name='Clock Source',index=0
  68 ---------------------------
  69 This control allows switching the word clock between interally generated
  70 44.1 or 48 kHz, or a number of external sources.
  71
  72 Note: the sources for the 1616 CardBus card are unclear. Please report your
  73 findings.
  74
  75 name='Clock Fallback',index=0
  76 -----------------------------
  77 This control determines the internal clock which the card switches to when
  78 the selected external clock source is/becomes invalid.
  79
  80 name='DAC1 0202 14dB PAD',index=0, etc.
  81 ---------------------------------------
  82 Output attenuation controls. Not available on 0404 cards.
  83
  84 name='ADC1 14dB PAD 0202',index=0, etc.
  85 ---------------------------------------
  86 Input attenuation controls. Not available on 0404 cards.
  87
  88 name='Optical Output Mode',index=0
  89 ----------------------------------
  90 Switches the TOSLINK output port between S/PDIF and ADAT.
  91 Not available on 0404 cards (fixed to S/PDIF).
  92
  93 name='Optical Input Mode',index=0
  94 ---------------------------------
  95 Switches the TOSLINK input port between S/PDIF and ADAT.
  96 Not available on 0404 cards (fixed to S/PDIF).
  97
  98 name='PCM Front Playback Volume',index=0
  99 ----------------------------------------
 100 This control is used to attenuate samples from left and right front PCM FX-bus
 101 accumulators. ALSA uses accumulators 8 and 9 for left and right front PCM
 102 samples for 5.1 playback. The result samples are forwarded to the DSP 0 & 1
 103 playback channels.
 104
 105 name='PCM Surround Playback Volume',index=0
 106 -------------------------------------------
 107 This control is used to attenuate samples from left and right surround PCM FX-bus
 108 accumulators. ALSA uses accumulators 2 and 3 for left and right surround PCM
 109 samples for 5.1 playback. The result samples are forwarded to the DSP 2 & 3
 110 playback channels.
 111
 112 name='PCM Side Playback Volume',index=0
 113 ---------------------------------------
 114 This control is used to attenuate samples from left and right side PCM FX-bus
 115 accumulators. ALSA uses accumulators 14 and 15 for left and right side PCM
 116 samples for 7.1 playback. The result samples are forwarded to the DSP 6 & 7
 117 playback channels.
 118
 119 name='PCM Center Playback Volume',index=0
 120 -----------------------------------------
 121 This control is used to attenuate samples from the center PCM FX-bus accumulator.
 122 ALSA uses accumulator 6 for center PCM samples for 5.1 playback. The result samples
 123 are forwarded to the DSP 4 playback channel.
 124
 125 name='PCM LFE Playback Volume',index=0
 126 --------------------------------------
 127 This control is used to attenuate samples from the LFE PCM FX-bus accumulator.
 128 ALSA uses accumulator 7 for LFE PCM samples for 5.1 playback. The result samples
 129 are forwarded to the DSP 5 playback channel.
 130
 131 name='PCM Playback Volume',index=0
 132 ----------------------------------
 133 This control is used to attenuate samples from left and right PCM FX-bus
 134 accumulators. ALSA uses accumulators 0 and 1 for left and right PCM samples for
 135 stereo playback. The result samples are forwarded to the virtual stereo mixer.
 136
 137 name='PCM Capture Volume',index=0
 138 ---------------------------------
 139 This control is used to attenuate samples from left and right PCM FX-bus
 140 accumulators. ALSA uses accumulators 0 and 1 for left and right PCM.
 141 The result is forwarded to the standard capture PCM device.
 142
 143 name='Music Playback Volume',index=0
 144 ------------------------------------
 145 This control is used to attenuate samples from left and right MIDI FX-bus
 146 accumulators. ALSA uses accumulators 4 and 5 for left and right MIDI samples.
 147 The result samples are forwarded to the virtual stereo mixer.
 148
 149 name='Music Capture Volume',index=0
 150 -----------------------------------
 151 These controls are used to attenuate samples from left and right MIDI FX-bus
 152 accumulator. ALSA uses accumulators 4 and 5 for left and right MIDI samples.
 153 The result is forwarded to the standard capture PCM device.
 154
 155 name='Front Playback Volume',index=0
 156 ------------------------------------
 157 This control is used to attenuate samples from the virtual stereo mixer.
 158 The result samples are forwarded to the DSP 0 & 1 playback channels.
 159
 160 name='Surround Playback Volume',index=0
 161 ---------------------------------------
 162 This control is used to attenuate samples from the virtual stereo mixer.
 163 The result samples are forwarded to the DSP 2 & 3 playback channels.
 164
 165 name='Side Playback Volume',index=0
 166 -----------------------------------
 167 This control is used to attenuate samples from the virtual stereo mixer.
 168 The result samples are forwarded to the DSP 6 & 7 playback channels.
 169
 170 name='Center Playback Volume',index=0
 171 -------------------------------------
 172 This control is used to attenuate samples from the virtual stereo mixer.
 173 The result samples are forwarded to the DSP 4 playback channel.
 174
 175 name='LFE Playback Volume',index=0
 176 ----------------------------------
 177 This control is used to attenuate samples from the virtual stereo mixer.
 178 The result samples are forwarded to the DSP 5 playback channel.
 179
 180 name='Tone Control - Switch',index=0
 181 ------------------------------------
 182 This control turns the tone control on or off. The samples forwarded to
 183 the DSP playback channels are affected.
 184
 185 name='Tone Control - Bass',index=0
 186 ----------------------------------
 187 This control sets the bass intensity. There is no neutral value!!
 188 When the tone control code is activated, the samples are always modified.
 189 The closest value to pure signal is 20.
 190
 191 name='Tone Control - Treble',index=0
 192 ------------------------------------
 193 This control sets the treble intensity. There is no neutral value!!
 194 When the tone control code is activated, the samples are always modified.
 195 The closest value to pure signal is 20.
 196
 197 name='Master Playback Volume',index=0
 198 -------------------------------------
 199 This control is used to attenuate samples for all DSP playback channels.
 200
 201 name='EMU Capture Volume',index=0
 202 ----------------------------------
 203 This control is used to attenuate samples from the DSP 0 & 1 capture channels.
 204 The result is forwarded to the standard capture PCM device.
 205
 206 name='DAC Left',index=0, etc.
 207 -----------------------------
 208 Select the source for the given physical audio output. These may be physical
 209 inputs, playback channels (DSP xx, specified as a decimal number), or silence.
 210
 211 name='DSP x',index=0
 212 --------------------
 213 Select the source for the given capture channel (specified as a hexadecimal
 214 digit). Same options as for the physical audio outputs.
 215
 216
 217 PCM stream related controls
 218 ===========================
 219
 220 These controls are described in audigy-mixer.rst.
 221
 222
 223 MANUALS/PATENTS
 224 ===============
 225
 226 See sb-live-mixer.rst.