~ubuntu-branches/ubuntu/natty/lirc/natty

« back to all changes in this revision

Viewing changes to doc/html/lircd.html

  • Committer: Bazaar Package Importer
  • Author(s): Mario Limonciello, Jeremy Yoder, Mario Limonciello
  • Date: 2009-10-12 21:16:10 UTC
  • mfrom: (1.2.9 upstream)
  • Revision ID: james.westby@ubuntu.com-20091012211610-z63bnon17ahmxgd1
Tags: 0.8.6-0ubuntu1
[ Jeremy Yoder ]
* Update to LIRC 0.8.6 release. (LP: #432678)
  - added support for ENE KB3926 revision B/C/D (ENE0100) CIR port
    (found on some notebooks, e.g: Acer Aspire 5720G, HP Pavilion dv5)
    (Maxim Levitsky)
  - New parameter for lircd: --repeat-max
  - merged 1st-gen mceusb device support into lirc_mceusb2,
    renamed lirc_mceusb2 to lirc_mceusb
  - added support for putting iMON receviers into MCE/RC6 mode
  - added input subsystem mouse device support to iMON driver
  - improved iMON driver to handle dual-interface iMON devices
    via a single lirc device, reducing configuration complexity
  - added support for more iMON devices, including proper support
    for touchscreen iMON devices (Rene Harder)
  - improved iMON driver including touchscreen support
  - Linux input support added to lircmd
  - added support for IT8720 CIR port
  - added support for XMP protocol
* Cleanup more_remotes.hwdb
* TODO:  Make changes to the "lircd.conf.atiusb" and
  "lircd.conf.hauppauge" files PATCHES instead of duplicates
* TODO:  Submit "lircd.conf.atiusb" and
  "lircd.conf.hauppauge" file patches upstream again
* Changed lirc init script to create socket in /var/run/lirc/lircd
  as is the new default, but also create a symlink /dev/lircd
  to point to it.  This makes all clients happy, old and new.
* Fix bug in dkms.conf.in, forgot to increment array number
  when adding ene0100 driver.
* Added the extra "Debian-only" remotes and transmitters back
  in, but in a different way.  I created a subdirectory 
  "debian/extras" and copy that to /usr/share/lirc/extras.
  This avoids patching the source.
  NOTE: CONFIG FILES IN BOTH LOCATIONS WILL USE THE "extras"
  VERSION.  DUPLICATE LINES IN lirc.hwdb AND extras/remotes.hwdb
  WILL USE THE extras/remotes.hwdb VERSION.  TRY TO AVOID THIS.
* Added support to build new ene0100 driver
* Update debian/lircd.init.d to reflect new default
  PID location in /var/run/lirc
* Update debian/lircd.init.d to force socket to /dev/lircd
  rather than the new default of /var/run/lirc/lircd
* Add support for new lirc-extras package to
  debian/lirc.postinst
* Remove /etc/lircd.conf link to /etc/lirc since
  0.8.6 defaults to /etc/lirc/lircd.conf now
* Drop 04_man_pages patch, included in upstream
* Drop 16_lirc-gpio in favor of a sed line in debian/rules
* Drop 28_irrecord_resume_support - Doesn't work
  according to upstream
* Drop 36_remove_extra_tekram in favor of a minor
  tweak to debian/lirc.postinst to ignore duplicates
* Drop extra remote control/transmitter patches, move to lirc-extras:
  - 21_atiusb
  - 22_hauppauge_novat_500
  - 23_remove_md8800
  - 24_freecom_dvbt
  - 26_transmitter_lircd.conf
  - 30_medion_md1_remote
  - 31_hauppauge_hvr_1100
  - 32_radioshack_15_2116_remote
  - 33_asus_mycinema_remote
  - 34_nebula_digitaltv_remote
  - 35_general_deviniput
  - 37_msi_tv_anywhere
  - 38_encore_enltv
* Cleaned up a few lintian warnings

[ Mario Limonciello ]
* lirc.init.d:
  - Merge a bunch of whitespace cleanup from debian.
* control:
  - Merge whitespace cleanup from debian.
  - Drop breaks on udev.  We don't have any older version of udev in karmic.
* copyright:
  - Sync from debian.
* watch:
  - Sync from debian.
* links:
  - Don't link to a transmitterdb, this should be provided by lirc-extras.
* rules:
  - Install extra changelog, as mentioned in debian's debian/rules.
* dkms.conf.in:
  - Drop bashisms. (LP: #445175)
* lirc.postinst:
  - On upgrades from earlier versions, require the user to reconfigure
    their remote and transmitter.
* lirc-modules-source.postinst:
  - Update to use the DKMS common postinst template.
 

Show diffs side-by-side

added added

removed removed

Lines of Context:
37
37
<A NAME="lbAB">&nbsp;</A>
38
38
<H2>NAME</H2>
39
39
 
40
 
LIRC daemon - decodes infrared signals and provides them on a Unix
 
40
lircd - LIRC daemon decodes infrared signals and provides them on a Unix
41
41
domain socket.
42
42
<A NAME="lbAC">&nbsp;</A>
43
43
<H2>SYNOPSIS</H2>
48
48
<A NAME="lbAD">&nbsp;</A>
49
49
<H2>DESCRIPTION</H2>
50
50
 
51
 
The main task of lircd is to decode the infrared signals and provide an
52
 
uniform interface for client applications. Clients can connect to lircd
53
 
through a Unix domain socket which is located in /dev/lircd. Using this
54
 
socket they will get the infrared codes received by lircd and they can
55
 
send commands to lircd.
 
51
The main task of lircd is to decode the infrared signals and provide
 
52
an uniform interface for client applications. Clients can connect to
 
53
lircd through a Unix domain socket which is located in
 
54
/var/run/lirc/lircd.  Using this ocket they will get the infrared
 
55
codes received by lircd and they can send commands to lircd.
56
56
<DL COMPACT>
57
57
<DT><B>-h</B> <B>--help</B><DD>
58
58
display this message
61
61
<DT><B>-n</B> <B>--nodaemon</B><DD>
62
62
don't fork to background
63
63
<DT><B>-p</B> <B>--permission</B>=<I>mode</I><DD>
64
 
file permissions for /dev/lircd
 
64
file permissions for /var/run/lirc/lircd
65
65
<DT><B>-H</B> <B>--driver</B>=<I>driver</I><DD>
66
66
use given driver
67
67
<DT><B>-d</B> <B>--device</B>=<I>device</I><DD>
82
82
accept SIMULATE command
83
83
<DT><B>-u</B> <B>--uinput</B><DD>
84
84
generate Linux input events
 
85
<DT><B>-R</B> <B>--repeat-max</B>=<I>limit</I><DD>
 
86
allow at most this many repeats
85
87
</DL>
86
88
<A NAME="lbAE">&nbsp;</A>
87
89
<H2>OPTIONS</H2>
88
90
 
89
 
The --permission option gives the file permission of /dev/lircd if it
90
 
has to be created in octal representation. Read the documentation for
91
 
chmod for further details. If no --permission option is given when the
92
 
socket is initially created the default is to give all users read and
93
 
write permissions (0666 in octal representation). If /dev/lircd already
94
 
exists this option has no effect.
 
91
The --permission option gives the file permission of
 
92
/var/run/lirc/lircd if it has to be created in octal
 
93
representation. Read the documentation for chmod for further
 
94
details. If no --permission option is given when the socket is
 
95
initially created the default is to give all users read and write
 
96
permissions (0666 in octal representation). If /var/run/lirc/lircd
 
97
already exists this option has no effect.
95
98
<P>
96
 
With the --device option you can select the character device which lircd
97
 
should read from. The default currently is /dev/lirc but it probably
98
 
will change in future.
 
99
With the --device option you can select the character device which
 
100
lircd should read from. The default currently is /dev/lirc but it
 
101
probably will change in future.
99
102
<P>
100
103
If you're using the dev/input driver, you can use <I>name=STRING</I> or
101
104
<I>phys=STRING</I> to select the device; lircd will look in /dev/input
116
119
The connecting lircd instance will receive IR events from the lircd
117
120
instance it connects to.
118
121
<P>
119
 
With the --output option you can select Unix domain socket, which lircd
120
 
will write remote key codes to. The default currently is /dev/lircd.
 
122
With the --output option you can select Unix domain socket, which
 
123
lircd will write remote key codes to. The default currently is
 
124
/var/run/lirc/lircd.
121
125
<P>
122
126
With the --pidfile option you can select the lircd daemon pid file.
123
 
The default currently is /var/run/lircd.pid.
 
127
The default currently is /var/run/lirc/lircd.pid.
124
128
<P>
125
129
With the --logfile option you can select the lircd daemon log file.
126
130
The default currently is /var/log/lircd. Note that this option will
145
149
was given a button in the lircd config file, e.g. if the button is
146
150
named KEY_1, the '1' key code will be generated. You will find a
147
151
complete list of possible button names in /usr/include/linux/input.h.
 
152
<P>
 
153
The --repeat-max option sets an upper limit to the number of repeats
 
154
when sending a signal. The current default is 600. A SEND_START
 
155
request will repeat the signal this many times. Also, if the number of
 
156
repeats in a SEND_ONCE request exceeds this number, it will be
 
157
replaced by this number.
148
158
<A NAME="lbAF">&nbsp;</A>
149
159
<H2>FILES</H2>
150
160
 
151
161
<P>
152
 
The config file for lircd is located in /etc/lircd.conf. lircd
 
162
The config file for lircd is located in /etc/lirc/lircd.conf. lircd
153
163
has its own log file in /var/log/lircd (beginning with LIRC version
154
164
0.6.1 you can configure lircd to use syslogd for log messages; then it
155
165
depends on your system configuration where log messages will show up).
174
184
 
175
185
                <BR><BR>
176
186
                <CENTER>[<A HREF="http://www.lirc.org/">LIRC homepage</A>]<BR>
177
 
                  <I>The LIRC Manual, last update: 12-Oct-2008</I></CENTER>
 
187
                  <I>The LIRC Manual, last update: 24-May-2009</I></CENTER>
178
188
                <BR><BR>
179
189
              </TD>
180
190
              <TD WIDTH="15%">&#160;<BR></TD>