.TH "IR\-KEYTABLE" "1" "Fri Oct 3 2014" "v4l-utils 1.32.0" "User Commands"
.SH "نام (NAME)"
ir\-keytable \- ابزاری همه‌کاره برای کار با دستگاه‌های کنترل از راه دور
.SH "خلاصه دستور (SYNOPSIS)"
.B ir\-keytable
[\fIOPTION\fR]...
.SH "توضیحات (DESCRIPTION)"
دستور ir\-keytable ابزاری است که دستگاه‌های کنترل از راه دور (Remote Controller) را فهرست می‌کند،
نگاشت کلیدهای rc را بارگذاری می‌نماید، رویدادها را آزمایش می‌کند و سایر گزینه‌های کنترل از راه دور را تنظیم می‌کند.
.PP
به‌جای بارگذاری نگاشت کلید rc، همچنین می‌توان رمزگشاهای پروتکل را تنظیم کرد
و نگاشت‌های scancode به keycode در rc را مستقیماً تعیین نمود.
.PP
نکته: برای عملکرد صحیح بیشتر گزینه‌ها، به دسترسی خواندن روی /dev/input نیاز دارید.
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-a\fR, \fB\-\-auto\-load\fR=\fICFGFILE\fR
بارگذاری خودکار نگاشت کلیدها، بر اساس یک فایل پیکربندی. تنها با
\fB\-\-sysdev\fR کار می‌کند.
.TP
\fB\-c\fR, \fB\-\-clear\fR
نگاشت‌های scancode به keycode را پاک می‌کند.
.TP
\fB\-D\fR, \fB\-\-delay\fR=\fIDELAY\fR
تاخیر پیش از تکرار فشرده شدن کلید را تنظیم می‌کند.
.TP
\fB\-k\fR, \fB\-\-set\-key\fR=\fISCANKEY\fR
نگاشت scancode به keycode را تنظیم می‌کند.
.TP
\fB\-p\fR, \fB\-\-protocol\fR=\fIPROTOCOL\fR
فهرست جداشده با کاما از پروتکل‌های هسته یا پروتکل BPF جهت فعال‌سازی. تمام پروتکل‌های
دیگر غیرفعال می‌شوند.
.TP
\fB\-e\fR, \fB\-\-parameter\fR=\fIPARAMETER\fR
فهرست جداشده با کاما از پارامترهای پروتکل BPF.
.TP
\fB\-P\fR, \fB\-\-period\fR\=\fIPERIOD\fR
دوره تناوب تکرار فشرده شدن کلید را تنظیم می‌کند.
.TP
\fB\-r\fR, \fB\-\-read\fR
نگاشت فعلی scancode به keycode را خوانده و نمایش می‌دهد.
.TP
\fB\-s\fR, \fB\-\-sysdev\fR=\fISYSDEV\fR
دستگاه rc برای کنترل؛ در صورت عدم تعیین، مقدار پیش‌فرض \fIrc0\fR است.
.TP
\fB\-t\fR, \fB\-\-test\fR
بررسی می‌کند که آیا دستگاه rc رویداد تولید می‌کند یا خیر.
.TP
\fB\-v\fR, \fB\-\-verbose\fR
پیام‌های اشکال‌زدایی را فعال می‌کند.
.TP
\fB\-w\fR, \fB\-\-write\fR=\fIKEYMAP\fR
پروتکل‌ها و نگاشت scancode به keycode را از فایل \fIKEYMAP\fR می‌خواند،
و آن‌ها را روی دستگاه rc فعال می‌نماید.
.TP
\fB\-?\fR, \fB\-\-help\fR
پیام راهنما را چاپ می‌کند.
.TP
\fB\-\-usage\fR
پیام کوتاه نحوه استفاده را ارائه می‌دهد.
.TP
\fB\-V\fR, \fB\-\-version\fR
نسخه v4l2\-utils را چاپ می‌کند.
.PP
آرگومان‌های اجباری یا اختیاری برای گزینه‌های طولانی، برای گزینه‌های کوتاه متناظر نیز اجباری یا اختیاری هستند. گزینه‌ها می‌توانند با یکدیگر ترکیب شوند.
.SS آرگومان‌های گزینه‌ها عبارتند از:
.IP \fISYSDEV\fR
دستگاه rc همان‌طور که در /sys/class/rc یافت می‌شود.
.IP \fIKEYMAP\fR
یک فایل نگاشت کلید toml همراه با فهرستی از پروتکل‌ها و نگاشت‌های scancode به keycode.
قالب آن در rc_keymap(5) شرح داده شده است.
.IP \fISCANKEY\fR
مجموعه‌ای از جفت‌مقادیر scancode1=keycode1,scancode2=keycode2..
.IP \fIPROTOCOL\fR
فهرست جداشده با کاما از پروتکل‌های هسته جهت فعال‌سازی (غیرحساس به بزرگی و کوچکی حروف).
پروتکل‌های پشتیبانی‌شده هسته عبارتند از: \fBnec\fR، \fBrc\-5\fR، \fBrc\-6\fR، \fBjvc\fR،
\fBsony\fR، \fBsanyo\fR، \fBrc\-5\-sz\fR، \fBsharp\fR، \fBmce\-kbd\fR،
\fBxmp\fR، \fBimon\fR، \fBrc\-mm\fR، \fBother\fR، \fBall\fR. همچنین می‌تواند یک پروتکل BPF باشد،
مانند \fBmanchester\fR، \fBpulse_distance\fR، \fBpulse_length\fR.
اگر با هیچ‌کدام از این موارد مطابقت نداشته باشد، به عنوان مسیر بارگذاری رمزگشای BPF
در نظر گرفته می‌شود.
.IP \fIPARAMETERS\fR
فهرست جداشده با کاما از پارامترها برای پروتکل BPF در حال بارگذاری. آن‌ها قالب name=value دارند که در آن value یک عدد است.
.IP \fIDELAY\fR
تاخیر پیش از تکرار فشرده شدن کلید.
.IP \fIPERIOD\fR
دوره تناوب تکرار فشرده شدن کلید.
.IP \fICFGFILE\fR
فایل پیکربندی که یک نام درایور/نگاشت کلید را به یک فایل نگاشت کلید پیوند می‌دهد.
.SH "وضعیت خروج (EXIT STATUS)"
در صورت موفقیت، مقدار 0 بازگردانده می‌شود. در غیر این صورت، کد خطا برگردانده خواهد شد.
.SH "مثال‌ها (EXAMPLES)"
برای فهرست کردن تمام دستگاه‌های کنترل از راه دور متصل:
.br
	\fBir\-keytable\fR
.PP
برای پاک کردن نگاشت keycode و استفاده از نگاشت جدیدتر:
.br
	\fBir\-keytable \-c \-w /etc/rc_keymaps/nec_terratec_cinergy_xs.toml\fR
.PP
برای افزودن کدهای بیشتر به جدول موجود:
.br
	\fBir\-keytable \-w /etc/rc_keymaps/nec_terratec_cinergy_xs.toml\fR
.PP
برای خواندن نگاشت فعلی scancode به keycode روی کنترل از راه دور دوم:
.br
	\fBir\-keytable \-s rc1 \-r\fR
.PP
برای فعال‌سازی پروتکل NEC و بارگذاری یک پروتکل BPF، همراه با پارامتری برای پروتکل BPF:
.br
	\fBir\-keytable \-p nec,pulse_distance \-e pulse_header=9000\fR
.PP
اگر نمی‌دانید کنترل از راه دور از چه پروتکلی استفاده می‌کند، آزمایش اولیه با فعال بودن
تمام رمزگشاهای هسته می‌تواند کمک‌کننده باشد. پروتکل رمزگشایی‌شده و scancodeها در خروجی
نمایش داده خواهند شد:
.br
	\fBir\-keytable \-c \-p all \-t\fR

.SH "گزارش باگ‌ها (BUGS)"
گزارش باگ‌ها را به \fBLinux Media Mailing List <linux-media@vger.kernel.org>\fR ارسال کنید.
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
حق نشر (c) ۲۰۱۰\-۲۰۱۴ متعلق به Mauro Carvalho Chehab.
.PP
مجوز GPLv2: گنو GPL نسخه ۲ <http://gnu.org/licenses/gpl.html>.
.br
این نرم‌افزار آزاد است: شما در تغییر و توزیع مجدد آن آزاد هستید.
هیچ ضمانتی وجود ندارد، تا حدی که قانون مجاز می‌داند.
.SH "همچنین ببینید (SEE ALSO)"
قالب نگاشت کلید در rc_keymap(5) شرح داده شده است.
.PP
برای ارسال IR یا دریافت IR خام، ir\-ctl(1) را ببینید.