Linux Audio

Check our new training course

Loading...
Note: File does not exist in v3.1.
  1// SPDX-License-Identifier: GPL-2.0
  2// Melfas MMS114/MMS136/MMS152 touchscreen device driver
  3//
  4// Copyright (c) 2012 Samsung Electronics Co., Ltd.
  5// Author: Joonyoung Shim <jy0922.shim@samsung.com>
  6
  7#include <linux/module.h>
  8#include <linux/delay.h>
  9#include <linux/of.h>
 10#include <linux/of_device.h>
 11#include <linux/i2c.h>
 12#include <linux/input/mt.h>
 13#include <linux/input/touchscreen.h>
 14#include <linux/interrupt.h>
 15#include <linux/regulator/consumer.h>
 16#include <linux/slab.h>
 17
 18/* Write only registers */
 19#define MMS114_MODE_CONTROL		0x01
 20#define MMS114_OPERATION_MODE_MASK	0xE
 21#define MMS114_ACTIVE			BIT(1)
 22
 23#define MMS114_XY_RESOLUTION_H		0x02
 24#define MMS114_X_RESOLUTION		0x03
 25#define MMS114_Y_RESOLUTION		0x04
 26#define MMS114_CONTACT_THRESHOLD	0x05
 27#define MMS114_MOVING_THRESHOLD		0x06
 28
 29/* Read only registers */
 30#define MMS114_PACKET_SIZE		0x0F
 31#define MMS114_INFORMATION		0x10
 32#define MMS114_TSP_REV			0xF0
 33
 34#define MMS152_FW_REV			0xE1
 35#define MMS152_COMPAT_GROUP		0xF2
 36
 37/* Minimum delay time is 50us between stop and start signal of i2c */
 38#define MMS114_I2C_DELAY		50
 39
 40/* 200ms needs after power on */
 41#define MMS114_POWERON_DELAY		200
 42
 43/* Touchscreen absolute values */
 44#define MMS114_MAX_AREA			0xff
 45
 46#define MMS114_MAX_TOUCH		10
 47#define MMS114_EVENT_SIZE		8
 48#define MMS136_EVENT_SIZE		6
 49
 50/* Touch type */
 51#define MMS114_TYPE_NONE		0
 52#define MMS114_TYPE_TOUCHSCREEN		1
 53#define MMS114_TYPE_TOUCHKEY		2
 54
 55enum mms_type {
 56	TYPE_MMS114	= 114,
 57	TYPE_MMS134S	= 134,
 58	TYPE_MMS136	= 136,
 59	TYPE_MMS152	= 152,
 60	TYPE_MMS345L	= 345,
 61};
 62
 63struct mms114_data {
 64	struct i2c_client	*client;
 65	struct input_dev	*input_dev;
 66	struct regulator	*core_reg;
 67	struct regulator	*io_reg;
 68	struct touchscreen_properties props;
 69	enum mms_type		type;
 70	unsigned int		contact_threshold;
 71	unsigned int		moving_threshold;
 72
 73	/* Use cache data for mode control register(write only) */
 74	u8			cache_mode_control;
 75};
 76
 77struct mms114_touch {
 78	u8 id:4, reserved_bit4:1, type:2, pressed:1;
 79	u8 x_hi:4, y_hi:4;
 80	u8 x_lo;
 81	u8 y_lo;
 82	u8 width;
 83	u8 strength;
 84	u8 reserved[2];
 85} __packed;
 86
 87static int __mms114_read_reg(struct mms114_data *data, unsigned int reg,
 88			     unsigned int len, u8 *val)
 89{
 90	struct i2c_client *client = data->client;
 91	struct i2c_msg xfer[2];
 92	u8 buf = reg & 0xff;
 93	int error;
 94
 95	if (reg <= MMS114_MODE_CONTROL && reg + len > MMS114_MODE_CONTROL)
 96		BUG();
 97
 98	/* Write register */
 99	xfer[0].addr = client->addr;
100	xfer[0].flags = client->flags & I2C_M_TEN;
101	xfer[0].len = 1;
102	xfer[0].buf = &buf;
103
104	/* Read data */
105	xfer[1].addr = client->addr;
106	xfer[1].flags = (client->flags & I2C_M_TEN) | I2C_M_RD;
107	xfer[1].len = len;
108	xfer[1].buf = val;
109
110	error = i2c_transfer(client->adapter, xfer, 2);
111	if (error != 2) {
112		dev_err(&client->dev,
113			"%s: i2c transfer failed (%d)\n", __func__, error);
114		return error < 0 ? error : -EIO;
115	}
116	udelay(MMS114_I2C_DELAY);
117
118	return 0;
119}
120
121static int mms114_read_reg(struct mms114_data *data, unsigned int reg)
122{
123	u8 val;
124	int error;
125
126	if (reg == MMS114_MODE_CONTROL)
127		return data->cache_mode_control;
128
129	error = __mms114_read_reg(data, reg, 1, &val);
130	return error < 0 ? error : val;
131}
132
133static int mms114_write_reg(struct mms114_data *data, unsigned int reg,
134			    unsigned int val)
135{
136	struct i2c_client *client = data->client;
137	u8 buf[2];
138	int error;
139
140	buf[0] = reg & 0xff;
141	buf[1] = val & 0xff;
142
143	error = i2c_master_send(client, buf, 2);
144	if (error != 2) {
145		dev_err(&client->dev,
146			"%s: i2c send failed (%d)\n", __func__, error);
147		return error < 0 ? error : -EIO;
148	}
149	udelay(MMS114_I2C_DELAY);
150
151	if (reg == MMS114_MODE_CONTROL)
152		data->cache_mode_control = val;
153
154	return 0;
155}
156
157static void mms114_process_mt(struct mms114_data *data, struct mms114_touch *touch)
158{
159	struct i2c_client *client = data->client;
160	struct input_dev *input_dev = data->input_dev;
161	unsigned int id;
162	unsigned int x;
163	unsigned int y;
164
165	if (touch->id > MMS114_MAX_TOUCH) {
166		dev_err(&client->dev, "Wrong touch id (%d)\n", touch->id);
167		return;
168	}
169
170	if (touch->type != MMS114_TYPE_TOUCHSCREEN) {
171		dev_err(&client->dev, "Wrong touch type (%d)\n", touch->type);
172		return;
173	}
174
175	id = touch->id - 1;
176	x = touch->x_lo | touch->x_hi << 8;
177	y = touch->y_lo | touch->y_hi << 8;
178
179	dev_dbg(&client->dev,
180		"id: %d, type: %d, pressed: %d, x: %d, y: %d, width: %d, strength: %d\n",
181		id, touch->type, touch->pressed,
182		x, y, touch->width, touch->strength);
183
184	input_mt_slot(input_dev, id);
185	input_mt_report_slot_state(input_dev, MT_TOOL_FINGER, touch->pressed);
186
187	if (touch->pressed) {
188		touchscreen_report_pos(input_dev, &data->props, x, y, true);
189		input_report_abs(input_dev, ABS_MT_TOUCH_MAJOR, touch->width);
190		input_report_abs(input_dev, ABS_MT_PRESSURE, touch->strength);
191	}
192}
193
194static irqreturn_t mms114_interrupt(int irq, void *dev_id)
195{
196	struct mms114_data *data = dev_id;
197	struct input_dev *input_dev = data->input_dev;
198	struct mms114_touch touch[MMS114_MAX_TOUCH];
199	int packet_size;
200	int touch_size;
201	int index;
202	int error;
203
204	mutex_lock(&input_dev->mutex);
205	if (!input_device_enabled(input_dev)) {
206		mutex_unlock(&input_dev->mutex);
207		goto out;
208	}
209	mutex_unlock(&input_dev->mutex);
210
211	packet_size = mms114_read_reg(data, MMS114_PACKET_SIZE);
212	if (packet_size <= 0)
213		goto out;
214
215	/* MMS136 has slightly different event size */
216	if (data->type == TYPE_MMS134S || data->type == TYPE_MMS136)
217		touch_size = packet_size / MMS136_EVENT_SIZE;
218	else
219		touch_size = packet_size / MMS114_EVENT_SIZE;
220
221	error = __mms114_read_reg(data, MMS114_INFORMATION, packet_size,
222			(u8 *)touch);
223	if (error < 0)
224		goto out;
225
226	for (index = 0; index < touch_size; index++)
227		mms114_process_mt(data, touch + index);
228
229	input_mt_report_pointer_emulation(data->input_dev, true);
230	input_sync(data->input_dev);
231
232out:
233	return IRQ_HANDLED;
234}
235
236static int mms114_set_active(struct mms114_data *data, bool active)
237{
238	int val;
239
240	val = mms114_read_reg(data, MMS114_MODE_CONTROL);
241	if (val < 0)
242		return val;
243
244	val &= ~MMS114_OPERATION_MODE_MASK;
245
246	/* If active is false, sleep mode */
247	if (active)
248		val |= MMS114_ACTIVE;
249
250	return mms114_write_reg(data, MMS114_MODE_CONTROL, val);
251}
252
253static int mms114_get_version(struct mms114_data *data)
254{
255	struct device *dev = &data->client->dev;
256	u8 buf[6];
257	int group;
258	int error;
259
260	switch (data->type) {
261	case TYPE_MMS345L:
262		error = __mms114_read_reg(data, MMS152_FW_REV, 3, buf);
263		if (error)
264			return error;
265
266		dev_info(dev, "TSP FW Rev: bootloader 0x%x / core 0x%x / config 0x%x\n",
267			 buf[0], buf[1], buf[2]);
268		break;
269
270	case TYPE_MMS152:
271		error = __mms114_read_reg(data, MMS152_FW_REV, 3, buf);
272		if (error)
273			return error;
274
275		group = i2c_smbus_read_byte_data(data->client,
276						  MMS152_COMPAT_GROUP);
277		if (group < 0)
278			return group;
279
280		dev_info(dev, "TSP FW Rev: bootloader 0x%x / core 0x%x / config 0x%x, Compat group: %c\n",
281			 buf[0], buf[1], buf[2], group);
282		break;
283
284	case TYPE_MMS114:
285	case TYPE_MMS134S:
286	case TYPE_MMS136:
287		error = __mms114_read_reg(data, MMS114_TSP_REV, 6, buf);
288		if (error)
289			return error;
290
291		dev_info(dev, "TSP Rev: 0x%x, HW Rev: 0x%x, Firmware Ver: 0x%x\n",
292			 buf[0], buf[1], buf[3]);
293		break;
294	}
295
296	return 0;
297}
298
299static int mms114_setup_regs(struct mms114_data *data)
300{
301	const struct touchscreen_properties *props = &data->props;
302	int val;
303	int error;
304
305	error = mms114_get_version(data);
306	if (error < 0)
307		return error;
308
309	/* MMS114, MMS134S and MMS136 have configuration and power on registers */
310	if (data->type != TYPE_MMS114 && data->type != TYPE_MMS134S &&
311	    data->type != TYPE_MMS136)
312		return 0;
313
314	error = mms114_set_active(data, true);
315	if (error < 0)
316		return error;
317
318	val = (props->max_x >> 8) & 0xf;
319	val |= ((props->max_y >> 8) & 0xf) << 4;
320	error = mms114_write_reg(data, MMS114_XY_RESOLUTION_H, val);
321	if (error < 0)
322		return error;
323
324	val = props->max_x & 0xff;
325	error = mms114_write_reg(data, MMS114_X_RESOLUTION, val);
326	if (error < 0)
327		return error;
328
329	val = props->max_x & 0xff;
330	error = mms114_write_reg(data, MMS114_Y_RESOLUTION, val);
331	if (error < 0)
332		return error;
333
334	if (data->contact_threshold) {
335		error = mms114_write_reg(data, MMS114_CONTACT_THRESHOLD,
336				data->contact_threshold);
337		if (error < 0)
338			return error;
339	}
340
341	if (data->moving_threshold) {
342		error = mms114_write_reg(data, MMS114_MOVING_THRESHOLD,
343				data->moving_threshold);
344		if (error < 0)
345			return error;
346	}
347
348	return 0;
349}
350
351static int mms114_start(struct mms114_data *data)
352{
353	struct i2c_client *client = data->client;
354	int error;
355
356	error = regulator_enable(data->core_reg);
357	if (error) {
358		dev_err(&client->dev, "Failed to enable avdd: %d\n", error);
359		return error;
360	}
361
362	error = regulator_enable(data->io_reg);
363	if (error) {
364		dev_err(&client->dev, "Failed to enable vdd: %d\n", error);
365		regulator_disable(data->core_reg);
366		return error;
367	}
368
369	msleep(MMS114_POWERON_DELAY);
370
371	error = mms114_setup_regs(data);
372	if (error < 0) {
373		regulator_disable(data->io_reg);
374		regulator_disable(data->core_reg);
375		return error;
376	}
377
378	enable_irq(client->irq);
379
380	return 0;
381}
382
383static void mms114_stop(struct mms114_data *data)
384{
385	struct i2c_client *client = data->client;
386	int error;
387
388	disable_irq(client->irq);
389
390	error = regulator_disable(data->io_reg);
391	if (error)
392		dev_warn(&client->dev, "Failed to disable vdd: %d\n", error);
393
394	error = regulator_disable(data->core_reg);
395	if (error)
396		dev_warn(&client->dev, "Failed to disable avdd: %d\n", error);
397}
398
399static int mms114_input_open(struct input_dev *dev)
400{
401	struct mms114_data *data = input_get_drvdata(dev);
402
403	return mms114_start(data);
404}
405
406static void mms114_input_close(struct input_dev *dev)
407{
408	struct mms114_data *data = input_get_drvdata(dev);
409
410	mms114_stop(data);
411}
412
413static int mms114_parse_legacy_bindings(struct mms114_data *data)
414{
415	struct device *dev = &data->client->dev;
416	struct touchscreen_properties *props = &data->props;
417
418	if (device_property_read_u32(dev, "x-size", &props->max_x)) {
419		dev_dbg(dev, "failed to get legacy x-size property\n");
420		return -EINVAL;
421	}
422
423	if (device_property_read_u32(dev, "y-size", &props->max_y)) {
424		dev_dbg(dev, "failed to get legacy y-size property\n");
425		return -EINVAL;
426	}
427
428	device_property_read_u32(dev, "contact-threshold",
429				&data->contact_threshold);
430	device_property_read_u32(dev, "moving-threshold",
431				&data->moving_threshold);
432
433	if (device_property_read_bool(dev, "x-invert"))
434		props->invert_x = true;
435	if (device_property_read_bool(dev, "y-invert"))
436		props->invert_y = true;
437
438	props->swap_x_y = false;
439
440	return 0;
441}
442
443static int mms114_probe(struct i2c_client *client)
444{
445	struct mms114_data *data;
446	struct input_dev *input_dev;
447	const void *match_data;
448	int error;
449
450	if (!i2c_check_functionality(client->adapter, I2C_FUNC_I2C)) {
451		dev_err(&client->dev, "Not supported I2C adapter\n");
452		return -ENODEV;
453	}
454
455	data = devm_kzalloc(&client->dev, sizeof(struct mms114_data),
456			    GFP_KERNEL);
457	input_dev = devm_input_allocate_device(&client->dev);
458	if (!data || !input_dev) {
459		dev_err(&client->dev, "Failed to allocate memory\n");
460		return -ENOMEM;
461	}
462
463	data->client = client;
464	data->input_dev = input_dev;
465
466	match_data = device_get_match_data(&client->dev);
467	if (!match_data)
468		return -EINVAL;
469
470	data->type = (enum mms_type)match_data;
471
472	input_set_capability(input_dev, EV_ABS, ABS_MT_POSITION_X);
473	input_set_capability(input_dev, EV_ABS, ABS_MT_POSITION_Y);
474	input_set_abs_params(input_dev, ABS_MT_PRESSURE, 0, 255, 0, 0);
475	input_set_abs_params(input_dev, ABS_MT_TOUCH_MAJOR,
476			     0, MMS114_MAX_AREA, 0, 0);
477
478	touchscreen_parse_properties(input_dev, true, &data->props);
479	if (!data->props.max_x || !data->props.max_y) {
480		dev_dbg(&client->dev,
481			"missing X/Y size properties, trying legacy bindings\n");
482		error = mms114_parse_legacy_bindings(data);
483		if (error)
484			return error;
485
486		input_set_abs_params(input_dev, ABS_MT_POSITION_X,
487				     0, data->props.max_x, 0, 0);
488		input_set_abs_params(input_dev, ABS_MT_POSITION_Y,
489				     0, data->props.max_y, 0, 0);
490	}
491
492	if (data->type == TYPE_MMS114 || data->type == TYPE_MMS134S ||
493	    data->type == TYPE_MMS136) {
494		/*
495		 * The firmware handles movement and pressure fuzz, so
496		 * don't duplicate that in software.
497		 */
498		data->moving_threshold = input_abs_get_fuzz(input_dev,
499							    ABS_MT_POSITION_X);
500		data->contact_threshold = input_abs_get_fuzz(input_dev,
501							     ABS_MT_PRESSURE);
502		input_abs_set_fuzz(input_dev, ABS_MT_POSITION_X, 0);
503		input_abs_set_fuzz(input_dev, ABS_MT_POSITION_Y, 0);
504		input_abs_set_fuzz(input_dev, ABS_MT_PRESSURE, 0);
505	}
506
507	input_dev->name = devm_kasprintf(&client->dev, GFP_KERNEL,
508					 "MELFAS MMS%d Touchscreen",
509					 data->type);
510	if (!input_dev->name)
511		return -ENOMEM;
512
513	input_dev->id.bustype = BUS_I2C;
514	input_dev->dev.parent = &client->dev;
515	input_dev->open = mms114_input_open;
516	input_dev->close = mms114_input_close;
517
518	error = input_mt_init_slots(input_dev, MMS114_MAX_TOUCH,
519				    INPUT_MT_DIRECT);
520	if (error)
521		return error;
522
523	input_set_drvdata(input_dev, data);
524	i2c_set_clientdata(client, data);
525
526	data->core_reg = devm_regulator_get(&client->dev, "avdd");
527	if (IS_ERR(data->core_reg)) {
528		error = PTR_ERR(data->core_reg);
529		dev_err(&client->dev,
530			"Unable to get the Core regulator (%d)\n", error);
531		return error;
532	}
533
534	data->io_reg = devm_regulator_get(&client->dev, "vdd");
535	if (IS_ERR(data->io_reg)) {
536		error = PTR_ERR(data->io_reg);
537		dev_err(&client->dev,
538			"Unable to get the IO regulator (%d)\n", error);
539		return error;
540	}
541
542	error = devm_request_threaded_irq(&client->dev, client->irq,
543					  NULL, mms114_interrupt,
544					  IRQF_ONESHOT | IRQF_NO_AUTOEN,
545					  dev_name(&client->dev), data);
546	if (error) {
547		dev_err(&client->dev, "Failed to register interrupt\n");
548		return error;
549	}
550
551	error = input_register_device(data->input_dev);
552	if (error) {
553		dev_err(&client->dev, "Failed to register input device\n");
554		return error;
555	}
556
557	return 0;
558}
559
560static int __maybe_unused mms114_suspend(struct device *dev)
561{
562	struct i2c_client *client = to_i2c_client(dev);
563	struct mms114_data *data = i2c_get_clientdata(client);
564	struct input_dev *input_dev = data->input_dev;
565	int id;
566
567	/* Release all touch */
568	for (id = 0; id < MMS114_MAX_TOUCH; id++) {
569		input_mt_slot(input_dev, id);
570		input_mt_report_slot_inactive(input_dev);
571	}
572
573	input_mt_report_pointer_emulation(input_dev, true);
574	input_sync(input_dev);
575
576	mutex_lock(&input_dev->mutex);
577	if (input_device_enabled(input_dev))
578		mms114_stop(data);
579	mutex_unlock(&input_dev->mutex);
580
581	return 0;
582}
583
584static int __maybe_unused mms114_resume(struct device *dev)
585{
586	struct i2c_client *client = to_i2c_client(dev);
587	struct mms114_data *data = i2c_get_clientdata(client);
588	struct input_dev *input_dev = data->input_dev;
589	int error;
590
591	mutex_lock(&input_dev->mutex);
592	if (input_device_enabled(input_dev)) {
593		error = mms114_start(data);
594		if (error < 0) {
595			mutex_unlock(&input_dev->mutex);
596			return error;
597		}
598	}
599	mutex_unlock(&input_dev->mutex);
600
601	return 0;
602}
603
604static SIMPLE_DEV_PM_OPS(mms114_pm_ops, mms114_suspend, mms114_resume);
605
606static const struct i2c_device_id mms114_id[] = {
607	{ "mms114", 0 },
608	{ }
609};
610MODULE_DEVICE_TABLE(i2c, mms114_id);
611
612#ifdef CONFIG_OF
613static const struct of_device_id mms114_dt_match[] = {
614	{
615		.compatible = "melfas,mms114",
616		.data = (void *)TYPE_MMS114,
617	}, {
618		.compatible = "melfas,mms134s",
619		.data = (void *)TYPE_MMS134S,
620	}, {
621		.compatible = "melfas,mms136",
622		.data = (void *)TYPE_MMS136,
623	}, {
624		.compatible = "melfas,mms152",
625		.data = (void *)TYPE_MMS152,
626	}, {
627		.compatible = "melfas,mms345l",
628		.data = (void *)TYPE_MMS345L,
629	},
630	{ }
631};
632MODULE_DEVICE_TABLE(of, mms114_dt_match);
633#endif
634
635static struct i2c_driver mms114_driver = {
636	.driver = {
637		.name	= "mms114",
638		.pm	= &mms114_pm_ops,
639		.of_match_table = of_match_ptr(mms114_dt_match),
640	},
641	.probe_new	= mms114_probe,
642	.id_table	= mms114_id,
643};
644
645module_i2c_driver(mms114_driver);
646
647/* Module information */
648MODULE_AUTHOR("Joonyoung Shim <jy0922.shim@samsung.com>");
649MODULE_DESCRIPTION("MELFAS mms114 Touchscreen driver");
650MODULE_LICENSE("GPL v2");