Documentation/sound/alsa/Audigy-mixer.txt

   1
   2                 Sound Blaster Audigy mixer / default DSP code
   3                 ===========================================
   4
   5 This is based on SB-Live-mixer.txt.
   6
   7 The EMU10K2 chips have a DSP part which can be programmed to support
   8 various ways of sample processing, which is described here.
   9 (This article does not deal with the overall functionality of the
  10 EMU10K2 chips. See the manuals section for further details.)
  11
  12 The ALSA driver programs this portion of chip by default code
  13 (can be altered later) which offers the following functionality:
  14
  15
  16 1) Digital mixer controls
  17 -------------------------
  18
  19 These controls are built using the DSP instructions. They offer extended
  20 functionality. Only the default build-in code in the ALSA driver is described
  21 here. Note that the controls work as attenuators: the maximum value is the
  22 neutral position leaving the signal unchanged. Note that if the  same destination
  23 is mentioned in multiple controls, the signal is accumulated and can be wrapped
  24 (set to maximal or minimal value without checking of overflow).
  25
  26
  27 Explanation of used abbreviations:
  28
  29 DAC    - digital to analog converter
  30 ADC    - analog to digital converter
  31 I2S    - one-way three wire serial bus for digital sound by Philips Semiconductors
  32          (this standard is used for connecting standalone DAC and ADC converters)
  33 LFE    - low frequency effects (subwoofer signal)
  34 AC97   - a chip containing an analog mixer, DAC and ADC converters
  35 IEC958 - S/PDIF
  36 FX-bus - the EMU10K2 chip has an effect bus containing 64 accumulators.
  37          Each of the synthesizer voices can feed its output to these accumulators
  38          and the DSP microcontroller can operate with the resulting sum.
  39
  40 name='PCM Front Playback Volume',index=0
  41
  42 This control is used to attenuate samples for left and right front PCM FX-bus
  43 accumulators. ALSA uses accumulators 8 and 9 for left and right front PCM
  44 samples for 5.1 playback. The result samples are forwarded to the front DAC PCM
  45 slots of the Philips DAC.
  46
  47 name='PCM Surround Playback Volume',index=0
  48
  49 This control is used to attenuate samples for left and right surround PCM FX-bus
  50 accumulators. ALSA uses accumulators 2 and 3 for left and right surround PCM
  51 samples for 5.1 playback. The result samples are forwarded to the surround DAC PCM
  52 slots of the Philips DAC.
  53
  54 name='PCM Center Playback Volume',index=0
  55
  56 This control is used to attenuate samples for center PCM FX-bus accumulator.
  57 ALSA uses accumulator 6 for center PCM sample for 5.1 playback. The result sample
  58 is forwarded to the center DAC PCM slot of the Philips DAC.
  59
  60 name='PCM LFE Playback Volume',index=0
  61
  62 This control is used to attenuate sample for LFE PCM FX-bus accumulator.
  63 ALSA uses accumulator 7 for LFE PCM sample for 5.1 playback. The result sample
  64 is forwarded to the LFE DAC PCM slot of the Philips DAC.
  65
  66 name='PCM Playback Volume',index=0
  67
  68 This control is used to attenuate samples for left and right PCM FX-bus
  69 accumulators. ALSA uses accumulators 0 and 1 for left and right PCM samples for
  70 stereo playback. The result samples are forwarded to the front DAC PCM slots
  71 of the Philips DAC.
  72
  73 name='PCM Capture Volume',index=0
  74
  75 This control is used to attenuate samples for left and right PCM FX-bus
  76 accumulator. ALSA uses accumulators 0 and 1 for left and right PCM.
  77 The result is forwarded to the ADC capture FIFO (thus to the standard capture
  78 PCM device).
  79
  80 name='Music Playback Volume',index=0
  81
  82 This control is used to attenuate samples for left and right MIDI FX-bus
  83 accumulators. ALSA uses accumulators 4 and 5 for left and right MIDI samples.
  84 The result samples are forwarded to the front DAC PCM slots of the AC97 codec.
  85
  86 name='Music Capture Volume',index=0
  87
  88 These controls are used to attenuate samples for left and right MIDI FX-bus
  89 accumulator. ALSA uses accumulators 4 and 5 for left and right PCM.
  90 The result is forwarded to the ADC capture FIFO (thus to the standard capture
  91 PCM device).
  92
  93 name='Mic Playback Volume',index=0
  94
  95 This control is used to attenuate samples for left and right Mic input.
  96 For Mic input is used AC97 codec. The result samples are forwarded to
  97 the front DAC PCM slots of the Philips DAC. Samples are forwarded to Mic
  98 capture FIFO (device 1 - 16bit/8KHz mono) too without volume control.
  99
 100 name='Mic Capture Volume',index=0
 101
 102 This control is used to attenuate samples for left and right Mic input.
 103 The result is forwarded to the ADC capture FIFO (thus to the standard capture
 104 PCM device).
 105
 106 name='Audigy CD Playback Volume',index=0
 107
 108 This control is used to attenuate samples from left and right IEC958 TTL
 109 digital inputs (usually used by a CDROM drive). The result samples are
 110 forwarded to the front DAC PCM slots of the Philips DAC.
 111
 112 name='Audigy CD Capture Volume',index=0
 113
 114 This control is used to attenuate samples from left and right IEC958 TTL
 115 digital inputs (usually used by a CDROM drive). The result samples are
 116 forwarded to the ADC capture FIFO (thus to the standard capture PCM device).
 117
 118 name='IEC958 Optical Playback Volume',index=0
 119
 120 This control is used to attenuate samples from left and right IEC958 optical
 121 digital input. The result samples are forwarded to the front DAC PCM slots
 122 of the Philips DAC.
 123
 124 name='IEC958 Optical Capture Volume',index=0
 125
 126 This control is used to attenuate samples from left and right IEC958 optical
 127 digital inputs. The result samples are forwarded to the ADC capture FIFO
 128 (thus to the standard capture PCM device).
 129
 130 name='Line2 Playback Volume',index=0
 131
 132 This control is used to attenuate samples from left and right I2S ADC
 133 inputs (on the AudigyDrive). The result samples are forwarded to the front
 134 DAC PCM slots of the Philips DAC.
 135
 136 name='Line2 Capture Volume',index=1
 137
 138 This control is used to attenuate samples from left and right I2S ADC
 139 inputs (on the AudigyDrive). The result samples are forwarded to the ADC
 140 capture FIFO (thus to the standard capture PCM device).
 141
 142 name='Analog Mix Playback Volume',index=0
 143
 144 This control is used to attenuate samples from left and right I2S ADC
 145 inputs from Philips ADC. The result samples are forwarded to the front
 146 DAC PCM slots of the Philips DAC. This contains mix from analog sources
 147 like CD, Line In, Aux, ....
 148
 149 name='Analog Mix Capture Volume',index=1
 150
 151 This control is used to attenuate samples from left and right I2S ADC
 152 inputs Philips ADC. The result samples are forwarded to the ADC
 153 capture FIFO (thus to the standard capture PCM device).
 154
 155 name='Aux2 Playback Volume',index=0
 156
 157 This control is used to attenuate samples from left and right I2S ADC
 158 inputs (on the AudigyDrive). The result samples are forwarded to the front
 159 DAC PCM slots of the Philips DAC.
 160
 161 name='Aux2 Capture Volume',index=1
 162
 163 This control is used to attenuate samples from left and right I2S ADC
 164 inputs (on the AudigyDrive). The result samples are forwarded to the ADC
 165 capture FIFO (thus to the standard capture PCM device).
 166
 167 name='Front Playback Volume',index=0
 168
 169 All stereo signals are mixed together and mirrored to surround, center and LFE.
 170 This control is used to attenuate samples for left and right front speakers of
 171 this mix.
 172
 173 name='Surround Playback Volume',index=0
 174
 175 All stereo signals are mixed together and mirrored to surround, center and LFE.
 176 This control is used to attenuate samples for left and right surround speakers of
 177 this mix.
 178
 179 name='Center Playback Volume',index=0
 180
 181 All stereo signals are mixed together and mirrored to surround, center and LFE.
 182 This control is used to attenuate sample for center speaker of this mix.
 183
 184 name='LFE Playback Volume',index=0
 185
 186 All stereo signals are mixed together and mirrored to surround, center and LFE.
 187 This control is used to attenuate sample for LFE speaker of this mix.
 188
 189 name='Tone Control - Switch',index=0
 190
 191 This control turns the tone control on or off. The samples for front, rear
 192 and center / LFE outputs are affected.
 193
 194 name='Tone Control - Bass',index=0
 195
 196 This control sets the bass intensity. There is no neutral value!!
 197 When the tone control code is activated, the samples are always modified.
 198 The closest value to pure signal is 20.
 199
 200 name='Tone Control - Treble',index=0
 201
 202 This control sets the treble intensity. There is no neutral value!!
 203 When the tone control code is activated, the samples are always modified.
 204 The closest value to pure signal is 20.
 205
 206 name='Master Playback Volume',index=0
 207
 208 This control is used to attenuate samples for front, surround, center and
 209 LFE outputs.
 210
 211 name='IEC958 Optical Raw Playback Switch',index=0
 212
 213 If this switch is on, then the samples for the IEC958 (S/PDIF) digital
 214 output are taken only from the raw FX8010 PCM, otherwise standard front
 215 PCM samples are taken.
 216
 217
 218 2) PCM stream related controls
 219 ------------------------------
 220
 221 name='EMU10K1 PCM Volume',index 0-31
 222
 223 Channel volume attenuation in range 0-0xffff. The maximum value (no
 224 attenuation) is default. The channel mapping for three values is
 225 as follows:
 226
 227         0 - mono, default 0xffff (no attenuation)
 228         1 - left, default 0xffff (no attenuation)
 229         2 - right, default 0xffff (no attenuation)
 230
 231 name='EMU10K1 PCM Send Routing',index 0-31
 232
 233 This control specifies the destination - FX-bus accumulators. There 24
 234 values with this mapping:
 235
 236          0 -  mono, A destination (FX-bus 0-63), default 0
 237          1 -  mono, B destination (FX-bus 0-63), default 1
 238          2 -  mono, C destination (FX-bus 0-63), default 2
 239          3 -  mono, D destination (FX-bus 0-63), default 3
 240          4 -  mono, E destination (FX-bus 0-63), default 0
 241          5 -  mono, F destination (FX-bus 0-63), default 0
 242          6 -  mono, G destination (FX-bus 0-63), default 0
 243          7 -  mono, H destination (FX-bus 0-63), default 0
 244          8 -  left, A destination (FX-bus 0-63), default 0
 245          9 -  left, B destination (FX-bus 0-63), default 1
 246         10 -  left, C destination (FX-bus 0-63), default 2
 247         11 -  left, D destination (FX-bus 0-63), default 3
 248         12 -  left, E destination (FX-bus 0-63), default 0
 249         13 -  left, F destination (FX-bus 0-63), default 0
 250         14 -  left, G destination (FX-bus 0-63), default 0
 251         15 -  left, H destination (FX-bus 0-63), default 0
 252         16 - right, A destination (FX-bus 0-63), default 0
 253         17 - right, B destination (FX-bus 0-63), default 1
 254         18 - right, C destination (FX-bus 0-63), default 2
 255         19 - right, D destination (FX-bus 0-63), default 3
 256         20 - right, E destination (FX-bus 0-63), default 0
 257         21 - right, F destination (FX-bus 0-63), default 0
 258         22 - right, G destination (FX-bus 0-63), default 0
 259         23 - right, H destination (FX-bus 0-63), default 0
 260
 261 Don't forget that it's illegal to assign a channel to the same FX-bus accumulator
 262 more than once (it means 0=0 && 1=0 is an invalid combination).
 263
 264 name='EMU10K1 PCM Send Volume',index 0-31
 265
 266 It specifies the attenuation (amount) for given destination in range 0-255.
 267 The channel mapping is following:
 268
 269          0 -  mono, A destination attn, default 255 (no attenuation)
 270          1 -  mono, B destination attn, default 255 (no attenuation)
 271          2 -  mono, C destination attn, default 0 (mute)
 272          3 -  mono, D destination attn, default 0 (mute)
 273          4 -  mono, E destination attn, default 0 (mute)
 274          5 -  mono, F destination attn, default 0 (mute)
 275          6 -  mono, G destination attn, default 0 (mute)
 276          7 -  mono, H destination attn, default 0 (mute)
 277          8 -  left, A destination attn, default 255 (no attenuation)
 278          9 -  left, B destination attn, default 0 (mute)
 279         10 -  left, C destination attn, default 0 (mute)
 280         11 -  left, D destination attn, default 0 (mute)
 281         12 -  left, E destination attn, default 0 (mute)
 282         13 -  left, F destination attn, default 0 (mute)
 283         14 -  left, G destination attn, default 0 (mute)
 284         15 -  left, H destination attn, default 0 (mute)
 285         16 - right, A destination attn, default 0 (mute)
 286         17 - right, B destination attn, default 255 (no attenuation)
 287         18 - right, C destination attn, default 0 (mute)
 288         19 - right, D destination attn, default 0 (mute)
 289         20 - right, E destination attn, default 0 (mute)
 290         21 - right, F destination attn, default 0 (mute)
 291         22 - right, G destination attn, default 0 (mute)
 292         23 - right, H destination attn, default 0 (mute)
 293
 294
 295
 296 4) MANUALS/PATENTS:
 297 -------------------
 298
 299 ftp://opensource.creative.com/pub/doc
 300 -------------------------------------
 301
 302         Files:
 303         LM4545.pdf      AC97 Codec
 304
 305         m2049.pdf       The EMU10K1 Digital Audio Processor
 306
 307         hog63.ps        FX8010 - A DSP Chip Architecture for Audio Effects
 308
 309
 310 WIPO Patents
 311 ------------
 312         Patent numbers:
 313         WO 9901813 (A1) Audio Effects Processor with multiple asynchronous (Jan. 14, 1999)
 314                         streams
 315
 316         WO 9901814 (A1) Processor with Instruction Set for Audio Effects (Jan. 14, 1999)
 317
 318         WO 9901953 (A1) Audio Effects Processor having Decoupled Instruction
 319                         Execution and Audio Data Sequencing (Jan. 14, 1999)
 320
 321
 322 US Patents (http://www.uspto.gov/)
 323 ----------------------------------
 324
 325         US 5925841      Digital Sampling Instrument employing cache memory (Jul. 20, 1999)
 326
 327         US 5928342      Audio Effects Processor integrated on a single chip (Jul. 27, 1999)
 328                         with a multiport memory onto which multiple asynchronous
 329                         digital sound samples can be concurrently loaded
 330
 331         US 5930158      Processor with Instruction Set for Audio Effects (Jul. 27, 1999)
 332
 333         US 6032235      Memory initialization circuit (Tram) (Feb. 29, 2000)
 334
 335         US 6138207      Interpolation looping of audio samples in cache connected to    (Oct. 24, 2000)
 336                         system bus with prioritization and modification of bus transfers
 337                         in accordance with loop ends and minimum block sizes
 338
 339         US 6151670      Method for conserving memory storage using a (Nov. 21, 2000)
 340                         pool of  short term memory registers
 341
 342         US 6195715      Interrupt control for multiple programs communicating with      (Feb. 27, 2001)
 343                         a common interrupt by associating programs to GP registers,
 344                         defining interrupt register, polling GP registers, and invoking
 345                         callback routine associated with defined interrupt register