IR-KEYTABLE(1)                   User Commands                  IR-KEYTABLE(1)

نام (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) را ببینید.

v4l-utils 1.32.0                Fri Oct 3 2014                  IR-KEYTABLE(1)