1 // SPDX-License-Identifier: GPL-2.0
3 * Copyright (C) 2012 Simon Budig, <simon.budig@kernelconcepts.de>
4 * Daniel Wagener <daniel.wagener@kernelconcepts.de> (M09 firmware support)
5 * Lothar Waßmann <LW@KARO-electronics.de> (DT support)
9 * This is a driver for the EDT "Polytouch" family of touch controllers
10 * based on the FocalTech FT5x06 line of chips.
12 * Development of this driver has been sponsored by Glyn:
13 * http://www.glyn.com/Products/Displays
16 #include <linux/debugfs.h>
17 #include <linux/delay.h>
18 #include <linux/gpio/consumer.h>
19 #include <linux/i2c.h>
20 #include <linux/interrupt.h>
21 #include <linux/input.h>
22 #include <linux/input/mt.h>
23 #include <linux/input/touchscreen.h>
24 #include <linux/irq.h>
25 #include <linux/kernel.h>
26 #include <linux/module.h>
27 #include <linux/property.h>
28 #include <linux/ratelimit.h>
29 #include <linux/regulator/consumer.h>
30 #include <linux/slab.h>
31 #include <linux/uaccess.h>
33 #include <asm/unaligned.h>
35 #define WORK_REGISTER_THRESHOLD 0x00
36 #define WORK_REGISTER_REPORT_RATE 0x08
37 #define WORK_REGISTER_GAIN 0x30
38 #define WORK_REGISTER_OFFSET 0x31
39 #define WORK_REGISTER_NUM_X 0x33
40 #define WORK_REGISTER_NUM_Y 0x34
42 #define PMOD_REGISTER_ACTIVE 0x00
43 #define PMOD_REGISTER_HIBERNATE 0x03
45 #define M09_REGISTER_THRESHOLD 0x80
46 #define M09_REGISTER_GAIN 0x92
47 #define M09_REGISTER_OFFSET 0x93
48 #define M09_REGISTER_NUM_X 0x94
49 #define M09_REGISTER_NUM_Y 0x95
51 #define M12_REGISTER_REPORT_RATE 0x88
53 #define EV_REGISTER_THRESHOLD 0x40
54 #define EV_REGISTER_GAIN 0x41
55 #define EV_REGISTER_OFFSET_Y 0x45
56 #define EV_REGISTER_OFFSET_X 0x46
58 #define NO_REGISTER 0xff
60 #define WORK_REGISTER_OPMODE 0x3c
61 #define FACTORY_REGISTER_OPMODE 0x01
62 #define PMOD_REGISTER_OPMODE 0xa5
64 #define TOUCH_EVENT_DOWN 0x00
65 #define TOUCH_EVENT_UP 0x01
66 #define TOUCH_EVENT_ON 0x02
67 #define TOUCH_EVENT_RESERVED 0x03
69 #define EDT_NAME_LEN 23
70 #define EDT_SWITCH_MODE_RETRIES 10
71 #define EDT_SWITCH_MODE_DELAY 5 /* msec */
72 #define EDT_RAW_DATA_RETRIES 100
73 #define EDT_RAW_DATA_DELAY 1000 /* usec */
75 #define EDT_DEFAULT_NUM_X 1024
76 #define EDT_DEFAULT_NUM_Y 1024
79 EDT_PMODE_NOT_SUPPORTED,
103 struct edt_ft5x06_ts_data {
104 struct i2c_client *client;
105 struct input_dev *input;
106 struct touchscreen_properties prop;
109 struct regulator *vcc;
110 struct regulator *iovcc;
112 struct gpio_desc *reset_gpio;
113 struct gpio_desc *wake_gpio;
115 #if defined(CONFIG_DEBUG_FS)
116 struct dentry *debug_dir;
123 enum edt_pmode suspend_mode;
130 int max_support_points;
132 char name[EDT_NAME_LEN];
133 char fw_version[EDT_NAME_LEN];
135 struct edt_reg_addr reg_addr;
136 enum edt_ver version;
137 unsigned int crc_errors;
138 unsigned int header_errors;
141 struct edt_i2c_chip_data {
142 int max_support_points;
145 static int edt_ft5x06_ts_readwrite(struct i2c_client *client,
146 u16 wr_len, u8 *wr_buf,
147 u16 rd_len, u8 *rd_buf)
149 struct i2c_msg wrmsg[2];
154 wrmsg[i].addr = client->addr;
156 wrmsg[i].len = wr_len;
157 wrmsg[i].buf = wr_buf;
161 wrmsg[i].addr = client->addr;
162 wrmsg[i].flags = I2C_M_RD;
163 wrmsg[i].len = rd_len;
164 wrmsg[i].buf = rd_buf;
168 ret = i2c_transfer(client->adapter, wrmsg, i);
177 static bool edt_ft5x06_ts_check_crc(struct edt_ft5x06_ts_data *tsdata,
183 for (i = 0; i < buflen - 1; i++)
186 if (crc != buf[buflen-1]) {
187 tsdata->crc_errors++;
188 dev_err_ratelimited(&tsdata->client->dev,
189 "crc error: 0x%02x expected, got 0x%02x\n",
197 static irqreturn_t edt_ft5x06_ts_isr(int irq, void *dev_id)
199 struct edt_ft5x06_ts_data *tsdata = dev_id;
200 struct device *dev = &tsdata->client->dev;
203 int i, type, x, y, id;
204 int offset, tplen, datalen, crclen;
207 switch (tsdata->version) {
209 cmd = 0xf9; /* tell the controller to send touch data */
210 offset = 5; /* where the actual touch data starts */
211 tplen = 4; /* data comes in so called frames */
212 crclen = 1; /* length of the crc data */
229 memset(rdbuf, 0, sizeof(rdbuf));
230 datalen = tplen * tsdata->max_support_points + offset + crclen;
232 error = edt_ft5x06_ts_readwrite(tsdata->client,
236 dev_err_ratelimited(dev, "Unable to fetch data, error: %d\n",
241 /* M09/M12 does not send header or CRC */
242 if (tsdata->version == EDT_M06) {
243 if (rdbuf[0] != 0xaa || rdbuf[1] != 0xaa ||
244 rdbuf[2] != datalen) {
245 tsdata->header_errors++;
246 dev_err_ratelimited(dev,
247 "Unexpected header: %02x%02x%02x!\n",
248 rdbuf[0], rdbuf[1], rdbuf[2]);
252 if (!edt_ft5x06_ts_check_crc(tsdata, rdbuf, datalen))
256 for (i = 0; i < tsdata->max_support_points; i++) {
257 u8 *buf = &rdbuf[i * tplen + offset];
260 /* ignore Reserved events */
261 if (type == TOUCH_EVENT_RESERVED)
264 /* M06 sometimes sends bogus coordinates in TOUCH_DOWN */
265 if (tsdata->version == EDT_M06 && type == TOUCH_EVENT_DOWN)
268 x = get_unaligned_be16(buf) & 0x0fff;
269 y = get_unaligned_be16(buf + 2) & 0x0fff;
270 /* The FT5x26 send the y coordinate first */
271 if (tsdata->version == EV_FT)
274 id = (buf[2] >> 4) & 0x0f;
276 input_mt_slot(tsdata->input, id);
277 if (input_mt_report_slot_state(tsdata->input, MT_TOOL_FINGER,
278 type != TOUCH_EVENT_UP))
279 touchscreen_report_pos(tsdata->input, &tsdata->prop,
283 input_mt_report_pointer_emulation(tsdata->input, true);
284 input_sync(tsdata->input);
290 static int edt_ft5x06_register_write(struct edt_ft5x06_ts_data *tsdata,
295 switch (tsdata->version) {
297 wrbuf[0] = tsdata->factory_mode ? 0xf3 : 0xfc;
298 wrbuf[1] = tsdata->factory_mode ? addr & 0x7f : addr & 0x3f;
300 wrbuf[3] = wrbuf[0] ^ wrbuf[1] ^ wrbuf[2];
301 return edt_ft5x06_ts_readwrite(tsdata->client, 4,
311 return edt_ft5x06_ts_readwrite(tsdata->client, 2,
319 static int edt_ft5x06_register_read(struct edt_ft5x06_ts_data *tsdata,
322 u8 wrbuf[2], rdbuf[2];
325 switch (tsdata->version) {
327 wrbuf[0] = tsdata->factory_mode ? 0xf3 : 0xfc;
328 wrbuf[1] = tsdata->factory_mode ? addr & 0x7f : addr & 0x3f;
329 wrbuf[1] |= tsdata->factory_mode ? 0x80 : 0x40;
331 error = edt_ft5x06_ts_readwrite(tsdata->client, 2, wrbuf, 2,
336 if ((wrbuf[0] ^ wrbuf[1] ^ rdbuf[0]) != rdbuf[1]) {
337 dev_err(&tsdata->client->dev,
338 "crc error: 0x%02x expected, got 0x%02x\n",
339 wrbuf[0] ^ wrbuf[1] ^ rdbuf[0],
350 error = edt_ft5x06_ts_readwrite(tsdata->client, 1,
363 struct edt_ft5x06_attribute {
364 struct device_attribute dattr;
373 #define EDT_ATTR(_field, _mode, _addr_m06, _addr_m09, _addr_ev, \
374 _limit_low, _limit_high) \
375 struct edt_ft5x06_attribute edt_ft5x06_attr_##_field = { \
376 .dattr = __ATTR(_field, _mode, \
377 edt_ft5x06_setting_show, \
378 edt_ft5x06_setting_store), \
379 .field_offset = offsetof(struct edt_ft5x06_ts_data, _field), \
380 .addr_m06 = _addr_m06, \
381 .addr_m09 = _addr_m09, \
382 .addr_ev = _addr_ev, \
383 .limit_low = _limit_low, \
384 .limit_high = _limit_high, \
387 static ssize_t edt_ft5x06_setting_show(struct device *dev,
388 struct device_attribute *dattr,
391 struct i2c_client *client = to_i2c_client(dev);
392 struct edt_ft5x06_ts_data *tsdata = i2c_get_clientdata(client);
393 struct edt_ft5x06_attribute *attr =
394 container_of(dattr, struct edt_ft5x06_attribute, dattr);
395 u8 *field = (u8 *)tsdata + attr->field_offset;
401 mutex_lock(&tsdata->mutex);
403 if (tsdata->factory_mode) {
408 switch (tsdata->version) {
410 addr = attr->addr_m06;
416 addr = attr->addr_m09;
420 addr = attr->addr_ev;
428 if (addr != NO_REGISTER) {
429 val = edt_ft5x06_register_read(tsdata, addr);
432 dev_err(&tsdata->client->dev,
433 "Failed to fetch attribute %s, error %d\n",
434 dattr->attr.name, error);
442 dev_warn(&tsdata->client->dev,
443 "%s: read (%d) and stored value (%d) differ\n",
444 dattr->attr.name, val, *field);
448 count = scnprintf(buf, PAGE_SIZE, "%d\n", val);
450 mutex_unlock(&tsdata->mutex);
451 return error ?: count;
454 static ssize_t edt_ft5x06_setting_store(struct device *dev,
455 struct device_attribute *dattr,
456 const char *buf, size_t count)
458 struct i2c_client *client = to_i2c_client(dev);
459 struct edt_ft5x06_ts_data *tsdata = i2c_get_clientdata(client);
460 struct edt_ft5x06_attribute *attr =
461 container_of(dattr, struct edt_ft5x06_attribute, dattr);
462 u8 *field = (u8 *)tsdata + attr->field_offset;
467 mutex_lock(&tsdata->mutex);
469 if (tsdata->factory_mode) {
474 error = kstrtouint(buf, 0, &val);
478 if (val < attr->limit_low || val > attr->limit_high) {
483 switch (tsdata->version) {
485 addr = attr->addr_m06;
491 addr = attr->addr_m09;
495 addr = attr->addr_ev;
503 if (addr != NO_REGISTER) {
504 error = edt_ft5x06_register_write(tsdata, addr, val);
506 dev_err(&tsdata->client->dev,
507 "Failed to update attribute %s, error: %d\n",
508 dattr->attr.name, error);
515 mutex_unlock(&tsdata->mutex);
516 return error ?: count;
519 /* m06, m09: range 0-31, m12: range 0-5 */
520 static EDT_ATTR(gain, S_IWUSR | S_IRUGO, WORK_REGISTER_GAIN,
521 M09_REGISTER_GAIN, EV_REGISTER_GAIN, 0, 31);
522 /* m06, m09: range 0-31, m12: range 0-16 */
523 static EDT_ATTR(offset, S_IWUSR | S_IRUGO, WORK_REGISTER_OFFSET,
524 M09_REGISTER_OFFSET, NO_REGISTER, 0, 31);
525 /* m06, m09, m12: no supported, ev_ft: range 0-80 */
526 static EDT_ATTR(offset_x, S_IWUSR | S_IRUGO, NO_REGISTER, NO_REGISTER,
527 EV_REGISTER_OFFSET_X, 0, 80);
528 /* m06, m09, m12: no supported, ev_ft: range 0-80 */
529 static EDT_ATTR(offset_y, S_IWUSR | S_IRUGO, NO_REGISTER, NO_REGISTER,
530 EV_REGISTER_OFFSET_Y, 0, 80);
531 /* m06: range 20 to 80, m09: range 0 to 30, m12: range 1 to 255... */
532 static EDT_ATTR(threshold, S_IWUSR | S_IRUGO, WORK_REGISTER_THRESHOLD,
533 M09_REGISTER_THRESHOLD, EV_REGISTER_THRESHOLD, 0, 255);
534 /* m06: range 3 to 14, m12: range 1 to 255 */
535 static EDT_ATTR(report_rate, S_IWUSR | S_IRUGO, WORK_REGISTER_REPORT_RATE,
536 M12_REGISTER_REPORT_RATE, NO_REGISTER, 0, 255);
538 static ssize_t model_show(struct device *dev, struct device_attribute *attr,
541 struct i2c_client *client = to_i2c_client(dev);
542 struct edt_ft5x06_ts_data *tsdata = i2c_get_clientdata(client);
544 return sysfs_emit(buf, "%s\n", tsdata->name);
547 static DEVICE_ATTR_RO(model);
549 static ssize_t fw_version_show(struct device *dev,
550 struct device_attribute *attr, char *buf)
552 struct i2c_client *client = to_i2c_client(dev);
553 struct edt_ft5x06_ts_data *tsdata = i2c_get_clientdata(client);
555 return sysfs_emit(buf, "%s\n", tsdata->fw_version);
558 static DEVICE_ATTR_RO(fw_version);
561 static ssize_t header_errors_show(struct device *dev,
562 struct device_attribute *attr, char *buf)
564 struct i2c_client *client = to_i2c_client(dev);
565 struct edt_ft5x06_ts_data *tsdata = i2c_get_clientdata(client);
567 return sysfs_emit(buf, "%d\n", tsdata->header_errors);
570 static DEVICE_ATTR_RO(header_errors);
573 static ssize_t crc_errors_show(struct device *dev,
574 struct device_attribute *attr, char *buf)
576 struct i2c_client *client = to_i2c_client(dev);
577 struct edt_ft5x06_ts_data *tsdata = i2c_get_clientdata(client);
579 return sysfs_emit(buf, "%d\n", tsdata->crc_errors);
582 static DEVICE_ATTR_RO(crc_errors);
584 static struct attribute *edt_ft5x06_attrs[] = {
585 &edt_ft5x06_attr_gain.dattr.attr,
586 &edt_ft5x06_attr_offset.dattr.attr,
587 &edt_ft5x06_attr_offset_x.dattr.attr,
588 &edt_ft5x06_attr_offset_y.dattr.attr,
589 &edt_ft5x06_attr_threshold.dattr.attr,
590 &edt_ft5x06_attr_report_rate.dattr.attr,
591 &dev_attr_model.attr,
592 &dev_attr_fw_version.attr,
593 &dev_attr_header_errors.attr,
594 &dev_attr_crc_errors.attr,
598 static const struct attribute_group edt_ft5x06_attr_group = {
599 .attrs = edt_ft5x06_attrs,
602 static void edt_ft5x06_restore_reg_parameters(struct edt_ft5x06_ts_data *tsdata)
604 struct edt_reg_addr *reg_addr = &tsdata->reg_addr;
606 edt_ft5x06_register_write(tsdata, reg_addr->reg_threshold,
608 edt_ft5x06_register_write(tsdata, reg_addr->reg_gain,
610 if (reg_addr->reg_offset != NO_REGISTER)
611 edt_ft5x06_register_write(tsdata, reg_addr->reg_offset,
613 if (reg_addr->reg_offset_x != NO_REGISTER)
614 edt_ft5x06_register_write(tsdata, reg_addr->reg_offset_x,
616 if (reg_addr->reg_offset_y != NO_REGISTER)
617 edt_ft5x06_register_write(tsdata, reg_addr->reg_offset_y,
619 if (reg_addr->reg_report_rate != NO_REGISTER)
620 edt_ft5x06_register_write(tsdata, reg_addr->reg_report_rate,
621 tsdata->report_rate);
625 #ifdef CONFIG_DEBUG_FS
626 static int edt_ft5x06_factory_mode(struct edt_ft5x06_ts_data *tsdata)
628 struct i2c_client *client = tsdata->client;
629 int retries = EDT_SWITCH_MODE_RETRIES;
633 if (tsdata->version != EDT_M06) {
634 dev_err(&client->dev,
635 "No factory mode support for non-M06 devices\n");
639 disable_irq(client->irq);
641 if (!tsdata->raw_buffer) {
642 tsdata->raw_bufsize = tsdata->num_x * tsdata->num_y *
644 tsdata->raw_buffer = kzalloc(tsdata->raw_bufsize, GFP_KERNEL);
645 if (!tsdata->raw_buffer) {
651 /* mode register is 0x3c when in the work mode */
652 error = edt_ft5x06_register_write(tsdata, WORK_REGISTER_OPMODE, 0x03);
654 dev_err(&client->dev,
655 "failed to switch to factory mode, error %d\n", error);
659 tsdata->factory_mode = true;
661 mdelay(EDT_SWITCH_MODE_DELAY);
662 /* mode register is 0x01 when in factory mode */
663 ret = edt_ft5x06_register_read(tsdata, FACTORY_REGISTER_OPMODE);
666 } while (--retries > 0);
669 dev_err(&client->dev, "not in factory mode after %dms.\n",
670 EDT_SWITCH_MODE_RETRIES * EDT_SWITCH_MODE_DELAY);
678 kfree(tsdata->raw_buffer);
679 tsdata->raw_buffer = NULL;
680 tsdata->factory_mode = false;
681 enable_irq(client->irq);
686 static int edt_ft5x06_work_mode(struct edt_ft5x06_ts_data *tsdata)
688 struct i2c_client *client = tsdata->client;
689 int retries = EDT_SWITCH_MODE_RETRIES;
693 /* mode register is 0x01 when in the factory mode */
694 error = edt_ft5x06_register_write(tsdata, FACTORY_REGISTER_OPMODE, 0x1);
696 dev_err(&client->dev,
697 "failed to switch to work mode, error: %d\n", error);
701 tsdata->factory_mode = false;
704 mdelay(EDT_SWITCH_MODE_DELAY);
705 /* mode register is 0x01 when in factory mode */
706 ret = edt_ft5x06_register_read(tsdata, WORK_REGISTER_OPMODE);
709 } while (--retries > 0);
712 dev_err(&client->dev, "not in work mode after %dms.\n",
713 EDT_SWITCH_MODE_RETRIES * EDT_SWITCH_MODE_DELAY);
714 tsdata->factory_mode = true;
718 kfree(tsdata->raw_buffer);
719 tsdata->raw_buffer = NULL;
721 edt_ft5x06_restore_reg_parameters(tsdata);
722 enable_irq(client->irq);
727 static int edt_ft5x06_debugfs_mode_get(void *data, u64 *mode)
729 struct edt_ft5x06_ts_data *tsdata = data;
731 *mode = tsdata->factory_mode;
736 static int edt_ft5x06_debugfs_mode_set(void *data, u64 mode)
738 struct edt_ft5x06_ts_data *tsdata = data;
744 mutex_lock(&tsdata->mutex);
746 if (mode != tsdata->factory_mode) {
747 retval = mode ? edt_ft5x06_factory_mode(tsdata) :
748 edt_ft5x06_work_mode(tsdata);
751 mutex_unlock(&tsdata->mutex);
756 DEFINE_SIMPLE_ATTRIBUTE(debugfs_mode_fops, edt_ft5x06_debugfs_mode_get,
757 edt_ft5x06_debugfs_mode_set, "%llu\n");
759 static ssize_t edt_ft5x06_debugfs_raw_data_read(struct file *file,
760 char __user *buf, size_t count, loff_t *off)
762 struct edt_ft5x06_ts_data *tsdata = file->private_data;
763 struct i2c_client *client = tsdata->client;
764 int retries = EDT_RAW_DATA_RETRIES;
771 if (*off < 0 || *off >= tsdata->raw_bufsize)
774 mutex_lock(&tsdata->mutex);
776 if (!tsdata->factory_mode || !tsdata->raw_buffer) {
781 error = edt_ft5x06_register_write(tsdata, 0x08, 0x01);
783 dev_dbg(&client->dev,
784 "failed to write 0x08 register, error %d\n", error);
789 usleep_range(EDT_RAW_DATA_DELAY, EDT_RAW_DATA_DELAY + 100);
790 val = edt_ft5x06_register_read(tsdata, 0x08);
793 } while (--retries > 0);
797 dev_dbg(&client->dev,
798 "failed to read 0x08 register, error %d\n", error);
803 dev_dbg(&client->dev,
804 "timed out waiting for register to settle\n");
809 rdbuf = tsdata->raw_buffer;
810 colbytes = tsdata->num_y * sizeof(u16);
814 for (i = 0; i < tsdata->num_x; i++) {
815 wrbuf[2] = i; /* column index */
816 error = edt_ft5x06_ts_readwrite(tsdata->client,
817 sizeof(wrbuf), wrbuf,
825 read = min_t(size_t, count, tsdata->raw_bufsize - *off);
826 if (copy_to_user(buf, tsdata->raw_buffer + *off, read)) {
833 mutex_unlock(&tsdata->mutex);
834 return error ?: read;
837 static const struct file_operations debugfs_raw_data_fops = {
839 .read = edt_ft5x06_debugfs_raw_data_read,
842 static void edt_ft5x06_ts_prepare_debugfs(struct edt_ft5x06_ts_data *tsdata,
843 const char *debugfs_name)
845 tsdata->debug_dir = debugfs_create_dir(debugfs_name, NULL);
847 debugfs_create_u16("num_x", S_IRUSR, tsdata->debug_dir, &tsdata->num_x);
848 debugfs_create_u16("num_y", S_IRUSR, tsdata->debug_dir, &tsdata->num_y);
850 debugfs_create_file("mode", S_IRUSR | S_IWUSR,
851 tsdata->debug_dir, tsdata, &debugfs_mode_fops);
852 debugfs_create_file("raw_data", S_IRUSR,
853 tsdata->debug_dir, tsdata, &debugfs_raw_data_fops);
856 static void edt_ft5x06_ts_teardown_debugfs(struct edt_ft5x06_ts_data *tsdata)
858 debugfs_remove_recursive(tsdata->debug_dir);
859 kfree(tsdata->raw_buffer);
864 static int edt_ft5x06_factory_mode(struct edt_ft5x06_ts_data *tsdata)
869 static void edt_ft5x06_ts_prepare_debugfs(struct edt_ft5x06_ts_data *tsdata,
870 const char *debugfs_name)
874 static void edt_ft5x06_ts_teardown_debugfs(struct edt_ft5x06_ts_data *tsdata)
878 #endif /* CONFIG_DEBUGFS */
880 static int edt_ft5x06_ts_identify(struct i2c_client *client,
881 struct edt_ft5x06_ts_data *tsdata)
883 u8 rdbuf[EDT_NAME_LEN];
886 char *model_name = tsdata->name;
887 char *fw_version = tsdata->fw_version;
889 /* see what we find if we assume it is a M06 *
890 * if we get less than EDT_NAME_LEN, we don't want
891 * to have garbage in there
893 memset(rdbuf, 0, sizeof(rdbuf));
894 error = edt_ft5x06_ts_readwrite(client, 1, "\xBB",
895 EDT_NAME_LEN - 1, rdbuf);
899 /* Probe content for something consistent.
900 * M06 starts with a response byte, M12 gives the data directly.
901 * M09/Generic does not provide model number information.
903 if (!strncasecmp(rdbuf + 1, "EP0", 3)) {
904 tsdata->version = EDT_M06;
906 /* remove last '$' end marker */
907 rdbuf[EDT_NAME_LEN - 1] = '\0';
908 if (rdbuf[EDT_NAME_LEN - 2] == '$')
909 rdbuf[EDT_NAME_LEN - 2] = '\0';
911 /* look for Model/Version separator */
912 p = strchr(rdbuf, '*');
915 strscpy(model_name, rdbuf + 1, EDT_NAME_LEN);
916 strscpy(fw_version, p ? p : "", EDT_NAME_LEN);
917 } else if (!strncasecmp(rdbuf, "EP0", 3)) {
918 tsdata->version = EDT_M12;
920 /* remove last '$' end marker */
921 rdbuf[EDT_NAME_LEN - 2] = '\0';
922 if (rdbuf[EDT_NAME_LEN - 3] == '$')
923 rdbuf[EDT_NAME_LEN - 3] = '\0';
925 /* look for Model/Version separator */
926 p = strchr(rdbuf, '*');
929 strscpy(model_name, rdbuf, EDT_NAME_LEN);
930 strscpy(fw_version, p ? p : "", EDT_NAME_LEN);
932 /* If it is not an EDT M06/M12 touchscreen, then the model
933 * detection is a bit hairy. The different ft5x06
934 * firmares around don't reliably implement the
935 * identification registers. Well, we'll take a shot.
937 * The main difference between generic focaltec based
938 * touches and EDT M09 is that we know how to retrieve
939 * the max coordinates for the latter.
941 tsdata->version = GENERIC_FT;
943 error = edt_ft5x06_ts_readwrite(client, 1, "\xA6",
948 strscpy(fw_version, rdbuf, 2);
950 error = edt_ft5x06_ts_readwrite(client, 1, "\xA8",
955 /* This "model identification" is not exact. Unfortunately
956 * not all firmwares for the ft5x06 put useful values in
957 * the identification registers.
960 case 0x11: /* EDT EP0110M09 */
961 case 0x35: /* EDT EP0350M09 */
962 case 0x43: /* EDT EP0430M09 */
963 case 0x50: /* EDT EP0500M09 */
964 case 0x57: /* EDT EP0570M09 */
965 case 0x70: /* EDT EP0700M09 */
966 tsdata->version = EDT_M09;
967 snprintf(model_name, EDT_NAME_LEN, "EP0%i%i0M09",
968 rdbuf[0] >> 4, rdbuf[0] & 0x0F);
970 case 0xa1: /* EDT EP1010ML00 */
971 tsdata->version = EDT_M09;
972 snprintf(model_name, EDT_NAME_LEN, "EP%i%i0ML00",
973 rdbuf[0] >> 4, rdbuf[0] & 0x0F);
975 case 0x5a: /* Solomon Goldentek Display */
976 snprintf(model_name, EDT_NAME_LEN, "GKTW50SCED1R0");
978 case 0x59: /* Evervision Display with FT5xx6 TS */
979 tsdata->version = EV_FT;
980 error = edt_ft5x06_ts_readwrite(client, 1, "\x53",
984 strscpy(fw_version, rdbuf, 1);
985 snprintf(model_name, EDT_NAME_LEN,
986 "EVERVISION-FT5726NEi");
989 snprintf(model_name, EDT_NAME_LEN,
990 "generic ft5x06 (%02x)",
999 static void edt_ft5x06_ts_get_defaults(struct device *dev,
1000 struct edt_ft5x06_ts_data *tsdata)
1002 struct edt_reg_addr *reg_addr = &tsdata->reg_addr;
1006 error = device_property_read_u32(dev, "threshold", &val);
1008 edt_ft5x06_register_write(tsdata, reg_addr->reg_threshold, val);
1009 tsdata->threshold = val;
1012 error = device_property_read_u32(dev, "gain", &val);
1014 edt_ft5x06_register_write(tsdata, reg_addr->reg_gain, val);
1018 error = device_property_read_u32(dev, "offset", &val);
1020 if (reg_addr->reg_offset != NO_REGISTER)
1021 edt_ft5x06_register_write(tsdata,
1022 reg_addr->reg_offset, val);
1023 tsdata->offset = val;
1026 error = device_property_read_u32(dev, "offset-x", &val);
1028 if (reg_addr->reg_offset_x != NO_REGISTER)
1029 edt_ft5x06_register_write(tsdata,
1030 reg_addr->reg_offset_x, val);
1031 tsdata->offset_x = val;
1034 error = device_property_read_u32(dev, "offset-y", &val);
1036 if (reg_addr->reg_offset_y != NO_REGISTER)
1037 edt_ft5x06_register_write(tsdata,
1038 reg_addr->reg_offset_y, val);
1039 tsdata->offset_y = val;
1043 static void edt_ft5x06_ts_get_parameters(struct edt_ft5x06_ts_data *tsdata)
1045 struct edt_reg_addr *reg_addr = &tsdata->reg_addr;
1047 tsdata->threshold = edt_ft5x06_register_read(tsdata,
1048 reg_addr->reg_threshold);
1049 tsdata->gain = edt_ft5x06_register_read(tsdata, reg_addr->reg_gain);
1050 if (reg_addr->reg_offset != NO_REGISTER)
1052 edt_ft5x06_register_read(tsdata, reg_addr->reg_offset);
1053 if (reg_addr->reg_offset_x != NO_REGISTER)
1054 tsdata->offset_x = edt_ft5x06_register_read(tsdata,
1055 reg_addr->reg_offset_x);
1056 if (reg_addr->reg_offset_y != NO_REGISTER)
1057 tsdata->offset_y = edt_ft5x06_register_read(tsdata,
1058 reg_addr->reg_offset_y);
1059 if (reg_addr->reg_report_rate != NO_REGISTER)
1060 tsdata->report_rate = edt_ft5x06_register_read(tsdata,
1061 reg_addr->reg_report_rate);
1062 tsdata->num_x = EDT_DEFAULT_NUM_X;
1063 if (reg_addr->reg_num_x != NO_REGISTER)
1064 tsdata->num_x = edt_ft5x06_register_read(tsdata,
1065 reg_addr->reg_num_x);
1066 tsdata->num_y = EDT_DEFAULT_NUM_Y;
1067 if (reg_addr->reg_num_y != NO_REGISTER)
1068 tsdata->num_y = edt_ft5x06_register_read(tsdata,
1069 reg_addr->reg_num_y);
1072 static void edt_ft5x06_ts_set_regs(struct edt_ft5x06_ts_data *tsdata)
1074 struct edt_reg_addr *reg_addr = &tsdata->reg_addr;
1076 switch (tsdata->version) {
1078 reg_addr->reg_threshold = WORK_REGISTER_THRESHOLD;
1079 reg_addr->reg_report_rate = WORK_REGISTER_REPORT_RATE;
1080 reg_addr->reg_gain = WORK_REGISTER_GAIN;
1081 reg_addr->reg_offset = WORK_REGISTER_OFFSET;
1082 reg_addr->reg_offset_x = NO_REGISTER;
1083 reg_addr->reg_offset_y = NO_REGISTER;
1084 reg_addr->reg_num_x = WORK_REGISTER_NUM_X;
1085 reg_addr->reg_num_y = WORK_REGISTER_NUM_Y;
1090 reg_addr->reg_threshold = M09_REGISTER_THRESHOLD;
1091 reg_addr->reg_report_rate = tsdata->version == EDT_M12 ?
1092 M12_REGISTER_REPORT_RATE : NO_REGISTER;
1093 reg_addr->reg_gain = M09_REGISTER_GAIN;
1094 reg_addr->reg_offset = M09_REGISTER_OFFSET;
1095 reg_addr->reg_offset_x = NO_REGISTER;
1096 reg_addr->reg_offset_y = NO_REGISTER;
1097 reg_addr->reg_num_x = M09_REGISTER_NUM_X;
1098 reg_addr->reg_num_y = M09_REGISTER_NUM_Y;
1102 reg_addr->reg_threshold = EV_REGISTER_THRESHOLD;
1103 reg_addr->reg_report_rate = NO_REGISTER;
1104 reg_addr->reg_gain = EV_REGISTER_GAIN;
1105 reg_addr->reg_offset = NO_REGISTER;
1106 reg_addr->reg_offset_x = EV_REGISTER_OFFSET_X;
1107 reg_addr->reg_offset_y = EV_REGISTER_OFFSET_Y;
1108 reg_addr->reg_num_x = NO_REGISTER;
1109 reg_addr->reg_num_y = NO_REGISTER;
1113 /* this is a guesswork */
1114 reg_addr->reg_threshold = M09_REGISTER_THRESHOLD;
1115 reg_addr->reg_report_rate = NO_REGISTER;
1116 reg_addr->reg_gain = M09_REGISTER_GAIN;
1117 reg_addr->reg_offset = M09_REGISTER_OFFSET;
1118 reg_addr->reg_offset_x = NO_REGISTER;
1119 reg_addr->reg_offset_y = NO_REGISTER;
1120 reg_addr->reg_num_x = NO_REGISTER;
1121 reg_addr->reg_num_y = NO_REGISTER;
1126 static void edt_ft5x06_disable_regulators(void *arg)
1128 struct edt_ft5x06_ts_data *data = arg;
1130 regulator_disable(data->vcc);
1131 regulator_disable(data->iovcc);
1134 static int edt_ft5x06_ts_probe(struct i2c_client *client,
1135 const struct i2c_device_id *id)
1137 const struct edt_i2c_chip_data *chip_data;
1138 struct edt_ft5x06_ts_data *tsdata;
1139 u8 buf[2] = { 0xfc, 0x00 };
1140 struct input_dev *input;
1141 unsigned long irq_flags;
1145 dev_dbg(&client->dev, "probing for EDT FT5x06 I2C\n");
1147 tsdata = devm_kzalloc(&client->dev, sizeof(*tsdata), GFP_KERNEL);
1149 dev_err(&client->dev, "failed to allocate driver data.\n");
1153 chip_data = device_get_match_data(&client->dev);
1155 chip_data = (const struct edt_i2c_chip_data *)id->driver_data;
1156 if (!chip_data || !chip_data->max_support_points) {
1157 dev_err(&client->dev, "invalid or missing chip data\n");
1161 tsdata->max_support_points = chip_data->max_support_points;
1163 tsdata->vcc = devm_regulator_get(&client->dev, "vcc");
1164 if (IS_ERR(tsdata->vcc)) {
1165 error = PTR_ERR(tsdata->vcc);
1166 if (error != -EPROBE_DEFER)
1167 dev_err(&client->dev,
1168 "failed to request regulator: %d\n", error);
1172 tsdata->iovcc = devm_regulator_get(&client->dev, "iovcc");
1173 if (IS_ERR(tsdata->iovcc)) {
1174 error = PTR_ERR(tsdata->iovcc);
1175 if (error != -EPROBE_DEFER)
1176 dev_err(&client->dev,
1177 "failed to request iovcc regulator: %d\n", error);
1181 error = regulator_enable(tsdata->iovcc);
1183 dev_err(&client->dev, "failed to enable iovcc: %d\n", error);
1187 /* Delay enabling VCC for > 10us (T_ivd) after IOVCC */
1188 usleep_range(10, 100);
1190 error = regulator_enable(tsdata->vcc);
1192 dev_err(&client->dev, "failed to enable vcc: %d\n", error);
1193 regulator_disable(tsdata->iovcc);
1197 error = devm_add_action_or_reset(&client->dev,
1198 edt_ft5x06_disable_regulators,
1203 tsdata->reset_gpio = devm_gpiod_get_optional(&client->dev,
1204 "reset", GPIOD_OUT_HIGH);
1205 if (IS_ERR(tsdata->reset_gpio)) {
1206 error = PTR_ERR(tsdata->reset_gpio);
1207 dev_err(&client->dev,
1208 "Failed to request GPIO reset pin, error %d\n", error);
1212 tsdata->wake_gpio = devm_gpiod_get_optional(&client->dev,
1213 "wake", GPIOD_OUT_LOW);
1214 if (IS_ERR(tsdata->wake_gpio)) {
1215 error = PTR_ERR(tsdata->wake_gpio);
1216 dev_err(&client->dev,
1217 "Failed to request GPIO wake pin, error %d\n", error);
1222 * Check which sleep modes we can support. Power-off requieres the
1223 * reset-pin to ensure correct power-down/power-up behaviour. Start with
1224 * the EDT_PMODE_POWEROFF test since this is the deepest possible sleep
1227 if (tsdata->reset_gpio)
1228 tsdata->suspend_mode = EDT_PMODE_POWEROFF;
1229 else if (tsdata->wake_gpio)
1230 tsdata->suspend_mode = EDT_PMODE_HIBERNATE;
1232 tsdata->suspend_mode = EDT_PMODE_NOT_SUPPORTED;
1234 if (tsdata->wake_gpio) {
1235 usleep_range(5000, 6000);
1236 gpiod_set_value_cansleep(tsdata->wake_gpio, 1);
1239 if (tsdata->reset_gpio) {
1240 usleep_range(5000, 6000);
1241 gpiod_set_value_cansleep(tsdata->reset_gpio, 0);
1245 input = devm_input_allocate_device(&client->dev);
1247 dev_err(&client->dev, "failed to allocate input device.\n");
1251 mutex_init(&tsdata->mutex);
1252 tsdata->client = client;
1253 tsdata->input = input;
1254 tsdata->factory_mode = false;
1256 error = edt_ft5x06_ts_identify(client, tsdata);
1258 dev_err(&client->dev, "touchscreen probe failed\n");
1263 * Dummy read access. EP0700MLP1 returns bogus data on the first
1264 * register read access and ignores writes.
1266 edt_ft5x06_ts_readwrite(tsdata->client, 2, buf, 2, buf);
1268 edt_ft5x06_ts_set_regs(tsdata);
1269 edt_ft5x06_ts_get_defaults(&client->dev, tsdata);
1270 edt_ft5x06_ts_get_parameters(tsdata);
1272 if (tsdata->reg_addr.reg_report_rate != NO_REGISTER &&
1273 !device_property_read_u32(&client->dev,
1274 "report-rate-hz", &report_rate)) {
1275 if (tsdata->version == EDT_M06)
1276 tsdata->report_rate = clamp_val(report_rate, 30, 140);
1278 tsdata->report_rate = clamp_val(report_rate, 1, 255);
1280 if (report_rate != tsdata->report_rate)
1281 dev_warn(&client->dev,
1282 "report-rate %dHz is unsupported, use %dHz\n",
1283 report_rate, tsdata->report_rate);
1285 if (tsdata->version == EDT_M06)
1286 tsdata->report_rate /= 10;
1288 edt_ft5x06_register_write(tsdata,
1289 tsdata->reg_addr.reg_report_rate,
1290 tsdata->report_rate);
1293 dev_dbg(&client->dev,
1294 "Model \"%s\", Rev. \"%s\", %dx%d sensors\n",
1295 tsdata->name, tsdata->fw_version, tsdata->num_x, tsdata->num_y);
1297 input->name = tsdata->name;
1298 input->id.bustype = BUS_I2C;
1299 input->dev.parent = &client->dev;
1301 input_set_abs_params(input, ABS_MT_POSITION_X,
1302 0, tsdata->num_x * 64 - 1, 0, 0);
1303 input_set_abs_params(input, ABS_MT_POSITION_Y,
1304 0, tsdata->num_y * 64 - 1, 0, 0);
1306 touchscreen_parse_properties(input, true, &tsdata->prop);
1308 error = input_mt_init_slots(input, tsdata->max_support_points,
1311 dev_err(&client->dev, "Unable to init MT slots.\n");
1315 i2c_set_clientdata(client, tsdata);
1317 irq_flags = irq_get_trigger_type(client->irq);
1318 if (irq_flags == IRQF_TRIGGER_NONE)
1319 irq_flags = IRQF_TRIGGER_FALLING;
1320 irq_flags |= IRQF_ONESHOT;
1322 error = devm_request_threaded_irq(&client->dev, client->irq,
1323 NULL, edt_ft5x06_ts_isr, irq_flags,
1324 client->name, tsdata);
1326 dev_err(&client->dev, "Unable to request touchscreen IRQ.\n");
1330 error = devm_device_add_group(&client->dev, &edt_ft5x06_attr_group);
1334 error = input_register_device(input);
1338 edt_ft5x06_ts_prepare_debugfs(tsdata, dev_driver_string(&client->dev));
1340 dev_dbg(&client->dev,
1341 "EDT FT5x06 initialized: IRQ %d, WAKE pin %d, Reset pin %d.\n",
1343 tsdata->wake_gpio ? desc_to_gpio(tsdata->wake_gpio) : -1,
1344 tsdata->reset_gpio ? desc_to_gpio(tsdata->reset_gpio) : -1);
1349 static void edt_ft5x06_ts_remove(struct i2c_client *client)
1351 struct edt_ft5x06_ts_data *tsdata = i2c_get_clientdata(client);
1353 edt_ft5x06_ts_teardown_debugfs(tsdata);
1356 static int __maybe_unused edt_ft5x06_ts_suspend(struct device *dev)
1358 struct i2c_client *client = to_i2c_client(dev);
1359 struct edt_ft5x06_ts_data *tsdata = i2c_get_clientdata(client);
1360 struct gpio_desc *reset_gpio = tsdata->reset_gpio;
1363 if (device_may_wakeup(dev))
1366 if (tsdata->suspend_mode == EDT_PMODE_NOT_SUPPORTED)
1369 /* Enter hibernate mode. */
1370 ret = edt_ft5x06_register_write(tsdata, PMOD_REGISTER_OPMODE,
1371 PMOD_REGISTER_HIBERNATE);
1373 dev_warn(dev, "Failed to set hibernate mode\n");
1375 if (tsdata->suspend_mode == EDT_PMODE_HIBERNATE)
1379 * Power-off according the datasheet. Cut the power may leaf the irq
1380 * line in an undefined state depending on the host pull resistor
1381 * settings. Disable the irq to avoid adjusting each host till the
1382 * device is back in a full functional state.
1384 disable_irq(tsdata->client->irq);
1386 gpiod_set_value_cansleep(reset_gpio, 1);
1387 usleep_range(1000, 2000);
1389 ret = regulator_disable(tsdata->vcc);
1391 dev_warn(dev, "Failed to disable vcc\n");
1392 ret = regulator_disable(tsdata->iovcc);
1394 dev_warn(dev, "Failed to disable iovcc\n");
1399 static int __maybe_unused edt_ft5x06_ts_resume(struct device *dev)
1401 struct i2c_client *client = to_i2c_client(dev);
1402 struct edt_ft5x06_ts_data *tsdata = i2c_get_clientdata(client);
1405 if (device_may_wakeup(dev))
1408 if (tsdata->suspend_mode == EDT_PMODE_NOT_SUPPORTED)
1411 if (tsdata->suspend_mode == EDT_PMODE_POWEROFF) {
1412 struct gpio_desc *reset_gpio = tsdata->reset_gpio;
1415 * We can't check if the regulator is a dummy or a real
1416 * regulator. So we need to specify the 5ms reset time (T_rst)
1417 * here instead of the 100us T_rtp time. We also need to wait
1418 * 300ms in case it was a real supply and the power was cutted
1419 * of. Toggle the reset pin is also a way to exit the hibernate
1422 gpiod_set_value_cansleep(reset_gpio, 1);
1423 usleep_range(5000, 6000);
1425 ret = regulator_enable(tsdata->iovcc);
1427 dev_err(dev, "Failed to enable iovcc\n");
1431 /* Delay enabling VCC for > 10us (T_ivd) after IOVCC */
1432 usleep_range(10, 100);
1434 ret = regulator_enable(tsdata->vcc);
1436 dev_err(dev, "Failed to enable vcc\n");
1437 regulator_disable(tsdata->iovcc);
1441 usleep_range(1000, 2000);
1442 gpiod_set_value_cansleep(reset_gpio, 0);
1445 edt_ft5x06_restore_reg_parameters(tsdata);
1446 enable_irq(tsdata->client->irq);
1448 if (tsdata->factory_mode)
1449 ret = edt_ft5x06_factory_mode(tsdata);
1451 struct gpio_desc *wake_gpio = tsdata->wake_gpio;
1453 gpiod_set_value_cansleep(wake_gpio, 0);
1454 usleep_range(5000, 6000);
1455 gpiod_set_value_cansleep(wake_gpio, 1);
1462 static SIMPLE_DEV_PM_OPS(edt_ft5x06_ts_pm_ops,
1463 edt_ft5x06_ts_suspend, edt_ft5x06_ts_resume);
1465 static const struct edt_i2c_chip_data edt_ft5x06_data = {
1466 .max_support_points = 5,
1469 static const struct edt_i2c_chip_data edt_ft5506_data = {
1470 .max_support_points = 10,
1473 static const struct edt_i2c_chip_data edt_ft6236_data = {
1474 .max_support_points = 2,
1477 static const struct i2c_device_id edt_ft5x06_ts_id[] = {
1478 { .name = "edt-ft5x06", .driver_data = (long)&edt_ft5x06_data },
1479 { .name = "edt-ft5506", .driver_data = (long)&edt_ft5506_data },
1480 { .name = "ev-ft5726", .driver_data = (long)&edt_ft5506_data },
1481 /* Note no edt- prefix for compatibility with the ft6236.c driver */
1482 { .name = "ft6236", .driver_data = (long)&edt_ft6236_data },
1485 MODULE_DEVICE_TABLE(i2c, edt_ft5x06_ts_id);
1487 static const struct of_device_id edt_ft5x06_of_match[] = {
1488 { .compatible = "edt,edt-ft5206", .data = &edt_ft5x06_data },
1489 { .compatible = "edt,edt-ft5306", .data = &edt_ft5x06_data },
1490 { .compatible = "edt,edt-ft5406", .data = &edt_ft5x06_data },
1491 { .compatible = "edt,edt-ft5506", .data = &edt_ft5506_data },
1492 { .compatible = "evervision,ev-ft5726", .data = &edt_ft5506_data },
1493 /* Note focaltech vendor prefix for compatibility with ft6236.c */
1494 { .compatible = "focaltech,ft6236", .data = &edt_ft6236_data },
1497 MODULE_DEVICE_TABLE(of, edt_ft5x06_of_match);
1499 static struct i2c_driver edt_ft5x06_ts_driver = {
1501 .name = "edt_ft5x06",
1502 .of_match_table = edt_ft5x06_of_match,
1503 .pm = &edt_ft5x06_ts_pm_ops,
1504 .probe_type = PROBE_PREFER_ASYNCHRONOUS,
1506 .id_table = edt_ft5x06_ts_id,
1507 .probe = edt_ft5x06_ts_probe,
1508 .remove = edt_ft5x06_ts_remove,
1511 module_i2c_driver(edt_ft5x06_ts_driver);
1513 MODULE_AUTHOR("Simon Budig <simon.budig@kernelconcepts.de>");
1514 MODULE_DESCRIPTION("EDT FT5x06 I2C Touchscreen Driver");
1515 MODULE_LICENSE("GPL v2");