WACOM(4) Kernel Interfaces Manual WACOM(4)
wacom - Wacom input driver
Option "Device" "devpath"
wacom is an X input driver for Wacom devices.
The wacom driver functions as a pointer input device.
This driver supports the Wacom IV and Wacom V protocols. Serial tablets only need this driver. USB tablet support is available on some
Linux platforms and requires the wacom kernel driver being loaded before this driver starts.
Please check http://linuxwacom.sourceforge.net for latest updates of Wacom X and kernel drivers.
DRIVER-INTERNAL DEVICE HOTPLUGGING
When input device hotplugging in the X server is enabled and no InputDevice section exists for a compatible tablet device and an InputClass
section (see xorg.conf.d(5x)) assigns this driver for the device, the wacom driver creates multiple X devices for each a physical device,
one X device for each available tool. The list of tools is hardware-dependent. See Option Type as outlined in the CONFIGURATION DETAILS
These tool-specific devices are referred to as parent device and dependent device. The parent device is the one presented by the system
and the one that causes the X server to load the wacom driver. This parent device then causes the automatic addition of several dependent
devices. If the parent device is unplugged or otherwise removed, the dependent devices will be automatically removed as well.
Dependent devices may be assigned tool-specific options through additional InputClass sections. We recommend that a MatchDriver wacom line
is used in these sections in addition to the user-specific pattern.
Match directives are applied by the X server before the driver is selected. The type name of the parent device is appended by the driver.
It is not possible to use a MatchProduct directive to match against this appended type name.
Please refer to xorg.conf(5x) or xorg.conf.d(5x) for general configuration details and for options that can be used with all input drivers.
This section only covers configuration details specific to this driver.
Multiple instances of the Wacom devices can cohabit. Each device supports the following entries:
Option "Type" "stylus"|"eraser"|"cursor"|"pad"|"touch"
sets the type of tool the device represents. This option is mandatory. The core options, such as "SendCoreEvents" or
"AlwaysCore", are unnecessary in Gimp if you don't need to move system cursor outside of Gimp drawing area. "pad" is for
Intuos 3 or Cintiq 21UX tablet ExpressKeys/menu strips, and Graphire 4 or Bamboo tablet buttons, wheel, and/or ring. It is
required for Intuos3, CintiqV5, Graphire 4, and Bamboo if you want to use keystroke features. "pad" is reported as a second
tool in the driver. "touch" is for the tablet with touch support. Right now only a few Tablet PCs have this feature.
Option "Device" "path"
sets the path to the special file which represents serial line where the tablet is plugged. You have to specify it for each
subsection with the same value if you want to have multiple devices with the same tablet. This option is mandatory.
Option "Suppress" "number"
sets the position increment under which not to transmit coordinates. This entry must be specified only in the first Wacom sub-
section if you have multiple devices for one tablet. If you don't specify this entry, the default value, which is 2, will be
used. To disable suppression, the entry should be specified as 0. When suppress is defined, an event will be sent only when
at least one of the following conditions is met:
the change between the current X coordinate and the previous one is greater than suppress;
the change between the current Y coordinate and the previous one is greater than suppress;
the change between the current pressure and the previous one is greater than suppress;
the change between the current degree of rotation and the previous one of the transducer is greater than suppress;
the change between the current absolute wheel value and the previous one is equal to or greater than suppress;
the change between the current tilt value and the previous one is equal to or greater than suppress (if tilt is sup-
relative wheel value has changed;
button value has changed;
proximity has changed.
Option "Mode" "Relative"|"Absolute"
sets the mode of the device. The default value for stylus, pad and eraser is Absolute; cursor is Relative; touch defaults to
Relative for tablets with touch pads and Absolute for touch screens.
Option "TopX" "number"
X coordinate of the top corner of the active zone. Default to 0.
Option "TopY" "number"
Y coordinate of the top corner of the active zone. Default to 0.
Option "BottomX" "number"
X coordinate of the bottom corner of the active zone. Default to width of the tablet.
Option "BottomY" "number"
Y coordinate of the bottom corner of the active zone. Default to height of the tablet.
Option "ButtonsOnly" "on"|"off"
disables the device's motion events. Default to off.
Option "ButtonM" "AC"
reports an action AC when button M is pressed, where M is one of the device supported button numbers, it can be 1 to 32.
Wacom uses a driver-internal button mapping, where any physical button appears to the X server as the button specified by the
ButtonM mapping. Hence, if two physical buttons have the same ButtonM mapping, the server will think they are the same physical
button. The default action reported to the X server is mouse button M click. Because X uses buttons 4, 5, 6, and 7 as the four
scrolling directions, physical buttons 4 and higher are mapped to 8 and higher by default. To ignore the button click, i.e.,
to not report any button click event to the X server, use "0" or "button 0".
Option "TPCButton" "on"|"off"
enables the stylus buttons as Tablet PC buttons. If enabled, the stylus reports button events only when its tip is pressed. If
any button is down, pressing the tip reports a button event for the button. Otherwise if no button is down, the tip reports as
usual. Default to "on" for Tablet PCs; "off" for all other models. Only available on the stylus tool.
Option "Touch" "on"|"off"
enables the touch event for Tablet PC that supports touch feature, i.e., system cursor moves when user touches the tablet.
Default to "on" for Tablet PCs with touch feature; "off" for all other models.
Option "Rotate" "CW"|"CCW"|"HALF"|"NONE"
rotates the tablet orientation counterclockwise (CCW) or clockwise (CW) or 180 degrees (HALF). If you have specific tablet
mappings, i.e. TopX/Y or BottomX/Y were set, the mapping will be applied before rotation. Rotation must be applied to the par-
ent device (usually the stylus), rotation settings on in-driver hotplugged devices (see DRIVER-INTERNAL DEVICE HOTPLUGGING )
will be ignored. The default is "NONE".
Option "PressCurve" "x1,y1,x2,y2"
sets pressure curve by control points x1, y1, x2, and y2. Their values are in range from 0..100. The pressure curve is inter-
preted as Bezier curve with 4 control points, the first and the last control point being fixed on the coordinates 0/0 and
100/100, respectively. The middle control points are adjustible by this setting and thus define the shape of the curve. The
input for linear curve (default) is "0,0,100,100"; slightly depressed curve (firmer) might be "5,0,100,95"; slightly raised
curve (softer) might be "0,5,95,100". The pressure curve is only applicable to devices of type stylus or eraser, other devices
do not honor this setting.
Option "DebugLevel" "number"
sets the level of debugging info for tool-specific messages. There are 12 levels, specified by the integers between 1 and 12.
All debug messages with a level less than or equal to the "number" will be logged into the Xorg log file. This option is only
available if the driver was built with debugging support.
Option "CommonDBG" "number"
sets the level of debugging info for common (i.e. not tool-specific) code paths on the tablet. There are 12 levels, specified
by the integers between 1 and 12. All debug messages with a level less than or equal to the "number" will be logged into the
Xorg log file. This option is only available if the driver was built with debugging support.
Option "CursorProx" "number"
sets the max distance from tablet to stop reporting movement for cursor in relative mode. Default for Intuos series is 10, for
Graphire series (including Volitos) is 42. Only available for the cursor/puck device.
Option "RawSample" "number"
Set the sample window size (a sliding average sampling window) for incoming input tool raw data points. Default: 4, range
of 1 to 20.
Option "Serial" "number"
sets the serial number associated with the physical device. This allows to have multiple devices of the same type (i.e. multi-
ple pens). This option is only available on wacom V devices (Intuos series and Cintiq 21U). To see which serial number belongs
to a device, you need to run the utility program, xsetwacom, which comes with linuxwacom package.
Option "ToolSerials" "number[,type[,label]][;...]"
sets the list of serial numbered devices that need to be hotplugged for a physical device. The 'type' option may be any of
"pen", "airbrush", "artpen", or "cursor". This option is only available on wacom V devices (Intuos series and Cintiq 21U). To
see which serial number belongs to a device, you need to run the utility program, xsetwacom, that comes with this driver.
Option "Threshold" "number"
sets the pressure threshold used to generate a button 1 events of stylus. The threshold applies to the normalised pressure
range of [0..2048]. The default is 27.
Option "Gesture" "bool"
Enable or disable gesture support on the device. Default: off unless the tablet supports multi-touch.
Option "ZoomDistance" "number"
If Option "Gesture" is enabled, this option specifies the minimum movement distance before a zoom gesture is recognized.
Option "ScrollDistance" "number"
If Option "Gesture" is enabled, this option specifies the minimum movement distance before a scroll gesture is recognized.
Option "TapTime" "number"
If Option "Gesture" is enabled, this option determines the maximum time of a touch event to be recognized as tap. A press and
release event shorter than TapTime generates button press and release events. Presses longer than TapTime do not generate but-
ton events, only motion events.
Left click: tap, actual click happens after TapTime period elapses.
Left click drag: tap to select, quickly (within TapTime period) touch selection again. Then drag. Available on touchpads, e.g. BambooPT,
Right click: one finger down + tap second finger
Vertical scroll: two fingers side by side (in any orientation) moving vertically with constant separation initiates a vertical scroll. By
driver default a gesture up results in a scroll down event (the document moves up) and a gesture down results in a scroll up event (moving
the document down).
Horizontal scroll: two fingers side by side held at a constant distance moving horizontally initiates a horizontal scroll. A gesture to
the left results in a scroll right event (the document moves left) and a gesture right results in a scroll left event (moving the document
Zoom in: two separated fingers side by side, bring together i.e. pinch.
Zoom out: two fingers side by side, spread. Not all applications support zoom.
Xorg(1), xorg.conf(5), xorg.conf.d(5), X(7)
More information is available at http://linuxwacom.sourceforge.net
Peter Hutterer <firstname.lastname@example.org>, Ping Cheng <email@example.com>, Frederic Lepied <firstname.lastname@example.org>, John E. Joganic <jej@j-arka-
dia.com>, Magnus Vigerlof <Magnus.Vigerlof@ipbo.se>
X Version 11 xf86-input-wacom 0.15.0 WACOM(4)