✎ lirc [Wiki ubuntu-fr]

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

{{tag>hardy télécommande multimédia matériel media_center}}
----

====== LIRC - Installation & maintenance ======

===== Description =====

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

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 récepteur, plusieurs transmetteurs, ou plusieurs récepteurs, 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.

Cette page explique comment configurer LIRC avec le pilote « lirc_mceusb ». C'est un exemple. Si vous souhaitez utiliser LIRC avec un autre type de récepteur, vous pouvez le compiler directement avec un autre pilote (pour certains récepteurs vous trouverez des [[#pilotes_demandant_un_effort_supplementaire|informations complémentaires]]).

<note important> Depuis le noyaux 2.6.33 et LIRC 0.9 beaucoup de choses ont changé avec l'intégration au noyau de fonctionalités télécommandes infrarouge (ir-core) et de fait ce qui est décrit ci-dessous ne s'applique pas forcement. Le site français MythTV publie des informations très utiles sur le sujet [[http://mythtv-fr.org/wiki/piloter_par_telecommande]].</note>
===== Installation et configuration pour une télécommande =====

==== Prérequis ====

Le [[:dépôts|dépôt]] universe doit être activé.

Avoir vérifié que son matériel n'est pas reconnu nativement par le noyau et le programme [[irkeytable|ir-keytable]].
==== Installation ====

[[:tutoriel:comment_installer_un_paquet|Installez les paquets]] [[apt://lirc]], [[apt://lirc-modules-source]] et [[apt://module-assistant]].

<note>Certaines télécommandes sont directement supportées par le [[:kernel|noyau]] (voir la section « [[#materiel_gere_par_i2c]] »).</note>
<note>Pour Maverick et après, lirc-modules-source ne doit pas forcement être installé (voir [[http://www.mail-archive.com/ubuntu-bugs@lists.ubuntu.com/msg2555899.html|bug]]). Le paquet n'existe plus dans Precise Pangolin (12.04 LTS)</note>

==== Configuration ====

=== Configuration des modules ===

Durant la configuration des modules LIRC vous devrez sélectionner le type de récepteur infrarouge que vous allez utiliser.

sudo dpkg-reconfigure lirc-modules-source

ou pour les versions récentes sans lirc-modules-sources

sudo dpkg-reconfigure lirc

|Informations diverses sur les périphériques IR supportés. (Flèches haut et bas pour faire défiler).\\ Notez le (les) nom(s) du (des) module(s) que vous voulez utiliser.\\ Sélectionnez « OK » grâce à la touche de tabulation (->).|{{lirc:info_modules.png?320}}|
|Sélectionnez le (les) module(s) que vous souhaitez configurer. Pour certains modules, consultez la partie [[#pilotes_demandant_un_effort_supplementaire]].\\ (Utilisez les flèches haut et bas pour naviguer et la barre d'espace pour sélectionner ; tabulation pour aller sur le bouton <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 du fichier /etc/lirc/hardware.conf ===

[[:tutoriel:comment_editer_un_fichier|Éditez le fichier]] ''/etc/lirc/hardware.conf'' avec les droits administrateurs. S'il n'existe pas, créez-le. Ensuite, faites les modifications suivantes :
  * 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'' »).

<note tip>Sur le site du projet LIRC, [[http://www.lirc.org/html/table.html|une page]] recense les matériels supportés avec les modules appropriés (colonne « //Required LIRC kernel modules// »). Suivant le récepteur utilisé, on utilise soit un module, comme indiqué précédemment, soit un pilote. Dans ce dernier cas, il faut laisser le paramètre ''MODULES'' vierge.</note>

La page [[:lirc - exemples "hardware.conf"]] de la documentation donne des exemples de fichiers ''hardware.conf''.

==== Compilation des modules LIRC ====

<note important>
Les modules LIRC ont besoin d'être recompilés à chaque mise à jour du noyau.
</note>
<note>Selon votre matériel, cette étape n'est pas nécessaire.</note>

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

Préparez votre système à une compilation de nouveaux modules noyau (cette étape lui fait préparer les bons //headers//) :
  sudo m-a update,prepare

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

Mettez à jour la liste des modules :
  sudo depmod -a

Redémarrez LIRC :
  sudo /etc/init.d/lirc restart

==== 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çons de l'obtenir :
  * trouver un fichier existant (sur le site [[http://www.lirc.org/remotes/|lirc.org]] ; le plus simple) ;
  * le créer à partir d'un utilitaire de LIRC (''irrecord'').

=== 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 remplacez son contenu par celui trouvé précédemment.

=== Créer un fichier lircd.conf avec irrecord ===

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''.
Reportez-vous au [[:tutoriel:creer_fichier_lircd.conf|tutoriel]] existant sur le sujet.

==== Démarrage de LIRC et essai ====

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

Le terminal doit se mettre en « attente » (on ne peut plus taper de commande). Appuyez sur les touches de votre télécommande. 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 s'est pas chargé correctement. Essayez de redémarrer votre ordinateur. Si ça ne fonctionne toujours pas, regardez si le module s'est bien chargé grâce à la commande <code>dmesg | grep lirc</code>

Si au lancement de LIRC vous avez ceci :
<code>
$ sudo service 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 fichier ''lircd.conf''. Retournez à la section   "[[#Le fichier lircd.conf]]".

==== Création des fichiers lircrc ====

Pour la création des fichiers lircrc, il faut se reporter à [[:tutoriel:lircrc|ce tutoriel]].

===== Pilotes demandant en effort supplémentaire =====

==== Récepteur ou émetteur infrarouge ====

Une boîte de dialogue supplémentaire s'affichera au moment de la configuration des modules.

==== Périphériques GPIO ====

Depuis le noyau 2.6.22, on ne peut plus utiliser le pilote lirc_gpio de LIRC. À la place, les périphériques GPIO seront gérés par le pilote native ''/dev/input'' de LIRC. Lors de la configuration des modules, on vous demandera quel périphérique d'événement vous voulez utiliser pour votre télécommande. Cette information peut être trouvée à l'aide de la commande suivante :
<code>cat /proc/bus/input/devices</code>

==== Télécommande Apple ====

Il faut trouver le périphérique d'événement dans ''/dev/'' et le renseigner dans le paramètre ''DEVICE'' dans le fichier ''/etc/lirc/hardware.conf''.

==== Méthode alternative avec InputLirc ====
InputLirc est un daemon léger qui permet de ré-envoyer les KeyCodes générés par ''/dev/input/eventX'' aux clients Lirc.

Pour commencer, il faut stopper le daemon Lircd. Pour cela, nous allons reconfigurer le paquet Lirc :
<code> sudo dpkg-reconfigure lirc </code>

Il faut alors répondre "none" aux deux questions posées. Maintenant, le paramètre START_LIRCD devrait être configuré sur "false" dans ''etc/lirc/hardware.conf'' \\
On peut alors installer InputLirc :

<code> sudo apt-get install inputlirc </code>

Pour le configurer, il faut connaître le numéro du EventX correspondant à votre récepteur IR :

<code>cat /proc/bus/input/devices </code>

Dans mon cas, sur ma Zbox nano, j’obtiens :

<code>I: Bus=0019 Vendor=1050 Product=00c5 Version=0062
N: Name="Nuvoton w836x7hg Infrared Remote Transceiver"
P: Phys=nuvoton/cir0
S: Sysfs=/devices/pnp0/00:02/rc/rc0/input7
U: Uniq=
H: Handlers=kbd event7 
B: PROP=0
B: EV=100013
B: KEY=fff 0 108fc010 4004900000000 0 40000a000 1080c4000801 9e168000000000 2
B: MSC=10</code>
 
Donc, dans mon cas, les signaux de ma télécommande sont transmis à travers ''/dev/input/event7'', ce qu'il faut indiquer à inputLirc en ajoutant au fichier ''/etc/default/inputlirc'' :
<file>EVENTS="/dev/input/event7"
OPTIONS="-g -m 0 -c"</file>

Il ne reste plus qu'à redemarrer inputLirc :
<code>/etc/init.d/inputlirc stop
/etc/init.d/inputlirc start</code>

<note> Ces informations sont issues de [[http://kodi.wiki/view/HOW-TO:Set_up_an_MCE_remote_control_in_Linux]] (en anglais)</note>
===== Installation et configuration pour plusieurs télécommandes =====

<note warning>Partie à vérifier avec les dernières versions.</note>

Une fois que LIRC fonctionne avec une télécommande, vous pouvez modifier la configuration pour supporter des télécommandes supplémentaires. La première chose à faire sera de vous assurer que votre noyau contient tous les pilotes nécessaires pour faire fonctionner ce matériel supplémentaire. Si, lors de la configuration pour un seul appareil, vous aviez construit les modules dont vous pensiez avoir besoin pour les autres, vous pouvez sauter l'étape suivante.

==== Compiler les modules supplémentaires dont on a besoin ====

Nettoyez les vieux modules :
  sudo rm /usr/src/lirc*deb
  sudo m-a clean lirc

Arrêtez LIRC et déchargez tous les modules correspondants :
  sudo /etc/init.d/lirc stop
  sudo rmmod LOADED_LIRC_MODULES

Remplacez LOADED_LIRC_MODULES par les noms des modules LIRC que vous aviez chargés.

Reconfigurez lirc-modules-source. Choisissez tous les modules dont vous aurez besoin, y compris ceux d'avant :
  sudo dpkg-reconfigure lirc-modules-source

Compilez et installez tout ça :
  sudo m-a a-i lirc

Si vous avez un message qui dit qu'il n'arrive pas à installer, vous pouvez forcer ceci :  
  sudo dpkg -i /usr/src/lirc*deb

==== Modification des scripts d'initialisation ====

[[:tutoriel:comment_editer_un_fichier|Éditez le fichier]] '/etc/lirc/hardware.conf' :
  * Assurez-vous que tous vos modules figurent sur la ligne MODULES="", séparés par des espaces. Prenez garde à l'ordre dans lequel vous les mentionnez. Ce sera l'ordre dans lequel LIRC reconnaîtra les appareils. C'est donc important si vous voulez faire une différence entre ceux-ci.
  * Modifiez les lignes du côté de LIRCD_ARGS="" pour faire correspondre le tout à
<file>
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"
</file>

<note>Il faut adapter les paramètres ''device'' à votre configuration.</note>

[[:tutoriel:comment_editer_un_fichier|Éditez le fichier]] ''/etc/init.d/lirc'' :
  * Changez :
<file>
      LIRCD_ARGS=`build_args $LIRCD_ARGS`
      start-stop-daemon --start --quiet --exec /usr/sbin/lircd -- $LIRCD_ARGS 
                < /dev/null
</file>
en :
<file>
      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
</file>

Faites les manipulations sur ''/etc/lirc/hardware.conf'' et ''/etc/init.d/lirc'' pour chaque nouvel appareil.

==== Essai ====

Démarrez LIRC :
  sudo /etc/init.d/lirc start

Vous devriez avoir deux lircd actifs. Tout processus lirc qui tentera d'interagir avec lircd devra se faire spécifier un paramètre lui indiquant à quelle instance il s'adresse.

===== Transmission infrarouge =====

Les périphériques suivants ont un support pour la transmission infrarouge :
  * transmetteur infrarouge série (avec le module lirc_serial) ;
  * récepteur infrarouge et quadruple-transmetteur CommandIR (avec le module lirc_cmdir) ;
  * Media Center Remote 2 (avec le module lirc_mceusb2) ;
  * Hauppauge PVR-150 (avec le module lirc_pvr150) ;
  * USB-UIRT (avec le module lircd natif).

Les émetteurs utilisant i2c ont une configuration spécifique car n'utilisant plus LIRC.

Cette partie va donc décrire les configurations spécifiques à différents types d'émetteurs infrarouge. Après avoir préparé les configurations spécifiques à un matériel, il faut passer à la partie sur la configuration générale de la transmission infrarouge.

==== Configuration de différents types d'émetteurs ====

=== Transmetteur infrarouge série ===

Les paquets de Hardy vont vous poser des questions relatives au port série que vous utilisez. Suivez les boîtes de dialogues et le port série sera configuré correctement.

=== Récepteur infrarouge et quadruple-transmetteur CommandIR ===

Le [[http://www.commandir.com/content/view/37/54/|site de CommandIR]] (en anglais) indique comment installer ce matériel. Il suffit de lancer ''gnome-lirc-properties'' (dans un bureau Gnome) et de sélectionner le bon matériel.

=== Transmetteur infrarouge MCEUSB2 ===

Les paquets de Hardy possèdent le support pour les transmetteur MCEUSB2.

=== Transmetteur infrarouge de la carte PVR-150====

Sous la version 8.04 d'Ubuntu, il faut faire les manipulations suivantes décrites dans les paragraphes suivants.

== Copie du micrologiciel PVR-150 ==

Téléchargez le micrologiciel Hauppauge et ajoutez le jeu de codes approprié à votre fichier lircd.conf pour le périphérique que vous voulez contrôler.

Le micrologiciel peut être trouvé [[http://www.blushingpenguin.com/mark/lmilk/haup-ir-blaster.bin|ici]]. Téléchargez-le et placez-le dans le répertoire ''/lib/firmware/''.

Les jeux de codes sont  [[http://www.blushingpenguin.com/mark/lmilk/lircd.conf|ici]].  Ce fichier contient les jeux de codes de tous les périphériques de la base de données. Extrayez-en l'information de votre périphérique et insérez-la dans le fichier ''/etc/lirc/lircd.conf'' -- en prenant soin de sauvegarder l'original dans un lieu sûr.

Une fois ces deux étapes effectuées, redémarrez l'ordinateur avant de continuer.

== Ajout du jeu de codes pour le transmetteur ==

Il vous faut déterminer le code de votre appareil. Pour le trouver, consultez la liste [[http://www.blushingpenguin.com/mark/lmilk/IRcodesets.html|ici]]. Il n'est pas toujours aisé de trouver le bon code pour votre appareil. Cependant, la liste principale permet généralement de le trouver par élimination.

Une fois que vous avez déterminé votre code, il faut extraire le jeu de codes correspondant dans le fichier principal. Il faut ensuite les ajouter au fichier ''/etc/lirc/lircd.conf'' comme pour une autre télécommande.

À titre d'exemple, pour //blaster// un bouton de marche pour un récepteur de câble Motorola DCT6200, il faut utiliser le code pour le bouton correspondant avec le code 85 (correspondant au récepteur). Dans ce cas, on obtient le code 0_85_KEY_POWER où :
  * 0 désigne le fait que c'est un récepteur pour le câble (1 pour le satellite) ;
  * 85 correspond au code trouvépour le récepteur ;
  * KEY_POWER désigne la fonction.
Si vous voulez le lier à un bouton de votre télécommande, il faut changer ''KEY_POWER'' (correspondant au bouton de marche) par le nom de la clé donnée par ''irw''.

Pour commencer la partie du fichier ''/etc/lircd.conf'' pour l'émetteur, il faut utiliser cet en-tête :
<file>
begin remote

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

Il faut ensuite trouver le bouton de marche dans le jeu de codes 85. Comme on regarde pour un récepteur de câble, il faut utiliser le préfixe 0. On trouve donc la partie suivante dans le fichier principal :
<file>    name 0_85_KEY_POWER
    5570570</file>
Ensuite, rendez le conforme à ce que renvoie ''irw'' quand vous appuyer sur le bouton. Dans ce cas, ''irw'' renvoie ''POWER''. Il faut donc modifier le nom de la manière suivante :
<file>   name POWER
   5570570</file>

Il faut faire de même pour les autres boutons voulus.

Quand vous avez terminé de renseigner les boutons, ajouter ce qui suit :
<file>end raw_codes
end remote</file>
Cela permet de terminer la définition de la télécommande. Dans cet exemple, la définition entière de la télécommande (avec un seul bouton) est la suivante :
<file>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</file>

Après avoir sauvegardé le nouveau fichier ''lircd.conf'', redémarrez LIRC :
  sudo /etc/init.d/lirc restart

Ensuite, essayez-le. Vous pouvez, par exemple, utiliser la commande suivante :
  irsend SEND_ONCE blaster POWEROFF

Elle allume et éteint le récepteur DCT6200. Même si elle ne contrôle pas l'appareil comme prévu, vous devriez voir l'émetteur émettre des signaux lumineux.

Les problèmes avec la sélection des codes, le positionnement de l'émetteur et autres vont au-delà de l'objectif de cette page. Vous pouvez faire de plus amples recherches sur Internet qui possède des informations sur ces sujets.

=== Matériel géré par i2c ===

Ubuntu Edgy a introduit directement dans son noyau la gestion de quelques télécommandes via le bus i2c. Pour ces télécommandes, il est déconseillé d'utiliser LIRC. Quand vous appuyez sur des boutons de votre télécommande, ils devraient être reconnus directement comme des touches ordinaires du clavier. Si les comportements de ces touches ne vous plaisent pas, voyez la page [[tutoriel:creer_et_utiliser_un_agencement_de_clavier_personnalise|Créer et utiliser un agencement de clavier personnalisé]].

Si vous vous entêtez à vouloir garder lirc, il existe un tutoriel en anglais pour adapter votre noyau à cet usage : [[http://www.ubuntuforums.org/showthread.php?t=288229|HOWTO: Lirc in Edgy]].

<note warning>Partie à vérifier avec les dernières versions.</note>

Sous Intrepid, on peut parvenir au même résultat en indiquant simplement à HAL d'ignorer le périphérique, ce qui permet à lirc de le détecter et de l'utiliser. Pour cela, [[:tutoriel:comment_editer_un_fichier|éditez le fichier]] ''/usr/share/hal/fdi/preprobe/20thirdparty/lirc.fdi'', à la ligne : 
<file>
<match key="info.product" contains_ncase="saa7134 ir">
</file>
remplacez ''saa7134 ir'' par l'''info.product'' de votre télécommande, que l'on peut trouver à l'aide de la commande ''lshal''. Après redémarrage, la télécommande devrait être accessible pour LIRC avec le pilote ''dev/input''.

==== Configuration générale et utilisation ====

=== Création d'un fichier lircd.conf ===

Il faut trouver ou bien créer un fichier ''lircd.conf'' représentant la télécommande à la place de laquelle le transmetteur va être utilisé. Pour créer ce fichier, vous pouvez vous reporter à la partie [[#le_fichier_lircd.conf|Le fichier lircd.conf]] en prenant en compte les précisions qui suivent. Vous pouvez enregistrer le fichier lircd.conf où bon vous semble. Il faut cependant ajouter une ligne ''include'' à votre fichier principal ''/etc/lirc/lircd.conf''. Par exemple, si le fichier lircd.conf de votre émetteur est ''~/émetteur/lircd.conf'', il faut ajouter la ligne suivante :
<file>include ~/émetteur/lircd.conf</file>

=== Redémarrage de LIRC ===

Pour prendre en compte les modifications sur les fichiers lircd.conf, il faut redémarrer LIRC avec la commande suivante :
<code>sudo /etc/init.d/lirc restart</code>

=== Essai de transmission ===

La syntaxe pour la transmission est la suivante :
<code>irsend -d $LIRCDPROCESS SEND_ONCE $REMOTE $BUTTON</code>
où :
  * $LIRCDPROCESS représente l'appareil lircd de ''/dev/'' utilisé pour la transmission ;
  * $REMOTE représente le nom de la télécommande, comme écrit dans le fichier ''/etc/lirc/lircd.conf'' ;
  * $BUTTON représente le bouton que vous essayez de transmettre.
Voici un exemple :
<code>irsend -d /dev/lircd SEND_ONCE my_favorite_remote power</code>
Ceci va transmettre le bouton de marche pour la télécommande « my_favourite_remote » en utilisant le processus lircd primaire.

Si la transmission de fonctionne pas immédiatement, la meilleure méthode pour commencer un diagnostic est d'utiliser un appareil photo numérique. Allumez l'appareil photo et regardez la [[http://fr.wikipedia.org/wiki/Diode_électroluminescente|DÉL]] infrarouge de laquelle vous essayez de transmettre à travers l'objectif. Vous devriez voir des flashs violets venant de la DÉL infrarouge quand vous essayez de transmettre. Si vous ne voyez rien, votre appareil ne transmet rien.

===== Liens =====

* [[http://www.lirc.org/|Site officiel de lirc]]
  * [[http://lirc.sourceforge.net/remotes/|Fichiers de configuration pour télécommandes]]
  * [[http://www.lirc.org/receivers.html|Faire son récepteur pour quelques euros]]
  * [[https://help.ubuntu.com/community/InstallLirc/Hardy|Documentation anglophone]]

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

Merci de recopier le code ci-contre pour prouver que vous êtes humain : H S O V J 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