2 * Atmel maXTouch Touchscreen driver
4 * Copyright (C) 2010 Samsung Electronics Co.Ltd
5 * Copyright (C) 2011-2014 Atmel Corporation
6 * Copyright (C) 2012 Google, Inc.
8 * Author: Joonyoung Shim <jy0922.shim@samsung.com>
10 * This program is free software; you can redistribute it and/or modify it
11 * under the terms of the GNU General Public License as published by the
12 * Free Software Foundation; either version 2 of the License, or (at your
13 * option) any later version.
17 #include <linux/acpi.h>
18 #include <linux/dmi.h>
19 #include <linux/module.h>
20 #include <linux/init.h>
21 #include <linux/completion.h>
22 #include <linux/delay.h>
23 #include <linux/firmware.h>
24 #include <linux/i2c.h>
25 #include <linux/platform_data/atmel_mxt_ts.h>
26 #include <linux/input/mt.h>
27 #include <linux/interrupt.h>
29 #include <linux/slab.h>
30 #include <asm/unaligned.h>
33 #define MXT_FW_NAME "maxtouch.fw"
34 #define MXT_CFG_NAME "maxtouch.cfg"
35 #define MXT_CFG_MAGIC "OBP_RAW V1"
38 #define MXT_OBJECT_START 0x07
39 #define MXT_OBJECT_SIZE 6
40 #define MXT_INFO_CHECKSUM_SIZE 3
41 #define MXT_MAX_BLOCK_WRITE 256
44 #define MXT_DEBUG_DIAGNOSTIC_T37 37
45 #define MXT_GEN_MESSAGE_T5 5
46 #define MXT_GEN_COMMAND_T6 6
47 #define MXT_GEN_POWER_T7 7
48 #define MXT_GEN_ACQUIRE_T8 8
49 #define MXT_GEN_DATASOURCE_T53 53
50 #define MXT_TOUCH_MULTI_T9 9
51 #define MXT_TOUCH_KEYARRAY_T15 15
52 #define MXT_TOUCH_PROXIMITY_T23 23
53 #define MXT_TOUCH_PROXKEY_T52 52
54 #define MXT_PROCI_GRIPFACE_T20 20
55 #define MXT_PROCG_NOISE_T22 22
56 #define MXT_PROCI_ONETOUCH_T24 24
57 #define MXT_PROCI_TWOTOUCH_T27 27
58 #define MXT_PROCI_GRIP_T40 40
59 #define MXT_PROCI_PALM_T41 41
60 #define MXT_PROCI_TOUCHSUPPRESSION_T42 42
61 #define MXT_PROCI_STYLUS_T47 47
62 #define MXT_PROCG_NOISESUPPRESSION_T48 48
63 #define MXT_SPT_COMMSCONFIG_T18 18
64 #define MXT_SPT_GPIOPWM_T19 19
65 #define MXT_SPT_SELFTEST_T25 25
66 #define MXT_SPT_CTECONFIG_T28 28
67 #define MXT_SPT_USERDATA_T38 38
68 #define MXT_SPT_DIGITIZER_T43 43
69 #define MXT_SPT_MESSAGECOUNT_T44 44
70 #define MXT_SPT_CTECONFIG_T46 46
71 #define MXT_TOUCH_MULTITOUCHSCREEN_T100 100
73 /* MXT_GEN_MESSAGE_T5 object */
74 #define MXT_RPTID_NOMSG 0xff
76 /* MXT_GEN_COMMAND_T6 field */
77 #define MXT_COMMAND_RESET 0
78 #define MXT_COMMAND_BACKUPNV 1
79 #define MXT_COMMAND_CALIBRATE 2
80 #define MXT_COMMAND_REPORTALL 3
81 #define MXT_COMMAND_DIAGNOSTIC 5
83 /* Define for T6 status byte */
84 #define MXT_T6_STATUS_RESET (1 << 7)
85 #define MXT_T6_STATUS_OFL (1 << 6)
86 #define MXT_T6_STATUS_SIGERR (1 << 5)
87 #define MXT_T6_STATUS_CAL (1 << 4)
88 #define MXT_T6_STATUS_CFGERR (1 << 3)
89 #define MXT_T6_STATUS_COMSERR (1 << 2)
91 /* MXT_GEN_POWER_T7 field */
97 #define MXT_POWER_CFG_RUN 0
98 #define MXT_POWER_CFG_DEEPSLEEP 1
100 /* MXT_TOUCH_MULTI_T9 field */
101 #define MXT_T9_CTRL 0
102 #define MXT_T9_ORIENT 9
103 #define MXT_T9_RANGE 18
105 /* MXT_TOUCH_MULTI_T9 status */
106 #define MXT_T9_UNGRIP (1 << 0)
107 #define MXT_T9_SUPPRESS (1 << 1)
108 #define MXT_T9_AMP (1 << 2)
109 #define MXT_T9_VECTOR (1 << 3)
110 #define MXT_T9_MOVE (1 << 4)
111 #define MXT_T9_RELEASE (1 << 5)
112 #define MXT_T9_PRESS (1 << 6)
113 #define MXT_T9_DETECT (1 << 7)
120 /* MXT_TOUCH_MULTI_T9 orient */
121 #define MXT_T9_ORIENT_SWITCH (1 << 0)
123 /* MXT_SPT_COMMSCONFIG_T18 */
124 #define MXT_COMMS_CTRL 0
125 #define MXT_COMMS_CMD 1
127 /* Define for MXT_GEN_COMMAND_T6 */
128 #define MXT_BOOT_VALUE 0xa5
129 #define MXT_RESET_VALUE 0x01
130 #define MXT_BACKUP_VALUE 0x55
132 /* T100 Multiple Touch Touchscreen */
133 #define MXT_T100_CTRL 0
134 #define MXT_T100_CFG1 1
135 #define MXT_T100_TCHAUX 3
136 #define MXT_T100_XRANGE 13
137 #define MXT_T100_YRANGE 24
139 #define MXT_T100_CFG_SWITCHXY BIT(5)
141 #define MXT_T100_TCHAUX_VECT BIT(0)
142 #define MXT_T100_TCHAUX_AMPL BIT(1)
143 #define MXT_T100_TCHAUX_AREA BIT(2)
145 #define MXT_T100_DETECT BIT(7)
146 #define MXT_T100_TYPE_MASK 0x70
149 MXT_T100_TYPE_FINGER = 1,
150 MXT_T100_TYPE_PASSIVE_STYLUS = 2,
151 MXT_T100_TYPE_HOVERING_FINGER = 4,
152 MXT_T100_TYPE_GLOVE = 5,
153 MXT_T100_TYPE_LARGE_TOUCH = 6,
156 #define MXT_DISTANCE_ACTIVE_TOUCH 0
157 #define MXT_DISTANCE_HOVERING 1
159 #define MXT_TOUCH_MAJOR_DEFAULT 1
160 #define MXT_PRESSURE_DEFAULT 1
163 #define MXT_BACKUP_TIME 50 /* msec */
164 #define MXT_RESET_TIME 200 /* msec */
165 #define MXT_RESET_TIMEOUT 3000 /* msec */
166 #define MXT_CRC_TIMEOUT 1000 /* msec */
167 #define MXT_FW_RESET_TIME 3000 /* msec */
168 #define MXT_FW_CHG_TIMEOUT 300 /* msec */
170 /* Command to unlock bootloader */
171 #define MXT_UNLOCK_CMD_MSB 0xaa
172 #define MXT_UNLOCK_CMD_LSB 0xdc
174 /* Bootloader mode status */
175 #define MXT_WAITING_BOOTLOAD_CMD 0xc0 /* valid 7 6 bit only */
176 #define MXT_WAITING_FRAME_DATA 0x80 /* valid 7 6 bit only */
177 #define MXT_FRAME_CRC_CHECK 0x02
178 #define MXT_FRAME_CRC_FAIL 0x03
179 #define MXT_FRAME_CRC_PASS 0x04
180 #define MXT_APP_CRC_FAIL 0x40 /* valid 7 8 bit only */
181 #define MXT_BOOT_STATUS_MASK 0x3f
182 #define MXT_BOOT_EXTENDED_ID (1 << 5)
183 #define MXT_BOOT_ID_MASK 0x1f
185 /* Touchscreen absolute values */
186 #define MXT_MAX_AREA 0xff
188 #define MXT_PIXELS_PER_MM 20
204 u8 instances_minus_one;
208 /* Each client has this additional data */
210 struct i2c_client *client;
211 struct input_dev *input_dev;
212 char phys[64]; /* device physical location */
213 const struct mxt_platform_data *pdata;
214 struct mxt_object *object_table;
215 struct mxt_info info;
231 u8 last_message_count;
234 struct t7_config t7_cfg;
236 /* Cached parameters from object table */
246 u8 T100_reportid_min;
247 u8 T100_reportid_max;
249 /* for fw update in bootloader */
250 struct completion bl_completion;
252 /* for reset handling */
253 struct completion reset_completion;
255 /* for config update handling */
256 struct completion crc_completion;
259 static size_t mxt_obj_size(const struct mxt_object *obj)
261 return obj->size_minus_one + 1;
264 static size_t mxt_obj_instances(const struct mxt_object *obj)
266 return obj->instances_minus_one + 1;
269 static bool mxt_object_readable(unsigned int type)
272 case MXT_GEN_COMMAND_T6:
273 case MXT_GEN_POWER_T7:
274 case MXT_GEN_ACQUIRE_T8:
275 case MXT_GEN_DATASOURCE_T53:
276 case MXT_TOUCH_MULTI_T9:
277 case MXT_TOUCH_KEYARRAY_T15:
278 case MXT_TOUCH_PROXIMITY_T23:
279 case MXT_TOUCH_PROXKEY_T52:
280 case MXT_PROCI_GRIPFACE_T20:
281 case MXT_PROCG_NOISE_T22:
282 case MXT_PROCI_ONETOUCH_T24:
283 case MXT_PROCI_TWOTOUCH_T27:
284 case MXT_PROCI_GRIP_T40:
285 case MXT_PROCI_PALM_T41:
286 case MXT_PROCI_TOUCHSUPPRESSION_T42:
287 case MXT_PROCI_STYLUS_T47:
288 case MXT_PROCG_NOISESUPPRESSION_T48:
289 case MXT_SPT_COMMSCONFIG_T18:
290 case MXT_SPT_GPIOPWM_T19:
291 case MXT_SPT_SELFTEST_T25:
292 case MXT_SPT_CTECONFIG_T28:
293 case MXT_SPT_USERDATA_T38:
294 case MXT_SPT_DIGITIZER_T43:
295 case MXT_SPT_CTECONFIG_T46:
302 static void mxt_dump_message(struct mxt_data *data, u8 *message)
304 dev_dbg(&data->client->dev, "message: %*ph\n",
305 data->T5_msg_size, message);
308 static int mxt_wait_for_completion(struct mxt_data *data,
309 struct completion *comp,
310 unsigned int timeout_ms)
312 struct device *dev = &data->client->dev;
313 unsigned long timeout = msecs_to_jiffies(timeout_ms);
316 ret = wait_for_completion_interruptible_timeout(comp, timeout);
319 } else if (ret == 0) {
320 dev_err(dev, "Wait for completion timed out.\n");
326 static int mxt_bootloader_read(struct mxt_data *data,
327 u8 *val, unsigned int count)
332 msg.addr = data->bootloader_addr;
333 msg.flags = data->client->flags & I2C_M_TEN;
334 msg.flags |= I2C_M_RD;
338 ret = i2c_transfer(data->client->adapter, &msg, 1);
342 ret = ret < 0 ? ret : -EIO;
343 dev_err(&data->client->dev, "%s: i2c recv failed (%d)\n",
350 static int mxt_bootloader_write(struct mxt_data *data,
351 const u8 * const val, unsigned int count)
356 msg.addr = data->bootloader_addr;
357 msg.flags = data->client->flags & I2C_M_TEN;
361 ret = i2c_transfer(data->client->adapter, &msg, 1);
365 ret = ret < 0 ? ret : -EIO;
366 dev_err(&data->client->dev, "%s: i2c send failed (%d)\n",
373 static int mxt_lookup_bootloader_address(struct mxt_data *data, bool retry)
375 u8 appmode = data->client->addr;
381 /* Chips after 1664S use different scheme */
382 if (retry || data->info.family_id >= 0xa2) {
383 bootloader = appmode - 0x24;
386 /* Fall through for normal case */
391 bootloader = appmode - 0x26;
395 dev_err(&data->client->dev,
396 "Appmode i2c address 0x%02x not found\n",
401 data->bootloader_addr = bootloader;
405 static int mxt_probe_bootloader(struct mxt_data *data, bool alt_address)
407 struct device *dev = &data->client->dev;
412 error = mxt_lookup_bootloader_address(data, alt_address);
416 error = mxt_bootloader_read(data, &val, 1);
420 /* Check app crc fail mode */
421 crc_failure = (val & ~MXT_BOOT_STATUS_MASK) == MXT_APP_CRC_FAIL;
423 dev_err(dev, "Detected bootloader, status:%02X%s\n",
424 val, crc_failure ? ", APP_CRC_FAIL" : "");
429 static u8 mxt_get_bootloader_version(struct mxt_data *data, u8 val)
431 struct device *dev = &data->client->dev;
434 if (val & MXT_BOOT_EXTENDED_ID) {
435 if (mxt_bootloader_read(data, &buf[0], 3) != 0) {
436 dev_err(dev, "%s: i2c failure\n", __func__);
440 dev_dbg(dev, "Bootloader ID:%d Version:%d\n", buf[1], buf[2]);
444 dev_dbg(dev, "Bootloader ID:%d\n", val & MXT_BOOT_ID_MASK);
450 static int mxt_check_bootloader(struct mxt_data *data, unsigned int state,
453 struct device *dev = &data->client->dev;
460 * In application update mode, the interrupt
461 * line signals state transitions. We must wait for the
462 * CHG assertion before reading the status byte.
463 * Once the status byte has been read, the line is deasserted.
465 ret = mxt_wait_for_completion(data, &data->bl_completion,
469 * TODO: handle -ERESTARTSYS better by terminating
470 * fw update process before returning to userspace
471 * by writing length 0x000 to device (iff we are in
472 * WAITING_FRAME_DATA state).
474 dev_err(dev, "Update wait error %d\n", ret);
479 ret = mxt_bootloader_read(data, &val, 1);
483 if (state == MXT_WAITING_BOOTLOAD_CMD)
484 val = mxt_get_bootloader_version(data, val);
487 case MXT_WAITING_BOOTLOAD_CMD:
488 case MXT_WAITING_FRAME_DATA:
489 case MXT_APP_CRC_FAIL:
490 val &= ~MXT_BOOT_STATUS_MASK;
492 case MXT_FRAME_CRC_PASS:
493 if (val == MXT_FRAME_CRC_CHECK) {
495 } else if (val == MXT_FRAME_CRC_FAIL) {
496 dev_err(dev, "Bootloader CRC fail\n");
505 dev_err(dev, "Invalid bootloader state %02X != %02X\n",
513 static int mxt_send_bootloader_cmd(struct mxt_data *data, bool unlock)
519 buf[0] = MXT_UNLOCK_CMD_LSB;
520 buf[1] = MXT_UNLOCK_CMD_MSB;
526 ret = mxt_bootloader_write(data, buf, 2);
533 static int __mxt_read_reg(struct i2c_client *client,
534 u16 reg, u16 len, void *val)
536 struct i2c_msg xfer[2];
541 buf[1] = (reg >> 8) & 0xff;
544 xfer[0].addr = client->addr;
550 xfer[1].addr = client->addr;
551 xfer[1].flags = I2C_M_RD;
555 ret = i2c_transfer(client->adapter, xfer, 2);
561 dev_err(&client->dev, "%s: i2c transfer failed (%d)\n",
568 static int __mxt_write_reg(struct i2c_client *client, u16 reg, u16 len,
576 buf = kmalloc(count, GFP_KERNEL);
581 buf[1] = (reg >> 8) & 0xff;
582 memcpy(&buf[2], val, len);
584 ret = i2c_master_send(client, buf, count);
590 dev_err(&client->dev, "%s: i2c send failed (%d)\n",
598 static int mxt_write_reg(struct i2c_client *client, u16 reg, u8 val)
600 return __mxt_write_reg(client, reg, 1, &val);
603 static struct mxt_object *
604 mxt_get_object(struct mxt_data *data, u8 type)
606 struct mxt_object *object;
609 for (i = 0; i < data->info.object_num; i++) {
610 object = data->object_table + i;
611 if (object->type == type)
615 dev_warn(&data->client->dev, "Invalid object type T%u\n", type);
619 static void mxt_proc_t6_messages(struct mxt_data *data, u8 *msg)
621 struct device *dev = &data->client->dev;
623 u32 crc = msg[2] | (msg[3] << 8) | (msg[4] << 16);
625 complete(&data->crc_completion);
627 if (crc != data->config_crc) {
628 data->config_crc = crc;
629 dev_dbg(dev, "T6 Config Checksum: 0x%06X\n", crc);
633 if (status & MXT_T6_STATUS_RESET)
634 complete(&data->reset_completion);
636 /* Output debug if status has changed */
637 if (status != data->t6_status)
638 dev_dbg(dev, "T6 Status 0x%02X%s%s%s%s%s%s%s\n",
640 status == 0 ? " OK" : "",
641 status & MXT_T6_STATUS_RESET ? " RESET" : "",
642 status & MXT_T6_STATUS_OFL ? " OFL" : "",
643 status & MXT_T6_STATUS_SIGERR ? " SIGERR" : "",
644 status & MXT_T6_STATUS_CAL ? " CAL" : "",
645 status & MXT_T6_STATUS_CFGERR ? " CFGERR" : "",
646 status & MXT_T6_STATUS_COMSERR ? " COMSERR" : "");
648 /* Save current status */
649 data->t6_status = status;
652 static int mxt_write_object(struct mxt_data *data,
653 u8 type, u8 offset, u8 val)
655 struct mxt_object *object;
658 object = mxt_get_object(data, type);
659 if (!object || offset >= mxt_obj_size(object))
662 reg = object->start_address;
663 return mxt_write_reg(data->client, reg + offset, val);
666 static void mxt_input_button(struct mxt_data *data, u8 *message)
668 struct input_dev *input = data->input_dev;
669 const struct mxt_platform_data *pdata = data->pdata;
672 for (i = 0; i < pdata->t19_num_keys; i++) {
673 if (pdata->t19_keymap[i] == KEY_RESERVED)
676 /* Active-low switch */
677 input_report_key(input, pdata->t19_keymap[i],
678 !(message[1] & BIT(i)));
682 static void mxt_input_sync(struct mxt_data *data)
684 input_mt_report_pointer_emulation(data->input_dev,
685 data->pdata->t19_num_keys);
686 input_sync(data->input_dev);
689 static void mxt_proc_t9_message(struct mxt_data *data, u8 *message)
691 struct device *dev = &data->client->dev;
692 struct input_dev *input_dev = data->input_dev;
700 id = message[0] - data->T9_reportid_min;
702 x = (message[2] << 4) | ((message[4] >> 4) & 0xf);
703 y = (message[3] << 4) | ((message[4] & 0xf));
705 /* Handle 10/12 bit switching */
706 if (data->max_x < 1024)
708 if (data->max_y < 1024)
712 amplitude = message[6];
715 "[%u] %c%c%c%c%c%c%c%c x: %5u y: %5u area: %3u amp: %3u\n",
717 (status & MXT_T9_DETECT) ? 'D' : '.',
718 (status & MXT_T9_PRESS) ? 'P' : '.',
719 (status & MXT_T9_RELEASE) ? 'R' : '.',
720 (status & MXT_T9_MOVE) ? 'M' : '.',
721 (status & MXT_T9_VECTOR) ? 'V' : '.',
722 (status & MXT_T9_AMP) ? 'A' : '.',
723 (status & MXT_T9_SUPPRESS) ? 'S' : '.',
724 (status & MXT_T9_UNGRIP) ? 'U' : '.',
725 x, y, area, amplitude);
727 input_mt_slot(input_dev, id);
729 if (status & MXT_T9_DETECT) {
731 * Multiple bits may be set if the host is slow to read
732 * the status messages, indicating all the events that
735 if (status & MXT_T9_RELEASE) {
736 input_mt_report_slot_state(input_dev,
738 mxt_input_sync(data);
742 input_mt_report_slot_state(input_dev, MT_TOOL_FINGER, 1);
743 input_report_abs(input_dev, ABS_MT_POSITION_X, x);
744 input_report_abs(input_dev, ABS_MT_POSITION_Y, y);
745 input_report_abs(input_dev, ABS_MT_PRESSURE, amplitude);
746 input_report_abs(input_dev, ABS_MT_TOUCH_MAJOR, area);
748 /* Touch no longer active, close out slot */
749 input_mt_report_slot_state(input_dev, MT_TOOL_FINGER, 0);
752 data->update_input = true;
755 static void mxt_proc_t100_message(struct mxt_data *data, u8 *message)
757 struct device *dev = &data->client->dev;
758 struct input_dev *input_dev = data->input_dev;
770 id = message[0] - data->T100_reportid_min - 2;
772 /* ignore SCRSTATUS events */
777 x = get_unaligned_le16(&message[2]);
778 y = get_unaligned_le16(&message[4]);
780 if (status & MXT_T100_DETECT) {
781 type = (status & MXT_T100_TYPE_MASK) >> 4;
784 case MXT_T100_TYPE_HOVERING_FINGER:
785 tool = MT_TOOL_FINGER;
786 distance = MXT_DISTANCE_HOVERING;
788 if (data->t100_aux_vect)
789 orientation = message[data->t100_aux_vect];
793 case MXT_T100_TYPE_FINGER:
794 case MXT_T100_TYPE_GLOVE:
795 tool = MT_TOOL_FINGER;
796 distance = MXT_DISTANCE_ACTIVE_TOUCH;
798 if (data->t100_aux_area)
799 major = message[data->t100_aux_area];
801 if (data->t100_aux_ampl)
802 pressure = message[data->t100_aux_ampl];
804 if (data->t100_aux_vect)
805 orientation = message[data->t100_aux_vect];
809 case MXT_T100_TYPE_PASSIVE_STYLUS:
813 * Passive stylus is reported with size zero so
816 major = MXT_TOUCH_MAJOR_DEFAULT;
818 if (data->t100_aux_ampl)
819 pressure = message[data->t100_aux_ampl];
823 case MXT_T100_TYPE_LARGE_TOUCH:
824 /* Ignore suppressed touch */
828 dev_dbg(dev, "Unexpected T100 type\n");
834 * Values reported should be non-zero if tool is touching the
837 if (!pressure && type != MXT_T100_TYPE_HOVERING_FINGER)
838 pressure = MXT_PRESSURE_DEFAULT;
840 input_mt_slot(input_dev, id);
842 if (status & MXT_T100_DETECT) {
843 dev_dbg(dev, "[%u] type:%u x:%u y:%u a:%02X p:%02X v:%02X\n",
844 id, type, x, y, major, pressure, orientation);
846 input_mt_report_slot_state(input_dev, tool, 1);
847 input_report_abs(input_dev, ABS_MT_POSITION_X, x);
848 input_report_abs(input_dev, ABS_MT_POSITION_Y, y);
849 input_report_abs(input_dev, ABS_MT_TOUCH_MAJOR, major);
850 input_report_abs(input_dev, ABS_MT_PRESSURE, pressure);
851 input_report_abs(input_dev, ABS_MT_DISTANCE, distance);
852 input_report_abs(input_dev, ABS_MT_ORIENTATION, orientation);
854 dev_dbg(dev, "[%u] release\n", id);
857 input_mt_report_slot_state(input_dev, 0, 0);
860 data->update_input = true;
863 static int mxt_proc_message(struct mxt_data *data, u8 *message)
865 u8 report_id = message[0];
867 if (report_id == MXT_RPTID_NOMSG)
870 if (report_id == data->T6_reportid) {
871 mxt_proc_t6_messages(data, message);
872 } else if (!data->input_dev) {
874 * Do not report events if input device
875 * is not yet registered.
877 mxt_dump_message(data, message);
878 } else if (report_id >= data->T9_reportid_min &&
879 report_id <= data->T9_reportid_max) {
880 mxt_proc_t9_message(data, message);
881 } else if (report_id >= data->T100_reportid_min &&
882 report_id <= data->T100_reportid_max) {
883 mxt_proc_t100_message(data, message);
884 } else if (report_id == data->T19_reportid) {
885 mxt_input_button(data, message);
886 data->update_input = true;
888 mxt_dump_message(data, message);
894 static int mxt_read_and_process_messages(struct mxt_data *data, u8 count)
896 struct device *dev = &data->client->dev;
901 /* Safety check for msg_buf */
902 if (count > data->max_reportid)
905 /* Process remaining messages if necessary */
906 ret = __mxt_read_reg(data->client, data->T5_address,
907 data->T5_msg_size * count, data->msg_buf);
909 dev_err(dev, "Failed to read %u messages (%d)\n", count, ret);
913 for (i = 0; i < count; i++) {
914 ret = mxt_proc_message(data,
915 data->msg_buf + data->T5_msg_size * i);
921 /* return number of messages read */
925 static irqreturn_t mxt_process_messages_t44(struct mxt_data *data)
927 struct device *dev = &data->client->dev;
931 /* Read T44 and T5 together */
932 ret = __mxt_read_reg(data->client, data->T44_address,
933 data->T5_msg_size + 1, data->msg_buf);
935 dev_err(dev, "Failed to read T44 and T5 (%d)\n", ret);
939 count = data->msg_buf[0];
943 * This condition is caused by the CHG line being configured
944 * in Mode 0. It results in unnecessary I2C operations but it
947 dev_dbg(dev, "Interrupt triggered but zero messages\n");
949 } else if (count > data->max_reportid) {
950 dev_err(dev, "T44 count %d exceeded max report id\n", count);
951 count = data->max_reportid;
954 /* Process first message */
955 ret = mxt_proc_message(data, data->msg_buf + 1);
957 dev_warn(dev, "Unexpected invalid message\n");
961 num_left = count - 1;
963 /* Process remaining messages if necessary */
965 ret = mxt_read_and_process_messages(data, num_left);
968 else if (ret != num_left)
969 dev_warn(dev, "Unexpected invalid message\n");
973 if (data->update_input) {
974 mxt_input_sync(data);
975 data->update_input = false;
981 static int mxt_process_messages_until_invalid(struct mxt_data *data)
983 struct device *dev = &data->client->dev;
987 count = data->max_reportid;
989 /* Read messages until we force an invalid */
991 read = mxt_read_and_process_messages(data, count);
996 if (data->update_input) {
997 mxt_input_sync(data);
998 data->update_input = false;
1001 dev_err(dev, "CHG pin isn't cleared\n");
1005 static irqreturn_t mxt_process_messages(struct mxt_data *data)
1007 int total_handled, num_handled;
1008 u8 count = data->last_message_count;
1010 if (count < 1 || count > data->max_reportid)
1013 /* include final invalid message */
1014 total_handled = mxt_read_and_process_messages(data, count + 1);
1015 if (total_handled < 0)
1017 /* if there were invalid messages, then we are done */
1018 else if (total_handled <= count)
1021 /* keep reading two msgs until one is invalid or reportid limit */
1023 num_handled = mxt_read_and_process_messages(data, 2);
1024 if (num_handled < 0)
1027 total_handled += num_handled;
1029 if (num_handled < 2)
1031 } while (total_handled < data->num_touchids);
1034 data->last_message_count = total_handled;
1036 if (data->update_input) {
1037 mxt_input_sync(data);
1038 data->update_input = false;
1044 static irqreturn_t mxt_interrupt(int irq, void *dev_id)
1046 struct mxt_data *data = dev_id;
1048 if (data->in_bootloader) {
1049 /* bootloader state transition completion */
1050 complete(&data->bl_completion);
1054 if (!data->object_table)
1057 if (data->T44_address) {
1058 return mxt_process_messages_t44(data);
1060 return mxt_process_messages(data);
1064 static int mxt_t6_command(struct mxt_data *data, u16 cmd_offset,
1065 u8 value, bool wait)
1068 u8 command_register;
1069 int timeout_counter = 0;
1072 reg = data->T6_address + cmd_offset;
1074 ret = mxt_write_reg(data->client, reg, value);
1083 ret = __mxt_read_reg(data->client, reg, 1, &command_register);
1086 } while (command_register != 0 && timeout_counter++ <= 100);
1088 if (timeout_counter > 100) {
1089 dev_err(&data->client->dev, "Command failed!\n");
1096 static int mxt_soft_reset(struct mxt_data *data)
1098 struct device *dev = &data->client->dev;
1101 dev_info(dev, "Resetting device\n");
1103 disable_irq(data->irq);
1105 reinit_completion(&data->reset_completion);
1107 ret = mxt_t6_command(data, MXT_COMMAND_RESET, MXT_RESET_VALUE, false);
1111 /* Ignore CHG line for 100ms after reset */
1114 enable_irq(data->irq);
1116 ret = mxt_wait_for_completion(data, &data->reset_completion,
1124 static void mxt_update_crc(struct mxt_data *data, u8 cmd, u8 value)
1127 * On failure, CRC is set to 0 and config will always be
1130 data->config_crc = 0;
1131 reinit_completion(&data->crc_completion);
1133 mxt_t6_command(data, cmd, value, true);
1136 * Wait for crc message. On failure, CRC is set to 0 and config will
1137 * always be downloaded.
1139 mxt_wait_for_completion(data, &data->crc_completion, MXT_CRC_TIMEOUT);
1142 static void mxt_calc_crc24(u32 *crc, u8 firstbyte, u8 secondbyte)
1144 static const unsigned int crcpoly = 0x80001B;
1148 data_word = (secondbyte << 8) | firstbyte;
1149 result = ((*crc << 1) ^ data_word);
1151 if (result & 0x1000000)
1157 static u32 mxt_calculate_crc(u8 *base, off_t start_off, off_t end_off)
1160 u8 *ptr = base + start_off;
1161 u8 *last_val = base + end_off - 1;
1163 if (end_off < start_off)
1166 while (ptr < last_val) {
1167 mxt_calc_crc24(&crc, *ptr, *(ptr + 1));
1171 /* if len is odd, fill the last byte with 0 */
1172 if (ptr == last_val)
1173 mxt_calc_crc24(&crc, *ptr, 0);
1175 /* Mask to 24-bit */
1181 static int mxt_prepare_cfg_mem(struct mxt_data *data,
1182 const struct firmware *cfg,
1183 unsigned int data_pos,
1184 unsigned int cfg_start_ofs,
1186 size_t config_mem_size)
1188 struct device *dev = &data->client->dev;
1189 struct mxt_object *object;
1190 unsigned int type, instance, size, byte_offset;
1197 while (data_pos < cfg->size) {
1198 /* Read type, instance, length */
1199 ret = sscanf(cfg->data + data_pos, "%x %x %x%n",
1200 &type, &instance, &size, &offset);
1204 } else if (ret != 3) {
1205 dev_err(dev, "Bad format: failed to parse object\n");
1210 object = mxt_get_object(data, type);
1213 for (i = 0; i < size; i++) {
1214 ret = sscanf(cfg->data + data_pos, "%hhx%n",
1217 dev_err(dev, "Bad format in T%d at %d\n",
1226 if (size > mxt_obj_size(object)) {
1228 * Either we are in fallback mode due to wrong
1229 * config or config from a later fw version,
1230 * or the file is corrupt or hand-edited.
1232 dev_warn(dev, "Discarding %zu byte(s) in T%u\n",
1233 size - mxt_obj_size(object), type);
1234 } else if (mxt_obj_size(object) > size) {
1236 * If firmware is upgraded, new bytes may be added to
1237 * end of objects. It is generally forward compatible
1238 * to zero these bytes - previous behaviour will be
1239 * retained. However this does invalidate the CRC and
1240 * will force fallback mode until the configuration is
1241 * updated. We warn here but do nothing else - the
1242 * malloc has zeroed the entire configuration.
1244 dev_warn(dev, "Zeroing %zu byte(s) in T%d\n",
1245 mxt_obj_size(object) - size, type);
1248 if (instance >= mxt_obj_instances(object)) {
1249 dev_err(dev, "Object instances exceeded!\n");
1253 reg = object->start_address + mxt_obj_size(object) * instance;
1255 for (i = 0; i < size; i++) {
1256 ret = sscanf(cfg->data + data_pos, "%hhx%n",
1260 dev_err(dev, "Bad format in T%d at %d\n",
1266 if (i > mxt_obj_size(object))
1269 byte_offset = reg + i - cfg_start_ofs;
1271 if (byte_offset >= 0 && byte_offset < config_mem_size) {
1272 *(config_mem + byte_offset) = val;
1274 dev_err(dev, "Bad object: reg:%d, T%d, ofs=%d\n",
1275 reg, object->type, byte_offset);
1284 static int mxt_upload_cfg_mem(struct mxt_data *data, unsigned int cfg_start,
1285 u8 *config_mem, size_t config_mem_size)
1287 unsigned int byte_offset = 0;
1290 /* Write configuration as blocks */
1291 while (byte_offset < config_mem_size) {
1292 unsigned int size = config_mem_size - byte_offset;
1294 if (size > MXT_MAX_BLOCK_WRITE)
1295 size = MXT_MAX_BLOCK_WRITE;
1297 error = __mxt_write_reg(data->client,
1298 cfg_start + byte_offset,
1299 size, config_mem + byte_offset);
1301 dev_err(&data->client->dev,
1302 "Config write error, ret=%d\n", error);
1306 byte_offset += size;
1312 static int mxt_init_t7_power_cfg(struct mxt_data *data);
1315 * mxt_update_cfg - download configuration to chip
1317 * Atmel Raw Config File Format
1319 * The first four lines of the raw config file contain:
1321 * 2) Chip ID Information (first 7 bytes of device memory)
1322 * 3) Chip Information Block 24-bit CRC Checksum
1323 * 4) Chip Configuration 24-bit CRC Checksum
1325 * The rest of the file consists of one line per object instance:
1326 * <TYPE> <INSTANCE> <SIZE> <CONTENTS>
1328 * <TYPE> - 2-byte object type as hex
1329 * <INSTANCE> - 2-byte object instance number as hex
1330 * <SIZE> - 2-byte object size as hex
1331 * <CONTENTS> - array of <SIZE> 1-byte hex values
1333 static int mxt_update_cfg(struct mxt_data *data, const struct firmware *cfg)
1335 struct device *dev = &data->client->dev;
1336 struct mxt_info cfg_info;
1342 u32 info_crc, config_crc, calculated_crc;
1344 size_t config_mem_size;
1346 mxt_update_crc(data, MXT_COMMAND_REPORTALL, 1);
1348 if (strncmp(cfg->data, MXT_CFG_MAGIC, strlen(MXT_CFG_MAGIC))) {
1349 dev_err(dev, "Unrecognised config file\n");
1353 data_pos = strlen(MXT_CFG_MAGIC);
1355 /* Load information block and check */
1356 for (i = 0; i < sizeof(struct mxt_info); i++) {
1357 ret = sscanf(cfg->data + data_pos, "%hhx%n",
1358 (unsigned char *)&cfg_info + i,
1361 dev_err(dev, "Bad format\n");
1368 if (cfg_info.family_id != data->info.family_id) {
1369 dev_err(dev, "Family ID mismatch!\n");
1373 if (cfg_info.variant_id != data->info.variant_id) {
1374 dev_err(dev, "Variant ID mismatch!\n");
1379 ret = sscanf(cfg->data + data_pos, "%x%n", &info_crc, &offset);
1381 dev_err(dev, "Bad format: failed to parse Info CRC\n");
1386 ret = sscanf(cfg->data + data_pos, "%x%n", &config_crc, &offset);
1388 dev_err(dev, "Bad format: failed to parse Config CRC\n");
1394 * The Info Block CRC is calculated over mxt_info and the object
1395 * table. If it does not match then we are trying to load the
1396 * configuration from a different chip or firmware version, so
1397 * the configuration CRC is invalid anyway.
1399 if (info_crc == data->info_crc) {
1400 if (config_crc == 0 || data->config_crc == 0) {
1401 dev_info(dev, "CRC zero, attempting to apply config\n");
1402 } else if (config_crc == data->config_crc) {
1403 dev_dbg(dev, "Config CRC 0x%06X: OK\n",
1407 dev_info(dev, "Config CRC 0x%06X: does not match file 0x%06X\n",
1408 data->config_crc, config_crc);
1412 "Warning: Info CRC error - device=0x%06X file=0x%06X\n",
1413 data->info_crc, info_crc);
1416 /* Malloc memory to store configuration */
1417 cfg_start_ofs = MXT_OBJECT_START +
1418 data->info.object_num * sizeof(struct mxt_object) +
1419 MXT_INFO_CHECKSUM_SIZE;
1420 config_mem_size = data->mem_size - cfg_start_ofs;
1421 config_mem = kzalloc(config_mem_size, GFP_KERNEL);
1423 dev_err(dev, "Failed to allocate memory\n");
1427 ret = mxt_prepare_cfg_mem(data, cfg, data_pos, cfg_start_ofs,
1428 config_mem, config_mem_size);
1432 /* Calculate crc of the received configs (not the raw config file) */
1433 if (data->T7_address < cfg_start_ofs) {
1434 dev_err(dev, "Bad T7 address, T7addr = %x, config offset %x\n",
1435 data->T7_address, cfg_start_ofs);
1440 calculated_crc = mxt_calculate_crc(config_mem,
1441 data->T7_address - cfg_start_ofs,
1444 if (config_crc > 0 && config_crc != calculated_crc)
1445 dev_warn(dev, "Config CRC error, calculated=%06X, file=%06X\n",
1446 calculated_crc, config_crc);
1448 ret = mxt_upload_cfg_mem(data, cfg_start_ofs,
1449 config_mem, config_mem_size);
1453 mxt_update_crc(data, MXT_COMMAND_BACKUPNV, MXT_BACKUP_VALUE);
1455 ret = mxt_soft_reset(data);
1459 dev_info(dev, "Config successfully updated\n");
1461 /* T7 config may have changed */
1462 mxt_init_t7_power_cfg(data);
1469 static int mxt_acquire_irq(struct mxt_data *data)
1473 enable_irq(data->irq);
1475 error = mxt_process_messages_until_invalid(data);
1482 static int mxt_get_info(struct mxt_data *data)
1484 struct i2c_client *client = data->client;
1485 struct mxt_info *info = &data->info;
1488 /* Read 7-byte info block starting at address 0 */
1489 error = __mxt_read_reg(client, 0, sizeof(*info), info);
1496 static void mxt_free_input_device(struct mxt_data *data)
1498 if (data->input_dev) {
1499 input_unregister_device(data->input_dev);
1500 data->input_dev = NULL;
1504 static void mxt_free_object_table(struct mxt_data *data)
1506 kfree(data->object_table);
1507 data->object_table = NULL;
1508 kfree(data->msg_buf);
1509 data->msg_buf = NULL;
1510 data->T5_address = 0;
1511 data->T5_msg_size = 0;
1512 data->T6_reportid = 0;
1513 data->T7_address = 0;
1514 data->T9_reportid_min = 0;
1515 data->T9_reportid_max = 0;
1516 data->T19_reportid = 0;
1517 data->T44_address = 0;
1518 data->T100_reportid_min = 0;
1519 data->T100_reportid_max = 0;
1520 data->max_reportid = 0;
1523 static int mxt_get_object_table(struct mxt_data *data)
1525 struct i2c_client *client = data->client;
1527 struct mxt_object *object_table;
1533 table_size = data->info.object_num * sizeof(struct mxt_object);
1534 object_table = kzalloc(table_size, GFP_KERNEL);
1535 if (!object_table) {
1536 dev_err(&data->client->dev, "Failed to allocate memory\n");
1540 error = __mxt_read_reg(client, MXT_OBJECT_START, table_size,
1543 kfree(object_table);
1547 /* Valid Report IDs start counting from 1 */
1550 for (i = 0; i < data->info.object_num; i++) {
1551 struct mxt_object *object = object_table + i;
1554 le16_to_cpus(&object->start_address);
1556 if (object->num_report_ids) {
1558 reportid += object->num_report_ids *
1559 mxt_obj_instances(object);
1560 max_id = reportid - 1;
1566 dev_dbg(&data->client->dev,
1567 "T%u Start:%u Size:%zu Instances:%zu Report IDs:%u-%u\n",
1568 object->type, object->start_address,
1569 mxt_obj_size(object), mxt_obj_instances(object),
1572 switch (object->type) {
1573 case MXT_GEN_MESSAGE_T5:
1574 if (data->info.family_id == 0x80 &&
1575 data->info.version < 0x20) {
1577 * On mXT224 firmware versions prior to V2.0
1578 * read and discard unused CRC byte otherwise
1579 * DMA reads are misaligned.
1581 data->T5_msg_size = mxt_obj_size(object);
1583 /* CRC not enabled, so skip last byte */
1584 data->T5_msg_size = mxt_obj_size(object) - 1;
1586 data->T5_address = object->start_address;
1588 case MXT_GEN_COMMAND_T6:
1589 data->T6_reportid = min_id;
1590 data->T6_address = object->start_address;
1592 case MXT_GEN_POWER_T7:
1593 data->T7_address = object->start_address;
1595 case MXT_TOUCH_MULTI_T9:
1596 data->multitouch = MXT_TOUCH_MULTI_T9;
1597 data->T9_reportid_min = min_id;
1598 data->T9_reportid_max = max_id;
1599 data->num_touchids = object->num_report_ids
1600 * mxt_obj_instances(object);
1602 case MXT_SPT_MESSAGECOUNT_T44:
1603 data->T44_address = object->start_address;
1605 case MXT_SPT_GPIOPWM_T19:
1606 data->T19_reportid = min_id;
1608 case MXT_TOUCH_MULTITOUCHSCREEN_T100:
1609 data->multitouch = MXT_TOUCH_MULTITOUCHSCREEN_T100;
1610 data->T100_reportid_min = min_id;
1611 data->T100_reportid_max = max_id;
1612 /* first two report IDs reserved */
1613 data->num_touchids = object->num_report_ids - 2;
1617 end_address = object->start_address
1618 + mxt_obj_size(object) * mxt_obj_instances(object) - 1;
1620 if (end_address >= data->mem_size)
1621 data->mem_size = end_address + 1;
1624 /* Store maximum reportid */
1625 data->max_reportid = reportid;
1627 /* If T44 exists, T5 position has to be directly after */
1628 if (data->T44_address && (data->T5_address != data->T44_address + 1)) {
1629 dev_err(&client->dev, "Invalid T44 position\n");
1631 goto free_object_table;
1634 data->msg_buf = kcalloc(data->max_reportid,
1635 data->T5_msg_size, GFP_KERNEL);
1636 if (!data->msg_buf) {
1637 dev_err(&client->dev, "Failed to allocate message buffer\n");
1639 goto free_object_table;
1642 data->object_table = object_table;
1647 mxt_free_object_table(data);
1651 static int mxt_read_t9_resolution(struct mxt_data *data)
1653 struct i2c_client *client = data->client;
1655 struct t9_range range;
1656 unsigned char orient;
1657 struct mxt_object *object;
1659 object = mxt_get_object(data, MXT_TOUCH_MULTI_T9);
1663 error = __mxt_read_reg(client,
1664 object->start_address + MXT_T9_RANGE,
1665 sizeof(range), &range);
1669 le16_to_cpus(&range.x);
1670 le16_to_cpus(&range.y);
1672 error = __mxt_read_reg(client,
1673 object->start_address + MXT_T9_ORIENT,
1678 /* Handle default values */
1685 if (orient & MXT_T9_ORIENT_SWITCH) {
1686 data->max_x = range.y;
1687 data->max_y = range.x;
1689 data->max_x = range.x;
1690 data->max_y = range.y;
1693 dev_dbg(&client->dev,
1694 "Touchscreen size X%uY%u\n", data->max_x, data->max_y);
1699 static int mxt_read_t100_config(struct mxt_data *data)
1701 struct i2c_client *client = data->client;
1703 struct mxt_object *object;
1704 u16 range_x, range_y;
1708 object = mxt_get_object(data, MXT_TOUCH_MULTITOUCHSCREEN_T100);
1712 error = __mxt_read_reg(client,
1713 object->start_address + MXT_T100_XRANGE,
1714 sizeof(range_x), &range_x);
1718 le16_to_cpus(&range_x);
1720 error = __mxt_read_reg(client,
1721 object->start_address + MXT_T100_YRANGE,
1722 sizeof(range_y), &range_y);
1726 le16_to_cpus(&range_y);
1728 error = __mxt_read_reg(client,
1729 object->start_address + MXT_T100_CFG1,
1734 error = __mxt_read_reg(client,
1735 object->start_address + MXT_T100_TCHAUX,
1740 /* Handle default values */
1747 if (cfg & MXT_T100_CFG_SWITCHXY) {
1748 data->max_x = range_y;
1749 data->max_y = range_x;
1751 data->max_x = range_x;
1752 data->max_y = range_y;
1755 /* allocate aux bytes */
1758 if (tchaux & MXT_T100_TCHAUX_VECT)
1759 data->t100_aux_vect = aux++;
1761 if (tchaux & MXT_T100_TCHAUX_AMPL)
1762 data->t100_aux_ampl = aux++;
1764 if (tchaux & MXT_T100_TCHAUX_AREA)
1765 data->t100_aux_area = aux++;
1767 dev_dbg(&client->dev,
1768 "T100 aux mappings vect:%u ampl:%u area:%u\n",
1769 data->t100_aux_vect, data->t100_aux_ampl, data->t100_aux_area);
1771 dev_info(&client->dev,
1772 "T100 Touchscreen size X%uY%u\n", data->max_x, data->max_y);
1777 static int mxt_input_open(struct input_dev *dev);
1778 static void mxt_input_close(struct input_dev *dev);
1780 static void mxt_set_up_as_touchpad(struct input_dev *input_dev,
1781 struct mxt_data *data)
1783 const struct mxt_platform_data *pdata = data->pdata;
1786 input_dev->name = "Atmel maXTouch Touchpad";
1788 __set_bit(INPUT_PROP_BUTTONPAD, input_dev->propbit);
1790 input_abs_set_res(input_dev, ABS_X, MXT_PIXELS_PER_MM);
1791 input_abs_set_res(input_dev, ABS_Y, MXT_PIXELS_PER_MM);
1792 input_abs_set_res(input_dev, ABS_MT_POSITION_X,
1794 input_abs_set_res(input_dev, ABS_MT_POSITION_Y,
1797 for (i = 0; i < pdata->t19_num_keys; i++)
1798 if (pdata->t19_keymap[i] != KEY_RESERVED)
1799 input_set_capability(input_dev, EV_KEY,
1800 pdata->t19_keymap[i]);
1803 static int mxt_initialize_input_device(struct mxt_data *data)
1805 const struct mxt_platform_data *pdata = data->pdata;
1806 struct device *dev = &data->client->dev;
1807 struct input_dev *input_dev;
1809 unsigned int num_mt_slots;
1810 unsigned int mt_flags = 0;
1812 switch (data->multitouch) {
1813 case MXT_TOUCH_MULTI_T9:
1814 num_mt_slots = data->T9_reportid_max - data->T9_reportid_min + 1;
1815 error = mxt_read_t9_resolution(data);
1817 dev_warn(dev, "Failed to initialize T9 resolution\n");
1820 case MXT_TOUCH_MULTITOUCHSCREEN_T100:
1821 num_mt_slots = data->num_touchids;
1822 error = mxt_read_t100_config(data);
1824 dev_warn(dev, "Failed to read T100 config\n");
1828 dev_err(dev, "Invalid multitouch object\n");
1832 input_dev = input_allocate_device();
1834 dev_err(dev, "Failed to allocate memory\n");
1838 input_dev->name = "Atmel maXTouch Touchscreen";
1839 input_dev->phys = data->phys;
1840 input_dev->id.bustype = BUS_I2C;
1841 input_dev->dev.parent = dev;
1842 input_dev->open = mxt_input_open;
1843 input_dev->close = mxt_input_close;
1845 input_set_capability(input_dev, EV_KEY, BTN_TOUCH);
1847 /* For single touch */
1848 input_set_abs_params(input_dev, ABS_X, 0, data->max_x, 0, 0);
1849 input_set_abs_params(input_dev, ABS_Y, 0, data->max_y, 0, 0);
1851 if (data->multitouch == MXT_TOUCH_MULTI_T9 ||
1852 (data->multitouch == MXT_TOUCH_MULTITOUCHSCREEN_T100 &&
1853 data->t100_aux_ampl)) {
1854 input_set_abs_params(input_dev, ABS_PRESSURE, 0, 255, 0, 0);
1857 /* If device has buttons we assume it is a touchpad */
1858 if (pdata->t19_num_keys) {
1859 mxt_set_up_as_touchpad(input_dev, data);
1860 mt_flags |= INPUT_MT_POINTER;
1862 mt_flags |= INPUT_MT_DIRECT;
1865 /* For multi touch */
1866 error = input_mt_init_slots(input_dev, num_mt_slots, mt_flags);
1868 dev_err(dev, "Error %d initialising slots\n", error);
1872 if (data->multitouch == MXT_TOUCH_MULTITOUCHSCREEN_T100) {
1873 input_set_abs_params(input_dev, ABS_MT_TOOL_TYPE,
1874 0, MT_TOOL_MAX, 0, 0);
1875 input_set_abs_params(input_dev, ABS_MT_DISTANCE,
1876 MXT_DISTANCE_ACTIVE_TOUCH,
1877 MXT_DISTANCE_HOVERING,
1881 input_set_abs_params(input_dev, ABS_MT_POSITION_X,
1882 0, data->max_x, 0, 0);
1883 input_set_abs_params(input_dev, ABS_MT_POSITION_Y,
1884 0, data->max_y, 0, 0);
1886 if (data->multitouch == MXT_TOUCH_MULTI_T9 ||
1887 (data->multitouch == MXT_TOUCH_MULTITOUCHSCREEN_T100 &&
1888 data->t100_aux_area)) {
1889 input_set_abs_params(input_dev, ABS_MT_TOUCH_MAJOR,
1890 0, MXT_MAX_AREA, 0, 0);
1893 if (data->multitouch == MXT_TOUCH_MULTI_T9 ||
1894 (data->multitouch == MXT_TOUCH_MULTITOUCHSCREEN_T100 &&
1895 data->t100_aux_ampl)) {
1896 input_set_abs_params(input_dev, ABS_MT_PRESSURE,
1900 if (data->multitouch == MXT_TOUCH_MULTITOUCHSCREEN_T100 &&
1901 data->t100_aux_vect) {
1902 input_set_abs_params(input_dev, ABS_MT_ORIENTATION,
1906 if (data->multitouch == MXT_TOUCH_MULTITOUCHSCREEN_T100 &&
1907 data->t100_aux_ampl) {
1908 input_set_abs_params(input_dev, ABS_MT_PRESSURE,
1912 if (data->multitouch == MXT_TOUCH_MULTITOUCHSCREEN_T100 &&
1913 data->t100_aux_vect) {
1914 input_set_abs_params(input_dev, ABS_MT_ORIENTATION,
1918 input_set_drvdata(input_dev, data);
1920 error = input_register_device(input_dev);
1922 dev_err(dev, "Error %d registering input device\n", error);
1926 data->input_dev = input_dev;
1931 input_free_device(input_dev);
1935 static int mxt_configure_objects(struct mxt_data *data,
1936 const struct firmware *cfg);
1938 static void mxt_config_cb(const struct firmware *cfg, void *ctx)
1940 mxt_configure_objects(ctx, cfg);
1941 release_firmware(cfg);
1944 static int mxt_initialize(struct mxt_data *data)
1946 struct i2c_client *client = data->client;
1947 int recovery_attempts = 0;
1951 error = mxt_get_info(data);
1955 /* Check bootloader state */
1956 error = mxt_probe_bootloader(data, false);
1958 dev_info(&client->dev, "Trying alternate bootloader address\n");
1959 error = mxt_probe_bootloader(data, true);
1961 /* Chip is not in appmode or bootloader mode */
1966 /* OK, we are in bootloader, see if we can recover */
1967 if (++recovery_attempts > 1) {
1968 dev_err(&client->dev, "Could not recover from bootloader mode\n");
1970 * We can reflash from this state, so do not
1971 * abort initialization.
1973 data->in_bootloader = true;
1977 /* Attempt to exit bootloader into app mode */
1978 mxt_send_bootloader_cmd(data, false);
1979 msleep(MXT_FW_RESET_TIME);
1982 /* Get object table information */
1983 error = mxt_get_object_table(data);
1985 dev_err(&client->dev, "Error %d reading object table\n", error);
1989 error = mxt_acquire_irq(data);
1991 goto err_free_object_table;
1993 error = request_firmware_nowait(THIS_MODULE, true, MXT_CFG_NAME,
1994 &client->dev, GFP_KERNEL, data,
1997 dev_err(&client->dev, "Failed to invoke firmware loader: %d\n",
1999 goto err_free_object_table;
2004 err_free_object_table:
2005 mxt_free_object_table(data);
2009 static int mxt_set_t7_power_cfg(struct mxt_data *data, u8 sleep)
2011 struct device *dev = &data->client->dev;
2013 struct t7_config *new_config;
2014 struct t7_config deepsleep = { .active = 0, .idle = 0 };
2016 if (sleep == MXT_POWER_CFG_DEEPSLEEP)
2017 new_config = &deepsleep;
2019 new_config = &data->t7_cfg;
2021 error = __mxt_write_reg(data->client, data->T7_address,
2022 sizeof(data->t7_cfg), new_config);
2026 dev_dbg(dev, "Set T7 ACTV:%d IDLE:%d\n",
2027 new_config->active, new_config->idle);
2032 static int mxt_init_t7_power_cfg(struct mxt_data *data)
2034 struct device *dev = &data->client->dev;
2039 error = __mxt_read_reg(data->client, data->T7_address,
2040 sizeof(data->t7_cfg), &data->t7_cfg);
2044 if (data->t7_cfg.active == 0 || data->t7_cfg.idle == 0) {
2046 dev_dbg(dev, "T7 cfg zero, resetting\n");
2047 mxt_soft_reset(data);
2051 dev_dbg(dev, "T7 cfg zero after reset, overriding\n");
2052 data->t7_cfg.active = 20;
2053 data->t7_cfg.idle = 100;
2054 return mxt_set_t7_power_cfg(data, MXT_POWER_CFG_RUN);
2058 dev_dbg(dev, "Initialized power cfg: ACTV %d, IDLE %d\n",
2059 data->t7_cfg.active, data->t7_cfg.idle);
2063 static int mxt_configure_objects(struct mxt_data *data,
2064 const struct firmware *cfg)
2066 struct device *dev = &data->client->dev;
2067 struct mxt_info *info = &data->info;
2070 error = mxt_init_t7_power_cfg(data);
2072 dev_err(dev, "Failed to initialize power cfg\n");
2077 error = mxt_update_cfg(data, cfg);
2079 dev_warn(dev, "Error %d updating config\n", error);
2082 if (data->multitouch) {
2083 error = mxt_initialize_input_device(data);
2087 dev_warn(dev, "No touch object detected\n");
2091 "Family: %u Variant: %u Firmware V%u.%u.%02X Objects: %u\n",
2092 info->family_id, info->variant_id, info->version >> 4,
2093 info->version & 0xf, info->build, info->object_num);
2098 /* Firmware Version is returned as Major.Minor.Build */
2099 static ssize_t mxt_fw_version_show(struct device *dev,
2100 struct device_attribute *attr, char *buf)
2102 struct mxt_data *data = dev_get_drvdata(dev);
2103 struct mxt_info *info = &data->info;
2104 return scnprintf(buf, PAGE_SIZE, "%u.%u.%02X\n",
2105 info->version >> 4, info->version & 0xf, info->build);
2108 /* Hardware Version is returned as FamilyID.VariantID */
2109 static ssize_t mxt_hw_version_show(struct device *dev,
2110 struct device_attribute *attr, char *buf)
2112 struct mxt_data *data = dev_get_drvdata(dev);
2113 struct mxt_info *info = &data->info;
2114 return scnprintf(buf, PAGE_SIZE, "%u.%u\n",
2115 info->family_id, info->variant_id);
2118 static ssize_t mxt_show_instance(char *buf, int count,
2119 struct mxt_object *object, int instance,
2124 if (mxt_obj_instances(object) > 1)
2125 count += scnprintf(buf + count, PAGE_SIZE - count,
2126 "Instance %u\n", instance);
2128 for (i = 0; i < mxt_obj_size(object); i++)
2129 count += scnprintf(buf + count, PAGE_SIZE - count,
2130 "\t[%2u]: %02x (%d)\n", i, val[i], val[i]);
2131 count += scnprintf(buf + count, PAGE_SIZE - count, "\n");
2136 static ssize_t mxt_object_show(struct device *dev,
2137 struct device_attribute *attr, char *buf)
2139 struct mxt_data *data = dev_get_drvdata(dev);
2140 struct mxt_object *object;
2146 /* Pre-allocate buffer large enough to hold max sized object. */
2147 obuf = kmalloc(256, GFP_KERNEL);
2152 for (i = 0; i < data->info.object_num; i++) {
2153 object = data->object_table + i;
2155 if (!mxt_object_readable(object->type))
2158 count += scnprintf(buf + count, PAGE_SIZE - count,
2159 "T%u:\n", object->type);
2161 for (j = 0; j < mxt_obj_instances(object); j++) {
2162 u16 size = mxt_obj_size(object);
2163 u16 addr = object->start_address + j * size;
2165 error = __mxt_read_reg(data->client, addr, size, obuf);
2169 count = mxt_show_instance(buf, count, object, j, obuf);
2175 return error ?: count;
2178 static int mxt_check_firmware_format(struct device *dev,
2179 const struct firmware *fw)
2181 unsigned int pos = 0;
2184 while (pos < fw->size) {
2185 c = *(fw->data + pos);
2187 if (c < '0' || (c > '9' && c < 'A') || c > 'F')
2194 * To convert file try:
2195 * xxd -r -p mXTXXX__APP_VX-X-XX.enc > maxtouch.fw
2197 dev_err(dev, "Aborting: firmware file must be in binary format\n");
2202 static int mxt_load_fw(struct device *dev, const char *fn)
2204 struct mxt_data *data = dev_get_drvdata(dev);
2205 const struct firmware *fw = NULL;
2206 unsigned int frame_size;
2207 unsigned int pos = 0;
2208 unsigned int retry = 0;
2209 unsigned int frame = 0;
2212 ret = request_firmware(&fw, fn, dev);
2214 dev_err(dev, "Unable to open firmware %s\n", fn);
2218 /* Check for incorrect enc file */
2219 ret = mxt_check_firmware_format(dev, fw);
2221 goto release_firmware;
2223 if (!data->in_bootloader) {
2224 /* Change to the bootloader mode */
2225 data->in_bootloader = true;
2227 ret = mxt_t6_command(data, MXT_COMMAND_RESET,
2228 MXT_BOOT_VALUE, false);
2230 goto release_firmware;
2232 msleep(MXT_RESET_TIME);
2234 /* Do not need to scan since we know family ID */
2235 ret = mxt_lookup_bootloader_address(data, 0);
2237 goto release_firmware;
2239 mxt_free_input_device(data);
2240 mxt_free_object_table(data);
2242 enable_irq(data->irq);
2245 reinit_completion(&data->bl_completion);
2247 ret = mxt_check_bootloader(data, MXT_WAITING_BOOTLOAD_CMD, false);
2249 /* Bootloader may still be unlocked from previous attempt */
2250 ret = mxt_check_bootloader(data, MXT_WAITING_FRAME_DATA, false);
2254 dev_info(dev, "Unlocking bootloader\n");
2256 /* Unlock bootloader */
2257 ret = mxt_send_bootloader_cmd(data, true);
2262 while (pos < fw->size) {
2263 ret = mxt_check_bootloader(data, MXT_WAITING_FRAME_DATA, true);
2267 frame_size = ((*(fw->data + pos) << 8) | *(fw->data + pos + 1));
2269 /* Take account of CRC bytes */
2272 /* Write one frame to device */
2273 ret = mxt_bootloader_write(data, fw->data + pos, frame_size);
2277 ret = mxt_check_bootloader(data, MXT_FRAME_CRC_PASS, true);
2281 /* Back off by 20ms per retry */
2285 dev_err(dev, "Retry count exceeded\n");
2294 if (frame % 50 == 0)
2295 dev_dbg(dev, "Sent %d frames, %d/%zd bytes\n",
2296 frame, pos, fw->size);
2299 /* Wait for flash. */
2300 ret = mxt_wait_for_completion(data, &data->bl_completion,
2305 dev_dbg(dev, "Sent %d frames, %d bytes\n", frame, pos);
2308 * Wait for device to reset. Some bootloader versions do not assert
2309 * the CHG line after bootloading has finished, so ignore potential
2312 mxt_wait_for_completion(data, &data->bl_completion, MXT_FW_RESET_TIME);
2314 data->in_bootloader = false;
2317 disable_irq(data->irq);
2319 release_firmware(fw);
2323 static ssize_t mxt_update_fw_store(struct device *dev,
2324 struct device_attribute *attr,
2325 const char *buf, size_t count)
2327 struct mxt_data *data = dev_get_drvdata(dev);
2330 error = mxt_load_fw(dev, MXT_FW_NAME);
2332 dev_err(dev, "The firmware update failed(%d)\n", error);
2335 dev_info(dev, "The firmware update succeeded\n");
2337 error = mxt_initialize(data);
2345 static DEVICE_ATTR(fw_version, S_IRUGO, mxt_fw_version_show, NULL);
2346 static DEVICE_ATTR(hw_version, S_IRUGO, mxt_hw_version_show, NULL);
2347 static DEVICE_ATTR(object, S_IRUGO, mxt_object_show, NULL);
2348 static DEVICE_ATTR(update_fw, S_IWUSR, NULL, mxt_update_fw_store);
2350 static struct attribute *mxt_attrs[] = {
2351 &dev_attr_fw_version.attr,
2352 &dev_attr_hw_version.attr,
2353 &dev_attr_object.attr,
2354 &dev_attr_update_fw.attr,
2358 static const struct attribute_group mxt_attr_group = {
2362 static void mxt_start(struct mxt_data *data)
2364 switch (data->pdata->suspend_mode) {
2365 case MXT_SUSPEND_T9_CTRL:
2366 mxt_soft_reset(data);
2369 /* 0x83 = SCANEN | RPTEN | ENABLE */
2370 mxt_write_object(data,
2371 MXT_TOUCH_MULTI_T9, MXT_T9_CTRL, 0x83);
2374 case MXT_SUSPEND_DEEP_SLEEP:
2376 mxt_set_t7_power_cfg(data, MXT_POWER_CFG_RUN);
2378 /* Recalibrate since chip has been in deep sleep */
2379 mxt_t6_command(data, MXT_COMMAND_CALIBRATE, 1, false);
2385 static void mxt_stop(struct mxt_data *data)
2387 switch (data->pdata->suspend_mode) {
2388 case MXT_SUSPEND_T9_CTRL:
2390 mxt_write_object(data,
2391 MXT_TOUCH_MULTI_T9, MXT_T9_CTRL, 0);
2394 case MXT_SUSPEND_DEEP_SLEEP:
2396 mxt_set_t7_power_cfg(data, MXT_POWER_CFG_DEEPSLEEP);
2401 static int mxt_input_open(struct input_dev *dev)
2403 struct mxt_data *data = input_get_drvdata(dev);
2410 static void mxt_input_close(struct input_dev *dev)
2412 struct mxt_data *data = input_get_drvdata(dev);
2418 static const struct mxt_platform_data *mxt_parse_dt(struct i2c_client *client)
2420 struct mxt_platform_data *pdata;
2421 struct device_node *np = client->dev.of_node;
2426 return ERR_PTR(-ENOENT);
2428 pdata = devm_kzalloc(&client->dev, sizeof(*pdata), GFP_KERNEL);
2430 return ERR_PTR(-ENOMEM);
2432 if (of_find_property(np, "linux,gpio-keymap", &proplen)) {
2433 pdata->t19_num_keys = proplen / sizeof(u32);
2435 keymap = devm_kzalloc(&client->dev,
2436 pdata->t19_num_keys * sizeof(keymap[0]),
2439 return ERR_PTR(-ENOMEM);
2441 ret = of_property_read_u32_array(np, "linux,gpio-keymap",
2442 keymap, pdata->t19_num_keys);
2444 dev_warn(&client->dev,
2445 "Couldn't read linux,gpio-keymap: %d\n", ret);
2447 pdata->t19_keymap = keymap;
2450 pdata->suspend_mode = MXT_SUSPEND_DEEP_SLEEP;
2455 static const struct mxt_platform_data *mxt_parse_dt(struct i2c_client *client)
2457 return ERR_PTR(-ENOENT);
2463 struct mxt_acpi_platform_data {
2465 struct mxt_platform_data pdata;
2468 static unsigned int samus_touchpad_buttons[] = {
2475 static struct mxt_acpi_platform_data samus_platform_data[] = {
2480 .t19_num_keys = ARRAY_SIZE(samus_touchpad_buttons),
2481 .t19_keymap = samus_touchpad_buttons,
2491 static const struct dmi_system_id mxt_dmi_table[] = {
2493 /* 2015 Google Pixel */
2494 .ident = "Chromebook Pixel 2",
2496 DMI_MATCH(DMI_SYS_VENDOR, "GOOGLE"),
2497 DMI_MATCH(DMI_PRODUCT_NAME, "Samus"),
2499 .driver_data = samus_platform_data,
2504 static const struct mxt_platform_data *mxt_parse_acpi(struct i2c_client *client)
2506 struct acpi_device *adev;
2507 const struct dmi_system_id *system_id;
2508 const struct mxt_acpi_platform_data *acpi_pdata;
2511 * Ignore ACPI devices representing bootloader mode.
2513 * This is a bit of a hack: Google Chromebook BIOS creates ACPI
2514 * devices for both application and bootloader modes, but we are
2515 * interested in application mode only (if device is in bootloader
2516 * mode we'll end up switching into application anyway). So far
2517 * application mode addresses were all above 0x40, so we'll use it
2520 if (client->addr < 0x40)
2521 return ERR_PTR(-ENXIO);
2523 adev = ACPI_COMPANION(&client->dev);
2525 return ERR_PTR(-ENOENT);
2527 system_id = dmi_first_match(mxt_dmi_table);
2529 return ERR_PTR(-ENOENT);
2531 acpi_pdata = system_id->driver_data;
2533 return ERR_PTR(-ENOENT);
2535 while (acpi_pdata->hid) {
2536 if (!strcmp(acpi_device_hid(adev), acpi_pdata->hid))
2537 return &acpi_pdata->pdata;
2542 return ERR_PTR(-ENOENT);
2545 static const struct mxt_platform_data *mxt_parse_acpi(struct i2c_client *client)
2547 return ERR_PTR(-ENOENT);
2551 static const struct mxt_platform_data *
2552 mxt_get_platform_data(struct i2c_client *client)
2554 const struct mxt_platform_data *pdata;
2556 pdata = dev_get_platdata(&client->dev);
2560 pdata = mxt_parse_dt(client);
2561 if (!IS_ERR(pdata) || PTR_ERR(pdata) != -ENOENT)
2564 pdata = mxt_parse_acpi(client);
2565 if (!IS_ERR(pdata) || PTR_ERR(pdata) != -ENOENT)
2568 dev_err(&client->dev, "No platform data specified\n");
2569 return ERR_PTR(-EINVAL);
2572 static int mxt_probe(struct i2c_client *client, const struct i2c_device_id *id)
2574 struct mxt_data *data;
2575 const struct mxt_platform_data *pdata;
2578 pdata = mxt_get_platform_data(client);
2580 return PTR_ERR(pdata);
2582 data = kzalloc(sizeof(struct mxt_data), GFP_KERNEL);
2584 dev_err(&client->dev, "Failed to allocate memory\n");
2588 snprintf(data->phys, sizeof(data->phys), "i2c-%u-%04x/input0",
2589 client->adapter->nr, client->addr);
2591 data->client = client;
2592 data->pdata = pdata;
2593 data->irq = client->irq;
2594 i2c_set_clientdata(client, data);
2596 init_completion(&data->bl_completion);
2597 init_completion(&data->reset_completion);
2598 init_completion(&data->crc_completion);
2600 error = request_threaded_irq(client->irq, NULL, mxt_interrupt,
2601 pdata->irqflags | IRQF_ONESHOT,
2602 client->name, data);
2604 dev_err(&client->dev, "Failed to register interrupt\n");
2608 disable_irq(client->irq);
2610 error = mxt_initialize(data);
2614 error = sysfs_create_group(&client->dev.kobj, &mxt_attr_group);
2616 dev_err(&client->dev, "Failure %d creating sysfs group\n",
2618 goto err_free_object;
2624 mxt_free_input_device(data);
2625 mxt_free_object_table(data);
2627 free_irq(client->irq, data);
2633 static int mxt_remove(struct i2c_client *client)
2635 struct mxt_data *data = i2c_get_clientdata(client);
2637 sysfs_remove_group(&client->dev.kobj, &mxt_attr_group);
2638 free_irq(data->irq, data);
2639 mxt_free_input_device(data);
2640 mxt_free_object_table(data);
2646 static int __maybe_unused mxt_suspend(struct device *dev)
2648 struct i2c_client *client = to_i2c_client(dev);
2649 struct mxt_data *data = i2c_get_clientdata(client);
2650 struct input_dev *input_dev = data->input_dev;
2655 mutex_lock(&input_dev->mutex);
2657 if (input_dev->users)
2660 mutex_unlock(&input_dev->mutex);
2665 static int __maybe_unused mxt_resume(struct device *dev)
2667 struct i2c_client *client = to_i2c_client(dev);
2668 struct mxt_data *data = i2c_get_clientdata(client);
2669 struct input_dev *input_dev = data->input_dev;
2674 mutex_lock(&input_dev->mutex);
2676 if (input_dev->users)
2679 mutex_unlock(&input_dev->mutex);
2684 static SIMPLE_DEV_PM_OPS(mxt_pm_ops, mxt_suspend, mxt_resume);
2686 static const struct of_device_id mxt_of_match[] = {
2687 { .compatible = "atmel,maxtouch", },
2690 MODULE_DEVICE_TABLE(of, mxt_of_match);
2693 static const struct acpi_device_id mxt_acpi_id[] = {
2694 { "ATML0000", 0 }, /* Touchpad */
2695 { "ATML0001", 0 }, /* Touchscreen */
2698 MODULE_DEVICE_TABLE(acpi, mxt_acpi_id);
2701 static const struct i2c_device_id mxt_id[] = {
2702 { "qt602240_ts", 0 },
2703 { "atmel_mxt_ts", 0 },
2704 { "atmel_mxt_tp", 0 },
2708 MODULE_DEVICE_TABLE(i2c, mxt_id);
2710 static struct i2c_driver mxt_driver = {
2712 .name = "atmel_mxt_ts",
2713 .of_match_table = of_match_ptr(mxt_of_match),
2714 .acpi_match_table = ACPI_PTR(mxt_acpi_id),
2718 .remove = mxt_remove,
2722 module_i2c_driver(mxt_driver);
2724 /* Module information */
2725 MODULE_AUTHOR("Joonyoung Shim <jy0922.shim@samsung.com>");
2726 MODULE_DESCRIPTION("Atmel maXTouch Touchscreen driver");
2727 MODULE_LICENSE("GPL");