1 // SPDX-License-Identifier: GPL-2.0-only
3 * Driver for Goodix Touchscreens
5 * Copyright (c) 2014 Red Hat Inc.
10 * 2010 - 2012 Goodix Technology.
14 #include <linux/kernel.h>
15 #include <linux/dmi.h>
16 #include <linux/firmware.h>
17 #include <linux/gpio/consumer.h>
18 #include <linux/i2c.h>
19 #include <linux/input.h>
20 #include <linux/input/mt.h>
21 #include <linux/input/touchscreen.h>
22 #include <linux/module.h>
23 #include <linux/delay.h>
24 #include <linux/irq.h>
25 #include <linux/interrupt.h>
26 #include <linux/regulator/consumer.h>
27 #include <linux/slab.h>
28 #include <linux/acpi.h>
30 #include <asm/unaligned.h>
32 #define GOODIX_GPIO_INT_NAME "irq"
33 #define GOODIX_GPIO_RST_NAME "reset"
35 #define GOODIX_MAX_HEIGHT 4096
36 #define GOODIX_MAX_WIDTH 4096
37 #define GOODIX_INT_TRIGGER 1
38 #define GOODIX_CONTACT_SIZE 8
39 #define GOODIX_MAX_CONTACT_SIZE 9
40 #define GOODIX_MAX_CONTACTS 10
41 #define GOODIX_MAX_KEYS 7
43 #define GOODIX_CONFIG_MIN_LENGTH 186
44 #define GOODIX_CONFIG_911_LENGTH 186
45 #define GOODIX_CONFIG_967_LENGTH 228
46 #define GOODIX_CONFIG_GT9X_LENGTH 240
47 #define GOODIX_CONFIG_MAX_LENGTH 240
49 /* Register defines */
50 #define GOODIX_REG_COMMAND 0x8040
51 #define GOODIX_CMD_SCREEN_OFF 0x05
53 #define GOODIX_READ_COOR_ADDR 0x814E
54 #define GOODIX_GT1X_REG_CONFIG_DATA 0x8050
55 #define GOODIX_GT9X_REG_CONFIG_DATA 0x8047
56 #define GOODIX_REG_ID 0x8140
58 #define GOODIX_BUFFER_STATUS_READY BIT(7)
59 #define GOODIX_HAVE_KEY BIT(4)
60 #define GOODIX_BUFFER_STATUS_TIMEOUT 20
62 #define RESOLUTION_LOC 1
63 #define MAX_CONTACTS_LOC 5
66 /* Our special handling for GPIO accesses through ACPI is x86 specific */
67 #if defined CONFIG_X86 && defined CONFIG_ACPI
68 #define ACPI_GPIO_SUPPORT
71 struct goodix_ts_data;
73 enum goodix_irq_pin_access_method {
76 IRQ_PIN_ACCESS_ACPI_GPIO,
77 IRQ_PIN_ACCESS_ACPI_METHOD,
80 struct goodix_chip_data {
83 int (*check_config)(struct goodix_ts_data *ts, const u8 *cfg, int len);
84 void (*calc_config_checksum)(struct goodix_ts_data *ts);
87 struct goodix_chip_id {
89 const struct goodix_chip_data *data;
92 #define GOODIX_ID_MAX_LEN 4
94 struct goodix_ts_data {
95 struct i2c_client *client;
96 struct input_dev *input_dev;
97 const struct goodix_chip_data *chip;
98 struct touchscreen_properties prop;
99 unsigned int max_touch_num;
100 unsigned int int_trigger_type;
101 struct regulator *avdd28;
102 struct regulator *vddio;
103 struct gpio_desc *gpiod_int;
104 struct gpio_desc *gpiod_rst;
107 char id[GOODIX_ID_MAX_LEN + 1];
109 const char *cfg_name;
110 bool reset_controller_at_probe;
111 bool load_cfg_from_disk;
112 struct completion firmware_loading_complete;
113 unsigned long irq_flags;
114 enum goodix_irq_pin_access_method irq_pin_access_method;
115 unsigned int contact_size;
116 u8 config[GOODIX_CONFIG_MAX_LENGTH];
117 unsigned short keymap[GOODIX_MAX_KEYS];
120 static int goodix_check_cfg_8(struct goodix_ts_data *ts,
121 const u8 *cfg, int len);
122 static int goodix_check_cfg_16(struct goodix_ts_data *ts,
123 const u8 *cfg, int len);
124 static void goodix_calc_cfg_checksum_8(struct goodix_ts_data *ts);
125 static void goodix_calc_cfg_checksum_16(struct goodix_ts_data *ts);
127 static const struct goodix_chip_data gt1x_chip_data = {
128 .config_addr = GOODIX_GT1X_REG_CONFIG_DATA,
129 .config_len = GOODIX_CONFIG_GT9X_LENGTH,
130 .check_config = goodix_check_cfg_16,
131 .calc_config_checksum = goodix_calc_cfg_checksum_16,
134 static const struct goodix_chip_data gt911_chip_data = {
135 .config_addr = GOODIX_GT9X_REG_CONFIG_DATA,
136 .config_len = GOODIX_CONFIG_911_LENGTH,
137 .check_config = goodix_check_cfg_8,
138 .calc_config_checksum = goodix_calc_cfg_checksum_8,
141 static const struct goodix_chip_data gt967_chip_data = {
142 .config_addr = GOODIX_GT9X_REG_CONFIG_DATA,
143 .config_len = GOODIX_CONFIG_967_LENGTH,
144 .check_config = goodix_check_cfg_8,
145 .calc_config_checksum = goodix_calc_cfg_checksum_8,
148 static const struct goodix_chip_data gt9x_chip_data = {
149 .config_addr = GOODIX_GT9X_REG_CONFIG_DATA,
150 .config_len = GOODIX_CONFIG_GT9X_LENGTH,
151 .check_config = goodix_check_cfg_8,
152 .calc_config_checksum = goodix_calc_cfg_checksum_8,
155 static const struct goodix_chip_id goodix_chip_ids[] = {
156 { .id = "1151", .data = >1x_chip_data },
157 { .id = "5663", .data = >1x_chip_data },
158 { .id = "5688", .data = >1x_chip_data },
159 { .id = "917S", .data = >1x_chip_data },
161 { .id = "911", .data = >911_chip_data },
162 { .id = "9271", .data = >911_chip_data },
163 { .id = "9110", .data = >911_chip_data },
164 { .id = "927", .data = >911_chip_data },
165 { .id = "928", .data = >911_chip_data },
167 { .id = "912", .data = >967_chip_data },
168 { .id = "9147", .data = >967_chip_data },
169 { .id = "967", .data = >967_chip_data },
173 static const unsigned long goodix_irq_flags[] = {
174 IRQ_TYPE_EDGE_RISING,
175 IRQ_TYPE_EDGE_FALLING,
181 * Those tablets have their coordinates origin at the bottom right
182 * of the tablet, as if rotated 180 degrees
184 static const struct dmi_system_id rotated_screen[] = {
185 #if defined(CONFIG_DMI) && defined(CONFIG_X86)
187 .ident = "Teclast X89",
189 /* tPAD is too generic, also match on bios date */
190 DMI_MATCH(DMI_BOARD_VENDOR, "TECLAST"),
191 DMI_MATCH(DMI_BOARD_NAME, "tPAD"),
192 DMI_MATCH(DMI_BIOS_DATE, "12/19/2014"),
196 .ident = "WinBook TW100",
198 DMI_MATCH(DMI_SYS_VENDOR, "WinBook"),
199 DMI_MATCH(DMI_PRODUCT_NAME, "TW100")
203 .ident = "WinBook TW700",
205 DMI_MATCH(DMI_SYS_VENDOR, "WinBook"),
206 DMI_MATCH(DMI_PRODUCT_NAME, "TW700")
213 static const struct dmi_system_id nine_bytes_report[] = {
214 #if defined(CONFIG_DMI) && defined(CONFIG_X86)
216 .ident = "Lenovo YogaBook",
217 /* YB1-X91L/F and YB1-X90L/F */
219 DMI_MATCH(DMI_PRODUCT_NAME, "Lenovo YB1-X9")
227 * Those tablets have their x coordinate inverted
229 static const struct dmi_system_id inverted_x_screen[] = {
230 #if defined(CONFIG_DMI) && defined(CONFIG_X86)
232 .ident = "Cube I15-TC",
234 DMI_MATCH(DMI_SYS_VENDOR, "Cube"),
235 DMI_MATCH(DMI_PRODUCT_NAME, "I15-TC")
243 * goodix_i2c_read - read data from a register of the i2c slave device.
245 * @client: i2c device.
246 * @reg: the register to read from.
247 * @buf: raw write data buffer.
248 * @len: length of the buffer to write
250 static int goodix_i2c_read(struct i2c_client *client,
251 u16 reg, u8 *buf, int len)
253 struct i2c_msg msgs[2];
254 __be16 wbuf = cpu_to_be16(reg);
258 msgs[0].addr = client->addr;
260 msgs[0].buf = (u8 *)&wbuf;
262 msgs[1].flags = I2C_M_RD;
263 msgs[1].addr = client->addr;
267 ret = i2c_transfer(client->adapter, msgs, 2);
268 return ret < 0 ? ret : (ret != ARRAY_SIZE(msgs) ? -EIO : 0);
272 * goodix_i2c_write - write data to a register of the i2c slave device.
274 * @client: i2c device.
275 * @reg: the register to write to.
276 * @buf: raw data buffer to write.
277 * @len: length of the buffer to write
279 static int goodix_i2c_write(struct i2c_client *client, u16 reg, const u8 *buf,
286 addr_buf = kmalloc(len + 2, GFP_KERNEL);
290 addr_buf[0] = reg >> 8;
291 addr_buf[1] = reg & 0xFF;
292 memcpy(&addr_buf[2], buf, len);
295 msg.addr = client->addr;
299 ret = i2c_transfer(client->adapter, &msg, 1);
301 return ret < 0 ? ret : (ret != 1 ? -EIO : 0);
304 static int goodix_i2c_write_u8(struct i2c_client *client, u16 reg, u8 value)
306 return goodix_i2c_write(client, reg, &value, sizeof(value));
309 static const struct goodix_chip_data *goodix_get_chip_data(const char *id)
313 for (i = 0; goodix_chip_ids[i].id; i++) {
314 if (!strcmp(goodix_chip_ids[i].id, id))
315 return goodix_chip_ids[i].data;
318 return >9x_chip_data;
321 static int goodix_ts_read_input_report(struct goodix_ts_data *ts, u8 *data)
323 unsigned long max_timeout;
326 u16 addr = GOODIX_READ_COOR_ADDR;
328 * We are going to read 1-byte header,
329 * ts->contact_size * max(1, touch_num) bytes of coordinates
330 * and 1-byte footer which contains the touch-key code.
332 const int header_contact_keycode_size = 1 + ts->contact_size + 1;
335 * The 'buffer status' bit, which indicates that the data is valid, is
336 * not set as soon as the interrupt is raised, but slightly after.
337 * This takes around 10 ms to happen, so we poll for 20 ms.
339 max_timeout = jiffies + msecs_to_jiffies(GOODIX_BUFFER_STATUS_TIMEOUT);
341 error = goodix_i2c_read(ts->client, addr, data,
342 header_contact_keycode_size);
344 dev_err(&ts->client->dev, "I2C transfer error: %d\n",
349 if (data[0] & GOODIX_BUFFER_STATUS_READY) {
350 touch_num = data[0] & 0x0f;
351 if (touch_num > ts->max_touch_num)
355 addr += header_contact_keycode_size;
356 data += header_contact_keycode_size;
357 error = goodix_i2c_read(ts->client,
368 usleep_range(1000, 2000); /* Poll every 1 - 2 ms */
369 } while (time_before(jiffies, max_timeout));
372 * The Goodix panel will send spurious interrupts after a
373 * 'finger up' event, which will always cause a timeout.
378 static void goodix_ts_report_touch_8b(struct goodix_ts_data *ts, u8 *coor_data)
380 int id = coor_data[0] & 0x0F;
381 int input_x = get_unaligned_le16(&coor_data[1]);
382 int input_y = get_unaligned_le16(&coor_data[3]);
383 int input_w = get_unaligned_le16(&coor_data[5]);
385 input_mt_slot(ts->input_dev, id);
386 input_mt_report_slot_state(ts->input_dev, MT_TOOL_FINGER, true);
387 touchscreen_report_pos(ts->input_dev, &ts->prop,
388 input_x, input_y, true);
389 input_report_abs(ts->input_dev, ABS_MT_TOUCH_MAJOR, input_w);
390 input_report_abs(ts->input_dev, ABS_MT_WIDTH_MAJOR, input_w);
393 static void goodix_ts_report_touch_9b(struct goodix_ts_data *ts, u8 *coor_data)
395 int id = coor_data[1] & 0x0F;
396 int input_x = get_unaligned_le16(&coor_data[3]);
397 int input_y = get_unaligned_le16(&coor_data[5]);
398 int input_w = get_unaligned_le16(&coor_data[7]);
400 input_mt_slot(ts->input_dev, id);
401 input_mt_report_slot_state(ts->input_dev, MT_TOOL_FINGER, true);
402 touchscreen_report_pos(ts->input_dev, &ts->prop,
403 input_x, input_y, true);
404 input_report_abs(ts->input_dev, ABS_MT_TOUCH_MAJOR, input_w);
405 input_report_abs(ts->input_dev, ABS_MT_WIDTH_MAJOR, input_w);
408 static void goodix_ts_report_key(struct goodix_ts_data *ts, u8 *data)
414 if (data[0] & GOODIX_HAVE_KEY) {
415 touch_num = data[0] & 0x0f;
416 key_value = data[1 + ts->contact_size * touch_num];
417 for (i = 0; i < GOODIX_MAX_KEYS; i++)
418 if (key_value & BIT(i))
419 input_report_key(ts->input_dev,
422 for (i = 0; i < GOODIX_MAX_KEYS; i++)
423 input_report_key(ts->input_dev, ts->keymap[i], 0);
428 * goodix_process_events - Process incoming events
430 * @ts: our goodix_ts_data pointer
432 * Called when the IRQ is triggered. Read the current device state, and push
433 * the input events to the user space.
435 static void goodix_process_events(struct goodix_ts_data *ts)
437 u8 point_data[2 + GOODIX_MAX_CONTACT_SIZE * GOODIX_MAX_CONTACTS];
441 touch_num = goodix_ts_read_input_report(ts, point_data);
445 goodix_ts_report_key(ts, point_data);
447 for (i = 0; i < touch_num; i++)
448 if (ts->contact_size == 9)
449 goodix_ts_report_touch_9b(ts,
450 &point_data[1 + ts->contact_size * i]);
452 goodix_ts_report_touch_8b(ts,
453 &point_data[1 + ts->contact_size * i]);
455 input_mt_sync_frame(ts->input_dev);
456 input_sync(ts->input_dev);
460 * goodix_ts_irq_handler - The IRQ handler
462 * @irq: interrupt number.
463 * @dev_id: private data pointer.
465 static irqreturn_t goodix_ts_irq_handler(int irq, void *dev_id)
467 struct goodix_ts_data *ts = dev_id;
469 goodix_process_events(ts);
471 if (goodix_i2c_write_u8(ts->client, GOODIX_READ_COOR_ADDR, 0) < 0)
472 dev_err(&ts->client->dev, "I2C write end_cmd error\n");
477 static void goodix_free_irq(struct goodix_ts_data *ts)
479 devm_free_irq(&ts->client->dev, ts->client->irq, ts);
482 static int goodix_request_irq(struct goodix_ts_data *ts)
484 return devm_request_threaded_irq(&ts->client->dev, ts->client->irq,
485 NULL, goodix_ts_irq_handler,
486 ts->irq_flags, ts->client->name, ts);
489 static int goodix_check_cfg_8(struct goodix_ts_data *ts, const u8 *cfg, int len)
491 int i, raw_cfg_len = len - 2;
494 for (i = 0; i < raw_cfg_len; i++)
496 check_sum = (~check_sum) + 1;
497 if (check_sum != cfg[raw_cfg_len]) {
498 dev_err(&ts->client->dev,
499 "The checksum of the config fw is not correct");
503 if (cfg[raw_cfg_len + 1] != 1) {
504 dev_err(&ts->client->dev,
505 "Config fw must have Config_Fresh register set");
512 static void goodix_calc_cfg_checksum_8(struct goodix_ts_data *ts)
514 int i, raw_cfg_len = ts->chip->config_len - 2;
517 for (i = 0; i < raw_cfg_len; i++)
518 check_sum += ts->config[i];
519 check_sum = (~check_sum) + 1;
521 ts->config[raw_cfg_len] = check_sum;
522 ts->config[raw_cfg_len + 1] = 1; /* Set "config_fresh" bit */
525 static int goodix_check_cfg_16(struct goodix_ts_data *ts, const u8 *cfg,
528 int i, raw_cfg_len = len - 3;
531 for (i = 0; i < raw_cfg_len; i += 2)
532 check_sum += get_unaligned_be16(&cfg[i]);
533 check_sum = (~check_sum) + 1;
534 if (check_sum != get_unaligned_be16(&cfg[raw_cfg_len])) {
535 dev_err(&ts->client->dev,
536 "The checksum of the config fw is not correct");
540 if (cfg[raw_cfg_len + 2] != 1) {
541 dev_err(&ts->client->dev,
542 "Config fw must have Config_Fresh register set");
549 static void goodix_calc_cfg_checksum_16(struct goodix_ts_data *ts)
551 int i, raw_cfg_len = ts->chip->config_len - 3;
554 for (i = 0; i < raw_cfg_len; i += 2)
555 check_sum += get_unaligned_be16(&ts->config[i]);
556 check_sum = (~check_sum) + 1;
558 put_unaligned_be16(check_sum, &ts->config[raw_cfg_len]);
559 ts->config[raw_cfg_len + 2] = 1; /* Set "config_fresh" bit */
563 * goodix_check_cfg - Checks if config fw is valid
565 * @ts: goodix_ts_data pointer
566 * @cfg: firmware config data
568 static int goodix_check_cfg(struct goodix_ts_data *ts, const u8 *cfg, int len)
570 if (len < GOODIX_CONFIG_MIN_LENGTH ||
571 len > GOODIX_CONFIG_MAX_LENGTH) {
572 dev_err(&ts->client->dev,
573 "The length of the config fw is not correct");
577 return ts->chip->check_config(ts, cfg, len);
581 * goodix_send_cfg - Write fw config to device
583 * @ts: goodix_ts_data pointer
584 * @cfg: config firmware to write to device
586 static int goodix_send_cfg(struct goodix_ts_data *ts, const u8 *cfg, int len)
590 error = goodix_check_cfg(ts, cfg, len);
594 error = goodix_i2c_write(ts->client, ts->chip->config_addr, cfg, len);
596 dev_err(&ts->client->dev, "Failed to write config data: %d",
600 dev_dbg(&ts->client->dev, "Config sent successfully.");
602 /* Let the firmware reconfigure itself, so sleep for 10ms */
603 usleep_range(10000, 11000);
608 #ifdef ACPI_GPIO_SUPPORT
609 static int goodix_pin_acpi_direction_input(struct goodix_ts_data *ts)
611 acpi_handle handle = ACPI_HANDLE(&ts->client->dev);
614 status = acpi_evaluate_object(handle, "INTI", NULL, NULL);
615 return ACPI_SUCCESS(status) ? 0 : -EIO;
618 static int goodix_pin_acpi_output_method(struct goodix_ts_data *ts, int value)
620 acpi_handle handle = ACPI_HANDLE(&ts->client->dev);
623 status = acpi_execute_simple_method(handle, "INTO", value);
624 return ACPI_SUCCESS(status) ? 0 : -EIO;
627 static int goodix_pin_acpi_direction_input(struct goodix_ts_data *ts)
629 dev_err(&ts->client->dev,
630 "%s called on device without ACPI support\n", __func__);
634 static int goodix_pin_acpi_output_method(struct goodix_ts_data *ts, int value)
636 dev_err(&ts->client->dev,
637 "%s called on device without ACPI support\n", __func__);
642 static int goodix_irq_direction_output(struct goodix_ts_data *ts, int value)
644 switch (ts->irq_pin_access_method) {
645 case IRQ_PIN_ACCESS_NONE:
646 dev_err(&ts->client->dev,
647 "%s called without an irq_pin_access_method set\n",
650 case IRQ_PIN_ACCESS_GPIO:
651 return gpiod_direction_output(ts->gpiod_int, value);
652 case IRQ_PIN_ACCESS_ACPI_GPIO:
654 * The IRQ pin triggers on a falling edge, so its gets marked
655 * as active-low, use output_raw to avoid the value inversion.
657 return gpiod_direction_output_raw(ts->gpiod_int, value);
658 case IRQ_PIN_ACCESS_ACPI_METHOD:
659 return goodix_pin_acpi_output_method(ts, value);
662 return -EINVAL; /* Never reached */
665 static int goodix_irq_direction_input(struct goodix_ts_data *ts)
667 switch (ts->irq_pin_access_method) {
668 case IRQ_PIN_ACCESS_NONE:
669 dev_err(&ts->client->dev,
670 "%s called without an irq_pin_access_method set\n",
673 case IRQ_PIN_ACCESS_GPIO:
674 return gpiod_direction_input(ts->gpiod_int);
675 case IRQ_PIN_ACCESS_ACPI_GPIO:
676 return gpiod_direction_input(ts->gpiod_int);
677 case IRQ_PIN_ACCESS_ACPI_METHOD:
678 return goodix_pin_acpi_direction_input(ts);
681 return -EINVAL; /* Never reached */
684 static int goodix_int_sync(struct goodix_ts_data *ts)
688 error = goodix_irq_direction_output(ts, 0);
692 msleep(50); /* T5: 50ms */
694 error = goodix_irq_direction_input(ts);
702 * goodix_reset - Reset device during power on
704 * @ts: goodix_ts_data pointer
706 static int goodix_reset(struct goodix_ts_data *ts)
710 /* begin select I2C slave addr */
711 error = gpiod_direction_output(ts->gpiod_rst, 0);
715 msleep(20); /* T2: > 10ms */
717 /* HIGH: 0x28/0x29, LOW: 0xBA/0xBB */
718 error = goodix_irq_direction_output(ts, ts->client->addr == 0x14);
722 usleep_range(100, 2000); /* T3: > 100us */
724 error = gpiod_direction_output(ts->gpiod_rst, 1);
728 usleep_range(6000, 10000); /* T4: > 5ms */
730 /* end select I2C slave addr */
731 error = gpiod_direction_input(ts->gpiod_rst);
735 error = goodix_int_sync(ts);
742 #ifdef ACPI_GPIO_SUPPORT
743 #include <asm/cpu_device_id.h>
744 #include <asm/intel-family.h>
746 static const struct x86_cpu_id baytrail_cpu_ids[] = {
747 { X86_VENDOR_INTEL, 6, INTEL_FAM6_ATOM_SILVERMONT, X86_FEATURE_ANY, },
751 static inline bool is_byt(void)
753 const struct x86_cpu_id *id = x86_match_cpu(baytrail_cpu_ids);
758 static const struct acpi_gpio_params first_gpio = { 0, 0, false };
759 static const struct acpi_gpio_params second_gpio = { 1, 0, false };
761 static const struct acpi_gpio_mapping acpi_goodix_int_first_gpios[] = {
762 { GOODIX_GPIO_INT_NAME "-gpios", &first_gpio, 1 },
763 { GOODIX_GPIO_RST_NAME "-gpios", &second_gpio, 1 },
767 static const struct acpi_gpio_mapping acpi_goodix_int_last_gpios[] = {
768 { GOODIX_GPIO_RST_NAME "-gpios", &first_gpio, 1 },
769 { GOODIX_GPIO_INT_NAME "-gpios", &second_gpio, 1 },
773 static const struct acpi_gpio_mapping acpi_goodix_reset_only_gpios[] = {
774 { GOODIX_GPIO_RST_NAME "-gpios", &first_gpio, 1 },
778 static int goodix_resource(struct acpi_resource *ares, void *data)
780 struct goodix_ts_data *ts = data;
781 struct device *dev = &ts->client->dev;
782 struct acpi_resource_gpio *gpio;
784 switch (ares->type) {
785 case ACPI_RESOURCE_TYPE_GPIO:
786 gpio = &ares->data.gpio;
787 if (gpio->connection_type == ACPI_RESOURCE_GPIO_TYPE_INT) {
788 if (ts->gpio_int_idx == -1) {
789 ts->gpio_int_idx = ts->gpio_count;
791 dev_err(dev, "More then one GpioInt resource, ignoring ACPI GPIO resources\n");
792 ts->gpio_int_idx = -2;
805 * This function gets called in case we fail to get the irq GPIO directly
806 * because the ACPI tables lack GPIO-name to APCI _CRS index mappings
807 * (no _DSD UUID daffd814-6eba-4d8c-8a91-bc9bbf4aa301 data).
808 * In that case we add our own mapping and then goodix_get_gpio_config()
809 * retries to get the GPIOs based on the added mapping.
811 static int goodix_add_acpi_gpio_mappings(struct goodix_ts_data *ts)
813 const struct acpi_gpio_mapping *gpio_mapping = NULL;
814 struct device *dev = &ts->client->dev;
815 LIST_HEAD(resources);
819 ts->gpio_int_idx = -1;
820 ret = acpi_dev_get_resources(ACPI_COMPANION(dev), &resources,
821 goodix_resource, ts);
823 dev_err(dev, "Error getting ACPI resources: %d\n", ret);
827 acpi_dev_free_resource_list(&resources);
829 if (ts->gpio_count == 2 && ts->gpio_int_idx == 0) {
830 ts->irq_pin_access_method = IRQ_PIN_ACCESS_ACPI_GPIO;
831 gpio_mapping = acpi_goodix_int_first_gpios;
832 } else if (ts->gpio_count == 2 && ts->gpio_int_idx == 1) {
833 ts->irq_pin_access_method = IRQ_PIN_ACCESS_ACPI_GPIO;
834 gpio_mapping = acpi_goodix_int_last_gpios;
835 } else if (ts->gpio_count == 1 && ts->gpio_int_idx == -1 &&
836 acpi_has_method(ACPI_HANDLE(dev), "INTI") &&
837 acpi_has_method(ACPI_HANDLE(dev), "INTO")) {
838 dev_info(dev, "Using ACPI INTI and INTO methods for IRQ pin access\n");
839 ts->irq_pin_access_method = IRQ_PIN_ACCESS_ACPI_METHOD;
840 gpio_mapping = acpi_goodix_reset_only_gpios;
841 } else if (is_byt() && ts->gpio_count == 2 && ts->gpio_int_idx == -1) {
842 dev_info(dev, "No ACPI GpioInt resource, assuming that the GPIO order is reset, int\n");
843 ts->irq_pin_access_method = IRQ_PIN_ACCESS_ACPI_GPIO;
844 gpio_mapping = acpi_goodix_int_last_gpios;
846 dev_warn(dev, "Unexpected ACPI resources: gpio_count %d, gpio_int_idx %d\n",
847 ts->gpio_count, ts->gpio_int_idx);
851 return devm_acpi_dev_add_driver_gpios(dev, gpio_mapping);
854 static int goodix_add_acpi_gpio_mappings(struct goodix_ts_data *ts)
858 #endif /* CONFIG_X86 && CONFIG_ACPI */
861 * goodix_get_gpio_config - Get GPIO config from ACPI/DT
863 * @ts: goodix_ts_data pointer
865 static int goodix_get_gpio_config(struct goodix_ts_data *ts)
869 struct gpio_desc *gpiod;
870 bool added_acpi_mappings = false;
874 dev = &ts->client->dev;
876 ts->avdd28 = devm_regulator_get(dev, "AVDD28");
877 if (IS_ERR(ts->avdd28)) {
878 error = PTR_ERR(ts->avdd28);
879 if (error != -EPROBE_DEFER)
881 "Failed to get AVDD28 regulator: %d\n", error);
885 ts->vddio = devm_regulator_get(dev, "VDDIO");
886 if (IS_ERR(ts->vddio)) {
887 error = PTR_ERR(ts->vddio);
888 if (error != -EPROBE_DEFER)
890 "Failed to get VDDIO regulator: %d\n", error);
895 /* Get the interrupt GPIO pin number */
896 gpiod = devm_gpiod_get_optional(dev, GOODIX_GPIO_INT_NAME, GPIOD_IN);
898 error = PTR_ERR(gpiod);
899 if (error != -EPROBE_DEFER)
900 dev_dbg(dev, "Failed to get %s GPIO: %d\n",
901 GOODIX_GPIO_INT_NAME, error);
904 if (!gpiod && has_acpi_companion(dev) && !added_acpi_mappings) {
905 added_acpi_mappings = true;
906 if (goodix_add_acpi_gpio_mappings(ts) == 0)
907 goto retry_get_irq_gpio;
910 ts->gpiod_int = gpiod;
912 /* Get the reset line GPIO pin number */
913 gpiod = devm_gpiod_get_optional(dev, GOODIX_GPIO_RST_NAME, GPIOD_IN);
915 error = PTR_ERR(gpiod);
916 if (error != -EPROBE_DEFER)
917 dev_dbg(dev, "Failed to get %s GPIO: %d\n",
918 GOODIX_GPIO_RST_NAME, error);
922 ts->gpiod_rst = gpiod;
924 switch (ts->irq_pin_access_method) {
925 case IRQ_PIN_ACCESS_ACPI_GPIO:
927 * We end up here if goodix_add_acpi_gpio_mappings() has
928 * called devm_acpi_dev_add_driver_gpios() because the ACPI
929 * tables did not contain name to index mappings.
930 * Check that we successfully got both GPIOs after we've
931 * added our own acpi_gpio_mapping and if we did not get both
932 * GPIOs reset irq_pin_access_method to IRQ_PIN_ACCESS_NONE.
934 if (!ts->gpiod_int || !ts->gpiod_rst)
935 ts->irq_pin_access_method = IRQ_PIN_ACCESS_NONE;
937 case IRQ_PIN_ACCESS_ACPI_METHOD:
939 ts->irq_pin_access_method = IRQ_PIN_ACCESS_NONE;
942 if (ts->gpiod_int && ts->gpiod_rst) {
943 ts->reset_controller_at_probe = true;
944 ts->load_cfg_from_disk = true;
945 ts->irq_pin_access_method = IRQ_PIN_ACCESS_GPIO;
953 * goodix_read_config - Read the embedded configuration of the panel
955 * @ts: our goodix_ts_data pointer
957 * Must be called during probe
959 static void goodix_read_config(struct goodix_ts_data *ts)
964 error = goodix_i2c_read(ts->client, ts->chip->config_addr,
965 ts->config, ts->chip->config_len);
967 dev_warn(&ts->client->dev, "Error reading config: %d\n",
969 ts->int_trigger_type = GOODIX_INT_TRIGGER;
970 ts->max_touch_num = GOODIX_MAX_CONTACTS;
974 ts->int_trigger_type = ts->config[TRIGGER_LOC] & 0x03;
975 ts->max_touch_num = ts->config[MAX_CONTACTS_LOC] & 0x0f;
977 x_max = get_unaligned_le16(&ts->config[RESOLUTION_LOC]);
978 y_max = get_unaligned_le16(&ts->config[RESOLUTION_LOC + 2]);
979 if (x_max && y_max) {
980 input_abs_set_max(ts->input_dev, ABS_MT_POSITION_X, x_max - 1);
981 input_abs_set_max(ts->input_dev, ABS_MT_POSITION_Y, y_max - 1);
984 ts->chip->calc_config_checksum(ts);
988 * goodix_read_version - Read goodix touchscreen version
990 * @ts: our goodix_ts_data pointer
992 static int goodix_read_version(struct goodix_ts_data *ts)
996 char id_str[GOODIX_ID_MAX_LEN + 1];
998 error = goodix_i2c_read(ts->client, GOODIX_REG_ID, buf, sizeof(buf));
1000 dev_err(&ts->client->dev, "read version failed: %d\n", error);
1004 memcpy(id_str, buf, GOODIX_ID_MAX_LEN);
1005 id_str[GOODIX_ID_MAX_LEN] = 0;
1006 strscpy(ts->id, id_str, GOODIX_ID_MAX_LEN + 1);
1008 ts->version = get_unaligned_le16(&buf[4]);
1010 dev_info(&ts->client->dev, "ID %s, version: %04x\n", ts->id,
1017 * goodix_i2c_test - I2C test function to check if the device answers.
1019 * @client: the i2c client
1021 static int goodix_i2c_test(struct i2c_client *client)
1027 while (retry++ < 2) {
1028 error = goodix_i2c_read(client, GOODIX_REG_ID,
1033 dev_err(&client->dev, "i2c test failed attempt %d: %d\n",
1042 * goodix_configure_dev - Finish device initialization
1044 * @ts: our goodix_ts_data pointer
1046 * Must be called from probe to finish initialization of the device.
1047 * Contains the common initialization code for both devices that
1048 * declare gpio pins and devices that do not. It is either called
1049 * directly from probe or from request_firmware_wait callback.
1051 static int goodix_configure_dev(struct goodix_ts_data *ts)
1056 ts->int_trigger_type = GOODIX_INT_TRIGGER;
1057 ts->max_touch_num = GOODIX_MAX_CONTACTS;
1059 ts->input_dev = devm_input_allocate_device(&ts->client->dev);
1060 if (!ts->input_dev) {
1061 dev_err(&ts->client->dev, "Failed to allocate input device.");
1065 ts->input_dev->name = "Goodix Capacitive TouchScreen";
1066 ts->input_dev->phys = "input/ts";
1067 ts->input_dev->id.bustype = BUS_I2C;
1068 ts->input_dev->id.vendor = 0x0416;
1069 if (kstrtou16(ts->id, 10, &ts->input_dev->id.product))
1070 ts->input_dev->id.product = 0x1001;
1071 ts->input_dev->id.version = ts->version;
1073 ts->input_dev->keycode = ts->keymap;
1074 ts->input_dev->keycodesize = sizeof(ts->keymap[0]);
1075 ts->input_dev->keycodemax = GOODIX_MAX_KEYS;
1077 /* Capacitive Windows/Home button on some devices */
1078 for (i = 0; i < GOODIX_MAX_KEYS; ++i) {
1080 ts->keymap[i] = KEY_LEFTMETA;
1082 ts->keymap[i] = KEY_F1 + (i - 1);
1084 input_set_capability(ts->input_dev, EV_KEY, ts->keymap[i]);
1087 input_set_capability(ts->input_dev, EV_ABS, ABS_MT_POSITION_X);
1088 input_set_capability(ts->input_dev, EV_ABS, ABS_MT_POSITION_Y);
1089 input_set_abs_params(ts->input_dev, ABS_MT_WIDTH_MAJOR, 0, 255, 0, 0);
1090 input_set_abs_params(ts->input_dev, ABS_MT_TOUCH_MAJOR, 0, 255, 0, 0);
1092 /* Read configuration and apply touchscreen parameters */
1093 goodix_read_config(ts);
1095 /* Try overriding touchscreen parameters via device properties */
1096 touchscreen_parse_properties(ts->input_dev, true, &ts->prop);
1098 if (!ts->prop.max_x || !ts->prop.max_y || !ts->max_touch_num) {
1099 dev_err(&ts->client->dev,
1100 "Invalid config (%d, %d, %d), using defaults\n",
1101 ts->prop.max_x, ts->prop.max_y, ts->max_touch_num);
1102 ts->prop.max_x = GOODIX_MAX_WIDTH - 1;
1103 ts->prop.max_y = GOODIX_MAX_HEIGHT - 1;
1104 ts->max_touch_num = GOODIX_MAX_CONTACTS;
1105 input_abs_set_max(ts->input_dev,
1106 ABS_MT_POSITION_X, ts->prop.max_x);
1107 input_abs_set_max(ts->input_dev,
1108 ABS_MT_POSITION_Y, ts->prop.max_y);
1111 if (dmi_check_system(rotated_screen)) {
1112 ts->prop.invert_x = true;
1113 ts->prop.invert_y = true;
1114 dev_dbg(&ts->client->dev,
1115 "Applying '180 degrees rotated screen' quirk\n");
1118 if (dmi_check_system(nine_bytes_report)) {
1119 ts->contact_size = 9;
1121 dev_dbg(&ts->client->dev,
1122 "Non-standard 9-bytes report format quirk\n");
1125 if (dmi_check_system(inverted_x_screen)) {
1126 ts->prop.invert_x = true;
1127 dev_dbg(&ts->client->dev,
1128 "Applying 'inverted x screen' quirk\n");
1131 error = input_mt_init_slots(ts->input_dev, ts->max_touch_num,
1132 INPUT_MT_DIRECT | INPUT_MT_DROP_UNUSED);
1134 dev_err(&ts->client->dev,
1135 "Failed to initialize MT slots: %d", error);
1139 error = input_register_device(ts->input_dev);
1141 dev_err(&ts->client->dev,
1142 "Failed to register input device: %d", error);
1146 ts->irq_flags = goodix_irq_flags[ts->int_trigger_type] | IRQF_ONESHOT;
1147 error = goodix_request_irq(ts);
1149 dev_err(&ts->client->dev, "request IRQ failed: %d\n", error);
1157 * goodix_config_cb - Callback to finish device init
1159 * @ts: our goodix_ts_data pointer
1161 * request_firmware_wait callback that finishes
1162 * initialization of the device.
1164 static void goodix_config_cb(const struct firmware *cfg, void *ctx)
1166 struct goodix_ts_data *ts = ctx;
1170 /* send device configuration to the firmware */
1171 error = goodix_send_cfg(ts, cfg->data, cfg->size);
1173 goto err_release_cfg;
1176 goodix_configure_dev(ts);
1179 release_firmware(cfg);
1180 complete_all(&ts->firmware_loading_complete);
1183 static void goodix_disable_regulators(void *arg)
1185 struct goodix_ts_data *ts = arg;
1187 regulator_disable(ts->vddio);
1188 regulator_disable(ts->avdd28);
1191 static int goodix_ts_probe(struct i2c_client *client,
1192 const struct i2c_device_id *id)
1194 struct goodix_ts_data *ts;
1197 dev_dbg(&client->dev, "I2C Address: 0x%02x\n", client->addr);
1199 if (!i2c_check_functionality(client->adapter, I2C_FUNC_I2C)) {
1200 dev_err(&client->dev, "I2C check functionality failed.\n");
1204 ts = devm_kzalloc(&client->dev, sizeof(*ts), GFP_KERNEL);
1208 ts->client = client;
1209 i2c_set_clientdata(client, ts);
1210 init_completion(&ts->firmware_loading_complete);
1211 ts->contact_size = GOODIX_CONTACT_SIZE;
1213 error = goodix_get_gpio_config(ts);
1217 /* power up the controller */
1218 error = regulator_enable(ts->avdd28);
1220 dev_err(&client->dev,
1221 "Failed to enable AVDD28 regulator: %d\n",
1226 error = regulator_enable(ts->vddio);
1228 dev_err(&client->dev,
1229 "Failed to enable VDDIO regulator: %d\n",
1231 regulator_disable(ts->avdd28);
1235 error = devm_add_action_or_reset(&client->dev,
1236 goodix_disable_regulators, ts);
1241 if (ts->reset_controller_at_probe) {
1242 /* reset the controller */
1243 error = goodix_reset(ts);
1245 dev_err(&client->dev, "Controller reset failed.\n");
1250 error = goodix_i2c_test(client);
1252 if (!ts->reset_controller_at_probe &&
1253 ts->irq_pin_access_method != IRQ_PIN_ACCESS_NONE) {
1254 /* Retry after a controller reset */
1255 ts->reset_controller_at_probe = true;
1258 dev_err(&client->dev, "I2C communication failure: %d\n", error);
1262 error = goodix_read_version(ts);
1264 dev_err(&client->dev, "Read version failed.\n");
1268 ts->chip = goodix_get_chip_data(ts->id);
1270 if (ts->load_cfg_from_disk) {
1271 /* update device config */
1272 ts->cfg_name = devm_kasprintf(&client->dev, GFP_KERNEL,
1273 "goodix_%s_cfg.bin", ts->id);
1277 error = request_firmware_nowait(THIS_MODULE, true, ts->cfg_name,
1278 &client->dev, GFP_KERNEL, ts,
1281 dev_err(&client->dev,
1282 "Failed to invoke firmware loader: %d\n",
1289 error = goodix_configure_dev(ts);
1297 static int goodix_ts_remove(struct i2c_client *client)
1299 struct goodix_ts_data *ts = i2c_get_clientdata(client);
1301 if (ts->load_cfg_from_disk)
1302 wait_for_completion(&ts->firmware_loading_complete);
1307 static int __maybe_unused goodix_suspend(struct device *dev)
1309 struct i2c_client *client = to_i2c_client(dev);
1310 struct goodix_ts_data *ts = i2c_get_clientdata(client);
1313 if (ts->load_cfg_from_disk)
1314 wait_for_completion(&ts->firmware_loading_complete);
1316 /* We need gpio pins to suspend/resume */
1317 if (ts->irq_pin_access_method == IRQ_PIN_ACCESS_NONE) {
1318 disable_irq(client->irq);
1322 /* Free IRQ as IRQ pin is used as output in the suspend sequence */
1323 goodix_free_irq(ts);
1325 /* Output LOW on the INT pin for 5 ms */
1326 error = goodix_irq_direction_output(ts, 0);
1328 goodix_request_irq(ts);
1332 usleep_range(5000, 6000);
1334 error = goodix_i2c_write_u8(ts->client, GOODIX_REG_COMMAND,
1335 GOODIX_CMD_SCREEN_OFF);
1337 dev_err(&ts->client->dev, "Screen off command failed\n");
1338 goodix_irq_direction_input(ts);
1339 goodix_request_irq(ts);
1344 * The datasheet specifies that the interval between sending screen-off
1345 * command and wake-up should be longer than 58 ms. To avoid waking up
1346 * sooner, delay 58ms here.
1352 static int __maybe_unused goodix_resume(struct device *dev)
1354 struct i2c_client *client = to_i2c_client(dev);
1355 struct goodix_ts_data *ts = i2c_get_clientdata(client);
1359 if (ts->irq_pin_access_method == IRQ_PIN_ACCESS_NONE) {
1360 enable_irq(client->irq);
1365 * Exit sleep mode by outputting HIGH level to INT pin
1368 error = goodix_irq_direction_output(ts, 1);
1372 usleep_range(2000, 5000);
1374 error = goodix_int_sync(ts);
1378 error = goodix_i2c_read(ts->client, ts->chip->config_addr,
1381 dev_warn(dev, "Error reading config version: %d, resetting controller\n",
1383 else if (config_ver != ts->config[0])
1384 dev_info(dev, "Config version mismatch %d != %d, resetting controller\n",
1385 config_ver, ts->config[0]);
1387 if (error != 0 || config_ver != ts->config[0]) {
1388 error = goodix_reset(ts);
1390 dev_err(dev, "Controller reset failed.\n");
1394 error = goodix_send_cfg(ts, ts->config, ts->chip->config_len);
1399 error = goodix_request_irq(ts);
1406 static SIMPLE_DEV_PM_OPS(goodix_pm_ops, goodix_suspend, goodix_resume);
1408 static const struct i2c_device_id goodix_ts_id[] = {
1409 { "GDIX1001:00", 0 },
1412 MODULE_DEVICE_TABLE(i2c, goodix_ts_id);
1415 static const struct acpi_device_id goodix_acpi_match[] = {
1420 MODULE_DEVICE_TABLE(acpi, goodix_acpi_match);
1424 static const struct of_device_id goodix_of_match[] = {
1425 { .compatible = "goodix,gt1151" },
1426 { .compatible = "goodix,gt5663" },
1427 { .compatible = "goodix,gt5688" },
1428 { .compatible = "goodix,gt911" },
1429 { .compatible = "goodix,gt9110" },
1430 { .compatible = "goodix,gt912" },
1431 { .compatible = "goodix,gt9147" },
1432 { .compatible = "goodix,gt917s" },
1433 { .compatible = "goodix,gt927" },
1434 { .compatible = "goodix,gt9271" },
1435 { .compatible = "goodix,gt928" },
1436 { .compatible = "goodix,gt967" },
1439 MODULE_DEVICE_TABLE(of, goodix_of_match);
1442 static struct i2c_driver goodix_ts_driver = {
1443 .probe = goodix_ts_probe,
1444 .remove = goodix_ts_remove,
1445 .id_table = goodix_ts_id,
1447 .name = "Goodix-TS",
1448 .acpi_match_table = ACPI_PTR(goodix_acpi_match),
1449 .of_match_table = of_match_ptr(goodix_of_match),
1450 .pm = &goodix_pm_ops,
1453 module_i2c_driver(goodix_ts_driver);
1457 MODULE_DESCRIPTION("Goodix touchscreen driver");
1458 MODULE_LICENSE("GPL v2");