1 // SPDX-License-Identifier: GPL-2.0-only
3 * Input Multitouch Library
5 * Copyright (c) 2008-2010 Henrik Rydberg
8 #include <linux/input/mt.h>
9 #include <linux/export.h>
10 #include <linux/slab.h>
11 #include "input-core-private.h"
13 #define TRKID_SGN ((TRKID_MAX + 1) >> 1)
15 static void copy_abs(struct input_dev
*dev
, unsigned int dst
, unsigned int src
)
17 if (dev
->absinfo
&& test_bit(src
, dev
->absbit
)) {
18 dev
->absinfo
[dst
] = dev
->absinfo
[src
];
19 dev
->absinfo
[dst
].fuzz
= 0;
20 __set_bit(dst
, dev
->absbit
);
25 * input_mt_init_slots() - initialize MT input slots
26 * @dev: input device supporting MT events and finger tracking
27 * @num_slots: number of slots used by the device
28 * @flags: mt tasks to handle in core
30 * This function allocates all necessary memory for MT slot handling
31 * in the input device, prepares the ABS_MT_SLOT and
32 * ABS_MT_TRACKING_ID events for use and sets up appropriate buffers.
33 * Depending on the flags set, it also performs pointer emulation and
34 * frame synchronization.
36 * May be called repeatedly. Returns -EINVAL if attempting to
37 * reinitialize with a different number of slots.
39 int input_mt_init_slots(struct input_dev
*dev
, unsigned int num_slots
,
42 struct input_mt
*mt
= dev
->mt
;
48 return mt
->num_slots
!= num_slots
? -EINVAL
: 0;
49 /* Arbitrary limit for avoiding too large memory allocation. */
53 mt
= kzalloc(struct_size(mt
, slots
, num_slots
), GFP_KERNEL
);
57 mt
->num_slots
= num_slots
;
59 input_set_abs_params(dev
, ABS_MT_SLOT
, 0, num_slots
- 1, 0, 0);
60 input_set_abs_params(dev
, ABS_MT_TRACKING_ID
, 0, TRKID_MAX
, 0, 0);
62 if (flags
& (INPUT_MT_POINTER
| INPUT_MT_DIRECT
)) {
63 __set_bit(EV_KEY
, dev
->evbit
);
64 __set_bit(BTN_TOUCH
, dev
->keybit
);
66 copy_abs(dev
, ABS_X
, ABS_MT_POSITION_X
);
67 copy_abs(dev
, ABS_Y
, ABS_MT_POSITION_Y
);
68 copy_abs(dev
, ABS_PRESSURE
, ABS_MT_PRESSURE
);
70 if (flags
& INPUT_MT_POINTER
) {
71 __set_bit(BTN_TOOL_FINGER
, dev
->keybit
);
72 __set_bit(BTN_TOOL_DOUBLETAP
, dev
->keybit
);
74 __set_bit(BTN_TOOL_TRIPLETAP
, dev
->keybit
);
76 __set_bit(BTN_TOOL_QUADTAP
, dev
->keybit
);
78 __set_bit(BTN_TOOL_QUINTTAP
, dev
->keybit
);
79 __set_bit(INPUT_PROP_POINTER
, dev
->propbit
);
81 if (flags
& INPUT_MT_DIRECT
)
82 __set_bit(INPUT_PROP_DIRECT
, dev
->propbit
);
83 if (flags
& INPUT_MT_SEMI_MT
)
84 __set_bit(INPUT_PROP_SEMI_MT
, dev
->propbit
);
85 if (flags
& INPUT_MT_TRACK
) {
86 unsigned int n2
= num_slots
* num_slots
;
87 mt
->red
= kcalloc(n2
, sizeof(*mt
->red
), GFP_KERNEL
);
92 /* Mark slots as 'inactive' */
93 for (i
= 0; i
< num_slots
; i
++)
94 input_mt_set_value(&mt
->slots
[i
], ABS_MT_TRACKING_ID
, -1);
96 /* Mark slots as 'unused' */
105 EXPORT_SYMBOL(input_mt_init_slots
);
108 * input_mt_destroy_slots() - frees the MT slots of the input device
109 * @dev: input device with allocated MT slots
111 * This function is only needed in error path as the input core will
112 * automatically free the MT slots when the device is destroyed.
114 void input_mt_destroy_slots(struct input_dev
*dev
)
122 EXPORT_SYMBOL(input_mt_destroy_slots
);
125 * input_mt_report_slot_state() - report contact state
126 * @dev: input device with allocated MT slots
127 * @tool_type: the tool type to use in this slot
128 * @active: true if contact is active, false otherwise
130 * Reports a contact via ABS_MT_TRACKING_ID, and optionally
131 * ABS_MT_TOOL_TYPE. If active is true and the slot is currently
132 * inactive, or if the tool type is changed, a new tracking id is
133 * assigned to the slot. The tool type is only reported if the
134 * corresponding absbit field is set.
136 * Returns true if contact is active.
138 bool input_mt_report_slot_state(struct input_dev
*dev
,
139 unsigned int tool_type
, bool active
)
141 struct input_mt
*mt
= dev
->mt
;
142 struct input_mt_slot
*slot
;
148 slot
= &mt
->slots
[mt
->slot
];
149 slot
->frame
= mt
->frame
;
152 input_event(dev
, EV_ABS
, ABS_MT_TRACKING_ID
, -1);
156 id
= input_mt_get_value(slot
, ABS_MT_TRACKING_ID
);
158 id
= input_mt_new_trkid(mt
);
160 input_event(dev
, EV_ABS
, ABS_MT_TRACKING_ID
, id
);
161 input_event(dev
, EV_ABS
, ABS_MT_TOOL_TYPE
, tool_type
);
165 EXPORT_SYMBOL(input_mt_report_slot_state
);
168 * input_mt_report_finger_count() - report contact count
169 * @dev: input device with allocated MT slots
170 * @count: the number of contacts
172 * Reports the contact count via BTN_TOOL_FINGER, BTN_TOOL_DOUBLETAP,
173 * BTN_TOOL_TRIPLETAP and BTN_TOOL_QUADTAP.
175 * The input core ensures only the KEY events already setup for
176 * this device will produce output.
178 void input_mt_report_finger_count(struct input_dev
*dev
, int count
)
180 input_event(dev
, EV_KEY
, BTN_TOOL_FINGER
, count
== 1);
181 input_event(dev
, EV_KEY
, BTN_TOOL_DOUBLETAP
, count
== 2);
182 input_event(dev
, EV_KEY
, BTN_TOOL_TRIPLETAP
, count
== 3);
183 input_event(dev
, EV_KEY
, BTN_TOOL_QUADTAP
, count
== 4);
184 input_event(dev
, EV_KEY
, BTN_TOOL_QUINTTAP
, count
== 5);
186 EXPORT_SYMBOL(input_mt_report_finger_count
);
189 * input_mt_report_pointer_emulation() - common pointer emulation
190 * @dev: input device with allocated MT slots
191 * @use_count: report number of active contacts as finger count
193 * Performs legacy pointer emulation via BTN_TOUCH, ABS_X, ABS_Y and
194 * ABS_PRESSURE. Touchpad finger count is emulated if use_count is true.
196 * The input core ensures only the KEY and ABS axes already setup for
197 * this device will produce output.
199 void input_mt_report_pointer_emulation(struct input_dev
*dev
, bool use_count
)
201 struct input_mt
*mt
= dev
->mt
;
202 struct input_mt_slot
*oldest
;
212 for (i
= 0; i
< mt
->num_slots
; ++i
) {
213 struct input_mt_slot
*ps
= &mt
->slots
[i
];
214 int id
= input_mt_get_value(ps
, ABS_MT_TRACKING_ID
);
218 if ((id
- oldid
) & TRKID_SGN
) {
225 input_event(dev
, EV_KEY
, BTN_TOUCH
, count
> 0);
229 !test_bit(ABS_MT_DISTANCE
, dev
->absbit
) &&
230 test_bit(ABS_DISTANCE
, dev
->absbit
) &&
231 input_abs_get_val(dev
, ABS_DISTANCE
) != 0) {
233 * Force reporting BTN_TOOL_FINGER for devices that
234 * only report general hover (and not per-contact
235 * distance) when contact is in proximity but not
241 input_mt_report_finger_count(dev
, count
);
245 int x
= input_mt_get_value(oldest
, ABS_MT_POSITION_X
);
246 int y
= input_mt_get_value(oldest
, ABS_MT_POSITION_Y
);
248 input_event(dev
, EV_ABS
, ABS_X
, x
);
249 input_event(dev
, EV_ABS
, ABS_Y
, y
);
251 if (test_bit(ABS_MT_PRESSURE
, dev
->absbit
)) {
252 int p
= input_mt_get_value(oldest
, ABS_MT_PRESSURE
);
253 input_event(dev
, EV_ABS
, ABS_PRESSURE
, p
);
256 if (test_bit(ABS_MT_PRESSURE
, dev
->absbit
))
257 input_event(dev
, EV_ABS
, ABS_PRESSURE
, 0);
260 EXPORT_SYMBOL(input_mt_report_pointer_emulation
);
262 static void __input_mt_drop_unused(struct input_dev
*dev
, struct input_mt
*mt
)
266 lockdep_assert_held(&dev
->event_lock
);
268 for (i
= 0; i
< mt
->num_slots
; i
++) {
269 if (input_mt_is_active(&mt
->slots
[i
]) &&
270 !input_mt_is_used(mt
, &mt
->slots
[i
])) {
271 input_handle_event(dev
, EV_ABS
, ABS_MT_SLOT
, i
);
272 input_handle_event(dev
, EV_ABS
, ABS_MT_TRACKING_ID
, -1);
278 * input_mt_drop_unused() - Inactivate slots not seen in this frame
279 * @dev: input device with allocated MT slots
281 * Lift all slots not seen since the last call to this function.
283 void input_mt_drop_unused(struct input_dev
*dev
)
285 struct input_mt
*mt
= dev
->mt
;
290 spin_lock_irqsave(&dev
->event_lock
, flags
);
292 __input_mt_drop_unused(dev
, mt
);
295 spin_unlock_irqrestore(&dev
->event_lock
, flags
);
298 EXPORT_SYMBOL(input_mt_drop_unused
);
301 * input_mt_release_slots() - Deactivate all slots
302 * @dev: input device with allocated MT slots
304 * Lift all active slots.
306 void input_mt_release_slots(struct input_dev
*dev
)
308 struct input_mt
*mt
= dev
->mt
;
310 lockdep_assert_held(&dev
->event_lock
);
313 /* This will effectively mark all slots unused. */
316 __input_mt_drop_unused(dev
, mt
);
318 if (test_bit(ABS_PRESSURE
, dev
->absbit
))
319 input_handle_event(dev
, EV_ABS
, ABS_PRESSURE
, 0);
326 * input_mt_sync_frame() - synchronize mt frame
327 * @dev: input device with allocated MT slots
329 * Close the frame and prepare the internal state for a new one.
330 * Depending on the flags, marks unused slots as inactive and performs
333 void input_mt_sync_frame(struct input_dev
*dev
)
335 struct input_mt
*mt
= dev
->mt
;
336 bool use_count
= false;
341 if (mt
->flags
& INPUT_MT_DROP_UNUSED
) {
344 spin_lock_irqsave(&dev
->event_lock
, flags
);
345 __input_mt_drop_unused(dev
, mt
);
346 spin_unlock_irqrestore(&dev
->event_lock
, flags
);
349 if ((mt
->flags
& INPUT_MT_POINTER
) && !(mt
->flags
& INPUT_MT_SEMI_MT
))
352 input_mt_report_pointer_emulation(dev
, use_count
);
356 EXPORT_SYMBOL(input_mt_sync_frame
);
358 static int adjust_dual(int *begin
, int step
, int *end
, int eq
, int mu
)
367 s
= p
== end
? f
+ 1 : *p
;
369 for (; p
!= end
; p
+= step
) {
379 if (c
== 0 || (c
> mu
&& (!eq
|| mu
> 0)))
381 /* Improve convergence for positive matrices by penalizing overcovers */
382 if (s
< 0 && mu
<= 0)
385 for (p
= begin
; p
!= end
; p
+= step
)
388 return (c
< s
&& s
<= 0) || (f
>= 0 && f
< c
);
391 static void find_reduced_matrix(int *w
, int nr
, int nc
, int nrc
, int mu
)
395 for (k
= 0; k
< nrc
; k
++) {
396 for (i
= 0; i
< nr
; i
++)
397 adjust_dual(w
+ i
, nr
, w
+ i
+ nrc
, nr
<= nc
, mu
);
399 for (i
= 0; i
< nrc
; i
+= nr
)
400 sum
+= adjust_dual(w
+ i
, 1, w
+ i
+ nr
, nc
<= nr
, mu
);
406 static int input_mt_set_matrix(struct input_mt
*mt
,
407 const struct input_mt_pos
*pos
, int num_pos
,
410 const struct input_mt_pos
*p
;
411 struct input_mt_slot
*s
;
415 for (s
= mt
->slots
; s
!= mt
->slots
+ mt
->num_slots
; s
++) {
416 if (!input_mt_is_active(s
))
418 x
= input_mt_get_value(s
, ABS_MT_POSITION_X
);
419 y
= input_mt_get_value(s
, ABS_MT_POSITION_Y
);
420 for (p
= pos
; p
!= pos
+ num_pos
; p
++) {
421 int dx
= x
- p
->x
, dy
= y
- p
->y
;
422 *w
++ = dx
* dx
+ dy
* dy
- mu
;
429 static void input_mt_set_slots(struct input_mt
*mt
,
430 int *slots
, int num_pos
)
432 struct input_mt_slot
*s
;
435 for (j
= 0; j
!= num_pos
; j
++)
438 for (s
= mt
->slots
; s
!= mt
->slots
+ mt
->num_slots
; s
++) {
439 if (!input_mt_is_active(s
))
442 for (j
= 0; j
!= num_pos
; j
++) {
444 slots
[j
] = s
- mt
->slots
;
452 for (s
= mt
->slots
; s
!= mt
->slots
+ mt
->num_slots
; s
++) {
453 if (input_mt_is_active(s
))
456 for (j
= 0; j
!= num_pos
; j
++) {
458 slots
[j
] = s
- mt
->slots
;
466 * input_mt_assign_slots() - perform a best-match assignment
467 * @dev: input device with allocated MT slots
468 * @slots: the slot assignment to be filled
469 * @pos: the position array to match
470 * @num_pos: number of positions
471 * @dmax: maximum ABS_MT_POSITION displacement (zero for infinite)
473 * Performs a best match against the current contacts and returns
474 * the slot assignment list. New contacts are assigned to unused
477 * The assignments are balanced so that all coordinate displacements are
478 * below the euclidian distance dmax. If no such assignment can be found,
479 * some contacts are assigned to unused slots.
481 * Returns zero on success, or negative error in case of failure.
483 int input_mt_assign_slots(struct input_dev
*dev
, int *slots
,
484 const struct input_mt_pos
*pos
, int num_pos
,
487 struct input_mt
*mt
= dev
->mt
;
488 int mu
= 2 * dmax
* dmax
;
493 if (num_pos
> mt
->num_slots
)
498 nrc
= input_mt_set_matrix(mt
, pos
, num_pos
, mu
);
499 find_reduced_matrix(mt
->red
, num_pos
, nrc
/ num_pos
, nrc
, mu
);
500 input_mt_set_slots(mt
, slots
, num_pos
);
504 EXPORT_SYMBOL(input_mt_assign_slots
);
507 * input_mt_get_slot_by_key() - return slot matching key
508 * @dev: input device with allocated MT slots
509 * @key: the key of the sought slot
511 * Returns the slot of the given key, if it exists, otherwise
512 * set the key on the first unused slot and return.
514 * If no available slot can be found, -1 is returned.
515 * Note that for this function to work properly, input_mt_sync_frame() has
516 * to be called at each frame.
518 int input_mt_get_slot_by_key(struct input_dev
*dev
, int key
)
520 struct input_mt
*mt
= dev
->mt
;
521 struct input_mt_slot
*s
;
526 for (s
= mt
->slots
; s
!= mt
->slots
+ mt
->num_slots
; s
++)
527 if (input_mt_is_active(s
) && s
->key
== key
)
528 return s
- mt
->slots
;
530 for (s
= mt
->slots
; s
!= mt
->slots
+ mt
->num_slots
; s
++)
531 if (!input_mt_is_active(s
) && !input_mt_is_used(mt
, s
)) {
533 return s
- mt
->slots
;
538 EXPORT_SYMBOL(input_mt_get_slot_by_key
);