blob: 9e5f1aabea7e92c2abc48fe7de380c17279873be [file] [log] [blame]
Arjan Opmeer2a0bd752008-10-16 22:10:19 -04001/*
Arjan Opmeer3f8c0df2009-04-18 19:05:40 -07002 * Elantech Touchpad driver (v6)
Arjan Opmeer2a0bd752008-10-16 22:10:19 -04003 *
Arjan Opmeer3f8c0df2009-04-18 19:05:40 -07004 * Copyright (C) 2007-2009 Arjan Opmeer <arjan@opmeer.net>
Arjan Opmeer2a0bd752008-10-16 22:10:19 -04005 *
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 */
JJ Ding28f49612011-09-09 10:30:31 -070019#define ETP_FW_ID_QUERY 0x00
Arjan Opmeer2a0bd752008-10-16 22:10:19 -040020#define ETP_FW_VERSION_QUERY 0x01
21#define ETP_CAPABILITIES_QUERY 0x02
JJ Ding84a90b62011-09-20 22:42:51 -070022#define ETP_SAMPLE_QUERY 0x03
Arjan Opmeer2a0bd752008-10-16 22:10:19 -040023
24/*
25 * Command values for register reading or writing
26 */
27#define ETP_REGISTER_READ 0x10
28#define ETP_REGISTER_WRITE 0x11
JJ Ding28f49612011-09-09 10:30:31 -070029#define ETP_REGISTER_READWRITE 0x00
Arjan Opmeer2a0bd752008-10-16 22:10:19 -040030
31/*
32 * Hardware version 2 custom PS/2 command value
33 */
34#define ETP_PS2_CUSTOM_COMMAND 0xf8
35
36/*
37 * Times to retry a ps2_command and millisecond delay between tries
38 */
39#define ETP_PS2_COMMAND_TRIES 3
40#define ETP_PS2_COMMAND_DELAY 500
41
42/*
43 * Times to try to read back a register and millisecond delay between tries
44 */
45#define ETP_READ_BACK_TRIES 5
46#define ETP_READ_BACK_DELAY 2000
47
48/*
49 * Register bitmasks for hardware version 1
50 */
51#define ETP_R10_ABSOLUTE_MODE 0x04
52#define ETP_R11_4_BYTE_MODE 0x02
53
54/*
55 * Capability bitmasks
56 */
57#define ETP_CAP_HAS_ROCKER 0x04
58
59/*
60 * One hard to find application note states that X axis range is 0 to 576
61 * and Y axis range is 0 to 384 for harware version 1.
62 * Edge fuzz might be necessary because of bezel around the touchpad
63 */
64#define ETP_EDGE_FUZZ_V1 32
65
66#define ETP_XMIN_V1 ( 0 + ETP_EDGE_FUZZ_V1)
67#define ETP_XMAX_V1 (576 - ETP_EDGE_FUZZ_V1)
68#define ETP_YMIN_V1 ( 0 + ETP_EDGE_FUZZ_V1)
69#define ETP_YMAX_V1 (384 - ETP_EDGE_FUZZ_V1)
70
71/*
JJ Ding8a360d02011-09-09 10:27:42 -070072 * The resolution for older v2 hardware doubled.
73 * (newer v2's firmware provides command so we can query)
Arjan Opmeer2a0bd752008-10-16 22:10:19 -040074 */
JJ Ding8a360d02011-09-09 10:27:42 -070075#define ETP_XMIN_V2 0
76#define ETP_XMAX_V2 1152
77#define ETP_YMIN_V2 0
78#define ETP_YMAX_V2 768
Arjan Opmeer2a0bd752008-10-16 22:10:19 -040079
Éric Pielf941c702011-05-16 22:45:54 -070080#define ETP_PMIN_V2 0
81#define ETP_PMAX_V2 255
82#define ETP_WMIN_V2 0
83#define ETP_WMAX_V2 15
84
JJ Ding28f49612011-09-09 10:30:31 -070085/*
JJ Ding1dc6ede2011-09-09 10:31:58 -070086 * v3 hardware has 2 kinds of packet types,
87 * v4 hardware has 3.
JJ Ding28f49612011-09-09 10:30:31 -070088 */
89#define PACKET_UNKNOWN 0x01
90#define PACKET_DEBOUNCE 0x02
91#define PACKET_V3_HEAD 0x03
92#define PACKET_V3_TAIL 0x04
JJ Ding1dc6ede2011-09-09 10:31:58 -070093#define PACKET_V4_HEAD 0x05
94#define PACKET_V4_MOTION 0x06
95#define PACKET_V4_STATUS 0x07
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 * The base position for one finger, v4 hardware
109 */
110struct finger_pos {
111 unsigned int x;
112 unsigned int y;
113};
JJ Ding28f49612011-09-09 10:30:31 -0700114
Arjan Opmeer2a0bd752008-10-16 22:10:19 -0400115struct elantech_data {
JJ Ding1dc6ede2011-09-09 10:31:58 -0700116 unsigned char reg_07;
Arjan Opmeer2a0bd752008-10-16 22:10:19 -0400117 unsigned char reg_10;
118 unsigned char reg_11;
119 unsigned char reg_20;
120 unsigned char reg_21;
121 unsigned char reg_22;
122 unsigned char reg_23;
123 unsigned char reg_24;
124 unsigned char reg_25;
125 unsigned char reg_26;
126 unsigned char debug;
JJ Ding230282a2011-09-09 10:26:16 -0700127 unsigned char capabilities[3];
Éric Piel7f29f172010-08-05 23:51:49 -0700128 bool paritycheck;
129 bool jumpy_cursor;
Éric Pielf941c702011-05-16 22:45:54 -0700130 bool reports_pressure;
Dmitry Torokhov504e8be2010-05-13 00:41:15 -0700131 unsigned char hw_version;
Éric Piel7f29f172010-08-05 23:51:49 -0700132 unsigned int fw_version;
133 unsigned int single_finger_reports;
JJ Ding230282a2011-09-09 10:26:16 -0700134 unsigned int y_max;
JJ Ding1dc6ede2011-09-09 10:31:58 -0700135 unsigned int width;
136 struct finger_pos mt[ETP_MAX_FINGERS];
Arjan Opmeer2a0bd752008-10-16 22:10:19 -0400137 unsigned char parity[256];
138};
139
140#ifdef CONFIG_MOUSE_PS2_ELANTECH
Dmitry Torokhovb7802c52009-09-09 19:13:20 -0700141int elantech_detect(struct psmouse *psmouse, bool set_properties);
Arjan Opmeer2a0bd752008-10-16 22:10:19 -0400142int elantech_init(struct psmouse *psmouse);
143#else
Dmitry Torokhovb7802c52009-09-09 19:13:20 -0700144static inline int elantech_detect(struct psmouse *psmouse, bool set_properties)
Arjan Opmeer2a0bd752008-10-16 22:10:19 -0400145{
146 return -ENOSYS;
147}
148static inline int elantech_init(struct psmouse *psmouse)
149{
150 return -ENOSYS;
151}
152#endif /* CONFIG_MOUSE_PS2_ELANTECH */
153
154#endif