✎ lirc_brouillon [Wiki ubuntu-fr]

Vous affichez une ancienne révision du document ! Si vous l'enregistrez, vous créerez une nouvelle version avec ce contenu.

<note important> Traduction en cours</note>

----

====== Lirc - installation & maintenance ======

===== Description =====

Lirc permet d'utiliser une télécommande infrarouge. Presque toutes (mais pas toutes) sont compatibles.

FIXME à traduire
> LIRC has improved in Ubuntu 6.10 over how it was in Ubuntu 6.06.
> The default Lirc init scripts are properly setup to handle a single device, but the driver build scripts can handle multiple devices.  If you are looking to set up an IR transmitter and a receivers, multiple transmitters, or multiple receivers, set up a Single Device and verify functionality.  Afterwords, continue on to the setting up multiple devices section.

proposition de traduction (par zetotof, je passais par là. Je signalerais ça -> mailing list)

>Comparé à la version 6.06 d'ubuntu, LIRC s'est nettement amélioré.
>Par défaut, Les scripts d'initialisation de LIRC sont correctement configurés pour la gestion d'un seul appareil, mais en réalité les scripts du pilote peuvent en gérer plusieurs. Si vous cherchez à configurer un transmetteur infrarouge et un recepteur, plusieurs transmetteurs, ou plusieurs recepteurs, commencez d'abord par configurer un seul appareil et vérifiez son bon fonctionnement. Après cela seulement, vous pourrez vous intéresser à la section traitant la configuration de multiples appareils.

Ce tutorial explique comment configurer lirc avec le pilote "lirc_mceusb". C'est un exemple, si vous souhaiter utiliser lirc avec un autre type de récepteur, vous pouver le compiler directement avec un autre pilotes (pour certain récepteur vous trouverez des informations complémentaire [[#information supplémentaires|en bas de cette page]]).

===== Installation et configuration pour une télécommande =====

==== Prérequis ====

Avant de commencer l'installation assurez-vous que les dépots universe, multiverse et backports sont activés (voir la page [[:dépots]]).

Commencez par [[:tutoriel:comment_installer_un_paquet|Installer les paquets]] **lirc lirc-modules-source module-assistant**.

<note>
**1)** Certaines télécommandes sont directement supportées par le kernel voir la section "[[#managed i2c devices]]".\\
**2)** Pour les récepteurs des cartes hauppage PVR-150 voir voir la section "[[#récepteur IR de PVR-150]]"
</note>

==== Configurer lirc-modules-source ====

Durant la configuration du modules lirc vous devrez sélectionner le type de récepteur infra rouge que vous allez utiliser.

sudo dpkg-reconfigure lirc-modules-source

|Informations diverses sur les périphériques IR supporté. (Flèche //haut/bas// pour faire défiler). \\ Sélectionner OK grâce à la touche de //tabulation// (->)|{{lirc:info_modules.png?320}}|
|Sélectionnez le/les module(s) que vous souhaitez configurer. Pour certain modules consultez les [[#informations supplémentaires]] (comme pour les récepteurs sur port série et les FIXME ??? adaptateur port série ???). \\ Pour les  PVR-150 sélectionnez ''i2c'' et ''PVR150'' \\ (//Haut/bas// pour naviguer; //barre espace// pour sélectionner; //tabulation// pour "<OK>")|{{lirc:select_modules.png?320}}|
|Le script vous propose de compiler automatiquement les modules. Sélectionnez **non**.|{{lirc:autoconstruct.png?320}}|
|Vous avez maintenant différentes options pour remplacer le fichier ''lirc-modules-source.conf''. Sélectionnez **Installer la version du responsable  du paquet**.|{{lirc:replace_modules-source_dot_conf.png?320}}|

=== Modification /etc/lirc/hardware.conf ===

[[:tutoriel:comment_editer_un_fichier|Éditez le fichier]] **/etc/lirc/hardware.conf** avec les droits administrateurs.

> [[utilisateurs:Jonas]] : Le fichier n'existait pas quand quand j'ai voulu l'éditer. J'ai alors lancé ''lircd'' dans un consoles et je les stoppé ce qui à crée le fichier.

* Modifiez ''LOAD_MODULES=false'' en ''LOAD_MODULES=true''.
  * Remplissez la section MODULES avec le nom de votre module entre guillemets, préfixé de l'acronyme "''lirc_''" ( par exemple pour le pilote ''mceusb'', mettez "''lirc_mceusb''").
  * Pour les récepteurs des cartes PVR-150:
<code>
LIRCD_ARGS="--device=/dev/lirc0" 
LOAD_MODULES=true
MODULES="lirc_dev lirc_pvr150"
</code>

[[:lirc - exemples "hardware.conf"]]

==== Compilation des modules lirc ====

<note important>
Les modules lirc ont besoin d'être recompilé à chaque mise à jours du noyaux.\\ Voir la section "[[#Reconstruction_des_modules]]" pour plus d'information.
</note>

FIXME (traduire) This step will grab the necessary headers to build the kernel modules:
>(proposition par zetotof)
>Cette étape va préparer les fichiers d'en-tête nécessaire à la compilation des modules noyau

sudo m-a update,prepare

Nettoyez le système ancienne version du module lirc
  sudo rm /usr/src/lirc*deb
  sudo m-a clean lirc

Compilez et installez les modules du kernel
  sudo m-a a-i lirc

Mettez à jours la liste des modules
  sudo depmod -a

==== Le fichier lircd.conf ====

Le fichier ''lircd.conf'' liste les correspondances entre le signal IR et la fonction de la touche. Il existe deux façon de créer le fichier ''lircd.conf''.
  * Trouver un fichier déjà fait pour votre télécommande.
  * Créer votre propre fichier

=== Utiliser un fichier lircd.conf existant ===

* Vous pouvez chercher le fichier de configuration pour votre télécommande [[http://lirc.sourceforge.net/remotes/|ici]].
  * [[:tutoriel:comment_editer_un_fichier|Éditez le fichier]] **/etc/lirc/lircd.conf** et remplacer sont contenu par celui trouvé précédemment.

(Si vous avez trouvé un fichier de configuration sautez la section suivante.)

=== Créer son fichier lircd.conf ===

FIXME à compléter/vérifier avec attention

Si vous souhaitez créer votre propre fichier ou que vous n'avez pas trouvé de fichier déjà fait pour votre télécommande. Vous pouvez utilisez ''irrecord''

Insérez le modules que vous venez de compiler.
> Insert the module that you have just built and intend to record from.

Exemple:
  sudo modprobe lirc_mceusb

S'il il y a une erreur au chargement du module, 
>(proposition de zetotof)
>cela pourait être parce que le module assistant m-a a ignoré le pilote spécial i2c.
Forcez l'installation puis réessayez le chargement du module.
> If this fails, it might be because the m-a ignored the special i2c module.  Force it to load, then try the modprobe command again:

sudo dpkg -i /usr/src/lirc-modules-2.6.*.deb
  sudo modprobe lirc_mceusb

Pour enregistrer les touche de votre télécommande
  sudo irrecord -d /dev/lirc0 lircd.conf

Une fois l'enregistrement des touche terminé, déplacez votre fichier dans ''/etc/lirc/lircd.conf''.
  sudo mv lircd.conf /etc/lirc

=== Démarrage de Lirc et test ===

Les modules seront chargés au démarrage de lirc. Démarrez lirc puis irw (l'utilitaire de test):
  sudo /etc/init.d/lirc start
  irw

Le terminal ne doit se mettre en "attente" (on ne peut plus taper de commande). Appuyez sur les touches de votre télécommandes, elles devraient s'afficher dans le terminal. Pour quitter pressez <ctrl> + 'C'.

Si irw se termine immédiatement (vous pouvez taper une commande après le lancement de celui-ci) c'est que le module ne c'est pas chargé correctement. Essayez de redémarrer votre ordinateur. Si ça ne fonctionne toujours pas, regardez si le modules c'est bien chargé grâce la commande ''dmesg | grep lirc''.

Si au lancement de lirc vous avez ceci :
<code>
$ sudo /etc/init.d/lirc start
##################################################
## LIRC IS NOT CONFIGURED ##
## ##
## read /usr/share/doc/lirc/html/configure.html ##
##################################################
</code>
C'est que vous n'avez pas bien créé votre ''lircd.conf''. Retournez à la section   "[[#création du fichier lircd.conf]]".

==== Création du fichier .lircrc ====

Le fichier ''~/.lircrc'' indique ce que les boutons déclenche.

=== Méthode standard ===

[[:tutoriel:comment_editer_un_fichier|Créer le fichier]] ''.lircrc'' en utilisateur.

La syntaxe basic pour l'action d'une touche est
<code>
begin
    prog = PROGRAME
    button = BOUTONS
    config = ACTION
end
</code>

Où :
  * ''PROGRAME'' Est le programe qui va utiliser ce boutons, par exemple : ''PROGRAME'' sera '''mythtv''', '''mplayer''', '''xine''', '''vlc''', ou '''irexec'''.
  * ''BOUTONS'' est le nom du boutons qui se trouve dans ''/etc/lirc/lircd.conf''.
  * ''ACTION'' est l'action qui sera lancer quand on presse sur le boutons.

Vous pourrez trouver des fichiers d'exemples sur [[https://help.ubuntu.com/community/Install_Lirc_Edgy#head-c3cababa402d7e016b14d54d58c481591a54bdd1le|cette page]] (Mais en cherchant un peut sur internet vous trouverez certainement un fichier plus adapter à votre utilisation)

Pour des informations plus détailler sur ce fichier, consultez [[http://www.lirc.org/html/configure.html#lircrc_format|la documentation de lirc sur son site]] (en anglais).

=== Méthode alternative - IRKick ===

Si vous êtres un utilisateur de KDE vous pouvez vous servir de IRKick.

>FIXME Jonas : Je n'utilise pas KDE, est-ce que IRKick a besoin de toutes ces explication ? 
>If you're a KDE user, you may find it more convenient to set up functionality using irkick. This requires you already have your lircd.conf and hardware.conf set up, but you won't need an lircrc file if you take this approach.

[[:tutoriel:comment_installer_un_paquet|Installez les paquets]] **lirc-x kdelirc**.

>Next, start up IRKick - It's in the Utilities menu.
>
>IRKick contains extensions to easily setup the remotes functions with Amarok, Kaffeine, Noatun, and Konqueror, but can be made to perform any terminal command or dcop call.
>
>To add functionality for a button - just click add (on the right-hand side).
>To add a new mode for the remote, click on the left add and give it an appropriate name. Note: when adding a new mode, you'll also need to assign a button to switch to that mode. This allows you to have buttons do different things in different modes. Select the mode on the left before adding new functions for buttons.
>
>Click apply when you're done making changes, and that's it, no configuration files to play with :)

=== Note spécifique pour quelques applications utilissant lirc ===

Une multitude d'application peuvent se servir de lirc. Vous pouvez séparez les actions de ces différentes applications dans les fichier .lircrc en créant des bloc débutant pas ''begin'' et finissant pas ''end''.

== MythTV ==

Si vous utilisez mythtv, vous aurez besoin de créer un fichier réservé à mythtv dans ''~/.mythtv/lircrc'' ou de créer un lien symbolique vers votre fichier ''~/.lircrc''.

== IRexec ==

IRexec permet de lancer un application sur la pression d'une touche. La syntaxe est la suivante :

<code>
begin
    prog = irexec
    button = BOUTONS
    config = APPLICATION
end
</code>
Où APPLICATION est le chemin vers l'executable à lancer.

===== Configuration et installation pour plusieurs télécommandes =====

Une fois que lirc fonctionne avec une télécommande vous pouvez modifier la configuration pour supporter des télécommandes supplémentaires.

<note info>
Cette section n'a pas encore été traduite car elle s'adresse à un nombre d'utilisateur bien moins important.\\
Mais si vous avez du temps à consacré a cette traduction n'hésitez pas !
</note>

After you have proven LIRC works with a single device, you can modify your scripts to include support for multiple devices.  The first thing you will have to make sure you have kernel modules for the additional devices.  If during the single device setup, you built modules for all the devices you thought you would need, you can skip  the next step.

==== Build Additional Modules ====
 * Clear our any old module builds
  sudo rm /usr/src/lirc*deb
  sudo m-a clean lirc

* Stop lirc & unload any loaded modules.
  sudo /etc/init.d/lirc stop
  sudo rmmod LOADED_LIRC_MODULES
  * Replace LOADED_LIRC_MODULES with any lirc modules you have loaded.

* Reconfigure lirc-modules-source.  Choose all modules you will need (including those previously chosen)
  sudo dpkg-reconfigure lirc-modules-source

* Build/install the kernel modules
  sudo m-a a-i lirc

* If you get a message that it won't reinstall an already installed version, you can force installation.
  sudo dpkg -i /usr/src/lirc*deb

==== Modify Init Scripts ====
 * Modify {{{/etc/lirc/hardware.conf}}}
  * Make sure that all of your modules are now added to the list of MODULES="".  Take note of the order you provide these modules.  This will be the order that lirc recognizes the devices, and important if you are going to need to differentiate between different lirc devices.
  * Modify LIRCD_ARGS="" to match
<code>
LIRCD_ARGS="--device=/dev/lirc0 --output=/dev/lircd1 --pidfile=/var/run/lircd1.pid --listen"
LIRCD2_ARGS="--device=/dev/lirc1 --output=/dev/lircd --pidfile=/var/run/lircd.pid --connect=localhost:8765"
</code>

* Modify {{{/etc/init.d/lirc}}}
  * Change this block:
<code>
      LIRCD_ARGS=`build_args $LIRCD_ARGS`
      start-stop-daemon --start --quiet --exec /usr/sbin/lircd -- $LIRCD_ARGS \
                < /dev/null
</code>
To be:
<code>
      LIRCD_ARGS=`build_args $LIRCD_ARGS`
      LIRCD2_ARGS=`build_args $LIRCD2_ARGS`
      start-stop-daemon --start --quiet --exec /usr/sbin/lircd -- $LIRCD_ARGS \
                < /dev/null
      /usr/sbin/lircd $LIRCD2_ARGS \
               < /dev/null
</code>

* If you have more then 2 LIRC devices, you will need to add additional blocks to {{{/etc/lirc/hardware.conf}}} and {{{/etc/init.d/lirc}}} to connect to the main lirc process.

==== Test ====

* Start lirc
  sudo /etc/init.d/lirc start

* You should have two lircd processes running.  You will need to provide a parameter to any lirc process trying to interact with lircd now to indicate which lircd you want to interact with.

===== Informations complémentaires =====

==== Périphériques supportés ====

Ces pilotes supporte :
 * lirc_pvr150
 * lirc_serial
 * lirc_mceusb2

==== Managed I2C Devices ====
Ubuntu Edgy introduces support in the kernel to directly manage some remotes via the i2c bus.  For remotes like this, the kernel is deprecating the use (and requirement) of lirc.  You should be able to press keys on the remote and have them recognized as ordinary keyboard keys.  If you don't like the way that the keypresses that are recognized for certain buttons on the remote, their behavior can be changed using Xmodmap.

Alternatively, if you would like to still use lirc to manage your i2c device, hexion has written a howto explaining how to install lirc from source and replace the ir_common module in the kernel causing this behavior.  See his howto here: [http://www.ubuntuforums.org/showthread.php?t=288229  HOWTO: Lirc in Edgy].

==== Récépteur IR de PVR-150 ====

=== Packages ===

Le récépteur de la PVR-150 demande un une version de LIRC patchée.

Ajouter le dépots suivant :
<note attention>
Attention ! ce dépot n'est pas officiel il peut nuire à la stabilité de votre système !
</note>
<code>
#Mario's Lirc Repository (superm1@ubuntu.com)
deb http://people.atrpms.net/~mlimonciello/personal edgy lirc
deb-src http://people.atrpms.net/~mlimonciello/personal edgy lirc
</code>

Ajouter la clef public du dépots :
<code>
wget http://people.atrpms.net/~mlimonciello/personal/80DF6D58.gpg -O- | sudo apt-key add -
</code>

Mettez à jours votre liste des paquets et (ré)installer lirc. Lors de la [[#Configurer lirc_modules-source|configuration de lirc_modules-source choisissez les modules ''lirc_i2c'' et ''lirc_pvr150'' modules when building.

=== FIXME PVR-150 firmware and codesets ===
You need to download the Hauppauge firmware and add the appropriate codeset to your lircd.conf for the device you want to control.

The firmware can be found [[http://www.blushingpenguin.com/mark/lmilk/haup-ir-blaster.bin|here]]. Download it and put it in ~+`/lib/firmware`+~

The codesets can be found [[http://www.blushingpenguin.com/mark/lmilk/lircd.conf|here]].  This file contains the codesets for every device in the database.  You will need to extract the information for the device you want to control, and append it to your /etc/lirc/lircd.conf -- but for now, just save it someplace safe.

When you have downloaded and moved the firmware and have the codeset file, '''''Reboot''''' before continuing.

=== FIXME Adding the blaster codeset ===
You will need to determine the codeset of your device.  To help you determine the possible codeset, consult the list here: [http://www.blushingpenguin.com/mark/lmilk/IRcodesets.html here].  Note that finding the correct codeset for your device can be tricky- but the master list can usually help you track them down by process of elimination.

Once you have determined a codeset, you need to extract those codes from the master file you downloaded and add them to your /etc/lirc/lircd.conf as another remote.

For example, to blast a '''Power Button'''  a Motorola DCT6200 series cable box, you would use the POWER button raw code from codeset 85. If you are linking it to a key on your remote, you want to change the button name to the name reported by irw.

sudo nano /etc/lirc/lircd.conf

First, add the blaster header:
<code>
begin remote

name          blaster
  bits          32
  flags         RAW_CODES
  eps           0
  aeps          0
  plead         0
  gap           333333
  repeat_bit    0
  begin raw_codes
</code>

Next, find the power button in codeset 85- since this is a cable box, it is prefixed in the master file as 0_85:
<code>
    name 0_85_KEY_POWER
    5570570
</code>
then make it conform to how irw reports the keypress- in this case, irw reports it as ''POWER'', so that is what to name it:
<code>
   name POWER
   5570570
</code>

Keep adding your buttons (only the ones you want to control with the blaster).  When you are finished, add:
<code>
end raw_codes
end remote
</code>
to close out that remote definition.  In this example, the entire remote definition for the power button only looks like:
<code>
begin remote

name          blaster
  bits          32
  flags         RAW_CODES
  eps           0
  aeps          0
  plead         0
  gap           333333
  repeat_bit    0
  begin raw_codes
  name 0_85_KEY_POWER
  5570570
 end raw_codes
end remote
</code>

After saving the new lircd.conf, restart lirc:

sudo /etc/init.d/lirc restart

and test it.  In the example the command:

irsend SEND_ONCE blaster POWEROFF

turns the DCT6200 cable box on and off.  Even if it does not control the device as intended, you should see the blaster flashing.

Troubleshooting codeset selection, blaster placement, etc. is beyond the scope of this guide.  A wealth of information is readily available via [http://www.google.com Google]

==== MCEUSB2 IR Transmitter ====
Packages included in edgy-backports include support for the mceusb2 IR transmitter.  Configuration is the same as standard serial transmitters.

==== Récepteur / Emetteur sur port série ====
 
Si vous utilisez le pilote ''lirc_serial'' vous devez désactivé le support série du kernel.

Commencer par[[:tutoriel:comment_installer_un_paquet|Installez le paquet]] **setserial**.

Ensuite vous pouvez utilisé 2 métodes différentes. ([[utilisateurs:jonas]] j'ai utilisé la seconde qui semble plus simple et qui a fonctionné).

=== 1ère méthode ===

(Source : Forum TechnoPenguin & TrubbleMaker)\\
Nous allons utilisé "modprobe.conf"
Éditer le fichier **/etc/modprobe.conf** et ajouter les lignes suivante :

<code>
alias char-major-61 lirc_serial
options lirc_serial irq=4 io=0x3f8
install lirc_serial /bin/setserial /dev/ttyS0 uart none ;\
    /sbin/modprobe --ignore-install lirc_serial
</code>

(Ces ligne sont valable si  votre récepteur est connecté sur le 1er port série (/dev/ttyS0')'' si ce n'est pas la cas adapté ''/dev/ttyS1'', IRQ et le port IO.

=== 2ème méthode ===

Utilisation de la configuration debian de setserial
  sudo dpkg-reconfigure setserial
  * Choisissez "manuel"
  * [[:tutoriel:comment_editer_un_fichier|Modifiez]] **/var/lib/setserial/autoserial.conf**.
   * Ajoutez (ou modifiez si les ligne sont déjà présente) (metter ttyS1 si vous utilise le 2ème port)
  /dev/ttyS0 uart none
  * Copier ce script dans ''/etc/serial.conf''
  sudo cp /var/lib/setserial/autoserial.conf /etc/serial.conf

===== Reconstruction du modules =====

Si vous avez besoin de recompiler le module (après une mise à jours du kernel) il suffira de taper les ligne suivante : 
<code>
sudo rm /usr/src/lirc*deb
sudo m-a clean lirc
sudo m-a update,prepare
sudo m-a a-i lirc
sudo depmod -a Method
</code>
Et vous aurez certainement besoin de rédémarrer lirc
  sudo /etc/init.d/lirc restart

===== Liens =====

* [[http://www.lirc.org/|site officiel de lirc]]
  * [[http://lirc.sourceforge.net/remotes/|Fichier de configuration pour télécomande]]
  * [[http://www.lirc.org/receivers.html|Faire son récepteur pour quelque euro]]

------
//Contributeurs : [[utilisateurs:Jonas]], [[utilisateurs:Ju]]//

//Basé sur « [[https://help.ubuntu.com/community/Install_Lirc_Edgy|Install Lirc Edgy]] » par Nick666 //

Merci de recopier le code ci-contre pour prouver que vous êtes humain : M D H O A Merci de laisser ce champ vide :

Résumé

Note : En modifiant cette page, vous acceptez que le contenu soit placé sous les termes de la licence suivante : CC Paternité-Partage des Conditions Initiales à l'Identique 3.0 Unported