نام (NAME)

ir-keytable - ابزاری همه‌کاره برای کار با دستگاه‌های کنترل از راه دور

خلاصه دستور (SYNOPSIS)

ir-keytable [OPTION]...

توضیحات (DESCRIPTION)

دستور ir-keytable ابزاری است که دستگاه‌های کنترل از راه دور (Remote Controller) را فهرست می‌کند، نگاشت کلیدهای rc را بارگذاری می‌نماید، رویدادها را آزمایش می‌کند و سایر گزینه‌های کنترل از راه دور را تنظیم می‌کند.

به‌جای بارگذاری نگاشت کلید rc، همچنین می‌توان رمزگشاهای پروتکل را تنظیم کرد و نگاشت‌های scancode به keycode در rc را مستقیماً تعیین نمود.

نکته: برای عملکرد صحیح بیشتر گزینه‌ها، به دسترسی خواندن روی /dev/input نیاز دارید.

گزینه‌ها (OPTIONS)

-a, --auto-load=CFGFILE: بارگذاری خودکار نگاشت کلیدها، بر اساس یک فایل پیکربندی. تنها با --sysdev کار می‌کند.
-c, --clear: نگاشت‌های scancode به keycode را پاک می‌کند.
-D, --delay=DELAY: تاخیر پیش از تکرار فشرده شدن کلید را تنظیم می‌کند.
-k, --set-key=SCANKEY: نگاشت scancode به keycode را تنظیم می‌کند.
-p, --protocol=PROTOCOL: فهرست جداشده با کاما از پروتکل‌های هسته یا پروتکل BPF جهت فعال‌سازی. تمام پروتکل‌های دیگر غیرفعال می‌شوند.
-e, --parameter=PARAMETER: فهرست جداشده با کاما از پارامترهای پروتکل BPF.
-P, --period=PERIOD: دوره تناوب تکرار فشرده شدن کلید را تنظیم می‌کند.
-r, --read: نگاشت فعلی scancode به keycode را خوانده و نمایش می‌دهد.
-s, --sysdev=SYSDEV: دستگاه rc برای کنترل؛ در صورت عدم تعیین، مقدار پیش‌فرض rc0 است.
-t, --test: بررسی می‌کند که آیا دستگاه rc رویداد تولید می‌کند یا خیر.
-v, --verbose: پیام‌های اشکال‌زدایی را فعال می‌کند.
-w, --write=KEYMAP: پروتکل‌ها و نگاشت scancode به keycode را از فایل KEYMAP می‌خواند، و آن‌ها را روی دستگاه rc فعال می‌نماید.
-?, --help: پیام راهنما را چاپ می‌کند.
--usage: پیام کوتاه نحوه استفاده را ارائه می‌دهد.
-V, --version: نسخه v4l2-utils را چاپ می‌کند.

آرگومان‌های اجباری یا اختیاری برای گزینه‌های طولانی، برای گزینه‌های کوتاه متناظر نیز اجباری یا اختیاری هستند. گزینه‌ها می‌توانند با یکدیگر ترکیب شوند.

آرگومان‌های گزینه‌ها عبارتند از:

SYSDEV: دستگاه rc همان‌طور که در /sys/class/rc یافت می‌شود.
KEYMAP: یک فایل نگاشت کلید toml همراه با فهرستی از پروتکل‌ها و نگاشت‌های scancode به keycode. قالب آن در rc_keymap(5) شرح داده شده است.
SCANKEY: مجموعه‌ای از جفت‌مقادیر scancode1=keycode1,scancode2=keycode2..
PROTOCOL: فهرست جداشده با کاما از پروتکل‌های هسته جهت فعال‌سازی (غیرحساس به بزرگی و کوچکی حروف). پروتکل‌های پشتیبانی‌شده هسته عبارتند از: nec، rc-5، rc-6، jvc، sony، sanyo، rc-5-sz، sharp، mce-kbd، xmp، imon، rc-mm، other، all. همچنین می‌تواند یک پروتکل BPF باشد، مانند manchester، pulse_distance، pulse_length. اگر با هیچ‌کدام از این موارد مطابقت نداشته باشد، به عنوان مسیر بارگذاری رمزگشای BPF در نظر گرفته می‌شود.
PARAMETERS: فهرست جداشده با کاما از پارامترها برای پروتکل BPF در حال بارگذاری. آن‌ها قالب name=value دارند که در آن value یک عدد است.
DELAY: تاخیر پیش از تکرار فشرده شدن کلید.
PERIOD: دوره تناوب تکرار فشرده شدن کلید.
CFGFILE: فایل پیکربندی که یک نام درایور/نگاشت کلید را به یک فایل نگاشت کلید پیوند می‌دهد.

وضعیت خروج (EXIT STATUS)

در صورت موفقیت، مقدار 0 بازگردانده می‌شود. در غیر این صورت، کد خطا برگردانده خواهد شد.

مثال‌ها (EXAMPLES)

برای فهرست کردن تمام دستگاه‌های کنترل از راه دور متصل:
ir-keytable

برای پاک کردن نگاشت keycode و استفاده از نگاشت جدیدتر:
ir-keytable -c -w /etc/rc_keymaps/nec_terratec_cinergy_xs.toml

برای افزودن کدهای بیشتر به جدول موجود:
ir-keytable -w /etc/rc_keymaps/nec_terratec_cinergy_xs.toml

برای خواندن نگاشت فعلی scancode به keycode روی کنترل از راه دور دوم:
ir-keytable -s rc1 -r

برای فعال‌سازی پروتکل NEC و بارگذاری یک پروتکل BPF، همراه با پارامتری برای پروتکل BPF:
ir-keytable -p nec,pulse_distance -e pulse_header=9000

اگر نمی‌دانید کنترل از راه دور از چه پروتکلی استفاده می‌کند، آزمایش اولیه با فعال بودن تمام رمزگشاهای هسته می‌تواند کمک‌کننده باشد. پروتکل رمزگشایی‌شده و scancodeها در خروجی نمایش داده خواهند شد:
ir-keytable -c -p all -t

گزارش باگ‌ها (BUGS)

گزارش باگ‌ها را به Linux Media Mailing List <linux-media@vger.kernel.org> ارسال کنید.

کپی‌رایت و تکثیر (COPYRIGHT)

حق نشر (c) ۲۰۱۰-۲۰۱۴ متعلق به Mauro Carvalho Chehab.

مجوز GPLv2: گنو GPL نسخه ۲ http://gnu.org/licenses/gpl.html.
این نرم‌افزار آزاد است: شما در تغییر و توزیع مجدد آن آزاد هستید. هیچ ضمانتی وجود ندارد، تا حدی که قانون مجاز می‌داند.

همچنین ببینید (SEE ALSO)

قالب نگاشت کلید در rc_keymap(5) شرح داده شده است.

برای ارسال IR یا دریافت IR خام، ir-ctl(1) را ببینید.