Linux 2.6.21.1
[linux/fpc-iii.git] / drivers / input / touchscreen / ads7846.c
blob0a26e0663542bf968b517ac6b0e087ff8cf64237
1 /*
2 * ADS7846 based touchscreen and sensor driver
4 * Copyright (c) 2005 David Brownell
5 * Copyright (c) 2006 Nokia Corporation
6 * Various changes: Imre Deak <imre.deak@nokia.com>
8 * Using code from:
9 * - corgi_ts.c
10 * Copyright (C) 2004-2005 Richard Purdie
11 * - omap_ts.[hc], ads7846.h, ts_osk.c
12 * Copyright (C) 2002 MontaVista Software
13 * Copyright (C) 2004 Texas Instruments
14 * Copyright (C) 2005 Dirk Behme
16 * This program is free software; you can redistribute it and/or modify
17 * it under the terms of the GNU General Public License version 2 as
18 * published by the Free Software Foundation.
20 #include <linux/hwmon.h>
21 #include <linux/init.h>
22 #include <linux/err.h>
23 #include <linux/delay.h>
24 #include <linux/input.h>
25 #include <linux/interrupt.h>
26 #include <linux/slab.h>
27 #include <linux/spi/spi.h>
28 #include <linux/spi/ads7846.h>
29 #include <asm/irq.h>
31 #ifdef CONFIG_ARM
32 #include <asm/mach-types.h>
33 #ifdef CONFIG_ARCH_OMAP
34 #include <asm/arch/gpio.h>
35 #endif
36 #endif
40 * This code has been heavily tested on a Nokia 770, and lightly
41 * tested on other ads7846 devices (OSK/Mistral, Lubbock).
42 * Support for ads7843 and ads7845 has only been stubbed in.
44 * IRQ handling needs a workaround because of a shortcoming in handling
45 * edge triggered IRQs on some platforms like the OMAP1/2. These
46 * platforms don't handle the ARM lazy IRQ disabling properly, thus we
47 * have to maintain our own SW IRQ disabled status. This should be
48 * removed as soon as the affected platform's IRQ handling is fixed.
50 * app note sbaa036 talks in more detail about accurate sampling...
51 * that ought to help in situations like LCDs inducing noise (which
52 * can also be helped by using synch signals) and more generally.
53 * This driver tries to utilize the measures described in the app
54 * note. The strength of filtering can be set in the board-* specific
55 * files.
58 #define TS_POLL_DELAY (1 * 1000000) /* ns delay before the first sample */
59 #define TS_POLL_PERIOD (5 * 1000000) /* ns delay between samples */
61 /* this driver doesn't aim at the peak continuous sample rate */
62 #define SAMPLE_BITS (8 /*cmd*/ + 16 /*sample*/ + 2 /* before, after */)
64 struct ts_event {
65 /* For portability, we can't read 12 bit values using SPI (which
66 * would make the controller deliver them as native byteorder u16
67 * with msbs zeroed). Instead, we read them as two 8-bit values,
68 * *** WHICH NEED BYTESWAPPING *** and range adjustment.
70 u16 x;
71 u16 y;
72 u16 z1, z2;
73 int ignore;
76 struct ads7846 {
77 struct input_dev *input;
78 char phys[32];
80 struct spi_device *spi;
82 #if defined(CONFIG_HWMON) || defined(CONFIG_HWMON_MODULE)
83 struct attribute_group *attr_group;
84 struct class_device *hwmon;
85 #endif
87 u16 model;
88 u16 vref_delay_usecs;
89 u16 x_plate_ohms;
90 u16 pressure_max;
92 u8 read_x, read_y, read_z1, read_z2, pwrdown;
93 u16 dummy; /* for the pwrdown read */
94 struct ts_event tc;
96 struct spi_transfer xfer[10];
97 struct spi_message msg[5];
98 struct spi_message *last_msg;
99 int msg_idx;
100 int read_cnt;
101 int read_rep;
102 int last_read;
104 u16 debounce_max;
105 u16 debounce_tol;
106 u16 debounce_rep;
108 spinlock_t lock;
109 struct hrtimer timer;
110 unsigned pendown:1; /* P: lock */
111 unsigned pending:1; /* P: lock */
112 // FIXME remove "irq_disabled"
113 unsigned irq_disabled:1; /* P: lock */
114 unsigned disabled:1;
116 int (*filter)(void *data, int data_idx, int *val);
117 void *filter_data;
118 void (*filter_cleanup)(void *data);
119 int (*get_pendown_state)(void);
122 /* leave chip selected when we're done, for quicker re-select? */
123 #if 0
124 #define CS_CHANGE(xfer) ((xfer).cs_change = 1)
125 #else
126 #define CS_CHANGE(xfer) ((xfer).cs_change = 0)
127 #endif
129 /*--------------------------------------------------------------------------*/
131 /* The ADS7846 has touchscreen and other sensors.
132 * Earlier ads784x chips are somewhat compatible.
134 #define ADS_START (1 << 7)
135 #define ADS_A2A1A0_d_y (1 << 4) /* differential */
136 #define ADS_A2A1A0_d_z1 (3 << 4) /* differential */
137 #define ADS_A2A1A0_d_z2 (4 << 4) /* differential */
138 #define ADS_A2A1A0_d_x (5 << 4) /* differential */
139 #define ADS_A2A1A0_temp0 (0 << 4) /* non-differential */
140 #define ADS_A2A1A0_vbatt (2 << 4) /* non-differential */
141 #define ADS_A2A1A0_vaux (6 << 4) /* non-differential */
142 #define ADS_A2A1A0_temp1 (7 << 4) /* non-differential */
143 #define ADS_8_BIT (1 << 3)
144 #define ADS_12_BIT (0 << 3)
145 #define ADS_SER (1 << 2) /* non-differential */
146 #define ADS_DFR (0 << 2) /* differential */
147 #define ADS_PD10_PDOWN (0 << 0) /* lowpower mode + penirq */
148 #define ADS_PD10_ADC_ON (1 << 0) /* ADC on */
149 #define ADS_PD10_REF_ON (2 << 0) /* vREF on + penirq */
150 #define ADS_PD10_ALL_ON (3 << 0) /* ADC + vREF on */
152 #define MAX_12BIT ((1<<12)-1)
154 /* leave ADC powered up (disables penirq) between differential samples */
155 #define READ_12BIT_DFR(x, adc, vref) (ADS_START | ADS_A2A1A0_d_ ## x \
156 | ADS_12_BIT | ADS_DFR | \
157 (adc ? ADS_PD10_ADC_ON : 0) | (vref ? ADS_PD10_REF_ON : 0))
159 #define READ_Y(vref) (READ_12BIT_DFR(y, 1, vref))
160 #define READ_Z1(vref) (READ_12BIT_DFR(z1, 1, vref))
161 #define READ_Z2(vref) (READ_12BIT_DFR(z2, 1, vref))
163 #define READ_X(vref) (READ_12BIT_DFR(x, 1, vref))
164 #define PWRDOWN (READ_12BIT_DFR(y, 0, 0)) /* LAST */
166 /* single-ended samples need to first power up reference voltage;
167 * we leave both ADC and VREF powered
169 #define READ_12BIT_SER(x) (ADS_START | ADS_A2A1A0_ ## x \
170 | ADS_12_BIT | ADS_SER)
172 #define REF_ON (READ_12BIT_DFR(x, 1, 1))
173 #define REF_OFF (READ_12BIT_DFR(y, 0, 0))
175 /*--------------------------------------------------------------------------*/
178 * Non-touchscreen sensors only use single-ended conversions.
179 * The range is GND..vREF. The ads7843 and ads7835 must use external vREF;
180 * ads7846 lets that pin be unconnected, to use internal vREF.
182 static unsigned vREF_mV;
183 module_param(vREF_mV, uint, 0);
184 MODULE_PARM_DESC(vREF_mV, "external vREF voltage, in milliVolts");
186 struct ser_req {
187 u8 ref_on;
188 u8 command;
189 u8 ref_off;
190 u16 scratch;
191 __be16 sample;
192 struct spi_message msg;
193 struct spi_transfer xfer[6];
196 static void ads7846_enable(struct ads7846 *ts);
197 static void ads7846_disable(struct ads7846 *ts);
199 static int device_suspended(struct device *dev)
201 struct ads7846 *ts = dev_get_drvdata(dev);
202 return dev->power.power_state.event != PM_EVENT_ON || ts->disabled;
205 static int ads7846_read12_ser(struct device *dev, unsigned command)
207 struct spi_device *spi = to_spi_device(dev);
208 struct ads7846 *ts = dev_get_drvdata(dev);
209 struct ser_req *req = kzalloc(sizeof *req, GFP_KERNEL);
210 int status;
211 int sample;
212 int use_internal;
214 if (!req)
215 return -ENOMEM;
217 spi_message_init(&req->msg);
219 /* FIXME boards with ads7846 might use external vref instead ... */
220 use_internal = (ts->model == 7846);
222 /* maybe turn on internal vREF, and let it settle */
223 if (use_internal) {
224 req->ref_on = REF_ON;
225 req->xfer[0].tx_buf = &req->ref_on;
226 req->xfer[0].len = 1;
227 spi_message_add_tail(&req->xfer[0], &req->msg);
229 req->xfer[1].rx_buf = &req->scratch;
230 req->xfer[1].len = 2;
232 /* for 1uF, settle for 800 usec; no cap, 100 usec. */
233 req->xfer[1].delay_usecs = ts->vref_delay_usecs;
234 spi_message_add_tail(&req->xfer[1], &req->msg);
237 /* take sample */
238 req->command = (u8) command;
239 req->xfer[2].tx_buf = &req->command;
240 req->xfer[2].len = 1;
241 spi_message_add_tail(&req->xfer[2], &req->msg);
243 req->xfer[3].rx_buf = &req->sample;
244 req->xfer[3].len = 2;
245 spi_message_add_tail(&req->xfer[3], &req->msg);
247 /* REVISIT: take a few more samples, and compare ... */
249 /* maybe off internal vREF */
250 if (use_internal) {
251 req->ref_off = REF_OFF;
252 req->xfer[4].tx_buf = &req->ref_off;
253 req->xfer[4].len = 1;
254 spi_message_add_tail(&req->xfer[4], &req->msg);
256 req->xfer[5].rx_buf = &req->scratch;
257 req->xfer[5].len = 2;
258 CS_CHANGE(req->xfer[5]);
259 spi_message_add_tail(&req->xfer[5], &req->msg);
262 ts->irq_disabled = 1;
263 disable_irq(spi->irq);
264 status = spi_sync(spi, &req->msg);
265 ts->irq_disabled = 0;
266 enable_irq(spi->irq);
268 if (req->msg.status)
269 status = req->msg.status;
271 /* on-wire is a must-ignore bit, a BE12 value, then padding */
272 sample = be16_to_cpu(req->sample);
273 sample = sample >> 3;
274 sample &= 0x0fff;
276 kfree(req);
277 return status ? status : sample;
280 #if defined(CONFIG_HWMON) || defined(CONFIG_HWMON_MODULE)
282 #define SHOW(name, var, adjust) static ssize_t \
283 name ## _show(struct device *dev, struct device_attribute *attr, char *buf) \
285 struct ads7846 *ts = dev_get_drvdata(dev); \
286 ssize_t v = ads7846_read12_ser(dev, \
287 READ_12BIT_SER(var) | ADS_PD10_ALL_ON); \
288 if (v < 0) \
289 return v; \
290 return sprintf(buf, "%u\n", adjust(ts, v)); \
292 static DEVICE_ATTR(name, S_IRUGO, name ## _show, NULL);
295 /* Sysfs conventions report temperatures in millidegrees Celcius.
296 * ADS7846 could use the low-accuracy two-sample scheme, but can't do the high
297 * accuracy scheme without calibration data. For now we won't try either;
298 * userspace sees raw sensor values, and must scale/calibrate appropriately.
300 static inline unsigned null_adjust(struct ads7846 *ts, ssize_t v)
302 return v;
305 SHOW(temp0, temp0, null_adjust) /* temp1_input */
306 SHOW(temp1, temp1, null_adjust) /* temp2_input */
309 /* sysfs conventions report voltages in millivolts. We can convert voltages
310 * if we know vREF. userspace may need to scale vAUX to match the board's
311 * external resistors; we assume that vBATT only uses the internal ones.
313 static inline unsigned vaux_adjust(struct ads7846 *ts, ssize_t v)
315 unsigned retval = v;
317 /* external resistors may scale vAUX into 0..vREF */
318 retval *= vREF_mV;
319 retval = retval >> 12;
320 return retval;
323 static inline unsigned vbatt_adjust(struct ads7846 *ts, ssize_t v)
325 unsigned retval = vaux_adjust(ts, v);
327 /* ads7846 has a resistor ladder to scale this signal down */
328 if (ts->model == 7846)
329 retval *= 4;
330 return retval;
333 SHOW(in0_input, vaux, vaux_adjust)
334 SHOW(in1_input, vbatt, vbatt_adjust)
337 static struct attribute *ads7846_attributes[] = {
338 &dev_attr_temp0.attr,
339 &dev_attr_temp1.attr,
340 &dev_attr_in0_input.attr,
341 &dev_attr_in1_input.attr,
342 NULL,
345 static struct attribute_group ads7846_attr_group = {
346 .attrs = ads7846_attributes,
349 static struct attribute *ads7843_attributes[] = {
350 &dev_attr_in0_input.attr,
351 &dev_attr_in1_input.attr,
352 NULL,
355 static struct attribute_group ads7843_attr_group = {
356 .attrs = ads7843_attributes,
359 static struct attribute *ads7845_attributes[] = {
360 &dev_attr_in0_input.attr,
361 NULL,
364 static struct attribute_group ads7845_attr_group = {
365 .attrs = ads7845_attributes,
368 static int ads784x_hwmon_register(struct spi_device *spi, struct ads7846 *ts)
370 struct class_device *hwmon;
371 int err;
373 /* hwmon sensors need a reference voltage */
374 switch (ts->model) {
375 case 7846:
376 if (!vREF_mV) {
377 dev_dbg(&spi->dev, "assuming 2.5V internal vREF\n");
378 vREF_mV = 2500;
380 break;
381 case 7845:
382 case 7843:
383 if (!vREF_mV) {
384 dev_warn(&spi->dev,
385 "external vREF for ADS%d not specified\n",
386 ts->model);
387 return 0;
389 break;
392 /* different chips have different sensor groups */
393 switch (ts->model) {
394 case 7846:
395 ts->attr_group = &ads7846_attr_group;
396 break;
397 case 7845:
398 ts->attr_group = &ads7845_attr_group;
399 break;
400 case 7843:
401 ts->attr_group = &ads7843_attr_group;
402 break;
403 default:
404 dev_dbg(&spi->dev, "ADS%d not recognized\n", ts->model);
405 return 0;
408 err = sysfs_create_group(&spi->dev.kobj, ts->attr_group);
409 if (err)
410 return err;
412 hwmon = hwmon_device_register(&spi->dev);
413 if (IS_ERR(hwmon)) {
414 sysfs_remove_group(&spi->dev.kobj, ts->attr_group);
415 return PTR_ERR(hwmon);
418 ts->hwmon = hwmon;
419 return 0;
422 static void ads784x_hwmon_unregister(struct spi_device *spi,
423 struct ads7846 *ts)
425 if (ts->hwmon) {
426 sysfs_remove_group(&spi->dev.kobj, ts->attr_group);
427 hwmon_device_unregister(ts->hwmon);
431 #else
432 static inline int ads784x_hwmon_register(struct spi_device *spi,
433 struct ads7846 *ts)
435 return 0;
438 static inline void ads784x_hwmon_unregister(struct spi_device *spi,
439 struct ads7846 *ts)
442 #endif
444 static int is_pen_down(struct device *dev)
446 struct ads7846 *ts = dev_get_drvdata(dev);
448 return ts->pendown;
451 static ssize_t ads7846_pen_down_show(struct device *dev,
452 struct device_attribute *attr, char *buf)
454 return sprintf(buf, "%u\n", is_pen_down(dev));
457 static DEVICE_ATTR(pen_down, S_IRUGO, ads7846_pen_down_show, NULL);
459 static ssize_t ads7846_disable_show(struct device *dev,
460 struct device_attribute *attr, char *buf)
462 struct ads7846 *ts = dev_get_drvdata(dev);
464 return sprintf(buf, "%u\n", ts->disabled);
467 static ssize_t ads7846_disable_store(struct device *dev,
468 struct device_attribute *attr,
469 const char *buf, size_t count)
471 struct ads7846 *ts = dev_get_drvdata(dev);
472 char *endp;
473 int i;
475 i = simple_strtoul(buf, &endp, 10);
476 spin_lock_irq(&ts->lock);
478 if (i)
479 ads7846_disable(ts);
480 else
481 ads7846_enable(ts);
483 spin_unlock_irq(&ts->lock);
485 return count;
488 static DEVICE_ATTR(disable, 0664, ads7846_disable_show, ads7846_disable_store);
490 static struct attribute *ads784x_attributes[] = {
491 &dev_attr_pen_down.attr,
492 &dev_attr_disable.attr,
493 NULL,
496 static struct attribute_group ads784x_attr_group = {
497 .attrs = ads784x_attributes,
500 /*--------------------------------------------------------------------------*/
503 * PENIRQ only kicks the timer. The timer only reissues the SPI transfer,
504 * to retrieve touchscreen status.
506 * The SPI transfer completion callback does the real work. It reports
507 * touchscreen events and reactivates the timer (or IRQ) as appropriate.
510 static void ads7846_rx(void *ads)
512 struct ads7846 *ts = ads;
513 unsigned Rt;
514 u16 x, y, z1, z2;
516 /* ads7846_rx_val() did in-place conversion (including byteswap) from
517 * on-the-wire format as part of debouncing to get stable readings.
519 x = ts->tc.x;
520 y = ts->tc.y;
521 z1 = ts->tc.z1;
522 z2 = ts->tc.z2;
524 /* range filtering */
525 if (x == MAX_12BIT)
526 x = 0;
528 if (likely(x && z1)) {
529 /* compute touch pressure resistance using equation #2 */
530 Rt = z2;
531 Rt -= z1;
532 Rt *= x;
533 Rt *= ts->x_plate_ohms;
534 Rt /= z1;
535 Rt = (Rt + 2047) >> 12;
536 } else
537 Rt = 0;
539 /* Sample found inconsistent by debouncing or pressure is beyond
540 * the maximum. Don't report it to user space, repeat at least
541 * once more the measurement
543 if (ts->tc.ignore || Rt > ts->pressure_max) {
544 #ifdef VERBOSE
545 pr_debug("%s: ignored %d pressure %d\n",
546 ts->spi->dev.bus_id, ts->tc.ignore, Rt);
547 #endif
548 hrtimer_start(&ts->timer, ktime_set(0, TS_POLL_PERIOD),
549 HRTIMER_MODE_REL);
550 return;
553 /* NOTE: We can't rely on the pressure to determine the pen down
554 * state, even this controller has a pressure sensor. The pressure
555 * value can fluctuate for quite a while after lifting the pen and
556 * in some cases may not even settle at the expected value.
558 * The only safe way to check for the pen up condition is in the
559 * timer by reading the pen signal state (it's a GPIO _and_ IRQ).
561 if (Rt) {
562 struct input_dev *input = ts->input;
564 if (!ts->pendown) {
565 input_report_key(input, BTN_TOUCH, 1);
566 ts->pendown = 1;
567 #ifdef VERBOSE
568 dev_dbg(&ts->spi->dev, "DOWN\n");
569 #endif
571 input_report_abs(input, ABS_X, x);
572 input_report_abs(input, ABS_Y, y);
573 input_report_abs(input, ABS_PRESSURE, Rt);
575 input_sync(input);
576 #ifdef VERBOSE
577 dev_dbg(&ts->spi->dev, "%4d/%4d/%4d\n", x, y, Rt);
578 #endif
581 hrtimer_start(&ts->timer, ktime_set(0, TS_POLL_PERIOD),
582 HRTIMER_MODE_REL);
585 static int ads7846_debounce(void *ads, int data_idx, int *val)
587 struct ads7846 *ts = ads;
589 if (!ts->read_cnt || (abs(ts->last_read - *val) > ts->debounce_tol)) {
590 /* Start over collecting consistent readings. */
591 ts->read_rep = 0;
592 /* Repeat it, if this was the first read or the read
593 * wasn't consistent enough. */
594 if (ts->read_cnt < ts->debounce_max) {
595 ts->last_read = *val;
596 ts->read_cnt++;
597 return ADS7846_FILTER_REPEAT;
598 } else {
599 /* Maximum number of debouncing reached and still
600 * not enough number of consistent readings. Abort
601 * the whole sample, repeat it in the next sampling
602 * period.
604 ts->read_cnt = 0;
605 return ADS7846_FILTER_IGNORE;
607 } else {
608 if (++ts->read_rep > ts->debounce_rep) {
609 /* Got a good reading for this coordinate,
610 * go for the next one. */
611 ts->read_cnt = 0;
612 ts->read_rep = 0;
613 return ADS7846_FILTER_OK;
614 } else {
615 /* Read more values that are consistent. */
616 ts->read_cnt++;
617 return ADS7846_FILTER_REPEAT;
622 static int ads7846_no_filter(void *ads, int data_idx, int *val)
624 return ADS7846_FILTER_OK;
627 static void ads7846_rx_val(void *ads)
629 struct ads7846 *ts = ads;
630 struct spi_message *m;
631 struct spi_transfer *t;
632 u16 *rx_val;
633 int val;
634 int action;
635 int status;
637 m = &ts->msg[ts->msg_idx];
638 t = list_entry(m->transfers.prev, struct spi_transfer, transfer_list);
639 rx_val = t->rx_buf;
641 /* adjust: on-wire is a must-ignore bit, a BE12 value, then padding;
642 * built from two 8 bit values written msb-first.
644 val = be16_to_cpu(*rx_val) >> 3;
646 action = ts->filter(ts->filter_data, ts->msg_idx, &val);
647 switch (action) {
648 case ADS7846_FILTER_REPEAT:
649 break;
650 case ADS7846_FILTER_IGNORE:
651 ts->tc.ignore = 1;
652 /* Last message will contain ads7846_rx() as the
653 * completion function.
655 m = ts->last_msg;
656 break;
657 case ADS7846_FILTER_OK:
658 *rx_val = val;
659 ts->tc.ignore = 0;
660 m = &ts->msg[++ts->msg_idx];
661 break;
662 default:
663 BUG();
665 status = spi_async(ts->spi, m);
666 if (status)
667 dev_err(&ts->spi->dev, "spi_async --> %d\n",
668 status);
671 static enum hrtimer_restart ads7846_timer(struct hrtimer *handle)
673 struct ads7846 *ts = container_of(handle, struct ads7846, timer);
674 int status = 0;
676 spin_lock_irq(&ts->lock);
678 if (unlikely(!ts->get_pendown_state() ||
679 device_suspended(&ts->spi->dev))) {
680 if (ts->pendown) {
681 struct input_dev *input = ts->input;
683 input_report_key(input, BTN_TOUCH, 0);
684 input_report_abs(input, ABS_PRESSURE, 0);
685 input_sync(input);
687 ts->pendown = 0;
688 #ifdef VERBOSE
689 dev_dbg(&ts->spi->dev, "UP\n");
690 #endif
693 /* measurement cycle ended */
694 if (!device_suspended(&ts->spi->dev)) {
695 ts->irq_disabled = 0;
696 enable_irq(ts->spi->irq);
698 ts->pending = 0;
699 } else {
700 /* pen is still down, continue with the measurement */
701 ts->msg_idx = 0;
702 status = spi_async(ts->spi, &ts->msg[0]);
703 if (status)
704 dev_err(&ts->spi->dev, "spi_async --> %d\n", status);
707 spin_unlock_irq(&ts->lock);
708 return HRTIMER_NORESTART;
711 static irqreturn_t ads7846_irq(int irq, void *handle)
713 struct ads7846 *ts = handle;
714 unsigned long flags;
716 spin_lock_irqsave(&ts->lock, flags);
717 if (likely(ts->get_pendown_state())) {
718 if (!ts->irq_disabled) {
719 /* The ARM do_simple_IRQ() dispatcher doesn't act
720 * like the other dispatchers: it will report IRQs
721 * even after they've been disabled. We work around
722 * that here. (The "generic irq" framework may help...)
724 ts->irq_disabled = 1;
725 disable_irq(ts->spi->irq);
726 ts->pending = 1;
727 hrtimer_start(&ts->timer, ktime_set(0, TS_POLL_DELAY),
728 HRTIMER_MODE_REL);
731 spin_unlock_irqrestore(&ts->lock, flags);
733 return IRQ_HANDLED;
736 /*--------------------------------------------------------------------------*/
738 /* Must be called with ts->lock held */
739 static void ads7846_disable(struct ads7846 *ts)
741 if (ts->disabled)
742 return;
744 ts->disabled = 1;
746 /* are we waiting for IRQ, or polling? */
747 if (!ts->pending) {
748 ts->irq_disabled = 1;
749 disable_irq(ts->spi->irq);
750 } else {
751 /* the timer will run at least once more, and
752 * leave everything in a clean state, IRQ disabled
754 while (ts->pending) {
755 spin_unlock_irq(&ts->lock);
756 msleep(1);
757 spin_lock_irq(&ts->lock);
761 /* we know the chip's in lowpower mode since we always
762 * leave it that way after every request
767 /* Must be called with ts->lock held */
768 static void ads7846_enable(struct ads7846 *ts)
770 if (!ts->disabled)
771 return;
773 ts->disabled = 0;
774 ts->irq_disabled = 0;
775 enable_irq(ts->spi->irq);
778 static int ads7846_suspend(struct spi_device *spi, pm_message_t message)
780 struct ads7846 *ts = dev_get_drvdata(&spi->dev);
782 spin_lock_irq(&ts->lock);
784 spi->dev.power.power_state = message;
785 ads7846_disable(ts);
787 spin_unlock_irq(&ts->lock);
789 return 0;
793 static int ads7846_resume(struct spi_device *spi)
795 struct ads7846 *ts = dev_get_drvdata(&spi->dev);
797 spin_lock_irq(&ts->lock);
799 spi->dev.power.power_state = PMSG_ON;
800 ads7846_enable(ts);
802 spin_unlock_irq(&ts->lock);
804 return 0;
807 static int __devinit ads7846_probe(struct spi_device *spi)
809 struct ads7846 *ts;
810 struct input_dev *input_dev;
811 struct ads7846_platform_data *pdata = spi->dev.platform_data;
812 struct spi_message *m;
813 struct spi_transfer *x;
814 int vref;
815 int err;
817 if (!spi->irq) {
818 dev_dbg(&spi->dev, "no IRQ?\n");
819 return -ENODEV;
822 if (!pdata) {
823 dev_dbg(&spi->dev, "no platform data?\n");
824 return -ENODEV;
827 /* don't exceed max specified sample rate */
828 if (spi->max_speed_hz > (125000 * SAMPLE_BITS)) {
829 dev_dbg(&spi->dev, "f(sample) %d KHz?\n",
830 (spi->max_speed_hz/SAMPLE_BITS)/1000);
831 return -EINVAL;
834 /* REVISIT when the irq can be triggered active-low, or if for some
835 * reason the touchscreen isn't hooked up, we don't need to access
836 * the pendown state.
838 if (pdata->get_pendown_state == NULL) {
839 dev_dbg(&spi->dev, "no get_pendown_state function?\n");
840 return -EINVAL;
843 /* We'd set TX wordsize 8 bits and RX wordsize to 13 bits ... except
844 * that even if the hardware can do that, the SPI controller driver
845 * may not. So we stick to very-portable 8 bit words, both RX and TX.
847 spi->bits_per_word = 8;
848 spi->mode = SPI_MODE_1;
849 err = spi_setup(spi);
850 if (err < 0)
851 return err;
853 ts = kzalloc(sizeof(struct ads7846), GFP_KERNEL);
854 input_dev = input_allocate_device();
855 if (!ts || !input_dev) {
856 err = -ENOMEM;
857 goto err_free_mem;
860 dev_set_drvdata(&spi->dev, ts);
861 spi->dev.power.power_state = PMSG_ON;
863 ts->spi = spi;
864 ts->input = input_dev;
866 hrtimer_init(&ts->timer, CLOCK_MONOTONIC, HRTIMER_MODE_REL);
867 ts->timer.function = ads7846_timer;
869 spin_lock_init(&ts->lock);
871 ts->model = pdata->model ? : 7846;
872 ts->vref_delay_usecs = pdata->vref_delay_usecs ? : 100;
873 ts->x_plate_ohms = pdata->x_plate_ohms ? : 400;
874 ts->pressure_max = pdata->pressure_max ? : ~0;
876 if (pdata->filter != NULL) {
877 if (pdata->filter_init != NULL) {
878 err = pdata->filter_init(pdata, &ts->filter_data);
879 if (err < 0)
880 goto err_free_mem;
882 ts->filter = pdata->filter;
883 ts->filter_cleanup = pdata->filter_cleanup;
884 } else if (pdata->debounce_max) {
885 ts->debounce_max = pdata->debounce_max;
886 if (ts->debounce_max < 2)
887 ts->debounce_max = 2;
888 ts->debounce_tol = pdata->debounce_tol;
889 ts->debounce_rep = pdata->debounce_rep;
890 ts->filter = ads7846_debounce;
891 ts->filter_data = ts;
892 } else
893 ts->filter = ads7846_no_filter;
894 ts->get_pendown_state = pdata->get_pendown_state;
896 snprintf(ts->phys, sizeof(ts->phys), "%s/input0", spi->dev.bus_id);
898 input_dev->name = "ADS784x Touchscreen";
899 input_dev->phys = ts->phys;
900 input_dev->cdev.dev = &spi->dev;
902 input_dev->evbit[0] = BIT(EV_KEY) | BIT(EV_ABS);
903 input_dev->keybit[LONG(BTN_TOUCH)] = BIT(BTN_TOUCH);
904 input_set_abs_params(input_dev, ABS_X,
905 pdata->x_min ? : 0,
906 pdata->x_max ? : MAX_12BIT,
907 0, 0);
908 input_set_abs_params(input_dev, ABS_Y,
909 pdata->y_min ? : 0,
910 pdata->y_max ? : MAX_12BIT,
911 0, 0);
912 input_set_abs_params(input_dev, ABS_PRESSURE,
913 pdata->pressure_min, pdata->pressure_max, 0, 0);
915 vref = pdata->keep_vref_on;
917 /* set up the transfers to read touchscreen state; this assumes we
918 * use formula #2 for pressure, not #3.
920 m = &ts->msg[0];
921 x = ts->xfer;
923 spi_message_init(m);
925 /* y- still on; turn on only y+ (and ADC) */
926 ts->read_y = READ_Y(vref);
927 x->tx_buf = &ts->read_y;
928 x->len = 1;
929 spi_message_add_tail(x, m);
931 x++;
932 x->rx_buf = &ts->tc.y;
933 x->len = 2;
934 spi_message_add_tail(x, m);
936 m->complete = ads7846_rx_val;
937 m->context = ts;
939 m++;
940 spi_message_init(m);
942 /* turn y- off, x+ on, then leave in lowpower */
943 x++;
944 ts->read_x = READ_X(vref);
945 x->tx_buf = &ts->read_x;
946 x->len = 1;
947 spi_message_add_tail(x, m);
949 x++;
950 x->rx_buf = &ts->tc.x;
951 x->len = 2;
952 spi_message_add_tail(x, m);
954 m->complete = ads7846_rx_val;
955 m->context = ts;
957 /* turn y+ off, x- on; we'll use formula #2 */
958 if (ts->model == 7846) {
959 m++;
960 spi_message_init(m);
962 x++;
963 ts->read_z1 = READ_Z1(vref);
964 x->tx_buf = &ts->read_z1;
965 x->len = 1;
966 spi_message_add_tail(x, m);
968 x++;
969 x->rx_buf = &ts->tc.z1;
970 x->len = 2;
971 spi_message_add_tail(x, m);
973 m->complete = ads7846_rx_val;
974 m->context = ts;
976 m++;
977 spi_message_init(m);
979 x++;
980 ts->read_z2 = READ_Z2(vref);
981 x->tx_buf = &ts->read_z2;
982 x->len = 1;
983 spi_message_add_tail(x, m);
985 x++;
986 x->rx_buf = &ts->tc.z2;
987 x->len = 2;
988 spi_message_add_tail(x, m);
990 m->complete = ads7846_rx_val;
991 m->context = ts;
994 /* power down */
995 m++;
996 spi_message_init(m);
998 x++;
999 ts->pwrdown = PWRDOWN;
1000 x->tx_buf = &ts->pwrdown;
1001 x->len = 1;
1002 spi_message_add_tail(x, m);
1004 x++;
1005 x->rx_buf = &ts->dummy;
1006 x->len = 2;
1007 CS_CHANGE(*x);
1008 spi_message_add_tail(x, m);
1010 m->complete = ads7846_rx;
1011 m->context = ts;
1013 ts->last_msg = m;
1015 if (request_irq(spi->irq, ads7846_irq, IRQF_TRIGGER_FALLING,
1016 spi->dev.driver->name, ts)) {
1017 dev_dbg(&spi->dev, "irq %d busy?\n", spi->irq);
1018 err = -EBUSY;
1019 goto err_cleanup_filter;
1022 err = ads784x_hwmon_register(spi, ts);
1023 if (err)
1024 goto err_free_irq;
1026 dev_info(&spi->dev, "touchscreen, irq %d\n", spi->irq);
1028 /* take a first sample, leaving nPENIRQ active and vREF off; avoid
1029 * the touchscreen, in case it's not connected.
1031 (void) ads7846_read12_ser(&spi->dev,
1032 READ_12BIT_SER(vaux) | ADS_PD10_ALL_ON);
1034 err = sysfs_create_group(&spi->dev.kobj, &ads784x_attr_group);
1035 if (err)
1036 goto err_remove_hwmon;
1038 err = input_register_device(input_dev);
1039 if (err)
1040 goto err_remove_attr_group;
1042 return 0;
1044 err_remove_attr_group:
1045 sysfs_remove_group(&spi->dev.kobj, &ads784x_attr_group);
1046 err_remove_hwmon:
1047 ads784x_hwmon_unregister(spi, ts);
1048 err_free_irq:
1049 free_irq(spi->irq, ts);
1050 err_cleanup_filter:
1051 if (ts->filter_cleanup)
1052 ts->filter_cleanup(ts->filter_data);
1053 err_free_mem:
1054 input_free_device(input_dev);
1055 kfree(ts);
1056 return err;
1059 static int __devexit ads7846_remove(struct spi_device *spi)
1061 struct ads7846 *ts = dev_get_drvdata(&spi->dev);
1063 ads784x_hwmon_unregister(spi, ts);
1064 input_unregister_device(ts->input);
1066 ads7846_suspend(spi, PMSG_SUSPEND);
1068 sysfs_remove_group(&spi->dev.kobj, &ads784x_attr_group);
1070 free_irq(ts->spi->irq, ts);
1071 /* suspend left the IRQ disabled */
1072 enable_irq(ts->spi->irq);
1074 if (ts->filter_cleanup)
1075 ts->filter_cleanup(ts->filter_data);
1077 kfree(ts);
1079 dev_dbg(&spi->dev, "unregistered touchscreen\n");
1080 return 0;
1083 static struct spi_driver ads7846_driver = {
1084 .driver = {
1085 .name = "ads7846",
1086 .bus = &spi_bus_type,
1087 .owner = THIS_MODULE,
1089 .probe = ads7846_probe,
1090 .remove = __devexit_p(ads7846_remove),
1091 .suspend = ads7846_suspend,
1092 .resume = ads7846_resume,
1095 static int __init ads7846_init(void)
1097 /* grr, board-specific init should stay out of drivers!! */
1099 #ifdef CONFIG_ARCH_OMAP
1100 if (machine_is_omap_osk()) {
1101 /* GPIO4 = PENIRQ; GPIO6 = BUSY */
1102 omap_request_gpio(4);
1103 omap_set_gpio_direction(4, 1);
1104 omap_request_gpio(6);
1105 omap_set_gpio_direction(6, 1);
1107 // also TI 1510 Innovator, bitbanging through FPGA
1108 // also Nokia 770
1109 // also Palm Tungsten T2
1110 #endif
1112 // PXA:
1113 // also Dell Axim X50
1114 // also HP iPaq H191x/H192x/H415x/H435x
1115 // also Intel Lubbock (additional to UCB1400; as temperature sensor)
1116 // also Sharp Zaurus C7xx, C8xx (corgi/sheperd/husky)
1118 // Atmel at91sam9261-EK uses ads7843
1120 // also various AMD Au1x00 devel boards
1122 return spi_register_driver(&ads7846_driver);
1124 module_init(ads7846_init);
1126 static void __exit ads7846_exit(void)
1128 spi_unregister_driver(&ads7846_driver);
1130 #ifdef CONFIG_ARCH_OMAP
1131 if (machine_is_omap_osk()) {
1132 omap_free_gpio(4);
1133 omap_free_gpio(6);
1135 #endif
1138 module_exit(ads7846_exit);
1140 MODULE_DESCRIPTION("ADS7846 TouchScreen Driver");
1141 MODULE_LICENSE("GPL");