xref: /linux/drivers/input/mouse/cypress_ps2.h (revision c4ee0af3fa0dc65f690fc908f02b8355f9576ea0)
1 #ifndef _CYPRESS_PS2_H
2 #define _CYPRESS_PS2_H
3 
4 #include "psmouse.h"
5 
6 #define CMD_BITS_MASK 0x03
7 #define COMPOSIT(x, s) (((x) & CMD_BITS_MASK) << (s))
8 
9 #define ENCODE_CMD(aa, bb, cc, dd) \
10 	(COMPOSIT((aa), 6) | COMPOSIT((bb), 4) | COMPOSIT((cc), 2) | COMPOSIT((dd), 0))
11 #define CYTP_CMD_ABS_NO_PRESSURE_MODE       ENCODE_CMD(0, 1, 0, 0)
12 #define CYTP_CMD_ABS_WITH_PRESSURE_MODE     ENCODE_CMD(0, 1, 0, 1)
13 #define CYTP_CMD_SMBUS_MODE                 ENCODE_CMD(0, 1, 1, 0)
14 #define CYTP_CMD_STANDARD_MODE              ENCODE_CMD(0, 2, 0, 0)  /* not implemented yet. */
15 #define CYTP_CMD_CYPRESS_REL_MODE           ENCODE_CMD(1, 1, 1, 1)  /* not implemented yet. */
16 #define CYTP_CMD_READ_CYPRESS_ID            ENCODE_CMD(0, 0, 0, 0)
17 #define CYTP_CMD_READ_TP_METRICS            ENCODE_CMD(0, 0, 0, 1)
18 #define CYTP_CMD_SET_HSCROLL_WIDTH(w)       ENCODE_CMD(1, 1, 0, (w))
19 #define     CYTP_CMD_SET_HSCROLL_MASK       ENCODE_CMD(1, 1, 0, 0)
20 #define CYTP_CMD_SET_VSCROLL_WIDTH(w)       ENCODE_CMD(1, 2, 0, (w))
21 #define     CYTP_CMD_SET_VSCROLL_MASK       ENCODE_CMD(1, 2, 0, 0)
22 #define CYTP_CMD_SET_PALM_GEOMETRY(e)       ENCODE_CMD(1, 2, 1, (e))
23 #define     CYTP_CMD_PALM_GEMMETRY_MASK     ENCODE_CMD(1, 2, 1, 0)
24 #define CYTP_CMD_SET_PALM_SENSITIVITY(s)    ENCODE_CMD(1, 2, 2, (s))
25 #define     CYTP_CMD_PALM_SENSITIVITY_MASK  ENCODE_CMD(1, 2, 2, 0)
26 #define CYTP_CMD_SET_MOUSE_SENSITIVITY(s)   ENCODE_CMD(1, 3, ((s) >> 2), (s))
27 #define     CYTP_CMD_MOUSE_SENSITIVITY_MASK ENCODE_CMD(1, 3, 0, 0)
28 #define CYTP_CMD_REQUEST_BASELINE_STATUS    ENCODE_CMD(2, 0, 0, 1)
29 #define CYTP_CMD_REQUEST_RECALIBRATION      ENCODE_CMD(2, 0, 0, 3)
30 
31 #define DECODE_CMD_AA(x) (((x) >> 6) & CMD_BITS_MASK)
32 #define DECODE_CMD_BB(x) (((x) >> 4) & CMD_BITS_MASK)
33 #define DECODE_CMD_CC(x) (((x) >> 2) & CMD_BITS_MASK)
34 #define DECODE_CMD_DD(x) ((x) & CMD_BITS_MASK)
35 
36 /* Cypress trackpad working mode. */
37 #define CYTP_BIT_ABS_PRESSURE    (1 << 3)
38 #define CYTP_BIT_ABS_NO_PRESSURE (1 << 2)
39 #define CYTP_BIT_CYPRESS_REL     (1 << 1)
40 #define CYTP_BIT_STANDARD_REL    (1 << 0)
41 #define CYTP_BIT_REL_MASK (CYTP_BIT_CYPRESS_REL | CYTP_BIT_STANDARD_REL)
42 #define CYTP_BIT_ABS_MASK (CYTP_BIT_ABS_PRESSURE | CYTP_BIT_ABS_NO_PRESSURE)
43 #define CYTP_BIT_ABS_REL_MASK (CYTP_BIT_ABS_MASK | CYTP_BIT_REL_MASK)
44 
45 #define CYTP_BIT_HIGH_RATE       (1 << 4)
46 /*
47  * report mode bit is set, firmware working in Remote Mode.
48  * report mode bit is cleared, firmware working in Stream Mode.
49  */
50 #define CYTP_BIT_REPORT_MODE     (1 << 5)
51 
52 /* scrolling width values for set HSCROLL and VSCROLL width command. */
53 #define SCROLL_WIDTH_NARROW 1
54 #define SCROLL_WIDTH_NORMAL 2
55 #define SCROLL_WIDTH_WIDE   3
56 
57 #define PALM_GEOMETRY_ENABLE  1
58 #define PALM_GEOMETRY_DISABLE 0
59 
60 #define TP_METRICS_MASK  0x80
61 #define FW_VERSION_MASX    0x7f
62 #define FW_VER_HIGH_MASK 0x70
63 #define FW_VER_LOW_MASK  0x0f
64 
65 /* Times to retry a ps2_command and millisecond delay between tries. */
66 #define CYTP_PS2_CMD_TRIES 3
67 #define CYTP_PS2_CMD_DELAY 500
68 
69 /* time out for PS/2 command only in milliseconds. */
70 #define CYTP_CMD_TIMEOUT  200
71 #define CYTP_DATA_TIMEOUT 30
72 
73 #define CYTP_EXT_CMD   0xe8
74 #define CYTP_PS2_RETRY 0xfe
75 #define CYTP_PS2_ERROR 0xfc
76 
77 #define CYTP_RESP_RETRY 0x01
78 #define CYTP_RESP_ERROR 0xfe
79 
80 
81 #define CYTP_105001_WIDTH  97   /* Dell XPS 13 */
82 #define CYTP_105001_HIGH   59
83 #define CYTP_DEFAULT_WIDTH (CYTP_105001_WIDTH)
84 #define CYTP_DEFAULT_HIGH  (CYTP_105001_HIGH)
85 
86 #define CYTP_ABS_MAX_X     1600
87 #define CYTP_ABS_MAX_Y     900
88 #define CYTP_MAX_PRESSURE  255
89 #define CYTP_MIN_PRESSURE  0
90 
91 /* header byte bits of relative package. */
92 #define BTN_LEFT_BIT   0x01
93 #define BTN_RIGHT_BIT  0x02
94 #define BTN_MIDDLE_BIT 0x04
95 #define REL_X_SIGN_BIT 0x10
96 #define REL_Y_SIGN_BIT 0x20
97 
98 /* header byte bits of absolute package. */
99 #define ABS_VSCROLL_BIT 0x10
100 #define ABS_HSCROLL_BIT 0x20
101 #define ABS_MULTIFINGER_TAP 0x04
102 #define ABS_EDGE_MOTION_MASK 0x80
103 
104 #define DFLT_RESP_BITS_VALID     0x88  /* SMBus bit should not be set. */
105 #define DFLT_RESP_SMBUS_BIT      0x80
106 #define   DFLT_SMBUS_MODE        0x80
107 #define   DFLT_PS2_MODE          0x00
108 #define DFLT_RESP_BIT_MODE       0x40
109 #define   DFLT_RESP_REMOTE_MODE  0x40
110 #define   DFLT_RESP_STREAM_MODE  0x00
111 #define DFLT_RESP_BIT_REPORTING  0x20
112 #define DFLT_RESP_BIT_SCALING    0x10
113 
114 #define TP_METRICS_BIT_PALM               0x80
115 #define TP_METRICS_BIT_STUBBORN           0x40
116 #define TP_METRICS_BIT_2F_JITTER          0x30
117 #define TP_METRICS_BIT_1F_JITTER          0x0c
118 #define TP_METRICS_BIT_APA                0x02
119 #define TP_METRICS_BIT_MTG                0x01
120 #define TP_METRICS_BIT_ABS_PKT_FORMAT_SET 0xf0
121 #define TP_METRICS_BIT_2F_SPIKE           0x0c
122 #define TP_METRICS_BIT_1F_SPIKE           0x03
123 
124 /* bits of first byte response of E9h-Status Request command. */
125 #define RESP_BTN_RIGHT_BIT  0x01
126 #define RESP_BTN_MIDDLE_BIT 0x02
127 #define RESP_BTN_LEFT_BIT   0x04
128 #define RESP_SCALING_BIT    0x10
129 #define RESP_ENABLE_BIT     0x20
130 #define RESP_REMOTE_BIT     0x40
131 #define RESP_SMBUS_BIT      0x80
132 
133 #define CYTP_MAX_MT_SLOTS 2
134 
135 struct cytp_contact {
136 	int x;
137 	int y;
138 	int z;  /* also named as touch pressure. */
139 };
140 
141 /* The structure of Cypress Trackpad event data. */
142 struct cytp_report_data {
143 	int contact_cnt;
144 	struct cytp_contact contacts[CYTP_MAX_MT_SLOTS];
145 	unsigned int left:1;
146 	unsigned int right:1;
147 	unsigned int middle:1;
148 	unsigned int tap:1;  /* multi-finger tap detected. */
149 };
150 
151 /* The structure of Cypress Trackpad device private data. */
152 struct cytp_data {
153 	int fw_version;
154 
155 	int pkt_size;
156 	int mode;
157 
158 	int tp_min_pressure;
159 	int tp_max_pressure;
160 	int tp_width;  /* X direction physical size in mm. */
161 	int tp_high;  /* Y direction physical size in mm. */
162 	int tp_max_abs_x;  /* Max X absolute units that can be reported. */
163 	int tp_max_abs_y;  /* Max Y absolute units that can be reported. */
164 
165 	int tp_res_x;  /* X resolution in units/mm. */
166 	int tp_res_y;  /* Y resolution in units/mm. */
167 
168 	int tp_metrics_supported;
169 };
170 
171 
172 #ifdef CONFIG_MOUSE_PS2_CYPRESS
173 int cypress_detect(struct psmouse *psmouse, bool set_properties);
174 int cypress_init(struct psmouse *psmouse);
175 bool cypress_supported(void);
176 #else
177 inline int cypress_detect(struct psmouse *psmouse, bool set_properties)
178 {
179 	return -ENOSYS;
180 }
181 inline int cypress_init(struct psmouse *psmouse)
182 {
183 	return -ENOSYS;
184 }
185 inline bool cypress_supported(void)
186 {
187 	return 0;
188 }
189 #endif /* CONFIG_MOUSE_PS2_CYPRESS */
190 
191 #endif  /* _CYPRESS_PS2_H */
192