Loading...
1/*
2 * Elantech Touchpad driver (v6)
3 *
4 * Copyright (C) 2007-2009 Arjan Opmeer <arjan@opmeer.net>
5 *
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
8 * by the Free Software Foundation.
9 *
10 * Trademarks are the property of their respective owners.
11 */
12
13#ifndef _ELANTECH_H
14#define _ELANTECH_H
15
16/*
17 * Command values for Synaptics style queries
18 */
19#define ETP_FW_ID_QUERY 0x00
20#define ETP_FW_VERSION_QUERY 0x01
21#define ETP_CAPABILITIES_QUERY 0x02
22#define ETP_SAMPLE_QUERY 0x03
23#define ETP_RESOLUTION_QUERY 0x04
24
25/*
26 * Command values for register reading or writing
27 */
28#define ETP_REGISTER_READ 0x10
29#define ETP_REGISTER_WRITE 0x11
30#define ETP_REGISTER_READWRITE 0x00
31
32/*
33 * Hardware version 2 custom PS/2 command value
34 */
35#define ETP_PS2_CUSTOM_COMMAND 0xf8
36
37/*
38 * Times to retry a ps2_command and millisecond delay between tries
39 */
40#define ETP_PS2_COMMAND_TRIES 3
41#define ETP_PS2_COMMAND_DELAY 500
42
43/*
44 * Times to try to read back a register and millisecond delay between tries
45 */
46#define ETP_READ_BACK_TRIES 5
47#define ETP_READ_BACK_DELAY 2000
48
49/*
50 * Register bitmasks for hardware version 1
51 */
52#define ETP_R10_ABSOLUTE_MODE 0x04
53#define ETP_R11_4_BYTE_MODE 0x02
54
55/*
56 * Capability bitmasks
57 */
58#define ETP_CAP_HAS_ROCKER 0x04
59
60/*
61 * One hard to find application note states that X axis range is 0 to 576
62 * and Y axis range is 0 to 384 for harware version 1.
63 * Edge fuzz might be necessary because of bezel around the touchpad
64 */
65#define ETP_EDGE_FUZZ_V1 32
66
67#define ETP_XMIN_V1 ( 0 + ETP_EDGE_FUZZ_V1)
68#define ETP_XMAX_V1 (576 - ETP_EDGE_FUZZ_V1)
69#define ETP_YMIN_V1 ( 0 + ETP_EDGE_FUZZ_V1)
70#define ETP_YMAX_V1 (384 - ETP_EDGE_FUZZ_V1)
71
72/*
73 * The resolution for older v2 hardware doubled.
74 * (newer v2's firmware provides command so we can query)
75 */
76#define ETP_XMIN_V2 0
77#define ETP_XMAX_V2 1152
78#define ETP_YMIN_V2 0
79#define ETP_YMAX_V2 768
80
81#define ETP_PMIN_V2 0
82#define ETP_PMAX_V2 255
83#define ETP_WMIN_V2 0
84#define ETP_WMAX_V2 15
85
86/*
87 * v3 hardware has 2 kinds of packet types,
88 * v4 hardware has 3.
89 */
90#define PACKET_UNKNOWN 0x01
91#define PACKET_DEBOUNCE 0x02
92#define PACKET_V3_HEAD 0x03
93#define PACKET_V3_TAIL 0x04
94#define PACKET_V4_HEAD 0x05
95#define PACKET_V4_MOTION 0x06
96#define PACKET_V4_STATUS 0x07
97#define PACKET_TRACKPOINT 0x08
98
99/*
100 * track up to 5 fingers for v4 hardware
101 */
102#define ETP_MAX_FINGERS 5
103
104/*
105 * weight value for v4 hardware
106 */
107#define ETP_WEIGHT_VALUE 5
108
109/*
110 * The base position for one finger, v4 hardware
111 */
112struct finger_pos {
113 unsigned int x;
114 unsigned int y;
115};
116
117struct elantech_data {
118 struct input_dev *tp_dev; /* Relative device for trackpoint */
119 char tp_phys[32];
120 unsigned char reg_07;
121 unsigned char reg_10;
122 unsigned char reg_11;
123 unsigned char reg_20;
124 unsigned char reg_21;
125 unsigned char reg_22;
126 unsigned char reg_23;
127 unsigned char reg_24;
128 unsigned char reg_25;
129 unsigned char reg_26;
130 unsigned char debug;
131 unsigned char capabilities[3];
132 unsigned char samples[3];
133 bool paritycheck;
134 bool jumpy_cursor;
135 bool reports_pressure;
136 bool crc_enabled;
137 bool set_hw_resolution;
138 unsigned char hw_version;
139 unsigned int fw_version;
140 unsigned int single_finger_reports;
141 unsigned int y_max;
142 unsigned int width;
143 struct finger_pos mt[ETP_MAX_FINGERS];
144 unsigned char parity[256];
145 int (*send_cmd)(struct psmouse *psmouse, unsigned char c, unsigned char *param);
146 void (*original_set_rate)(struct psmouse *psmouse, unsigned int rate);
147};
148
149#ifdef CONFIG_MOUSE_PS2_ELANTECH
150int elantech_detect(struct psmouse *psmouse, bool set_properties);
151int elantech_init(struct psmouse *psmouse);
152#else
153static inline int elantech_detect(struct psmouse *psmouse, bool set_properties)
154{
155 return -ENOSYS;
156}
157static inline int elantech_init(struct psmouse *psmouse)
158{
159 return -ENOSYS;
160}
161#endif /* CONFIG_MOUSE_PS2_ELANTECH */
162
163#endif
1/* SPDX-License-Identifier: GPL-2.0-only */
2/*
3 * Elantech Touchpad driver (v6)
4 *
5 * Copyright (C) 2007-2009 Arjan Opmeer <arjan@opmeer.net>
6 *
7 * Trademarks are the property of their respective owners.
8 */
9
10#ifndef _ELANTECH_H
11#define _ELANTECH_H
12
13/*
14 * Command values for Synaptics style queries
15 */
16#define ETP_FW_ID_QUERY 0x00
17#define ETP_FW_VERSION_QUERY 0x01
18#define ETP_CAPABILITIES_QUERY 0x02
19#define ETP_SAMPLE_QUERY 0x03
20#define ETP_RESOLUTION_QUERY 0x04
21#define ETP_ICBODY_QUERY 0x05
22
23/*
24 * Command values for register reading or writing
25 */
26#define ETP_REGISTER_READ 0x10
27#define ETP_REGISTER_WRITE 0x11
28#define ETP_REGISTER_READWRITE 0x00
29
30/*
31 * Hardware version 2 custom PS/2 command value
32 */
33#define ETP_PS2_CUSTOM_COMMAND 0xf8
34
35/*
36 * Times to retry a ps2_command and millisecond delay between tries
37 */
38#define ETP_PS2_COMMAND_TRIES 3
39#define ETP_PS2_COMMAND_DELAY 500
40
41/*
42 * Times to try to read back a register and millisecond delay between tries
43 */
44#define ETP_READ_BACK_TRIES 5
45#define ETP_READ_BACK_DELAY 2000
46
47/*
48 * Register bitmasks for hardware version 1
49 */
50#define ETP_R10_ABSOLUTE_MODE 0x04
51#define ETP_R11_4_BYTE_MODE 0x02
52
53/*
54 * Capability bitmasks
55 */
56#define ETP_CAP_HAS_ROCKER 0x04
57
58/*
59 * One hard to find application note states that X axis range is 0 to 576
60 * and Y axis range is 0 to 384 for harware version 1.
61 * Edge fuzz might be necessary because of bezel around the touchpad
62 */
63#define ETP_EDGE_FUZZ_V1 32
64
65#define ETP_XMIN_V1 ( 0 + ETP_EDGE_FUZZ_V1)
66#define ETP_XMAX_V1 (576 - ETP_EDGE_FUZZ_V1)
67#define ETP_YMIN_V1 ( 0 + ETP_EDGE_FUZZ_V1)
68#define ETP_YMAX_V1 (384 - ETP_EDGE_FUZZ_V1)
69
70/*
71 * The resolution for older v2 hardware doubled.
72 * (newer v2's firmware provides command so we can query)
73 */
74#define ETP_XMIN_V2 0
75#define ETP_XMAX_V2 1152
76#define ETP_YMIN_V2 0
77#define ETP_YMAX_V2 768
78
79#define ETP_PMIN_V2 0
80#define ETP_PMAX_V2 255
81#define ETP_WMIN_V2 0
82#define ETP_WMAX_V2 15
83
84/*
85 * v3 hardware has 2 kinds of packet types,
86 * v4 hardware has 3.
87 */
88#define PACKET_UNKNOWN 0x01
89#define PACKET_DEBOUNCE 0x02
90#define PACKET_V3_HEAD 0x03
91#define PACKET_V3_TAIL 0x04
92#define PACKET_V4_HEAD 0x05
93#define PACKET_V4_MOTION 0x06
94#define PACKET_V4_STATUS 0x07
95#define PACKET_TRACKPOINT 0x08
96
97/*
98 * track up to 5 fingers for v4 hardware
99 */
100#define ETP_MAX_FINGERS 5
101
102/*
103 * weight value for v4 hardware
104 */
105#define ETP_WEIGHT_VALUE 5
106
107/*
108 * Bus information on 3rd byte of query ETP_RESOLUTION_QUERY(0x04)
109 */
110#define ETP_BUS_PS2_ONLY 0
111#define ETP_BUS_SMB_ALERT_ONLY 1
112#define ETP_BUS_SMB_HST_NTFY_ONLY 2
113#define ETP_BUS_PS2_SMB_ALERT 3
114#define ETP_BUS_PS2_SMB_HST_NTFY 4
115
116/*
117 * New ICs are either using SMBus Host Notify or just plain PS2.
118 *
119 * ETP_FW_VERSION_QUERY is:
120 * Byte 1:
121 * - bit 0..3: IC BODY
122 * Byte 2:
123 * - bit 4: HiddenButton
124 * - bit 5: PS2_SMBUS_NOTIFY
125 * - bit 6: PS2CRCCheck
126 */
127#define ETP_NEW_IC_SMBUS_HOST_NOTIFY(fw_version) \
128 ((((fw_version) & 0x0f2000) == 0x0f2000) && \
129 ((fw_version) & 0x0000ff) > 0)
130
131/*
132 * The base position for one finger, v4 hardware
133 */
134struct finger_pos {
135 unsigned int x;
136 unsigned int y;
137};
138
139struct elantech_device_info {
140 unsigned char capabilities[3];
141 unsigned char samples[3];
142 unsigned char debug;
143 unsigned char hw_version;
144 unsigned char pattern;
145 unsigned int fw_version;
146 unsigned int ic_version;
147 unsigned int product_id;
148 unsigned int x_min;
149 unsigned int y_min;
150 unsigned int x_max;
151 unsigned int y_max;
152 unsigned int x_res;
153 unsigned int y_res;
154 unsigned int x_traces;
155 unsigned int y_traces;
156 unsigned int width;
157 unsigned int bus;
158 bool paritycheck;
159 bool jumpy_cursor;
160 bool reports_pressure;
161 bool crc_enabled;
162 bool set_hw_resolution;
163 bool has_trackpoint;
164 bool has_middle_button;
165 int (*send_cmd)(struct psmouse *psmouse, unsigned char c,
166 unsigned char *param);
167};
168
169struct elantech_data {
170 struct input_dev *tp_dev; /* Relative device for trackpoint */
171 char tp_phys[32];
172 unsigned char reg_07;
173 unsigned char reg_10;
174 unsigned char reg_11;
175 unsigned char reg_20;
176 unsigned char reg_21;
177 unsigned char reg_22;
178 unsigned char reg_23;
179 unsigned char reg_24;
180 unsigned char reg_25;
181 unsigned char reg_26;
182 unsigned int single_finger_reports;
183 unsigned int y_max;
184 unsigned int width;
185 struct finger_pos mt[ETP_MAX_FINGERS];
186 unsigned char parity[256];
187 struct elantech_device_info info;
188 void (*original_set_rate)(struct psmouse *psmouse, unsigned int rate);
189};
190
191int elantech_detect(struct psmouse *psmouse, bool set_properties);
192int elantech_init_ps2(struct psmouse *psmouse);
193
194#ifdef CONFIG_MOUSE_PS2_ELANTECH
195int elantech_init(struct psmouse *psmouse);
196#else
197static inline int elantech_init(struct psmouse *psmouse)
198{
199 return -ENOSYS;
200}
201#endif /* CONFIG_MOUSE_PS2_ELANTECH */
202
203int elantech_init_smbus(struct psmouse *psmouse);
204
205#endif