tjh.dev
Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
ALSA: emu10k1: add separate documentation for E-MU cards
They are sufficiently different from Sound Blasters.
Signed-off-by: Oswald Buddenhagen <oswald.buddenhagen@gmx.de>
Link: https://lore.kernel.org/r/20230825222157.170978-3-oswald.buddenhagen@gmx.de
Signed-off-by: Takashi Iwai <tiwai@suse.de>
authored by
Oswald Buddenhagen
and committed by
Takashi Iwai
0982e519
13890a6a
+227
+226
Documentation/sound/cards/emu-mixer.rst
+226
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.