README 4.04 KB
Newer Older
1
2
3
4
5
6
7
8
9
10
KDE 4 KCModule

This module implements a GUI for the Wacom Linux Drivers and extends it
with profile support to handle different button / pen layouts per profile.

For hardware support have a look at http://www.linuxwacom.sourceforge.net

Easy profile switching is added via a small plasma applet.
In addition a daemon running in the background helps with hotplug support.

11
All tablets can be set up as long as they are found with the wacom kernel module.
Jörg Ehrichs's avatar
Jörg Ehrichs committed
12
13
14
15

Check with
$ xsetwacom list devices
if your device is correctly recognized first. If it dosn't show up here I can't configure it.
16
17
18
19

Components:
* kded:
	runs in the background, detects a connected tablet and applies the pad button / stylus profile
Jörg Ehrichs's avatar
Jörg Ehrichs committed
20
21
	detects xrandr rotation and rotates the tablet with it
	apply global shortcuts for the the touch on/off stylus feature
22
23
24
25
26
27
28
29
30

* kcontrol module:
	unified gui to set-up the buttons and other aspects of the tablet

* plasma-applet:
	optional applet for easy switching between different profiles

Dependencies:
* wacom tablet driver especially the xsetwacom tool
Jörg Ehrichs's avatar
Jörg Ehrichs committed
31
32
33
34
35
36
37
38
39
* xserver-xorg-input-wacom >= 0.10.11

* kdelibs5-dev
* kdebase-workspace-dev
* xorg-dev
* xserver-xorg-dev
* libxi-dev
* libxinerama-dev
* x11proto-xinerama-dev
40
* libxrandr-dev
41
42
43
44
45
46
47
48
49
50

#################################################################
# install with

mkdir build
cd build
cmake ../ -DCMAKE_INSTALL_PREFIX=`kde4-config --prefix` -DCMAKE_BUILD_TYPE=release
make
make install

Jörg Ehrichs's avatar
Jörg Ehrichs committed
51
52
53
54
55
56
#################################################################
# start with

First the background daemon must be running. You can logout/login or restart the kded with
$ kquitapp kded
$ kded
57

Jörg Ehrichs's avatar
Jörg Ehrichs committed
58
Afterwards you get a notice when you plugin your device and can configure it via
59

Jörg Ehrichs's avatar
Jörg Ehrichs committed
60
$kcmshell4 kcm_wacomtablet
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
or have a look in the system settings where the keyboard and mouse settings are

##################################################################
# Add missing tablet devices

If your device is not recognized by this program but you can set it up via the xsetwacom driver.
You can add the missing lines yourself.

All you need is the tabletID.

------------------------------------------------
Step 1) Get real internal Tablet name

xsetwacom list dev

for my Wacom Bamboo:
Wacom Bamboo eraser ERASER    
Wacom Bamboo cursor CURSOR    
Wacom Bamboo pad PAD       
Wacom Bamboo     STYLUS 

------------------------------------------------
Step 2) Then you need the Tablet ID

xsetwacom get "Wacom Bamboo" tabletid

for my Wacom Bamboo:
101

------------------------------------------------
Step 3) Transform it into Hexadecimal

For my Wacom Bamboo: 0065

------------------------------------------------
Step 4) Add a new section into the right datafile
look at /usr/share/kde4/apps/wacomtablet/data/

for the Wacom Bamboo the right file is: wacom_devicelist

Add a new entry

for my Wacom Bamboo:

[0065]
model=MTE_450        # try to google for it but not used right now
layout=bl_6          # can be empty if no button layout is available that exists (see images dir)
name=Wacom Bamboo    # name as found above
padbuttons=4         # available buttons on the pad
wheel=no             
touchring=yes
touchstripl=no
Jörg Ehrichs's avatar
Jörg Ehrichs committed
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
touchstripr=no
hwbutton1=1          # these mag the physical button numbers to what the XServer likes to name them
hwbutton2=2          # see below for more information
hwbutton3=3
hwbutton4=8

--------------------------------------------------------------------
hwbuttonX explanantion:

Kernels >= 2.6.38 renamed the buttons for some reason.

xsetwacom does not work with the pysical hardware button numbers 1-X
but rather with the real numbers as seen by the XServer

In case you run into trouble with the buttons do the following:
* deinstall the kded/kcm ;)
* disconnect/reconnect the tablet
* run xev in the terminal
* move the mouse over the new window
* press the hardware buttons and write down what button xev sees

and now update the wacom_device list accordingly

for the new Pen & touch tablets before the kernel 2.6.38 we got
hwbutton1=1
hwbutton2=2
hwbutton3=3
hwbutton4=8

for kernels >= 2.6.38 we get 
hwbutton1=3
hwbutton2=8
hwbutton3=9
hwbutton4=1