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

<?xml version="1.0" encoding="UTF-8"?>
<!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" version="1.1" width="1863px" height="1911px" viewBox="-0.5 -0.5 1863 1911" content="&lt;mxfile modified=&quot;2019-03-06T02:00:35.486Z&quot; host=&quot;www.draw.io&quot; agent=&quot;Mozilla/5.0 (X11; Linux x86_64; rv:64.0) Gecko/20100101 Firefox/64.0&quot; etag=&quot;vkHiu0IQZw_6aWYCIVwM&quot; version=&quot;10.3.5&quot; type=&quot;device&quot;&gt;&lt;diagram id=&quot;27c35eac-9917-780f-69cd-550de3271581&quot; name=&quot;Page-1&quot;&gt;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
evdev: Do not perform spurious detection when spurious is already enabled When exiting RELEASE_DELAYED state, do not transition into states to detect the need for spurious mode (RELEASE_WAITING, MAYBE_SPURIOUS). RELEASE_DELAYED is only entered when spurious mode is enabled, there is no need to detect the need for spurious mode again. 2019-01-04 16:03:38 +09:00			`<?xml version="1.0" encoding="UTF-8"?>`
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: Rename button up and down states to mirror each other The button up debouncing states mirror the button down states with the addition of the spurious debouncing states. Rename the states to better show this symmetry. 2019-01-04 15:37:17 +09:00			<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" version="1.1" width="1863px" height="1911px" viewBox="-0.5 -0.5 1863 1911" content="<mxfile modified="2019-03-06T02:00:35.486Z" host="www.draw.io" agent="Mozilla/5.0 (X11; Linux x86_64; rv:64.0) Gecko/20100101 Firefox/64.0" etag="vkHiu0IQZw_6aWYCIVwM" version="10.3.5" type="device"><diagram id="27c35eac-9917-780f-69cd-550de3271581" name="Page-1">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