1 /*        $NetBSD: synapticsreg.h,v 1.14 2024/11/10 11:49:19 mlelstv Exp $      */
2 
3 /*
4  * Copyright (c) 2005, Steve C. Woodford
5  * Copyright (c) 2004, Ales Krenek
6  * Copyright (c) 2004, Kentaro A. Kurahone
7  * All rights reserved.
8  *
9  * Redistribution and use in source and binary forms, with or without
10  * modification, are permitted provided that the following conditions
11  * are met:
12  *
13  *   * Redistributions of source code must retain the above copyright
14  *     notice, this list of conditions and the following disclaimer.
15  *   * Redistributions in binary form must reproduce the above
16  *     copyright notice, this list of conditions and the following
17  *     disclaimer in the documentation and/or other materials provided
18  *     with the distribution.
19  *   * Neither the name of the Kentaro A. Kurahone nor the names of its
20  *     contributors may be used to endorse or promote products derived
21  *     from this software without specific prior written permission.
22  *
23  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
24  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
25  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
26  * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
27  * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
28  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
29  * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
30  * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
31  * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
32  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
33  * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
34  * POSSIBILITY OF SUCH DAMAGE.
35  *
36  */
37 
38 #ifndef   _DEV_PCKBCPORT_SYNAPTICSREG_H_
39 #define   _DEV_PCKBCPORT_SYNAPTICSREG_H_
40 
41 /* Synaptics information queries. */
42 #define   SYNAPTICS_IDENTIFY_TOUCHPAD   0x0
43 #define   SYNAPTICS_READ_MODE           0x1
44 #define   SYNAPTICS_READ_CAPABILITIES   0x2
45 #define   SYNAPTICS_READ_MODEL_ID                 0x3
46 #define   SYNAPTICS_QUERY_RESOLUTION    0x8
47 #define   SYNAPTICS_EXTENDED_QUERY      0x9
48 #define   SYNAPTICS_CONTINUED_CAPABILITIES 0x0c
49 #define   SYNAPTICS_READ_MAX_COORDS     0x0d
50 #define   SYNAPTICS_READ_MIN_COORDS     0x0f
51 #define   SYNAPTICS_WRITE_DELUXE_3      0xc8 /* 6.2.3. Deluxe mode setting sequence */
52 
53 /* Synaptics special commands */
54 #define   SYNAPTICS_CMD_SET_MODE2                 0x14
55 #define   SYNAPTICS_CMD_CLIENT_CMD      0x28
56 
57 /* Magic numbers. */
58 #define   SYNAPTICS_MIN_VERSION                   45 /* 4.5 */
59 #define   SYNAPTICS_MAGIC_BYTE                    0x47
60 
61 /* Capability bits. */
62 /* (byte[0] << 8) | byte[2] */
63 /* Submodel ID: byte[1] */
64 #define SYNAPTICS_CAP_VALUE(b)          (((b)[0] << 8) | (b)[2])
65 #define SYNAPTICS_CAP_SUBMODEL(b)       ((b)[1])
66 #define   SYNAPTICS_CAP_EXTENDED                  (1 << 15)
67 #define   SYNAPTICS_CAP_EXTNUM                    (1 << 14 | 1 << 13 | 1 << 12)
68 #define   SYNAPTICS_CAP_MBUTTON                   (1 << 10)
69 #define   SYNAPTICS_CAP_PASSTHROUGH     (1 << 7)
70 #define   SYNAPTICS_CAP_LOWPOWER                  (1 << 6)
71 #define   SYNAPTICS_CAP_MULTIFINGERREPORT (1 << 5)
72 #define   SYNAPTICS_CAP_SLEEP           (1 << 4)
73 #define   SYNAPTICS_CAP_4BUTTON                   (1 << 3)
74 #define   SYNAPTICS_CAP_MULTIDETECT     (1 << 1)
75 #define   SYNAPTICS_CAP_PALMDETECT      (1 << 0)
76 
77 /* Continued Capability bits */
78 /* (byte[0] << 8) | byte[1] */
79 #define SYN_CCAP_VALUE(b)     (((b)[0] << 8) | (b)[1])
80 #define SYN_CCAP_COVERED_PAD            __BIT(15)
81 #define SYN_CCAP_MULTIFINGER_MODE       __BITS(13,14)
82 #define SYN_CCAP_CLICKPAD_BIT_0                   __BIT(12) /* one-button clickpad */
83 #define SYN_CCAP_HAS_ADV_GESTURE_MODE   __BIT(11)
84 #define SYN_CCAP_CLEARPAD               __BIT(10)
85 #define SYN_CCAP_REPORT_MAX             __BIT(9)
86 #define SYN_CCAP_ADJ_THRESHOLD                    __BIT(8)
87 #define SYN_CCAP_REPORT_MIN             __BIT(5)
88 #define SYN_CCAP_UNIFORM_CLICKPAD       __BIT(4)
89 #define SYN_CCAP_IMAGE_SENSOR           __BIT(3)  /* reports V */
90 #define SYN_CCAP_REDUCED_FILTERING      __BIT(2)
91 #define SYN_CCAP_DELUX_LED_CONTROLS     __BIT(1)
92 #define SYN_CCAP_CLICKPAD_BIT_1                   __BIT(0)  /* two-button clickpad */
93 #define SYN_CCAP_CLICKPAD_TYPE(v)       \
94           ((__SHIFTOUT((v), SYN_CCAP_CLICKPAD_BIT_1) << 1) | \
95             __SHIFTOUT((v), SYN_CCAP_CLICKPAD_BIT_0))
96 
97 /* Mode bits. */
98 #define   SYNAPTICS_MODE_ABSOLUTE                 (1 << 7)
99 #define   SYNAPTICS_MODE_RATE           (1 << 6)
100 #define   SYNAPTICS_MODE_SLEEP                    (1 << 3)
101 #define   SYNAPTICS_MODE_EXTENDED_W     (1 << 2) /* double meaning */
102 #define   SYNAPTICS_MODE_GEST           (1 << 2)
103 #define   SYNAPTICS_MODE_4BYTE_CLIENT   (1 << 1)
104 #define   SYNAPTICS_MODE_W              (1 << 0)
105 
106 /* Extended mode button masks. */
107 #define   SYN_1BUTMASK                            0x1
108 #define   SYN_2BUTMASK                            0x1
109 #define   SYN_3BUTMASK                            0x2
110 #define   SYN_4BUTMASK                            0x2
111 #define   SYN_5BUTMASK                            0x4
112 #define   SYN_6BUTMASK                            0x4
113 #define   SYN_7BUTMASK                            0x8
114 #define   SYN_8BUTMASK                            0x8
115 
116 /* Touchpad edge boundaries (Recommended values from Synaptics documentation) */
117 #define   SYNAPTICS_EDGE_LEFT           1632
118 #define   SYNAPTICS_EDGE_RIGHT                    5312
119 #define   SYNAPTICS_EDGE_TOP            4288
120 #define   SYNAPTICS_EDGE_BOTTOM                   1568
121 #define   SYNAPTICS_EDGE_MAX            6143
122 
123 /* Finger pressures */
124 #define   SYNAPTICS_FINGER_NONE                   0
125 #define   SYNAPTICS_FINGER_HOVER                  10
126 #define   SYNAPTICS_FINGER_LIGHT                  30
127 #define   SYNAPTICS_FINGER_NORMAL                 80
128 #define   SYNAPTICS_FINGER_HEAVY                  110
129 #define   SYNAPTICS_FINGER_FLAT                   200
130 #define   SYNAPTICS_FINGER_PALM                   255
131 
132 /* Width values */
133 #define   SYNAPTICS_WIDTH_TWO_FINGERS   0
134 #define   SYNAPTICS_WIDTH_THREE_OR_MORE 1
135 #define   SYNAPTICS_WIDTH_PEN           2
136 #define   SYNAPTICS_WIDTH_EXTENDED_W    2
137 #define   SYNAPTICS_WIDTH_ADVANCEDGESTURE         2
138 #define   SYNAPTICS_WIDTH_PASSTHROUGH   3
139 #define   SYNAPTICS_WIDTH_FINGER_MIN    4
140 #define   SYNAPTICS_WIDTH_FINGER_NORMAL 5
141 #define   SYNAPTICS_WIDTH_FINGER_MAX    7
142 #define   SYNAPTICS_WIDTH_PALM_MIN      8
143 #define   SYNAPTICS_WIDTH_PALM_MAX      14
144 #define   SYNAPTICS_WIDTH_MAX           15
145 
146 /* Extended W types */
147 #define SYNAPTICS_EW_WHEEL              0
148 #define SYNAPTICS_EW_SECONDARY_FINGER   1
149 #define SYNAPTICS_EW_FINGER_STATUS      2
150 
151 #endif    /* _DEV_PCKBCPORT_SYNAPTICSREG_H_ */
152