263 lines
6.2 KiB
HTML
263 lines
6.2 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of SPEAKER-TEST</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>SPEAKER-TEST</H1>
|
|
Section: User Commands (1)<BR>Updated: April 2nd, 2011<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
speaker-test - command-line speaker test tone generator for ALSA
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
<B>speaker-test [-options]</B>
|
|
|
|
<P>
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
<B>speaker-test</B> generates a tone that can be used to test the speakers of a computer.
|
|
<P>
|
|
<B>speaker-test</B> by default will test the <I>default</I> device. If you
|
|
want to test another sound device you will have first to get a list of
|
|
all of the sound cards in your system and the devices associated with
|
|
those cards. Notice that there might be for example, one device for
|
|
analog sound, one for digital sound and one for HDMI sound.
|
|
To get the list of available cards and devices you can run <B>aplay -L</B>.
|
|
<P>
|
|
<P>
|
|
|
|
<P>
|
|
<PRE>
|
|
$ aplay -L
|
|
null
|
|
Discard all samples (playback) or generate zero samples (capture)
|
|
default:CARD=ICH5
|
|
Intel ICH5, Intel ICH5
|
|
Default Audio Device
|
|
front:CARD=ICH5,DEV=0
|
|
Intel ICH5, Intel ICH5
|
|
Front speakers
|
|
surround40:CARD=ICH5,DEV=0
|
|
Intel ICH5, Intel ICH5
|
|
4.0 Surround output to Front and Rear speakers
|
|
(...)
|
|
</PRE>
|
|
|
|
<P>
|
|
<P>
|
|
|
|
in the above example, there are four devices listed: null, default, front
|
|
and surround40. So, if you want to test the last device you can
|
|
run <B>speaker-test -Dsurround40:ICH5 -c 6</B>. The <B>-c</B> option will
|
|
indicate that the six audio channels in the device have to be tested.
|
|
<P>
|
|
<P>
|
|
<P>
|
|
<P>
|
|
<P>
|
|
<A NAME="lbAE"> </A>
|
|
<H2>OPTIONS</H2>
|
|
|
|
<P>
|
|
<DL COMPACT>
|
|
<DT id="1"><B>-c</B> | <B>--channels</B> <I>NUM</I><DD>
|
|
<I>NUM</I> channels in stream
|
|
<P>
|
|
<DT id="2"><B>-D</B> | <B>--device</B> <I>NAME</I><DD>
|
|
PCM device name <I>NAME</I>
|
|
<P>
|
|
<DT id="3"><B>-f</B> | <B>--frequency</B> <I>FREQ</I><DD>
|
|
sine wave of <I>FREQ</I> Hz
|
|
<P>
|
|
<DT id="4"><B>--help</B><DD>
|
|
Print usage help
|
|
<P>
|
|
<DT id="5"><B>-b</B> | <B>--buffer</B> <I>TIME</I><DD>
|
|
Use buffer size of <I>TIME</I> microseconds.
|
|
When 0 is given, use the maximal buffer size.
|
|
The default value is 0.
|
|
<P>
|
|
<DT id="6"><B>-p</B> | <B>--period</B> <I>TIME</I><DD>
|
|
Use period size of <I>TIME</I> microseconds.
|
|
When 0 is given, the periods given by <B>-P</B> option is used.
|
|
The default value is 0.
|
|
<P>
|
|
<DT id="7"><B>-P</B> | <B>--nperiods</B> <I>PERIODS</I><DD>
|
|
Use number of periods. The default value is 4.
|
|
<P>
|
|
<DT id="8"><B>-r</B> | <B>--rate</B> <I>RATE</I><DD>
|
|
stream of <I>RATE</I> Hz
|
|
<P>
|
|
<DT id="9"><B>-t</B> | <B>--test</B> <B>pink</B>|<B>sine</B>|<B>wav</B><DD>
|
|
<B>-t pink</B> means use pink noise (default).
|
|
<P>
|
|
Pink noise is perceptually uniform noise -- that is, it sounds like every frequency at once. If you can hear any tone it may indicate resonances in your speaker system or room.
|
|
<P>
|
|
<B>-t sine</B> means to use sine wave.
|
|
<P>
|
|
<B>-t wav</B> means to play WAV files, either pre-defined files or given via <B>-w</B> option.
|
|
<P>
|
|
You can pass the number from 1 to 3 as a backward compatibility.
|
|
<P>
|
|
<DT id="10"><B>-l</B> | <B>--nloops</B> <I>COUNT</I><DD>
|
|
<P>
|
|
Specifies the number of loops. Zero means to run infinitely.
|
|
<P>
|
|
When <B>-s</B> option below with a valid channel is given, <B>speaker-test</B> will perform
|
|
always a single-shot without looping.
|
|
<P>
|
|
<DT id="11"><B>-s</B> | <B>--speaker</B> <I>CHANNEL</I><DD>
|
|
Do a single-shot speaker test for the given channel. The channel number starts from 1.
|
|
The channel number corresponds to left, right, rear-left, rear-right, center, LFE,
|
|
side-left, side-right, and so on.
|
|
<P>
|
|
For example, when 1 is passed, it tests the left channel only once rather than both channels
|
|
with looping.
|
|
<P>
|
|
<DT id="12"><B>-w</B> | <B>--wavfile</B> <I>FILE</I><DD>
|
|
Use the given WAV file for the playback instead of pre-defined WAV files.
|
|
<P>
|
|
<DT id="13"><B>-W</B> | <B>--wavdir</B> <I>DIRECTORY</I><DD>
|
|
Specify the directory containing WAV files for playback.
|
|
The default path is <I>/usr/share/sounds/alsa</I>.
|
|
<P>
|
|
<DT id="14"><B>-m</B> | <B>--chmap</B> <I>MAP</I><DD>
|
|
Pass the channel map to override.
|
|
If the playback in a specific channel order or channel positions is
|
|
required, pass the channel position strings to this option.
|
|
<P>
|
|
<DT id="15"><B>-X</B> | <B>--force-frequency</B><DD>
|
|
Allow supplied <I>FREQ</I> to be outside the default range of 30-8000Hz. A minimum of 1Hz is still enforced.
|
|
<P>
|
|
</DL>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>USAGE EXAMPLES</H2>
|
|
|
|
<P>
|
|
Produce stereo sound from one stereo jack:
|
|
|
|
<DL COMPACT>
|
|
<DT id="16"><DD>
|
|
|
|
<PRE>
|
|
speaker-test -Dplug:front -c2
|
|
|
|
</PRE>
|
|
|
|
</DL>
|
|
<P>
|
|
|
|
|
|
<P>
|
|
Produce 4 speaker sound from two stereo jacks:
|
|
|
|
<DL COMPACT>
|
|
<DT id="17"><DD>
|
|
|
|
<PRE>
|
|
speaker-test -Dplug:surround40 -c4
|
|
|
|
</PRE>
|
|
|
|
</DL>
|
|
<P>
|
|
|
|
|
|
<P>
|
|
Produce 5.1 speaker sound from three stereo jacks:
|
|
|
|
<DL COMPACT>
|
|
<DT id="18"><DD>
|
|
|
|
<PRE>
|
|
speaker-test -Dplug:surround51 -c6
|
|
|
|
</PRE>
|
|
|
|
</DL>
|
|
<P>
|
|
|
|
|
|
<P>
|
|
To send a nice low 75Hz tone to the Woofer and then exit without touching any other speakers:
|
|
|
|
<DL COMPACT>
|
|
<DT id="19"><DD>
|
|
|
|
<PRE>
|
|
speaker-test -Dplug:surround51 -c6 -s1 -f75
|
|
|
|
</PRE>
|
|
|
|
</DL>
|
|
<P>
|
|
|
|
|
|
<P>
|
|
To do a 2-speaker test using the spdif (coax or optical) output:
|
|
|
|
<DL COMPACT>
|
|
<DT id="20"><DD>
|
|
|
|
<PRE>
|
|
speaker-test -Dplug:spdif -c2
|
|
|
|
</PRE>
|
|
|
|
</DL>
|
|
<P>
|
|
|
|
|
|
<P>
|
|
Play in the order of front-right and front-left from the front PCM
|
|
|
|
<DL COMPACT>
|
|
<DT id="21"><DD>
|
|
|
|
<PRE>
|
|
speaker-test -Dplug:front -c2 -mFR,FL
|
|
|
|
</PRE>
|
|
|
|
</DL>
|
|
<P>
|
|
|
|
|
|
<P>
|
|
<A NAME="lbAG"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+aplay">aplay</A>(1)</B>
|
|
|
|
<P>
|
|
<A NAME="lbAH"> </A>
|
|
<H2>AUTHOR</H2>
|
|
|
|
The speaker-test program was written by James Courtier-Dutton.
|
|
Pink noise support was added by Nathan Hurst.
|
|
Further extensions by Takashi Iwai.
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="22"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="23"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="24"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="25"><A HREF="#lbAE">OPTIONS</A><DD>
|
|
<DT id="26"><A HREF="#lbAF">USAGE EXAMPLES</A><DD>
|
|
<DT id="27"><A HREF="#lbAG">SEE ALSO</A><DD>
|
|
<DT id="28"><A HREF="#lbAH">AUTHOR</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:05:27 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|