2 * TSC2004/TSC2005 touchscreen driver core
4 * Copyright (C) 2006-2010 Nokia Corporation
5 * Copyright (C) 2015 QWERTY Embedded Design
6 * Copyright (C) 2015 EMAC Inc.
8 * Author: Lauri Leukkunen <lauri.leukkunen@nokia.com>
9 * based on TSC2301 driver by Klaus K. Pedersen <klaus.k.pedersen@nokia.com>
11 * This program is free software; you can redistribute it and/or modify
12 * it under the terms of the GNU General Public License as published by
13 * the Free Software Foundation; either version 2 of the License, or
14 * (at your option) any later version.
16 * This program is distributed in the hope that it will be useful,
17 * but WITHOUT ANY WARRANTY; without even the implied warranty of
18 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
19 * GNU General Public License for more details.
22 #include <linux/kernel.h>
23 #include <linux/module.h>
24 #include <linux/input.h>
25 #include <linux/input/touchscreen.h>
26 #include <linux/interrupt.h>
27 #include <linux/delay.h>
30 #include <linux/spi/tsc2005.h>
31 #include <linux/regulator/consumer.h>
32 #include <linux/regmap.h>
33 #include <linux/gpio/consumer.h>
34 #include "tsc200x-core.h"
37 * The touchscreen interface operates as follows:
39 * 1) Pen is pressed against the touchscreen.
40 * 2) TSC200X performs AD conversion.
41 * 3) After the conversion is done TSC200X drives DAV line down.
42 * 4) GPIO IRQ is received and tsc200x_irq_thread() is scheduled.
43 * 5) tsc200x_irq_thread() queues up a transfer to fetch the x, y, z1, z2
45 * 6) tsc200x_irq_thread() reports coordinates to input layer and sets up
46 * tsc200x_penup_timer() to be called after TSC200X_PENUP_TIME_MS (40ms).
47 * 7) When the penup timer expires, there have not been touch or DAV interrupts
48 * during the last 40ms which means the pen has been lifted.
50 * ESD recovery via a hardware reset is done if the TSC200X doesn't respond
51 * after a configurable period (in ms) of activity. If esd_timeout is 0, the
52 * watchdog is disabled.
55 static const struct regmap_range tsc200x_writable_ranges[] = {
56 regmap_reg_range(TSC200X_REG_AUX_HIGH, TSC200X_REG_CFR2),
59 static const struct regmap_access_table tsc200x_writable_table = {
60 .yes_ranges = tsc200x_writable_ranges,
61 .n_yes_ranges = ARRAY_SIZE(tsc200x_writable_ranges),
64 const struct regmap_config tsc200x_regmap_config = {
69 .read_flag_mask = TSC200X_REG_READ,
70 .write_flag_mask = TSC200X_REG_PND0,
71 .wr_table = &tsc200x_writable_table,
72 .use_single_rw = true,
74 EXPORT_SYMBOL_GPL(tsc200x_regmap_config);
82 #define TSC200X_DATA_REGS 4
86 struct regmap *regmap;
89 struct input_dev *idev;
94 /* raw copy of previous x,y,z */
101 struct timer_list penup_timer;
103 unsigned int esd_timeout;
104 struct delayed_work esd_work;
105 unsigned long last_valid_interrupt;
107 unsigned int x_plate_ohm;
114 struct regulator *vio;
116 struct gpio_desc *reset_gpio;
117 void (*set_reset)(bool enable);
118 int (*tsc200x_cmd)(struct device *dev, u8 cmd);
122 static void tsc200x_update_pen_state(struct tsc200x *ts,
123 int x, int y, int pressure)
126 input_report_abs(ts->idev, ABS_X, x);
127 input_report_abs(ts->idev, ABS_Y, y);
128 input_report_abs(ts->idev, ABS_PRESSURE, pressure);
130 input_report_key(ts->idev, BTN_TOUCH, !!pressure);
134 input_report_abs(ts->idev, ABS_PRESSURE, 0);
136 input_report_key(ts->idev, BTN_TOUCH, 0);
137 ts->pen_down = false;
140 input_sync(ts->idev);
141 dev_dbg(ts->dev, "point(%4d,%4d), pressure (%4d)\n", x, y,
145 static irqreturn_t tsc200x_irq_thread(int irq, void *_ts)
147 struct tsc200x *ts = _ts;
149 unsigned int pressure;
150 struct tsc200x_data tsdata;
153 /* read the coordinates */
154 error = regmap_bulk_read(ts->regmap, TSC200X_REG_X, &tsdata,
159 /* validate position */
160 if (unlikely(tsdata.x > MAX_12BIT || tsdata.y > MAX_12BIT))
163 /* Skip reading if the pressure components are out of range */
164 if (unlikely(tsdata.z1 == 0 || tsdata.z2 > MAX_12BIT))
166 if (unlikely(tsdata.z1 >= tsdata.z2))
170 * Skip point if this is a pen down with the exact same values as
171 * the value before pen-up - that implies SPI fed us stale data
174 ts->in_x == tsdata.x && ts->in_y == tsdata.y &&
175 ts->in_z1 == tsdata.z1 && ts->in_z2 == tsdata.z2) {
180 * At this point we are happy we have a valid and useful reading.
181 * Remember it for later comparisons. We may now begin downsampling.
185 ts->in_z1 = tsdata.z1;
186 ts->in_z2 = tsdata.z2;
188 /* Compute touch pressure resistance using equation #1 */
189 pressure = tsdata.x * (tsdata.z2 - tsdata.z1) / tsdata.z1;
190 pressure = pressure * ts->x_plate_ohm / 4096;
191 if (unlikely(pressure > MAX_12BIT))
194 spin_lock_irqsave(&ts->lock, flags);
196 tsc200x_update_pen_state(ts, tsdata.x, tsdata.y, pressure);
197 mod_timer(&ts->penup_timer,
198 jiffies + msecs_to_jiffies(TSC200X_PENUP_TIME_MS));
200 spin_unlock_irqrestore(&ts->lock, flags);
202 ts->last_valid_interrupt = jiffies;
207 static void tsc200x_penup_timer(unsigned long data)
209 struct tsc200x *ts = (struct tsc200x *)data;
212 spin_lock_irqsave(&ts->lock, flags);
213 tsc200x_update_pen_state(ts, 0, 0, 0);
214 spin_unlock_irqrestore(&ts->lock, flags);
217 static void tsc200x_start_scan(struct tsc200x *ts)
219 regmap_write(ts->regmap, TSC200X_REG_CFR0, TSC200X_CFR0_INITVALUE);
220 regmap_write(ts->regmap, TSC200X_REG_CFR1, TSC200X_CFR1_INITVALUE);
221 regmap_write(ts->regmap, TSC200X_REG_CFR2, TSC200X_CFR2_INITVALUE);
222 ts->tsc200x_cmd(ts->dev, TSC200X_CMD_NORMAL);
225 static void tsc200x_stop_scan(struct tsc200x *ts)
227 ts->tsc200x_cmd(ts->dev, TSC200X_CMD_STOP);
230 static void tsc200x_set_reset(struct tsc200x *ts, bool enable)
233 gpiod_set_value_cansleep(ts->reset_gpio, enable);
234 else if (ts->set_reset)
235 ts->set_reset(enable);
238 /* must be called with ts->mutex held */
239 static void __tsc200x_disable(struct tsc200x *ts)
241 tsc200x_stop_scan(ts);
243 disable_irq(ts->irq);
244 del_timer_sync(&ts->penup_timer);
246 cancel_delayed_work_sync(&ts->esd_work);
251 /* must be called with ts->mutex held */
252 static void __tsc200x_enable(struct tsc200x *ts)
254 tsc200x_start_scan(ts);
256 if (ts->esd_timeout && (ts->set_reset || ts->reset_gpio)) {
257 ts->last_valid_interrupt = jiffies;
258 schedule_delayed_work(&ts->esd_work,
259 round_jiffies_relative(
260 msecs_to_jiffies(ts->esd_timeout)));
264 static ssize_t tsc200x_selftest_show(struct device *dev,
265 struct device_attribute *attr,
268 struct tsc200x *ts = dev_get_drvdata(dev);
269 unsigned int temp_high;
270 unsigned int temp_high_orig;
271 unsigned int temp_high_test;
275 mutex_lock(&ts->mutex);
278 * Test TSC200X communications via temp high register.
280 __tsc200x_disable(ts);
282 error = regmap_read(ts->regmap, TSC200X_REG_TEMP_HIGH, &temp_high_orig);
284 dev_warn(dev, "selftest failed: read error %d\n", error);
289 temp_high_test = (temp_high_orig - 1) & MAX_12BIT;
291 error = regmap_write(ts->regmap, TSC200X_REG_TEMP_HIGH, temp_high_test);
293 dev_warn(dev, "selftest failed: write error %d\n", error);
298 error = regmap_read(ts->regmap, TSC200X_REG_TEMP_HIGH, &temp_high);
300 dev_warn(dev, "selftest failed: read error %d after write\n",
306 if (temp_high != temp_high_test) {
307 dev_warn(dev, "selftest failed: %d != %d\n",
308 temp_high, temp_high_test);
313 tsc200x_set_reset(ts, false);
314 usleep_range(100, 500); /* only 10us required */
315 tsc200x_set_reset(ts, true);
320 /* test that the reset really happened */
321 error = regmap_read(ts->regmap, TSC200X_REG_TEMP_HIGH, &temp_high);
323 dev_warn(dev, "selftest failed: read error %d after reset\n",
329 if (temp_high != temp_high_orig) {
330 dev_warn(dev, "selftest failed after reset: %d != %d\n",
331 temp_high, temp_high_orig);
336 __tsc200x_enable(ts);
337 mutex_unlock(&ts->mutex);
339 return sprintf(buf, "%d\n", success);
342 static DEVICE_ATTR(selftest, S_IRUGO, tsc200x_selftest_show, NULL);
344 static struct attribute *tsc200x_attrs[] = {
345 &dev_attr_selftest.attr,
349 static umode_t tsc200x_attr_is_visible(struct kobject *kobj,
350 struct attribute *attr, int n)
352 struct device *dev = container_of(kobj, struct device, kobj);
353 struct tsc200x *ts = dev_get_drvdata(dev);
354 umode_t mode = attr->mode;
356 if (attr == &dev_attr_selftest.attr) {
357 if (!ts->set_reset && !ts->reset_gpio)
364 static const struct attribute_group tsc200x_attr_group = {
365 .is_visible = tsc200x_attr_is_visible,
366 .attrs = tsc200x_attrs,
369 static void tsc200x_esd_work(struct work_struct *work)
371 struct tsc200x *ts = container_of(work, struct tsc200x, esd_work.work);
375 if (!mutex_trylock(&ts->mutex)) {
377 * If the mutex is taken, it means that disable or enable is in
378 * progress. In that case just reschedule the work. If the work
379 * is not needed, it will be canceled by disable.
384 if (time_is_after_jiffies(ts->last_valid_interrupt +
385 msecs_to_jiffies(ts->esd_timeout)))
388 /* We should be able to read register without disabling interrupts. */
389 error = regmap_read(ts->regmap, TSC200X_REG_CFR0, &r);
391 !((r ^ TSC200X_CFR0_INITVALUE) & TSC200X_CFR0_RW_MASK)) {
396 * If we could not read our known value from configuration register 0
397 * then we should reset the controller as if from power-up and start
400 dev_info(ts->dev, "TSC200X not responding - resetting\n");
402 disable_irq(ts->irq);
403 del_timer_sync(&ts->penup_timer);
405 tsc200x_update_pen_state(ts, 0, 0, 0);
407 tsc200x_set_reset(ts, false);
408 usleep_range(100, 500); /* only 10us required */
409 tsc200x_set_reset(ts, true);
412 tsc200x_start_scan(ts);
415 mutex_unlock(&ts->mutex);
417 /* re-arm the watchdog */
418 schedule_delayed_work(&ts->esd_work,
419 round_jiffies_relative(
420 msecs_to_jiffies(ts->esd_timeout)));
423 static int tsc200x_open(struct input_dev *input)
425 struct tsc200x *ts = input_get_drvdata(input);
427 mutex_lock(&ts->mutex);
430 __tsc200x_enable(ts);
434 mutex_unlock(&ts->mutex);
439 static void tsc200x_close(struct input_dev *input)
441 struct tsc200x *ts = input_get_drvdata(input);
443 mutex_lock(&ts->mutex);
446 __tsc200x_disable(ts);
450 mutex_unlock(&ts->mutex);
453 int tsc200x_probe(struct device *dev, int irq, const struct input_id *tsc_id,
454 struct regmap *regmap,
455 int (*tsc200x_cmd)(struct device *dev, u8 cmd))
457 const struct tsc2005_platform_data *pdata = dev_get_platdata(dev);
458 struct device_node *np = dev->of_node;
461 struct input_dev *input_dev;
462 unsigned int max_x = MAX_12BIT;
463 unsigned int max_y = MAX_12BIT;
464 unsigned int max_p = MAX_12BIT;
465 unsigned int fudge_x = TSC200X_DEF_X_FUZZ;
466 unsigned int fudge_y = TSC200X_DEF_Y_FUZZ;
467 unsigned int fudge_p = TSC200X_DEF_P_FUZZ;
468 unsigned int x_plate_ohm = TSC200X_DEF_RESISTOR;
469 unsigned int esd_timeout;
473 dev_err(dev, "no platform data\n");
478 dev_err(dev, "no irq\n");
483 return PTR_ERR(regmap);
486 dev_err(dev, "no cmd function\n");
491 fudge_x = pdata->ts_x_fudge;
492 fudge_y = pdata->ts_y_fudge;
493 fudge_p = pdata->ts_pressure_fudge;
494 max_x = pdata->ts_x_max;
495 max_y = pdata->ts_y_max;
496 max_p = pdata->ts_pressure_max;
497 x_plate_ohm = pdata->ts_x_plate_ohm;
498 esd_timeout = pdata->esd_timeout_ms;
500 x_plate_ohm = TSC200X_DEF_RESISTOR;
501 of_property_read_u32(np, "ti,x-plate-ohms", &x_plate_ohm);
503 of_property_read_u32(np, "ti,esd-recovery-timeout-ms",
507 ts = devm_kzalloc(dev, sizeof(*ts), GFP_KERNEL);
511 input_dev = devm_input_allocate_device(dev);
517 ts->idev = input_dev;
519 ts->tsc200x_cmd = tsc200x_cmd;
520 ts->x_plate_ohm = x_plate_ohm;
521 ts->esd_timeout = esd_timeout;
523 ts->reset_gpio = devm_gpiod_get_optional(dev, "reset", GPIOD_OUT_HIGH);
524 if (IS_ERR(ts->reset_gpio)) {
525 error = PTR_ERR(ts->reset_gpio);
526 dev_err(dev, "error acquiring reset gpio: %d\n", error);
530 ts->vio = devm_regulator_get_optional(dev, "vio");
531 if (IS_ERR(ts->vio)) {
532 error = PTR_ERR(ts->vio);
533 dev_err(dev, "vio regulator missing (%d)", error);
537 if (!ts->reset_gpio && pdata)
538 ts->set_reset = pdata->set_reset;
540 mutex_init(&ts->mutex);
542 spin_lock_init(&ts->lock);
543 setup_timer(&ts->penup_timer, tsc200x_penup_timer, (unsigned long)ts);
545 INIT_DELAYED_WORK(&ts->esd_work, tsc200x_esd_work);
547 snprintf(ts->phys, sizeof(ts->phys),
548 "%s/input-ts", dev_name(dev));
550 if (tsc_id->product == 2004) {
551 input_dev->name = "TSC200X touchscreen";
553 input_dev->name = devm_kasprintf(dev, GFP_KERNEL,
554 "TSC%04d touchscreen",
556 if (!input_dev->name)
560 input_dev->phys = ts->phys;
561 input_dev->id = *tsc_id;
562 input_dev->dev.parent = dev;
563 input_dev->evbit[0] = BIT(EV_ABS) | BIT(EV_KEY);
564 input_dev->keybit[BIT_WORD(BTN_TOUCH)] = BIT_MASK(BTN_TOUCH);
566 input_set_abs_params(input_dev, ABS_X, 0, max_x, fudge_x, 0);
567 input_set_abs_params(input_dev, ABS_Y, 0, max_y, fudge_y, 0);
568 input_set_abs_params(input_dev, ABS_PRESSURE, 0, max_p, fudge_p, 0);
571 touchscreen_parse_properties(input_dev, false, NULL);
573 input_dev->open = tsc200x_open;
574 input_dev->close = tsc200x_close;
576 input_set_drvdata(input_dev, ts);
578 /* Ensure the touchscreen is off */
579 tsc200x_stop_scan(ts);
581 error = devm_request_threaded_irq(dev, irq, NULL,
583 IRQF_TRIGGER_RISING | IRQF_ONESHOT,
586 dev_err(dev, "Failed to request irq, err: %d\n", error);
590 /* enable regulator for DT */
592 error = regulator_enable(ts->vio);
597 dev_set_drvdata(dev, ts);
598 error = sysfs_create_group(&dev->kobj, &tsc200x_attr_group);
601 "Failed to create sysfs attributes, err: %d\n", error);
602 goto disable_regulator;
605 error = input_register_device(ts->idev);
608 "Failed to register input device, err: %d\n", error);
609 goto err_remove_sysfs;
612 irq_set_irq_wake(irq, 1);
616 sysfs_remove_group(&dev->kobj, &tsc200x_attr_group);
619 regulator_disable(ts->vio);
622 EXPORT_SYMBOL_GPL(tsc200x_probe);
624 int tsc200x_remove(struct device *dev)
626 struct tsc200x *ts = dev_get_drvdata(dev);
628 sysfs_remove_group(&dev->kobj, &tsc200x_attr_group);
631 regulator_disable(ts->vio);
635 EXPORT_SYMBOL_GPL(tsc200x_remove);
637 static int __maybe_unused tsc200x_suspend(struct device *dev)
639 struct tsc200x *ts = dev_get_drvdata(dev);
641 mutex_lock(&ts->mutex);
643 if (!ts->suspended && ts->opened)
644 __tsc200x_disable(ts);
646 ts->suspended = true;
648 mutex_unlock(&ts->mutex);
653 static int __maybe_unused tsc200x_resume(struct device *dev)
655 struct tsc200x *ts = dev_get_drvdata(dev);
657 mutex_lock(&ts->mutex);
659 if (ts->suspended && ts->opened)
660 __tsc200x_enable(ts);
662 ts->suspended = false;
664 mutex_unlock(&ts->mutex);
669 SIMPLE_DEV_PM_OPS(tsc200x_pm_ops, tsc200x_suspend, tsc200x_resume);
670 EXPORT_SYMBOL_GPL(tsc200x_pm_ops);
672 MODULE_AUTHOR("Lauri Leukkunen <lauri.leukkunen@nokia.com>");
673 MODULE_DESCRIPTION("TSC200x Touchscreen Driver Core");
674 MODULE_LICENSE("GPL");