Known tablets working with the Wizardpen-driver

The setup has been tested with the following USB tablets. Non-USB tablets are not covered by this guide.

Known Tablet Names (The packaging)

• Acecad Flair II GT-504

• DigiPro 5.5×4” Graphics Tablet

• Digital Ink Pad (A4 format)
• G-pen
• Genius Wizardpen
• Genius Mousepen
• Genius Easypen i405
• Genius
• iBall
• Manhattan
• Pentagram
• QWare
• Trust TB-3100
• Trust TB-5300
• Trust TB-6300
• UC-LOGIC
• iBall Tablet PF8060

• AIPTEK HyperPen 10000 U

• AIPTEK Slim Tablet U600 Premium II

If your tablet is working, but not listed here, please ADD it! (If you don't have an account, then email me: drpjkurian@gmail.com

Setting up your tablet

General information

As of march 2010 the latest wizardpen driver from Wizardpen on Launchpad is available for Ubuntu/Debian as xserver-xorg-input-wizardpen, with the following apt(itude) settings:

 deb http://ppa.launchpad.net/doctormo/xorg-wizardpen/ubuntu jaunty main
 deb-src http://ppa.launchpad.net/doctormo/xorg-wizardpen/ubuntu jaunty main 

It should install without hassle, includes HAL configs and drivers. You still should include the driver in xorg.conf (Section "InputDevice") as mentioned below.

Installing needed packages

Open a terminal

Install some needed packages - Run this command:

sudo apt-get install xutils libx11-dev libxext-dev build-essential \
            xautomation xinput xserver-xorg-dev xutils-dev

Downloading the driver

You can download the latest driver from Wizardpen on Launchpad. Either try to find a deb or a source package there, or get the latest version using bzr. If you choose to install a source package you can just extract it and skip to "Building and installing the driver".

To install bzr run:

sudo apt-get install bzr
bzr branch lp:wizardpen

Now we need to generate the ./configure script:

./autogen.sh

Building and installing the driver

Run these commands from the directory you installed the source:

Configure, make and install:

./configure --with-xorg-module-dir=/usr/lib/xorg/modules
        make && sudo make install

Check the integrity of the driver installation by typing the command.

ls /usr/lib/xorg/modules/input/wizardpen_drv.*

It should give the output as follows

/usr/lib/xorg/modules/input/wizardpen_drv.la
/usr/lib/xorg/modules/input/wizardpen_drv.so

Type the following command in the terminal to know the make of the Pentablet.

grep -i name /proc/bus/input/devices

Please note down the make of the tablet which you have to use in the next step.

Create a new .fdi file by using the following command in terminal

sudo vim /etc/hal/fdi/policy/99-x11-wizardpen.fdi

Press 'I' so that INSERT appears Paste the following template in the terminal

<?xml version="1.0" encoding="ISO-8859-1" ?>
            <deviceinfo version="0.2">
            <device>
                <!-- This MUST match with the name of your tablet obtained -->
                <!-- in Step 2 specified previously                        -->
                <match key="info.product" contains="NAME OF YOUR TABLET">
                <merge key="input.x11_driver" type="string">wizardpen</merge>
                <merge key="input.x11_options.SendCoreEvents" type="string">true</merge>

                <!-- Modify these configuration accordingly -->
                <!-- See CONFIGURATION OPTIONS section for the full-set of -->
                <!-- configurable options                                  -->
                <merge key="input.x11_options.TopX" type="string">5619</merge>
                <merge key="input.x11_options.TopY" type="string">6554</merge>
                <merge key="input.x11_options.BottomX" type="string">29405</merge>
                <merge key="input.x11_options.BottomY" type="string">29671</merge>
                </match>
            </device>
            </deviceinfo>

Please insert the name of your tablet where i have mentionrd NAME OF YOUR TABLET. This you can do by moving the cursor in the terminal with arrow keys. Click Esc and type :wq and press Enter to save the file you have created.

• Reboot your machine. It should work.

Calibration

8060 Note: In the subsection, you'll find output from calibrate! If you tablet is listed there, you can just use that output instead!

• If you tablet isn't listed, I would love to recieve an email with the output, and the model of your tablet! (See email at the end of the page!)

If you want to calibrate yourself, just proceed.

Enter the "calibrate"-directory - Run this command:

cd calibrate

Calibrate in order to find the edges of your tablet/digitizer - Run this command:

sudo ./wizardpen-calibrate /dev/tablet-event

You may find "/dev/tablet-event" missing, try this command to help find the correct value

ls /dev/input/by-id/

Example corrected "/dev/tablet-event" location. Use the value for rc.local and xorg.conf

/dev/input/by-id/usb-WALTOP_International_Corp._Slim_Tablet-event-if00

Save the output from wizardpen-calibrate (the last 10 lines!) - You'll need it later in this howto!

Calibration output (If calibrate for some reason doesn't work!)

Skip this section if calibrate worked for you!

Genius G-Pen F610 (WALTOP SlimTablet) :

Section "InputDevice"
        Identifier      "WizardPen Tablet"
        Driver          "wizardpen"
        Option          "Device"        "/dev/input/by-id/usb-WALTOP_International_Corp._Slim_Tablet-event-if00"
        Option          "TopX"          "295"
        Option          "TopY"          "210"
        Option          "BottomX"       "20000"
        Option          "BottomY"       "12500"
EndSection

Tablet W5540U (UC-Logic):

Section "InputDevice"
        Identifier      "WizardPen Tablet"
        Option          "SendCoreEvents"        "true"
        Driver          "wizardpen"
        Option          "Device"        "/dev/tablet-event"
        Option          "TopX"          "2199"
        Option          "TopY"          "3598"
        Option          "BottomX"       "30325"
        Option          "BottomY"       "29278"
EndSection

Tablet W8060U (UC-Logic):

Section "InputDevice"
        Identifier      "WizardPen Tablet"
        Option          "SendCoreEvents"        "true"
        Driver          "wizardpen"
        Option          "Device"        "/dev/tablet-event"
        Option          "TopX"          "826"
        Option          "TopY"          "2626"
        Option          "BottomX"       "32747"
        Option          "BottomY"       "32762"
EndSection

Tablet PF1209 (UC-LOGIC)

Section "InputDevice"
        Identifier      "WizardPen Tablet"
        Option          "SendCoreEvents"        "true"
        Driver          "wizardpen"
        Option          "Device"        "/dev/tablet-event"
        Option          "TopX"          "0"
        Option          "TopY"          "1553"
        Option          "BottomX"       "32541"
        Option          "BottomY"       "32762"
EndSection

Tablet W8060U (Trust TB-6300)

Section "InputDevice"
        Identifier      "WizardPen Tablet"
        Option          "SendCoreEvents"        "true"
        Driver          "wizardpen"
        Option          "Device"        "/dev/tablet-event"
        Option          "TopX"          "0"
        Option          "TopY"          "234"
        Option          "BottomX"       "32747"
        Option          "BottomY"       "32762"
EndSection

Setting up X

Now we are ready to edit the xorg.conf file!

Take a backup - Run this command:

sudo cp /etc/X11/xorg.conf /etc/X11/xorg.conf.backup

Edit the file - Run this command:

sudo vim /etc/X11/xorg.conf

Press "I" - So that "-- INSERT --" appears!

Insert the output from calibrate into xorg.conf: (just place it below your generic mouse!)

Add the following line in the "ServerLayout" section:

InputDevice "WizardPen Tablet" "AlwaysCore"

Save the file, and exit the editor! (Press "ESC" and write ":wq" and press "Enter")

Making X start without a tablet connected

Now, the driver should NOT be initialized, if the tablet is NOT found!

The wizardpen-driver does not support hotplugging, so we should run a script on startup, to define whether or not the tablet is present.

Open /etc/rc.local - Run this command:

sudo vim /etc/rc.local

Press "I" - So that "-- INSERT --" appears!

...and insert some code: (insert it JUST above "exit 0")

XORG_CONF=/etc/X11/xorg.conf
if [ -e /dev/tablet-event ]; then
  sed -ie 's/^\(\s*\)\#\(\s*InputDevice\s\s*\"WizardPen\ Tablet\"\s\s*\"AlwaysCore\"\)\s*$/\1\2/' "$XORG_CONF"
  echo "Udev created /dev/tablet-event = Tablet present! - Tablet-driver enabled"
else
  sed -ie 's/\(^\s*InputDevice\s\s*\"WizardPen\ Tablet\"\s\s*\"AlwaysCore\"\)\s*$/\#&/' "$XORG_CONF"
  echo "Udev did NOT create /dev/tablet-event = tablet NOT present! - Tablet-driver disabled"
fi

Save the file, and exit the editor! (Press "ESC" and write ":wq" and press "Enter")

Now you can test udev's ability to detect the tablet - Run this command:

sudo /etc/init.d/rc.local start

The output will tell you if it is present or not! - And it should match reality! (try to disconnect it, and try again! - connect, and then again! - etc...)

You should now be able to restart X and have the tablet working as a mouse.

I'm still working on a way to support hotplugging, but the above code-example will make X start without a present tablet.

Configuring the buttons on the pen

Special thanks to riesenpixel for writing the following part about the button-configuration!

There are two ways to change the button mapping:

The first way (Not very smart, since it also change the behaviour of your generic mouse!)

If you want to change the button mapping for all devices running in core mode, you should use xmodmap. (not recommended, try the second way first!)

Show the current configuration:

xmodmap -pp

You will get a table like this:

For example, if you now want to change the middle button and the right button, execute the following command:

xmodmap -e "pointer = 1 3 2"

Here is a list of numbers with their corresponding function:

If you want to disable a button (maybe because you know that one of the buttons causes some problems), use zero. Example (should disable the right click):

xmodmap -e "pointer = 1 2 0"

To reset the xmodmap-configuration, use this command:

xmodmap -e "pointer = default"

The second way

If you are using more devices than just the tablet (e. g. mouse+tablet or multiple tablets a. s. o.) you can use this second way to change the mapping just for one device.

• Step 1: Find the name of the device you want to change, e.g. with this command: xsetpointer -l alternatively you can use this command: xinput list

  Step 2: execute this command to swap the middle and the right button ("WizardPen Tablet" is the device – if you want to change the configuration of another device, you have to change the name; use the table above to define other buttons)

xinput set-button-map "WizardPen Tablet" 1 3 2

Hint: If you experience problems with the buttons, use:

xinput set-button-map "WizardPen Tablet" 1 0 0

or, if you have a pen with 32 buttons

xinput set-button-map "WizardPen Tablet" 1 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0

...to disable all buttons on your pen (for instance if you just want to draw).

Troubleshooting - See this if you have any problems

Everything worked great! Except the mouse doesn't move at all!

This is known to be an issue with WP8060 at least, and possibly other models. Fortunately, there is a common fix as well! You need to go back into /etc/X11/xorg.conf and modify the InputDevice section a little:

Section "InputDevice"
       Identifier  "Tablet"
       Option "Name" "UC-LOGIC Tablet WP8060U"
       Option "SendCoreEvents" "true"
       Driver          "wizardpen"
       Option           "TopX"          "2650"
       Option           "TopY"          "3563"
       Option           "TopZ"          "10"
       Option           "BottomX"       "30733"
       Option           "BottomY"       "29715"
       Option           "BottomZ"       "511"
EndSection

The whole block is shown to indicate context. The main thing to change is the

Option "Name" "UC-LOGIC Tablet WP8060U"

part. Set the name to whatever type you have.

Reboot the XServer by logging out and back in, or typing sudo /etc/init.d/gdm restart, or reboot your computer, and you're good to go!

After X server restart, display reverts to "Safe Mode"

From xtoast's suggestion on the discussion page (linked at the bottom of this article), I found the ServerLayout line provided in the Setting up X section above causes my xorg.conf to 'forget' basic video display settings. I used the line suggested on the discussion page instead:

InputDevice     "Tablet"     "SendCoreEvents"

Restarted the PC and everything worked! I did not follow the rest of the advice on the linked page because just modifying the ServerLayout line resolved my problem.

The command cat /var/log/Xorg.0.log | grep "wizardpen" outputs errors

The output of

cat /var/log/Xorg.0.log | grep "wizardpen"

• may reveal several errors, some of them are:

Module present, but with compilation-errors:

(II) LoadModule: "wizardpen"
(II) Loading /usr/lib/xorg/modules/input/wizardpen_drv.so
dlopen: /usr/lib/xorg/modules/input/wizardpen_drv.so: undefined symbol: __stack_chk_fail_local
(EE) Failed to load /usr/lib/xorg/modules/input/wizardpen_drv.so
(II) UnloadModule: "wizardpen"
(EE) Failed to load module "wizardpen" (loader failed, 7)
(EE) No Input driver matching `wizardpen'

Module missing:

(II) LoadModule: "wizardpen"
 (WW) Warning, couldn't open module wizardpen
(II) UnloadModule: "wizardpen"
 (EE) Failed to load module "wizardpen" (module does not exist, 0)
(EE) No Input driver matching `wizardpen'

The Xserver is not starting after playing with the xorg.conf file

Wow - That's bad! - First of all, check that you set everything right!

Well, I suggest that you drop me an email, telling me what went wrong!

And then just restore the backup we created - run this command:

sudo cp /etc/X11/xorg.conf.backup /etc/X11/xorg.conf

Everything seems to work, except pressure sensitivity

All the tablets mentioned in "known tablets" has pressure sensitivity support in Linux!

If pressure-sensitivity doesn't work, there are 3 possible causes!

1. The driver is not properly installed

2. The tablet is not supported by this driver

3. The application is not properly configured, to accept pressure sensitivity.

Please make sure that your favourite application supports pressure sensitivity.

Please tell me about other applications!

Pressure sensitivity works, but is not calibrated well

The section we inserted into xorg.conf holds some options to calibrate the area of the tablet, but I haven't put in options to configure pressure sensitivity, since it varies a lot.

You can insert these options to enable MAX and MIN pressure sensitivity:

• Option "TopZ" "10" Option "BottomZ" "511"

Where "TopZ" represents the lowest pressure-level to accept, and "BottomZ" represents the maximum pressure-level to accept.

The tablet is automatically detected as a generic mouse

In addition to the Wizardpen configuration, my system automatically configured the tablet as a generic, relative-positioned mouse. This double configuration caused the mouse pointer to move out of sync with the tablet's absolute position. Explicitly defining X11's CorePointer Device prevented auto-configuration of the tablet, leaving Wizardpen the only driver using the device (the desired behavior). For an example configuration, see the forum post: How do I -disable- tablet control of the mouse?.

I have problems not solved by the above troubleshooting

Try one of these forums:

http://www.stud.fit.vutbr.cz/~xhorak28/unb/forum.php

http://ubuntuforums.org/showthread.php?t=1337260

Related articles

Talking about hotplugging: (haven't tested it! - Please mail me in case it works, and should be implemented here!) http://deadcabbit.blogspot.com/2007/07/linux-genius-wizardpen-setup-for-udev.html

CategoryHardware