                 Guide pratique des crans tactiles sous Linux

  Version franaise du guide pratique Linux Touch Screen HOWTO

  Christoph Baumann

   <cgb CHEZ debian POINT org>

   Adaptation franaise: ric Madesclair

   Relecture de la version franaise: Jean-Philippe Gurard

   Prparation de la publication de la v.f.: Jean-Philippe Gurard

   Version : 3.3.fr.1.0

    2002 Christoph Baumann, <cgb CHEZ debian POINT org>

    2005 ric Madesclair et Jean-Philippe Gurard pour la version franaise

   The GNU Free Documentation License applies to this document. Ce document
   est distribu selon les termes de la Licence de documentation Libre GNU
   (GFDL).

   28 fvrier 2005



   +------------------------------------------------------------------------+
   | Historique des versions                                                |
   |------------------------------------------------------------------------|
   | Version 3.3.fr.1.0           | 2005-02-28           | EM,JPG           |
   |------------------------------------------------------------------------|
   | Premire traduction franaise                                          |
   |------------------------------------------------------------------------|
   | Version 3.3                  | 2004-10-07           | CB               |
   +------------------------------------------------------------------------+

   Rsum

   Ce guide pratique explique comment utiliser un cran tactile comme
   priphrique d'entre sous XFree86. Il se concentre sur les crans
   tactiles EloTouch et MicroTouch, que l'auteur a eu l'occasion d'utiliser.
   Les exemples sont bass sur des priphriques connects via le port srie
   (/dev/ttyS0, et ctera).

   --------------------------------------------------------------------------

   Table des matires

   1. Introduction

                1.1. Commentaires et corrections

                1.2. Nouvelles versions de ce document

   2. Comment configurer le priphrique

   3. Activer le priphrique

   4. Utiliser en parallle un cran tactile et une souris

   5. Configuration sous XFree86 version 4

                5.1. Un autre exemple de paramtrage (pour la gamme SMT3 de
                Microtouch)

                5.2. Complment

   6. crans tactiles des portables LifeBook de Fujitsu

   7. Lectures conseilles

1. Introduction

   Ce guide pratique explique comment utiliser un cran tactile comme
   priphrique d'entre sous XFree86. Il se concentre sur les crans
   tactiles EloTouch et MicroTouch, que l'auteur a eu l'occasion d'utiliser.

   Les exemples sont bass sur des priphriques connects via le port srie
   (/dev/ttyS0, et ctera). -- N'hsitez pas  faire parvenir en anglais des
   informations relatives aux priphriques USB  l'auteur de ce document !

  1.1.  Commentaires et corrections

   N'hsitez pas  faire parvenir tout commentaire relatif  la version
   franaise de ce document  <commentaires CHEZ traduc POINT org> en
   prcisant son titre, sa date et sa version.

  1.2.  Nouvelles versions de ce document

   Vous trouverez la plus rcente version franaise de ce document 
   l'adresse :
   http://www.traduc.org/docs/howto/lecture/XFree86-Touch-Screen-HOWTO.html
   [http://www.traduc.org/docs/howto/lecture/XFree86-Touch-Screen-HOWTO.html].

   La plus rcente version originale de ce document est disponible 
   l'adresse : http://www.tldp.org/HOWTO/XFree86-Touch-Screen-HOWTO.html
   [http://www.tldp.org/HOWTO/XFree86-Touch-Screen-HOWTO.html].

2. Comment configurer le priphrique

   Les crans tactiles sont paramtrs dans l'une des sections  Xinput  du
   fichier de configuration de XFree86 (ce fichier se nomme en gnral
   /etc/X11/XF86Config ou /etc/XF86Config). Vrifiez pour commencer que le
   module correspondant au priphrique est bien prsent. Les modules se
   trouvent dans le rpertoire /usr/X11R6/lib/modules (les crans EloTouch et
   MicroTouch correspondent respectivement aux modules xf86Elo.so et
   xf86MuTouch.so). Regardez ensuite dans le fichier XF86Config, vous devriez
   trouver une section ressemblant  ceci :

 Section "Files"
 ...
 ModulePath "/usr/X11R6/lib/modules"
 ...
 EndSection

   Pour que le module soit charg par le serveur X, vous devrez avoir une
   section ressemblant  ceci :

 Section "Module"
 Load "xf86Elo.so"
 EndSection

   Maintenant, la partie la plus dlicate. Le serveur X a besoin de connatre
   certains paramtres du priphrique. La section correspondante doit
   ressembler  la section ci-dessous -- reportez-vous  la page de manuel de
   XF86Config(7) pour plus d'informations :

 Section "Xinput"

  # Utilisez  SubSection "MicrotouchFinger"  pour un cran MicroTouch

  SubSection "Elographics"

   Port "/dev/ttyS1"         # Pour un priphrique branch sur le
                             # deuxime port srie

   DeviceName "EcranTactile" # N'importe quel nom non ambigu convient

   MinimumXPosition  300
   MaximumXPosition 3700
   MinimumYPosition  300
   MaximumYPosition 3700
   UntouchDelay       10     # non reconnu par le pilote MuTouch
   ReportDelay        10     # non reconnu par le pilote MuTouch
   AlwaysCore                # active le priphrique au dmarrage

  EndSubSection

 EndSection

   Les valeurs des entres MinimumXPosition, et ctera sont bien entendu
   spcifique  la configuration de votre matriel (ils dpendent de la
   position de l'cran tactile par rapport au moniteur). Ces valeurs
   dfinissent  quels points de l'cran tactile correspondent les points
   (0,0) et (x[max], y[max]) de votre moniteur (x[max] et y[max] dpendent de
   la rsolution choisie pour votre serveur X, par exemple 1024x768). Le
   pilote lit ces valeurs et en dduit les autres coordonnes par
   interpolation. Le schma suivant illustre cette mise en correspondance :

  --------- surface de l'cran tactile -----------
  I                                              I
  I  ####### surface visible du moniteur ######  I
  I  #x                                       #  I
  I  # (0,0)                                  #  I
  I  # (MinimumXPosition,MinimumYPosition)    #  I
  I  #                                        #  I
  I  #                                        #  I
  I  #                                        #  I
  I  #                                        #  I
  I  #                                        #  I
  I  #                                        #  I
  I  #                                        #  I
  I  #    (MaximumXPosition,MaximumYPosition) #  I
  I  #                            (xmax,ymax) #  I
  I  #                                       x#  I
  I  ##########################################  I
  I                                              I
  ------------------------------------------------

   Trouver la bonne correspondance demandera soit un certain nombre d'essais,
   soit de lire la sortie brute de ce priphrique (ce qui demande une
   certaine connaissance de la programmation des ports srie : consultez le
   guide pratique de Programmation des entres-sorties srie
   [http://www.traduc.org/docs/howto/lecture/Serial-Programming-HOWTO.html]
   pour en savoir plus). Pour les crans tactiles EloTouch et MicroTouch, il
   existe un outil rudimentaire de calibration (crit par l'auteur de ce
   guide pratique), disponible  l'adresse suivante :
   http://www.sgoc.de/touchcal.html [http://www.sgoc.de/touchcal.html].

3.  Activer le priphrique

   Aprs le dmarrage du serveur X, lancez la commande suivante dans un
   terminal :

 xsetpointer nom_du_priphrique

   O nom_du_priphrique est le nom dfini dans le fichier XF86Config  la
   ligne :

 ...
 DeviceName "..."
 ...

   Dans l'exemple prsent plus haut, il s'agissait d'EcranTactile.

   Pour que le priphrique soit gr au dmarrage, ajoutez l'option
   AlwaysCore dans la section de paramtrage de l'cran tactile du fichier
   XF86Config (voir ci-dessus).

4.  Utiliser en parallle un cran tactile et une souris

   Pour utiliser en parallle un cran tactile et une souris, vous devrez
   dfinir la souris dans la section Xinput. Cette dfinition devrait tre la
   mme que la dfinition de la section Pointer. Par exemple, pour une souris
   utilisant le protocole PS/2 :

 Section "Xinput"
 ...
    SubSection "Mouse"
       Protocol "PS/2"
       Port "/dev/mouse"   # Ou /dev/psaux
       DeviceName "Mouse"
       AlwaysCore
    EndSubSection
 ...
 EndSection

   Plusieurs personnes m'ont signal ceci et notamment l'utilisation de
   l'option AlwaysCore. Merci  eux.

5.  Configuration sous XFree86 version 4

  suggre par Lee Monamy

   Voici un exemple de paramtrage du fichier XF86Config-4 pour un cran
   tactile ELO :

 Section "InputDevice"
         Identifier "Ecran tactile ELO"
         Driver     "elographics"
         Option     "Device"            "/dev/ttyS0"
         Option     "MinimumXPosition"         "300"
         Option     "MaximumXPosition"        "3700"
         Option     "MinimumYPosition"         "300"
         Option     "MaximumYPosition"        "3700"
         Option     "UntouchDelay"              "10"
         Option     "ReportDelay"               "10"
         Option     "SendCoreEvents"           "yes"
 EndSection

   Diffrence notable entre le paramtrage de cette version et celui de la
   version 3, vous devez indiquer Device  la place de Port, sinon vous
   obtiendrez une erreur. De plus, le paramtre AlwaysCore de la version 3 a
   t remplac par SendCoreEvents.

   Vous devez aussi ajouter une entre correspondant  l'cran tactile dans
   la section ServerLayout. Ceci, mme si le serveur X vous indique qu'il a
   bien ajout votre cran tactile :  (II) XINPUT: Adding extended input
   device "ECRANTACTILE" (type: Elographics Touch Screen) .

 Section "ServerLayout"
         Identifier      "Default Layout"
         Screen          "Default Screen"
         InputDevice     "Generic Keyboard"
 ...
         InputDevice     "Ecran tactile ELO"
 EndSection

  5.1. Un autre exemple de paramtrage (pour la gamme SMT3 de Microtouch)

    par Dirk Mueller

 Section "InputDevice"
         Identifier  "MicroTouchFinger"
         Driver      "mutouch"
         Option      "Type"             "finger"
         Option      "Device"           "/dev/ttyS0"
         Option      "ScreenNo"         "0"
         Option      "MinimumXPosition" "0"
         Option      "MaximumXPosition" "16383"
         Option      "MinimumYPosition" "0"
         Option      "MaximumYPosition" "16383"
 EndSection

   L'option Type peut avoir pour valeur finger ou stylus. Depuis que
   Microtouch a t rachet par 3M-Touch, vous trouverez les ressources
   relatives  ces produits  l'adresse suivante :
   http://www.3M.com/3MTouchSystems/downloads/legacy.jhtml#Linux
   [http://www.3M.com/3MTouchSystems/downloads/legacy.jhtml#Linux]

  5.2. Complment

   D'aprs Wong Yeow Sen, les noms des options de configuration ont t
   modifis dans XFree86 version 4.2 (au moins pour la distribution Red
   Hat 7.3). Si vous constatez que les valeurs de calibration que vous avez
   dfini ne sont pas utilises, essayez d'utiliser les options suivantes :

 ...
         Option  "MinX"    "100"
         Option  "MaxX"   "4000"
         Option  "MinY"    "100"
         Option  "MaxY"   "4000"
 ...

6.  crans tactiles des portables LifeBook de Fujitsu

  par Joerg Hau

   Les adresses qui suivent contiennent des informations sur ces
   priphriques :

     Le pilote Linux de Harald Hoyer pour les crans tactiles des portables
     LifeBook B112, B142 et B2130 : http://parzelle.de/Linux/Lifebook/
     [http://parzelle.de/Linux/Lifebook/]. Malheureusement, ce pilote n'est
     utilisable qu'avec la version 3 de XFree et apparemment, la page n'est
     plus mise  jour.

     Le pilote de Kenan Esau pour les crans tactiles des portables Lifebook
     de la gamme  B  : http://www.conan.de/lifebook/lifebook.html
     [http://www.conan.de/lifebook/lifebook.html]. Il s'agit d'une adaptation
      XFree version 4 du pilote de Harald Hoyer.

     J'ai utilis avec mon Fujitsu LifeBook B142 le pilote de Kenan Esau
     (dcrit  l'adresse :
     http://www.mysunrise.ch/users/joerg.hau/linux/b142.htm
     [http://www.mysunrise.ch/users/joerg.hau/linux/b142.htm]). Il fonctionne
     correctement.

7. Lectures conseilles

     o La page de manuel de XF86Config(7)

     o http://www.elotouch.com/support/linux.asp
       [http://www.elotouch.com/support/linux.asp]

     o http://www.3M.com/3MTouchSystems/downloads/legacy.jhtml#Linux
       [http://www.3M.com/3MTouchSystems/downloads/legacy.jhtml#Linux]

     o http://freshmeat.net/projects/xf86elousb
       [http://freshmeat.net/projects/xf86elousb] (Pilote iTouch USB)

     o Le manuel de votre cran tactile :-)

