ads7846.c 29.1 KB
Newer Older
D
David Brownell 已提交
1 2 3 4
/*
 * ADS7846 based touchscreen and sensor driver
 *
 * Copyright (c) 2005 David Brownell
I
Imre Deak 已提交
5 6
 * Copyright (c) 2006 Nokia Corporation
 * Various changes: Imre Deak <imre.deak@nokia.com>
D
David Brownell 已提交
7 8 9 10 11 12 13 14 15 16 17 18 19
 *
 * Using code from:
 *  - corgi_ts.c
 *	Copyright (C) 2004-2005 Richard Purdie
 *  - omap_ts.[hc], ads7846.h, ts_osk.c
 *	Copyright (C) 2002 MontaVista Software
 *	Copyright (C) 2004 Texas Instruments
 *	Copyright (C) 2005 Dirk Behme
 *
 *  This program is free software; you can redistribute it and/or modify
 *  it under the terms of the GNU General Public License version 2 as
 *  published by the Free Software Foundation.
 */
20
#include <linux/hwmon.h>
D
David Brownell 已提交
21
#include <linux/init.h>
22
#include <linux/err.h>
D
David Brownell 已提交
23 24 25 26
#include <linux/delay.h>
#include <linux/input.h>
#include <linux/interrupt.h>
#include <linux/slab.h>
27
#include <linux/gpio.h>
D
David Brownell 已提交
28 29
#include <linux/spi/spi.h>
#include <linux/spi/ads7846.h>
30
#include <asm/irq.h>
D
David Brownell 已提交
31 32 33


/*
34 35
 * This code has been heavily tested on a Nokia 770, and lightly
 * tested on other ads7846 devices (OSK/Mistral, Lubbock).
36
 * TSC2046 is just newer ads7846 silicon.
37 38
 * Support for ads7843 tested on Atmel at91sam926x-EK.
 * Support for ads7845 has only been stubbed in.
D
David Brownell 已提交
39
 *
I
Imre Deak 已提交
40 41 42 43 44 45
 * IRQ handling needs a workaround because of a shortcoming in handling
 * edge triggered IRQs on some platforms like the OMAP1/2. These
 * platforms don't handle the ARM lazy IRQ disabling properly, thus we
 * have to maintain our own SW IRQ disabled status. This should be
 * removed as soon as the affected platform's IRQ handling is fixed.
 *
D
David Brownell 已提交
46 47 48
 * app note sbaa036 talks in more detail about accurate sampling...
 * that ought to help in situations like LCDs inducing noise (which
 * can also be helped by using synch signals) and more generally.
I
Imre Deak 已提交
49 50 51
 * This driver tries to utilize the measures described in the app
 * note. The strength of filtering can be set in the board-* specific
 * files.
D
David Brownell 已提交
52 53
 */

54 55
#define TS_POLL_DELAY	(1 * 1000000)	/* ns delay before the first sample */
#define TS_POLL_PERIOD	(5 * 1000000)	/* ns delay between samples */
D
David Brownell 已提交
56

57 58 59
/* this driver doesn't aim at the peak continuous sample rate */
#define	SAMPLE_BITS	(8 /*cmd*/ + 16 /*sample*/ + 2 /* before, after */)

D
David Brownell 已提交
60 61 62
struct ts_event {
	/* For portability, we can't read 12 bit values using SPI (which
	 * would make the controller deliver them as native byteorder u16
63
	 * with msbs zeroed).  Instead, we read them as two 8-bit values,
64
	 * *** WHICH NEED BYTESWAPPING *** and range adjustment.
D
David Brownell 已提交
65
	 */
66 67 68
	u16	x;
	u16	y;
	u16	z1, z2;
69
	int	ignore;
D
David Brownell 已提交
70 71 72
};

struct ads7846 {
73
	struct input_dev	*input;
D
David Brownell 已提交
74 75 76
	char			phys[32];

	struct spi_device	*spi;
77 78

#if defined(CONFIG_HWMON) || defined(CONFIG_HWMON_MODULE)
79
	struct attribute_group	*attr_group;
80
	struct device		*hwmon;
81 82
#endif

D
David Brownell 已提交
83
	u16			model;
84
	u16			vref_mv;
D
David Brownell 已提交
85 86
	u16			vref_delay_usecs;
	u16			x_plate_ohms;
87
	u16			pressure_max;
D
David Brownell 已提交
88

89 90
	u8			read_x, read_y, read_z1, read_z2, pwrdown;
	u16			dummy;		/* for the pwrdown read */
D
David Brownell 已提交
91 92
	struct ts_event		tc;

93
	struct spi_transfer	xfer[18];
94
	struct spi_message	msg[5];
95
	struct spi_message	*last_msg;
96 97
	int			msg_idx;
	int			read_cnt;
98
	int			read_rep;
99 100 101 102
	int			last_read;

	u16			debounce_max;
	u16			debounce_tol;
103
	u16			debounce_rep;
D
David Brownell 已提交
104

105 106
	u16			penirq_recheck_delay_usecs;

D
David Brownell 已提交
107
	spinlock_t		lock;
108
	struct hrtimer		timer;
D
David Brownell 已提交
109 110 111 112
	unsigned		pendown:1;	/* P: lock */
	unsigned		pending:1;	/* P: lock */
// FIXME remove "irq_disabled"
	unsigned		irq_disabled:1;	/* P: lock */
I
Imre Deak 已提交
113
	unsigned		disabled:1;
114
	unsigned		is_suspended:1;
115

116 117 118
	int			(*filter)(void *data, int data_idx, int *val);
	void			*filter_data;
	void			(*filter_cleanup)(void *data);
119
	int			(*get_pendown_state)(void);
120
	int			gpio_pendown;
D
David Brownell 已提交
121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155
};

/* leave chip selected when we're done, for quicker re-select? */
#if	0
#define	CS_CHANGE(xfer)	((xfer).cs_change = 1)
#else
#define	CS_CHANGE(xfer)	((xfer).cs_change = 0)
#endif

/*--------------------------------------------------------------------------*/

/* The ADS7846 has touchscreen and other sensors.
 * Earlier ads784x chips are somewhat compatible.
 */
#define	ADS_START		(1 << 7)
#define	ADS_A2A1A0_d_y		(1 << 4)	/* differential */
#define	ADS_A2A1A0_d_z1		(3 << 4)	/* differential */
#define	ADS_A2A1A0_d_z2		(4 << 4)	/* differential */
#define	ADS_A2A1A0_d_x		(5 << 4)	/* differential */
#define	ADS_A2A1A0_temp0	(0 << 4)	/* non-differential */
#define	ADS_A2A1A0_vbatt	(2 << 4)	/* non-differential */
#define	ADS_A2A1A0_vaux		(6 << 4)	/* non-differential */
#define	ADS_A2A1A0_temp1	(7 << 4)	/* non-differential */
#define	ADS_8_BIT		(1 << 3)
#define	ADS_12_BIT		(0 << 3)
#define	ADS_SER			(1 << 2)	/* non-differential */
#define	ADS_DFR			(0 << 2)	/* differential */
#define	ADS_PD10_PDOWN		(0 << 0)	/* lowpower mode + penirq */
#define	ADS_PD10_ADC_ON		(1 << 0)	/* ADC on */
#define	ADS_PD10_REF_ON		(2 << 0)	/* vREF on + penirq */
#define	ADS_PD10_ALL_ON		(3 << 0)	/* ADC + vREF on */

#define	MAX_12BIT	((1<<12)-1)

/* leave ADC powered up (disables penirq) between differential samples */
156 157 158
#define	READ_12BIT_DFR(x, adc, vref) (ADS_START | ADS_A2A1A0_d_ ## x \
	| ADS_12_BIT | ADS_DFR | \
	(adc ? ADS_PD10_ADC_ON : 0) | (vref ? ADS_PD10_REF_ON : 0))
D
David Brownell 已提交
159

160 161 162
#define	READ_Y(vref)	(READ_12BIT_DFR(y,  1, vref))
#define	READ_Z1(vref)	(READ_12BIT_DFR(z1, 1, vref))
#define	READ_Z2(vref)	(READ_12BIT_DFR(z2, 1, vref))
163

164 165
#define	READ_X(vref)	(READ_12BIT_DFR(x,  1, vref))
#define	PWRDOWN		(READ_12BIT_DFR(y,  0, 0))	/* LAST */
D
David Brownell 已提交
166 167 168 169 170 171 172

/* single-ended samples need to first power up reference voltage;
 * we leave both ADC and VREF powered
 */
#define	READ_12BIT_SER(x) (ADS_START | ADS_A2A1A0_ ## x \
	| ADS_12_BIT | ADS_SER)

173 174
#define	REF_ON	(READ_12BIT_DFR(x, 1, 1))
#define	REF_OFF	(READ_12BIT_DFR(y, 0, 0))
D
David Brownell 已提交
175 176 177 178 179

/*--------------------------------------------------------------------------*/

/*
 * Non-touchscreen sensors only use single-ended conversions.
180 181
 * The range is GND..vREF. The ads7843 and ads7835 must use external vREF;
 * ads7846 lets that pin be unconnected, to use internal vREF.
D
David Brownell 已提交
182 183 184
 */

struct ser_req {
185
	u8			ref_on;
D
David Brownell 已提交
186
	u8			command;
187
	u8			ref_off;
D
David Brownell 已提交
188 189 190 191 192 193
	u16			scratch;
	__be16			sample;
	struct spi_message	msg;
	struct spi_transfer	xfer[6];
};

I
Imre Deak 已提交
194 195 196
static void ads7846_enable(struct ads7846 *ts);
static void ads7846_disable(struct ads7846 *ts);

197 198 199
static int device_suspended(struct device *dev)
{
	struct ads7846 *ts = dev_get_drvdata(dev);
200
	return ts->is_suspended || ts->disabled;
201 202
}

D
David Brownell 已提交
203 204 205 206
static int ads7846_read12_ser(struct device *dev, unsigned command)
{
	struct spi_device	*spi = to_spi_device(dev);
	struct ads7846		*ts = dev_get_drvdata(dev);
207
	struct ser_req		*req = kzalloc(sizeof *req, GFP_KERNEL);
D
David Brownell 已提交
208
	int			status;
209
	int			use_internal;
D
David Brownell 已提交
210 211 212 213

	if (!req)
		return -ENOMEM;

214
	spi_message_init(&req->msg);
215

216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232
	/* FIXME boards with ads7846 might use external vref instead ... */
	use_internal = (ts->model == 7846);

	/* maybe turn on internal vREF, and let it settle */
	if (use_internal) {
		req->ref_on = REF_ON;
		req->xfer[0].tx_buf = &req->ref_on;
		req->xfer[0].len = 1;
		spi_message_add_tail(&req->xfer[0], &req->msg);

		req->xfer[1].rx_buf = &req->scratch;
		req->xfer[1].len = 2;

		/* for 1uF, settle for 800 usec; no cap, 100 usec.  */
		req->xfer[1].delay_usecs = ts->vref_delay_usecs;
		spi_message_add_tail(&req->xfer[1], &req->msg);
	}
D
David Brownell 已提交
233 234 235 236 237

	/* take sample */
	req->command = (u8) command;
	req->xfer[2].tx_buf = &req->command;
	req->xfer[2].len = 1;
238 239
	spi_message_add_tail(&req->xfer[2], &req->msg);

D
David Brownell 已提交
240 241
	req->xfer[3].rx_buf = &req->sample;
	req->xfer[3].len = 2;
242
	spi_message_add_tail(&req->xfer[3], &req->msg);
D
David Brownell 已提交
243 244 245

	/* REVISIT:  take a few more samples, and compare ... */

246 247 248 249 250 251 252 253 254 255
	/* converter in low power mode & enable PENIRQ */
	req->ref_off = PWRDOWN;
	req->xfer[4].tx_buf = &req->ref_off;
	req->xfer[4].len = 1;
	spi_message_add_tail(&req->xfer[4], &req->msg);

	req->xfer[5].rx_buf = &req->scratch;
	req->xfer[5].len = 2;
	CS_CHANGE(req->xfer[5]);
	spi_message_add_tail(&req->xfer[5], &req->msg);
D
David Brownell 已提交
256

257
	ts->irq_disabled = 1;
D
David Brownell 已提交
258 259
	disable_irq(spi->irq);
	status = spi_sync(spi, &req->msg);
260
	ts->irq_disabled = 0;
D
David Brownell 已提交
261 262
	enable_irq(spi->irq);

263 264
	if (status == 0) {
		/* on-wire is a must-ignore bit, a BE12 value, then padding */
265 266 267
		status = be16_to_cpu(req->sample);
		status = status >> 3;
		status &= 0x0fff;
268
	}
D
David Brownell 已提交
269

270
	kfree(req);
271
	return status;
D
David Brownell 已提交
272 273
}

274 275 276
#if defined(CONFIG_HWMON) || defined(CONFIG_HWMON_MODULE)

#define SHOW(name, var, adjust) static ssize_t \
D
David Brownell 已提交
277 278
name ## _show(struct device *dev, struct device_attribute *attr, char *buf) \
{ \
279
	struct ads7846 *ts = dev_get_drvdata(dev); \
D
David Brownell 已提交
280
	ssize_t v = ads7846_read12_ser(dev, \
281
			READ_12BIT_SER(var) | ADS_PD10_ALL_ON); \
D
David Brownell 已提交
282 283
	if (v < 0) \
		return v; \
284
	return sprintf(buf, "%u\n", adjust(ts, v)); \
D
David Brownell 已提交
285 286 287
} \
static DEVICE_ATTR(name, S_IRUGO, name ## _show, NULL);

288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311

/* Sysfs conventions report temperatures in millidegrees Celcius.
 * ADS7846 could use the low-accuracy two-sample scheme, but can't do the high
 * accuracy scheme without calibration data.  For now we won't try either;
 * userspace sees raw sensor values, and must scale/calibrate appropriately.
 */
static inline unsigned null_adjust(struct ads7846 *ts, ssize_t v)
{
	return v;
}

SHOW(temp0, temp0, null_adjust)		/* temp1_input */
SHOW(temp1, temp1, null_adjust)		/* temp2_input */


/* sysfs conventions report voltages in millivolts.  We can convert voltages
 * if we know vREF.  userspace may need to scale vAUX to match the board's
 * external resistors; we assume that vBATT only uses the internal ones.
 */
static inline unsigned vaux_adjust(struct ads7846 *ts, ssize_t v)
{
	unsigned retval = v;

	/* external resistors may scale vAUX into 0..vREF */
312
	retval *= ts->vref_mv;
313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363
	retval = retval >> 12;
	return retval;
}

static inline unsigned vbatt_adjust(struct ads7846 *ts, ssize_t v)
{
	unsigned retval = vaux_adjust(ts, v);

	/* ads7846 has a resistor ladder to scale this signal down */
	if (ts->model == 7846)
		retval *= 4;
	return retval;
}

SHOW(in0_input, vaux, vaux_adjust)
SHOW(in1_input, vbatt, vbatt_adjust)


static struct attribute *ads7846_attributes[] = {
	&dev_attr_temp0.attr,
	&dev_attr_temp1.attr,
	&dev_attr_in0_input.attr,
	&dev_attr_in1_input.attr,
	NULL,
};

static struct attribute_group ads7846_attr_group = {
	.attrs = ads7846_attributes,
};

static struct attribute *ads7843_attributes[] = {
	&dev_attr_in0_input.attr,
	&dev_attr_in1_input.attr,
	NULL,
};

static struct attribute_group ads7843_attr_group = {
	.attrs = ads7843_attributes,
};

static struct attribute *ads7845_attributes[] = {
	&dev_attr_in0_input.attr,
	NULL,
};

static struct attribute_group ads7845_attr_group = {
	.attrs = ads7845_attributes,
};

static int ads784x_hwmon_register(struct spi_device *spi, struct ads7846 *ts)
{
364
	struct device *hwmon;
365 366 367 368 369
	int err;

	/* hwmon sensors need a reference voltage */
	switch (ts->model) {
	case 7846:
370
		if (!ts->vref_mv) {
371
			dev_dbg(&spi->dev, "assuming 2.5V internal vREF\n");
372
			ts->vref_mv = 2500;
373 374 375 376
		}
		break;
	case 7845:
	case 7843:
377
		if (!ts->vref_mv) {
378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436
			dev_warn(&spi->dev,
				"external vREF for ADS%d not specified\n",
				ts->model);
			return 0;
		}
		break;
	}

	/* different chips have different sensor groups */
	switch (ts->model) {
	case 7846:
		ts->attr_group = &ads7846_attr_group;
		break;
	case 7845:
		ts->attr_group = &ads7845_attr_group;
		break;
	case 7843:
		ts->attr_group = &ads7843_attr_group;
		break;
	default:
		dev_dbg(&spi->dev, "ADS%d not recognized\n", ts->model);
		return 0;
	}

	err = sysfs_create_group(&spi->dev.kobj, ts->attr_group);
	if (err)
		return err;

	hwmon = hwmon_device_register(&spi->dev);
	if (IS_ERR(hwmon)) {
		sysfs_remove_group(&spi->dev.kobj, ts->attr_group);
		return PTR_ERR(hwmon);
	}

	ts->hwmon = hwmon;
	return 0;
}

static void ads784x_hwmon_unregister(struct spi_device *spi,
				     struct ads7846 *ts)
{
	if (ts->hwmon) {
		sysfs_remove_group(&spi->dev.kobj, ts->attr_group);
		hwmon_device_unregister(ts->hwmon);
	}
}

#else
static inline int ads784x_hwmon_register(struct spi_device *spi,
					 struct ads7846 *ts)
{
	return 0;
}

static inline void ads784x_hwmon_unregister(struct spi_device *spi,
					    struct ads7846 *ts)
{
}
#endif
D
David Brownell 已提交
437

438 439
static int is_pen_down(struct device *dev)
{
440
	struct ads7846	*ts = dev_get_drvdata(dev);
441 442 443 444 445 446 447 448 449 450 451 452

	return ts->pendown;
}

static ssize_t ads7846_pen_down_show(struct device *dev,
				     struct device_attribute *attr, char *buf)
{
	return sprintf(buf, "%u\n", is_pen_down(dev));
}

static DEVICE_ATTR(pen_down, S_IRUGO, ads7846_pen_down_show, NULL);

I
Imre Deak 已提交
453 454 455 456 457 458 459 460 461 462 463 464 465
static ssize_t ads7846_disable_show(struct device *dev,
				     struct device_attribute *attr, char *buf)
{
	struct ads7846	*ts = dev_get_drvdata(dev);

	return sprintf(buf, "%u\n", ts->disabled);
}

static ssize_t ads7846_disable_store(struct device *dev,
				     struct device_attribute *attr,
				     const char *buf, size_t count)
{
	struct ads7846 *ts = dev_get_drvdata(dev);
466 467 468 469
	long i;

	if (strict_strtoul(buf, 10, &i))
		return -EINVAL;
I
Imre Deak 已提交
470 471 472 473 474 475 476 477 478 479 480 481 482 483 484

	spin_lock_irq(&ts->lock);

	if (i)
		ads7846_disable(ts);
	else
		ads7846_enable(ts);

	spin_unlock_irq(&ts->lock);

	return count;
}

static DEVICE_ATTR(disable, 0664, ads7846_disable_show, ads7846_disable_store);

485
static struct attribute *ads784x_attributes[] = {
486 487 488 489 490
	&dev_attr_pen_down.attr,
	&dev_attr_disable.attr,
	NULL,
};

491 492
static struct attribute_group ads784x_attr_group = {
	.attrs = ads784x_attributes,
493 494
};

D
David Brownell 已提交
495 496
/*--------------------------------------------------------------------------*/

497 498 499 500 501 502 503 504
static int get_pendown_state(struct ads7846 *ts)
{
	if (ts->get_pendown_state)
		return ts->get_pendown_state();

	return !gpio_get_value(ts->gpio_pendown);
}

D
David Brownell 已提交
505 506 507 508 509 510 511 512 513 514
/*
 * PENIRQ only kicks the timer.  The timer only reissues the SPI transfer,
 * to retrieve touchscreen status.
 *
 * The SPI transfer completion callback does the real work.  It reports
 * touchscreen events and reactivates the timer (or IRQ) as appropriate.
 */

static void ads7846_rx(void *ads)
{
515 516 517
	struct ads7846		*ts = ads;
	unsigned		Rt;
	u16			x, y, z1, z2;
D
David Brownell 已提交
518

519 520
	/* ads7846_rx_val() did in-place conversion (including byteswap) from
	 * on-the-wire format as part of debouncing to get stable readings.
D
David Brownell 已提交
521
	 */
522 523 524 525
	x = ts->tc.x;
	y = ts->tc.y;
	z1 = ts->tc.z1;
	z2 = ts->tc.z2;
D
David Brownell 已提交
526 527 528 529 530

	/* range filtering */
	if (x == MAX_12BIT)
		x = 0;

531 532 533
	if (ts->model == 7843) {
		Rt = ts->pressure_max / 2;
	} else if (likely(x && z1)) {
D
David Brownell 已提交
534 535 536 537 538 539 540
		/* compute touch pressure resistance using equation #2 */
		Rt = z2;
		Rt -= z1;
		Rt *= x;
		Rt *= ts->x_plate_ohms;
		Rt /= z1;
		Rt = (Rt + 2047) >> 12;
541
	} else {
D
David Brownell 已提交
542
		Rt = 0;
543
	}
544

545
	/* Sample found inconsistent by debouncing or pressure is beyond
546 547 548
	 * the maximum. Don't report it to user space, repeat at least
	 * once more the measurement
	 */
549
	if (ts->tc.ignore || Rt > ts->pressure_max) {
550 551 552 553
#ifdef VERBOSE
		pr_debug("%s: ignored %d pressure %d\n",
			ts->spi->dev.bus_id, ts->tc.ignore, Rt);
#endif
554
		hrtimer_start(&ts->timer, ktime_set(0, TS_POLL_PERIOD),
555
			      HRTIMER_MODE_REL);
556 557 558
		return;
	}

559 560 561 562 563
	/* Maybe check the pendown state before reporting. This discards
	 * false readings when the pen is lifted.
	 */
	if (ts->penirq_recheck_delay_usecs) {
		udelay(ts->penirq_recheck_delay_usecs);
564
		if (!get_pendown_state(ts))
565 566 567
			Rt = 0;
	}

568 569 570 571
	/* NOTE: We can't rely on the pressure to determine the pen down
	 * state, even this controller has a pressure sensor.  The pressure
	 * value can fluctuate for quite a while after lifting the pen and
	 * in some cases may not even settle at the expected value.
D
David Brownell 已提交
572
	 *
573 574
	 * The only safe way to check for the pen up condition is in the
	 * timer by reading the pen signal state (it's a GPIO _and_ IRQ).
D
David Brownell 已提交
575 576
	 */
	if (Rt) {
577
		struct input_dev *input = ts->input;
578

579 580 581 582 583
		if (!ts->pendown) {
			input_report_key(input, BTN_TOUCH, 1);
			ts->pendown = 1;
#ifdef VERBOSE
			dev_dbg(&ts->spi->dev, "DOWN\n");
D
David Brownell 已提交
584
#endif
585 586 587 588
		}
		input_report_abs(input, ABS_X, x);
		input_report_abs(input, ABS_Y, y);
		input_report_abs(input, ABS_PRESSURE, Rt);
D
David Brownell 已提交
589

590 591 592 593 594
		input_sync(input);
#ifdef VERBOSE
		dev_dbg(&ts->spi->dev, "%4d/%4d/%4d\n", x, y, Rt);
#endif
	}
D
David Brownell 已提交
595

596 597
	hrtimer_start(&ts->timer, ktime_set(0, TS_POLL_PERIOD),
			HRTIMER_MODE_REL);
D
David Brownell 已提交
598 599
}

600
static int ads7846_debounce(void *ads, int data_idx, int *val)
601 602 603
{
	struct ads7846		*ts = ads;

604 605 606
	if (!ts->read_cnt || (abs(ts->last_read - *val) > ts->debounce_tol)) {
		/* Start over collecting consistent readings. */
		ts->read_rep = 0;
607 608 609
		/* Repeat it, if this was the first read or the read
		 * wasn't consistent enough. */
		if (ts->read_cnt < ts->debounce_max) {
610
			ts->last_read = *val;
611
			ts->read_cnt++;
612
			return ADS7846_FILTER_REPEAT;
613 614 615 616 617 618 619
		} else {
			/* Maximum number of debouncing reached and still
			 * not enough number of consistent readings. Abort
			 * the whole sample, repeat it in the next sampling
			 * period.
			 */
			ts->read_cnt = 0;
620
			return ADS7846_FILTER_IGNORE;
621
		}
622
	} else {
623 624 625 626 627
		if (++ts->read_rep > ts->debounce_rep) {
			/* Got a good reading for this coordinate,
			 * go for the next one. */
			ts->read_cnt = 0;
			ts->read_rep = 0;
628 629
			return ADS7846_FILTER_OK;
		} else {
630 631
			/* Read more values that are consistent. */
			ts->read_cnt++;
632 633 634 635 636 637 638 639 640 641 642 643 644 645 646 647 648 649 650 651 652 653 654 655 656
			return ADS7846_FILTER_REPEAT;
		}
	}
}

static int ads7846_no_filter(void *ads, int data_idx, int *val)
{
	return ADS7846_FILTER_OK;
}

static void ads7846_rx_val(void *ads)
{
	struct ads7846 *ts = ads;
	struct spi_message *m;
	struct spi_transfer *t;
	int val;
	int action;
	int status;

	m = &ts->msg[ts->msg_idx];
	t = list_entry(m->transfers.prev, struct spi_transfer, transfer_list);

	/* adjust:  on-wire is a must-ignore bit, a BE12 value, then padding;
	 * built from two 8 bit values written msb-first.
	 */
657
	val = be16_to_cpup((__be16 *)t->rx_buf) >> 3;
658 659 660 661 662 663 664 665 666 667 668 669 670

	action = ts->filter(ts->filter_data, ts->msg_idx, &val);
	switch (action) {
	case ADS7846_FILTER_REPEAT:
		break;
	case ADS7846_FILTER_IGNORE:
		ts->tc.ignore = 1;
		/* Last message will contain ads7846_rx() as the
		 * completion function.
		 */
		m = ts->last_msg;
		break;
	case ADS7846_FILTER_OK:
671
		*(u16 *)t->rx_buf = val;
672 673 674 675 676
		ts->tc.ignore = 0;
		m = &ts->msg[++ts->msg_idx];
		break;
	default:
		BUG();
677 678 679 680 681 682 683
	}
	status = spi_async(ts->spi, m);
	if (status)
		dev_err(&ts->spi->dev, "spi_async --> %d\n",
				status);
}

684
static enum hrtimer_restart ads7846_timer(struct hrtimer *handle)
D
David Brownell 已提交
685
{
686
	struct ads7846	*ts = container_of(handle, struct ads7846, timer);
D
David Brownell 已提交
687
	int		status = 0;
688

689 690
	spin_lock_irq(&ts->lock);

691
	if (unlikely(!get_pendown_state(ts) ||
692 693 694 695 696 697 698 699 700 701 702 703 704 705
		     device_suspended(&ts->spi->dev))) {
		if (ts->pendown) {
			struct input_dev *input = ts->input;

			input_report_key(input, BTN_TOUCH, 0);
			input_report_abs(input, ABS_PRESSURE, 0);
			input_sync(input);

			ts->pendown = 0;
#ifdef VERBOSE
			dev_dbg(&ts->spi->dev, "UP\n");
#endif
		}

706
		/* measurement cycle ended */
707 708 709 710 711 712 713 714 715 716 717 718 719 720
		if (!device_suspended(&ts->spi->dev)) {
			ts->irq_disabled = 0;
			enable_irq(ts->spi->irq);
		}
		ts->pending = 0;
	} else {
		/* pen is still down, continue with the measurement */
		ts->msg_idx = 0;
		status = spi_async(ts->spi, &ts->msg[0]);
		if (status)
			dev_err(&ts->spi->dev, "spi_async --> %d\n", status);
	}

	spin_unlock_irq(&ts->lock);
721
	return HRTIMER_NORESTART;
722 723
}

724
static irqreturn_t ads7846_irq(int irq, void *handle)
725 726 727
{
	struct ads7846 *ts = handle;
	unsigned long flags;
D
David Brownell 已提交
728 729

	spin_lock_irqsave(&ts->lock, flags);
730
	if (likely(get_pendown_state(ts))) {
D
David Brownell 已提交
731
		if (!ts->irq_disabled) {
732 733 734 735
			/* The ARM do_simple_IRQ() dispatcher doesn't act
			 * like the other dispatchers:  it will report IRQs
			 * even after they've been disabled.  We work around
			 * that here.  (The "generic irq" framework may help...)
736
			 */
D
David Brownell 已提交
737 738
			ts->irq_disabled = 1;
			disable_irq(ts->spi->irq);
739
			ts->pending = 1;
740
			hrtimer_start(&ts->timer, ktime_set(0, TS_POLL_DELAY),
741
					HRTIMER_MODE_REL);
742
		}
D
David Brownell 已提交
743 744
	}
	spin_unlock_irqrestore(&ts->lock, flags);
I
Imre Deak 已提交
745 746

	return IRQ_HANDLED;
D
David Brownell 已提交
747 748 749 750
}

/*--------------------------------------------------------------------------*/

I
Imre Deak 已提交
751 752
/* Must be called with ts->lock held */
static void ads7846_disable(struct ads7846 *ts)
D
David Brownell 已提交
753
{
I
Imre Deak 已提交
754 755
	if (ts->disabled)
		return;
D
David Brownell 已提交
756

757 758
	ts->disabled = 1;

D
David Brownell 已提交
759
	/* are we waiting for IRQ, or polling? */
760 761 762
	if (!ts->pending) {
		ts->irq_disabled = 1;
		disable_irq(ts->spi->irq);
D
David Brownell 已提交
763
	} else {
764 765
		/* the timer will run at least once more, and
		 * leave everything in a clean state, IRQ disabled
D
David Brownell 已提交
766
		 */
767
		while (ts->pending) {
I
Imre Deak 已提交
768
			spin_unlock_irq(&ts->lock);
769
			msleep(1);
I
Imre Deak 已提交
770
			spin_lock_irq(&ts->lock);
D
David Brownell 已提交
771 772 773 774 775 776 777
		}
	}

	/* we know the chip's in lowpower mode since we always
	 * leave it that way after every request
	 */

I
Imre Deak 已提交
778 779 780 781 782 783 784 785 786 787 788 789 790 791 792 793 794 795 796
}

/* Must be called with ts->lock held */
static void ads7846_enable(struct ads7846 *ts)
{
	if (!ts->disabled)
		return;

	ts->disabled = 0;
	ts->irq_disabled = 0;
	enable_irq(ts->spi->irq);
}

static int ads7846_suspend(struct spi_device *spi, pm_message_t message)
{
	struct ads7846 *ts = dev_get_drvdata(&spi->dev);

	spin_lock_irq(&ts->lock);

797
	ts->is_suspended = 1;
I
Imre Deak 已提交
798 799 800 801
	ads7846_disable(ts);

	spin_unlock_irq(&ts->lock);

D
David Brownell 已提交
802
	return 0;
I
Imre Deak 已提交
803

D
David Brownell 已提交
804 805
}

806
static int ads7846_resume(struct spi_device *spi)
D
David Brownell 已提交
807
{
808
	struct ads7846 *ts = dev_get_drvdata(&spi->dev);
D
David Brownell 已提交
809

I
Imre Deak 已提交
810 811
	spin_lock_irq(&ts->lock);

812
	ts->is_suspended = 0;
I
Imre Deak 已提交
813 814 815 816
	ads7846_enable(ts);

	spin_unlock_irq(&ts->lock);

D
David Brownell 已提交
817 818 819
	return 0;
}

820 821 822 823 824 825 826 827 828 829 830 831 832 833 834 835 836 837 838 839 840 841 842 843 844 845 846 847 848 849
static int __devinit setup_pendown(struct spi_device *spi, struct ads7846 *ts)
{
	struct ads7846_platform_data *pdata = spi->dev.platform_data;
	int err;

	/* REVISIT when the irq can be triggered active-low, or if for some
	 * reason the touchscreen isn't hooked up, we don't need to access
	 * the pendown state.
	 */
	if (!pdata->get_pendown_state && !gpio_is_valid(pdata->gpio_pendown)) {
		dev_err(&spi->dev, "no get_pendown_state nor gpio_pendown?\n");
		return -EINVAL;
	}

	if (pdata->get_pendown_state) {
		ts->get_pendown_state = pdata->get_pendown_state;
		return 0;
	}

	err = gpio_request(pdata->gpio_pendown, "ads7846_pendown");
	if (err) {
		dev_err(&spi->dev, "failed to request pendown GPIO%d\n",
				pdata->gpio_pendown);
		return err;
	}

	ts->gpio_pendown = pdata->gpio_pendown;
	return 0;
}

850
static int __devinit ads7846_probe(struct spi_device *spi)
D
David Brownell 已提交
851 852
{
	struct ads7846			*ts;
853
	struct input_dev		*input_dev;
854
	struct ads7846_platform_data	*pdata = spi->dev.platform_data;
855
	struct spi_message		*m;
D
David Brownell 已提交
856
	struct spi_transfer		*x;
857
	int				vref;
858
	int				err;
D
David Brownell 已提交
859 860

	if (!spi->irq) {
861
		dev_dbg(&spi->dev, "no IRQ?\n");
D
David Brownell 已提交
862 863 864 865
		return -ENODEV;
	}

	if (!pdata) {
866
		dev_dbg(&spi->dev, "no platform data?\n");
D
David Brownell 已提交
867 868 869 870
		return -ENODEV;
	}

	/* don't exceed max specified sample rate */
871
	if (spi->max_speed_hz > (125000 * SAMPLE_BITS)) {
872
		dev_dbg(&spi->dev, "f(sample) %d KHz?\n",
873
				(spi->max_speed_hz/SAMPLE_BITS)/1000);
D
David Brownell 已提交
874 875 876
		return -EINVAL;
	}

877 878 879
	/* We'd set TX wordsize 8 bits and RX wordsize to 13 bits ... except
	 * that even if the hardware can do that, the SPI controller driver
	 * may not.  So we stick to very-portable 8 bit words, both RX and TX.
D
David Brownell 已提交
880
	 */
881
	spi->bits_per_word = 8;
882
	spi->mode = SPI_MODE_0;
883 884 885
	err = spi_setup(spi);
	if (err < 0)
		return err;
D
David Brownell 已提交
886

887 888 889 890 891 892
	ts = kzalloc(sizeof(struct ads7846), GFP_KERNEL);
	input_dev = input_allocate_device();
	if (!ts || !input_dev) {
		err = -ENOMEM;
		goto err_free_mem;
	}
D
David Brownell 已提交
893

894
	dev_set_drvdata(&spi->dev, ts);
D
David Brownell 已提交
895 896

	ts->spi = spi;
897
	ts->input = input_dev;
898
	ts->vref_mv = pdata->vref_mv;
D
David Brownell 已提交
899

900
	hrtimer_init(&ts->timer, CLOCK_MONOTONIC, HRTIMER_MODE_REL);
D
David Brownell 已提交
901 902
	ts->timer.function = ads7846_timer;

I
Imre Deak 已提交
903 904
	spin_lock_init(&ts->lock);

D
David Brownell 已提交
905 906 907
	ts->model = pdata->model ? : 7846;
	ts->vref_delay_usecs = pdata->vref_delay_usecs ? : 100;
	ts->x_plate_ohms = pdata->x_plate_ohms ? : 400;
908
	ts->pressure_max = pdata->pressure_max ? : ~0;
909 910 911 912 913 914 915 916 917 918

	if (pdata->filter != NULL) {
		if (pdata->filter_init != NULL) {
			err = pdata->filter_init(pdata, &ts->filter_data);
			if (err < 0)
				goto err_free_mem;
		}
		ts->filter = pdata->filter;
		ts->filter_cleanup = pdata->filter_cleanup;
	} else if (pdata->debounce_max) {
919
		ts->debounce_max = pdata->debounce_max;
920 921
		if (ts->debounce_max < 2)
			ts->debounce_max = 2;
922 923
		ts->debounce_tol = pdata->debounce_tol;
		ts->debounce_rep = pdata->debounce_rep;
924 925
		ts->filter = ads7846_debounce;
		ts->filter_data = ts;
926
	} else
927
		ts->filter = ads7846_no_filter;
928 929 930 931

	err = setup_pendown(spi, ts);
	if (err)
		goto err_cleanup_filter;
D
David Brownell 已提交
932

933 934 935 936
	if (pdata->penirq_recheck_delay_usecs)
		ts->penirq_recheck_delay_usecs =
				pdata->penirq_recheck_delay_usecs;

937
	snprintf(ts->phys, sizeof(ts->phys), "%s/input0", spi->dev.bus_id);
D
David Brownell 已提交
938

939 940
	input_dev->name = "ADS784x Touchscreen";
	input_dev->phys = ts->phys;
941
	input_dev->dev.parent = &spi->dev;
D
David Brownell 已提交
942

943 944
	input_dev->evbit[0] = BIT_MASK(EV_KEY) | BIT_MASK(EV_ABS);
	input_dev->keybit[BIT_WORD(BTN_TOUCH)] = BIT_MASK(BTN_TOUCH);
945
	input_set_abs_params(input_dev, ABS_X,
D
David Brownell 已提交
946 947 948
			pdata->x_min ? : 0,
			pdata->x_max ? : MAX_12BIT,
			0, 0);
949
	input_set_abs_params(input_dev, ABS_Y,
D
David Brownell 已提交
950 951 952
			pdata->y_min ? : 0,
			pdata->y_max ? : MAX_12BIT,
			0, 0);
953
	input_set_abs_params(input_dev, ABS_PRESSURE,
D
David Brownell 已提交
954 955
			pdata->pressure_min, pdata->pressure_max, 0, 0);

956 957
	vref = pdata->keep_vref_on;

D
David Brownell 已提交
958 959 960
	/* set up the transfers to read touchscreen state; this assumes we
	 * use formula #2 for pressure, not #3.
	 */
961
	m = &ts->msg[0];
D
David Brownell 已提交
962 963
	x = ts->xfer;

964 965
	spi_message_init(m);

D
David Brownell 已提交
966
	/* y- still on; turn on only y+ (and ADC) */
967
	ts->read_y = READ_Y(vref);
968
	x->tx_buf = &ts->read_y;
D
David Brownell 已提交
969
	x->len = 1;
970
	spi_message_add_tail(x, m);
971

D
David Brownell 已提交
972 973 974
	x++;
	x->rx_buf = &ts->tc.y;
	x->len = 2;
975 976
	spi_message_add_tail(x, m);

977 978 979 980 981 982 983 984 985 986 987 988 989 990 991 992 993 994
	/* the first sample after switching drivers can be low quality;
	 * optionally discard it, using a second one after the signals
	 * have had enough time to stabilize.
	 */
	if (pdata->settle_delay_usecs) {
		x->delay_usecs = pdata->settle_delay_usecs;

		x++;
		x->tx_buf = &ts->read_y;
		x->len = 1;
		spi_message_add_tail(x, m);

		x++;
		x->rx_buf = &ts->tc.y;
		x->len = 2;
		spi_message_add_tail(x, m);
	}

995
	m->complete = ads7846_rx_val;
996 997 998 999 1000 1001 1002
	m->context = ts;

	m++;
	spi_message_init(m);

	/* turn y- off, x+ on, then leave in lowpower */
	x++;
1003
	ts->read_x = READ_X(vref);
1004 1005 1006 1007 1008 1009 1010 1011 1012
	x->tx_buf = &ts->read_x;
	x->len = 1;
	spi_message_add_tail(x, m);

	x++;
	x->rx_buf = &ts->tc.x;
	x->len = 2;
	spi_message_add_tail(x, m);

1013 1014 1015 1016 1017 1018 1019 1020 1021 1022 1023 1024 1025 1026 1027
	/* ... maybe discard first sample ... */
	if (pdata->settle_delay_usecs) {
		x->delay_usecs = pdata->settle_delay_usecs;

		x++;
		x->tx_buf = &ts->read_x;
		x->len = 1;
		spi_message_add_tail(x, m);

		x++;
		x->rx_buf = &ts->tc.x;
		x->len = 2;
		spi_message_add_tail(x, m);
	}

1028
	m->complete = ads7846_rx_val;
1029
	m->context = ts;
D
David Brownell 已提交
1030 1031 1032

	/* turn y+ off, x- on; we'll use formula #2 */
	if (ts->model == 7846) {
1033 1034 1035
		m++;
		spi_message_init(m);

1036
		x++;
1037
		ts->read_z1 = READ_Z1(vref);
1038
		x->tx_buf = &ts->read_z1;
D
David Brownell 已提交
1039
		x->len = 1;
1040
		spi_message_add_tail(x, m);
1041

D
David Brownell 已提交
1042 1043 1044
		x++;
		x->rx_buf = &ts->tc.z1;
		x->len = 2;
1045 1046
		spi_message_add_tail(x, m);

1047 1048 1049 1050 1051 1052 1053 1054 1055 1056 1057 1058 1059 1060 1061
		/* ... maybe discard first sample ... */
		if (pdata->settle_delay_usecs) {
			x->delay_usecs = pdata->settle_delay_usecs;

			x++;
			x->tx_buf = &ts->read_z1;
			x->len = 1;
			spi_message_add_tail(x, m);

			x++;
			x->rx_buf = &ts->tc.z1;
			x->len = 2;
			spi_message_add_tail(x, m);
		}

1062
		m->complete = ads7846_rx_val;
1063 1064 1065 1066
		m->context = ts;

		m++;
		spi_message_init(m);
D
David Brownell 已提交
1067

1068
		x++;
1069
		ts->read_z2 = READ_Z2(vref);
1070
		x->tx_buf = &ts->read_z2;
D
David Brownell 已提交
1071
		x->len = 1;
1072
		spi_message_add_tail(x, m);
1073

D
David Brownell 已提交
1074 1075 1076
		x++;
		x->rx_buf = &ts->tc.z2;
		x->len = 2;
1077
		spi_message_add_tail(x, m);
D
David Brownell 已提交
1078

1079 1080 1081 1082 1083 1084 1085 1086 1087 1088 1089 1090 1091 1092 1093
		/* ... maybe discard first sample ... */
		if (pdata->settle_delay_usecs) {
			x->delay_usecs = pdata->settle_delay_usecs;

			x++;
			x->tx_buf = &ts->read_z2;
			x->len = 1;
			spi_message_add_tail(x, m);

			x++;
			x->rx_buf = &ts->tc.z2;
			x->len = 2;
			spi_message_add_tail(x, m);
		}

1094
		m->complete = ads7846_rx_val;
1095 1096
		m->context = ts;
	}
1097 1098

	/* power down */
1099 1100 1101
	m++;
	spi_message_init(m);

1102 1103 1104 1105
	x++;
	ts->pwrdown = PWRDOWN;
	x->tx_buf = &ts->pwrdown;
	x->len = 1;
1106
	spi_message_add_tail(x, m);
1107 1108 1109 1110

	x++;
	x->rx_buf = &ts->dummy;
	x->len = 2;
1111
	CS_CHANGE(*x);
1112
	spi_message_add_tail(x, m);
D
David Brownell 已提交
1113

1114 1115
	m->complete = ads7846_rx;
	m->context = ts;
D
David Brownell 已提交
1116

1117 1118
	ts->last_msg = m;

1119
	if (request_irq(spi->irq, ads7846_irq, IRQF_TRIGGER_FALLING,
1120
			spi->dev.driver->name, ts)) {
1121
		dev_dbg(&spi->dev, "irq %d busy?\n", spi->irq);
1122
		err = -EBUSY;
1123
		goto err_free_gpio;
D
David Brownell 已提交
1124 1125
	}

1126 1127 1128 1129
	err = ads784x_hwmon_register(spi, ts);
	if (err)
		goto err_free_irq;

1130
	dev_info(&spi->dev, "touchscreen, irq %d\n", spi->irq);
D
David Brownell 已提交
1131

1132
	/* take a first sample, leaving nPENIRQ active and vREF off; avoid
D
David Brownell 已提交
1133 1134
	 * the touchscreen, in case it's not connected.
	 */
1135
	(void) ads7846_read12_ser(&spi->dev,
D
David Brownell 已提交
1136 1137
			  READ_12BIT_SER(vaux) | ADS_PD10_ALL_ON);

1138
	err = sysfs_create_group(&spi->dev.kobj, &ads784x_attr_group);
1139
	if (err)
1140
		goto err_remove_hwmon;
I
Imre Deak 已提交
1141

1142 1143
	err = input_register_device(input_dev);
	if (err)
1144
		goto err_remove_attr_group;
1145

D
David Brownell 已提交
1146
	return 0;
1147

1148
 err_remove_attr_group:
1149 1150 1151
	sysfs_remove_group(&spi->dev.kobj, &ads784x_attr_group);
 err_remove_hwmon:
	ads784x_hwmon_unregister(spi, ts);
1152
 err_free_irq:
1153
	free_irq(spi->irq, ts);
1154 1155 1156
 err_free_gpio:
	if (ts->gpio_pendown != -1)
		gpio_free(ts->gpio_pendown);
1157 1158 1159
 err_cleanup_filter:
	if (ts->filter_cleanup)
		ts->filter_cleanup(ts->filter_data);
1160 1161 1162 1163
 err_free_mem:
	input_free_device(input_dev);
	kfree(ts);
	return err;
D
David Brownell 已提交
1164 1165
}

1166
static int __devexit ads7846_remove(struct spi_device *spi)
D
David Brownell 已提交
1167
{
1168
	struct ads7846		*ts = dev_get_drvdata(&spi->dev);
D
David Brownell 已提交
1169

1170
	ads784x_hwmon_unregister(spi, ts);
I
Imre Deak 已提交
1171 1172
	input_unregister_device(ts->input);

1173
	ads7846_suspend(spi, PMSG_SUSPEND);
D
David Brownell 已提交
1174

1175
	sysfs_remove_group(&spi->dev.kobj, &ads784x_attr_group);
D
David Brownell 已提交
1176

I
Imre Deak 已提交
1177
	free_irq(ts->spi->irq, ts);
1178 1179
	/* suspend left the IRQ disabled */
	enable_irq(ts->spi->irq);
I
Imre Deak 已提交
1180

1181 1182 1183
	if (ts->gpio_pendown != -1)
		gpio_free(ts->gpio_pendown);

1184 1185 1186
	if (ts->filter_cleanup)
		ts->filter_cleanup(ts->filter_data);

D
David Brownell 已提交
1187 1188
	kfree(ts);

1189
	dev_dbg(&spi->dev, "unregistered touchscreen\n");
D
David Brownell 已提交
1190 1191 1192
	return 0;
}

1193 1194 1195 1196 1197 1198
static struct spi_driver ads7846_driver = {
	.driver = {
		.name	= "ads7846",
		.bus	= &spi_bus_type,
		.owner	= THIS_MODULE,
	},
D
David Brownell 已提交
1199
	.probe		= ads7846_probe,
1200
	.remove		= __devexit_p(ads7846_remove),
D
David Brownell 已提交
1201 1202 1203 1204 1205 1206
	.suspend	= ads7846_suspend,
	.resume		= ads7846_resume,
};

static int __init ads7846_init(void)
{
1207
	return spi_register_driver(&ads7846_driver);
D
David Brownell 已提交
1208 1209 1210 1211 1212
}
module_init(ads7846_init);

static void __exit ads7846_exit(void)
{
1213
	spi_unregister_driver(&ads7846_driver);
D
David Brownell 已提交
1214 1215 1216 1217 1218
}
module_exit(ads7846_exit);

MODULE_DESCRIPTION("ADS7846 TouchScreen Driver");
MODULE_LICENSE("GPL");