LIRC: Difference between revisions
>Mkopp m (add categories) |
>Graysky (updated for consistent naming and added content) |
||
Line 1: | Line 1: | ||
==Lircmap.xml== | ==Lircmap.xml== | ||
=== | ===Definitions=== | ||
A custom Lircmap.xml is stored in the [[userdata]] directory. | '''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 a custom '''remote.xml''' which is discussed [[http://wiki.xbmc.org/?title=Keymap.xml elsewhere]]. | ||
'''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=== | ===File Format=== | ||
Line 8: | Line 15: | ||
<lircmap> | <lircmap> | ||
<remote device="devicename"> | <remote device="devicename"> | ||
< | <XBMC_button>LIRC_button</XBMC_button> | ||
... | ... | ||
</remote> | </remote> | ||
Line 14: | Line 21: | ||
====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" | 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 | There are two type of XBMC_buttons in XBMC. | ||
* Predefined Buttons are labeled using their button title such as: | * Predefined Buttons are labeled using their button title such as: | ||
Line 25: | Line 32: | ||
<menu> | <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]]. | 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; | * Customized buttons are for people who require more buttons than are defined by default. For example; |
Revision as of 10:44, 20 December 2009
Lircmap.xml
Definitions
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 a custom remote.xml which is discussed [elsewhere].
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 labeled 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
Lirc Configuration
Information
A complete Lirc configuration document is currently beyond the scope of this manual. More information on LIRC is available on the offical website www.lirc.org
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