| 1 |
.. _t440_support: |
| 2 |
|
| 3 |
============================================================================== |
| 4 |
Lenovo \*40 series touchpad support |
| 5 |
============================================================================== |
| 6 |
|
| 7 |
The Lenovo \*40 series emulates trackstick buttons on the top part of the |
| 8 |
touchpads. |
| 9 |
|
| 10 |
.. _t440_support_overview: |
| 11 |
|
| 12 |
------------------------------------------------------------------------------ |
| 13 |
Overview |
| 14 |
------------------------------------------------------------------------------ |
| 15 |
|
| 16 |
The Lenovo \*40 series introduced a new type of touchpad. Previously, all |
| 17 |
laptops had a separate set of physical buttons for the |
| 18 |
`trackstick <http://en.wikipedia.org/wiki/Pointing_stick>`_. This |
| 19 |
series removed these buttons, relying on a software emulation of the top |
| 20 |
section of the touchpad. This is visually marked on the trackpad itself, |
| 21 |
and clicks can be triggered by pressing the touchpad down with a finger in |
| 22 |
the respective area: |
| 23 |
|
| 24 |
.. figure:: top-software-buttons.svg |
| 25 |
:align: center |
| 26 |
|
| 27 |
Left, right and middle-button click with top software button areas |
| 28 |
|
| 29 |
This page only covers the top software buttons, the bottom button behavior |
| 30 |
is covered in :ref:`Clickpad software buttons <clickpad_softbuttons>`. |
| 31 |
|
| 32 |
Clickpads with a top button area are marked with the |
| 33 |
`INPUT_PROP_TOPBUTTONPAD <https://www.kernel.org/doc/Documentation/input/event-codes.txt>`_ |
| 34 |
property. |
| 35 |
|
| 36 |
.. _t440_support_btn_size: |
| 37 |
|
| 38 |
------------------------------------------------------------------------------ |
| 39 |
Size of the buttons |
| 40 |
------------------------------------------------------------------------------ |
| 41 |
|
| 42 |
The size of the buttons matches the visual markings on this touchpad. |
| 43 |
The width of the left and right buttons is approximately 42% of the |
| 44 |
touchpad's width, the middle button is centered and assigned 16% of the |
| 45 |
touchpad width. |
| 46 |
|
| 47 |
The line of the buttons is 5mm from the top edge of the touchpad, |
| 48 |
measurements of button presses showed that the size of the buttons needs to |
| 49 |
be approximately 10mm high to work reliable (especially when using the |
| 50 |
thumb to press the button). |
| 51 |
|
| 52 |
.. _t440_support_btn_behavior: |
| 53 |
|
| 54 |
------------------------------------------------------------------------------ |
| 55 |
Button behavior |
| 56 |
------------------------------------------------------------------------------ |
| 57 |
|
| 58 |
Movement in the top button area does not generate pointer movement. These |
| 59 |
buttons are not replacement buttons for the bottom button area but have |
| 60 |
their own behavior. Semantically attached to the trackstick device, libinput |
| 61 |
re-routes events from these buttons to appear through the trackstick device. |
| 62 |
|
| 63 |
|
| 64 |
.. graphviz:: |
| 65 |
|
| 66 |
|
| 67 |
digraph top_button_routing |
| 68 |
{ |
| 69 |
rankdir="LR"; |
| 70 |
node [shape="box";] |
| 71 |
|
| 72 |
trackstick [label="trackstick kernel device"]; |
| 73 |
touchpad [label="touchpad kernel device"]; |
| 74 |
|
| 75 |
subgraph cluster0 { |
| 76 |
bgcolor = floralwhite |
| 77 |
label = "libinput" |
| 78 |
|
| 79 |
libinput_ts [label="trackstick libinput_device" |
| 80 |
style=filled |
| 81 |
fillcolor=white]; |
| 82 |
libinput_tp [label="touchpad libinput_device" |
| 83 |
style=filled |
| 84 |
fillcolor=white]; |
| 85 |
|
| 86 |
libinput_tp -> libinput_ts [constraint=false |
| 87 |
color="red4"]; |
| 88 |
} |
| 89 |
|
| 90 |
trackstick -> libinput_ts [arrowhead="none"] |
| 91 |
touchpad -> libinput_tp [color="red4"] |
| 92 |
|
| 93 |
events_tp [label="other touchpad events"]; |
| 94 |
events_topbutton [label="top software button events"]; |
| 95 |
|
| 96 |
libinput_tp -> events_tp [arrowhead="none"] |
| 97 |
libinput_ts -> events_topbutton [color="red4"] |
| 98 |
} |
| 99 |
|
| 100 |
|
| 101 |
|
| 102 |
The top button areas work even if the touchpad is disabled but will be |
| 103 |
disabled when the trackstick device is disabled. If the finger starts inside |
| 104 |
the top area and moves outside the button area the finger is treated as dead |
| 105 |
and must be lifted to generate future buttons. Likewise, movement into the |
| 106 |
top button area does not trigger button events, a click has to start inside |
| 107 |
this area to take effect. |
| 108 |
|
| 109 |
.. _t440_support_identification: |
| 110 |
|
| 111 |
------------------------------------------------------------------------------ |
| 112 |
Kernel support |
| 113 |
------------------------------------------------------------------------------ |
| 114 |
|
| 115 |
The firmware on the first generation of touchpads providing top software |
| 116 |
buttons is buggy and announces wrong ranges. |
| 117 |
`Kernel patches <https://lkml.org/lkml/2014/3/7/722>`_ are required; |
| 118 |
these fixes are available in kernels 3.14.1, 3.15 and later but each |
| 119 |
touchpad needs a separate fix. |
| 120 |
|
| 121 |
The October 2014 refresh of these laptops do not have this firmware bug |
| 122 |
anymore and should work without per-device patches, though |
| 123 |
`this kernel commit <http://git.kernel.org/cgit/linux/kernel/git/torvalds/linux.git/commit/?id=02e07492cdfae9c86e3bd21c0beec88dbcc1e9e8>`_ |
| 124 |
is required. |
| 125 |
|
| 126 |
For a complete list of supported touchpads check |
| 127 |
`the kernel source <http://git.kernel.org/cgit/linux/kernel/git/torvalds/linux.git/tree/drivers/input/mouse/synaptics.c>`_ |
| 128 |
(search for "topbuttonpad_pnp_ids"). |