Lines Matching +full:keep +full:- +full:power +full:- +full:in +full:- +full:suspend
1 .. _input-event-codes:
15 the same moment in time. In the following, the term "event" refers to a single
22 event code values using the EVIOCG* ioctls defined in linux/input.h. The event
23 reports supported by a device are also provided by sysfs in
25 provided in class/input/event*/device/properties.
31 type has a set of applicable codes to be used in generating events. See the
36 - Used as markers to separate events. Events may be separated in time or in
41 - Used to describe state changes of keyboards, buttons, or other key-like
46 - Used to describe relative axis value changes, e.g. moving the mouse 5 units
51 - Used to describe absolute axis value changes, e.g. describing the
56 - Used to describe miscellaneous input data that do not fit into other types.
60 - Used to describe binary state input switches.
64 - Used to turn LEDs on devices on and off.
68 - Used to output sound to devices.
72 - Used for autorepeating devices.
76 - Used to send force feedback commands to an input device.
80 - A special type for power button and switch input.
84 - Used to receive force feedback device status.
92 ------
95 sent in the evdev event stream.
99 - Used to synchronize and separate events into packets of input data changes
100 occurring at the same moment in time. For example, motion of a mouse may set
106 - TBD
110 - Used to synchronize and separate touch events. See the
111 multi-touch-protocol.txt document for more information.
115 - Used to indicate buffer overrun in the evdev client's event queue.
121 ------
127 events have a value of 2. In general, KEY_<name> is used for keyboard keys, and
134 - These codes are used in conjunction with input trackpads, tablets, and
142 existing userspace, it is recommended to not switch tool in one EV_SYN frame
158 BTN_TOUCH must be the first evdev code emitted in a synchronization frame.
163 with current userspace it is recommended to follow this distinction. In the
165 EVIOCGPROP, defined in linux/input.h, will be used to convey the device type.
169 - These codes denote one, two, three, and four finger interaction on a
171 them on the touchpad in an effort to scroll content on screen,
173 Note that all BTN_TOOL_<name> codes and the BTN_TOUCH code are orthogonal in
179 a value of 1 in the same synchronization frame. This usage is deprecated.
181 Note: In multitouch drivers, the input_mt_report_finger_count() function should
182 be used to emit these codes. Please see multi-touch-protocol.txt for details.
185 ------
187 EV_REL events describe relative changes in a property. For example, a mouse may
188 move to the left by a certain number of units, but its absolute position in
196 - These codes are used for vertical and horizontal scroll wheels,
198 physical size of which varies by device. For high-resolution wheels
199 this may be an approximation based on the high-resolution scroll events,
206 - High-resolution scroll wheel data. The accumulated value 120 represents
207 movement by one detent. For devices that do not provide high-resolution
209 high-resolution scrolling, the value may be a fraction of 120.
211 If a vertical scroll wheel supports high-resolution scrolling, this code
212 will be emitted in addition to REL_WHEEL or REL_HWHEEL. The REL_WHEEL
213 and REL_HWHEEL may be an approximation based on the high-resolution
214 scroll events. There is no guarantee that the high-resolution data
219 ------
221 EV_ABS events describe absolute changes in a property. For example, a touchpad
228 - Used to describe the distance of a tool from an interaction surface. This
229 event should only be emitted while the tool is hovering, meaning in close
231 the input device may be used freely in three dimensions, consider ABS_Z
233 - BTN_TOOL_<name> should be set to 1 when the tool comes into detectable
240 - Used to describe the state of a multi-value profile switch. An event is
246 - Used to describe multitouch input events. Please see
247 multi-touch-protocol.txt for details.
251 - For touch devices, many devices converted contact size into pressure.
258 pressure is in measurable units. If the resolution is zero, the
259 pressure data is in arbitrary units. If the resolution is non-zero, the
260 pressure data is in units/gram. For example, a value of 10 with a
265 -----
270 Upon binding to a device or resuming from suspend, a driver must report
272 state is in sync.
274 Upon resume, if the switch state is the same as before suspend, then the input
276 not need to keep the state of the switch at any time.
279 ------
288 - Used to report the number of microseconds since the last reset. This event
292 A reset to zero can happen, in which case the time since the last event is
297 ------
303 ------
308 ------
314 -----
320 ------
322 EV_PWR events are a special type of event used specifically for power
329 i.e., the event types. In the case of two devices emitting the same event
330 types, additional information can be provided in the form of device
334 --------------------------------------
338 transformations, such as scaling, flipping and rotating). Non-direct input
339 devices require non-trivial transformation, such as absolute to relative
341 drawing tablets; non-direct devices: touchpads, mice.
344 on the screen and thus requires use of an on-screen pointer to trace user's
345 movements. Typical pointer devices: touchpads, tablets, mice; non-pointer
349 considered undefined and the device type should be deduced in the
353 --------------------
357 set. Common in Clickpad notebooks and Macbooks from 2009 and onwards.
361 compatibility, both methods need to be checked in userspace.
364 ------------------
380 -----------------------
394 ------------------------
406 The guidelines below ensure proper single-touch and multi-finger functionality.
407 For multi-touch functionality, see the multi-touch-protocol.rst document for
411 ----
419 ------------
429 ---------
436 on the trackpad. Where multi-finger support is available, BTN_TOOL_<name> should
442 -------
446 should be used to report when the tool is in contact with the tablet.