2 * Input Multitouch Library
4 * Copyright (c) 2008-2010 Henrik Rydberg
6 * This program is free software; you can redistribute it and/or modify it
7 * under the terms of the GNU General Public License version 2 as published by
8 * the Free Software Foundation.
11 #include <linux/input/mt.h>
12 #include <linux/export.h>
13 #include <linux/slab.h>
15 #define TRKID_SGN ((TRKID_MAX + 1) >> 1)
17 static void copy_abs(struct input_dev
*dev
, unsigned int dst
, unsigned int src
)
19 if (dev
->absinfo
&& test_bit(src
, dev
->absbit
)) {
20 dev
->absinfo
[dst
] = dev
->absinfo
[src
];
21 dev
->absinfo
[dst
].fuzz
= 0;
22 dev
->absbit
[BIT_WORD(dst
)] |= BIT_MASK(dst
);
27 * input_mt_init_slots() - initialize MT input slots
28 * @dev: input device supporting MT events and finger tracking
29 * @num_slots: number of slots used by the device
30 * @flags: mt tasks to handle in core
32 * This function allocates all necessary memory for MT slot handling
33 * in the input device, prepares the ABS_MT_SLOT and
34 * ABS_MT_TRACKING_ID events for use and sets up appropriate buffers.
35 * Depending on the flags set, it also performs pointer emulation and
36 * frame synchronization.
38 * May be called repeatedly. Returns -EINVAL if attempting to
39 * reinitialize with a different number of slots.
41 int input_mt_init_slots(struct input_dev
*dev
, unsigned int num_slots
,
44 struct input_mt
*mt
= dev
->mt
;
50 return mt
->num_slots
!= num_slots
? -EINVAL
: 0;
52 mt
= kzalloc(sizeof(*mt
) + num_slots
* sizeof(*mt
->slots
), GFP_KERNEL
);
56 mt
->num_slots
= num_slots
;
58 input_set_abs_params(dev
, ABS_MT_SLOT
, 0, num_slots
- 1, 0, 0);
59 input_set_abs_params(dev
, ABS_MT_TRACKING_ID
, 0, TRKID_MAX
, 0, 0);
61 if (flags
& (INPUT_MT_POINTER
| INPUT_MT_DIRECT
)) {
62 __set_bit(EV_KEY
, dev
->evbit
);
63 __set_bit(BTN_TOUCH
, dev
->keybit
);
65 copy_abs(dev
, ABS_X
, ABS_MT_POSITION_X
);
66 copy_abs(dev
, ABS_Y
, ABS_MT_POSITION_Y
);
67 copy_abs(dev
, ABS_PRESSURE
, ABS_MT_PRESSURE
);
69 if (flags
& INPUT_MT_POINTER
) {
70 __set_bit(BTN_TOOL_FINGER
, dev
->keybit
);
71 __set_bit(BTN_TOOL_DOUBLETAP
, dev
->keybit
);
73 __set_bit(BTN_TOOL_TRIPLETAP
, dev
->keybit
);
75 __set_bit(BTN_TOOL_QUADTAP
, dev
->keybit
);
77 __set_bit(BTN_TOOL_QUINTTAP
, dev
->keybit
);
78 __set_bit(INPUT_PROP_POINTER
, dev
->propbit
);
80 if (flags
& INPUT_MT_DIRECT
)
81 __set_bit(INPUT_PROP_DIRECT
, dev
->propbit
);
82 if (flags
& INPUT_MT_SEMI_MT
)
83 __set_bit(INPUT_PROP_SEMI_MT
, dev
->propbit
);
84 if (flags
& INPUT_MT_TRACK
) {
85 unsigned int n2
= num_slots
* num_slots
;
86 mt
->red
= kcalloc(n2
, sizeof(*mt
->red
), GFP_KERNEL
);
91 /* Mark slots as 'inactive' */
92 for (i
= 0; i
< num_slots
; i
++)
93 input_mt_set_value(&mt
->slots
[i
], ABS_MT_TRACKING_ID
, -1);
95 /* Mark slots as 'unused' */
104 EXPORT_SYMBOL(input_mt_init_slots
);
107 * input_mt_destroy_slots() - frees the MT slots of the input device
108 * @dev: input device with allocated MT slots
110 * This function is only needed in error path as the input core will
111 * automatically free the MT slots when the device is destroyed.
113 void input_mt_destroy_slots(struct input_dev
*dev
)
121 EXPORT_SYMBOL(input_mt_destroy_slots
);
124 * input_mt_report_slot_state() - report contact state
125 * @dev: input device with allocated MT slots
126 * @tool_type: the tool type to use in this slot
127 * @active: true if contact is active, false otherwise
129 * Reports a contact via ABS_MT_TRACKING_ID, and optionally
130 * ABS_MT_TOOL_TYPE. If active is true and the slot is currently
131 * inactive, or if the tool type is changed, a new tracking id is
132 * assigned to the slot. The tool type is only reported if the
133 * corresponding absbit field is set.
135 void input_mt_report_slot_state(struct input_dev
*dev
,
136 unsigned int tool_type
, bool active
)
138 struct input_mt
*mt
= dev
->mt
;
139 struct input_mt_slot
*slot
;
145 slot
= &mt
->slots
[mt
->slot
];
146 slot
->frame
= mt
->frame
;
149 input_event(dev
, EV_ABS
, ABS_MT_TRACKING_ID
, -1);
153 id
= input_mt_get_value(slot
, ABS_MT_TRACKING_ID
);
154 if (id
< 0 || input_mt_get_value(slot
, ABS_MT_TOOL_TYPE
) != tool_type
)
155 id
= input_mt_new_trkid(mt
);
157 input_event(dev
, EV_ABS
, ABS_MT_TRACKING_ID
, id
);
158 input_event(dev
, EV_ABS
, ABS_MT_TOOL_TYPE
, tool_type
);
160 EXPORT_SYMBOL(input_mt_report_slot_state
);
163 * input_mt_report_finger_count() - report contact count
164 * @dev: input device with allocated MT slots
165 * @count: the number of contacts
167 * Reports the contact count via BTN_TOOL_FINGER, BTN_TOOL_DOUBLETAP,
168 * BTN_TOOL_TRIPLETAP and BTN_TOOL_QUADTAP.
170 * The input core ensures only the KEY events already setup for
171 * this device will produce output.
173 void input_mt_report_finger_count(struct input_dev
*dev
, int count
)
175 input_event(dev
, EV_KEY
, BTN_TOOL_FINGER
, count
== 1);
176 input_event(dev
, EV_KEY
, BTN_TOOL_DOUBLETAP
, count
== 2);
177 input_event(dev
, EV_KEY
, BTN_TOOL_TRIPLETAP
, count
== 3);
178 input_event(dev
, EV_KEY
, BTN_TOOL_QUADTAP
, count
== 4);
179 input_event(dev
, EV_KEY
, BTN_TOOL_QUINTTAP
, count
== 5);
181 EXPORT_SYMBOL(input_mt_report_finger_count
);
184 * input_mt_report_pointer_emulation() - common pointer emulation
185 * @dev: input device with allocated MT slots
186 * @use_count: report number of active contacts as finger count
188 * Performs legacy pointer emulation via BTN_TOUCH, ABS_X, ABS_Y and
189 * ABS_PRESSURE. Touchpad finger count is emulated if use_count is true.
191 * The input core ensures only the KEY and ABS axes already setup for
192 * this device will produce output.
194 void input_mt_report_pointer_emulation(struct input_dev
*dev
, bool use_count
)
196 struct input_mt
*mt
= dev
->mt
;
197 struct input_mt_slot
*oldest
;
207 for (i
= 0; i
< mt
->num_slots
; ++i
) {
208 struct input_mt_slot
*ps
= &mt
->slots
[i
];
209 int id
= input_mt_get_value(ps
, ABS_MT_TRACKING_ID
);
213 if ((id
- oldid
) & TRKID_SGN
) {
220 input_event(dev
, EV_KEY
, BTN_TOUCH
, count
> 0);
224 !test_bit(ABS_MT_DISTANCE
, dev
->absbit
) &&
225 test_bit(ABS_DISTANCE
, dev
->absbit
) &&
226 input_abs_get_val(dev
, ABS_DISTANCE
) != 0) {
228 * Force reporting BTN_TOOL_FINGER for devices that
229 * only report general hover (and not per-contact
230 * distance) when contact is in proximity but not
236 input_mt_report_finger_count(dev
, count
);
240 int x
= input_mt_get_value(oldest
, ABS_MT_POSITION_X
);
241 int y
= input_mt_get_value(oldest
, ABS_MT_POSITION_Y
);
243 input_event(dev
, EV_ABS
, ABS_X
, x
);
244 input_event(dev
, EV_ABS
, ABS_Y
, y
);
246 if (test_bit(ABS_MT_PRESSURE
, dev
->absbit
)) {
247 int p
= input_mt_get_value(oldest
, ABS_MT_PRESSURE
);
248 input_event(dev
, EV_ABS
, ABS_PRESSURE
, p
);
251 if (test_bit(ABS_MT_PRESSURE
, dev
->absbit
))
252 input_event(dev
, EV_ABS
, ABS_PRESSURE
, 0);
255 EXPORT_SYMBOL(input_mt_report_pointer_emulation
);
257 static void __input_mt_drop_unused(struct input_dev
*dev
, struct input_mt
*mt
)
261 for (i
= 0; i
< mt
->num_slots
; i
++) {
262 if (!input_mt_is_used(mt
, &mt
->slots
[i
])) {
263 input_mt_slot(dev
, i
);
264 input_event(dev
, EV_ABS
, ABS_MT_TRACKING_ID
, -1);
270 * input_mt_drop_unused() - Inactivate slots not seen in this frame
271 * @dev: input device with allocated MT slots
273 * Lift all slots not seen since the last call to this function.
275 void input_mt_drop_unused(struct input_dev
*dev
)
277 struct input_mt
*mt
= dev
->mt
;
280 __input_mt_drop_unused(dev
, mt
);
284 EXPORT_SYMBOL(input_mt_drop_unused
);
287 * input_mt_sync_frame() - synchronize mt frame
288 * @dev: input device with allocated MT slots
290 * Close the frame and prepare the internal state for a new one.
291 * Depending on the flags, marks unused slots as inactive and performs
294 void input_mt_sync_frame(struct input_dev
*dev
)
296 struct input_mt
*mt
= dev
->mt
;
297 bool use_count
= false;
302 if (mt
->flags
& INPUT_MT_DROP_UNUSED
)
303 __input_mt_drop_unused(dev
, mt
);
305 if ((mt
->flags
& INPUT_MT_POINTER
) && !(mt
->flags
& INPUT_MT_SEMI_MT
))
308 input_mt_report_pointer_emulation(dev
, use_count
);
312 EXPORT_SYMBOL(input_mt_sync_frame
);
314 static int adjust_dual(int *begin
, int step
, int *end
, int eq
, int mu
)
323 s
= p
== end
? f
+ 1 : *p
;
325 for (; p
!= end
; p
+= step
)
332 if (c
== 0 || (c
> mu
&& (!eq
|| mu
> 0)))
334 /* Improve convergence for positive matrices by penalizing overcovers */
335 if (s
< 0 && mu
<= 0)
338 for (p
= begin
; p
!= end
; p
+= step
)
341 return (c
< s
&& s
<= 0) || (f
>= 0 && f
< c
);
344 static void find_reduced_matrix(int *w
, int nr
, int nc
, int nrc
, int mu
)
348 for (k
= 0; k
< nrc
; k
++) {
349 for (i
= 0; i
< nr
; i
++)
350 adjust_dual(w
+ i
, nr
, w
+ i
+ nrc
, nr
<= nc
, mu
);
352 for (i
= 0; i
< nrc
; i
+= nr
)
353 sum
+= adjust_dual(w
+ i
, 1, w
+ i
+ nr
, nc
<= nr
, mu
);
359 static int input_mt_set_matrix(struct input_mt
*mt
,
360 const struct input_mt_pos
*pos
, int num_pos
,
363 const struct input_mt_pos
*p
;
364 struct input_mt_slot
*s
;
368 for (s
= mt
->slots
; s
!= mt
->slots
+ mt
->num_slots
; s
++) {
369 if (!input_mt_is_active(s
))
371 x
= input_mt_get_value(s
, ABS_MT_POSITION_X
);
372 y
= input_mt_get_value(s
, ABS_MT_POSITION_Y
);
373 for (p
= pos
; p
!= pos
+ num_pos
; p
++) {
374 int dx
= x
- p
->x
, dy
= y
- p
->y
;
375 *w
++ = dx
* dx
+ dy
* dy
- mu
;
382 static void input_mt_set_slots(struct input_mt
*mt
,
383 int *slots
, int num_pos
)
385 struct input_mt_slot
*s
;
388 for (j
= 0; j
!= num_pos
; j
++)
391 for (s
= mt
->slots
; s
!= mt
->slots
+ mt
->num_slots
; s
++) {
392 if (!input_mt_is_active(s
))
395 for (j
= 0; j
!= num_pos
; j
++) {
397 slots
[j
] = s
- mt
->slots
;
405 for (s
= mt
->slots
; s
!= mt
->slots
+ mt
->num_slots
; s
++) {
406 if (input_mt_is_active(s
))
409 for (j
= 0; j
!= num_pos
; j
++) {
411 slots
[j
] = s
- mt
->slots
;
419 * input_mt_assign_slots() - perform a best-match assignment
420 * @dev: input device with allocated MT slots
421 * @slots: the slot assignment to be filled
422 * @pos: the position array to match
423 * @num_pos: number of positions
424 * @dmax: maximum ABS_MT_POSITION displacement (zero for infinite)
426 * Performs a best match against the current contacts and returns
427 * the slot assignment list. New contacts are assigned to unused
430 * The assignments are balanced so that all coordinate displacements are
431 * below the euclidian distance dmax. If no such assignment can be found,
432 * some contacts are assigned to unused slots.
434 * Returns zero on success, or negative error in case of failure.
436 int input_mt_assign_slots(struct input_dev
*dev
, int *slots
,
437 const struct input_mt_pos
*pos
, int num_pos
,
440 struct input_mt
*mt
= dev
->mt
;
441 int mu
= 2 * dmax
* dmax
;
446 if (num_pos
> mt
->num_slots
)
451 nrc
= input_mt_set_matrix(mt
, pos
, num_pos
, mu
);
452 find_reduced_matrix(mt
->red
, num_pos
, nrc
/ num_pos
, nrc
, mu
);
453 input_mt_set_slots(mt
, slots
, num_pos
);
457 EXPORT_SYMBOL(input_mt_assign_slots
);
460 * input_mt_get_slot_by_key() - return slot matching key
461 * @dev: input device with allocated MT slots
462 * @key: the key of the sought slot
464 * Returns the slot of the given key, if it exists, otherwise
465 * set the key on the first unused slot and return.
467 * If no available slot can be found, -1 is returned.
468 * Note that for this function to work properly, input_mt_sync_frame() has
469 * to be called at each frame.
471 int input_mt_get_slot_by_key(struct input_dev
*dev
, int key
)
473 struct input_mt
*mt
= dev
->mt
;
474 struct input_mt_slot
*s
;
479 for (s
= mt
->slots
; s
!= mt
->slots
+ mt
->num_slots
; s
++)
480 if (input_mt_is_active(s
) && s
->key
== key
)
481 return s
- mt
->slots
;
483 for (s
= mt
->slots
; s
!= mt
->slots
+ mt
->num_slots
; s
++)
484 if (!input_mt_is_active(s
) && !input_mt_is_used(mt
, s
)) {
486 return s
- mt
->slots
;
491 EXPORT_SYMBOL(input_mt_get_slot_by_key
);