xref: /linux/include/linux/input/mt.h (revision 0ea5c948cb64bab5bc7a5516774eb8536f05aa0d)
1 /* SPDX-License-Identifier: GPL-2.0-only */
2 #ifndef _INPUT_MT_H
3 #define _INPUT_MT_H
4 
5 /*
6  * Input Multitouch Library
7  *
8  * Copyright (c) 2010 Henrik Rydberg
9  */
10 
11 #include <linux/input.h>
12 
13 #define TRKID_MAX	0xffff
14 
15 #define INPUT_MT_POINTER	0x0001	/* pointer device, e.g. trackpad */
16 #define INPUT_MT_DIRECT		0x0002	/* direct device, e.g. touchscreen */
17 #define INPUT_MT_DROP_UNUSED	0x0004	/* drop contacts not seen in frame */
18 #define INPUT_MT_TRACK		0x0008	/* use in-kernel tracking */
19 #define INPUT_MT_SEMI_MT	0x0010	/* semi-mt device, finger count handled manually */
20 
21 /**
22  * struct input_mt_slot - represents the state of an input MT slot
23  * @abs: holds current values of ABS_MT axes for this slot
24  * @frame: last frame at which input_mt_report_slot_state() was called
25  * @key: optional driver designation of this slot
26  */
27 struct input_mt_slot {
28 	int abs[ABS_MT_LAST - ABS_MT_FIRST + 1];
29 	unsigned int frame;
30 	unsigned int key;
31 };
32 
33 /**
34  * struct input_mt - state of tracked contacts
35  * @trkid: stores MT tracking ID for the next contact
36  * @num_slots: number of MT slots the device uses
37  * @slot: MT slot currently being transmitted
38  * @flags: input_mt operation flags
39  * @frame: increases every time input_mt_sync_frame() is called
40  * @red: reduced cost matrix for in-kernel tracking
41  * @slots: array of slots holding current values of tracked contacts
42  */
43 struct input_mt {
44 	int trkid;
45 	int num_slots;
46 	int slot;
47 	unsigned int flags;
48 	unsigned int frame;
49 	int *red;
50 	struct input_mt_slot slots[] __counted_by(num_slots);
51 };
52 
input_mt_set_value(struct input_mt_slot * slot,unsigned code,int value)53 static inline void input_mt_set_value(struct input_mt_slot *slot,
54 				      unsigned code, int value)
55 {
56 	slot->abs[code - ABS_MT_FIRST] = value;
57 }
58 
input_mt_get_value(const struct input_mt_slot * slot,unsigned code)59 static inline int input_mt_get_value(const struct input_mt_slot *slot,
60 				     unsigned code)
61 {
62 	return slot->abs[code - ABS_MT_FIRST];
63 }
64 
input_mt_is_active(const struct input_mt_slot * slot)65 static inline bool input_mt_is_active(const struct input_mt_slot *slot)
66 {
67 	return input_mt_get_value(slot, ABS_MT_TRACKING_ID) >= 0;
68 }
69 
input_mt_is_used(const struct input_mt * mt,const struct input_mt_slot * slot)70 static inline bool input_mt_is_used(const struct input_mt *mt,
71 				    const struct input_mt_slot *slot)
72 {
73 	return slot->frame == mt->frame;
74 }
75 
76 int input_mt_init_slots(struct input_dev *dev, unsigned int num_slots,
77 			unsigned int flags);
78 void input_mt_destroy_slots(struct input_dev *dev);
79 
input_mt_new_trkid(struct input_mt * mt)80 static inline int input_mt_new_trkid(struct input_mt *mt)
81 {
82 	return mt->trkid++ & TRKID_MAX;
83 }
84 
input_mt_slot(struct input_dev * dev,int slot)85 static inline void input_mt_slot(struct input_dev *dev, int slot)
86 {
87 	input_event(dev, EV_ABS, ABS_MT_SLOT, slot);
88 }
89 
input_is_mt_value(int axis)90 static inline bool input_is_mt_value(int axis)
91 {
92 	return axis >= ABS_MT_FIRST && axis <= ABS_MT_LAST;
93 }
94 
input_is_mt_axis(int axis)95 static inline bool input_is_mt_axis(int axis)
96 {
97 	return axis == ABS_MT_SLOT || input_is_mt_value(axis);
98 }
99 
100 bool input_mt_report_slot_state(struct input_dev *dev,
101 				unsigned int tool_type, bool active);
102 
input_mt_report_slot_inactive(struct input_dev * dev)103 static inline void input_mt_report_slot_inactive(struct input_dev *dev)
104 {
105 	input_mt_report_slot_state(dev, 0, false);
106 }
107 
108 void input_mt_report_finger_count(struct input_dev *dev, int count);
109 void input_mt_report_pointer_emulation(struct input_dev *dev, bool use_count);
110 void input_mt_drop_unused(struct input_dev *dev);
111 
112 void input_mt_sync_frame(struct input_dev *dev);
113 
114 /**
115  * struct input_mt_pos - contact position
116  * @x: horizontal coordinate
117  * @y: vertical coordinate
118  */
119 struct input_mt_pos {
120 	s16 x, y;
121 };
122 
123 int input_mt_assign_slots(struct input_dev *dev, int *slots,
124 			  const struct input_mt_pos *pos, int num_pos,
125 			  int dmax);
126 
127 int input_mt_get_slot_by_key(struct input_dev *dev, int key);
128 
129 #endif
130