Debian Codegraph @

doc/user/tablet-debugging.rst

raw
1 .. _tablet-debugging:
2
3 ==============================================================================
4 Debugging tablet issues
5 ==============================================================================
6
7 .. _tablet-capabilities:
8
9 ------------------------------------------------------------------------------
10 Required tablet capabilities
11 ------------------------------------------------------------------------------
12
13 To handle a tablet correctly, libinput requires a set of capabilities
14 on the device. When these capabilities are missing, libinput ignores the
15 device and prints an error to the log. This error messages reads
16
17 ::
18
19 missing tablet capabilities: xy pen btn-stylus resolution. Ignoring this device.
20
21 or in older versions of libinput simply:
22
23 ::
24
25 libinput bug: device does not meet tablet criteria. Ignoring this device.
26
27
28 When a tablet is rejected, it is usually possible to verify the issue with
29 the ``libinput record`` tool.
30
31 - **xy** indicates that the tablet is missing the ``ABS_X`` and/or ``ABS_Y``
32 axis. This indicates that the device is mislabelled and the udev tag
33 ``ID_INPUT_TABLET`` is applied to a device that is not a tablet.
34 A bug should be filed against `systemd <http://github.com/systemd/systemd>`__.
35 - **pen** or **btn-stylus** indicates that the tablet does not have the
36 ``BTN_TOOL_PEN`` or ``BTN_STYLUS`` bit set. libinput requires either or both
37 of them to be present. This indicates a bug in the kernel driver
38 or the HID descriptors of the device.
39 - **resolution** indicates that the device does not have a resolution set
40 for the x and y axes. This can be fixed with a hwdb entry, locate and read
41 the `60-evdev.hwdb
42 <https://github.com/systemd/systemd/blob/main/hwdb.d/60-evdev.hwdb>`__ file
43 on your machine and file a pull request with the fixes against
44 `systemd <https://github.com/systemd/systemd/>`__.