From Fedora Project Wiki

m (Add to categories)
m (fixed prev. edit)
Tag: Manual revert
 
(7 intermediate revisions by 2 users not shown)
Line 5: Line 5:
== Setup ==
== Setup ==


# This test case should be performed on '''bare-metal machines'''.
# This test case should be performed on '''bare-metal''' machines. To be able to test with '''virtual''' machines, consider a [https://fedoraproject.org/wiki/QA:Howto_USB_Passtrough USB device pass-through]. Leave a note in the comments if you have performed this test using the VM with the USB Passthrough strategy.
# The computer must be equipped with a '''sound device'''.
# The computer must be equipped with a '''sound device'''.
# Install a desktop version of '''Fedora 34''' (or later).
# Install a desktop version of '''Fedora 35''' (or later).
# Make sure the <code>alsa-utils</code> package is installed.
# Make sure the <code>alsa-utils</code> package is installed.
# Connect your '''speakers''' (headphones) to your computer’s sound device.
# Connect your '''speakers''' (headphones) to your computer’s sound device.
Line 23: Line 23:
<li><p>Play the audio file (wav) over the default device.</p>
<li><p>Play the audio file (wav) over the default device.</p>
<p><code>$ aplay -D sysdefault &lt;audiofile.wav&gt;</code></p></li>
<p><code>$ aplay -D sysdefault &lt;audiofile.wav&gt;</code></p></li>
<li><p>Play the audio file (wav) over a selected ALSA device.</p>
<li><p>Play the audio file (wav) over a selected ALSA device. Make sure that you do not have another audio application running in the background, because the command would end up in error due to the device being blocked by another application.</p>
<p><code>$ aplay -D hw:X &lt;audiofile.wav&gt;</code></p></li>
<p><code>$ aplay -D hw:X &lt;audiofile.wav&gt;</code></p></li>
<li><p>Play the audio file (wav) over the pipewire device.</p>
<li><p>Play the audio file (wav) over the pipewire device.</p>
<p><code>$ aplay -D pipewire &lt;audiofile.wav&gt;</code></p></li>
<p><code>$ aplay -D pipewire &lt;audiofile.wav&gt;</code></p></li>
<li><p>Play the audio file (wav) over the physical device.</p>
<li><p>Play the audio file (wav) over the physical device. The Step 3 limitation applies here, too.</p>
<p><code>$ aplay -D sysdefault:CARD=USB &lt;audiofile.wav&gt;</code><ref><p>The device identifier might differ on your machine.</p></ref></p></li>
<p><code>$ aplay -D sysdefault:CARD=USB &lt;audiofile.wav&gt;</code><ref><p>The device identifier might differ on your machine.</p></ref></p></li>
<li><p>Repeat the above step for all physical devices.</p></li>
<li><p>Repeat the above step for all physical devices.</p></li>

Latest revision as of 02:03, 26 July 2023

ALSA backend

This test case tests that ALSA works as a sound backend and that various frontends can be used to communicate with it.

Setup

  1. This test case should be performed on bare-metal machines. To be able to test with virtual machines, consider a USB device pass-through. Leave a note in the comments if you have performed this test using the VM with the USB Passthrough strategy.
  2. The computer must be equipped with a sound device.
  3. Install a desktop version of Fedora 35 (or later).
  4. Make sure the alsa-utils package is installed.
  5. Connect your speakers (headphones) to your computer’s sound device.
  6. Use an audio file in wav format. If you do not have one you can download a suitable audio file. Some default files can be also found in the /usr/share/sounds/ directory.
  7. Perform the following steps as a regular user.

How to test

  1. List the sound devices known to ALSA.

    $ aplay -l

    or (for more details)

    $ aplay -L

    Identify the ones that represent the logical (default, pipewire) or a physical device (sysdefault:CARD=USB, sysdefault:CARD=PCH )

  2. Play the audio file (wav) over the default device.

    $ aplay -D sysdefault <audiofile.wav>

  3. Play the audio file (wav) over a selected ALSA device. Make sure that you do not have another audio application running in the background, because the command would end up in error due to the device being blocked by another application.

    $ aplay -D hw:X <audiofile.wav>

  4. Play the audio file (wav) over the pipewire device.

    $ aplay -D pipewire <audiofile.wav>

  5. Play the audio file (wav) over the physical device. The Step 3 limitation applies here, too.

    $ aplay -D sysdefault:CARD=USB <audiofile.wav>[1]

  6. Repeat the above step for all physical devices.

  7. Run alsamixer and try setting the volume for a physical device use while playing some audio.

Expected results

  1. aplay -L lists physical and logical devices on the system.
  2. Audio can be played over different endpoints using the aplay command.
  3. Volume levels can be adjusted for physical devices using alsamixer[2]

Footnotes

  1. The device identifier might differ on your machine.

  2. This is valid for devices that support software volume adjusting. USB cards often use dedicated hardware knobs to do it and they cannot be controlled programmatically.