xmode2(1)

1MODE2(1)                         User Commands                        MODE2(1)
2
3
4

NAME

6       xmode2 - Show the pulse/space length of infrared signals
7

SYNOPSIS

9       xmode2 [options]
10
11

DESCRIPTION

13       The main purpose of xmode2 is to check operation of your home-brew LIRC
14       receiver hardware and to see the IR waveform of the  remote  controller
15       without an expensive oscilloscope. Very useful for debugging. Of course
16       this program won't work with hardware that decodes the  signals  itself
17       like   e.g.   TV  cards  or  the  Irman  i.  e.,  it  only  works  with
18       LIRC_MODE_MODE2 type drivers.
19
20       xmode2 prints a simple graphics display of the pulse/space lengths.  It
21       accepts  a  few commands including time base changes; see the xmode2 -h
22       output.
23
24       lirc-lsplugins(1) allows checking if a driver is a LIRC_MODE2 type one.
25
26
27

OPTIONS

29       -h --help
30              display usage summary
31
32       -v --version
33              display version
34
35       -d --device=device
36              read from given device
37
38       -H --driver=driver
39              use given driver
40
41       -m --mode
42              enable alternative display mode
43
44       -r --raw
45              access device directly
46
47

RUNNING AS ROOT

49       In many cases xmode2 needs to run as root to access devices not  avail‐
50       able to regular users. On the other hand, running as root creates prob‐
51       lems such as log files owned by root, security concerns etc.
52
53       In order to cope with this, xmode2 by  default  drops  root  privileges
54       after opening the input device. This support is based on that root per‐
55       missions are acquired using sudo(1) e. g., using
56
57               $ sudo xmode2 --driver default --device /dev/lirc0
58
59       If not using sudo, the same behaviour could be accomplished  using  the
60       SUDO_USER environment variable e. g.,
61
62               # SUDO_USER=$LOGNAME xmode2 --raw /dev/lirc0
63
64       The  --keep-root  option will make xmode2 keep it's root privileges for
65       the complete run.
66
67
68

DRIVER LOADING

70       Drivers are loaded dynamically. The search path used for this is deter‐
71       mined by (falling priority):
72
73       - The --plugindir option.
74
75       - The    'plugindir'   entry   in    the   [lircd]   section   of   the
76         lirc_options.conf file.
77
78       - The environment variable LIRC_PLUGINDIR.
79
80       - A hardcoded default (usually /usr/lib[64]/lirc/plugins).
81
82

FILES

84       ~/.cache/xmode2.log
85           Debug output. Setting the XDG_CACHE_HOME environment variable relo‐
86           cates this file to $XDG_CACHE_HOME/mode2.log
87
88