1 // SPDX-License-Identifier: GPL-2.0-only
2 /*
3 * Atmel Atmegaxx Capacitive Touch Button Driver
4 *
5 * Copyright (C) 2016 Google, inc.
6 */
7
8 /*
9 * It's irrelevant that the HW used to develop captouch driver is based
10 * on Atmega88PA part and uses QtouchADC parts for sensing touch.
11 * Calling this driver "captouch" is an arbitrary way to distinguish
12 * the protocol this driver supported by other atmel/qtouch drivers.
13 *
14 * Captouch driver supports a newer/different version of the I2C
15 * registers/commands than the qt1070.c driver.
16 * Don't let the similarity of the general driver structure fool you.
17 *
18 * For raw i2c access from userspace, use i2cset/i2cget
19 * to poke at /dev/i2c-N devices.
20 */
21
22 #include <linux/device.h>
23 #include <linux/kernel.h>
24 #include <linux/module.h>
25 #include <linux/init.h>
26 #include <linux/i2c.h>
27 #include <linux/input.h>
28 #include <linux/interrupt.h>
29 #include <linux/slab.h>
30
31 /* Maximum number of buttons supported */
32 #define MAX_NUM_OF_BUTTONS 8
33
34 /* Registers */
35 #define REG_KEY1_THRESHOLD 0x02
36 #define REG_KEY2_THRESHOLD 0x03
37 #define REG_KEY3_THRESHOLD 0x04
38 #define REG_KEY4_THRESHOLD 0x05
39
40 #define REG_KEY1_REF_H 0x20
41 #define REG_KEY1_REF_L 0x21
42 #define REG_KEY2_REF_H 0x22
43 #define REG_KEY2_REF_L 0x23
44 #define REG_KEY3_REF_H 0x24
45 #define REG_KEY3_REF_L 0x25
46 #define REG_KEY4_REF_H 0x26
47 #define REG_KEY4_REF_L 0x27
48
49 #define REG_KEY1_DLT_H 0x30
50 #define REG_KEY1_DLT_L 0x31
51 #define REG_KEY2_DLT_H 0x32
52 #define REG_KEY2_DLT_L 0x33
53 #define REG_KEY3_DLT_H 0x34
54 #define REG_KEY3_DLT_L 0x35
55 #define REG_KEY4_DLT_H 0x36
56 #define REG_KEY4_DLT_L 0x37
57
58 #define REG_KEY_STATE 0x3C
59
60 /*
61 * @i2c_client: I2C slave device client pointer
62 * @input: Input device pointer
63 * @num_btn: Number of buttons
64 * @keycodes: map of button# to KeyCode
65 * @prev_btn: Previous key state to detect button "press" or "release"
66 * @xfer_buf: I2C transfer buffer
67 */
68 struct atmel_captouch_device {
69 struct i2c_client *client;
70 struct input_dev *input;
71 u32 num_btn;
72 u32 keycodes[MAX_NUM_OF_BUTTONS];
73 u8 prev_btn;
74 u8 xfer_buf[8] ____cacheline_aligned;
75 };
76
77 /*
78 * Read from I2C slave device
79 * The protocol is that the client has to provide both the register address
80 * and the length, and while reading back the device would prepend the data
81 * with address and length for verification.
82 */
atmel_read(struct atmel_captouch_device * capdev,u8 reg,u8 * data,size_t len)83 static int atmel_read(struct atmel_captouch_device *capdev,
84 u8 reg, u8 *data, size_t len)
85 {
86 struct i2c_client *client = capdev->client;
87 struct device *dev = &client->dev;
88 struct i2c_msg msg[2];
89 int err;
90
91 if (len > sizeof(capdev->xfer_buf) - 2)
92 return -EINVAL;
93
94 capdev->xfer_buf[0] = reg;
95 capdev->xfer_buf[1] = len;
96
97 msg[0].addr = client->addr;
98 msg[0].flags = 0;
99 msg[0].buf = capdev->xfer_buf;
100 msg[0].len = 2;
101
102 msg[1].addr = client->addr;
103 msg[1].flags = I2C_M_RD;
104 msg[1].buf = capdev->xfer_buf;
105 msg[1].len = len + 2;
106
107 err = i2c_transfer(client->adapter, msg, ARRAY_SIZE(msg));
108 if (err != ARRAY_SIZE(msg))
109 return err < 0 ? err : -EIO;
110
111 if (capdev->xfer_buf[0] != reg) {
112 dev_err(dev,
113 "I2C read error: register address does not match (%#02x vs %02x)\n",
114 capdev->xfer_buf[0], reg);
115 return -ECOMM;
116 }
117
118 memcpy(data, &capdev->xfer_buf[2], len);
119
120 return 0;
121 }
122
123 /*
124 * Handle interrupt and report the key changes to the input system.
125 * Multi-touch can be supported; however, it really depends on whether
126 * the device can multi-touch.
127 */
atmel_captouch_isr(int irq,void * data)128 static irqreturn_t atmel_captouch_isr(int irq, void *data)
129 {
130 struct atmel_captouch_device *capdev = data;
131 struct device *dev = &capdev->client->dev;
132 int error;
133 int i;
134 u8 new_btn;
135 u8 changed_btn;
136
137 error = atmel_read(capdev, REG_KEY_STATE, &new_btn, 1);
138 if (error) {
139 dev_err(dev, "failed to read button state: %d\n", error);
140 goto out;
141 }
142
143 dev_dbg(dev, "%s: button state %#02x\n", __func__, new_btn);
144
145 changed_btn = new_btn ^ capdev->prev_btn;
146 capdev->prev_btn = new_btn;
147
148 for (i = 0; i < capdev->num_btn; i++) {
149 if (changed_btn & BIT(i))
150 input_report_key(capdev->input,
151 capdev->keycodes[i],
152 new_btn & BIT(i));
153 }
154
155 input_sync(capdev->input);
156
157 out:
158 return IRQ_HANDLED;
159 }
160
161 /*
162 * Probe function to setup the device, input system and interrupt
163 */
atmel_captouch_probe(struct i2c_client * client,const struct i2c_device_id * id)164 static int atmel_captouch_probe(struct i2c_client *client,
165 const struct i2c_device_id *id)
166 {
167 struct atmel_captouch_device *capdev;
168 struct device *dev = &client->dev;
169 struct device_node *node;
170 int i;
171 int err;
172
173 if (!i2c_check_functionality(client->adapter,
174 I2C_FUNC_SMBUS_BYTE_DATA |
175 I2C_FUNC_SMBUS_WORD_DATA |
176 I2C_FUNC_SMBUS_I2C_BLOCK)) {
177 dev_err(dev, "needed i2c functionality is not supported\n");
178 return -EINVAL;
179 }
180
181 capdev = devm_kzalloc(dev, sizeof(*capdev), GFP_KERNEL);
182 if (!capdev)
183 return -ENOMEM;
184
185 capdev->client = client;
186
187 err = atmel_read(capdev, REG_KEY_STATE,
188 &capdev->prev_btn, sizeof(capdev->prev_btn));
189 if (err) {
190 dev_err(dev, "failed to read initial button state: %d\n", err);
191 return err;
192 }
193
194 capdev->input = devm_input_allocate_device(dev);
195 if (!capdev->input) {
196 dev_err(dev, "failed to allocate input device\n");
197 return -ENOMEM;
198 }
199
200 capdev->input->id.bustype = BUS_I2C;
201 capdev->input->id.product = 0x880A;
202 capdev->input->id.version = 0;
203 capdev->input->name = "ATMegaXX Capacitive Button Controller";
204 __set_bit(EV_KEY, capdev->input->evbit);
205
206 node = dev->of_node;
207 if (!node) {
208 dev_err(dev, "failed to find matching node in device tree\n");
209 return -EINVAL;
210 }
211
212 if (of_property_read_bool(node, "autorepeat"))
213 __set_bit(EV_REP, capdev->input->evbit);
214
215 capdev->num_btn = of_property_count_u32_elems(node, "linux,keymap");
216 if (capdev->num_btn > MAX_NUM_OF_BUTTONS)
217 capdev->num_btn = MAX_NUM_OF_BUTTONS;
218
219 err = of_property_read_u32_array(node, "linux,keycodes",
220 capdev->keycodes,
221 capdev->num_btn);
222 if (err) {
223 dev_err(dev,
224 "failed to read linux,keycode property: %d\n", err);
225 return err;
226 }
227
228 for (i = 0; i < capdev->num_btn; i++)
229 __set_bit(capdev->keycodes[i], capdev->input->keybit);
230
231 capdev->input->keycode = capdev->keycodes;
232 capdev->input->keycodesize = sizeof(capdev->keycodes[0]);
233 capdev->input->keycodemax = capdev->num_btn;
234
235 err = input_register_device(capdev->input);
236 if (err)
237 return err;
238
239 err = devm_request_threaded_irq(dev, client->irq,
240 NULL, atmel_captouch_isr,
241 IRQF_ONESHOT,
242 "atmel_captouch", capdev);
243 if (err) {
244 dev_err(dev, "failed to request irq %d: %d\n",
245 client->irq, err);
246 return err;
247 }
248
249 return 0;
250 }
251
252 #ifdef CONFIG_OF
253 static const struct of_device_id atmel_captouch_of_id[] = {
254 {
255 .compatible = "atmel,captouch",
256 },
257 { /* sentinel */ }
258 };
259 MODULE_DEVICE_TABLE(of, atmel_captouch_of_id);
260 #endif
261
262 static const struct i2c_device_id atmel_captouch_id[] = {
263 { "atmel_captouch", 0 },
264 { }
265 };
266 MODULE_DEVICE_TABLE(i2c, atmel_captouch_id);
267
268 static struct i2c_driver atmel_captouch_driver = {
269 .probe = atmel_captouch_probe,
270 .id_table = atmel_captouch_id,
271 .driver = {
272 .name = "atmel_captouch",
273 .of_match_table = of_match_ptr(atmel_captouch_of_id),
274 },
275 };
276 module_i2c_driver(atmel_captouch_driver);
277
278 /* Module information */
279 MODULE_AUTHOR("Hung-yu Wu <hywu@google.com>");
280 MODULE_DESCRIPTION("Atmel ATmegaXX Capacitance Touch Sensor I2C Driver");
281 MODULE_LICENSE("GPL v2");
282