| 1 |
.. _touchpad_jumping_cursor: |
| 2 |
|
| 3 |
============================================================================== |
| 4 |
Touchpad jumping cursor bugs |
| 5 |
============================================================================== |
| 6 |
|
| 7 |
A common bug encountered on touchpads is a cursor jump when alternating |
| 8 |
between fingers on a multi-touch-capable touchpad. For example, after moving |
| 9 |
the cursor a user may use a second finger in the software button area to |
| 10 |
physically click the touchpad. Upon setting the finger down, the cursor |
| 11 |
exhibits a jump towards the bottom left or right, depending on the finger |
| 12 |
position. |
| 13 |
|
| 14 |
When libinput detects a cursor jump it prints a bug warning to the log with |
| 15 |
the text **"Touch jump detected and discarded."** and a link to this page. |
| 16 |
|
| 17 |
.. note:: This warning is ratelimited and will stop appearing after a few |
| 18 |
times, even if the touchpad jumps continue. |
| 19 |
|
| 20 |
In most cases, this is a bug in the firmware (or kernel driver) and to |
| 21 |
libinput it appears that the touch point moves from its previous position. |
| 22 |
The pointer jump can usually be seen in the :ref:`libinput record |
| 23 |
<libinput-record>` output for the device: |
| 24 |
|
| 25 |
:: |
| 26 |
|
| 27 |
E: 249.206319 0000 0000 0000 # ------------ SYN_REPORT (0) ---------- |
| 28 |
E: 249.218008 0003 0035 3764 # EV_ABS / ABS_MT_POSITION_X 3764 |
| 29 |
E: 249.218008 0003 0036 2221 # EV_ABS / ABS_MT_POSITION_Y 2221 |
| 30 |
E: 249.218008 0003 003a 0065 # EV_ABS / ABS_MT_PRESSURE 65 |
| 31 |
E: 249.218008 0003 0000 3764 # EV_ABS / ABS_X 3764 |
| 32 |
E: 249.218008 0003 0001 2216 # EV_ABS / ABS_Y 2216 |
| 33 |
E: 249.218008 0003 0018 0065 # EV_ABS / ABS_PRESSURE 65 |
| 34 |
E: 249.218008 0000 0000 0000 # ------------ SYN_REPORT (0) ---------- |
| 35 |
E: 249.230881 0003 0035 3752 # EV_ABS / ABS_MT_POSITION_X 3752 |
| 36 |
E: 249.230881 0003 003a 0046 # EV_ABS / ABS_MT_PRESSURE 46 |
| 37 |
E: 249.230881 0003 0000 3758 # EV_ABS / ABS_X 3758 |
| 38 |
E: 249.230881 0003 0018 0046 # EV_ABS / ABS_PRESSURE 46 |
| 39 |
E: 249.230881 0000 0000 0000 # ------------ SYN_REPORT (0) ---------- |
| 40 |
E: 249.242648 0003 0035 1640 # EV_ABS / ABS_MT_POSITION_X 1640 |
| 41 |
E: 249.242648 0003 0036 4681 # EV_ABS / ABS_MT_POSITION_Y 4681 |
| 42 |
E: 249.242648 0003 003a 0025 # EV_ABS / ABS_MT_PRESSURE 25 |
| 43 |
E: 249.242648 0003 0000 1640 # EV_ABS / ABS_X 1640 |
| 44 |
E: 249.242648 0003 0001 4681 # EV_ABS / ABS_Y 4681 |
| 45 |
E: 249.242648 0003 0018 0025 # EV_ABS / ABS_PRESSURE 25 |
| 46 |
E: 249.242648 0000 0000 0000 # ------------ SYN_REPORT (0) ---------- |
| 47 |
E: 249.254568 0003 0035 1648 # EV_ABS / ABS_MT_POSITION_X 1648 |
| 48 |
E: 249.254568 0003 003a 0027 # EV_ABS / ABS_MT_PRESSURE 27 |
| 49 |
E: 249.254568 0003 0000 1644 # EV_ABS / ABS_X 1644 |
| 50 |
E: 249.254568 0003 0018 0027 # EV_ABS / ABS_PRESSURE 27 |
| 51 |
|
| 52 |
|
| 53 |
In this recording, the pointer jumps from its position 3752/2216 to |
| 54 |
1640/4681 within a single frame. On this particular touchpad, this would |
| 55 |
represent a physical move of almost 50mm. libinput detects some of these |
| 56 |
jumps and discards the movement but otherwise continues as usual. |
| 57 |
If your only encounter with these jumps is the warning printed to the log, |
| 58 |
libinput functions as intended. |
| 59 |
|
| 60 |
When you encounter the warning in the log, please generate a recording of |
| 61 |
your touchpad with :ref:`libinput record <libinput-record>` and file a bug. |
| 62 |
See :ref:`reporting_bugs` for more details. |
| 63 |
|
| 64 |
Note that it most cases, libinput cannot actually fix the issue. Filing a |
| 65 |
bug is useful to figure out if there are other factors at play or whether |
| 66 |
there are heuristics we can employ to reduce the impact. |
| 67 |
|
| 68 |
------------------------------------------------------------------------------ |
| 69 |
AlpsPS/2 ALPS DualPoint TouchPad jumping to 4095/0 |
| 70 |
------------------------------------------------------------------------------ |
| 71 |
|
| 72 |
A special case of pointer jumps happens on ``AlpsPS/2 ALPS DualPoint TouchPad`` |
| 73 |
devices found in the Lenovo ThinkPad E465 and E550 and likely others with |
| 74 |
the same touchpad hardware. On those devices, the touchpad occasionally |
| 75 |
sends an event for the second finger to move to position 4095/0 before |
| 76 |
moving back to the original position. libinput detects this movement and |
| 77 |
removes it but depending on the interaction this may cause a smaller jump |
| 78 |
later when the coordinates reset to the new position of the finger. |
| 79 |
|
| 80 |
Some more information is available in `Gitlab Issue #492 <https://gitlab.freedesktop.org/libinput/libinput/-/issues/492>`__. |