table of contents
| IR-KEYTABLE(1) | User Commands | IR-KEYTABLE(1) |
NAME¶
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 (nec, rc-5, rc-6, other) to be enabled
- 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 Mauro Carvalho Chehab <mchehab@redhat.com>
COPYRIGHT¶
Copyright (c) 2010-2011 by Mauro Carvalho Chehab <mchehab@redhat.com>.
License GPLv2: GNU GPL version 2
<http://gnu.org/licenses/gpl.html>.
This is free software: you are free to change and redistribute it. There is NO
WARRANTY, to the extent permitted by law.
| January 2011 | v4l-utils |