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/module.h>
18 #include <linux/init.h>
19 #include <linux/completion.h>
20 #include <linux/delay.h>
21 #include <linux/firmware.h>
22 #include <linux/i2c.h>
23 #include <linux/i2c/atmel_mxt_ts.h>
24 #include <linux/input/mt.h>
25 #include <linux/interrupt.h>
27 #include <linux/slab.h>
35 #define MXT_FW_NAME "maxtouch.fw"
36 #define MXT_CFG_NAME "maxtouch.cfg"
37 #define MXT_CFG_MAGIC "OBP_RAW V1"
41 #define MXT_FAMILY_ID 0x00
42 #define MXT_VARIANT_ID 0x01
43 #define MXT_VERSION 0x02
44 #define MXT_BUILD 0x03
45 #define MXT_MATRIX_X_SIZE 0x04
46 #define MXT_MATRIX_Y_SIZE 0x05
47 #define MXT_OBJECT_NUM 0x06
48 #define MXT_OBJECT_START 0x07
50 #define MXT_OBJECT_SIZE 6
51 #define MXT_INFO_CHECKSUM_SIZE 3
52 #define MXT_MAX_BLOCK_WRITE 256
55 #define MXT_DEBUG_DIAGNOSTIC_T37 37
56 #define MXT_GEN_MESSAGE_T5 5
57 #define MXT_GEN_COMMAND_T6 6
58 #define MXT_GEN_POWER_T7 7
59 #define MXT_GEN_ACQUIRE_T8 8
60 #define MXT_GEN_DATASOURCE_T53 53
61 #define MXT_TOUCH_MULTI_T9 9
62 #define MXT_TOUCH_KEYARRAY_T15 15
63 #define MXT_TOUCH_PROXIMITY_T23 23
64 #define MXT_TOUCH_PROXKEY_T52 52
65 #define MXT_PROCI_GRIPFACE_T20 20
66 #define MXT_PROCG_NOISE_T22 22
67 #define MXT_PROCI_ONETOUCH_T24 24
68 #define MXT_PROCI_TWOTOUCH_T27 27
69 #define MXT_PROCI_GRIP_T40 40
70 #define MXT_PROCI_PALM_T41 41
71 #define MXT_PROCI_TOUCHSUPPRESSION_T42 42
72 #define MXT_PROCI_STYLUS_T47 47
73 #define MXT_PROCG_NOISESUPPRESSION_T48 48
74 #define MXT_SPT_COMMSCONFIG_T18 18
75 #define MXT_SPT_GPIOPWM_T19 19
76 #define MXT_SPT_SELFTEST_T25 25
77 #define MXT_SPT_CTECONFIG_T28 28
78 #define MXT_SPT_USERDATA_T38 38
79 #define MXT_SPT_DIGITIZER_T43 43
80 #define MXT_SPT_MESSAGECOUNT_T44 44
81 #define MXT_SPT_CTECONFIG_T46 46
83 /* MXT_GEN_MESSAGE_T5 object */
84 #define MXT_RPTID_NOMSG 0xff
86 /* MXT_GEN_COMMAND_T6 field */
87 #define MXT_COMMAND_RESET 0
88 #define MXT_COMMAND_BACKUPNV 1
89 #define MXT_COMMAND_CALIBRATE 2
90 #define MXT_COMMAND_REPORTALL 3
91 #define MXT_COMMAND_DIAGNOSTIC 5
93 /* Define for T6 status byte */
94 #define MXT_T6_STATUS_RESET (1 << 7)
95 #define MXT_T6_STATUS_OFL (1 << 6)
96 #define MXT_T6_STATUS_SIGERR (1 << 5)
97 #define MXT_T6_STATUS_CAL (1 << 4)
98 #define MXT_T6_STATUS_CFGERR (1 << 3)
99 #define MXT_T6_STATUS_COMSERR (1 << 2)
101 /* MXT_GEN_POWER_T7 field */
107 #define MXT_POWER_CFG_RUN 0
108 #define MXT_POWER_CFG_DEEPSLEEP 1
110 /* MXT_GEN_ACQUIRE_T8 field */
111 #define MXT_ACQUIRE_CHRGTIME 0
112 #define MXT_ACQUIRE_TCHDRIFT 2
113 #define MXT_ACQUIRE_DRIFTST 3
114 #define MXT_ACQUIRE_TCHAUTOCAL 4
115 #define MXT_ACQUIRE_SYNC 5
116 #define MXT_ACQUIRE_ATCHCALST 6
117 #define MXT_ACQUIRE_ATCHCALSTHR 7
119 /* MXT_TOUCH_MULTI_T9 field */
120 #define MXT_T9_ORIENT 9
121 #define MXT_T9_RANGE 18
123 /* MXT_TOUCH_MULTI_T9 status */
124 #define MXT_T9_UNGRIP (1 << 0)
125 #define MXT_T9_SUPPRESS (1 << 1)
126 #define MXT_T9_AMP (1 << 2)
127 #define MXT_T9_VECTOR (1 << 3)
128 #define MXT_T9_MOVE (1 << 4)
129 #define MXT_T9_RELEASE (1 << 5)
130 #define MXT_T9_PRESS (1 << 6)
131 #define MXT_T9_DETECT (1 << 7)
138 /* MXT_TOUCH_MULTI_T9 orient */
139 #define MXT_T9_ORIENT_SWITCH (1 << 0)
141 /* MXT_PROCI_GRIPFACE_T20 field */
142 #define MXT_GRIPFACE_CTRL 0
143 #define MXT_GRIPFACE_XLOGRIP 1
144 #define MXT_GRIPFACE_XHIGRIP 2
145 #define MXT_GRIPFACE_YLOGRIP 3
146 #define MXT_GRIPFACE_YHIGRIP 4
147 #define MXT_GRIPFACE_MAXTCHS 5
148 #define MXT_GRIPFACE_SZTHR1 7
149 #define MXT_GRIPFACE_SZTHR2 8
150 #define MXT_GRIPFACE_SHPTHR1 9
151 #define MXT_GRIPFACE_SHPTHR2 10
152 #define MXT_GRIPFACE_SUPEXTTO 11
154 /* MXT_PROCI_NOISE field */
155 #define MXT_NOISE_CTRL 0
156 #define MXT_NOISE_OUTFLEN 1
157 #define MXT_NOISE_GCAFUL_LSB 3
158 #define MXT_NOISE_GCAFUL_MSB 4
159 #define MXT_NOISE_GCAFLL_LSB 5
160 #define MXT_NOISE_GCAFLL_MSB 6
161 #define MXT_NOISE_ACTVGCAFVALID 7
162 #define MXT_NOISE_NOISETHR 8
163 #define MXT_NOISE_FREQHOPSCALE 10
164 #define MXT_NOISE_FREQ0 11
165 #define MXT_NOISE_FREQ1 12
166 #define MXT_NOISE_FREQ2 13
167 #define MXT_NOISE_FREQ3 14
168 #define MXT_NOISE_FREQ4 15
169 #define MXT_NOISE_IDLEGCAFVALID 16
171 /* MXT_SPT_COMMSCONFIG_T18 */
172 #define MXT_COMMS_CTRL 0
173 #define MXT_COMMS_CMD 1
175 /* MXT_SPT_CTECONFIG_T28 field */
176 #define MXT_CTE_CTRL 0
177 #define MXT_CTE_CMD 1
178 #define MXT_CTE_MODE 2
179 #define MXT_CTE_IDLEGCAFDEPTH 3
180 #define MXT_CTE_ACTVGCAFDEPTH 4
181 #define MXT_CTE_VOLTAGE 5
183 #define MXT_VOLTAGE_DEFAULT 2700000
184 #define MXT_VOLTAGE_STEP 10000
186 /* Define for MXT_GEN_COMMAND_T6 */
187 #define MXT_BOOT_VALUE 0xa5
188 #define MXT_RESET_VALUE 0x01
189 #define MXT_BACKUP_VALUE 0x55
192 #define MXT_BACKUP_TIME 50 /* msec */
193 #define MXT_RESET_TIME 200 /* msec */
194 #define MXT_RESET_TIMEOUT 3000 /* msec */
195 #define MXT_CRC_TIMEOUT 1000 /* msec */
196 #define MXT_FW_RESET_TIME 3000 /* msec */
197 #define MXT_FW_CHG_TIMEOUT 300 /* msec */
199 /* Command to unlock bootloader */
200 #define MXT_UNLOCK_CMD_MSB 0xaa
201 #define MXT_UNLOCK_CMD_LSB 0xdc
203 /* Bootloader mode status */
204 #define MXT_WAITING_BOOTLOAD_CMD 0xc0 /* valid 7 6 bit only */
205 #define MXT_WAITING_FRAME_DATA 0x80 /* valid 7 6 bit only */
206 #define MXT_FRAME_CRC_CHECK 0x02
207 #define MXT_FRAME_CRC_FAIL 0x03
208 #define MXT_FRAME_CRC_PASS 0x04
209 #define MXT_APP_CRC_FAIL 0x40 /* valid 7 8 bit only */
210 #define MXT_BOOT_STATUS_MASK 0x3f
211 #define MXT_BOOT_EXTENDED_ID (1 << 5)
212 #define MXT_BOOT_ID_MASK 0x1f
214 /* Touchscreen absolute values */
215 #define MXT_MAX_AREA 0xff
217 #define MXT_PIXELS_PER_MM 20
233 u8 instances_minus_one;
237 /* Each client has this additional data */
239 struct i2c_client *client;
240 struct input_dev *input_dev;
241 char phys[64]; /* device physical location */
242 const struct mxt_platform_data *pdata;
243 struct mxt_object *object_table;
244 struct mxt_info info;
257 u8 last_message_count;
259 struct t7_config t7_cfg;
261 /* Cached parameters from object table */
272 /* for fw update in bootloader */
273 struct completion bl_completion;
275 /* for reset handling */
276 struct completion reset_completion;
278 /* for config update handling */
279 struct completion crc_completion;
282 static size_t mxt_obj_size(const struct mxt_object *obj)
284 return obj->size_minus_one + 1;
287 static size_t mxt_obj_instances(const struct mxt_object *obj)
289 return obj->instances_minus_one + 1;
292 static bool mxt_object_readable(unsigned int type)
295 case MXT_GEN_COMMAND_T6:
296 case MXT_GEN_POWER_T7:
297 case MXT_GEN_ACQUIRE_T8:
298 case MXT_GEN_DATASOURCE_T53:
299 case MXT_TOUCH_MULTI_T9:
300 case MXT_TOUCH_KEYARRAY_T15:
301 case MXT_TOUCH_PROXIMITY_T23:
302 case MXT_TOUCH_PROXKEY_T52:
303 case MXT_PROCI_GRIPFACE_T20:
304 case MXT_PROCG_NOISE_T22:
305 case MXT_PROCI_ONETOUCH_T24:
306 case MXT_PROCI_TWOTOUCH_T27:
307 case MXT_PROCI_GRIP_T40:
308 case MXT_PROCI_PALM_T41:
309 case MXT_PROCI_TOUCHSUPPRESSION_T42:
310 case MXT_PROCI_STYLUS_T47:
311 case MXT_PROCG_NOISESUPPRESSION_T48:
312 case MXT_SPT_COMMSCONFIG_T18:
313 case MXT_SPT_GPIOPWM_T19:
314 case MXT_SPT_SELFTEST_T25:
315 case MXT_SPT_CTECONFIG_T28:
316 case MXT_SPT_USERDATA_T38:
317 case MXT_SPT_DIGITIZER_T43:
318 case MXT_SPT_CTECONFIG_T46:
325 static void mxt_dump_message(struct mxt_data *data, u8 *message)
327 dev_dbg(&data->client->dev, "message: %*ph\n",
328 data->T5_msg_size, message);
331 static int mxt_wait_for_completion(struct mxt_data *data,
332 struct completion *comp,
333 unsigned int timeout_ms)
335 struct device *dev = &data->client->dev;
336 unsigned long timeout = msecs_to_jiffies(timeout_ms);
339 ret = wait_for_completion_interruptible_timeout(comp, timeout);
342 } else if (ret == 0) {
343 dev_err(dev, "Wait for completion timed out.\n");
349 static int mxt_bootloader_read(struct mxt_data *data,
350 u8 *val, unsigned int count)
355 msg.addr = data->bootloader_addr;
356 msg.flags = data->client->flags & I2C_M_TEN;
357 msg.flags |= I2C_M_RD;
361 ret = i2c_transfer(data->client->adapter, &msg, 1);
366 ret = ret < 0 ? ret : -EIO;
367 dev_err(&data->client->dev, "%s: i2c recv failed (%d)\n",
374 static int mxt_bootloader_write(struct mxt_data *data,
375 const u8 * const val, unsigned int count)
380 msg.addr = data->bootloader_addr;
381 msg.flags = data->client->flags & I2C_M_TEN;
385 ret = i2c_transfer(data->client->adapter, &msg, 1);
389 ret = ret < 0 ? ret : -EIO;
390 dev_err(&data->client->dev, "%s: i2c send failed (%d)\n",
397 static int mxt_lookup_bootloader_address(struct mxt_data *data, bool retry)
399 u8 appmode = data->client->addr;
405 /* Chips after 1664S use different scheme */
406 if (retry || data->info.family_id >= 0xa2) {
407 bootloader = appmode - 0x24;
410 /* Fall through for normal case */
415 bootloader = appmode - 0x26;
418 dev_err(&data->client->dev,
419 "Appmode i2c address 0x%02x not found\n",
424 data->bootloader_addr = bootloader;
428 static int mxt_probe_bootloader(struct mxt_data *data, bool retry)
430 struct device *dev = &data->client->dev;
435 ret = mxt_lookup_bootloader_address(data, retry);
439 ret = mxt_bootloader_read(data, &val, 1);
443 /* Check app crc fail mode */
444 crc_failure = (val & ~MXT_BOOT_STATUS_MASK) == MXT_APP_CRC_FAIL;
446 dev_err(dev, "Detected bootloader, status:%02X%s\n",
447 val, crc_failure ? ", APP_CRC_FAIL" : "");
452 static u8 mxt_get_bootloader_version(struct mxt_data *data, u8 val)
454 struct device *dev = &data->client->dev;
457 if (val & MXT_BOOT_EXTENDED_ID) {
458 if (mxt_bootloader_read(data, &buf[0], 3) != 0) {
459 dev_err(dev, "%s: i2c failure\n", __func__);
463 dev_dbg(dev, "Bootloader ID:%d Version:%d\n", buf[1], buf[2]);
467 dev_dbg(dev, "Bootloader ID:%d\n", val & MXT_BOOT_ID_MASK);
473 static int mxt_check_bootloader(struct mxt_data *data, unsigned int state,
476 struct device *dev = &data->client->dev;
483 * In application update mode, the interrupt
484 * line signals state transitions. We must wait for the
485 * CHG assertion before reading the status byte.
486 * Once the status byte has been read, the line is deasserted.
488 ret = mxt_wait_for_completion(data, &data->bl_completion,
492 * TODO: handle -ERESTARTSYS better by terminating
493 * fw update process before returning to userspace
494 * by writing length 0x000 to device (iff we are in
495 * WAITING_FRAME_DATA state).
497 dev_err(dev, "Update wait error %d\n", ret);
502 ret = mxt_bootloader_read(data, &val, 1);
506 if (state == MXT_WAITING_BOOTLOAD_CMD)
507 val = mxt_get_bootloader_version(data, val);
510 case MXT_WAITING_BOOTLOAD_CMD:
511 case MXT_WAITING_FRAME_DATA:
512 case MXT_APP_CRC_FAIL:
513 val &= ~MXT_BOOT_STATUS_MASK;
515 case MXT_FRAME_CRC_PASS:
516 if (val == MXT_FRAME_CRC_CHECK) {
518 } else if (val == MXT_FRAME_CRC_FAIL) {
519 dev_err(dev, "Bootloader CRC fail\n");
528 dev_err(dev, "Invalid bootloader state %02X != %02X\n",
536 static int mxt_send_bootloader_cmd(struct mxt_data *data, bool unlock)
542 buf[0] = MXT_UNLOCK_CMD_LSB;
543 buf[1] = MXT_UNLOCK_CMD_MSB;
549 ret = mxt_bootloader_write(data, buf, 2);
556 static int __mxt_read_reg(struct i2c_client *client,
557 u16 reg, u16 len, void *val)
559 struct i2c_msg xfer[2];
564 buf[1] = (reg >> 8) & 0xff;
567 xfer[0].addr = client->addr;
573 xfer[1].addr = client->addr;
574 xfer[1].flags = I2C_M_RD;
578 ret = i2c_transfer(client->adapter, xfer, 2);
584 dev_err(&client->dev, "%s: i2c transfer failed (%d)\n",
591 static int __mxt_write_reg(struct i2c_client *client, u16 reg, u16 len,
599 buf = kmalloc(count, GFP_KERNEL);
604 buf[1] = (reg >> 8) & 0xff;
605 memcpy(&buf[2], val, len);
607 ret = i2c_master_send(client, buf, count);
613 dev_err(&client->dev, "%s: i2c send failed (%d)\n",
621 static int mxt_write_reg(struct i2c_client *client, u16 reg, u8 val)
623 return __mxt_write_reg(client, reg, 1, &val);
626 static struct mxt_object *
627 mxt_get_object(struct mxt_data *data, u8 type)
629 struct mxt_object *object;
632 for (i = 0; i < data->info.object_num; i++) {
633 object = data->object_table + i;
634 if (object->type == type)
638 dev_warn(&data->client->dev, "Invalid object type T%u\n", type);
642 static void mxt_proc_t6_messages(struct mxt_data *data, u8 *msg)
644 struct device *dev = &data->client->dev;
646 u32 crc = msg[2] | (msg[3] << 8) | (msg[4] << 16);
648 complete(&data->crc_completion);
650 if (crc != data->config_crc) {
651 data->config_crc = crc;
652 dev_dbg(dev, "T6 Config Checksum: 0x%06X\n", crc);
656 if (status & MXT_T6_STATUS_RESET)
657 complete(&data->reset_completion);
659 /* Output debug if status has changed */
660 if (status != data->t6_status)
661 dev_dbg(dev, "T6 Status 0x%02X%s%s%s%s%s%s%s\n",
663 status == 0 ? " OK" : "",
664 status & MXT_T6_STATUS_RESET ? " RESET" : "",
665 status & MXT_T6_STATUS_OFL ? " OFL" : "",
666 status & MXT_T6_STATUS_SIGERR ? " SIGERR" : "",
667 status & MXT_T6_STATUS_CAL ? " CAL" : "",
668 status & MXT_T6_STATUS_CFGERR ? " CFGERR" : "",
669 status & MXT_T6_STATUS_COMSERR ? " COMSERR" : "");
671 /* Save current status */
672 data->t6_status = status;
675 static void mxt_input_button(struct mxt_data *data, u8 *message)
677 struct input_dev *input = data->input_dev;
678 const struct mxt_platform_data *pdata = data->pdata;
682 /* Active-low switch */
683 for (i = 0; i < pdata->t19_num_keys; i++) {
684 if (pdata->t19_keymap[i] == KEY_RESERVED)
686 button = !(message[1] & (1 << i));
687 input_report_key(input, pdata->t19_keymap[i], button);
691 static void mxt_input_sync(struct mxt_data *data)
693 input_mt_report_pointer_emulation(data->input_dev,
694 data->pdata->t19_num_keys);
695 input_sync(data->input_dev);
698 static void mxt_proc_t9_message(struct mxt_data *data, u8 *message)
700 struct device *dev = &data->client->dev;
701 struct input_dev *input_dev = data->input_dev;
709 id = message[0] - data->T9_reportid_min;
711 x = (message[2] << 4) | ((message[4] >> 4) & 0xf);
712 y = (message[3] << 4) | ((message[4] & 0xf));
714 /* Handle 10/12 bit switching */
715 if (data->max_x < 1024)
717 if (data->max_y < 1024)
721 amplitude = message[6];
724 "[%u] %c%c%c%c%c%c%c%c x: %5u y: %5u area: %3u amp: %3u\n",
726 (status & MXT_T9_DETECT) ? 'D' : '.',
727 (status & MXT_T9_PRESS) ? 'P' : '.',
728 (status & MXT_T9_RELEASE) ? 'R' : '.',
729 (status & MXT_T9_MOVE) ? 'M' : '.',
730 (status & MXT_T9_VECTOR) ? 'V' : '.',
731 (status & MXT_T9_AMP) ? 'A' : '.',
732 (status & MXT_T9_SUPPRESS) ? 'S' : '.',
733 (status & MXT_T9_UNGRIP) ? 'U' : '.',
734 x, y, area, amplitude);
736 input_mt_slot(input_dev, id);
738 if (status & MXT_T9_DETECT) {
740 * Multiple bits may be set if the host is slow to read
741 * the status messages, indicating all the events that
744 if (status & MXT_T9_RELEASE) {
745 input_mt_report_slot_state(input_dev,
747 mxt_input_sync(data);
751 input_mt_report_slot_state(input_dev, MT_TOOL_FINGER, 1);
752 input_report_abs(input_dev, ABS_MT_POSITION_X, x);
753 input_report_abs(input_dev, ABS_MT_POSITION_Y, y);
754 input_report_abs(input_dev, ABS_MT_PRESSURE, amplitude);
755 input_report_abs(input_dev, ABS_MT_TOUCH_MAJOR, area);
757 /* Touch no longer active, close out slot */
758 input_mt_report_slot_state(input_dev, MT_TOOL_FINGER, 0);
761 data->update_input = true;
764 static int mxt_proc_message(struct mxt_data *data, u8 *message)
766 u8 report_id = message[0];
768 if (report_id == MXT_RPTID_NOMSG)
771 if (report_id == data->T6_reportid) {
772 mxt_proc_t6_messages(data, message);
773 } else if (!data->input_dev) {
775 * Do not report events if input device
776 * is not yet registered.
778 mxt_dump_message(data, message);
779 } else if (report_id >= data->T9_reportid_min
780 && report_id <= data->T9_reportid_max) {
781 mxt_proc_t9_message(data, message);
782 } else if (report_id == data->T19_reportid) {
783 mxt_input_button(data, message);
784 data->update_input = true;
786 mxt_dump_message(data, message);
792 static int mxt_read_and_process_messages(struct mxt_data *data, u8 count)
794 struct device *dev = &data->client->dev;
799 /* Safety check for msg_buf */
800 if (count > data->max_reportid)
803 /* Process remaining messages if necessary */
804 ret = __mxt_read_reg(data->client, data->T5_address,
805 data->T5_msg_size * count, data->msg_buf);
807 dev_err(dev, "Failed to read %u messages (%d)\n", count, ret);
811 for (i = 0; i < count; i++) {
812 ret = mxt_proc_message(data,
813 data->msg_buf + data->T5_msg_size * i);
819 /* return number of messages read */
823 static irqreturn_t mxt_process_messages_t44(struct mxt_data *data)
825 struct device *dev = &data->client->dev;
829 /* Read T44 and T5 together */
830 ret = __mxt_read_reg(data->client, data->T44_address,
831 data->T5_msg_size + 1, data->msg_buf);
833 dev_err(dev, "Failed to read T44 and T5 (%d)\n", ret);
837 count = data->msg_buf[0];
840 dev_warn(dev, "Interrupt triggered but zero messages\n");
842 } else if (count > data->max_reportid) {
843 dev_err(dev, "T44 count %d exceeded max report id\n", count);
844 count = data->max_reportid;
847 /* Process first message */
848 ret = mxt_proc_message(data, data->msg_buf + 1);
850 dev_warn(dev, "Unexpected invalid message\n");
854 num_left = count - 1;
856 /* Process remaining messages if necessary */
858 ret = mxt_read_and_process_messages(data, num_left);
861 else if (ret != num_left)
862 dev_warn(dev, "Unexpected invalid message\n");
866 if (data->update_input) {
867 mxt_input_sync(data);
868 data->update_input = false;
874 static int mxt_process_messages_until_invalid(struct mxt_data *data)
876 struct device *dev = &data->client->dev;
880 count = data->max_reportid;
882 /* Read messages until we force an invalid */
884 read = mxt_read_and_process_messages(data, count);
889 if (data->update_input) {
890 mxt_input_sync(data);
891 data->update_input = false;
894 dev_err(dev, "CHG pin isn't cleared\n");
898 static irqreturn_t mxt_process_messages(struct mxt_data *data)
900 int total_handled, num_handled;
901 u8 count = data->last_message_count;
903 if (count < 1 || count > data->max_reportid)
906 /* include final invalid message */
907 total_handled = mxt_read_and_process_messages(data, count + 1);
908 if (total_handled < 0)
910 /* if there were invalid messages, then we are done */
911 else if (total_handled <= count)
914 /* keep reading two msgs until one is invalid or reportid limit */
916 num_handled = mxt_read_and_process_messages(data, 2);
920 total_handled += num_handled;
924 } while (total_handled < data->num_touchids);
927 data->last_message_count = total_handled;
929 if (data->update_input) {
930 mxt_input_sync(data);
931 data->update_input = false;
937 static irqreturn_t mxt_interrupt(int irq, void *dev_id)
939 struct mxt_data *data = dev_id;
941 if (data->in_bootloader) {
942 /* bootloader state transition completion */
943 complete(&data->bl_completion);
947 if (!data->object_table)
950 if (data->T44_address) {
951 return mxt_process_messages_t44(data);
953 return mxt_process_messages(data);
957 static int mxt_t6_command(struct mxt_data *data, u16 cmd_offset,
962 int timeout_counter = 0;
965 reg = data->T6_address + cmd_offset;
967 ret = mxt_write_reg(data->client, reg, value);
976 ret = __mxt_read_reg(data->client, reg, 1, &command_register);
979 } while (command_register != 0 && timeout_counter++ <= 100);
981 if (timeout_counter > 100) {
982 dev_err(&data->client->dev, "Command failed!\n");
989 static int mxt_soft_reset(struct mxt_data *data)
991 struct device *dev = &data->client->dev;
994 dev_info(dev, "Resetting chip\n");
996 reinit_completion(&data->reset_completion);
998 ret = mxt_t6_command(data, MXT_COMMAND_RESET, MXT_RESET_VALUE, false);
1002 ret = mxt_wait_for_completion(data, &data->reset_completion,
1010 static void mxt_update_crc(struct mxt_data *data, u8 cmd, u8 value)
1013 * On failure, CRC is set to 0 and config will always be
1016 data->config_crc = 0;
1017 reinit_completion(&data->crc_completion);
1019 mxt_t6_command(data, cmd, value, true);
1022 * Wait for crc message. On failure, CRC is set to 0 and config will
1023 * always be downloaded.
1025 mxt_wait_for_completion(data, &data->crc_completion, MXT_CRC_TIMEOUT);
1028 static void mxt_calc_crc24(u32 *crc, u8 firstbyte, u8 secondbyte)
1030 static const unsigned int crcpoly = 0x80001B;
1034 data_word = (secondbyte << 8) | firstbyte;
1035 result = ((*crc << 1) ^ data_word);
1037 if (result & 0x1000000)
1043 static u32 mxt_calculate_crc(u8 *base, off_t start_off, off_t end_off)
1046 u8 *ptr = base + start_off;
1047 u8 *last_val = base + end_off - 1;
1049 if (end_off < start_off)
1052 while (ptr < last_val) {
1053 mxt_calc_crc24(&crc, *ptr, *(ptr + 1));
1057 /* if len is odd, fill the last byte with 0 */
1058 if (ptr == last_val)
1059 mxt_calc_crc24(&crc, *ptr, 0);
1061 /* Mask to 24-bit */
1068 * mxt_update_cfg - download configuration to chip
1070 * Atmel Raw Config File Format
1072 * The first four lines of the raw config file contain:
1074 * 2) Chip ID Information (first 7 bytes of device memory)
1075 * 3) Chip Information Block 24-bit CRC Checksum
1076 * 4) Chip Configuration 24-bit CRC Checksum
1078 * The rest of the file consists of one line per object instance:
1079 * <TYPE> <INSTANCE> <SIZE> <CONTENTS>
1081 * <TYPE> - 2-byte object type as hex
1082 * <INSTANCE> - 2-byte object instance number as hex
1083 * <SIZE> - 2-byte object size as hex
1084 * <CONTENTS> - array of <SIZE> 1-byte hex values
1086 static int mxt_update_cfg(struct mxt_data *data, const struct firmware *cfg)
1088 struct device *dev = &data->client->dev;
1089 struct mxt_info cfg_info;
1090 struct mxt_object *object;
1097 u32 info_crc, config_crc, calculated_crc;
1099 size_t config_mem_size;
1100 unsigned int type, instance, size;
1104 mxt_update_crc(data, MXT_COMMAND_REPORTALL, 1);
1106 if (strncmp(cfg->data, MXT_CFG_MAGIC, strlen(MXT_CFG_MAGIC))) {
1107 dev_err(dev, "Unrecognised config file\n");
1112 data_pos = strlen(MXT_CFG_MAGIC);
1114 /* Load information block and check */
1115 for (i = 0; i < sizeof(struct mxt_info); i++) {
1116 ret = sscanf(cfg->data + data_pos, "%hhx%n",
1117 (unsigned char *)&cfg_info + i,
1120 dev_err(dev, "Bad format\n");
1128 if (cfg_info.family_id != data->info.family_id) {
1129 dev_err(dev, "Family ID mismatch!\n");
1134 if (cfg_info.variant_id != data->info.variant_id) {
1135 dev_err(dev, "Variant ID mismatch!\n");
1141 ret = sscanf(cfg->data + data_pos, "%x%n", &info_crc, &offset);
1143 dev_err(dev, "Bad format: failed to parse Info CRC\n");
1149 ret = sscanf(cfg->data + data_pos, "%x%n", &config_crc, &offset);
1151 dev_err(dev, "Bad format: failed to parse Config CRC\n");
1158 * The Info Block CRC is calculated over mxt_info and the object
1159 * table. If it does not match then we are trying to load the
1160 * configuration from a different chip or firmware version, so
1161 * the configuration CRC is invalid anyway.
1163 if (info_crc == data->info_crc) {
1164 if (config_crc == 0 || data->config_crc == 0) {
1165 dev_info(dev, "CRC zero, attempting to apply config\n");
1166 } else if (config_crc == data->config_crc) {
1167 dev_dbg(dev, "Config CRC 0x%06X: OK\n",
1172 dev_info(dev, "Config CRC 0x%06X: does not match file 0x%06X\n",
1173 data->config_crc, config_crc);
1177 "Warning: Info CRC error - device=0x%06X file=0x%06X\n",
1178 data->info_crc, info_crc);
1181 /* Malloc memory to store configuration */
1182 cfg_start_ofs = MXT_OBJECT_START +
1183 data->info.object_num * sizeof(struct mxt_object) +
1184 MXT_INFO_CHECKSUM_SIZE;
1185 config_mem_size = data->mem_size - cfg_start_ofs;
1186 config_mem = kzalloc(config_mem_size, GFP_KERNEL);
1188 dev_err(dev, "Failed to allocate memory\n");
1193 while (data_pos < cfg->size) {
1194 /* Read type, instance, length */
1195 ret = sscanf(cfg->data + data_pos, "%x %x %x%n",
1196 &type, &instance, &size, &offset);
1200 } else if (ret != 3) {
1201 dev_err(dev, "Bad format: failed to parse object\n");
1207 object = mxt_get_object(data, type);
1210 for (i = 0; i < size; i++) {
1211 ret = sscanf(cfg->data + data_pos, "%hhx%n",
1219 if (size > mxt_obj_size(object)) {
1221 * Either we are in fallback mode due to wrong
1222 * config or config from a later fw version,
1223 * or the file is corrupt or hand-edited.
1225 dev_warn(dev, "Discarding %zu byte(s) in T%u\n",
1226 size - mxt_obj_size(object), type);
1227 } else if (mxt_obj_size(object) > size) {
1229 * If firmware is upgraded, new bytes may be added to
1230 * end of objects. It is generally forward compatible
1231 * to zero these bytes - previous behaviour will be
1232 * retained. However this does invalidate the CRC and
1233 * will force fallback mode until the configuration is
1234 * updated. We warn here but do nothing else - the
1235 * malloc has zeroed the entire configuration.
1237 dev_warn(dev, "Zeroing %zu byte(s) in T%d\n",
1238 mxt_obj_size(object) - size, type);
1241 if (instance >= mxt_obj_instances(object)) {
1242 dev_err(dev, "Object instances exceeded!\n");
1247 reg = object->start_address + mxt_obj_size(object) * instance;
1249 for (i = 0; i < size; i++) {
1250 ret = sscanf(cfg->data + data_pos, "%hhx%n",
1254 dev_err(dev, "Bad format in T%d\n", type);
1260 if (i > mxt_obj_size(object))
1263 byte_offset = reg + i - cfg_start_ofs;
1265 if ((byte_offset >= 0)
1266 && (byte_offset <= config_mem_size)) {
1267 *(config_mem + byte_offset) = val;
1269 dev_err(dev, "Bad object: reg:%d, T%d, ofs=%d\n",
1270 reg, object->type, byte_offset);
1277 /* Calculate crc of the received configs (not the raw config file) */
1278 if (data->T7_address < cfg_start_ofs) {
1279 dev_err(dev, "Bad T7 address, T7addr = %x, config offset %x\n",
1280 data->T7_address, cfg_start_ofs);
1285 calculated_crc = mxt_calculate_crc(config_mem,
1286 data->T7_address - cfg_start_ofs,
1289 if (config_crc > 0 && (config_crc != calculated_crc))
1290 dev_warn(dev, "Config CRC error, calculated=%06X, file=%06X\n",
1291 calculated_crc, config_crc);
1293 /* Write configuration as blocks */
1295 while (byte_offset < config_mem_size) {
1296 size = config_mem_size - byte_offset;
1298 if (size > MXT_MAX_BLOCK_WRITE)
1299 size = MXT_MAX_BLOCK_WRITE;
1301 ret = __mxt_write_reg(data->client,
1302 cfg_start_ofs + byte_offset,
1303 size, config_mem + byte_offset);
1305 dev_err(dev, "Config write error, ret=%d\n", ret);
1309 byte_offset += size;
1312 mxt_update_crc(data, MXT_COMMAND_BACKUPNV, MXT_BACKUP_VALUE);
1314 ret = mxt_soft_reset(data);
1318 dev_info(dev, "Config successfully updated\n");
1323 release_firmware(cfg);
1327 static int mxt_acquire_irq(struct mxt_data *data)
1331 enable_irq(data->irq);
1333 error = mxt_process_messages_until_invalid(data);
1340 static int mxt_get_info(struct mxt_data *data)
1342 struct i2c_client *client = data->client;
1343 struct mxt_info *info = &data->info;
1346 /* Read 7-byte info block starting at address 0 */
1347 error = __mxt_read_reg(client, MXT_INFO, sizeof(*info), info);
1354 static void mxt_free_object_table(struct mxt_data *data)
1356 input_unregister_device(data->input_dev);
1357 data->input_dev = NULL;
1359 kfree(data->object_table);
1360 data->object_table = NULL;
1361 kfree(data->msg_buf);
1362 data->msg_buf = NULL;
1363 data->T5_address = 0;
1364 data->T5_msg_size = 0;
1365 data->T6_reportid = 0;
1366 data->T7_address = 0;
1367 data->T9_reportid_min = 0;
1368 data->T9_reportid_max = 0;
1369 data->T19_reportid = 0;
1370 data->T44_address = 0;
1371 data->max_reportid = 0;
1374 static int mxt_get_object_table(struct mxt_data *data)
1376 struct i2c_client *client = data->client;
1378 struct mxt_object *object_table;
1384 table_size = data->info.object_num * sizeof(struct mxt_object);
1385 object_table = kzalloc(table_size, GFP_KERNEL);
1386 if (!object_table) {
1387 dev_err(&data->client->dev, "Failed to allocate memory\n");
1391 error = __mxt_read_reg(client, MXT_OBJECT_START, table_size,
1394 kfree(object_table);
1398 /* Valid Report IDs start counting from 1 */
1401 for (i = 0; i < data->info.object_num; i++) {
1402 struct mxt_object *object = object_table + i;
1405 le16_to_cpus(&object->start_address);
1407 if (object->num_report_ids) {
1409 reportid += object->num_report_ids *
1410 mxt_obj_instances(object);
1411 max_id = reportid - 1;
1417 dev_dbg(&data->client->dev,
1418 "T%u Start:%u Size:%zu Instances:%zu Report IDs:%u-%u\n",
1419 object->type, object->start_address,
1420 mxt_obj_size(object), mxt_obj_instances(object),
1423 switch (object->type) {
1424 case MXT_GEN_MESSAGE_T5:
1425 if (data->info.family_id == 0x80) {
1427 * On mXT224 read and discard unused CRC byte
1428 * otherwise DMA reads are misaligned
1430 data->T5_msg_size = mxt_obj_size(object);
1432 /* CRC not enabled, so skip last byte */
1433 data->T5_msg_size = mxt_obj_size(object) - 1;
1435 data->T5_address = object->start_address;
1436 case MXT_GEN_COMMAND_T6:
1437 data->T6_reportid = min_id;
1438 data->T6_address = object->start_address;
1440 case MXT_GEN_POWER_T7:
1441 data->T7_address = object->start_address;
1443 case MXT_TOUCH_MULTI_T9:
1444 data->T9_reportid_min = min_id;
1445 data->T9_reportid_max = max_id;
1446 data->num_touchids = object->num_report_ids
1447 * mxt_obj_instances(object);
1449 case MXT_SPT_MESSAGECOUNT_T44:
1450 data->T44_address = object->start_address;
1452 case MXT_SPT_GPIOPWM_T19:
1453 data->T19_reportid = min_id;
1457 end_address = object->start_address
1458 + mxt_obj_size(object) * mxt_obj_instances(object) - 1;
1460 if (end_address >= data->mem_size)
1461 data->mem_size = end_address + 1;
1464 /* Store maximum reportid */
1465 data->max_reportid = reportid;
1467 /* If T44 exists, T5 position has to be directly after */
1468 if (data->T44_address && (data->T5_address != data->T44_address + 1)) {
1469 dev_err(&client->dev, "Invalid T44 position\n");
1471 goto free_object_table;
1474 data->msg_buf = kcalloc(data->max_reportid,
1475 data->T5_msg_size, GFP_KERNEL);
1476 if (!data->msg_buf) {
1477 dev_err(&client->dev, "Failed to allocate message buffer\n");
1479 goto free_object_table;
1482 data->object_table = object_table;
1487 mxt_free_object_table(data);
1491 static int mxt_read_t9_resolution(struct mxt_data *data)
1493 struct i2c_client *client = data->client;
1495 struct t9_range range;
1496 unsigned char orient;
1497 struct mxt_object *object;
1499 object = mxt_get_object(data, MXT_TOUCH_MULTI_T9);
1503 error = __mxt_read_reg(client,
1504 object->start_address + MXT_T9_RANGE,
1505 sizeof(range), &range);
1509 le16_to_cpus(&range.x);
1510 le16_to_cpus(&range.y);
1512 error = __mxt_read_reg(client,
1513 object->start_address + MXT_T9_ORIENT,
1518 /* Handle default values */
1525 if (orient & MXT_T9_ORIENT_SWITCH) {
1526 data->max_x = range.y;
1527 data->max_y = range.x;
1529 data->max_x = range.x;
1530 data->max_y = range.y;
1533 dev_dbg(&client->dev,
1534 "Touchscreen size X%uY%u\n", data->max_x, data->max_y);
1539 static int mxt_input_open(struct input_dev *dev);
1540 static void mxt_input_close(struct input_dev *dev);
1542 static int mxt_initialize_t9_input_device(struct mxt_data *data)
1544 struct device *dev = &data->client->dev;
1545 const struct mxt_platform_data *pdata = data->pdata;
1546 struct input_dev *input_dev;
1548 unsigned int num_mt_slots;
1549 unsigned int mt_flags = 0;
1552 error = mxt_read_t9_resolution(data);
1554 dev_warn(dev, "Failed to initialize T9 resolution\n");
1556 input_dev = input_allocate_device();
1558 dev_err(dev, "Failed to allocate memory\n");
1562 input_dev->name = "Atmel maXTouch Touchscreen";
1563 input_dev->phys = data->phys;
1564 input_dev->id.bustype = BUS_I2C;
1565 input_dev->dev.parent = dev;
1566 input_dev->open = mxt_input_open;
1567 input_dev->close = mxt_input_close;
1569 __set_bit(EV_ABS, input_dev->evbit);
1570 __set_bit(EV_KEY, input_dev->evbit);
1571 __set_bit(BTN_TOUCH, input_dev->keybit);
1573 if (pdata->t19_num_keys) {
1574 __set_bit(INPUT_PROP_BUTTONPAD, input_dev->propbit);
1576 for (i = 0; i < pdata->t19_num_keys; i++)
1577 if (pdata->t19_keymap[i] != KEY_RESERVED)
1578 input_set_capability(input_dev, EV_KEY,
1579 pdata->t19_keymap[i]);
1581 mt_flags |= INPUT_MT_POINTER;
1583 input_abs_set_res(input_dev, ABS_X, MXT_PIXELS_PER_MM);
1584 input_abs_set_res(input_dev, ABS_Y, MXT_PIXELS_PER_MM);
1585 input_abs_set_res(input_dev, ABS_MT_POSITION_X,
1587 input_abs_set_res(input_dev, ABS_MT_POSITION_Y,
1590 input_dev->name = "Atmel maXTouch Touchpad";
1593 /* For single touch */
1594 input_set_abs_params(input_dev, ABS_X,
1595 0, data->max_x, 0, 0);
1596 input_set_abs_params(input_dev, ABS_Y,
1597 0, data->max_y, 0, 0);
1598 input_set_abs_params(input_dev, ABS_PRESSURE,
1601 /* For multi touch */
1602 num_mt_slots = data->T9_reportid_max - data->T9_reportid_min + 1;
1603 error = input_mt_init_slots(input_dev, num_mt_slots, mt_flags);
1605 dev_err(dev, "Error %d initialising slots\n", error);
1609 input_set_abs_params(input_dev, ABS_MT_TOUCH_MAJOR,
1610 0, MXT_MAX_AREA, 0, 0);
1611 input_set_abs_params(input_dev, ABS_MT_POSITION_X,
1612 0, data->max_x, 0, 0);
1613 input_set_abs_params(input_dev, ABS_MT_POSITION_Y,
1614 0, data->max_y, 0, 0);
1615 input_set_abs_params(input_dev, ABS_MT_PRESSURE,
1618 input_set_drvdata(input_dev, data);
1620 error = input_register_device(input_dev);
1622 dev_err(dev, "Error %d registering input device\n", error);
1626 data->input_dev = input_dev;
1631 input_free_device(input_dev);
1635 static int mxt_configure_objects(struct mxt_data *data,
1636 const struct firmware *cfg);
1638 static void mxt_config_cb(const struct firmware *cfg, void *ctx)
1640 mxt_configure_objects(ctx, cfg);
1643 static int mxt_initialize(struct mxt_data *data)
1645 struct i2c_client *client = data->client;
1647 bool alt_bootloader_addr = false;
1651 error = mxt_get_info(data);
1654 error = mxt_probe_bootloader(data, alt_bootloader_addr);
1656 if (alt_bootloader_addr) {
1657 /* Chip is not in appmode or bootloader mode */
1661 dev_info(&client->dev, "Trying alternate bootloader address\n");
1662 alt_bootloader_addr = true;
1663 goto retry_bootloader;
1666 dev_err(&client->dev, "Could not recover from bootloader mode\n");
1668 * We can reflash from this state, so do not
1671 data->in_bootloader = true;
1675 /* Attempt to exit bootloader into app mode */
1676 mxt_send_bootloader_cmd(data, false);
1677 msleep(MXT_FW_RESET_TIME);
1683 /* Get object table information */
1684 error = mxt_get_object_table(data);
1686 dev_err(&client->dev, "Error %d reading object table\n", error);
1690 mxt_acquire_irq(data);
1692 goto err_free_object_table;
1694 request_firmware_nowait(THIS_MODULE, true, MXT_CFG_NAME,
1695 &data->client->dev, GFP_KERNEL, data,
1700 err_free_object_table:
1701 mxt_free_object_table(data);
1705 static int mxt_set_t7_power_cfg(struct mxt_data *data, u8 sleep)
1707 struct device *dev = &data->client->dev;
1709 struct t7_config *new_config;
1710 struct t7_config deepsleep = { .active = 0, .idle = 0 };
1712 if (sleep == MXT_POWER_CFG_DEEPSLEEP)
1713 new_config = &deepsleep;
1715 new_config = &data->t7_cfg;
1717 error = __mxt_write_reg(data->client, data->T7_address,
1718 sizeof(data->t7_cfg), new_config);
1722 dev_dbg(dev, "Set T7 ACTV:%d IDLE:%d\n",
1723 new_config->active, new_config->idle);
1728 static int mxt_init_t7_power_cfg(struct mxt_data *data)
1730 struct device *dev = &data->client->dev;
1735 error = __mxt_read_reg(data->client, data->T7_address,
1736 sizeof(data->t7_cfg), &data->t7_cfg);
1740 if (data->t7_cfg.active == 0 || data->t7_cfg.idle == 0) {
1742 dev_dbg(dev, "T7 cfg zero, resetting\n");
1743 mxt_soft_reset(data);
1747 dev_dbg(dev, "T7 cfg zero after reset, overriding\n");
1748 data->t7_cfg.active = 20;
1749 data->t7_cfg.idle = 100;
1750 return mxt_set_t7_power_cfg(data, MXT_POWER_CFG_RUN);
1754 dev_dbg(dev, "Initialized power cfg: ACTV %d, IDLE %d\n",
1755 data->t7_cfg.active, data->t7_cfg.idle);
1759 static int mxt_configure_objects(struct mxt_data *data,
1760 const struct firmware *cfg)
1762 struct device *dev = &data->client->dev;
1763 struct mxt_info *info = &data->info;
1767 error = mxt_update_cfg(data, cfg);
1769 dev_warn(dev, "Error %d updating config\n", error);
1772 error = mxt_init_t7_power_cfg(data);
1774 dev_err(dev, "Failed to initialize power cfg\n");
1778 error = mxt_initialize_t9_input_device(data);
1783 "Family: %u Variant: %u Firmware V%u.%u.%02X Objects: %u\n",
1784 info->family_id, info->variant_id, info->version >> 4,
1785 info->version & 0xf, info->build, info->object_num);
1790 /* Firmware Version is returned as Major.Minor.Build */
1791 static ssize_t mxt_fw_version_show(struct device *dev,
1792 struct device_attribute *attr, char *buf)
1794 struct mxt_data *data = dev_get_drvdata(dev);
1795 struct mxt_info *info = &data->info;
1796 return scnprintf(buf, PAGE_SIZE, "%u.%u.%02X\n",
1797 info->version >> 4, info->version & 0xf, info->build);
1800 /* Hardware Version is returned as FamilyID.VariantID */
1801 static ssize_t mxt_hw_version_show(struct device *dev,
1802 struct device_attribute *attr, char *buf)
1804 struct mxt_data *data = dev_get_drvdata(dev);
1805 struct mxt_info *info = &data->info;
1806 return scnprintf(buf, PAGE_SIZE, "%u.%u\n",
1807 info->family_id, info->variant_id);
1810 static ssize_t mxt_show_instance(char *buf, int count,
1811 struct mxt_object *object, int instance,
1816 if (mxt_obj_instances(object) > 1)
1817 count += scnprintf(buf + count, PAGE_SIZE - count,
1818 "Instance %u\n", instance);
1820 for (i = 0; i < mxt_obj_size(object); i++)
1821 count += scnprintf(buf + count, PAGE_SIZE - count,
1822 "\t[%2u]: %02x (%d)\n", i, val[i], val[i]);
1823 count += scnprintf(buf + count, PAGE_SIZE - count, "\n");
1828 static ssize_t mxt_object_show(struct device *dev,
1829 struct device_attribute *attr, char *buf)
1831 struct mxt_data *data = dev_get_drvdata(dev);
1832 struct mxt_object *object;
1838 /* Pre-allocate buffer large enough to hold max sized object. */
1839 obuf = kmalloc(256, GFP_KERNEL);
1844 for (i = 0; i < data->info.object_num; i++) {
1845 object = data->object_table + i;
1847 if (!mxt_object_readable(object->type))
1850 count += scnprintf(buf + count, PAGE_SIZE - count,
1851 "T%u:\n", object->type);
1853 for (j = 0; j < mxt_obj_instances(object); j++) {
1854 u16 size = mxt_obj_size(object);
1855 u16 addr = object->start_address + j * size;
1857 error = __mxt_read_reg(data->client, addr, size, obuf);
1861 count = mxt_show_instance(buf, count, object, j, obuf);
1867 return error ?: count;
1870 static int mxt_check_firmware_format(struct device *dev,
1871 const struct firmware *fw)
1873 unsigned int pos = 0;
1876 while (pos < fw->size) {
1877 c = *(fw->data + pos);
1879 if (c < '0' || (c > '9' && c < 'A') || c > 'F')
1886 * To convert file try:
1887 * xxd -r -p mXTXXX__APP_VX-X-XX.enc > maxtouch.fw
1889 dev_err(dev, "Aborting: firmware file must be in binary format\n");
1894 static int mxt_load_fw(struct device *dev, const char *fn)
1896 struct mxt_data *data = dev_get_drvdata(dev);
1897 const struct firmware *fw = NULL;
1898 unsigned int frame_size;
1899 unsigned int pos = 0;
1900 unsigned int retry = 0;
1901 unsigned int frame = 0;
1904 ret = request_firmware(&fw, fn, dev);
1906 dev_err(dev, "Unable to open firmware %s\n", fn);
1910 /* Check for incorrect enc file */
1911 ret = mxt_check_firmware_format(dev, fw);
1913 goto release_firmware;
1915 if (!data->in_bootloader) {
1916 /* Change to the bootloader mode */
1917 data->in_bootloader = true;
1919 ret = mxt_t6_command(data, MXT_COMMAND_RESET,
1920 MXT_BOOT_VALUE, false);
1922 goto release_firmware;
1924 msleep(MXT_RESET_TIME);
1926 /* Do not need to scan since we know family ID */
1927 ret = mxt_lookup_bootloader_address(data, 0);
1929 goto release_firmware;
1931 enable_irq(data->irq);
1934 mxt_free_object_table(data);
1935 reinit_completion(&data->bl_completion);
1937 ret = mxt_check_bootloader(data, MXT_WAITING_BOOTLOAD_CMD, false);
1939 /* Bootloader may still be unlocked from previous attempt */
1940 ret = mxt_check_bootloader(data, MXT_WAITING_FRAME_DATA, false);
1944 dev_info(dev, "Unlocking bootloader\n");
1946 /* Unlock bootloader */
1947 ret = mxt_send_bootloader_cmd(data, true);
1952 while (pos < fw->size) {
1953 ret = mxt_check_bootloader(data, MXT_WAITING_FRAME_DATA, true);
1957 frame_size = ((*(fw->data + pos) << 8) | *(fw->data + pos + 1));
1959 /* Take account of CRC bytes */
1962 /* Write one frame to device */
1963 ret = mxt_bootloader_write(data, fw->data + pos, frame_size);
1967 ret = mxt_check_bootloader(data, MXT_FRAME_CRC_PASS, true);
1971 /* Back off by 20ms per retry */
1975 dev_err(dev, "Retry count exceeded\n");
1984 if (frame % 50 == 0)
1985 dev_dbg(dev, "Sent %d frames, %d/%zd bytes\n",
1986 frame, pos, fw->size);
1989 /* Wait for flash. */
1990 ret = mxt_wait_for_completion(data, &data->bl_completion,
1995 dev_dbg(dev, "Sent %d frames, %d bytes\n", frame, pos);
1998 * Wait for device to reset. Some bootloader versions do not assert
1999 * the CHG line after bootloading has finished, so ignore potential
2002 mxt_wait_for_completion(data, &data->bl_completion, MXT_FW_RESET_TIME);
2004 data->in_bootloader = false;
2007 disable_irq(data->irq);
2009 release_firmware(fw);
2013 static ssize_t mxt_update_fw_store(struct device *dev,
2014 struct device_attribute *attr,
2015 const char *buf, size_t count)
2017 struct mxt_data *data = dev_get_drvdata(dev);
2020 error = mxt_load_fw(dev, MXT_FW_NAME);
2022 dev_err(dev, "The firmware update failed(%d)\n", error);
2025 dev_info(dev, "The firmware update succeeded\n");
2027 error = mxt_initialize(data);
2035 static DEVICE_ATTR(fw_version, S_IRUGO, mxt_fw_version_show, NULL);
2036 static DEVICE_ATTR(hw_version, S_IRUGO, mxt_hw_version_show, NULL);
2037 static DEVICE_ATTR(object, S_IRUGO, mxt_object_show, NULL);
2038 static DEVICE_ATTR(update_fw, S_IWUSR, NULL, mxt_update_fw_store);
2040 static struct attribute *mxt_attrs[] = {
2041 &dev_attr_fw_version.attr,
2042 &dev_attr_hw_version.attr,
2043 &dev_attr_object.attr,
2044 &dev_attr_update_fw.attr,
2048 static const struct attribute_group mxt_attr_group = {
2052 static void mxt_start(struct mxt_data *data)
2054 mxt_set_t7_power_cfg(data, MXT_POWER_CFG_RUN);
2056 /* Recalibrate since chip has been in deep sleep */
2057 mxt_t6_command(data, MXT_COMMAND_CALIBRATE, 1, false);
2060 static void mxt_stop(struct mxt_data *data)
2062 mxt_set_t7_power_cfg(data, MXT_POWER_CFG_DEEPSLEEP);
2065 static int mxt_input_open(struct input_dev *dev)
2067 struct mxt_data *data = input_get_drvdata(dev);
2074 static void mxt_input_close(struct input_dev *dev)
2076 struct mxt_data *data = input_get_drvdata(dev);
2082 static struct mxt_platform_data *mxt_parse_dt(struct i2c_client *client)
2084 struct mxt_platform_data *pdata;
2087 int proplen, i, ret;
2089 if (!client->dev.of_node)
2090 return ERR_PTR(-ENODEV);
2092 pdata = devm_kzalloc(&client->dev, sizeof(*pdata), GFP_KERNEL);
2094 return ERR_PTR(-ENOMEM);
2096 if (of_find_property(client->dev.of_node, "linux,gpio-keymap",
2098 pdata->t19_num_keys = proplen / sizeof(u32);
2100 keymap = devm_kzalloc(&client->dev,
2101 pdata->t19_num_keys * sizeof(keymap[0]),
2104 return ERR_PTR(-ENOMEM);
2106 for (i = 0; i < pdata->t19_num_keys; i++) {
2107 ret = of_property_read_u32_index(client->dev.of_node,
2108 "linux,gpio-keymap", i, &keycode);
2110 keycode = KEY_RESERVED;
2112 keymap[i] = keycode;
2115 pdata->t19_keymap = keymap;
2121 static struct mxt_platform_data *mxt_parse_dt(struct i2c_client *client)
2123 dev_dbg(&client->dev, "No platform data specified\n");
2124 return ERR_PTR(-EINVAL);
2128 static int mxt_probe(struct i2c_client *client, const struct i2c_device_id *id)
2130 struct mxt_data *data;
2131 const struct mxt_platform_data *pdata;
2134 pdata = dev_get_platdata(&client->dev);
2136 pdata = mxt_parse_dt(client);
2138 return PTR_ERR(pdata);
2141 data = kzalloc(sizeof(struct mxt_data), GFP_KERNEL);
2143 dev_err(&client->dev, "Failed to allocate memory\n");
2147 snprintf(data->phys, sizeof(data->phys), "i2c-%u-%04x/input0",
2148 client->adapter->nr, client->addr);
2150 data->client = client;
2151 data->pdata = pdata;
2152 data->irq = client->irq;
2153 i2c_set_clientdata(client, data);
2155 init_completion(&data->bl_completion);
2156 init_completion(&data->reset_completion);
2157 init_completion(&data->crc_completion);
2159 error = request_threaded_irq(client->irq, NULL, mxt_interrupt,
2160 pdata->irqflags | IRQF_ONESHOT,
2161 client->name, data);
2163 dev_err(&client->dev, "Failed to register interrupt\n");
2167 disable_irq(client->irq);
2169 error = mxt_initialize(data);
2173 error = sysfs_create_group(&client->dev.kobj, &mxt_attr_group);
2175 dev_err(&client->dev, "Failure %d creating sysfs group\n",
2177 goto err_free_object;
2183 mxt_free_object_table(data);
2185 free_irq(client->irq, data);
2191 static int mxt_remove(struct i2c_client *client)
2193 struct mxt_data *data = i2c_get_clientdata(client);
2195 sysfs_remove_group(&client->dev.kobj, &mxt_attr_group);
2196 free_irq(data->irq, data);
2197 input_unregister_device(data->input_dev);
2198 mxt_free_object_table(data);
2204 #ifdef CONFIG_PM_SLEEP
2205 static int mxt_suspend(struct device *dev)
2207 struct i2c_client *client = to_i2c_client(dev);
2208 struct mxt_data *data = i2c_get_clientdata(client);
2209 struct input_dev *input_dev = data->input_dev;
2211 mutex_lock(&input_dev->mutex);
2213 if (input_dev->users)
2216 mutex_unlock(&input_dev->mutex);
2221 static int mxt_resume(struct device *dev)
2223 struct i2c_client *client = to_i2c_client(dev);
2224 struct mxt_data *data = i2c_get_clientdata(client);
2225 struct input_dev *input_dev = data->input_dev;
2227 mutex_lock(&input_dev->mutex);
2229 if (input_dev->users)
2232 mutex_unlock(&input_dev->mutex);
2238 static SIMPLE_DEV_PM_OPS(mxt_pm_ops, mxt_suspend, mxt_resume);
2240 static const struct of_device_id mxt_of_match[] = {
2241 { .compatible = "atmel,maxtouch", },
2244 MODULE_DEVICE_TABLE(of, mxt_of_match);
2246 static const struct i2c_device_id mxt_id[] = {
2247 { "qt602240_ts", 0 },
2248 { "atmel_mxt_ts", 0 },
2249 { "atmel_mxt_tp", 0 },
2253 MODULE_DEVICE_TABLE(i2c, mxt_id);
2255 static struct i2c_driver mxt_driver = {
2257 .name = "atmel_mxt_ts",
2258 .owner = THIS_MODULE,
2259 .of_match_table = of_match_ptr(mxt_of_match),
2263 .remove = mxt_remove,
2267 module_i2c_driver(mxt_driver);
2269 /* Module information */
2270 MODULE_AUTHOR("Joonyoung Shim <jy0922.shim@samsung.com>");
2271 MODULE_DESCRIPTION("Atmel maXTouch Touchscreen driver");
2272 MODULE_LICENSE("GPL");