2 * Driver for Goodix Touchscreens
4 * Copyright (c) 2014 Red Hat Inc.
5 * Copyright (c) 2015 K. Merker <merker@debian.org>
7 * This code is based on gt9xx.c authored by andrew@goodix.com:
9 * 2010 - 2012 Goodix Technology.
13 * This program is free software; you can redistribute it and/or modify it
14 * under the terms of the GNU General Public License as published by the Free
15 * Software Foundation; version 2 of the License.
18 #include <linux/kernel.h>
19 #include <linux/dmi.h>
20 #include <linux/firmware.h>
21 #include <linux/gpio/consumer.h>
22 #include <linux/i2c.h>
23 #include <linux/input.h>
24 #include <linux/input/mt.h>
25 #include <linux/module.h>
26 #include <linux/delay.h>
27 #include <linux/irq.h>
28 #include <linux/interrupt.h>
29 #include <linux/slab.h>
30 #include <linux/acpi.h>
32 #include <asm/unaligned.h>
34 struct goodix_ts_data {
35 struct i2c_client *client;
36 struct input_dev *input_dev;
42 unsigned int max_touch_num;
43 unsigned int int_trigger_type;
45 struct gpio_desc *gpiod_int;
46 struct gpio_desc *gpiod_rst;
50 struct completion firmware_loading_complete;
51 unsigned long irq_flags;
54 #define GOODIX_GPIO_INT_NAME "irq"
55 #define GOODIX_GPIO_RST_NAME "reset"
57 #define GOODIX_MAX_HEIGHT 4096
58 #define GOODIX_MAX_WIDTH 4096
59 #define GOODIX_INT_TRIGGER 1
60 #define GOODIX_CONTACT_SIZE 8
61 #define GOODIX_MAX_CONTACTS 10
63 #define GOODIX_CONFIG_MAX_LENGTH 240
64 #define GOODIX_CONFIG_911_LENGTH 186
65 #define GOODIX_CONFIG_967_LENGTH 228
67 /* Register defines */
68 #define GOODIX_REG_COMMAND 0x8040
69 #define GOODIX_CMD_SCREEN_OFF 0x05
71 #define GOODIX_READ_COOR_ADDR 0x814E
72 #define GOODIX_REG_CONFIG_DATA 0x8047
73 #define GOODIX_REG_ID 0x8140
75 #define RESOLUTION_LOC 1
76 #define MAX_CONTACTS_LOC 5
79 static const unsigned long goodix_irq_flags[] = {
81 IRQ_TYPE_EDGE_FALLING,
87 * Those tablets have their coordinates origin at the bottom right
88 * of the tablet, as if rotated 180 degrees
90 static const struct dmi_system_id rotated_screen[] = {
91 #if defined(CONFIG_DMI) && defined(CONFIG_X86)
93 .ident = "Teclast X89",
95 /* tPAD is too generic, also match on bios date */
96 DMI_MATCH(DMI_BOARD_VENDOR, "TECLAST"),
97 DMI_MATCH(DMI_BOARD_NAME, "tPAD"),
98 DMI_MATCH(DMI_BIOS_DATE, "12/19/2014"),
102 .ident = "Teclast X98 Pro",
105 * Only match BIOS date, because the manufacturers
106 * BIOS does not report the board name at all
109 DMI_MATCH(DMI_BOARD_VENDOR, "TECLAST"),
110 DMI_MATCH(DMI_BIOS_DATE, "10/28/2015"),
114 .ident = "WinBook TW100",
116 DMI_MATCH(DMI_SYS_VENDOR, "WinBook"),
117 DMI_MATCH(DMI_PRODUCT_NAME, "TW100")
121 .ident = "WinBook TW700",
123 DMI_MATCH(DMI_SYS_VENDOR, "WinBook"),
124 DMI_MATCH(DMI_PRODUCT_NAME, "TW700")
132 * goodix_i2c_read - read data from a register of the i2c slave device.
134 * @client: i2c device.
135 * @reg: the register to read from.
136 * @buf: raw write data buffer.
137 * @len: length of the buffer to write
139 static int goodix_i2c_read(struct i2c_client *client,
140 u16 reg, u8 *buf, int len)
142 struct i2c_msg msgs[2];
143 u16 wbuf = cpu_to_be16(reg);
147 msgs[0].addr = client->addr;
149 msgs[0].buf = (u8 *)&wbuf;
151 msgs[1].flags = I2C_M_RD;
152 msgs[1].addr = client->addr;
156 ret = i2c_transfer(client->adapter, msgs, 2);
157 return ret < 0 ? ret : (ret != ARRAY_SIZE(msgs) ? -EIO : 0);
161 * goodix_i2c_write - write data to a register of the i2c slave device.
163 * @client: i2c device.
164 * @reg: the register to write to.
165 * @buf: raw data buffer to write.
166 * @len: length of the buffer to write
168 static int goodix_i2c_write(struct i2c_client *client, u16 reg, const u8 *buf,
175 addr_buf = kmalloc(len + 2, GFP_KERNEL);
179 addr_buf[0] = reg >> 8;
180 addr_buf[1] = reg & 0xFF;
181 memcpy(&addr_buf[2], buf, len);
184 msg.addr = client->addr;
188 ret = i2c_transfer(client->adapter, &msg, 1);
190 return ret < 0 ? ret : (ret != 1 ? -EIO : 0);
193 static int goodix_i2c_write_u8(struct i2c_client *client, u16 reg, u8 value)
195 return goodix_i2c_write(client, reg, &value, sizeof(value));
198 static int goodix_get_cfg_len(u16 id)
206 return GOODIX_CONFIG_911_LENGTH;
210 return GOODIX_CONFIG_967_LENGTH;
213 return GOODIX_CONFIG_MAX_LENGTH;
217 static int goodix_ts_read_input_report(struct goodix_ts_data *ts, u8 *data)
222 error = goodix_i2c_read(ts->client, GOODIX_READ_COOR_ADDR, data,
223 GOODIX_CONTACT_SIZE + 1);
225 dev_err(&ts->client->dev, "I2C transfer error: %d\n", error);
229 if (!(data[0] & 0x80))
232 touch_num = data[0] & 0x0f;
233 if (touch_num > ts->max_touch_num)
237 data += 1 + GOODIX_CONTACT_SIZE;
238 error = goodix_i2c_read(ts->client,
239 GOODIX_READ_COOR_ADDR +
240 1 + GOODIX_CONTACT_SIZE,
242 GOODIX_CONTACT_SIZE * (touch_num - 1));
250 static void goodix_ts_report_touch(struct goodix_ts_data *ts, u8 *coor_data)
252 int id = coor_data[0] & 0x0F;
253 int input_x = get_unaligned_le16(&coor_data[1]);
254 int input_y = get_unaligned_le16(&coor_data[3]);
255 int input_w = get_unaligned_le16(&coor_data[5]);
257 /* Inversions have to happen before axis swapping */
259 input_x = ts->abs_x_max - input_x;
261 input_y = ts->abs_y_max - input_y;
263 swap(input_x, input_y);
265 input_mt_slot(ts->input_dev, id);
266 input_mt_report_slot_state(ts->input_dev, MT_TOOL_FINGER, true);
267 input_report_abs(ts->input_dev, ABS_MT_POSITION_X, input_x);
268 input_report_abs(ts->input_dev, ABS_MT_POSITION_Y, input_y);
269 input_report_abs(ts->input_dev, ABS_MT_TOUCH_MAJOR, input_w);
270 input_report_abs(ts->input_dev, ABS_MT_WIDTH_MAJOR, input_w);
274 * goodix_process_events - Process incoming events
276 * @ts: our goodix_ts_data pointer
278 * Called when the IRQ is triggered. Read the current device state, and push
279 * the input events to the user space.
281 static void goodix_process_events(struct goodix_ts_data *ts)
283 u8 point_data[1 + GOODIX_CONTACT_SIZE * GOODIX_MAX_CONTACTS];
287 touch_num = goodix_ts_read_input_report(ts, point_data);
291 for (i = 0; i < touch_num; i++)
292 goodix_ts_report_touch(ts,
293 &point_data[1 + GOODIX_CONTACT_SIZE * i]);
295 input_mt_sync_frame(ts->input_dev);
296 input_sync(ts->input_dev);
300 * goodix_ts_irq_handler - The IRQ handler
302 * @irq: interrupt number.
303 * @dev_id: private data pointer.
305 static irqreturn_t goodix_ts_irq_handler(int irq, void *dev_id)
307 struct goodix_ts_data *ts = dev_id;
309 goodix_process_events(ts);
311 if (goodix_i2c_write_u8(ts->client, GOODIX_READ_COOR_ADDR, 0) < 0)
312 dev_err(&ts->client->dev, "I2C write end_cmd error\n");
317 static void goodix_free_irq(struct goodix_ts_data *ts)
319 devm_free_irq(&ts->client->dev, ts->client->irq, ts);
322 static int goodix_request_irq(struct goodix_ts_data *ts)
324 return devm_request_threaded_irq(&ts->client->dev, ts->client->irq,
325 NULL, goodix_ts_irq_handler,
326 ts->irq_flags, ts->client->name, ts);
330 * goodix_check_cfg - Checks if config fw is valid
332 * @ts: goodix_ts_data pointer
333 * @cfg: firmware config data
335 static int goodix_check_cfg(struct goodix_ts_data *ts,
336 const struct firmware *cfg)
341 if (cfg->size > GOODIX_CONFIG_MAX_LENGTH) {
342 dev_err(&ts->client->dev,
343 "The length of the config fw is not correct");
347 raw_cfg_len = cfg->size - 2;
348 for (i = 0; i < raw_cfg_len; i++)
349 check_sum += cfg->data[i];
350 check_sum = (~check_sum) + 1;
351 if (check_sum != cfg->data[raw_cfg_len]) {
352 dev_err(&ts->client->dev,
353 "The checksum of the config fw is not correct");
357 if (cfg->data[raw_cfg_len + 1] != 1) {
358 dev_err(&ts->client->dev,
359 "Config fw must have Config_Fresh register set");
367 * goodix_send_cfg - Write fw config to device
369 * @ts: goodix_ts_data pointer
370 * @cfg: config firmware to write to device
372 static int goodix_send_cfg(struct goodix_ts_data *ts,
373 const struct firmware *cfg)
377 error = goodix_check_cfg(ts, cfg);
381 error = goodix_i2c_write(ts->client, GOODIX_REG_CONFIG_DATA, cfg->data,
384 dev_err(&ts->client->dev, "Failed to write config data: %d",
388 dev_dbg(&ts->client->dev, "Config sent successfully.");
390 /* Let the firmware reconfigure itself, so sleep for 10ms */
391 usleep_range(10000, 11000);
396 static int goodix_int_sync(struct goodix_ts_data *ts)
400 error = gpiod_direction_output(ts->gpiod_int, 0);
404 msleep(50); /* T5: 50ms */
406 error = gpiod_direction_input(ts->gpiod_int);
414 * goodix_reset - Reset device during power on
416 * @ts: goodix_ts_data pointer
418 static int goodix_reset(struct goodix_ts_data *ts)
422 /* begin select I2C slave addr */
423 error = gpiod_direction_output(ts->gpiod_rst, 0);
427 msleep(20); /* T2: > 10ms */
429 /* HIGH: 0x28/0x29, LOW: 0xBA/0xBB */
430 error = gpiod_direction_output(ts->gpiod_int, ts->client->addr == 0x14);
434 usleep_range(100, 2000); /* T3: > 100us */
436 error = gpiod_direction_output(ts->gpiod_rst, 1);
440 usleep_range(6000, 10000); /* T4: > 5ms */
442 /* end select I2C slave addr */
443 error = gpiod_direction_input(ts->gpiod_rst);
447 error = goodix_int_sync(ts);
455 * goodix_get_gpio_config - Get GPIO config from ACPI/DT
457 * @ts: goodix_ts_data pointer
459 static int goodix_get_gpio_config(struct goodix_ts_data *ts)
463 struct gpio_desc *gpiod;
467 dev = &ts->client->dev;
469 /* Get the interrupt GPIO pin number */
470 gpiod = devm_gpiod_get_optional(dev, GOODIX_GPIO_INT_NAME, GPIOD_IN);
472 error = PTR_ERR(gpiod);
473 if (error != -EPROBE_DEFER)
474 dev_dbg(dev, "Failed to get %s GPIO: %d\n",
475 GOODIX_GPIO_INT_NAME, error);
479 ts->gpiod_int = gpiod;
481 /* Get the reset line GPIO pin number */
482 gpiod = devm_gpiod_get_optional(dev, GOODIX_GPIO_RST_NAME, GPIOD_IN);
484 error = PTR_ERR(gpiod);
485 if (error != -EPROBE_DEFER)
486 dev_dbg(dev, "Failed to get %s GPIO: %d\n",
487 GOODIX_GPIO_RST_NAME, error);
491 ts->gpiod_rst = gpiod;
497 * goodix_read_config - Read the embedded configuration of the panel
499 * @ts: our goodix_ts_data pointer
501 * Must be called during probe
503 static void goodix_read_config(struct goodix_ts_data *ts)
505 u8 config[GOODIX_CONFIG_MAX_LENGTH];
508 error = goodix_i2c_read(ts->client, GOODIX_REG_CONFIG_DATA,
509 config, ts->cfg_len);
511 dev_warn(&ts->client->dev,
512 "Error reading config (%d), using defaults\n",
514 ts->abs_x_max = GOODIX_MAX_WIDTH;
515 ts->abs_y_max = GOODIX_MAX_HEIGHT;
517 swap(ts->abs_x_max, ts->abs_y_max);
518 ts->int_trigger_type = GOODIX_INT_TRIGGER;
519 ts->max_touch_num = GOODIX_MAX_CONTACTS;
523 ts->abs_x_max = get_unaligned_le16(&config[RESOLUTION_LOC]);
524 ts->abs_y_max = get_unaligned_le16(&config[RESOLUTION_LOC + 2]);
526 swap(ts->abs_x_max, ts->abs_y_max);
527 ts->int_trigger_type = config[TRIGGER_LOC] & 0x03;
528 ts->max_touch_num = config[MAX_CONTACTS_LOC] & 0x0f;
529 if (!ts->abs_x_max || !ts->abs_y_max || !ts->max_touch_num) {
530 dev_err(&ts->client->dev,
531 "Invalid config, using defaults\n");
532 ts->abs_x_max = GOODIX_MAX_WIDTH;
533 ts->abs_y_max = GOODIX_MAX_HEIGHT;
535 swap(ts->abs_x_max, ts->abs_y_max);
536 ts->max_touch_num = GOODIX_MAX_CONTACTS;
539 if (dmi_check_system(rotated_screen)) {
540 ts->inverted_x = true;
541 ts->inverted_y = true;
542 dev_dbg(&ts->client->dev,
543 "Applying '180 degrees rotated screen' quirk\n");
548 * goodix_read_version - Read goodix touchscreen version
550 * @ts: our goodix_ts_data pointer
552 static int goodix_read_version(struct goodix_ts_data *ts)
558 error = goodix_i2c_read(ts->client, GOODIX_REG_ID, buf, sizeof(buf));
560 dev_err(&ts->client->dev, "read version failed: %d\n", error);
564 memcpy(id_str, buf, 4);
566 if (kstrtou16(id_str, 10, &ts->id))
569 ts->version = get_unaligned_le16(&buf[4]);
571 dev_info(&ts->client->dev, "ID %d, version: %04x\n", ts->id,
578 * goodix_i2c_test - I2C test function to check if the device answers.
580 * @client: the i2c client
582 static int goodix_i2c_test(struct i2c_client *client)
588 while (retry++ < 2) {
589 error = goodix_i2c_read(client, GOODIX_REG_CONFIG_DATA,
594 dev_err(&client->dev, "i2c test failed attempt %d: %d\n",
603 * goodix_request_input_dev - Allocate, populate and register the input device
605 * @ts: our goodix_ts_data pointer
607 * Must be called during probe
609 static int goodix_request_input_dev(struct goodix_ts_data *ts)
613 ts->input_dev = devm_input_allocate_device(&ts->client->dev);
614 if (!ts->input_dev) {
615 dev_err(&ts->client->dev, "Failed to allocate input device.");
619 input_set_abs_params(ts->input_dev, ABS_MT_POSITION_X,
620 0, ts->abs_x_max, 0, 0);
621 input_set_abs_params(ts->input_dev, ABS_MT_POSITION_Y,
622 0, ts->abs_y_max, 0, 0);
623 input_set_abs_params(ts->input_dev, ABS_MT_WIDTH_MAJOR, 0, 255, 0, 0);
624 input_set_abs_params(ts->input_dev, ABS_MT_TOUCH_MAJOR, 0, 255, 0, 0);
626 input_mt_init_slots(ts->input_dev, ts->max_touch_num,
627 INPUT_MT_DIRECT | INPUT_MT_DROP_UNUSED);
629 ts->input_dev->name = "Goodix Capacitive TouchScreen";
630 ts->input_dev->phys = "input/ts";
631 ts->input_dev->id.bustype = BUS_I2C;
632 ts->input_dev->id.vendor = 0x0416;
633 ts->input_dev->id.product = ts->id;
634 ts->input_dev->id.version = ts->version;
636 error = input_register_device(ts->input_dev);
638 dev_err(&ts->client->dev,
639 "Failed to register input device: %d", error);
647 * goodix_configure_dev - Finish device initialization
649 * @ts: our goodix_ts_data pointer
651 * Must be called from probe to finish initialization of the device.
652 * Contains the common initialization code for both devices that
653 * declare gpio pins and devices that do not. It is either called
654 * directly from probe or from request_firmware_wait callback.
656 static int goodix_configure_dev(struct goodix_ts_data *ts)
660 ts->swapped_x_y = device_property_read_bool(&ts->client->dev,
661 "touchscreen-swapped-x-y");
662 ts->inverted_x = device_property_read_bool(&ts->client->dev,
663 "touchscreen-inverted-x");
664 ts->inverted_y = device_property_read_bool(&ts->client->dev,
665 "touchscreen-inverted-y");
667 goodix_read_config(ts);
669 error = goodix_request_input_dev(ts);
673 ts->irq_flags = goodix_irq_flags[ts->int_trigger_type] | IRQF_ONESHOT;
674 error = goodix_request_irq(ts);
676 dev_err(&ts->client->dev, "request IRQ failed: %d\n", error);
684 * goodix_config_cb - Callback to finish device init
686 * @ts: our goodix_ts_data pointer
688 * request_firmware_wait callback that finishes
689 * initialization of the device.
691 static void goodix_config_cb(const struct firmware *cfg, void *ctx)
693 struct goodix_ts_data *ts = ctx;
697 /* send device configuration to the firmware */
698 error = goodix_send_cfg(ts, cfg);
700 goto err_release_cfg;
703 goodix_configure_dev(ts);
706 release_firmware(cfg);
707 complete_all(&ts->firmware_loading_complete);
710 static int goodix_ts_probe(struct i2c_client *client,
711 const struct i2c_device_id *id)
713 struct goodix_ts_data *ts;
716 dev_dbg(&client->dev, "I2C Address: 0x%02x\n", client->addr);
718 if (!i2c_check_functionality(client->adapter, I2C_FUNC_I2C)) {
719 dev_err(&client->dev, "I2C check functionality failed.\n");
723 ts = devm_kzalloc(&client->dev, sizeof(*ts), GFP_KERNEL);
728 i2c_set_clientdata(client, ts);
729 init_completion(&ts->firmware_loading_complete);
731 error = goodix_get_gpio_config(ts);
735 if (ts->gpiod_int && ts->gpiod_rst) {
736 /* reset the controller */
737 error = goodix_reset(ts);
739 dev_err(&client->dev, "Controller reset failed.\n");
744 error = goodix_i2c_test(client);
746 dev_err(&client->dev, "I2C communication failure: %d\n", error);
750 error = goodix_read_version(ts);
752 dev_err(&client->dev, "Read version failed.\n");
756 ts->cfg_len = goodix_get_cfg_len(ts->id);
758 if (ts->gpiod_int && ts->gpiod_rst) {
759 /* update device config */
760 ts->cfg_name = devm_kasprintf(&client->dev, GFP_KERNEL,
761 "/*(DEBLOBBED)*/", ts->id);
765 error = reject_firmware_nowait(THIS_MODULE, true, ts->cfg_name,
766 &client->dev, GFP_KERNEL, ts,
769 dev_err(&client->dev,
770 "Failed to invoke firmware loader: %d\n",
777 error = goodix_configure_dev(ts);
785 static int goodix_ts_remove(struct i2c_client *client)
787 struct goodix_ts_data *ts = i2c_get_clientdata(client);
789 if (ts->gpiod_int && ts->gpiod_rst)
790 wait_for_completion(&ts->firmware_loading_complete);
795 static int __maybe_unused goodix_suspend(struct device *dev)
797 struct i2c_client *client = to_i2c_client(dev);
798 struct goodix_ts_data *ts = i2c_get_clientdata(client);
801 /* We need gpio pins to suspend/resume */
802 if (!ts->gpiod_int || !ts->gpiod_rst) {
803 disable_irq(client->irq);
807 wait_for_completion(&ts->firmware_loading_complete);
809 /* Free IRQ as IRQ pin is used as output in the suspend sequence */
812 /* Output LOW on the INT pin for 5 ms */
813 error = gpiod_direction_output(ts->gpiod_int, 0);
815 goodix_request_irq(ts);
819 usleep_range(5000, 6000);
821 error = goodix_i2c_write_u8(ts->client, GOODIX_REG_COMMAND,
822 GOODIX_CMD_SCREEN_OFF);
824 dev_err(&ts->client->dev, "Screen off command failed\n");
825 gpiod_direction_input(ts->gpiod_int);
826 goodix_request_irq(ts);
831 * The datasheet specifies that the interval between sending screen-off
832 * command and wake-up should be longer than 58 ms. To avoid waking up
833 * sooner, delay 58ms here.
839 static int __maybe_unused goodix_resume(struct device *dev)
841 struct i2c_client *client = to_i2c_client(dev);
842 struct goodix_ts_data *ts = i2c_get_clientdata(client);
845 if (!ts->gpiod_int || !ts->gpiod_rst) {
846 enable_irq(client->irq);
851 * Exit sleep mode by outputting HIGH level to INT pin
854 error = gpiod_direction_output(ts->gpiod_int, 1);
858 usleep_range(2000, 5000);
860 error = goodix_int_sync(ts);
864 error = goodix_request_irq(ts);
871 static SIMPLE_DEV_PM_OPS(goodix_pm_ops, goodix_suspend, goodix_resume);
873 static const struct i2c_device_id goodix_ts_id[] = {
874 { "GDIX1001:00", 0 },
877 MODULE_DEVICE_TABLE(i2c, goodix_ts_id);
880 static const struct acpi_device_id goodix_acpi_match[] = {
885 MODULE_DEVICE_TABLE(acpi, goodix_acpi_match);
889 static const struct of_device_id goodix_of_match[] = {
890 { .compatible = "goodix,gt911" },
891 { .compatible = "goodix,gt9110" },
892 { .compatible = "goodix,gt912" },
893 { .compatible = "goodix,gt927" },
894 { .compatible = "goodix,gt9271" },
895 { .compatible = "goodix,gt928" },
896 { .compatible = "goodix,gt967" },
899 MODULE_DEVICE_TABLE(of, goodix_of_match);
902 static struct i2c_driver goodix_ts_driver = {
903 .probe = goodix_ts_probe,
904 .remove = goodix_ts_remove,
905 .id_table = goodix_ts_id,
908 .acpi_match_table = ACPI_PTR(goodix_acpi_match),
909 .of_match_table = of_match_ptr(goodix_of_match),
910 .pm = &goodix_pm_ops,
913 module_i2c_driver(goodix_ts_driver);
915 MODULE_AUTHOR("Benjamin Tissoires <benjamin.tissoires@gmail.com>");
916 MODULE_AUTHOR("Bastien Nocera <hadess@hadess.net>");
917 MODULE_DESCRIPTION("Goodix touchscreen driver");
918 MODULE_LICENSE("GPL v2");