.\" Man page generated from reStructuredText
.\" by the Docutils 0.22.4 manpage writer.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "alsaucm" "1" "2016-09-22" "" "راهنمای دستورات عمومی"
.SH "نام (NAME)"
alsaucm \- مدیر سناریوهای کاربرد ALSA (ALSA Use Case Manager)
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fIalsaucm\fP <گزینه‌ها> [دستور]
.SH "توضیحات (DESCRIPTION)"
.sp
برنامه \fBalsaucm\fP (مدیر سناریوهای کاربرد ALSA) ابزاری برای استفاده از رابط سناریوهای کاربرد ALSA به‌نشانی \%<http://\:www\:.alsa-project\:.org/\:alsa-doc/\:alsa-lib/\:group__ucm\:.html> از طریق خط فرمان است.
.sp
در کارت‌های صدای پیچیده، راه‌اندازی و تنظیم مسیرهای صوتی (audio routes) ساده نیست و ممکن است تنظیمات میکسر با یکدیگر تداخل داشته باشند و مانع از کارکرد کارت صدا شوند.
.sp
مدیر سناریوهای کاربرد ALSA سازوکاری برای کنترل سخت‌افزارهای صوتی پیچیده است که میان پیکربندی‌های سخت‌افزاری و سناریوهای کاربردی معناداری که برای کاربر نهایی قابل درک است، ارتباط برقرار می‌کند.
.sp
همچنین می‌توان از مدیر سناریوهای کاربرد برای جابه‌جایی سازگار و یکنواخت بین سناریوهای کاربرد در صورت نیاز استفاده کرد.
.sp
در سطحی پایین‌تر، این مدیر با پیکربندی کنترل‌های ALSA (kcontrols) در کارت صدا عمل می‌کند تا مسیردهی صوتی دیجیتال و آنالوگ سخت‌افزار را متناسب با سناریوی کاربردی دستگاه مورد نظر تغییر دهد.
.sp
پیکربندی‌های kcontrol مدیر سناریوهای کاربرد در فایل‌های متنی با قابلیت ویرایش آسان ذخیره می‌شوند. یک سناریوی صوتی می‌تواند توسط پارامترهای \fBverb\fP و \fBdevice\fP تعریف شود.
.sp
پارامتر verb کنش سناریوی کاربرد را توصیف می‌کند؛ مانند تماس تلفنی، گوش دادن به موسیقی، ضبط مکالمه و غیره. پارامتر device سخت‌افزار فیزیکی ضبط و پخش صدا را توصیف می‌کند؛ مانند هدفون، گوشی تلفن، هدست بلوتوث و غیره.
.SH "گزینه‌ها (OPTIONS)"
.sp
گزینه‌های در دسترس:
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.TP
.B \fB\-h\fP, \fB\-\-help\fP
نمایش این راهنما
.TP
.B \fB\-c\fP, \fB\-\-card\fP \fINAME\fP
باز کردن کارت صوتی با نام NAME
.TP
.B \fB\-i\fP, \fB\-\-interactive\fP
حالت تعاملی
.TP
.B \fB\-b\fP, \fB\-\-batch\fP \fIFILE\fP
حالت دسته‌ای (استفاده از \fB\(aq\-\(aq\fP برای ورودی استاندارد stdin)
.TP
.B \fB\-n\fP, \fB\-\-no\-open\fP
عدم باز کردن خودکار اولین کارت صدای یافت‌شده
.UNINDENT
.UNINDENT
.UNINDENT
.sp
دستورات در دسترس:
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.TP
.B \fBopen\fP \fINAME\fP
باز کردن کارت با نام NAME.
.sp
نام‌های معتبر، نام‌های کارت صدایی هستند که در مسیر \fB/usr/share/alsa/ucm\fP فهرست شده‌اند\&.
.TP
.B \fBreset\fP
بازنشانی کارت صدا به حالت پیش‌فرض.
.TP
.B \fBreload\fP
بارگذاری مجدد پیکربندی.
.TP
.B \fBlistcards\fP
فهرست کردن کارت‌های صدای موجود.
.TP
.B \fBlist\fP \fIIDENTIFIER\fP
دستور فهرست کردن، برای مواردی که دو مدخل بازمی‌گردانند (مقدار + توضیح).
.sp
مقدار آرگومان \fIIDENTIFIER\fP می‌تواند یکی از موارد زیر باشد:
.INDENT 7.0
.IP \(bu 2
\fB_verbs\fP \- دریافت فهرست verbها (به‌صورت جفت verb+comment)
.IP \(bu 2
\fB_devices[/{verb}]\fP \- دریافت فهرست دستگاه‌های پشتیبانی‌شده (به‌صورت جفت device+comment)
.IP \(bu 2
\fB_modifiers[/{verb}]\fP \- دریافت فهرست تغییردهنده‌های پشتیبانی‌شده (به‌صورت جفت modifier+comment)
.UNINDENT
.sp
فرم‌های بدون پسوند پایانی \fB/{verb}\fP تنها پس از تنظیم یک verb مشخص معتبر هستند.
.TP
.B \fBlist1\fP \fIIDENTIFIER\fP
دستور فهرست کردن، برای فهرست‌هایی که به ازای هر مدخل یک مورد بازمی‌گردانند.
.sp
مقدار آرگومان \fIIDENTIFIER\fP بسته به زمینه (context) می‌تواند متفاوت بوده و شامل موارد زیر باشد:
.INDENT 7.0
.IP \(bu 2
\fBTQ[/{verb}]\fP \- دریافت فهرست شناسه‌های کیفیت تن صدا (Tone Quality)
.IP \(bu 2
\fB_enadevs\fP \- دریافت فهرست دستگاه‌های فعال‌شده
.IP \(bu 2
\fB_enamods\fP \- دریافت فهرست تغییردهنده‌های فعال‌شده
.IP \(bu 2
\fB_supporteddevs/{modifier}|{device}[/{verb}]\fP \- فهرست دستگاه‌های پشتیبانی‌شده
.IP \(bu 2
\fB_conflictingdevs/{modifier}|{device}[/{verb}]\fP \- فهرست دستگاه‌های دارای تداخل
.UNINDENT
.TP
.B \fBget\fP \fIIDENTIFIER\fP
دریافت مقدار رشته‌ای (string).
.sp
مقدار آرگومان \fIIDENTIFIER\fP می‌تواند یکی از موارد زیر باشد:
.INDENT 7.0
.IP \(bu 2
\fB_verb\fP \- بازگرداندن verb فعلی
.IP \(bu 2
\fB[=]{NAME}[/[{modifier}|{/device}][/{verb}]]\fP (برای مشاهده NAMEهای معتبر به رابط سناریوهای کاربرد ALSA به‌نشانی \%<http://\:www\:.alsa-project\:.org/\:alsa-doc/\:alsa-lib/\:group__ucm\:.html> مراجعه کنید)
.UNINDENT
.TP
.B \fBgeti\fP \fIIDENTIFIER\fP
دریافت مقدار عددی صحیح (integer).
.sp
مقدار آرگومان \fIIDENTIFIER\fP می‌تواند یکی از موارد زیر باشد:
.INDENT 7.0
.IP \(bu 2
\fB_devstatus/{device}\fP
.IP \(bu 2
\fB_modstatus/{device}\fP
.UNINDENT
.TP
.B \fBset\fP \fIIDENTIFIER\fP \fIVALUE\fP
تنظیم مقدار رشته‌ای
.sp
مقدار آرگومان \fIIDENTIFIER\fP می‌تواند یکی از موارد زیر باشد:
.INDENT 7.0
.IP \(bu 2
\fB_verb\fP \- تنظیم verb بر روی \fIVALUE\fP
.IP \(bu 2
\fB_enadev\fP \- فعال‌سازی دستگاه مشخص‌شده توسط \fIVALUE\fP
.IP \(bu 2
\fB_disdev\fP \- غیرفعال‌سازی دستگاه مشخص‌شده توسط \fIVALUE\fP
.IP \(bu 2
\fB_swdev/{old_device}\fP \- تعویض دستگاه:
.INDENT 2.0
.IP \(bu 2
غیرفعال‌سازی \fIold_device\fP و سپس فعال‌سازی دستگاه مشخص‌شده توسط \fIVALUE\fP
.IP \(bu 2
در صورتی که هیچ دستگاهی فعال نبود، صرفاً بازمی‌گردد
.UNINDENT
.IP \(bu 2
\fB_enamod\fP \- فعال‌سازی تغییردهنده مشخص‌شده توسط \fIVALUE\fP
.IP \(bu 2
\fB_dismod\fP \- غیرفعال‌سازی تغییردهنده مشخص‌شده توسط \fIVALUE\fP
.IP \(bu 2
\fB_swmod/{old_modifier}\fP \- تعویض تغییردهنده:
.INDENT 2.0
.IP \(bu 2
غیرفعال‌سازی \fIold_modifier\fP و سپس فعال‌سازی تغییردهنده مشخص‌شده توسط \fIVALUE\fP
.IP \(bu 2
در صورتی که هیچ تغییردهنده‌ای فعال نبود، صرفاً بازمی‌گردد
.UNINDENT
.UNINDENT
.sp
توجه داشته باشید که شناسه‌های ارجاع‌دهنده به دستگاه‌ها و تغییردهنده‌ها تنها پس از تنظیم یک verb معتبر هستند.
.TP
.B \fBh\fP, \fBhelp\fP
راهنما
.TP
.B \fBq\fP, \fBquit\fP
خروج
.UNINDENT
.UNINDENT
.UNINDENT
.SH "فایل‌ها (FILES)"
.sp
فایل‌های اصلی سناریوی کاربرد برای هر کارت صدای پشتیبانی‌شده در مسیر \fB/usr/share/alsa/ucm\fP قرار دارند\&.
.sp
برای نمونه، فایل اصلی سناریوی کاربرد برای کارت \fIPandaboard\fP در مسیر \fB/usr/share/alsa/ucm/PandaBoard/PandaBoard.conf\fP قرار دارد؛ این فایل تمام سناریوهای کاربردی پشتیبانی‌شده را فهرست می‌کند، مانند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
SectionUseCase.\(dqHiFi\(dq {
                File \(dqhifi\(dq
                Comment \(dqPlay HiFi quality Music.\(dq
}
\&...
.EE
.UNINDENT
.UNINDENT
.sp
هر سناریوی کاربرد یک _verb تعریف می‌کند که در فایل مشخص‌شده در دستورالعمل \fBFile\fP (مانند بالا) توصیف شده است.
.sp
دستورالعمل \fBHiFi\fP بالا در مسیر \fB/usr/share/alsa/ucm/PandaBoard/hifi\fP توصیف شده است\&.
.sp
برای جزئیات بیشتر درباره ساختار نحوی فایل‌های UCM، سورس‌کد alsa\-lib را ببینید:
\%<http://\:git\:.alsa-project\:.org/?\:p=alsa-lib\:.git;a=blob;f=src/\:ucm/\:parser.c>
.SH "مثال‌ها (EXAMPLES)"
.sp
برخی دستورات، مانند \fBlist _devices\fP، تنها پس از تنظیم یک \fB_verb\fP در \fBهمان مرتبه اجرا\fP کار می‌کنند؛ برای مثال این توالی دستورات کار نمی‌کند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# alsaucm \-c bytcr\-rt5640 set _verb HiFi
# alsaucm \-c bytcr\-rt5640 list _devices
.EE
.UNINDENT
.UNINDENT
.sp
اما این دستور به درستی کار می‌کند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# alsaucm \-n \-b \- <<EOM
open bytcr\-rt5640
set _verb HiFi
list _devices
EOM
.EE
.UNINDENT
.UNINDENT
.sp
نمونه‌ای از تنظیم دستگاه \fISpeaker\fP برای verb مربوط به \fIHiFi\fP در کارت صدای \fIbytcr\-rt5640\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# alsaucm \-n \-b \- <<EOM
open bytcr\-rt5640
reset
set _verb HiFi
set _enadev Speaker
EOM
.EE
.UNINDENT
.UNINDENT
.SH "همچنین ببینید (SEE ALSO)"
.INDENT 0.0
.IP \(bu 2
رابط سناریوهای کاربرد: \%<http://\:www\:.alsa-project\:.org/\:alsa-doc/\:alsa-lib/\:group__ucm\:.html>
.UNINDENT
.SH "باگ‌ها (BUGS)"
.sp
مورد شناخته‌شده‌ای وجود ندارد.
.SH "نویسندگان (AUTHORS)"
Antonio Ospite <ao2@ao2.it>
.SH "حق نشر (COPYRIGHT)"
GPLv2+
.\" End of generated man page.