Tree [c27c14] master /
History



File Date Author Commit
data 2014-12-11 Ping Cheng Ping Cheng [c27c14] Update tool IDs for newer Cintiqs and Intuos 4/...
doc 2014-11-05 Peter Hutterer Peter Hutterer [785f88] doc: update doxygen.conf.in for newer doxygen
libwacom 2014-09-15 Benjamin Tissoires Benjamin Tissoires [f056e5] Rely on the PRODUCT attribute to fetch the bus,...
test 2014-02-06 Ping Cheng Ping Cheng [6d7021] Add .data files for Intuos series
tools 2014-02-06 Peter Hutterer Peter Hutterer [503e5c] tools: fix filtering by bustype when listing th...
.gitignore 2012-11-07 Olivier Fourdan Olivier Fourdan [e2fed9] tools: add tablet layout image viewer
COPYING 2011-11-29 Peter Hutterer Peter Hutterer [658456] Initial revision - a base library for querying ...
Makefile.am 2012-04-16 Peter Hutterer Peter Hutterer [75373b] tools: Move udev generation to a new tools/ dir...
NEWS 2014-11-06 Peter Hutterer Peter Hutterer [0f81d3] libwacom 0.11
README 2014-11-03 Peter Hutterer Peter Hutterer [92724c] Update README to describe how to add tablet des...
autogen.sh 2012-01-17 Colin Walters Colin Walters [7c6e78] autogen: Honor NOCONFIGURE=1
configure.ac 2014-11-06 Peter Hutterer Peter Hutterer [0f81d3] libwacom 0.11
libwacom.pc.in 2011-12-09 Peter Hutterer Peter Hutterer [3ce59e] Merge git://github.com/hadess/libwacom

Read Me

libwacom is a library to identify wacom tablets and their model-specific
features. It provides easy access to information such as "is this a built-in
on-screen tablet", "what is the size of this model", etc.

This functionality is currently used by e.g. GNOME to map built-in tablets
to the correct screen.

== Debugging libwacom with uinput devices ==
libwacom by default will not recognise uinput devices. To debug and test, a
physical device must be connected.

Custom udev rules are provided to help debug uinput device. Run
    generate-udev-rules --with-uinput-rules
to generate these rules and apply them locally. Devices will then be tagged
as required and can be debugged.

Some limitations:
* For these rules to work, the device must be listed in the database.
* libwacom will check UINPUT_* properties on the uinput device, if they do
  not get applied, the device will not be visible

DO NOT USE THESE UINPUT RULES unless you are debugging with uinput devices.
Remove the rules once debugging is done.

== Adding tablet descriptions to libwacom ==
A common indicator that a device is not supported by libwacom is that it
works normally in a GNOME session, but the device is not correctly mapped to
the screen.

Use the libwacom-list-local-devices tool to list all local devices
recognized by libwacom. If your device is not listed, but it is available
as an event device in the kernel (see /proc/bus/input/devices) and in the X
session (see xinput list), the device is missing from libwacom's database.

To add support for a new tablet to libwacom create a new tablet definition
file. See data/wacom.example in the source for a guideline on how
to add a new tablet. For an installed version of libwacom, see the existing
data files (e.g. /usr/share/libwacom/cintiq-13hd.tablet).
A new tablet description is enabled by adding and installing a new file
with a .tablet suffix. Once installed the tablet is part of libwacom's
database, no rebuild is neccessary. The tablet is then available
through libwacom-list-local-devices.

The device should also be added to the udev rule to ensure all required
properties are set. When building from source generate an update ruleset
with tools/generate-udev-rules after adding the tablet descripton to. When
updating an installed version of libwacom, add it manually to the existing
ruleset (/lib/udev/rules.d/65-libwacom.rules).