DebuggingSoundProblems

Differences between revisions 68 and 77 (spanning 9 versions)
Revision 68 as of 2011-12-12 09:13:35
Size: 2919
Editor: 210-242-151-101
Comment: Move information that is old and outdated to DebuggingSoundProblems/OldAndOutdated
Revision 77 as of 2014-07-26 11:08:14
Size: 3355
Editor: penalvch
Comment: Streamlined the article to ease bug reporter workflow. No content changes.
Deletions are marked like this. Additions are marked like this.
Line 6: Line 6:
= Basic troubleshooting = = Preliminary checks before filing a bug report =
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
}}}

== Preliminary checks ==
 Before filing a bug report, please check on the following:
Line 21: Line 15:
= Advanced troubleshooting = = How to report audio bugs =
Line 23: Line 17:
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 something goes wrong. 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". 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]].
Line 25: Line 19:
 1. For mixer problems, you can try controlling the [[Audio/Alsamixer|mixers at ALSA level]].

= Reporting Sound 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
If you have found a software bug, please report it by via the following terminal command: {{{
ubuntu-bug -s audio
Line 36: Line 23:
This will submit a detailed bug report with information about your current system. This will submit a detailed bug report with necessary information about your current system.
Line 38: Line 25:
If the above fails for some reason, you can file a bug report, then upload alsa-info information [[Audio/AlsaInfo|according to these instructions]]. 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 40: Line 27:
== Triaging sound bugs == == 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.

 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.

= Triaging sound bugs =
Line 53: Line 49:
= Further Information =

The [[https://launchpad.net/~ubuntu-audio-dev|Ubuntu Audio Developer's team]] maintains a set of Audio relevant wiki pages [[Audio|here]].

Debugging Central

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

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

  1. For mixer problems, you may control the mixers at ALSA level.

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

  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)