ir−keytable − a swiss−knife tool to handle Remote Controllers.
ir−keytable is a tool that lists Remote Controller devices, loads rc keymaps, tests events, and adjusts other Remote Controller options.
Rather than loading a rc keymap, it is also possible to set protocol decoders and set rc scancode to keycode mappings directly.
Note: You need to have read permissions on /dev/input for most of the options to work.
Auto−load keymaps, based on a configuration file. Only works with −−sysdev.
Clears the scancode to keycode mappings.
Sets the delay before repeating a keystroke.
Set scancode to keycode mapping.
Comma separated list of kernel protocols or BPF protocol to enable. All other protocols are disabled.
Comma separated list of parameters for the BPF protocol.
Sets the period to repeat a keystroke.
Read and show the current scancode to keycode mapping.
rc device to control, defaults to rc0 if not specified.
test if the rc device is generating events
Enables debug messages.
Reads the protocols and scancode to keycode mapping from the KEYMAP file, and enables those on the rc device.
Prints the help message
Give a short usage message
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:
the rc device as found at /sys/class/rc
a toml keymap file with a list of protocols and scancodes to keycode mappings. The format is described in rc_keymap(5).
a set of scancode1=keycode1,scancode2=keycode2.. value pairs
Comma separated list of kernel protocols to be enabled (case insensitive). Supported kernel protocols are: nec, rc−5, rc−6, jvc, sony, sanyo, rc−5−sz, sharp, mce−kbd, xmp, imon, rc−mm, other, all. It can also be a BPF protocol, e.g. manchester, pulse_distance, pulse_length. If it does not match any of these, it is taken to be the path of BPF decoder to be loaded.
Comma separated list of parameters for the BPF protocol being loaded. They have the format of name=value, where value is an number.
Delay before repeating a keystroke
Period to repeat a keystroke
configuration file that associates a driver/keymap name with a keymap file
On success, it returns 0. Otherwise, it will return the error code.
To list all
connected Remote Controller devices:
To clean the
keycode mapping and use a newer one:
ir−keytable −c −w /etc/rc_keymaps/nec_terratec_cinergy_xs.toml
To append more
codes to the existing table:
ir−keytable −w /etc/rc_keymaps/nec_terratec_cinergy_xs.toml
To read the
current scancode to keycode mapping on the second remote
ir−keytable −s rc1 −r
To enable NEC
protocol and load a BPF protocol, with a parameter for the
ir−keytable −p nec,pulse_distance −e pulse_header=9000
If you do not
know what protocol a remote uses, it can be helpful to first
try with all kernel decoders enabled. The decoded protocol
and scancodes will be displayed in the output:
ir−keytable −c −p all −t
Report bugs to Linux Media Mailing List <[email protected]>
Copyright (c) 2010−2014 by Mauro Carvalho Chehab.
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.
The keymap format is described in rc_keymap(5).
To transmit IR or receive raw IR, see ir−ctl(1).