DebuggingSoundProblems

Differences between revisions 72 and 73
Revision 72 as of 2011-12-19 11:18:04
Size: 3603
Editor: hd9483857
Comment:
Revision 73 as of 2012-08-30 15:02:02
Size: 3666
Editor: penalvch
Comment: Added = Minimum Requirements for Audio Bugs = due to https://bugs.launchpad.net/ubuntu/+source/linux/+bug/1037820
Deletions are marked like this. Additions are marked like this.
Line 6: Line 6:
= Basic troubleshooting = = Minimum Requirements for Audio Bugs =
Line 8: Line 8:
There is a troubleshooter that checks for some of the most common problems. Press Alt+F2, then enter this command:
{{{
ubuntu-bug audio
}}}
First, please make sure all the below mentioned steps are completed, and the results are commented in your report. Failure to do so may delay your bug getting fixed as soon as possible.
Line 13: Line 10:
== 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. :-(

 1. Is your speaker or microphone muted? Check here:
   * [[Audio/CheckForMutedSpeakerVolume|Check for muted speaker]]
   * [[Audio/CheckForMutedMicrophone|Check for muted microphone]]

= Advanced troubleshooting =

If the basic troubleshooting does not help, here are some additional things to try. However, when trying these steps, remember where you were so you can easily go back in case your problem is not fixed. Also, should you ever need to do anything in this section for your sound to work (for a new installation), you should report a bug using "ubuntu-bug audio".

 1. For mixer problems, you can try controlling the [[Audio/Alsamixer|mixers at ALSA level]].
 1. If your problem is related to your hardware, you might be helped by checking if it is a bug that is already fixed upstream. You can try [[Audio/UpgradingAlsa|upgrading your ALSA drivers]] to the latest snapshot.
 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.

= Reporting Sound Bugs =
== How to Report Audio Bugs ==
Line 43: Line 23:
== Triaging sound bugs == == 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. :-(

 1. Is your speaker or microphone muted? Check here:
   * [[Audio/CheckForMutedSpeakerVolume|Check for muted speaker]]
   * [[Audio/CheckForMutedMicrophone|Check for muted microphone]]

== Advanced troubleshooting ==

If the basic troubleshooting does not help, here are some additional things to try. However, when trying these steps, remember where you were so you can easily go back in case your problem is not fixed. Also, should you ever need to do anything in this section for your sound to work (for a new installation), you should report a bug using "ubuntu-bug audio".

 1. For mixer problems, you can try controlling the [[Audio/Alsamixer|mixers at ALSA level]].
 1. If your problem is related to your hardware, you might be helped by checking if it is a bug that is already fixed upstream. You can try [[Audio/UpgradingAlsa|upgrading your ALSA drivers]] to the latest snapshot.
 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.

= Triaging sound bugs =

Debugging Central

This page is part of the debugging series — pages with debugging details for a variety of Ubuntu packages.

Minimum Requirements for Audio Bugs

First, please make sure all the below mentioned steps are completed, and the results are commented in your report. Failure to do so may delay your bug getting fixed as soon as possible.

How to Report Audio Bugs

Please do not report problems on this page; use the normal support channels instead. See http://www.ubuntu.com/support

If you feel you have encountered a software bug, the way to report it is to run the following terminal command:

ubuntu-bug audio

This will submit a detailed bug report with information about your current system.

If the above fails for some reason, you can file a bug report, then upload alsa-info information according to these instructions.

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. Sad :-(

  2. Is your speaker or microphone muted? Check here:

Advanced troubleshooting

If the basic troubleshooting does not help, here are some additional things to try. However, when trying these steps, remember where you were so you can easily go back in case your problem is not fixed. Also, should you ever need to do anything in this section for your sound to work (for a new installation), you should report a bug using "ubuntu-bug audio".

  1. For mixer problems, you can try controlling the mixers at ALSA level.

  2. If your problem is related to your hardware, you might be helped by checking if it is a bug that is already fixed upstream. You can try upgrading your ALSA drivers to the latest snapshot.

  3. If your problem is audio crackling, glitching, or breaking up, and it is hardware specific, you can try applying a position fix quirk.

  4. 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.


CategoryDocumentation CategoryBugSquad CategoryDebugging

DebuggingSoundProblems (last edited 2014-07-26 11:08:14 by penalvch)