There are various sources of information you should check before writing mails directly to me. Please read the LIRC homepage carefully and have a look at the FAQ.

If your question is not answered there try the LIRC mailing list. Before posting to the list check the mailing list archive for an answer.

Reporting bugs

If you believe that you have found a bug in LIRC your bug report should contain the following information:

  • LIRC version, versions of all other packages involved
  • description of the IR hardware you are using
  • Are you using a SMP machine?
  • output of ls -l /dev/lirc*
  • output of lsmod
  • relevant passages from /var/log/messages
  • contents of lircd's logfile /var/log/lircd
    Compile LIRC in debug mode. A new command line option (-d[debug_level]) will become available for lircd. The debug level (0 to 5) will control how much additional debug output will be displayed. But be careful with this. After some extensive debug sessions I once discovered that my logfile was using 110 MBytes of disk space. :-)
  • a description of the problem so I can reproduce it
  • a patch that solves the problem (this one is optional)
  • the config files you are using (lircd.conf, lircmd.conf, .lircrc)
  • If you have problems with a config file try to find the shortest example that does not work as one would expect and include it.

If you have problems with one of the TV card drivers you should write to the according authors directly. You will find their email addresses in the source code and at the developers page.

Adding new remote controls

The following description was written having receivers in mind that deliver IR signals as pulses and spaces. So some of this will not be relevant for receivers that work at a higher abstraction layer as e.g. the Irman or TV card receivers.

There already is a growing database of config files for remote controls available at the LIRC homepage. But if your remote control is not available yet you can use irrecord to create a config file for your remote control. If you want to use more than one remote control you have to create a separate file for each remote. If your remote control is able to control different devices it is often wise to create separate config files for each functional unit of the remote control. You can later use a single config file for lircd by simply merging the config files with cat config1 config2 >lircd.conf.

Before using irrecord you should start mode2 and have a look at the signals that your receiver supplies. If you can see random pulses without pushing any buttons of your remote control your receiver is picking up ambient light. So if your receiver has no ambient light filter try to add one. A good strategy might also be to create a config file in a dark room and to turn off all fluorescent lamps or any other devices that may cause IR noise.

If decoding of IR commands does not work reliably you can try to modify the eps and aeps values in the lircd config file to adjust the tolerance of signal lengths. aeps is an absolute value while eps is a relative value expressed in percent. Also if repeats do not work you should complain. I.e. if you hold down a button the output of irw should look like this.

        0000000000f40bf0 00 1_DOWN ANIMAX
        0000000000f40bf0 01 1_DOWN ANIMAX
        0000000000f40bf0 02 1_DOWN ANIMAX
        0000000000f40bf0 03 1_DOWN ANIMAX
        0000000000f40bf0 04 1_DOWN ANIMAX
        0000000000f40bf0 05 1_DOWN ANIMAX

Note how the second field gets incremented. Many people don't even notice if this does not work correctly.

If you want to use a config file to send IR commands you should try to vary the modulation frequency of the signals. The default frequency is 38000 Hz. It cannot be detected automatically because the receiver hardware only gives us the demodulated signals. Using the correct modulation frequency will increase range significantly. You can set the modulation frequency for a remote control by adding the line

        frequency <freq>

to the according section of the config file where freq stands for the modulation frequency in Hertz. Usually values from 34000 to 44000 are good choices.

As creating new config files is difficult sometimes and irrecord often cannot detect all features of the remote control please send new config files to lirc@bartelmus.de. Other people will appreciate this very much. Sometimes they cannot create such a config file themselves because their original remote control is broken or has been lost. Some devices that are capable of IR come without a remote control. Some people also only want to build a transmitter and if you make a config file available for them they won't need to build a receiver, too. Please add all information you can get concerning the remote control as a comment to the config file.

If you still have difficulties to create a working config file send a message to the mailing list or file a ticket at the lirc sourceforge space You need to provide the following info:

  • version of LIRC that you are using
    Check if you are using the current version and if there already is a config file for your remote control.
  • description of your problem
  • config file created by irrecord, if available
  • output of irrecord in DEBUG mode (you can compile LIRC in DEBUG mode by selecting this feature in the Software configuration section of the setup program or by adding --enable-debug to the configure script command line)
  • output of mode2
    Make sure you hold down some buttons for a while so that repeat codes will be visible. Do NOT edit this output. Just submit it, preferably as an attachment to a ticket or as an url using pastebin.com or so

I won't be able to answer any emails that do not contain the necessary information!

[LIRC homepage]
The LIRC Manual, last update: 10-June-2014