LIRC: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
>NedBot
m (Robot: Cosmetic changes)
(http://wiki.xbmc.org/index.php?title=Lirc&oldid=50158)
Line 1: Line 1:
{{Keyboard navigation}}
{{Keyboard navigation}}
{{cleanup}}
<section begin="intro" />LIRC is software that allows you to decode and send infra-red signals of most commonly used remote controls.<section end="intro" />
 
* http://www.lirc.org/
 
== lircmap.xml ==
 
'''A custom Lircmap.xml''' - This file merely defines the translation, bridging a '''LIRC_button''' to a '''XBMC_button'''. The file is literally named '''Lircmap.xml''' and is stored in the [[userdata]] directory. Do not confuse the '''Lircmap.xml''' with [[Keyboard.xml]].
'''A custom Lircmap.xml''' - This file merely defines the translation, bridging a '''LIRC_button''' to a '''XBMC_button'''. The file is literally named '''Lircmap.xml''' and is stored in the [[userdata]] directory. Do not confuse the '''Lircmap.xml''' with [[Keyboard.xml]].


Line 11: Line 16:
This information can be had using the test application "irw" and then hitting some buttons. More on this in the [[Lirc and Lircmap.xml#Testing Lirc Output]] section below.
This information can be had using the test application "irw" and then hitting some buttons. More on this in the [[Lirc and Lircmap.xml#Testing Lirc Output]] section below.


=== File Format ===
=== File format ===
Lircmap.xml format is as follows:
Lircmap.xml format is as follows:


Line 21: Line 26:
   </lircmap>
   </lircmap>


==== Device Name ====
==== Device name ====
The device name is defined in your lircd.conf file in the "name" field. This information can be had using the test application "irw" and then hitting some buttons. More on this in the [[Lirc and Lircmap.xml#Testing Lirc Output]] section below.
The device name is defined in your lircd.conf file in the "name" field. This information can be had using the test application "irw" and then hitting some buttons. More on this in the [[Lirc and Lircmap.xml#Testing Lirc Output]] section below.


==== XBMC_Button Names ====
==== XBMC button names ====
There are two type of XBMC_buttons in XBMC.  
There are two type of XBMC_buttons in XBMC.  


Line 44: Line 49:


  FYI : obc stands for original button code and is a legacy of the old xbox IR remote system
  FYI : obc stands for original button code and is a legacy of the old xbox IR remote system
== Lirc Configuration ==
=== Information ===
A complete Lirc configuration document is currently beyond the scope of this manual. More information on LIRC is available on the official website www.lirc.org


=== Testing Lirc Output ===
=== Testing Lirc Output ===
Line 71: Line 72:
[[Category:Linux]]
[[Category:Linux]]
[[Category:Remotes]]
[[Category:Remotes]]
[[Category:XBMC Manual]]
[[Category:Supplemental tools]]

Revision as of 02:58, 6 November 2013

Template:Keyboard navigation LIRC is software that allows you to decode and send infra-red signals of most commonly used remote controls.

lircmap.xml

A custom Lircmap.xml - This file merely defines the translation, bridging a LIRC_button to a XBMC_button. The file is literally named Lircmap.xml and is stored in the userdata directory. Do not confuse the Lircmap.xml with Keyboard.xml.

LIRC_Button - what your lircd.conf calls the physical button on your remote control.

XBMC_button - an XBMC internal button title.

device name - is defined in your lircd.conf file in the "name" field.

This information can be had using the test application "irw" and then hitting some buttons. More on this in the Lirc and Lircmap.xml#Testing Lirc Output section below.

File format

Lircmap.xml format is as follows:

  <lircmap>
       <remote device="devicename">
               <XBMC_button>LIRC_button</XBMC_button>
               ...
       </remote>
  </lircmap>

Device name

The device name is defined in your lircd.conf file in the "name" field. This information can be had using the test application "irw" and then hitting some buttons. More on this in the Lirc and Lircmap.xml#Testing Lirc Output section below.

XBMC button names

There are two type of XBMC_buttons in XBMC.

  • Predefined Buttons are labelled using their button title such as:
  <left>
  <right>
  <title>
  <menu>

These buttons are predefined in keymap.xml and handle all functions needed for a working system. For a complete list of buttons see keymap.xml#Remote Buttons.

  • Customized buttons are for people who require more buttons than are defined by default. For example;
  <obc1>BUTTON1</obc1>
  ...
  <obc254>BUTTON254</obc254>
Note : These obc buttons must be defined in keymap.xml under the [[<universalremote>]] heading
FYI : obc stands for original button code and is a legacy of the old xbox IR remote system

Testing Lirc Output

use the command 'irw' to test your LIRC configuration

  xbmc@xbmclinux:~$ irw
  0000000000040004 00 ARROW_UP Cyp_Se_WitheHome
  0000000000040004 00 VOLUME_UP Cyp_Se_WitheHome
  0000000000040004 00 NUMPAD_6 Cyp_Se_WitheHome
  0000000000040004 00 INFO Cyp_Se_WitheHome

In this example Cyp_Se_WitheHome is the device name ARROW_UP, VOLUME_UP, NUMPAD_6, INFO are button names

If you wish to redefine the button names it can be done in /etc/lircd.conf

Examples