.\" -*- nroff -*-
.\" macros
.de EX \" Begin Example
.  IP
.  ft CW
.  nf
.  ne \\$1
..
.de EE \" End Example
.  ft P
.  fi
.  PP
..
.TH SPEAKER\-TEST 1 "April 2nd, 2011" speaker\-test
.SH "نام (NAME)"
speaker\-test \- مولد تن‌آوای آزمایشی بلندگو در خط فرمان برای ALSA
.SH "خلاصه دستور (SYNOPSIS)"
.B speaker\-test [\-options]

.SH "توضیحات (DESCRIPTION)"
دستور
\fBspeaker\-test\fP
تن‌آوایی تولید می‌کند که می‌تواند برای آزمایش بلندگوهای رایانه استفاده شود.

برنامه
\fBspeaker\-test\fP
به صورت پیش‌فرض دستگاه
\fIdefault\fP
را آزمایش می‌کند. اگر می‌خواهید دستگاه صوتی دیگری را آزمایش کنید، ابتدا باید فهرستی از تمام کارت‌های صوتی سیستم و دستگاه‌های مرتبط با آن‌ها تهیه کنید. توجه داشته باشید که ممکن است به عنوان مثال یک دستگاه برای صدای آنالوگ، یکی برای صدای دیجیتال و دیگری برای صدای HDMI وجود داشته باشد.
برای دریافت فهرست کارت‌ها و دستگاه‌های موجود می‌توانید
\fBaplay \-L\fR
را اجرا کنید.

.P
خروجی
\fBaplay\fR
مشابه نمونه زیر خواهد بود:

.nf
$ 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
(...)
.fi

.P
هر یک از دستگاه‌ها در ابتدای تعریف فهرست شده‌اند؛ بنابراین در مثال بالا، چهار دستگاه فهرست شده است: null، default، front و surround40. بنابراین اگر می‌خواهید آخرین دستگاه را آزمایش کنید، می‌توانید
\fBspeaker\-test \-Dsurround40:ICH5 \-c 6\fR
را اجرا کنید. گزینه
\fB\-c\fR
مشخص می‌کند که شش کانال صوتی در این دستگاه باید آزمایش شوند.

.SH "گزینه‌ها (OPTIONS)"

.TP
\fB\-c\fP | \fB\-\-channels\fP \fINUM\fP
تعداد \fINUM\fP کانال در جریان صوتی

.TP
\fB\-D\fP | \fB\-\-device\fP \fINAME\fP
نام دستگاه \fINAME\fP برای PCM

.TP
\fB\-f\fP | \fB\-\-frequency\fP \fIFREQ\fP
موج سینوسی با بسامد \fIFREQ\fP هرتز

.TP
\fB\-\-help\fP
چاپ راهنمای استفاده

.TP
\fB\-b\fP | \fB\-\-buffer\fP \fITIME\fP
استفاده از اندازه بافر به میزان \fITIME\fP میکروثانیه.
هنگامی که 0 داده شود، بیشترین اندازه بافر استفاده می‌شود.
مقدار پیش‌فرض 0 است.

.TP
\fB\-p\fP | \fB\-\-period\fP \fITIME\fP
استفاده از اندازه دوره زمانی به میزان \fITIME\fP میکروثانیه.
هنگامی که 0 داده شود، دوره‌های زمانی تعیین‌شده توسط گزینه \fB\-P\fP استفاده می‌شوند.
مقدار پیش‌فرض 0 است.

.TP
\fB\-P\fP | \fB\-\-nperiods\fP \fIPERIODS\fP
استفاده از تعداد دوره‌ها. مقدار پیش‌فرض 4 است.

.TP
\fB\-r\fP | \fB\-\-rate\fP \fIRATE\fP
جریان با نرخ نمونه‌برداری \fIRATE\fP هرتز

.TP
\fB\-t\fP | \fB\-\-test\fP \fBpink\fP|\fBst2095\fP|\fBsine\fP|\fBwav\fP
گزینه \fB\-t pink\fP به معنای استفاده از نویز صورتی است (پیش‌فرض).

نویز صورتی از نظر ادراکی نویز یکنواخت است -- به این معنی که مانند شنیده شدن همزمان همه بسامدها به نظر می‌رسد. اگر تن‌آوای خاصی را می‌شنوید ممکن است نشان‌دهنده تشدید (رزونانس) در سیستم بلندگو یا اتاق شما باشد.

گزینه \fB\-t st2095\fP به معنای استفاده از نویز صورتی با پهنای باند محدود در -18.5dB AES FS است که بر اساس استاندارد SMPTE ST-2095:1-2015 تولید شده است.
علاوه بر مکان‌یابی بلندگو، ممکن است برای کالیبراسیون سیستم نیز استفاده شود، به عنوان مثال 85dB برای بلندگوهای سالن با +10dB اضافی برای ساب‌ووفرها.
طبق مشخصات، این گزینه برای "کالیبره کردن سطح فشار صوت و پاسخ الکتروآکوستیک سیستم B-chain سینما" در نظر گرفته شده است.
توجه داشته باشید که نرخ‌های نمونه‌برداری کمتر از 48 کیلوهرتز خارج از محدوده مشخصات هستند و تلاشی برای ساخت فیلتر با نرخ کاهش‌یافته انجام خواهد شد.

گزینه \fB\-t sine\fP به معنای استفاده از موج سینوسی است.

گزینه \fB\-t wav\fP به معنای پخش فایل‌های WAV است، چه فایل‌های از پیش تعریف‌شده و چه فایل‌هایی که از طریق گزینه \fB\-w\fP مشخص شده‌اند.

برای سازگاری با نسخه‌های پیشین می‌توانید عددی بین 1 تا 3 ارسال کنید.

.TP
\fB\-l\fP | \fB\-\-nloops\fP \fICOUNT\fP
تعداد تکرارها (حلقه‌ها) را مشخص می‌کند. صفر به معنای اجرای نامحدود است.

هنگامی که گزینه \fB\-s\fP در زیر با یک کانال معتبر داده شود، \fBspeaker\-test\fP همیشه یک اجرای تکی بدون حلقه انجام می‌دهد.

.TP
\fB\-s\fP | \fB\-\-speaker\fP \fICHANNEL\fP
انجام آزمایش تک‌مرحله‌ای بلندگو برای کانال داده‌شده. شماره کانال از 1 شروع می‌شود.
شماره کانال به ترتیب متناظر با چپ، راست، عقب-چپ، عقب-راست، مرکز، LFE، کنار-چپ، کنار-راست و غیره است.

به عنوان مثال، هنگامی که 1 ارسال می‌شود، کانال چپ را تنها یک بار آزمایش می‌کند نه هر دو کانال را در یک حلقه تکرار.

.TP
\fB\-w\fP | \fB\-\-wavfile\fP \fIFILE\fP
استفاده از فایل WAV داده‌شده برای پخش به جای فایل‌های پیش‌فرض WAV.

.TP
\fB\-W\fP | \fB\-\-wavdir\fP \fIDIRECTORY\fP
تعیین دایرکتوری حاوی فایل‌های WAV برای پخش.
مسیر پیش‌فرض \fI/usr/share/sounds/alsa\fP است.

.TP
\fB\-m\fP | \fB\-\-chmap\fP \fIMAP\fP
ارسال نگاشت کانال برای بازتعریف و جایگزینی.
اگر پخش به ترتیب کانالی مشخص یا موقعیت‌های کانالی خاص مورد نیاز است، رشته‌های موقعیت کانال را به این گزینه ارسال کنید.

.TP
\fB\-X\fP | \fB\-\-force-frequency\fP
اجازه می‌دهد مقدار بسامد \fIFREQ\fP ارائه‌شده خارج از محدوده پیش‌فرض ۳۰ تا ۸۰۰۰ هرتز باشد. حداقل مقدار ۱ هرتز همچنان اعمال می‌شود.

.SH "مثال‌ها (EXAMPLES)"

تولید صدای استریو از یک جک استریو:
.EX
  speaker\-test \-Dplug:front \-c2
.EE

تولید صدای ۴ بلندگو از دو جک استریو:
.EX
  speaker\-test \-Dplug:surround40 \-c4
.EE

تولید صدای ۵.۱ کاناله بلندگو از سه جک استریو:
.EX
  speaker\-test \-Dplug:surround51 \-c6
.EE

برای ارسال یک تن‌آوای بم ۷۵ هرتز به ووفر و سپس خروج بدون آزمایش سایر بلندگوها:
.EX
  speaker\-test \-Dplug:surround51 \-c6 \-s1 \-f75
.EE

برای انجام آزمایش ۲ بلندگو با استفاده از خروجی spdif (کواکسیال یا نوری):
.EX
  speaker\-test \-Dplug:spdif \-c2
.EE

پخش به ترتیب جلو-راست و جلو-چپ از PCM جلو:
.EX
  speaker\-test \-Dplug:front \-c2 \-mFR,FL
.EE

.SH "همچنین ببینید (SEE ALSO)"
.BR aplay(1)

.SH "نویسندگان (AUTHORS)"
برنامه speaker\-test توسط James Courtier-Dutton نوشته شده است.
پشتیبانی از نویز صورتی توسط Nathan Hurst افزوده شد.
توسعه‌های بیشتر توسط Takashi Iwai انجام شد.
نویز صورتی باند محدود SMPTE ST-2095:1 توسط Rick Sayre اضافه شد.