               Guide pratique des tablettes USB Graphire de Wacom

  Version franaise du guide pratique Wacom Graphire USB Mini-HOWTO

  Arnaud Claden

   <tiamat CHEZ club TIRET internet POINT fr>

  Joseph Mokadim

   <dagdadiamaith CHEZ free POINT fr>

   Adaptation franaise

  Jean-Philippe Gurard

   <fevrier CHEZ tigreraye POINT org>

   Relecture de la version franaise

  Jean-Philippe Gurard

   <fevrier CHEZ tigreraye POINT org>

   Prparation de la publication de la v.f.

   Version : 2000-06-01.fr.1.1

   26 janvier 2007

   +------------------------------------------------------------------------+
   | Historique des versions                                                |
   |------------------------------------------------------------------------|
   | Version 2000-06-01.fr.1.1          | 2007-01-26        | JM, JPG       |
   |------------------------------------------------------------------------|
   | Inclusion de quelques corrections du traducteur.                       |
   |------------------------------------------------------------------------|
   | Version 2000-06-01.fr.1.0          | 2006-03-20        | JM, JPG       |
   |------------------------------------------------------------------------|
   | Premire traduction franaise. Mise  jour des liens de la version     |
   | originale. Suppression du lien vers xink qui semble ne plus exister.   |
   |------------------------------------------------------------------------|
   | Version 2000-06-01                 | 2000-06-01        | AC            |
   +------------------------------------------------------------------------+

   Rsum

   Ce document explique comment installer une tablette USB Graphire de Wacom
   afin de l'utiliser sous Linux (console et X). Il va de la configuration du
   noyau  celle de l'application. Ces informations devraient tre galement
   utilisables pour une tablette USB Intuos.

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

   Table des matires

   Droits d'utilisation (copyright)

   Introduction

                Nouvelles versions de ce document

                Commentaires et corrections

                Remerciements

                Limitation de responsabilit

   Matriel et logiciels ncessaires

                Matriel

                Noyau

                Programmes en mode console

                XWindow

                Autres

                Noyau et matriel

                La console Linux

                XWindow

                Pour aller plus loin

Droits d'utilisation (copyright)

   Version originale copyright  2000 par Arnaud Claden <tiamat CHEZ club
   TIRET internet POINT fr>.

   Version franaise copyright  2000 par Joseph Mokadim et Jean-Philippe
   Gurard.

   Ce document dcrit l'installation des tablettes Wacom sous Linux. Vous
   pouvez utiliser, distribuer et reproduire ce document librement 
   condition que :

    1. vous n'omettiez pas ou ne modifiiez pas l'avis de copyright.

    2. vous n'omettiez pas ou ne modifiiez pas le numro de version et la
       date.

    3. vous n'omettiez pas ou ne modifiiez pas le lien vers la plus rcente
       version accessible en ligne.

    4. vous indiquiez clairement en tant que telle toute version condense,
       modifie ou altre.

Introduction

   Ce document est un guide d'installation d'une tablette Wacom Graphire USB
   sous Linux. C'est une installation assez complexe, mais ce guide vous
   guidera pas  pas tout au long du processus.

   Cet ouvrage a t principalement ralis  partir du guide pratique des
   tablettes Wacom de Stephan Runkel, mais il apporte des lments relatifs
   au paramtrage USB absents du document original. Pour plus d'informations
   sur les tablettes Wacom en gnral, reportez-vous au guide pratique de
   Stephan Runkel.

   J'ai crit ce document car j'ai eu beaucoup de mal  installer ma tablette
   Graphire flambant neuve sous Linux. Elle fonctionne  prsent parfaitement
   bien avec mon portable Toshiba 4030CDT.

  Nouvelles versions de ce document

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

   La plus rcente version originale de ce document est disponible 
   l'adresse : http://tiamat.club.fr/computer/howto/Wacom_USB-Mini_HOWTO.html
   [http://tiamat.club.fr/computer/howto/Wacom_USB-Mini_HOWTO.html].

  Commentaires et corrections

   N'hsitez pas  faire parvenir vos commentaires, corrections et ajouts 
   l'adresse : <tiamat CHEZ club TIRET internet POINT fr>

   N'hsitez pas  faire parvenir vos commentaires et suggestions concernant
   l'adaptation franaise de ce document au projet Traduc.org
   [http://www.traduc.org]  l'adresse : <commentaires CHEZ traduc POINT
   org>.

  Remerciements

   Je souhaite remercier toutes les personnes qui travaillent sur la partie
   USB du noyau et spcialement Vojtech Pavlik pour son travail sur le module
   wacom.

   Bien sr, je remercie Stephan Runkel pour son formidable guide pratique
   sur les tablettes Wacom, qui m'a beaucoup aid dans le processus de
   paramtrage.

   Des remerciements spciaux vont aussi  Frdric Lepied pour son travail
   sur le module xf86Wacom.

  Limitation de responsabilit

    ma connaissance, les informations de ce document sont correctes. Mais
   rien ne garantit que je n'aie pas fait d'erreur. Je vous invite donc 
   tre prudent lorsque vous suivez les indications de ce guide pratique, et
   ceci plus spcialement si elles ne vous semblent pas logiques. Rien de ce
   que j'indique ne devrait avoir d'effet prjudiciable  votre ordinateur
   mais, juste au cas o, je dcline toute responsabilit quant aux dommages
   causs par l'utilisation des informations contenues dans ce guide. Ce
   document n'est pas un guide pratique du noyau, je supposerai donc connue
   la faon de tlcharger, d'installer, de paramtrer et de compiler un
   nouveau noyau.

Matriel et logiciels ncessaires

  Matriel

   Le plus important bien sr, est de possder un ordinateur avec un port USB
   et une tablette USB Graphire de Wacom.

  Noyau

   Lors de cette installation, j'ai utilis le plus rcent noyau en
   dveloppement : linux-2.3.99-pre6. Il est assez stable et possde toutes
   les capacits ncessaires. Vous pouvez galement utiliser un noyau 2.2 en
   utilisant les correctifs appropris^[1] :
   http://web.archive.org/web/20010124002200/www.suse.cz/development/usb-backport/
   [http://web.archive.org/web/20010124002200/www.suse.cz/development/usb-backport/].

  Programmes en mode console

   Pour la console Linux, le seul programme dont vous ayez besoin est gpm,
   disponible sur http://linux.schottelius.org/gpm/
   [http://linux.schottelius.org/gpm/].

  XWindow

   Pour utiliser toutes les capacits de votre tablette, il vous faudra
   utiliser XInput. Plus spcifiquement vous aurez besoin du module
   xf86Wacom.so (qui est fourni avec les versions les plus rcentes de
   XFree86, et ceci depuis la version 3.3.5). Une autre solution (que vous
   devrez peut-tre utiliser) est d'utiliser le module xf86WacomUSB.so, qui
   est une adaptation au port USB, en cours de dveloppement, du xf86Wacom.so
   original. J'en parlerai plus tard dans ce document.

  Autres

   Les applications compatibles XInput sont :

    1. The Gimp -- un puissant programme de manipulation d'images dans le
       style de Photoshop. La version instable 1.1.x en cours de
       dveloppement inclut en standard la compatibilit XInput. Vous pouvez
       obtenir Gimp sur http://www.gimp.org [http://www.gimp.org].

    2. gsumi -- un programme simple de dessin en noir et blanc qui permet de
       dessiner et d'effacer en fonction de la pression et de l'inclinaison.
       Vous pouvez l'obtenir via sa page web :
       http://www.gtk.org/~otaylor/gsumi/
       [http://www.gtk.org/~otaylor/gsumi/].

    3. RasMol -- un programme de visualisation molculaire qui permet
       d'utiliser des cadrans via XInput. Reportez-vous 
       http://www.umass.edu/microbio/rasmol/distrib/rasman.htm
       [http://www.umass.edu/microbio/rasmol/distrib/rasman.htm].

    4. xinput (de Frdric Lepied) -- un utilitaire trs utile pour
       configurer et tester les priphriques XInput. xinput est disponible
       sur : [1]ftp://ftp.x.org/contrib/utilities/xinput-1.2.tar.gz.

  Noyau et matriel

    Paramtrage du noyau

   Comme je l'ai dit prcdemment, les options que je vais donner viennent du
   noyau 2.3.99pre6. Si tout n'est pas exactement identique, je pense que
   vous arriverez bien  deviner quoi choisir ;)

   [2][Note] Rappel
             [] reprsente un choix entre  oui  et  non  (y/n), et <>
             reprsente les options  oui ,  non  et  module  (y/n/m) du
             noyau.

   En premier lieu, vous devez autoriser le code exprimental :

 Code Maturity level options --->
 [*] Prompt for development and/or incomplete code/drivers

   Si vous ne le faites pas, vous n'aurez pas accs  certains pilotes.

   Ensuite, allez  la section USB.

 USB support --->
 <*> Support for USB
 [*] USB verbose debug messages
 --- Miscellaneous USB options
 [*] Preliminary USB device filesystem

   Avec cette option, vous activerez les nouvelles fonctionnalits de
   /dev/usb/* (que, bien sr, vous devrez crer :  voir plus loin).

 --- USB controllers
 <*> UHCI (Intel PIIX4, VIA, ...) support
 < > OHCI (Compaq, iMacs, OPTi, SiS, ALi, ...) support

   Vous devez choisir un et un seul d'entre eux. Donc, si l'un ne fonctionne
   pas, choisissez l'autre. Si vous utilisez un systme x86, il est probable
   que vous preniez le pilote UHCI.

 --- USB Devices
 < > USB Printer support
 < > USB Scanner support
 < > USB Audio support
 < > USB Modem (CDC ACM) support

   Si vous possdez un de ces matriels, activez ces options  votre guise.

 <M> USB Serial Converter support

   Ces options doivent tre actives pour que la tablette Wacom fonctionne.

 [*] USB Generic Serial Driver
 [ ] USB Handspring Visor Driver
 [ ] USB ConnectTech WhiteHEAT Serial Driver (EXPERIMENTAL)
 [ ] USB FTDI Single Port Serial Driver (EXPERIMENTAL)
 [ ] USB Keyspan PDA Single Port Serial Driver (EXPERIMENTAL)
 [ ] USB ZyXEL omni.net LCD Plus Driver (EXPERIMENTAL)
 [*] USB Serial Converter verbose debug

   Cette dernire option permet d'avoir tous les messages (ce qui peut tre
   trs utile au dbut). Vous pourrez la dsactiver lorsque tout fonctionnera
   correctement.

 < > USB Kodak DC-2xx Camera support
 < > USB Mustek MDC800 Digital Camera support (EXPERIMENTAL)
 < > USB Mass Storage support (EXPERIMENTAL)
 < > USS720 parport driver
 < > DABUSB driver
 < > PLUSB Prolific USB-Network driver (EXPERIMENTAL)
 < > USB ADMtek Pegasus-based device support (EXPERIMENTAL)
 < > USB Diamond Rio500 support (EXPERIMENTAL)
 --- USB HID

   Le HID est l'interface entre vous et vos priphriques. Vous DEVEZ
   l'activer.

 <M> USB Human Interface Device (HID) support
 < > USB HIDBP Keyboard support
 < > USB HIDBP Mouse support
 <M> Wacom Intuos/Graphire tablet support

   Nous y sommes, le support Wacom devrait tre activ ( moins que vous ne
   lisiez ceci que pour le plaisir ;) )

 < > Logitech WingMan Force joystick support
 < > Keyboard support
 <M> Mouse support

    activer pour utiliser la souris Wacom Intuos/Graphire.

 (1024) Horizontal screen resolution
 (768) Vertical screen resolution
 <M > Joystick support
 <M> Event interface support

    Compilation du noyau

   Maintenant, le plus facile :

   Lorsque vous sortez du paramtrage, suivez la procdure classique :

 make dep bzImage modules modules_install

   Tapez ceci tel quel et l'ordinateur effectuera toutes les tapes les unes
   aprs les autres.

   Ensuite, copiez le fichier bzImage dans /boot, copiez System.map dans
   /boot, modifiez votre lilo.conf pour pointer vers votre nouveau noyau et
   tapez /sbin/lilo  l'invite.

   [3][Note] Note
             Bien sr, tout ceci (configuration et compilation du noyau,
             ajustement de lilo, doit tre fait sous le compte root).

    Avant de redmarrer

      FStab

   Si vous voulez viter d'avoir un message d'erreur au prochain redmarrage,
   vous devrez faire ce qui suit :

   Modifiez le fichier /etc/fstab et ajoutez les lignes suivantes :

 none    /proc/bus/usb    usbdevfs    defaults    0    0

   La ligne ci-dessus pour activer le systme de fichier usb.

 none    /var/shm         shm         defaults    0    0

   La ligne ci-dessus  cause d'un changement dans le noyau de la gestion de
   la mmoire partage.

      Priphriques USB

   Ensuite, si vous voulez utiliser l'USB :

 mkdir /dev/input
 mknod /dev/input/mouse0 c 13 32

   Les commandes ci-dessus permettent d'activer l'utilisation de la souris.

 mknod /dev/input/event0 c 13 64
 mknod /dev/input/event1 c 13 65
 mknod /dev/input/event2 c 13 66
 mknod /dev/input/event3 c 13 67

   Et ces commandes pour prendre en compte le stylet : dplacement, pression,
   boutons et gomme.

      Paramtrage des modules

   ditez le fichier /etc/modules.conf et ajoutez la ligne suivante :

 alias char-major-13 usbcore

      Ce que j'ai fait ensuite

   Ensuite j'ai ajout les commandes suivantes dans le fichier
   /etc/rc.d/boot.local (rappelez-vous, j'utilise une distribution SuSE, mais
   vous devriez trouver l'quivalent pour RedHat dans
   /etc/rc.d/init.d/boot.local ou /etc/rc.d/init.d/rc.local).

 /sbin/modprobe wacom
 /sbin/modprobe mousedev
 /sbin/modprobe evdev

   Ceci, afin d'tre sr que les modules se chargeront au moment du
   dmarrage.

      Et enfin

   Redmarrage ;)

   Regardez les messages de dmarrage :

 dmesg | less

   et vrifiez qu'il n'y ait aucune erreur relative  l'USB. Cela se pourrait
   si vous avez choisi UHCI et que votre systme est utilise l'OHCI.

   Voici les messages qui apparaissent sur mon systme :

 .....
 .....
 usb.c: registered new driver usbdevfs
 usb.c: registered new driver hub
 usb-uhci.c: $Revision: 1.9 $ time 17:54:28 May 8 2000
 usb-uhci.c: High bandwidth mode enabled
 usb-uhci.c: Intel USB controller: setting latency timer to 0
 usb-uhci.c: USB UHCI at I/O 0xffe0, IRQ 11
 usb-uhci.c: Detected 2 ports
 usb.c: new USB bus registered, assigned bus number 1
 usb.c: USB new device connect, assigned device number 1
 usb.c: kmalloc IF c3fcd2e0, numif 1
 usb.c: new device strings: Mfr=0, Product=2, SerialNumber=1
 usb.c: USB device number 1 default language ID 0x0
 Product: USB UHCI Root Hub
 SerialNumber: ffe0
 hub.c: USB hub found
 hub.c: 2 ports detected
 hub.c: ganged power switching
 hub.c: standalone hub
 hub.c: global over-current protection
 hub.c: power on to power good time: 2ms
 hub.c: hub controller current requirement: 0mA
 hub.c: port 1 is removable
 hub.c: port 2 is removable
 hub.c: local power source is good
 hub.c: no over-current condition exists
 hub.c: enabling power on all ports
 usb.c: hub driver claimed interface c3fcd2e0
 .....
 .....
 hub.c: port 1 connection change
 usb.c: USB new device connect, assigned device number 2
 usb.c: kmalloc IF c3fcd620, numif 1
 usb.c: skipped 1 class/vendor specific interface descriptors
 usb.c: new device strings: Mfr=1, Product=2, SerialNumber=0
 usb.c: USB device number 2 default language ID 0x409
 Manufacturer: WACOM
 Product: ET-0405-UV1.1-1
 usb.c: unhandled interfaces on device
 usb.c: This device is not recognized by any installed USB driver.
 Length                          = 18
 DescriptorType                  = 01
 USB version                     = 1.00
 Vendor:Product                  = 056a:0010
 MaxPacketSize0                  = 0
 NumConfigurations               = 1
 Device Version                  = 1.11
 Device Class:SubClass:Protocol  = 00:00:00
 Per-interface classes
 Configuration:
 .....
 .....

   Lorsque le noyau dit  This device is not recognized by any installed USB
   driver (ce priphrique n'est reconnu par aucun pilote USB install) ,
   c'est parce que, au moment du dmarrage, le module wacom n'est pas encore
   charg. Mais comme vous pouvez le voir, toutes les interfaces et bus USB
   sont reconnus. Aussi, si votre systme ne fonctionne pas et n'affiche
   aucun message de ce genre, vrifiez si vous n'avez pas oubli une option
   USB (l'un des lments que j'ai indiqu comme devant figurer dans le noyau
   et que vous avez choisi comme module : si c'est le cas, dans le fichier
   /etc/rc.d/init.d/boot.local, ajoutez une commande modprobe avant les 3
   lignes que j'ai indiques, par exemple :

 /sbin/modprobe usb-uhci

   Voici les messages correspondant au chargement du module wacom :

 .....
 .....
 usb.c: registered new driver wacom
 input0: Wacom Graphire on usb2
 usb.c: wacom driver claimed interface c3fcd620
 mouse0: PS/2 mouse device for input0
 mice: PS/2 mouse device common for all mice
 event0: Event device for input0
 .....
 .....

   Vrifiez tout et ressayez jusqu' ce que vous obteniez tous ces messages
   (ou quelque chose qui corresponde).

  La console Linux

   Maintenant que votre USB est activ, il est temps de tester tout cela avec
   gpm :

   Si gpm tait activ au moment du dmarrage, vous allez devoir le tuer :

 gpm -k

   Ensuite, essayez votre tablette Wacom :

 gpm -tIMPS/2 -m /dev/input/mouse0

   Dplacez le stylet, ou votre souris et TADA ... le curseur se dplace sur
   l'cran.

  XWindow

    Avoir 2 souris sur le mme systme

   Avez-vous jamais rv d'avoir 2 souris sur votre systme ? Si la rponse
   est oui, faites ce qui suit.

   ditez le fichier /etc/XF86Config.

   La section modules doit ressembler  ceci :

 Section "Module"
 Load "xf86Wacom.so"
 EndSection

   Vrifiez la section XInput :

 Section "XInput"
  SubSection "Mouse"

   DeviceName "TabletteWacom"
   Protocol "IMPS/2"
   Port "/dev/input/mouse0"
   Buttons 5
   ZAxisMapping 4 5
   AlwaysCore

  EndSubSection
 EndSection

   [4]1 Ou le nom de votre choix.
   [5]2 Je ne suis pas arriv  faire reconnatre la molette par le protocole
        imwheel, si vous y arrivez, envoyez-moi un courrier lectronique.
   [6]3 AlwaysCore veut dire que la souris Wacom est toujours considre
        comme pointeur principal. Autrement dit, que dplacer la souris Wacom
        ou la souris normale revient au mme.

   Et voil, la souris Wacom (ou le stylet) est maintenant considre comme
   un second pointeur, mais le premier fonctionne toujours.

    La ralit

   De retour  la section XInput, aprs les paramtres pour la souris, nous
   trouvons les rglages intimes de la tablette Wacom :

 SubSection "WacomStylus"

   Port "/dev/input/event0"
   DeviceName "WacomStylus"
   Mode Absolute
   #Suppress 6
   DebugLevel 10
   #TiltMode
   #HistorySize 200
   #AlwaysCore
   #KeepShape

   #TopX 20412
   #TopY 14730
   #BottomX 0
   #BottomY 0

 EndSubSection

 SubSection "WacomEraser"

   DeviceName "/dev/input/event0"
   DeviceName "WacomEraser"
   Mode Absolute

 EndSubSection

 SubSection "WacomCursor"

   Port "/dev/input/event0"
   DeviceName "GraphireMouse"
   Mode Absolute

 EndSubSection

   [7]1  Le priphrique d'vnements USB.
   [8]2  Ou le nom de votre choix.
   [9]3  C'est--dire que la surface de la tablette est quivalente  celle
         de l'cran.
   [10]4 Une fois que tout fonctionne, mettre cette variable  zro.
   [11]5 Ces 4 lignes permettent un ajustement fin des coordonnes pour
         correspondre  l'cran.

    Le nouveau module

   Le module xf86Wacom.so n'est pas spcifiquement crit pour les tablettes
   USB Wacom et il arrive qu'il ne fonctionne pas correctement avec ces
   tablettes. Un nouveau pilote a t crit par Matsumura Namihiko <po TIRET
   jp CHEZ geocities POINT co POINT jp> et nomm xf86WacomUSB (son code
   source est disponible  la mme adresse que ce petit guide). Cependant,
   afin de pouvoir le compiler, vous aurez besoin du code source du noyau et
   du code source complet de XFree86 (j'ai russi  le compiler avec XFree86
   version 3.3.5, mais cela devrait marcher avec la version 3.3.6).

   Ce pilote ne prend pas en charge toutes les possibilits de la tablette et
   se plante si vous lui passez le paramtre AlwaysCore.

   Pour corriger cela, je reste en contact avec Frdric Lepied afin qu'il
   modifie le module original afin qu'il prenne en compte toutes les
   possibilits de la tablette.

   [12][Note] Nouveau
              Sur le site de Frdric Lepied vous trouverez un lien vers le
              nouveau pilote USB qui fonctionne parfaitement bien, mais
              exclusivement avec la possibilit de faire fonctionner votre
              tablette en souris : c'est--dire soit vous utilisez votre
              tablette avec Le Gimp pour dessiner, soit vous l'utilisez comme
              une souris XFree, mais pas les deux en mme temps. Je vais me
              renseigner plus avant et mettre ce document  jour en
              consquence.

  Pour aller plus loin

   Pour plus d'information sur les tablettes Wacom en gnral, essayez le
   formidable guide pratique de Stephan Runkel <runkel CHEZ runkeledv POINT
   de> : http://www.traduc.org/docs/howto/lecture/Wacom-Tablet-HOWTO.html
   [http://www.traduc.org/docs/howto/lecture/Wacom-Tablet-HOWTO.html]

   En ce qui concerne le module xf86Wacom.so, vrifiez chez Frdric Lepied
   <lepied CHEZ xfree86 POINT org> : http://www.teaser.fr/~flepied/
   [http://www.teaser.fr/~flepied/].

   xf86WacomUSB.so, disponible sur ftp.aros.org/pub (lien mort) .

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

   ^[1] Il s'agit d'adaptations au noyau 2.2 des pilotes USB destins au
   noyau 2.4.

