DebuggingSoundProblems
Differences between revisions 14 and 77 (spanning 63 versions)
|
Size: 8071
Comment: reverting back to the way it should be
|
← Revision 77 as of 2014-07-26 11:08:14 ⇥
Size: 3355
Comment: Streamlined the article to ease bug reporter workflow. No content changes.
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 1: | Line 1: |
| #### do not move or rename as the Ubuntu Bug Control team uses this page extensively #### | |
| Line 2: | Line 3: |
| #do not move or rename as the Ubuntu Bug Control team uses this page extensively ||<tablestyle="float:right; font-size: 0.9em; width:40%; background:#F1F1ED; margin: 0 0 1em 1em;" style="padding:0.5em;">'''Contents'''[[BR]][[TableOfContents(2)]]|| |
<<Include(Debugging/Header)>> ||<tablestyle="float:right; font-size: 0.9em; width:30%; background:#F1F1ED; background-repeat: no-repeat; background-position: 98% 0.5ex; margin: 0 0 1em 1em; padding: 0.5em;"><<TableOfContents>>|| |
| Line 5: | Line 6: |
| = Basic troubleshooting = | = Preliminary checks before filing a bug report = |
| Line 7: | Line 8: |
| === Preliminary checks === 1. Is your sound system plugged in and switched on. I spent an hour trying to diagnose a sound issue when the problem was that I had switched off the speakers to answer a phone call and forgot that I had done so. :-( |
Before filing a bug report, please check on the following: 1. Is your sound system plugged in and switched on? I spent an hour trying to diagnose a sound issue when the problem was that I had switched off the speakers to answer a phone call and forgot that I had done so. :-( |
| Line 10: | Line 11: |
| === Checking volume levels === 1. From command line: Open a terminal window and launch ''alsamixer'' then make sure sound is unmuted and that the volume is turned up. Unmute everything, sometimes a muted channel will be the problem, even if the description doesn't seem immediately relevant. 1. From GUI: This can be done by running something like ''gnome-alsamixer'' from a terminal window or navigating to your your Volume Control. Again, at this point make sure sound is unmuted and that the volume is turned up. Unmute everything, sometimes a muted channel will be the problem, even if the description doesn't seem immediately relevant. Also check that your switches are set correctly - for instance that if you use the analog output the analog switch is set ON or that the digital or S/PDIF switch is set OFF. You can select which tracks/switches are visible in Volume Control (see above) under Edit->Preferences. * Note: These controls have equivalent functionality to alsamixer but with a graphical interface. Checking or unchecking devices in the these accomplishes the exact same thing as unmuting or muting devices, respectively, in alsamixer. * Starting with Ubuntu 7.04, the sound volume control is also accessible from Menu->Sound&Video->Volume Control. It may be hidden in your menus but can be shown by going to System > Preferences > Main Menu and under Applications > Sound&Video ticking Volume Control. |
1. Is your speaker or microphone muted? Check here: * [[Audio/CheckForMutedSpeakerVolume|Check for muted speaker]] * [[Audio/CheckForMutedMicrophone|Check for muted microphone]] |
| Line 16: | Line 15: |
| === Checking sound device assignment === 1. Most sound applications output to card0 by default. In some cases, other audio devices (like a USB MIDI Keyboard) might be recognized as a soundcard and take card0, bumping your real soundcard to card1. To see which devices are connected to which cards, do the following: * {{{ cat /proc/asound/cards }}} 1. You can manipulate the device number assignment by adding snd-usb-audio to /etc/modprobe.d/alsa-base . Next boot, the snd-usb-audio device will get index 1. * {{{ options snd-usb-audio index=1 |
= How to report audio bugs = Please do not report general problems on this page; use the normal support channels instead. For more on this, please see [[http://www.ubuntu.com/support]]. If you have found a software bug, please report it by via the following terminal command: {{{ ubuntu-bug -s audio |
| Line 24: | Line 23: |
| === Checking permissions and resources === 1. Make sure that all users needing access to the Sound Device can "Use audio devices" in the "User Privileges" tab of users-admin (System->Administration->Users and Groups). 1. Test different "Sound Servers": Go to System > Preferences > Sound ("Multimedia Systems Selector" in earlier editions of Ubuntu). From there, you can test the different options. In some scenarios several different sound servers may be installed, and only one may work. This is probably the origin of the problem if you cannot play audio with xine or rhythmbox, but you can with xmms or helix/realplayer. 1. If you application sounds works, but your system sounds does not (login, logout, error sounds...) try removing the .asoundrc* files from your own directory (e.g. with 'rm .asoundrc*'). It should make the system sounds work without a reboot. 1. If you can get absolutely no sound and you have an onboard sound chip you can try to disable it in the BIOS. This solves the problem is some cases. 1. If you have no sound and you have a regular sound card type "lsmod | grep snd" in the terminal and see if there is more than one card listed. It's possible that you have a motherboard sound chip that is interfering. Add it to the bottom of the blacklist file. For example, sudo nano /etc/modprobe.d/blacklist then add "blacklist snd_via82xx" to the bottom. |
This will submit a detailed bug report with necessary information about your current system. |
| Line 31: | Line 25: |
| = Reporting Sound Bugs = | If the above fails for some reason, you may file a bug report, then upload alsa-info information [[Audio/AlsaInfo|according to these instructions]]. |
| Line 33: | Line 27: |
| Please do not report problems on this page; use the normal support channels instead. See http://www.ubuntu.com/support | == Things to specify in your bug report == |
| Line 35: | Line 29: |
| If you feel you have encountered a software bug, please report the bug at https://launchpad.net/ubuntu/+filebug using your kernel version as the package. If you are uncertain of the kernel version that you have installed you can check by typing ''uname -a'' in a terminal. Also, be sure to include the following information to your report. Please be sure to add each file as a separate attachment: 1. Output of 'uname -a' * {{{ uname -a > uname-a.log }}} 1. Output of 'sudo lspci -vvnn' * {{{ sudo lspci -vvnn > lspci-vvnn.log }}} 1. Sound Information (see below for how to gather) |
First, should you ever need to do anything in this section for your sound to work in a brand new installation you should report a bug. |
| Line 44: | Line 31: |
| === Automatic Sound Information Collection === This is the preferred method for gathering the appropriate sound information from you system. It's helps ensure that you gather the sound information correctly and completely. The following script gathers all required information in one go [http://bulletproof.servebeer.com/alsa/scripts/alsa-info.sh] . The script was written to aid the alsa developers, and also to help the people in #alsa to sort out sound issues. Please download and run the script as follows: 1. {{{ ./alsa-info.sh --no-upload }}} 1. /tmp/alsa-info.txt will be generated. Attach this file to your bug report 1. The alsa-info.sh script can either be run as 'bash alsa-info.sh' _or_ made executable and run as './alsa-info.sh'. |
1. For mixer problems, you may control the [[Audio/Alsamixer|mixers at ALSA level]]. 1. A hardware enablement or regression bug may have been fixed upstream. Hence, please test the latest snapshot of [[Audio/UpgradingAlsa|upgrading your ALSA drivers]], mention which version specifically you tested, if this resolves your problem. 1. If your problem is audio crackling, glitching, or breaking up, and it is hardware specific, you can try applying a [[Audio/PositionReporting|position fix quirk]]. 1. Using very new hardware? [[Audio/HDAGeneric|Here's how to check]] whether your built-in sound card has driver support. |
| Line 51: | Line 36: |
| === Manual sound configuration collection === This is the information gathered from the automated sound information collection script. We highly recommend you use the automated script when gathering the sound information regarding your system. Manually collection of the information by hand is a tedious process and is more prone to user error. |
= Triaging sound bugs = |
| Line 54: | Line 38: |
| 1. You can use aplay to get a list of soundcards configured by alsa * {{{ $ aplay --list-devices aplay: device_list:200: no soundcards found... }}} 1. The following commands can help to figure out what sound card (chip set) you have (Look for lines that contain 'Multimedia audio controller'). The actual {sub,}{vendor,device} IDs are important. That's how we track whether something exists as a quirk or needs to be added/modified. * {{{ $ lspci -vvnn $ lspnp -v }}} 1. The following command lists the codecs involved. The output from this command is ''vital''. Different codecs pushing the same driver (say, intel8x0, emu10k1, or hda-intel) exhibit a huge variation in errata. * {{{ tail -2 /proc/asound/oss/sndstat }}} 1. It is ''imperative'' that you include the amixer output from your preferred (the one that's giving problems) audio device. The community has spent years documenting known mixer issues on http://alsa.opensrc.org/ (see drivers). For instance, many of the codecs driving cs46xx, emu10k1, and intel8x0 require multiple elements to be selected, unmuted, and raised to audible levels. * {{{ amixer }}} 1. This script command (which is really just filtered cat /proc/asound/cards) lists the enumerated sound devices on your system. * {{{ asoundconf list }}} 1. We need to know if you've modified any runtime configuration files that affect how alsa-lib interacts with your sound devices. The nonexistence of the above files is not a problem. * {{{ cat /etc/asound.conf ~/.asoundrc* }}} 1. Many codecs and drivers, upon initialization, will spit something via printk() into the kernel ring buffer. Any diagnostic messages will appear in this output. * {{{ dmesg }}} 1. Sound devices require resources. We need to see if those resources are properly assigned, the above command lists interrupts used. * {{{ cat /proc/interrupts }}} |
In general, no-sound/low-sound/headphone-no-sound/no auto-mute/etc. bugs should be: * Filed against the '''linux''' source package. * Add the '''kernel-sound''' tag * '''Subscribe''' (do not assign) the '''Ubuntu-audio''' team (not the ubuntu-audio-dev team) |
| Line 81: | Line 43: |
| = Misc = A bit of useful information regarding manual installation of sound drivers as well as troubleshooting pulseaudio, flash, and sound mixing can be found here: |
Only assign bugs to the "alsa-driver" source package if the reporter is using the alsa-source binary package with module-assistant OR is requesting a blacklist or slots/index modification. |
| Line 84: | Line 45: |
| https://help.ubuntu.com/community/DebuggingSoundProblemsMisc | * Do not mark bugs as duplicates unless you're 100% sure that both the '''hardware''', '''software''', and '''symptom''' match exactly. Slightly different hardware very often requires slightly different fixes. If in doubt, file a new bug. |
| Line 86: | Line 47: |
| = Links = http://alsa.opensrc.org/index.php |
[[Audio/SameHardware|Here's an article]] of how to determine whether you have the same hardware as the original bug reporter. = Further Information = The [[https://launchpad.net/~ubuntu-audio-dev|Ubuntu Audio Developer's team]] maintains a set of Audio relevant wiki pages [[Audio|here]]. |
| Line 90: | Line 54: |
| CategoryDocumentation CategoryBugSquad | CategoryDocumentation CategoryBugSquad CategoryDebugging |
This page is part of the debugging series — pages with debugging details for a variety of Ubuntu packages. |
Preliminary checks before filing a bug report
- Before filing a bug report, please check on the following:
Is your sound system plugged in and switched on? I spent an hour trying to diagnose a sound issue when the problem was that I had switched off the speakers to answer a phone call and forgot that I had done so.
- Is your speaker or microphone muted? Check here:
How to report audio bugs
Please do not report general problems on this page; use the normal support channels instead. For more on this, please see http://www.ubuntu.com/support.
If you have found a software bug, please report it by via the following terminal command:
ubuntu-bug -s audio
This will submit a detailed bug report with necessary information about your current system.
If the above fails for some reason, you may file a bug report, then upload alsa-info information according to these instructions.
Things to specify in your bug report
First, should you ever need to do anything in this section for your sound to work in a brand new installation you should report a bug.
For mixer problems, you may control the mixers at ALSA level.
A hardware enablement or regression bug may have been fixed upstream. Hence, please test the latest snapshot of upgrading your ALSA drivers, mention which version specifically you tested, if this resolves your problem.
If your problem is audio crackling, glitching, or breaking up, and it is hardware specific, you can try applying a position fix quirk.
Using very new hardware? Here's how to check whether your built-in sound card has driver support.
Triaging sound bugs
In general, no-sound/low-sound/headphone-no-sound/no auto-mute/etc. bugs should be:
Filed against the linux source package.
Add the kernel-sound tag
Subscribe (do not assign) the Ubuntu-audio team (not the ubuntu-audio-dev team)
Only assign bugs to the "alsa-driver" source package if the reporter is using the alsa-source binary package with module-assistant OR is requesting a blacklist or slots/index modification.
Do not mark bugs as duplicates unless you're 100% sure that both the hardware, software, and symptom match exactly. Slightly different hardware very often requires slightly different fixes. If in doubt, file a new bug.
Here's an article of how to determine whether you have the same hardware as the original bug reporter.
Further Information
The Ubuntu Audio Developer's team maintains a set of Audio relevant wiki pages here.
DebuggingSoundProblems (last edited 2014-07-26 11:08:14 by penalvch)