aboutsummaryrefslogtreecommitdiff
path: root/Documentation/sound/cards
AgeCommit message (Collapse)AuthorFilesLines
2023-08-26ALSA: emu10k1: add separate documentation for E-MU cardsOswald Buddenhagen2-0/+227
They are sufficiently different from Sound Blasters. Signed-off-by: Oswald Buddenhagen <[email protected]> Link: https://lore.kernel.org/r/[email protected] Signed-off-by: Takashi Iwai <[email protected]>
2023-08-26ALSA: emu10k1: more documentation updatesOswald Buddenhagen2-77/+77
- Clarify the data flows. For SB Live! I fixed only the most obvious point ("from" vs. "for"). - Mention 7.1 side channels on Audigy. - Be unspecific about the output DACs on Audigy, as lots of variants actually exist (see emu_chip_details table). Signed-off-by: Oswald Buddenhagen <[email protected]> Link: https://lore.kernel.org/r/[email protected] Signed-off-by: Takashi Iwai <[email protected]>
2023-08-26ALSA: emu10k1: de-duplicate audigy-mixer.rst vs. sb-live-mixer.rstOswald Buddenhagen1-66/+1
Let the MANUALS/PATENTS section of the former simply refer to the latter - there is no point in duplicating this information with little value to end users. Signed-off-by: Oswald Buddenhagen <[email protected]> Link: https://lore.kernel.org/r/[email protected] Signed-off-by: Takashi Iwai <[email protected]>
2023-06-07docs: sound: add 'pcmtest' driver documentationIvan Orlov2-0/+121
Add documentation for the new Virtual PCM Test Driver. It covers all possible usage cases: errors and delay injections, random and pattern-based data generation, playback and ioctl redefinition functionalities testing. We have a lot of different virtual media drivers, which can be used for testing of the userspace applications and media subsystem middle layer. However, all of them are aimed at testing the video functionality and simulating the video devices. For audio devices we have only snd-dummy module, which is good in simulating the correct behavior of an ALSA device. I decided to write a tool, which would help to test the userspace ALSA programs (and the PCM middle layer as well) under unusual circumstances to figure out how they would behave. So I came up with this Virtual PCM Test Driver. This new Virtual PCM Test Driver has several features which can be useful during the userspace ALSA applications testing/fuzzing, or testing/fuzzing of the PCM middle layer. Not all of them can be implemented using the existing virtual drivers (like dummy or loopback). Here is what can this driver do: - Simulate both capture and playback processes - Check the playback stream for containing the looped pattern - Generate random or pattern-based capture data - Inject delays into the playback and capturing processes - Inject errors during the PCM callbacks Also, this driver can check the playback stream for containing the predefined pattern, which is used in the corresponding selftest to check the PCM middle layer data transferring functionality. Additionally, this driver redefines the default RESET ioctl, and the selftest covers this PCM API functionality as well. The driver supports both interleaved and non-interleaved access modes, and have separate pattern buffers for each channel. The driver supports up to 4 channels and up to 8 substreams. Signed-off-by: Ivan Orlov <[email protected]> Acked-by: Jaroslav Kysela <[email protected]> Link: https://lore.kernel.org/r/[email protected] Signed-off-by: Takashi Iwai <[email protected]>
2023-05-17ALSA: emu10k1: straighten out FX send initOswald Buddenhagen1-18/+18
The mixer structures were filled in two places: on driver init, and when the devices are opened. The latter made the former pointless, so we remove the former. This implies that mixer dumps may now return all zeroes, which is OK, as restoring them is meaningless as well. Things were even weirder for the (generally unused) secondary sends: Some of the initialization loops were forgotten when support for Audigy was added, thus creating the technically illegal state of multiple sends being routed to the same FX accumulator (though it apparently doesn't matter when the amount is zero). The global multi-channel init used some rather bizarre values for the secondary sends, and the init on open actually forgot to re-initialize them. We now use a not really more useful, but simpler formula. The direct register init was also bogus. This doesn't really matter, as the value is overwritten when a voice comes into use, but still. Signed-off-by: Oswald Buddenhagen <[email protected]> Link: https://lore.kernel.org/r/[email protected] Signed-off-by: Takashi Iwai <[email protected]>
2023-05-16ALSA: emu10k1: enable bit-exact playback, part 2: voice attenuationOswald Buddenhagen2-2/+2
The voice volume is a raw fractional multiplier that can't actually represent 1.0. To still enable real pass-through, we now set the volume to 0.5 (which results in no loss of precision, as the FX bus provides fractional values) and scale up the samples in DSP code. To maintain backwards compatibility with existing configuration files, we rescale the values in the mixer controls. The range is extended upwards from 0xffff to 0x1fffd, which actually introduces the possibility of specifying an amplification. There is still a minor incompatibility with user space, namely if someone loaded custom DSP code. They'll just get half the volume, so this doesn't seem like a big deal. Signed-off-by: Oswald Buddenhagen <[email protected]> Link: https://lore.kernel.org/r/[email protected] Signed-off-by: Takashi Iwai <[email protected]>
2023-04-06ALSA: emu10k1: documentation updatesOswald Buddenhagen2-19/+25
- Less misinformation - Language and whitespace fixups Signed-off-by: Oswald Buddenhagen <[email protected]> Link: https://lore.kernel.org/r/[email protected] Signed-off-by: Takashi Iwai <[email protected]>
2023-01-29Documentation: sound: correct spellingRandy Dunlap3-3/+3
Correct spelling problems for Documentation/sound/ as reported by codespell. Signed-off-by: Randy Dunlap <[email protected]> Cc: Jaroslav Kysela <[email protected]> Cc: Takashi Iwai <[email protected]> Cc: [email protected] Cc: Jonathan Corbet <[email protected]> Cc: [email protected] Link: https://lore.kernel.org/r/[email protected] Signed-off-by: Takashi Iwai <[email protected]>
2020-08-24Documentation: sound/cards: fix heading underline lengths for https: changesRandy Dunlap2-2/+2
Fix documentation build warnings for underline length too short, caused by s/http/https/ and not changing the accompanying underlines. Documentation/sound/cards/audigy-mixer.rst:335: WARNING: Title underline too short. US Patents (https://www.uspto.gov/) ---------------------------------- Documentation/sound/cards/sb-live-mixer.rst:340: WARNING: Title underline too short. US Patents (https://www.uspto.gov/) ---------------------------------- Fixes: 7ed33ea6b4fa ("ALSA: Replace HTTP links with HTTPS ones") Signed-off-by: Randy Dunlap <[email protected]> Cc: Alexander A. Klimov <[email protected]> Link: https://lore.kernel.org/r/[email protected] Signed-off-by: Takashi Iwai <[email protected]>
2020-07-19ALSA: Replace HTTP links with HTTPS onesAlexander A. Klimov2-2/+2
Rationale: Reduces attack surface on kernel devs opening the links for MITM as HTTPS traffic is much harder to manipulate. Deterministic algorithm: For each file: If not .svg: For each line: If doesn't contain `\bxmlns\b`: For each link, `\bhttp://[^# \t\r\n]*(?:\w|/)`: If neither `\bgnu\.org/license`, nor `\bmozilla\.org/MPL\b`: If both the HTTP and HTTPS versions return 200 OK and serve the same content: Replace HTTP with HTTPS. Signed-off-by: Alexander A. Klimov <[email protected]> Link: https://lore.kernel.org/r/[email protected] Signed-off-by: Takashi Iwai <[email protected]>
2018-06-26ALSA: multisound.sh: update module namespaceMauro Carvalho Chehab1-36/+36
The modules for the cards described here changed their names. Update accordingly. Signed-off-by: Mauro Carvalho Chehab <[email protected]> Signed-off-by: Takashi Iwai <[email protected]>
2018-06-26ALSA:: multisound.sh: fix script to make it build with modern toolsMauro Carvalho Chehab1-14/+16
The script is old and produce some warnings and errors, because it lacks including stdlib.h and io.h is at sys/io.h. Fix it to run with the tools found on modern Linux distros. Tested building it on Fedora 28. Signed-off-by: Mauro Carvalho Chehab <[email protected]> Signed-off-by: Takashi Iwai <[email protected]>
2018-06-26sound: restore MultiSound scriptMauro Carvalho Chehab1-0/+1137
This script is mentioned at multisound Kconfig and files. As the driver still exists, it probably makes sense to restore it. Fixes: 727dede0ba8a ("sound: Retire OSS") Signed-off-by: Mauro Carvalho Chehab <[email protected]> Signed-off-by: Takashi Iwai <[email protected]>
2017-10-12Documentation: fix input related doc refsTom Saeger1-1/+1
Make `input` document refs valid including: - joystick - joystick-parport Signed-off-by: Tom Saeger <[email protected]> Reviewed-by: Takashi Iwai <[email protected]> Signed-off-by: Jonathan Corbet <[email protected]>
2016-11-10ALSA: doc: ReSTize img,spdif-in.txtTakashi Iwai2-0/+54
Yet another simple conversion from a plain text file. Put to cards directory. Signed-off-by: Takashi Iwai <[email protected]>
2016-11-10ALSA: doc: ReSTize serial-u16550.txtTakashi Iwai2-0/+94
Yet another simple conversion from a plain text file. Put to cards directory. Signed-off-by: Takashi Iwai <[email protected]>
2016-11-10ALSA: doc: ReSTize hdspm.txtTakashi Iwai2-0/+380
A simple conversion from a plain text file. Quite a few reformatting in the end due to the style of the original document. Put to cards directory. Signed-off-by: Takashi Iwai <[email protected]>
2016-11-10ALSA: doc: ReSTize README.maya44Takashi Iwai2-0/+187
Another simple conversion from a plain text file. Put to cards directory. Signed-off-by: Takashi Iwai <[email protected]>
2016-11-10ALSA: doc: ReSTize Bt87x.txtTakashi Iwai2-0/+84
Another simple conversion from a plain text file. Put to cards directory. Signed-off-by: Takashi Iwai <[email protected]>
2016-11-10ALSA: doc: ReSTize MIXART.txtTakashi Iwai2-0/+111
Another simple conversion from a plain text file. Put to cards directory. Signed-off-by: Takashi Iwai <[email protected]>
2016-11-10ALSA: doc: ReSTize Audiophile-USB.txtTakashi Iwai2-0/+551
Another simple conversion from a plain text file. Put to cards directory. Signed-off-by: Takashi Iwai <[email protected]>
2016-11-10ALSA: doc: ReSTize VIA82xx-mixer.txtTakashi Iwai2-0/+9
Another simple conversion from a plain text file. Put to cards directory. Signed-off-by: Takashi Iwai <[email protected]>
2016-11-10ALSA: doc: ReSTize emu10k1-jack.txtTakashi Iwai2-1/+79
Another simple conversion from a plain text file. Put to cards directory. Signed-off-by: Takashi Iwai <[email protected]>
2016-11-10ALSA: doc: ReSTize Audigy-mixer.txtTakashi Iwai2-0/+370
Another simple conversion from a plain text file. Put to cards subdirectory. Signed-off-by: Takashi Iwai <[email protected]>
2016-11-10ALSA: doc: ReSTize SB-Live-mixer documentTakashi Iwai2-0/+374
Another simple conversion from a plain text file. Put to cards subdirectory. Signed-off-by: Takashi Iwai <[email protected]>
2016-11-10ALSA: doc: ReSTize CMIPCI documentTakashi Iwai2-0/+273
A simple conversion from a plain text file. Put to cards subdirectory. Signed-off-by: Takashi Iwai <[email protected]>
2016-11-10ALSA: doc: ReSTize Joystick documentTakashi Iwai2-0/+98
A conversion from a simple text file. A new subdirectory, cards, was created to contain the card-specific information like this one. Signed-off-by: Takashi Iwai <[email protected]>