ads7846.c 27.6 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 27 28
#include <linux/delay.h>
#include <linux/input.h>
#include <linux/interrupt.h>
#include <linux/slab.h>
#include <linux/spi/spi.h>
#include <linux/spi/ads7846.h>
29
#include <asm/irq.h>
D
David Brownell 已提交
30 31 32 33 34 35 36 37 38 39

#ifdef	CONFIG_ARM
#include <asm/mach-types.h>
#ifdef	CONFIG_ARCH_OMAP
#include <asm/arch/gpio.h>
#endif
#endif


/*
40 41
 * This code has been heavily tested on a Nokia 770, and lightly
 * tested on other ads7846 devices (OSK/Mistral, Lubbock).
42 43
 * Support for ads7843 tested on Atmel at91sam926x-EK.
 * Support for ads7845 has only been stubbed in.
D
David Brownell 已提交
44
 *
I
Imre Deak 已提交
45 46 47 48 49 50
 * 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 已提交
51 52 53
 * 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 已提交
54 55 56
 * 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 已提交
57 58
 */

59 60
#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 已提交
61

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

D
David Brownell 已提交
65 66 67
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
68
	 * with msbs zeroed).  Instead, we read them as two 8-bit values,
69
	 * *** WHICH NEED BYTESWAPPING *** and range adjustment.
D
David Brownell 已提交
70
	 */
71 72 73
	u16	x;
	u16	y;
	u16	z1, z2;
74
	int	ignore;
D
David Brownell 已提交
75 76 77
};

struct ads7846 {
78
	struct input_dev	*input;
D
David Brownell 已提交
79 80 81
	char			phys[32];

	struct spi_device	*spi;
82 83

#if defined(CONFIG_HWMON) || defined(CONFIG_HWMON_MODULE)
84
	struct attribute_group	*attr_group;
85 86 87
	struct class_device	*hwmon;
#endif

D
David Brownell 已提交
88 89 90
	u16			model;
	u16			vref_delay_usecs;
	u16			x_plate_ohms;
91
	u16			pressure_max;
D
David Brownell 已提交
92

93 94
	u8			read_x, read_y, read_z1, read_z2, pwrdown;
	u16			dummy;		/* for the pwrdown read */
D
David Brownell 已提交
95 96
	struct ts_event		tc;

97
	struct spi_transfer	xfer[10];
98
	struct spi_message	msg[5];
99
	struct spi_message	*last_msg;
100 101
	int			msg_idx;
	int			read_cnt;
102
	int			read_rep;
103 104 105 106
	int			last_read;

	u16			debounce_max;
	u16			debounce_tol;
107
	u16			debounce_rep;
D
David Brownell 已提交
108 109

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

117 118 119
	int			(*filter)(void *data, int data_idx, int *val);
	void			*filter_data;
	void			(*filter_cleanup)(void *data);
120
	int			(*get_pendown_state)(void);
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 185
static unsigned vREF_mV;
module_param(vREF_mV, uint, 0);
MODULE_PARM_DESC(vREF_mV, "external vREF voltage, in milliVolts");
D
David Brownell 已提交
186 187

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

I
Imre Deak 已提交
197 198 199
static void ads7846_enable(struct ads7846 *ts);
static void ads7846_disable(struct ads7846 *ts);

200 201 202 203 204 205
static int device_suspended(struct device *dev)
{
	struct ads7846 *ts = dev_get_drvdata(dev);
	return dev->power.power_state.event != PM_EVENT_ON || ts->disabled;
}

D
David Brownell 已提交
206 207 208 209
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);
210
	struct ser_req		*req = kzalloc(sizeof *req, GFP_KERNEL);
D
David Brownell 已提交
211 212
	int			status;
	int			sample;
213
	int			use_internal;
D
David Brownell 已提交
214 215 216 217

	if (!req)
		return -ENOMEM;

218
	spi_message_init(&req->msg);
219

220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236
	/* 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 已提交
237 238 239 240 241

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

D
David Brownell 已提交
244 245
	req->xfer[3].rx_buf = &req->sample;
	req->xfer[3].len = 2;
246
	spi_message_add_tail(&req->xfer[3], &req->msg);
D
David Brownell 已提交
247 248 249

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

250 251 252 253 254 255 256 257 258 259
	/* 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 已提交
260

261
	ts->irq_disabled = 1;
D
David Brownell 已提交
262 263
	disable_irq(spi->irq);
	status = spi_sync(spi, &req->msg);
264
	ts->irq_disabled = 0;
D
David Brownell 已提交
265 266 267 268
	enable_irq(spi->irq);

	if (req->msg.status)
		status = req->msg.status;
269 270

	/* on-wire is a must-ignore bit, a BE12 value, then padding */
D
David Brownell 已提交
271
	sample = be16_to_cpu(req->sample);
272 273
	sample = sample >> 3;
	sample &= 0x0fff;
D
David Brownell 已提交
274

275
	kfree(req);
D
David Brownell 已提交
276 277 278
	return status ? status : sample;
}

279 280 281
#if defined(CONFIG_HWMON) || defined(CONFIG_HWMON_MODULE)

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

293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 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 364 365 366 367 368 369 370 371 372 373 374 375 376 377 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 437 438 439 440 441

/* 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 */
	retval *= vREF_mV;
	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)
{
	struct class_device *hwmon;
	int err;

	/* hwmon sensors need a reference voltage */
	switch (ts->model) {
	case 7846:
		if (!vREF_mV) {
			dev_dbg(&spi->dev, "assuming 2.5V internal vREF\n");
			vREF_mV = 2500;
		}
		break;
	case 7845:
	case 7843:
		if (!vREF_mV) {
			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 已提交
442

443 444
static int is_pen_down(struct device *dev)
{
445
	struct ads7846	*ts = dev_get_drvdata(dev);
446 447 448 449 450 451 452 453 454 455 456 457

	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 已提交
458 459 460 461 462 463 464 465 466 467 468 469 470 471 472 473 474 475 476 477 478 479 480 481 482 483 484 485 486 487 488
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);
	char *endp;
	int i;

	i = simple_strtoul(buf, &endp, 10);
	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);

489
static struct attribute *ads784x_attributes[] = {
490 491 492 493 494
	&dev_attr_pen_down.attr,
	&dev_attr_disable.attr,
	NULL,
};

495 496
static struct attribute_group ads784x_attr_group = {
	.attrs = ads784x_attributes,
497 498
};

D
David Brownell 已提交
499 500 501 502 503 504 505 506 507 508 509 510
/*--------------------------------------------------------------------------*/

/*
 * 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)
{
511 512 513
	struct ads7846		*ts = ads;
	unsigned		Rt;
	u16			x, y, z1, z2;
D
David Brownell 已提交
514

515 516
	/* 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 已提交
517
	 */
518 519 520 521
	x = ts->tc.x;
	y = ts->tc.y;
	z1 = ts->tc.z1;
	z2 = ts->tc.z2;
D
David Brownell 已提交
522 523 524 525 526

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

527
	if (likely(x && z1)) {
D
David Brownell 已提交
528 529 530 531 532 533 534 535 536 537
		/* compute touch pressure resistance using equation #2 */
		Rt = z2;
		Rt -= z1;
		Rt *= x;
		Rt *= ts->x_plate_ohms;
		Rt /= z1;
		Rt = (Rt + 2047) >> 12;
	} else
		Rt = 0;

538 539 540
	if (ts->model == 7843)
		Rt = ts->pressure_max / 2;

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

555 556 557 558
	/* 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 已提交
559
	 *
560 561
	 * 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 已提交
562 563
	 */
	if (Rt) {
564
		struct input_dev *input = ts->input;
565

566 567 568 569 570
		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 已提交
571
#endif
572 573 574 575
		}
		input_report_abs(input, ABS_X, x);
		input_report_abs(input, ABS_Y, y);
		input_report_abs(input, ABS_PRESSURE, Rt);
D
David Brownell 已提交
576

577 578 579 580 581
		input_sync(input);
#ifdef VERBOSE
		dev_dbg(&ts->spi->dev, "%4d/%4d/%4d\n", x, y, Rt);
#endif
	}
D
David Brownell 已提交
582

583 584
	hrtimer_start(&ts->timer, ktime_set(0, TS_POLL_PERIOD),
			HRTIMER_MODE_REL);
D
David Brownell 已提交
585 586
}

587
static int ads7846_debounce(void *ads, int data_idx, int *val)
588 589 590
{
	struct ads7846		*ts = ads;

591 592 593
	if (!ts->read_cnt || (abs(ts->last_read - *val) > ts->debounce_tol)) {
		/* Start over collecting consistent readings. */
		ts->read_rep = 0;
594 595 596
		/* Repeat it, if this was the first read or the read
		 * wasn't consistent enough. */
		if (ts->read_cnt < ts->debounce_max) {
597
			ts->last_read = *val;
598
			ts->read_cnt++;
599
			return ADS7846_FILTER_REPEAT;
600 601 602 603 604 605 606
		} 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;
607
			return ADS7846_FILTER_IGNORE;
608
		}
609
	} else {
610 611 612 613 614
		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;
615 616
			return ADS7846_FILTER_OK;
		} else {
617 618
			/* Read more values that are consistent. */
			ts->read_cnt++;
619 620 621 622 623 624 625 626 627 628 629 630 631 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 657 658 659 660 661 662 663 664 665
			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;
	u16 *rx_val;
	int val;
	int action;
	int status;

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

	/* adjust:  on-wire is a must-ignore bit, a BE12 value, then padding;
	 * built from two 8 bit values written msb-first.
	 */
	val = be16_to_cpu(*rx_val) >> 3;

	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:
		*rx_val = val;
		ts->tc.ignore = 0;
		m = &ts->msg[++ts->msg_idx];
		break;
	default:
		BUG();
666 667 668 669 670 671 672
	}
	status = spi_async(ts->spi, m);
	if (status)
		dev_err(&ts->spi->dev, "spi_async --> %d\n",
				status);
}

673
static enum hrtimer_restart ads7846_timer(struct hrtimer *handle)
D
David Brownell 已提交
674
{
675
	struct ads7846	*ts = container_of(handle, struct ads7846, timer);
D
David Brownell 已提交
676
	int		status = 0;
677

678 679
	spin_lock_irq(&ts->lock);

680 681 682 683 684 685 686 687 688 689 690 691 692 693 694
	if (unlikely(!ts->get_pendown_state() ||
		     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
		}

695
		/* measurement cycle ended */
696 697 698 699 700 701 702 703 704 705 706 707 708 709
		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);
710
	return HRTIMER_NORESTART;
711 712
}

713
static irqreturn_t ads7846_irq(int irq, void *handle)
714 715 716
{
	struct ads7846 *ts = handle;
	unsigned long flags;
D
David Brownell 已提交
717 718

	spin_lock_irqsave(&ts->lock, flags);
719
	if (likely(ts->get_pendown_state())) {
D
David Brownell 已提交
720
		if (!ts->irq_disabled) {
721 722 723 724
			/* 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...)
725
			 */
D
David Brownell 已提交
726 727
			ts->irq_disabled = 1;
			disable_irq(ts->spi->irq);
728
			ts->pending = 1;
729
			hrtimer_start(&ts->timer, ktime_set(0, TS_POLL_DELAY),
730
					HRTIMER_MODE_REL);
731
		}
D
David Brownell 已提交
732 733
	}
	spin_unlock_irqrestore(&ts->lock, flags);
I
Imre Deak 已提交
734 735

	return IRQ_HANDLED;
D
David Brownell 已提交
736 737 738 739
}

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

I
Imre Deak 已提交
740 741
/* Must be called with ts->lock held */
static void ads7846_disable(struct ads7846 *ts)
D
David Brownell 已提交
742
{
I
Imre Deak 已提交
743 744
	if (ts->disabled)
		return;
D
David Brownell 已提交
745

746 747
	ts->disabled = 1;

D
David Brownell 已提交
748
	/* are we waiting for IRQ, or polling? */
749 750 751
	if (!ts->pending) {
		ts->irq_disabled = 1;
		disable_irq(ts->spi->irq);
D
David Brownell 已提交
752
	} else {
753 754
		/* the timer will run at least once more, and
		 * leave everything in a clean state, IRQ disabled
D
David Brownell 已提交
755
		 */
756
		while (ts->pending) {
I
Imre Deak 已提交
757
			spin_unlock_irq(&ts->lock);
758
			msleep(1);
I
Imre Deak 已提交
759
			spin_lock_irq(&ts->lock);
D
David Brownell 已提交
760 761 762 763 764 765 766
		}
	}

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

I
Imre Deak 已提交
767 768 769 770 771 772 773 774 775 776 777 778 779 780 781 782 783 784 785 786 787 788 789 790
}

/* 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);

	spi->dev.power.power_state = message;
	ads7846_disable(ts);

	spin_unlock_irq(&ts->lock);

D
David Brownell 已提交
791
	return 0;
I
Imre Deak 已提交
792

D
David Brownell 已提交
793 794
}

795
static int ads7846_resume(struct spi_device *spi)
D
David Brownell 已提交
796
{
797
	struct ads7846 *ts = dev_get_drvdata(&spi->dev);
D
David Brownell 已提交
798

I
Imre Deak 已提交
799 800
	spin_lock_irq(&ts->lock);

801
	spi->dev.power.power_state = PMSG_ON;
I
Imre Deak 已提交
802 803 804 805
	ads7846_enable(ts);

	spin_unlock_irq(&ts->lock);

D
David Brownell 已提交
806 807 808
	return 0;
}

809
static int __devinit ads7846_probe(struct spi_device *spi)
D
David Brownell 已提交
810 811
{
	struct ads7846			*ts;
812
	struct input_dev		*input_dev;
813
	struct ads7846_platform_data	*pdata = spi->dev.platform_data;
814
	struct spi_message		*m;
D
David Brownell 已提交
815
	struct spi_transfer		*x;
816
	int				vref;
817
	int				err;
D
David Brownell 已提交
818 819

	if (!spi->irq) {
820
		dev_dbg(&spi->dev, "no IRQ?\n");
D
David Brownell 已提交
821 822 823 824
		return -ENODEV;
	}

	if (!pdata) {
825
		dev_dbg(&spi->dev, "no platform data?\n");
D
David Brownell 已提交
826 827 828 829
		return -ENODEV;
	}

	/* don't exceed max specified sample rate */
830
	if (spi->max_speed_hz > (125000 * SAMPLE_BITS)) {
831
		dev_dbg(&spi->dev, "f(sample) %d KHz?\n",
832
				(spi->max_speed_hz/SAMPLE_BITS)/1000);
D
David Brownell 已提交
833 834 835
		return -EINVAL;
	}

836 837 838 839
	/* 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.
	 */
840 841 842 843 844
	if (pdata->get_pendown_state == NULL) {
		dev_dbg(&spi->dev, "no get_pendown_state function?\n");
		return -EINVAL;
	}

845 846 847
	/* 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 已提交
848
	 */
849
	spi->bits_per_word = 8;
850 851 852 853
	spi->mode = SPI_MODE_1;
	err = spi_setup(spi);
	if (err < 0)
		return err;
D
David Brownell 已提交
854

855 856 857 858 859 860
	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 已提交
861

862
	dev_set_drvdata(&spi->dev, ts);
863
	spi->dev.power.power_state = PMSG_ON;
D
David Brownell 已提交
864 865

	ts->spi = spi;
866
	ts->input = input_dev;
D
David Brownell 已提交
867

868
	hrtimer_init(&ts->timer, CLOCK_MONOTONIC, HRTIMER_MODE_REL);
D
David Brownell 已提交
869 870
	ts->timer.function = ads7846_timer;

I
Imre Deak 已提交
871 872
	spin_lock_init(&ts->lock);

D
David Brownell 已提交
873 874 875
	ts->model = pdata->model ? : 7846;
	ts->vref_delay_usecs = pdata->vref_delay_usecs ? : 100;
	ts->x_plate_ohms = pdata->x_plate_ohms ? : 400;
876
	ts->pressure_max = pdata->pressure_max ? : ~0;
877 878 879 880 881 882 883 884 885 886

	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) {
887
		ts->debounce_max = pdata->debounce_max;
888 889
		if (ts->debounce_max < 2)
			ts->debounce_max = 2;
890 891
		ts->debounce_tol = pdata->debounce_tol;
		ts->debounce_rep = pdata->debounce_rep;
892 893
		ts->filter = ads7846_debounce;
		ts->filter_data = ts;
894
	} else
895
		ts->filter = ads7846_no_filter;
896
	ts->get_pendown_state = pdata->get_pendown_state;
D
David Brownell 已提交
897

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

900 901
	input_dev->name = "ADS784x Touchscreen";
	input_dev->phys = ts->phys;
902
	input_dev->dev.parent = &spi->dev;
D
David Brownell 已提交
903

904 905 906
	input_dev->evbit[0] = BIT(EV_KEY) | BIT(EV_ABS);
	input_dev->keybit[LONG(BTN_TOUCH)] = BIT(BTN_TOUCH);
	input_set_abs_params(input_dev, ABS_X,
D
David Brownell 已提交
907 908 909
			pdata->x_min ? : 0,
			pdata->x_max ? : MAX_12BIT,
			0, 0);
910
	input_set_abs_params(input_dev, ABS_Y,
D
David Brownell 已提交
911 912 913
			pdata->y_min ? : 0,
			pdata->y_max ? : MAX_12BIT,
			0, 0);
914
	input_set_abs_params(input_dev, ABS_PRESSURE,
D
David Brownell 已提交
915 916
			pdata->pressure_min, pdata->pressure_max, 0, 0);

917 918
	vref = pdata->keep_vref_on;

D
David Brownell 已提交
919 920 921
	/* set up the transfers to read touchscreen state; this assumes we
	 * use formula #2 for pressure, not #3.
	 */
922
	m = &ts->msg[0];
D
David Brownell 已提交
923 924
	x = ts->xfer;

925 926
	spi_message_init(m);

D
David Brownell 已提交
927
	/* y- still on; turn on only y+ (and ADC) */
928
	ts->read_y = READ_Y(vref);
929
	x->tx_buf = &ts->read_y;
D
David Brownell 已提交
930
	x->len = 1;
931
	spi_message_add_tail(x, m);
932

D
David Brownell 已提交
933 934 935
	x++;
	x->rx_buf = &ts->tc.y;
	x->len = 2;
936 937
	spi_message_add_tail(x, m);

938
	m->complete = ads7846_rx_val;
939 940 941 942 943 944 945
	m->context = ts;

	m++;
	spi_message_init(m);

	/* turn y- off, x+ on, then leave in lowpower */
	x++;
946
	ts->read_x = READ_X(vref);
947 948 949 950 951 952 953 954 955
	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);

956
	m->complete = ads7846_rx_val;
957
	m->context = ts;
D
David Brownell 已提交
958 959 960

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

964
		x++;
965
		ts->read_z1 = READ_Z1(vref);
966
		x->tx_buf = &ts->read_z1;
D
David Brownell 已提交
967
		x->len = 1;
968
		spi_message_add_tail(x, m);
969

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

975
		m->complete = ads7846_rx_val;
976 977 978 979
		m->context = ts;

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

981
		x++;
982
		ts->read_z2 = READ_Z2(vref);
983
		x->tx_buf = &ts->read_z2;
D
David Brownell 已提交
984
		x->len = 1;
985
		spi_message_add_tail(x, m);
986

D
David Brownell 已提交
987 988 989
		x++;
		x->rx_buf = &ts->tc.z2;
		x->len = 2;
990
		spi_message_add_tail(x, m);
D
David Brownell 已提交
991

992
		m->complete = ads7846_rx_val;
993 994
		m->context = ts;
	}
995 996

	/* power down */
997 998 999
	m++;
	spi_message_init(m);

1000 1001 1002 1003
	x++;
	ts->pwrdown = PWRDOWN;
	x->tx_buf = &ts->pwrdown;
	x->len = 1;
1004
	spi_message_add_tail(x, m);
1005 1006 1007 1008

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

1012 1013
	m->complete = ads7846_rx;
	m->context = ts;
D
David Brownell 已提交
1014

1015 1016
	ts->last_msg = m;

1017
	if (request_irq(spi->irq, ads7846_irq, IRQF_TRIGGER_FALLING,
1018
			spi->dev.driver->name, ts)) {
1019
		dev_dbg(&spi->dev, "irq %d busy?\n", spi->irq);
1020
		err = -EBUSY;
1021
		goto err_cleanup_filter;
D
David Brownell 已提交
1022 1023
	}

1024 1025 1026 1027
	err = ads784x_hwmon_register(spi, ts);
	if (err)
		goto err_free_irq;

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

1030
	/* take a first sample, leaving nPENIRQ active and vREF off; avoid
D
David Brownell 已提交
1031 1032
	 * the touchscreen, in case it's not connected.
	 */
1033
	(void) ads7846_read12_ser(&spi->dev,
D
David Brownell 已提交
1034 1035
			  READ_12BIT_SER(vaux) | ADS_PD10_ALL_ON);

1036
	err = sysfs_create_group(&spi->dev.kobj, &ads784x_attr_group);
1037
	if (err)
1038
		goto err_remove_hwmon;
I
Imre Deak 已提交
1039

1040 1041
	err = input_register_device(input_dev);
	if (err)
1042
		goto err_remove_attr_group;
1043

D
David Brownell 已提交
1044
	return 0;
1045

1046
 err_remove_attr_group:
1047 1048 1049
	sysfs_remove_group(&spi->dev.kobj, &ads784x_attr_group);
 err_remove_hwmon:
	ads784x_hwmon_unregister(spi, ts);
1050
 err_free_irq:
1051
	free_irq(spi->irq, ts);
1052 1053 1054
 err_cleanup_filter:
	if (ts->filter_cleanup)
		ts->filter_cleanup(ts->filter_data);
1055 1056 1057 1058
 err_free_mem:
	input_free_device(input_dev);
	kfree(ts);
	return err;
D
David Brownell 已提交
1059 1060
}

1061
static int __devexit ads7846_remove(struct spi_device *spi)
D
David Brownell 已提交
1062
{
1063
	struct ads7846		*ts = dev_get_drvdata(&spi->dev);
D
David Brownell 已提交
1064

1065
	ads784x_hwmon_unregister(spi, ts);
I
Imre Deak 已提交
1066 1067
	input_unregister_device(ts->input);

1068
	ads7846_suspend(spi, PMSG_SUSPEND);
D
David Brownell 已提交
1069

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

I
Imre Deak 已提交
1072
	free_irq(ts->spi->irq, ts);
1073 1074
	/* suspend left the IRQ disabled */
	enable_irq(ts->spi->irq);
I
Imre Deak 已提交
1075

1076 1077 1078
	if (ts->filter_cleanup)
		ts->filter_cleanup(ts->filter_data);

D
David Brownell 已提交
1079 1080
	kfree(ts);

1081
	dev_dbg(&spi->dev, "unregistered touchscreen\n");
D
David Brownell 已提交
1082 1083 1084
	return 0;
}

1085 1086 1087 1088 1089 1090
static struct spi_driver ads7846_driver = {
	.driver = {
		.name	= "ads7846",
		.bus	= &spi_bus_type,
		.owner	= THIS_MODULE,
	},
D
David Brownell 已提交
1091
	.probe		= ads7846_probe,
1092
	.remove		= __devexit_p(ads7846_remove),
D
David Brownell 已提交
1093 1094 1095 1096 1097 1098 1099 1100 1101 1102 1103 1104 1105 1106 1107 1108 1109 1110 1111 1112 1113 1114 1115 1116
	.suspend	= ads7846_suspend,
	.resume		= ads7846_resume,
};

static int __init ads7846_init(void)
{
	/* grr, board-specific init should stay out of drivers!! */

#ifdef	CONFIG_ARCH_OMAP
	if (machine_is_omap_osk()) {
		/* GPIO4 = PENIRQ; GPIO6 = BUSY */
		omap_request_gpio(4);
		omap_set_gpio_direction(4, 1);
		omap_request_gpio(6);
		omap_set_gpio_direction(6, 1);
	}
	// also TI 1510 Innovator, bitbanging through FPGA
	// also Nokia 770
	// also Palm Tungsten T2
#endif

	// PXA:
	// also Dell Axim X50
	// also HP iPaq H191x/H192x/H415x/H435x
1117
	// also Intel Lubbock (additional to UCB1400; as temperature sensor)
D
David Brownell 已提交
1118 1119
	// also Sharp Zaurus C7xx, C8xx (corgi/sheperd/husky)

1120 1121
	// Atmel at91sam9261-EK uses ads7843

D
David Brownell 已提交
1122 1123
	// also various AMD Au1x00 devel boards

1124
	return spi_register_driver(&ads7846_driver);
D
David Brownell 已提交
1125 1126 1127 1128 1129
}
module_init(ads7846_init);

static void __exit ads7846_exit(void)
{
1130
	spi_unregister_driver(&ads7846_driver);
D
David Brownell 已提交
1131 1132 1133 1134 1135 1136 1137 1138 1139 1140 1141 1142 1143

#ifdef	CONFIG_ARCH_OMAP
	if (machine_is_omap_osk()) {
		omap_free_gpio(4);
		omap_free_gpio(6);
	}
#endif

}
module_exit(ads7846_exit);

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