ir-keytable man page

ir-keytable — a swiss-knife tool to handle Remote Controllers.

Synopsis

ir-keytable [OPTION]... --device [/dev/input/event* device]
ir-keytable [OPTION]... --sysdev [ir class (f. ex. rc0)]
ir-keytable [OPTION]... [for using the rc0 sysdev]

Description

ir-keytable is a tool that lists the Remote Controller devices, allows one to get/set IR keycode/scancode tables, test events generated by IR, and to adjust other Remote Controller options.

Note: You need to have read permissions on /dev/input for most of the options to work.

Options

-a, --auto-load=CFGFILE
Auto-load a table, based on a configuration file. Only works with sysdev.
-c, --clear
clears the old table
-d, --device=DEV
ir device to control
-D, --delay=DELAY
Sets the delay before repeating a keystroke
-k, --set-key=SCANKEY
Change scan/key pairs
-p, --protocol=PROTOCOL
Protocol to enable (the other ones will be disabled). To enable more than one, use the option more than one time
-P, --period=PERIOD
Sets the period to repeat a keystroke
-r, --read
reads the current scancode/keycode table
-s, --sysdev=SYSDEV
ir class device to control
-t, --test
test if IR is generating events
-v, --verbose
enables debug messages
-w, --write=TABLE
write (adds) the scancodes to the device scancode/keycode table from the specified TABLE file
-?, --help
Prints the help message
--usage
Give a short usage message
-V, --version
print the v4l2-utils version

Mandatory or optional arguments to long options are also mandatory or optional for any corresponding short options. Options can be combined together.

The options arguments are

DEV
the /dev/input/event* device to control
SYSDEV
the ir class as found at /sys/class/rc
TABLE
a file wit a set of scancode=keycode value pairs
SCANKEY
a set of scancode1=keycode1,scancode2=keycode2.. value pairs
PROTOCOL
protocol name to be enabled (case insensitive). Supported protocols are: NEC, RC-5, RC-6, JVC, SONY, SANYO, LIRC, RC-5-SZ, SHARP, MCE-KBD, XMP, other, all.
DELAY
Delay before repeating a keystroke
PERIOD
Period to repeat a keystroke
CFGFILE
configuration file that associates a driver/table name with a keymap file

Exit Status

On success, it returns 0. Otherwise, it will return the error code.

Examples

To list all connected Remote Controller devices:
ir-keytable

To clean the keycode table and use a newer one:
ir-keytable -c -w /etc/rc_keymaps/nec_terratec_cinergy_xs

To append more codes to the existing table:
ir-keytable -w /etc/rc_keymaps/nec_terratec_cinergy_xs

To read the current keytable, on the second remote controller: ir-keytable -s rc1 -r

Bugs

Report bugs to Linux Media Mailing List <linux-media@vger.kernel.org>

Info

Fri Oct 3 2014 v4l-utils 1.10.0 User Commands