libinput/doc/button-debouncing-state-machine.svg

<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="1277px" height="2101px" version="1.1" content="&lt;mxfile userAgent=&quot;Mozilla/5.0 (X11; Linux x86_64; rv:52.0) Gecko/20100101 Firefox/52.0&quot; version=&quot;8.0.4&quot; editor=&quot;www.draw.io&quot; type=&quot;google&quot;&gt;&lt;diagram id=&quot;27c35eac-9917-780f-69cd-550de3271581&quot; name=&quot;Page-1&quot;&gt;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
evdev: add new debouncing code The current debouncing code monitors events and switches on when events are too close together. From then on, any event can be delayed. Vicente Bergas provided an algorithm that avoids most of these delays: on a button state change we now forward the change without delay but start a timer. If the button changes state during that timer, the changes are ignored. On timer expiry, events are sent to match the hardware state with the client's view of the device. This is only done if needed. Thus, a press-release sequence of: PRP sends a single press event, a sequence of PRPR sends press and then the release at the end of the timeout. The timeout is short enough that the delay should not be noticeable. This new mode is called the 'bounce' mode. The old mode is now referred to as 'spurious' mode and only covers the case of a button held down that loses contact. It works as before, monitoring a button for these spurious contact losses and switching on. When on, button release events are delayed as before. The whole button debouncing moves to a state machine which makes debugging a lot easier. See the accompanying SVG for the diagram. Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net> 2017-11-13 09:33:50 +10:00			`<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">`
evdev: add a quirk to disable debouncing on the MS Nano Transcievers A set of wireless devices that can scramble the timestamps, so we get press/release within 8ms even though I doubt the user is capable of doing this. Since they're generally good quality anyway, let's just disable debouncing on those until someone complains and we need something more sophisticated. https://bugs.freedesktop.org/show_bug.cgi?id=104415 Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net> (cherry picked from commit 3a3fd645c4a78ff85e66327d51c4262292c5b09a) 2018-01-31 16:18:15 +10:00			<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="1277px" height="2101px" version="1.1" content="<mxfile userAgent="Mozilla/5.0 (X11; Linux x86_64; rv:52.0) Gecko/20100101 Firefox/52.0" version="8.0.4" editor="www.draw.io" type="google"><diagram id="27c35eac-9917-780f-69cd-550de3271581" name="Page-1">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