View on GitHub
DIGImend
Improving Linux support for graphics tablets.

Tablet setup with WizardPen

If your kernel does not support your tablet the recommendation is to use the digimend-kernel-drivers. For supported kernel versions and tablets see the README.md file.

However, there are tablets that do not yet have a kernel driver. While waiting for a kernel driver to be developed for a currently unsupported tablet, you might want to try the WizardPen driver as a work around. Both UC-logic and Waltop tablets have reported success with it on recent kernels and X Servers even though it has been deprecated. Ubuntu Precise 12.04 (kernel 3.2 and X server 1.11/1.12) and Quantal 12.10 (kernel 3.5 and X Server 1.13) for example. You might be able to enable your pen and maybe your pen buttons. The tablet’s frame buttons and mouse (if it has them) will require the kernel driver.

NOTE: The DIGImend project does not develop nor support the WizardPen driver. This is a suggestion intended to be temporary work around for the convenience of unsupported tablet users.

Obtain the WizardPen driver

Download the latest WizardPen driver tar (wizardpen_0.8.1) from Martin Owen’s Launchpad PPA onto your Desktop. Open a terminal and run (copy and paste) the following commands:

cd Desktop 
wget https://launchpad.net/~doctormo/+archive/xorg-wizardpen/+files/xserver-xorg-input-wizardpen_0.8.1-0ubuntu3.tar.gz

Extract it onto your Desktop by running the following in the terminal:

tar xvzf xserver-xorg-input-wizardpen_0.8.1-0ubuntu3.tar.gz

Compile the WizardPen driver

These instructions are Ubuntu centric but you should be able to adapt them to other Distros. With a little detective work you can find the names your Distro uses for the libraries. And you would use your Distro’s package manager and equivalent of sudo naturally.

Preliminaries

The dependencies listed in the WizardPen README are:

build-essential xutils-dev xutils libx11-dev libxext-dev xautomation xinput xserver-xorg-dev

In Ubuntu build-essential contains the gcc and C development library along with the Debian package development tools and make utility.

Additionally in Ubuntu the following were added to cover “all the bases”:

autoconf libtool pkg-config

But not all of them may be necessary.

Compiling

Then to compile run the following commands:

sudo apt-get install build-essential xutils-dev xutils \
             libx11-dev libxext-dev xautomation xinput \
             xserver-xorg-dev autoconf libtool pkg-config
cd xserver-xorg-input-wizardpen-0.8.1
./autogen.sh --prefix=/usr
make
sudo make install

Installed files

When it is compiled and installed you will end up with following:

  1. the WizardPen X driver at /usr/lib/xorg/modules/input/wizardpen_drv.so (and wizardpen_drv.la)
  2. the WizardPen udev rules at /etc/udev/rules.d/67-xorg-wizardpen.rules
  3. the wizardpen .conf at /usr/share/X11/xorg.conf.d/70-wizardpen.conf
  4. calibration executable (alternative to xinput_calibrator) at /usr/bin/wizardpen-calibrate
  5. the WizardPen manual (i.e. man wizardpen in a terminal) at /usr/share/man/man4/wizardpen.4

Tablets in 67-xorg-wizardpen.rules

Tablet OEMs and models in the Wizardpen udev rules are supported by the WizardPen driver through its 70-wizardpen.conf. Tablets not included will need a custom .conf file, see X.org configuration below. To determine your tablet’s Vendor ID and Product ID enter lsusb in a terminal and look at the tablet’s line in the output, e.g. 5543:6001.

AceCad Corp

Flair II GT-504
VENDOR_ID=”0460”, Product ID=”0004”

KYE Systems Corp

KYE Systems Corp Wide Screen Design Tablet TB-7300
VENDOR ID=”0458”, Product ID=”5003”
KYE Systems Corp Wide Screen Design Tablet TB-7300
VENDOR ID=”0458”, Product ID=”5004”

UC-Logic Technology Corp

SuperPen WP3325U Tablet
VENDOR_ID=”5543”, Product ID=”0002”
WP4030, Genius MousePen 4x3 Tablet/Aquila L1 Tablet
VENDOR_ID=”5543”, Product ID=”0003”
WP5540, Genius MousePen 5x4 Tablet
VENDOR_ID=”5543”, Product ID=”0004”
WP8060, Genius MousePen 8x6 Tablet, Trust TB-6300
VENDOR_ID=”5543”, Product ID=”0005”
Genius PenSketch 6x8 Tablet
VENDOR_ID=”5543”, Product ID=”0041”
Genius PenSketch 12x9 Tablet
VENDOR_ID=”5543”, Product ID=”0042”
Digital Organizer (may not exist)
VENDOR_ID=”5543”, Product ID=”6000”
Genius G-Note 5000
VENDOR_ID=”5543”, Product ID=”6001”

X.org configuration

70-wizardpen.conf

This .conf file is installed in /usr/share/X11/xorg.conf.d when the WizardPen driver is compiled.

Section "InputClass"
    Identifier "wizardpen"
    MatchIsTablet "on"
    MatchDevicePath "/dev/input/event*"
    MatchTag "wizardpen"
    Driver "wizardpen"
    Option       "TopX"      "1506"
    Option       "TopY"      "2705"
    Option       "BottomX"   "31225"
    Option       "BottomY"   "30892"
EndSection

The wizardpen.rules ensure MatchIsTablet matches and sets the “wizardpen” tag for MatchTag. You may want to remove it (or comment the lines out) if your tablet is not included in the udev rules, unless you prefer to create a rule for your tablet.

Custom tablet .conf

If your tablet is not one of the ones already included in the WizardPen udev rules above you will need to create a custom .conf file as described on the evdev or wacom driver pages. Add your custom .conf file to /etc/X11/xorg.conf.d. You may need to create the xorg.conf.d directory if it is not already there.

sudo mkdir /etc/X11/xorg.conf.d

Now using a text editor create the 52-tablet.conf:

gksudo gedit /etc/X11/xorg.conf.d/52-tablet.conf

and add the following snippet to it. Determine the keyword used below from the <device name> in the output of xinput list. Pick one as unique to your tablet as possible.

Section "InputClass"
    Identifier "Tablet on WizardPen"
    #MatchIsTablet "on"
    MatchProduct "keyword"
    MatchDevicePath "/dev/input/event*"
    Driver "wizardpen"
    # Apply custom Options below.
EndSection

Save, Close, and restart. Provided you have done the match correctly with luck your pen should be working. You can check if you succesfully placed the pen on the WizardPen driver by looking in Xorg.0.log at /var/log.

MatchIsTablet is commented out because the kernel might not be flagging the tablet’s pen as a tablet. If it does go ahead and use MatchIsTablet by removing the comment (#).

The WizardPen driver does not use the same options as the evdev or Wacom drivers so be sure to look at man wizardpen entered in a terminal.

Example custom .confs

For a H85 Kanvus tablet. The lsusb ouput is:

Bus 003 Device 016: ID 5543:0782 UC-Logic Technology Corp.

The xinput list output is:

⎜ ↳ H850S id=10 [slave pointer (2)]
⎜ ↳ H850S id=11 [slave pointer (2)]

Since the <device name> is “H850S” there is no choice for a keyword, but “H850S” seems plenty unique.

Section "InputClass"
    Identifier "UC-Logic tablet"
    MatchIsTablet "on"
    MatchProduct "H850S"
    MatchDevicePath "/dev/input/event*"
    Driver "wizardpen"
    # Apply custom Options below.
EndSection

For a Kanvus Note A4. The lsusb ouput is:

Bus 003 Device 053: ID 5543:6003 UC-Logic Technology Corp.

The xinput list output is:

⎜ ↳ UC-LOGIC DIGITAL-Organizer id=11 [slave pointer (2)]

Given the <device name>, “UC-LOGIC” is a reasonable keyword. And it could be combined with “H850S” creating a match to the Kanvus H85 also.

Section "InputClass"
    Identifier "UC-Logic tablet"
    MatchIsTablet "on"
    MatchProduct "UC-LOGIC|H850S"
    MatchDevicePath "/dev/input/event*"
    Driver "wizardpen"
    # Apply custom Options below.
    Option      "TopX"      "-10"
    Option      "TopY"      "45"
    Option      "BottomX"   "4020"
    Option      "BottomY"   "2842"
EndSection

For an ACCU branded Waltop tablet. The lsusb ouput is:

Bus 004 Device 003: ID 172f:0051 Waltop International Corp.

The xinput list output is:

⎜ ↳ WALTOP International Corp. PEN-INPUT DEVICE id=12 [slave pointer (2)]

Note: the output actually contained 3 lines with stylus, eraser, and pad appended because the tablet was originally setup on the Wacom driver, which did not work for it.

Here the <device name> is “WALTOP International Corp. PEN-INPUT DEVICE” making “WALTOP” a good choice for the keyword.

Section "InputClass"
    Identifier "Waltop pen"
    MatchIsTablet "on"
    MatchProduct "WALTOP"
    MatchDevicePath "/dev/input/event*"
    Driver "wizardpen"
    # Apply custom Options below.
    Option      "TopZ"      "50"  # pressure threshold
    Option      "TopX"      "-10"
    Option      "TopY"      "-10"
    Option      "BottomX"   "7210"
    Option      "BottomY"   "5410"
EndSection