Tablet Definition Files

To add support for a new tablet, libwacom will need a tablet definition file for the device. .svg files illustrating the ExpressKey layout of the tablet may be necessary as well. These files are located in libwacom/data. The files are added to this library by creating new .tablet files (using an existing file as a template) and creating a pull request that includes the files.

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.