Skip to content
Peter Hutterer edited this page Oct 2, 2018 · 20 revisions

Follow the steps below if your tablet works but does not show up in the GNOME Control Center. If the tablet does not work, then the issue is either in the kernel or in the xf86-input-wacom driver.

libwacom-list-local-devices

Run this command to check whether your device is detected by libwacom.

The output of this command should include all connected devices, e.g.

 $ libwacom-list-local-devices
[Device]
Name=Wacom Serial Tablet WACf004
DeviceMatch=serial:0000:0000;
Class=ISDV4
Width=0
Height=0
IntegratedIn=Display;System;
Styli=0xfffff;0xffffe;

[Features]
Reversible=false
Stylus=true
Ring=false
Ring2=false
Touch=false
TouchSwitch=false
StatusLEDs=
NumStrips=0
Buttons=0

If the device is not found but works otherwise, you will need to add a tablet data file for your device. The easiest approach is to search for an existing data file that is of a similar model and copy+modify that file. The most important lines are Name and DeviceMatch. Both need to be correct and must match the device (use evtest or evemu-record to get the required information from the device).

It is sufficient to add the new .data to the installation folder (/usr/share/libwacom). If the file is correct, libwacom-list-local-devices will show the device. If so, please add the file to the git tree and submit a pull request. If the tablet is one with buttons, please also add the matching svg file.

Error handling

A .tablet file already exists, but my device isn't found

If the your-model-name.tablet file already exists but libwacom-list-local-devices does not show your device it is most likely missing the DeviceMatch for your device. Identify your match string (using evtest or evemu-record) and add the string to the semicolon-separated list.

Duplicate matches

The command may complain about duplicate matches, e.g. (libwacom-list-local-devices:2595): libwacom-CRITICAL **: Duplicate match of 'usb:056a:00d0' on device 'Wacom Bamboo Touch (2FG)'.

If you get this error you need to find the duplicate match in the /usr/share/libwacom data directory. grep for the match string (e.g. usb:056a:00d0) and identify which files include the string. If two files provided by libwacom include the same string, please file an issue. If you edited a new file for your local tablet with the same match string, please consider adding your device match to existing file.

Clone this wiki locally