ALSA: doc: ReSTize README.maya44

Another	simple conversion from a plain text file.
Put to cards directory.

Signed-off-by: Takashi Iwai <tiwai@suse.de>
This commit is contained in:
Takashi Iwai 2016-11-10 17:07:49 +01:00
parent 7bb97dfdca
commit a02f5895ee
2 changed files with 81 additions and 57 deletions

View File

@ -13,3 +13,4 @@ Card-Specific Information
audiophile-usb audiophile-usb
mixart mixart
bt87x bt87x
maya44

View File

@ -1,10 +1,18 @@
NOTE: The following is the original document of Rainer's patch that the =================================
current maya44 code based on. Some contents might be obsoleted, but I Notes on Maya44 USB Audio Support
keep here as reference -- tiwai =================================
---------------------------------------------------------------- .. note::
The following is the original document of Rainer's patch that the
current maya44 code based on. Some contents might be obsoleted, but I
keep here as reference -- tiwai
Feb 14, 2008
Rainer Zimmermann <mail@lightshed.de>
STATE OF DEVELOPMENT: STATE OF DEVELOPMENT
====================
This driver is being developed on the initiative of Piotr Makowski (oponek@gmail.com) and financed by Lars Bergmann. This driver is being developed on the initiative of Piotr Makowski (oponek@gmail.com) and financed by Lars Bergmann.
Development is carried out by Rainer Zimmermann (mail@lightshed.de). Development is carried out by Rainer Zimmermann (mail@lightshed.de).
@ -44,16 +52,17 @@ Things that do not seem to work:
- Ardour 2.1 seems to work only via JACK, not using ALSA directly or via OSS. This still needs to be tracked down. - Ardour 2.1 seems to work only via JACK, not using ALSA directly or via OSS. This still needs to be tracked down.
DRIVER DETAILS: DRIVER DETAILS
==============
the following files were added: the following files were added:
pci/ice1724/maya44.c - Maya44 specific code * pci/ice1724/maya44.c - Maya44 specific code
pci/ice1724/maya44.h * pci/ice1724/maya44.h
pci/ice1724/ice1724.patch * pci/ice1724/ice1724.patch
pci/ice1724/ice1724.h.patch - PROPOSED patch to ice1724.h (see SAMPLING RATES) * pci/ice1724/ice1724.h.patch - PROPOSED patch to ice1724.h (see SAMPLING RATES)
i2c/other/wm8776.c - low-level access routines for Wolfson WM8776 codecs * i2c/other/wm8776.c - low-level access routines for Wolfson WM8776 codecs
include/wm8776.h * include/wm8776.h
Note that the wm8776.c code is meant to be card-independent and does not actually register the codec with the ALSA infrastructure. Note that the wm8776.c code is meant to be card-independent and does not actually register the codec with the ALSA infrastructure.
@ -62,25 +71,26 @@ This is done in maya44.c, mainly because some of the WM8776 controls are used in
the following files were created in pci/ice1724, simply #including the corresponding file from the alsa-kernel tree: the following files were created in pci/ice1724, simply #including the corresponding file from the alsa-kernel tree:
wtm.h * wtm.h
vt1720_mobo.h * vt1720_mobo.h
revo.h * revo.h
prodigy192.h * prodigy192.h
pontis.h * pontis.h
phase.h * phase.h
maya44.h * maya44.h
juli.h * juli.h
aureon.h * aureon.h
amp.h * amp.h
envy24ht.h * envy24ht.h
se.h * se.h
prodigy_hifi.h * prodigy_hifi.h
*I hope this is the correct way to do things.* *I hope this is the correct way to do things.*
SAMPLING RATES: SAMPLING RATES
==============
The Maya44 card (or more exactly, the Wolfson WM8776 codecs) allow a maximum sampling rate of 192 kHz for playback and 92 kHz for capture. The Maya44 card (or more exactly, the Wolfson WM8776 codecs) allow a maximum sampling rate of 192 kHz for playback and 92 kHz for capture.
@ -98,66 +108,79 @@ I propose some additional code for limiting the sampling rate when setting on a
The proposed code (currently deactivated) is in ice1712.h.patch, ice1724.c and maya44.c (in pci/ice1712). The proposed code (currently deactivated) is in ice1712.h.patch, ice1724.c and maya44.c (in pci/ice1712).
SOUND DEVICES: SOUND DEVICES
=============
PCM devices correspond to inputs/outputs as follows (assuming Maya44 is card #0): PCM devices correspond to inputs/outputs as follows (assuming Maya44 is card #0):
hw:0,0 input - stereo, analog input 1+2 * hw:0,0 input - stereo, analog input 1+2
hw:0,0 output - stereo, analog output 1+2 * hw:0,0 output - stereo, analog output 1+2
hw:0,1 input - stereo, analog input 3+4 OR S/PDIF input * hw:0,1 input - stereo, analog input 3+4 OR S/PDIF input
hw:0,1 output - stereo, analog output 3+4 (and SPDIF out) * hw:0,1 output - stereo, analog output 3+4 (and SPDIF out)
NAMING OF MIXER CONTROLS: NAMING OF MIXER CONTROLS
========================
(for more information about the signal flow, please refer to the block diagram on p.24 of the ESI Maya44 manual, or in the ESI windows software). (for more information about the signal flow, please refer to the block diagram on p.24 of the ESI Maya44 manual, or in the ESI windows software).
PCM: (digital) output level for channel 1+2 PCM
PCM 1: same for channel 3+4 (digital) output level for channel 1+2
PCM 1
same for channel 3+4
Mic Phantom+48V
switch for +48V phantom power for electrostatic microphones on input 1/2.
Mic Phantom+48V: switch for +48V phantom power for electrostatic microphones on input 1/2.
Make sure this is not turned on while any other source is connected to input 1/2. Make sure this is not turned on while any other source is connected to input 1/2.
It might damage the source and/or the maya44 card. It might damage the source and/or the maya44 card.
Mic/Line input: if switch is on, input jack 1/2 is microphone input (mono), otherwise line input (stereo). Mic/Line input
if switch is on, input jack 1/2 is microphone input (mono), otherwise line input (stereo).
Bypass: analogue bypass from ADC input to output for channel 1+2. Same as "Monitor" in the windows driver. Bypass
Bypass 1: same for channel 3+4. analogue bypass from ADC input to output for channel 1+2. Same as "Monitor" in the windows driver.
Bypass 1
same for channel 3+4.
Crossmix: cross-mixer from channels 1+2 to channels 3+4 Crossmix
Crossmix 1: cross-mixer from channels 3+4 to channels 1+2 cross-mixer from channels 1+2 to channels 3+4
Crossmix 1
cross-mixer from channels 3+4 to channels 1+2
IEC958 Output
switch for S/PDIF output.
IEC958 Output: switch for S/PDIF output.
This is not supported by the ESI windows driver. This is not supported by the ESI windows driver.
S/PDIF should output the same signal as channel 3+4. [untested!] S/PDIF should output the same signal as channel 3+4. [untested!]
Digitial output selectors: Digitial output selectors
These switches allow a direct digital routing from the ADCs to the DACs. These switches allow a direct digital routing from the ADCs to the DACs.
Each switch determines where the digital input data to one of the DACs comes from. Each switch determines where the digital input data to one of the DACs comes from.
They are not supported by the ESI windows driver. They are not supported by the ESI windows driver.
For normal operation, they should all be set to "PCM out". For normal operation, they should all be set to "PCM out".
H/W: Output source channel 1 H/W
H/W 1: Output source channel 2 Output source channel 1
H/W 2: Output source channel 3 H/W 1
H/W 3: Output source channel 4 Output source channel 2
H/W 2
Output source channel 3
H/W 3
Output source channel 4
H/W 4 ... H/W 9
unknown function, left in to enable testing.
H/W 4 ... H/W 9: unknown function, left in to enable testing.
Possibly some of these control S/PDIF output(s). Possibly some of these control S/PDIF output(s).
If these turn out to be unused, they will go away in later driver versions. If these turn out to be unused, they will go away in later driver versions.
Selectable values for each of the digital output selectors are: Selectable values for each of the digital output selectors are:
"PCM out" -> DAC output of the corresponding channel (default setting)
"Input 1"...
"Input 4" -> direct routing from ADC output of the selected input channel
PCM out
-------- DAC output of the corresponding channel (default setting)
Input 1 ... Input 4
Feb 14, 2008 direct routing from ADC output of the selected input channel
Rainer Zimmermann
mail@lightshed.de