Tablet Definition Files

If you have a Wacom tablet and it is not yet in libwacom/data, send us a definition file for your tablet.

This will assist applications in configuring it because they can then access the metadata in libwacom about your device. Note that the libwacom data files do not make the stylus work, this is merely about adding extra information for better configuration. See the wacom.example file for explanations of the requested data and its format.

Autogenerating a tablet file with sysinfo.sh

The easiest way to generate a tablet file is to auto-generate one with the sysinfo.sh script. This script will collect data about the tablet and generate a .tablet file. The data should be submitted to the wacom-hid-descriptors repository. Please see the README in that repository for more details.

Even if the tablet file cannot be autogenerated, it must still contain a reference to the sysinfo data and the respective wacom-hid-descriptors repository issue. See recently added tablet files for reference.

Example tablet file

The definition file intuos4-8x13.tablet demonstrates a "completed" one:

# Wacom
# Intuos4 Large
# PTK-840
#
# sysinfo.1234abcd
# https://github.com/linuxwacom/wacom-hid-descriptors/issues/1234
#
# Button Map:
# (A=1, B=2, C=3, ...)
#
#    *-----------------------*
#    |                       |
#  B |                       |
#  C |                       |
#  D |                       |
#  E |                       |
#  A |        TABLET         |
#  F |                       |
#  G |                       |
#  H |                       |
#  I |                       |
#    |                       |
#    *-----------------------*
#
# LED Map:
# (XY=Bank X, LED Y)
#
#     *-----------------------*
#     |                       |
#  00 |                       |
#  01 |                       |
#  02 |        TABLET         |
#  03 |                       |
#     |                       |
#     *-----------------------*
#

[Device]
Name=Wacom Intuos4 8x13
DeviceMatch=usb:056a:00ba
Class=Intuos4
Width=13
Height=8
Styli=0x802;0x80c;0x804;0x80a;0x40802;0x4080a;0x902;0x90a;0x20802;0x806;0x006;

[Features]
Reversible=true
Stylus=true
Ring=true
Buttons=9
BuiltIn=false

[Buttons]
Left=A;B;C;D;E;F;G;H;I

OLEDs=B;C;D;E;F;G;H;I

Ring=A
RingNumModes=4

The above is just an example, look at git log -p data/ for previous patches (e.g. this commit) and emulate what they do.

For devices that already exist in libwacom but have a new VID/PID, adding a new DeviceMatch to the existing file is sufficient.

Submit your patch as a pull request on Github.