Penguin
Diff: HowToWacomUSBminiHOWTO
EditPageHistoryDiffInfoLikePages

Differences between current version and predecessor to the previous major change of HowToWacomUSBminiHOWTO.

Other diffs: Previous Revision, Previous Author, or view the Annotated Edit History

Newer page: version 3 Last edited on Tuesday, October 26, 2004 11:03:53 am by AristotlePagaltzis
Older page: version 2 Last edited on Friday, June 7, 2002 1:07:49 am by perry Revert
@@ -1,969 +1 @@
-  
-  
-  
-Wacom Graphire USB Mini-HOWTO  
-  
-  
-  
-----  
-  
-!!!Wacom Graphire USB Mini-HOWTO  
-  
-!!Arnaud Claden  
-01 June 2000  
-  
-  
-----  
-''This is the Wacom Graphire USB Mini-HOWTO. This document describes how  
-to setup a Wacom Graphire USB tablet for use with Linux (console and X), starting  
-with the kernel configuration to the application level. But information should  
-be accurate for the Intuos USB tablet.  
-''  
-----  
-  
-  
-  
-  
-!!1. Copyright  
-  
-  
-  
-  
-!!2. Introduction  
-  
-  
-*2.1 New versions of this document  
-  
-*2.2 Feedback and Corrections  
-  
-*2.3 Acknowledgements  
-  
-*2.4 Disclaimer  
-  
-  
-  
-  
-  
-!!3. Requirements  
-  
-  
-*3.1 Hardware  
-  
-*3.2 Kernel  
-  
-*3.3 Console Software  
-  
-*3.4 XWindow  
-  
-*3.5 Others  
-  
-  
-  
-  
-  
-!!4. Kernel and hard stuff  
-  
-  
-*4.1 Kernel configuration  
-  
-*4.2 Kernel compilation  
-  
-*4.3 Before rebooting  
-  
-  
-  
-  
-  
-!!5. The Linux console  
-  
-  
-  
-  
-!!6. XWindow  
-  
-  
-*6.1 Having 2 mouses on the same system  
-  
-*6.2 Now on to the real stuff  
-  
-*6.3 The new module  
-  
-  
-  
-  
-  
-!!7. Further documentation  
-----  
-  
-!!1. Copyright  
-  
-  
-Copyright (c) 2000 by Arnaud Claden <tiamat@club-internet.fr>  
-  
-  
-This document describes the installation of Wacom tablets under linux.  
-You may use, disseminate, and reproduce this document freely, provided you:  
-  
-  
-  
-  
-  
-#Do not omit or alter this copyright notice.  
-#  
-  
-#Do not omit or alter the version number and date.  
-#  
-  
-#Do not omit or alter the document's pointer to the current WWW version.  
-#  
-  
-#Clearly mark any condensed, altered or modified versions as such.  
-#  
-  
-----  
-  
-!!2. Introduction  
-  
-  
-This document is a guide to getting your Wacom Graphire USB tablet to working  
-with Linux. Beware, this is a quite difficult task, but this guide will guide  
-you, step-by-step, through the process.  
-  
-  
-This work is mainly derived from the Wacom Tablet HOWTO by Stephan Runkel,  
-but brings some precisions about all the USB configuration that is absent from  
-the original document. If you want more precision about general Wacom Tablets,  
-please read Stephan Runkel's HOWTO.  
-  
-  
-I have written this document because I've had many difficulties in setting  
-up my brand new Graphire tablet with Linux, but now it works quite well on  
-my Toshiba 4030CDT Laptop.  
-  
-!!2.1 New versions of this document  
-  
-  
-  
-New version of this document will be made available at the following location  
-:  
-  
-  
-http://perso.club-internet.fr/tiamat/computer/howto/Wacom_USB-Mini_HOWTO.html  
-  
-!!2.2 Feedback and Corrections  
-  
-  
-  
-Comments, corrections, and additions will greatly be appreciated. I can  
-be contacted at:  
-  
-  
-<tiamat@club-internet.fr>  
-  
-!!2.3 Acknowledgements  
-  
-  
-  
-I wish to thank everyone that work on the USB part of the kernel, and special  
-thanks go to Vojtech Pavlik for his work on the wacom module.  
-  
-  
-Of course, I thank Stephan Runkel for his great Wacom Tablet HOWTO that  
-helped me much in the configuration process.  
-  
-  
-Special thanks also go to Frederic Lepied for his work on the xf86Wacom  
-module.  
-  
-!!2.4 Disclaimer  
-  
-  
-  
-The information in this document is correct to the best of my knowledge,  
-but there's a always a chance I've made some mistakes, so don't follow everything  
-too blindly, especially if it seems wrong. Nothing here should have a detrimental  
-effect on your computer, but just in case I take no responsibility for any  
-damages incurred from the use of the information contained herein.This document  
-is not a kernel howto, so I'll take the assumption that you know how to download/install  
-a new kernel, and how to configure/compile it.  
-----  
-  
-!!3. Requirements  
-  
-!!3.1 Hardware  
-  
-  
-  
-The main part is, of course, a computer with at least one USB port and  
-a Wacom Graphire USB tablet.  
-  
-!!3.2 Kernel  
-  
-  
-  
-I've used the latest development kernel for my installation : linux-2.3.99-pre6.  
-It's quite stable and has all the necessary features. You can also find some  
-downports, which are patches for old 2.2.x kernels. You can find all the infos  
-on the backport at http://www.suse.cz/development/usb-backport  
-  
-!!3.3 Console Software  
-  
-  
-  
-For the Linux console, the only program you need is gpm, available at ftp://ftp.prosa.it/pub/gpm  
-  
-!!3.4 XWindow  
-  
-  
-  
-For having all the abilities of your tablet, you'll need to use XInput.  
-More specifically you'll need the xf86Wacom.so module (that is shipped with  
-the most recent versions of XFRee86 starting from 3.3.5). Alternately, you  
-may need the xf86WacomUSB.so, which is a work-in-progress of adapting the original  
-xf86Wacom.so to use the USB. I'll speak of it later in this document.  
-  
-!!3.5 Others  
-  
-  
-  
-The applications supporting XInput are :  
-  
-  
-  
-  
-  
-#The Gimp - a powerful image manipulation program in the style of Photoshop.  
-The 1.1.x instable development version includes XInput support as a standard  
-feature. You can obtain Gimp from http://www.gimp.org  
-#  
-  
-#gsumi - a simple B/W drawing program that supports drawing / erasing with  
-pressure and tilt sensitivity. Get it from the gsumi web page: http://www.gtk.org/~otaylor/gsumi/  
-#  
-  
-#xink (By Ralph Levien) - another rudimentary drawing program for X. xink  
-is available from: ftp://kiwi.cs.berkeley.edu/pub/raph/xink.tar.gz  
-#  
-  
-#!RasMol - a molecular visualization program that supports a hardware dial  
-box using XInput. look at http://www.umass.edu/microbio/rasmol/distrib/rasman.htm  
-.  
-#  
-  
-#xinput (by Frederic Lepied) - a very useful utility for configuring and  
-testing XInput devices. xinput is available from: ftp://ftp.x.org/contrib/utilities/xinput-1.2.tar.gz  
-#  
-  
-----  
-  
-!!4. Kernel and hard stuff  
-  
-!!4.1 Kernel configuration  
-  
-  
-  
-Like I said earlier, the options I'll give come from the 2.3.99pre6 kernel.  
-If everything is not exactly the same, I think that taking a good guess should  
-help ;)  
-  
-  
-__** Reminder : [ [] stands for Yes/No options, and <> stands  
-for Yes/No/Module **__  
-  
-  
-First of all, you have to enable the experimental code :  
-  
-  
-__Code Maturity level options --->__  
-  
-  
-__[[*] Prompt for development and/or incomplete code/drivers__  
-  
-  
-If you don't, you won't have access to some of the drivers.  
-  
-  
-Then, move on to the USB section.  
-  
-  
-__USB support --->__  
-  
-  
-__<*> Support for USB__  
-  
-  
-__[[*] USB verbose debug messages__  
-  
-  
-__--- Miscellaneous USB options__  
-  
-  
-__[[*] Preliminary USB device filesystem__  
-  
-  
-With this option, you'll activate the new features of the /dev/usb/* (which,  
-of course, you'll have to create : to be seen later)  
-  
-  
-__--- USB controllers__  
-  
-  
-__<*> UHCI (Intel PIIX4, VIA, ...) support__  
-  
-  
-__< > OHCI (Compaq, iMacs, OPTi, SiS, ALi, ...) support__  
-  
-  
-You must choose one of these, and only one. So, if one doesn't work, then  
-choose the other. Chances are that, if you use an x86 system, you'll take the  
-UHCI driver.  
-  
-  
-__--- USB Devices__  
-  
-  
-__< > USB Printer support__  
-  
-  
-__< > USB Scanner support__  
-  
-  
-__< > USB Audio support__  
-  
-  
-__< > USB Modem (CDC ACM) support__  
-  
-  
-If you have one of these, feel free to activate the options  
-  
-  
-__<M> USB Serial Converter support__  
-  
-  
-This options must be activated for the Wacom tablet to work.  
-  
-  
-__[[*] 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__  
-  
-  
-If you want to have all the messages (which can be very helpful in the  
-beginning). When satisfied with the functionning, you can deactivate it.  
-  
-  
-__< > 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__  
-  
-  
-The HID is kinda the interface between you and your devices, so you MUST  
-activate it.  
-  
-  
-__<M> USB Human Interface Device (HID) support__  
-  
-  
-__< > USB HIDBP Keyboard support__  
-  
-  
-__< > USB HIDBP Mouse support__  
-  
-  
-__<M> Wacom Intuos/Graphire tablet support__  
-  
-  
-There we go, the Wacom support should be activated (unless you read this  
-just for fun ;) )  
-  
-  
-__< > Logitech !WingMan Force joystick support__  
-  
-  
-__< > Keyboard support__  
-  
-  
-__<M> Mouse support__  
-  
-  
-To be activated to use the Wacom Intuos/Graphire mouse  
-  
-  
-__(1024) Horizontal screen resolution__  
-  
-  
-__(768) Vertical screen resolution__  
-  
-  
-__<M > Joystick support__  
-  
-  
-__<M> Event interface support__  
-  
-!!4.2 Kernel compilation  
-  
-  
-  
-Now the easy stuff :  
-  
-  
-When you exit the configuration do as they say  
-  
-  
-__make dep bzImage modules modules_install__  
-  
-  
-Type it just like this and the computer will run all the steps one after  
-the other.  
-  
-  
-Then copy the file bzImage to /boot, copy the System.map to /boot, edit  
-your lilo.conf to point to your new kernel and type __/sbin/lilo__ at the prompt.  
-  
-  
-__** Of course all of this (kernel config, kernel compilation and lilo tweaking  
-must be done as root) **__  
-  
-!!4.3 Before rebooting  
-  
-  
-!FStab  
-  
-  
-If you want to avoid error messages at the next reboot, you'll have to  
-do the following :  
-  
-  
-Edit the file /etc/fstab and add the following lines  
-  
-  
-__none /proc/bus/usb usbdevfs defaults 0 __  
-  
-  
-This one is to activate the usb device filesystem  
-  
-  
-__none /var/shm shm defaults 0 __  
-  
-  
-This one is because of a change in the shared memory stuff in the kernel.  
-  
-!USB related devices  
-  
-  
-Next, if you want to be able to use the USB :  
-  
-  
-__mkdir /dev/input__  
-  
-  
-__mknod /dev/input/mouse0 c 13 32__  
-  
-  
-This will activate the mouse support  
-  
-  
-__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__  
-  
-  
-These will activate the stylus : moves, pressure, button and eraser.  
-  
-!Modules configuration  
-  
-  
-Edit the file /etc/modules.conf and add the following line :  
-  
-  
-__alias char-major-13 usbcore__  
-  
-!What I did next  
-  
-  
-Next I added in the /etc/rc.d/boot.local file (remember, I use a SuSE distribution,  
-but you should fine an equivalent for !RedHat in /etc/rc.d/init.d/boot.local  
-or /etc/rc.d/init.d/rc.local)  
-  
-  
-__/sbin/modprobe wacom__  
-  
-  
-__/sbin/modprobe mousedev__  
-  
-  
-__/sbin/modprobe evdev__  
-  
-  
-Just to be sure the modules will load at boot time.  
-  
-!Last but not least  
-  
-  
-Reboot ;)  
-  
-  
-Check your boot messages (__dmesg | less__), and see if there are no errors  
-related to USB. It may be because you've chosen UHCI and your system is an  
-OHCI one.  
-  
-  
-On my system, the following messages are shown :  
-  
-  
-__..... __  
-  
-  
-__..... __  
-  
-  
-__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=, 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: __  
-  
-  
-__..... __  
-  
-  
-__.....__  
-  
-  
-When the kernel says "__This device is not recognized by any installed USB  
-driver__", it's because, at boot time, the wacom module is not yet loaded. But  
-as you can see, the whole USB bus and interfaces are recognized. So if your  
-system doesn't work and doesn't have such messages, try to check if you haven't  
-forgotten an USB option (something I indicated to be put in the kernel and  
-that you put as a module : if it's the case, in the __/etc/rc.d/init.d/boot.local__,  
-put the necessary modprobe __BEFORE__ the 3 lines I indicated, for example __/sbin/modprobe  
-usb-uhci__).  
-  
-  
-When the wacom module loads, here are the messages :  
-  
-  
-__..... __  
-  
-  
-__..... __  
-  
-  
-__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 __  
-  
-  
-__..... __  
-  
-  
-__.....__  
-  
-  
-Retry and check everything until you get all these messages (or corresponding  
-ones).  
-----  
-  
-!!5. The Linux console  
-  
-  
-Now that you have your USB activated, it's just about time to try it all  
-with gpm :  
-  
-  
-If gpm is activated at boot time, you'll have to kill it : __gpm -k__  
-  
-  
-Then try your Wacom tablet : __gpm -tIMPS/2 -m /dev/input/mouse0__  
-  
-  
-Move your stylus, or your mouse, and TADA ... the cursor moves on the screen.  
-----  
-  
-!!6. XWindow  
-  
-!!6.1 Having 2 mouses on the same system  
-  
-  
-  
-Have you ever dreamed of having 2 mouses on your system ? If the answer  
-is yes, do the following.  
-  
-  
-Edit the file __/etc/XF86Config__  
-  
-  
-The modules section should look like this  
-  
-  
-__Section "Module"__  
-  
-  
-__Load "xf86Wacom.so"__  
-  
-  
-__!EndSection__  
-  
-  
-Then check the XInput section :  
-  
-  
-__Section "XInput"__  
-  
-  
-__!SubSection "Mouse"__  
-  
-  
-__!DeviceName "!WacomTablet"__ --> or whatever you like  
-  
-  
-__Protocol "IMPS/2"__ --> I didn't manage to have imwheel recognize the wheel,  
-but if you do, drop me an email  
-  
-  
-__Port "/dev/input/mouse0"__  
-  
-  
-__Buttons 5__  
-  
-  
-__ZAxisMapping 4 5__  
-  
-  
-__!AlwaysCore__ --> means that the Wacom mouse is always considered as the  
-core pointer, ie if you move your normal mouse or the Wacom mouse (or stylus),  
-it'll be just the same.  
-  
-  
-__!EndSubSection__  
-  
-  
-__!EndSection__  
-  
-  
-And there you are, the Wacom mouse (or stylus) is now considered as a second  
-mouse, but your normal one still works.  
-  
-!!6.2 Now on to the real stuff  
-  
-  
-  
-Back to the XInput section, after the parameters for the mouse, here is  
-the real Wacom stuff :  
-  
-  
-__!SubSection "!WacomStylus"__  
-  
-  
-__Port "/dev/input/event0"__ --> the USB event device  
-  
-  
-__!DeviceName "!WacomStylus"__ --> or whatever you want to call it  
-  
-  
-__Mode Absolute__ --> ie the tablet surface is equivalent to the screen  
-surface  
-  
-  
-__#Suppress 6__  
-  
-  
-__!DebugLevel 10__ --> once everything works, set it to  
-  
-  
-__#!TiltMode__  
-  
-  
-__#!HistorySize 200__  
-  
-  
-__#!AlwaysCore__  
-  
-  
-__#!KeepShape__  
-  
-  
-__#TopX 20412__ --> the 4 lines are used to fine-tune the coordinate  
-to fit with the screen  
-  
-  
-__#TopY 14730__  
-  
-  
-__#BottomX __  
-  
-  
-__#BottomY __  
-  
-  
-__!EndSubSection__  
-  
-  
-__!SubSection "!WacomEraser"__  
-  
-  
-__!DeviceName "/dev/input/event0"__  
-  
-  
-__!DeviceName "!WacomEraser"__  
-  
-  
-__Mode Absolute__  
-  
-  
-__!EndSubSection__  
-  
-  
-__!SubSection "!WacomCursor"__  
-  
-  
-__Port "/dev/input/event0"__  
-  
-  
-__!DeviceName "!GraphireMouse"__  
-  
-  
-__Mode Absolute__  
-  
-  
-__!EndSubSection__  
-  
-!!6.3 The new module  
-  
-  
-  
-The xf86Wacom.so is not specifically written for the USB tablets, and it's  
-even not working correctly with these tablets. A new driver has been written  
-by Matsumura Namihiko <po-jp@geocities.co.jp> has written one named xf86WacomUSB  
-(available as source code at the same location than this Mini-HOWTO). However,  
-to be able to compile it, you'll need the kernel source code and the source  
-tree for XFree86 (I compiled it with success against XFree86 3.3.5, but it  
-should compile with 3.3.6).  
-  
-  
-This driver doesn't handle all the possibilities of the tablet, and crashes  
-if you pass it the __!AlwaysCore__ parameter.  
-  
-  
-To correct this, I'll keep in touch with Frederic Lepied for a modification  
-of the original module to have it handle all of the possibilities of the tablet.  
-  
-  
-__**NEWS** At Frederic Lepied's site, you'll find a link to a new USB driver  
-that works perfectly well, but exclusively with the possibility to have your  
-tablet working as a mouse : ie either you use your tablet in The Gimp to draw,  
-or you use it as an XFree mouse, but not both together. I'll investigate further,  
-and update this document accordingly.__  
-----  
-  
-!!7. Further documentation  
-  
-  
-For more information about Wacom tablets in general, try the great Wacom  
-tablet HOWTO from Stephan Runkel <runkel@runkeledv.de> : http://www.linuxdoc.org/HOWTO/Wacom-Tablet-HOWTO.html  
-  
-  
-About the xf86Wacom.so, check Frederic Lepied's <lepied@xfree86.org>  
-: http://www.lepied.com/xfree86  
-  
-  
-xf86WacomUSB.so, available at ftp://ftp.aros .org/pub  
-----  
+Describe [HowToWacomUSBminiHOWTO ] here.