1 // SPDX-License-Identifier: GPL-2.0-or-later
2 /* -------------------------------------------------------------------------
3 * Copyright (C) 2014-2015, Intel Corporation
7 * Copyright (C) 2010-2015, Shanghai Sileadinc Co.Ltd
9 * -------------------------------------------------------------------------
12 #include <linux/i2c.h>
13 #include <linux/module.h>
14 #include <linux/acpi.h>
15 #include <linux/interrupt.h>
16 #include <linux/gpio/consumer.h>
17 #include <linux/delay.h>
18 #include <linux/firmware.h>
19 #include <linux/input.h>
20 #include <linux/input/mt.h>
21 #include <linux/input/touchscreen.h>
23 #include <linux/pm_runtime.h>
24 #include <linux/irq.h>
25 #include <linux/regulator/consumer.h>
27 #include <asm/unaligned.h>
29 #define SILEAD_TS_NAME "silead_ts"
31 #define SILEAD_REG_RESET 0xE0
32 #define SILEAD_REG_DATA 0x80
33 #define SILEAD_REG_TOUCH_NR 0x80
34 #define SILEAD_REG_POWER 0xBC
35 #define SILEAD_REG_CLOCK 0xE4
36 #define SILEAD_REG_STATUS 0xB0
37 #define SILEAD_REG_ID 0xFC
38 #define SILEAD_REG_MEM_CHECK 0xB0
40 #define SILEAD_STATUS_OK 0x5A5A5A5A
41 #define SILEAD_TS_DATA_LEN 44
42 #define SILEAD_CLOCK 0x04
44 #define SILEAD_CMD_RESET 0x88
45 #define SILEAD_CMD_START 0x00
47 #define SILEAD_POINT_DATA_LEN 0x04
48 #define SILEAD_POINT_Y_OFF 0x00
49 #define SILEAD_POINT_Y_MSB_OFF 0x01
50 #define SILEAD_POINT_X_OFF 0x02
51 #define SILEAD_POINT_X_MSB_OFF 0x03
52 #define SILEAD_EXTRA_DATA_MASK 0xF0
54 #define SILEAD_CMD_SLEEP_MIN 10000
55 #define SILEAD_CMD_SLEEP_MAX 20000
56 #define SILEAD_POWER_SLEEP 20
57 #define SILEAD_STARTUP_SLEEP 30
59 #define SILEAD_MAX_FINGERS 10
61 enum silead_ts_power {
66 struct silead_ts_data {
67 struct i2c_client *client;
68 struct gpio_desc *gpio_power;
69 struct input_dev *input;
70 struct input_dev *pen_input;
71 struct regulator_bulk_data regulators[2];
73 struct touchscreen_properties prop;
76 struct input_mt_pos pos[SILEAD_MAX_FINGERS];
77 int slots[SILEAD_MAX_FINGERS];
78 int id[SILEAD_MAX_FINGERS];
79 u32 efi_fw_min_max[4];
80 bool efi_fw_min_max_set;
88 struct silead_fw_data {
93 static void silead_apply_efi_fw_min_max(struct silead_ts_data *data)
95 struct input_absinfo *absinfo_x = &data->input->absinfo[ABS_MT_POSITION_X];
96 struct input_absinfo *absinfo_y = &data->input->absinfo[ABS_MT_POSITION_Y];
98 if (!data->efi_fw_min_max_set)
101 absinfo_x->minimum = data->efi_fw_min_max[0];
102 absinfo_x->maximum = data->efi_fw_min_max[1];
103 absinfo_y->minimum = data->efi_fw_min_max[2];
104 absinfo_y->maximum = data->efi_fw_min_max[3];
106 if (data->prop.invert_x) {
107 absinfo_x->maximum -= absinfo_x->minimum;
108 absinfo_x->minimum = 0;
111 if (data->prop.invert_y) {
112 absinfo_y->maximum -= absinfo_y->minimum;
113 absinfo_y->minimum = 0;
116 if (data->prop.swap_x_y) {
117 swap(absinfo_x->minimum, absinfo_y->minimum);
118 swap(absinfo_x->maximum, absinfo_y->maximum);
122 static int silead_ts_request_input_dev(struct silead_ts_data *data)
124 struct device *dev = &data->client->dev;
127 data->input = devm_input_allocate_device(dev);
130 "Failed to allocate input device\n");
134 input_set_abs_params(data->input, ABS_MT_POSITION_X, 0, 4095, 0, 0);
135 input_set_abs_params(data->input, ABS_MT_POSITION_Y, 0, 4095, 0, 0);
136 touchscreen_parse_properties(data->input, true, &data->prop);
137 silead_apply_efi_fw_min_max(data);
139 input_mt_init_slots(data->input, data->max_fingers,
140 INPUT_MT_DIRECT | INPUT_MT_DROP_UNUSED |
143 if (device_property_read_bool(dev, "silead,home-button"))
144 input_set_capability(data->input, EV_KEY, KEY_LEFTMETA);
146 data->input->name = SILEAD_TS_NAME;
147 data->input->phys = "input/ts";
148 data->input->id.bustype = BUS_I2C;
150 error = input_register_device(data->input);
152 dev_err(dev, "Failed to register input device: %d\n", error);
159 static int silead_ts_request_pen_input_dev(struct silead_ts_data *data)
161 struct device *dev = &data->client->dev;
164 if (!data->pen_supported)
167 data->pen_input = devm_input_allocate_device(dev);
168 if (!data->pen_input)
171 input_set_abs_params(data->pen_input, ABS_X, 0, 4095, 0, 0);
172 input_set_abs_params(data->pen_input, ABS_Y, 0, 4095, 0, 0);
173 input_set_capability(data->pen_input, EV_KEY, BTN_TOUCH);
174 input_set_capability(data->pen_input, EV_KEY, BTN_TOOL_PEN);
175 set_bit(INPUT_PROP_DIRECT, data->pen_input->propbit);
176 touchscreen_parse_properties(data->pen_input, false, &data->prop);
177 input_abs_set_res(data->pen_input, ABS_X, data->pen_x_res);
178 input_abs_set_res(data->pen_input, ABS_Y, data->pen_y_res);
180 data->pen_input->name = SILEAD_TS_NAME " pen";
181 data->pen_input->phys = "input/pen";
182 data->input->id.bustype = BUS_I2C;
184 error = input_register_device(data->pen_input);
186 dev_err(dev, "Failed to register pen input device: %d\n", error);
193 static void silead_ts_set_power(struct i2c_client *client,
194 enum silead_ts_power state)
196 struct silead_ts_data *data = i2c_get_clientdata(client);
198 if (data->gpio_power) {
199 gpiod_set_value_cansleep(data->gpio_power, state);
200 msleep(SILEAD_POWER_SLEEP);
204 static bool silead_ts_handle_pen_data(struct silead_ts_data *data, u8 *buf)
206 u8 *coord = buf + SILEAD_POINT_DATA_LEN;
207 struct input_mt_pos pos;
209 if (!data->pen_supported || buf[2] != 0x00 || buf[3] != 0x00)
212 if (buf[0] == 0x00 && buf[1] == 0x00 && data->pen_down) {
213 data->pen_up_count++;
214 if (data->pen_up_count == 6) {
215 data->pen_down = false;
221 if (buf[0] == 0x01 && buf[1] == 0x08) {
222 touchscreen_set_mt_pos(&pos, &data->prop,
223 get_unaligned_le16(&coord[SILEAD_POINT_X_OFF]) & 0xfff,
224 get_unaligned_le16(&coord[SILEAD_POINT_Y_OFF]) & 0xfff);
226 input_report_abs(data->pen_input, ABS_X, pos.x);
227 input_report_abs(data->pen_input, ABS_Y, pos.y);
229 data->pen_up_count = 0;
230 data->pen_down = true;
237 input_report_key(data->pen_input, BTN_TOOL_PEN, data->pen_down);
238 input_report_key(data->pen_input, BTN_TOUCH, data->pen_down);
239 input_sync(data->pen_input);
243 static void silead_ts_read_data(struct i2c_client *client)
245 struct silead_ts_data *data = i2c_get_clientdata(client);
246 struct input_dev *input = data->input;
247 struct device *dev = &client->dev;
248 u8 *bufp, buf[SILEAD_TS_DATA_LEN];
249 int touch_nr, softbutton, error, i;
250 bool softbutton_pressed = false;
252 error = i2c_smbus_read_i2c_block_data(client, SILEAD_REG_DATA,
253 SILEAD_TS_DATA_LEN, buf);
255 dev_err(dev, "Data read error %d\n", error);
259 if (buf[0] > data->max_fingers) {
260 dev_warn(dev, "More touches reported then supported %d > %d\n",
261 buf[0], data->max_fingers);
262 buf[0] = data->max_fingers;
265 if (silead_ts_handle_pen_data(data, buf))
266 goto sync; /* Pen is down, release all previous touches */
269 bufp = buf + SILEAD_POINT_DATA_LEN;
270 for (i = 0; i < buf[0]; i++, bufp += SILEAD_POINT_DATA_LEN) {
271 softbutton = (bufp[SILEAD_POINT_Y_MSB_OFF] &
272 SILEAD_EXTRA_DATA_MASK) >> 4;
276 * For now only respond to softbutton == 0x01, some
277 * tablets *without* a capacative button send 0x04
278 * when crossing the edges of the screen.
280 if (softbutton == 0x01)
281 softbutton_pressed = true;
287 * Bits 4-7 are the touch id, note not all models have
288 * hardware touch ids so atm we don't use these.
290 data->id[touch_nr] = (bufp[SILEAD_POINT_X_MSB_OFF] &
291 SILEAD_EXTRA_DATA_MASK) >> 4;
292 touchscreen_set_mt_pos(&data->pos[touch_nr], &data->prop,
293 get_unaligned_le16(&bufp[SILEAD_POINT_X_OFF]) & 0xfff,
294 get_unaligned_le16(&bufp[SILEAD_POINT_Y_OFF]) & 0xfff);
298 input_mt_assign_slots(input, data->slots, data->pos, touch_nr, 0);
300 for (i = 0; i < touch_nr; i++) {
301 input_mt_slot(input, data->slots[i]);
302 input_mt_report_slot_state(input, MT_TOOL_FINGER, true);
303 input_report_abs(input, ABS_MT_POSITION_X, data->pos[i].x);
304 input_report_abs(input, ABS_MT_POSITION_Y, data->pos[i].y);
306 dev_dbg(dev, "x=%d y=%d hw_id=%d sw_id=%d\n", data->pos[i].x,
307 data->pos[i].y, data->id[i], data->slots[i]);
311 input_mt_sync_frame(input);
312 input_report_key(input, KEY_LEFTMETA, softbutton_pressed);
316 static int silead_ts_init(struct i2c_client *client)
318 struct silead_ts_data *data = i2c_get_clientdata(client);
321 error = i2c_smbus_write_byte_data(client, SILEAD_REG_RESET,
325 usleep_range(SILEAD_CMD_SLEEP_MIN, SILEAD_CMD_SLEEP_MAX);
327 error = i2c_smbus_write_byte_data(client, SILEAD_REG_TOUCH_NR,
331 usleep_range(SILEAD_CMD_SLEEP_MIN, SILEAD_CMD_SLEEP_MAX);
333 error = i2c_smbus_write_byte_data(client, SILEAD_REG_CLOCK,
337 usleep_range(SILEAD_CMD_SLEEP_MIN, SILEAD_CMD_SLEEP_MAX);
339 error = i2c_smbus_write_byte_data(client, SILEAD_REG_RESET,
343 usleep_range(SILEAD_CMD_SLEEP_MIN, SILEAD_CMD_SLEEP_MAX);
348 dev_err(&client->dev, "Registers clear error %d\n", error);
352 static int silead_ts_reset(struct i2c_client *client)
356 error = i2c_smbus_write_byte_data(client, SILEAD_REG_RESET,
360 usleep_range(SILEAD_CMD_SLEEP_MIN, SILEAD_CMD_SLEEP_MAX);
362 error = i2c_smbus_write_byte_data(client, SILEAD_REG_CLOCK,
366 usleep_range(SILEAD_CMD_SLEEP_MIN, SILEAD_CMD_SLEEP_MAX);
368 error = i2c_smbus_write_byte_data(client, SILEAD_REG_POWER,
372 usleep_range(SILEAD_CMD_SLEEP_MIN, SILEAD_CMD_SLEEP_MAX);
377 dev_err(&client->dev, "Chip reset error %d\n", error);
381 static int silead_ts_startup(struct i2c_client *client)
385 error = i2c_smbus_write_byte_data(client, SILEAD_REG_RESET, 0x00);
387 dev_err(&client->dev, "Startup error %d\n", error);
391 msleep(SILEAD_STARTUP_SLEEP);
396 static int silead_ts_load_fw(struct i2c_client *client)
398 struct device *dev = &client->dev;
399 struct silead_ts_data *data = i2c_get_clientdata(client);
400 const struct firmware *fw = NULL;
401 struct silead_fw_data *fw_data;
402 unsigned int fw_size, i;
405 dev_dbg(dev, "Firmware file name: %s", data->fw_name);
408 * Unfortunately, at the time of writing this comment, we have been unable to
409 * get permission from Silead, or from device OEMs, to distribute the necessary
410 * Silead firmware files in linux-firmware.
412 * On a whole bunch of devices the UEFI BIOS code contains a touchscreen driver,
413 * which contains an embedded copy of the firmware. The fw-loader code has a
414 * "platform" fallback mechanism, which together with info on the firmware
415 * from drivers/platform/x86/touchscreen_dmi.c will use the firmware from the
416 * UEFI driver when the firmware is missing from /lib/firmware. This makes the
417 * touchscreen work OOTB without users needing to manually download the firmware.
419 * The firmware bundled with the original Windows/Android is usually newer then
420 * the firmware in the UEFI driver and it is better calibrated. This better
421 * calibration can lead to significant differences in the reported min/max
424 * To deal with this we first try to load the firmware without "platform"
425 * fallback. If that fails we retry with "platform" fallback and if that
426 * succeeds we apply an (optional) set of alternative min/max values from the
427 * "silead,efi-fw-min-max" property.
429 error = firmware_request_nowarn(&fw, data->fw_name, dev);
431 error = firmware_request_platform(&fw, data->fw_name, dev);
433 dev_err(dev, "Firmware request error %d\n", error);
437 error = device_property_read_u32_array(dev, "silead,efi-fw-min-max",
438 data->efi_fw_min_max,
439 ARRAY_SIZE(data->efi_fw_min_max));
441 data->efi_fw_min_max_set = true;
443 /* The EFI (platform) embedded fw does not have pen support */
444 if (data->pen_supported) {
445 dev_warn(dev, "Warning loading '%s' from filesystem failed, using EFI embedded copy.\n",
447 dev_warn(dev, "Warning pen support is known to be broken in the EFI embedded fw version\n");
448 data->pen_supported = false;
452 fw_size = fw->size / sizeof(*fw_data);
453 fw_data = (struct silead_fw_data *)fw->data;
455 for (i = 0; i < fw_size; i++) {
456 error = i2c_smbus_write_i2c_block_data(client,
459 (u8 *)&fw_data[i].val);
461 dev_err(dev, "Firmware load error %d\n", error);
466 release_firmware(fw);
470 static u32 silead_ts_get_status(struct i2c_client *client)
475 error = i2c_smbus_read_i2c_block_data(client, SILEAD_REG_STATUS,
476 sizeof(status), (u8 *)&status);
478 dev_err(&client->dev, "Status read error %d\n", error);
482 return le32_to_cpu(status);
485 static int silead_ts_get_id(struct i2c_client *client)
487 struct silead_ts_data *data = i2c_get_clientdata(client);
491 error = i2c_smbus_read_i2c_block_data(client, SILEAD_REG_ID,
492 sizeof(chip_id), (u8 *)&chip_id);
496 data->chip_id = le32_to_cpu(chip_id);
497 dev_info(&client->dev, "Silead chip ID: 0x%8X", data->chip_id);
502 static int silead_ts_setup(struct i2c_client *client)
508 * Some buggy BIOS-es bring up the chip in a stuck state where it
509 * blocks the I2C bus. The following steps are necessary to
510 * unstuck the chip / bus:
511 * 1. Turn off the Silead chip.
512 * 2. Try to do an I2C transfer with the chip, this will fail in
513 * response to which the I2C-bus-driver will call:
514 * i2c_recover_bus() which will unstuck the I2C-bus. Note the
515 * unstuck-ing of the I2C bus only works if we first drop the
516 * chip off the bus by turning it off.
517 * 3. Turn the chip back on.
519 * On the x86/ACPI systems were this problem is seen, step 1. and
520 * 3. require making ACPI calls and dealing with ACPI Power
521 * Resources. The workaround below runtime-suspends the chip to
522 * turn it off, leaving it up to the ACPI subsystem to deal with
526 if (device_property_read_bool(&client->dev,
527 "silead,stuck-controller-bug")) {
528 pm_runtime_set_active(&client->dev);
529 pm_runtime_enable(&client->dev);
530 pm_runtime_allow(&client->dev);
532 pm_runtime_suspend(&client->dev);
534 dev_warn(&client->dev, FW_BUG "Stuck I2C bus: please ignore the next 'controller timed out' error\n");
535 silead_ts_get_id(client);
537 /* The forbid will also resume the device */
538 pm_runtime_forbid(&client->dev);
539 pm_runtime_disable(&client->dev);
542 silead_ts_set_power(client, SILEAD_POWER_OFF);
543 silead_ts_set_power(client, SILEAD_POWER_ON);
545 error = silead_ts_get_id(client);
547 dev_err(&client->dev, "Chip ID read error %d\n", error);
551 error = silead_ts_init(client);
555 error = silead_ts_reset(client);
559 error = silead_ts_load_fw(client);
563 error = silead_ts_startup(client);
567 status = silead_ts_get_status(client);
568 if (status != SILEAD_STATUS_OK) {
569 dev_err(&client->dev,
570 "Initialization error, status: 0x%X\n", status);
577 static irqreturn_t silead_ts_threaded_irq_handler(int irq, void *id)
579 struct silead_ts_data *data = id;
580 struct i2c_client *client = data->client;
582 silead_ts_read_data(client);
587 static void silead_ts_read_props(struct i2c_client *client)
589 struct silead_ts_data *data = i2c_get_clientdata(client);
590 struct device *dev = &client->dev;
594 error = device_property_read_u32(dev, "silead,max-fingers",
597 dev_dbg(dev, "Max fingers read error %d\n", error);
598 data->max_fingers = 5; /* Most devices handle up-to 5 fingers */
601 error = device_property_read_string(dev, "firmware-name", &str);
603 snprintf(data->fw_name, sizeof(data->fw_name),
606 dev_dbg(dev, "Firmware file name read error. Using default.");
608 data->pen_supported = device_property_read_bool(dev, "silead,pen-supported");
609 device_property_read_u32(dev, "silead,pen-resolution-x", &data->pen_x_res);
610 device_property_read_u32(dev, "silead,pen-resolution-y", &data->pen_y_res);
614 static int silead_ts_set_default_fw_name(struct silead_ts_data *data,
615 const struct i2c_device_id *id)
617 const struct acpi_device_id *acpi_id;
618 struct device *dev = &data->client->dev;
621 if (ACPI_HANDLE(dev)) {
622 acpi_id = acpi_match_device(dev->driver->acpi_match_table, dev);
626 snprintf(data->fw_name, sizeof(data->fw_name),
627 "silead/%s.fw", acpi_id->id);
629 for (i = 0; i < strlen(data->fw_name); i++)
630 data->fw_name[i] = tolower(data->fw_name[i]);
632 snprintf(data->fw_name, sizeof(data->fw_name),
633 "silead/%s.fw", id->name);
639 static int silead_ts_set_default_fw_name(struct silead_ts_data *data,
640 const struct i2c_device_id *id)
642 snprintf(data->fw_name, sizeof(data->fw_name),
643 "silead/%s.fw", id->name);
648 static void silead_disable_regulator(void *arg)
650 struct silead_ts_data *data = arg;
652 regulator_bulk_disable(ARRAY_SIZE(data->regulators), data->regulators);
655 static int silead_ts_probe(struct i2c_client *client,
656 const struct i2c_device_id *id)
658 struct silead_ts_data *data;
659 struct device *dev = &client->dev;
662 if (!i2c_check_functionality(client->adapter,
664 I2C_FUNC_SMBUS_READ_I2C_BLOCK |
665 I2C_FUNC_SMBUS_WRITE_I2C_BLOCK)) {
666 dev_err(dev, "I2C functionality check failed\n");
670 data = devm_kzalloc(dev, sizeof(*data), GFP_KERNEL);
674 i2c_set_clientdata(client, data);
675 data->client = client;
677 error = silead_ts_set_default_fw_name(data, id);
681 silead_ts_read_props(client);
683 /* We must have the IRQ provided by DT or ACPI subsystem */
684 if (client->irq <= 0)
687 data->regulators[0].supply = "vddio";
688 data->regulators[1].supply = "avdd";
689 error = devm_regulator_bulk_get(dev, ARRAY_SIZE(data->regulators),
695 * Enable regulators at probe and disable them at remove, we need
696 * to keep the chip powered otherwise it forgets its firmware.
698 error = regulator_bulk_enable(ARRAY_SIZE(data->regulators),
703 error = devm_add_action_or_reset(dev, silead_disable_regulator, data);
708 data->gpio_power = devm_gpiod_get_optional(dev, "power", GPIOD_OUT_LOW);
709 if (IS_ERR(data->gpio_power)) {
710 if (PTR_ERR(data->gpio_power) != -EPROBE_DEFER)
711 dev_err(dev, "Shutdown GPIO request failed\n");
712 return PTR_ERR(data->gpio_power);
715 error = silead_ts_setup(client);
719 error = silead_ts_request_input_dev(data);
723 error = silead_ts_request_pen_input_dev(data);
727 error = devm_request_threaded_irq(dev, client->irq,
728 NULL, silead_ts_threaded_irq_handler,
729 IRQF_ONESHOT, client->name, data);
731 if (error != -EPROBE_DEFER)
732 dev_err(dev, "IRQ request failed %d\n", error);
739 static int __maybe_unused silead_ts_suspend(struct device *dev)
741 struct i2c_client *client = to_i2c_client(dev);
743 disable_irq(client->irq);
744 silead_ts_set_power(client, SILEAD_POWER_OFF);
748 static int __maybe_unused silead_ts_resume(struct device *dev)
750 struct i2c_client *client = to_i2c_client(dev);
751 bool second_try = false;
754 silead_ts_set_power(client, SILEAD_POWER_ON);
757 error = silead_ts_reset(client);
762 error = silead_ts_load_fw(client);
767 error = silead_ts_startup(client);
771 status = silead_ts_get_status(client);
772 if (status != SILEAD_STATUS_OK) {
775 dev_dbg(dev, "Reloading firmware after unsuccessful resume\n");
778 dev_err(dev, "Resume error, status: 0x%02x\n", status);
782 enable_irq(client->irq);
787 static SIMPLE_DEV_PM_OPS(silead_ts_pm, silead_ts_suspend, silead_ts_resume);
789 static const struct i2c_device_id silead_ts_id[] = {
798 MODULE_DEVICE_TABLE(i2c, silead_ts_id);
801 static const struct acpi_device_id silead_ts_acpi_match[] = {
813 MODULE_DEVICE_TABLE(acpi, silead_ts_acpi_match);
817 static const struct of_device_id silead_ts_of_match[] = {
818 { .compatible = "silead,gsl1680" },
819 { .compatible = "silead,gsl1688" },
820 { .compatible = "silead,gsl3670" },
821 { .compatible = "silead,gsl3675" },
822 { .compatible = "silead,gsl3692" },
825 MODULE_DEVICE_TABLE(of, silead_ts_of_match);
828 static struct i2c_driver silead_ts_driver = {
829 .probe = silead_ts_probe,
830 .id_table = silead_ts_id,
832 .name = SILEAD_TS_NAME,
833 .acpi_match_table = ACPI_PTR(silead_ts_acpi_match),
834 .of_match_table = of_match_ptr(silead_ts_of_match),
838 module_i2c_driver(silead_ts_driver);
841 MODULE_DESCRIPTION("Silead I2C touchscreen driver");
842 MODULE_LICENSE("GPL");