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>
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/types.h>
21 #include <linux/hwmon.h>
22 #include <linux/init.h>
23 #include <linux/err.h>
24 #include <linux/sched.h>
25 #include <linux/delay.h>
26 #include <linux/input.h>
27 #include <linux/interrupt.h>
28 #include <linux/slab.h>
29 #include <linux/gpio.h>
30 #include <linux/spi/spi.h>
31 #include <linux/spi/ads7846.h>
32 #include <linux/regulator/consumer.h>
36 * This code has been heavily tested on a Nokia 770, and lightly
37 * tested on other ads7846 devices (OSK/Mistral, Lubbock, Spitz).
38 * TSC2046 is just newer ads7846 silicon.
39 * Support for ads7843 tested on Atmel at91sam926x-EK.
40 * Support for ads7845 has only been stubbed in.
41 * Support for Analog Devices AD7873 and AD7843 tested.
43 * IRQ handling needs a workaround because of a shortcoming in handling
44 * edge triggered IRQs on some platforms like the OMAP1/2. These
45 * platforms don't handle the ARM lazy IRQ disabling properly, thus we
46 * have to maintain our own SW IRQ disabled status. This should be
47 * removed as soon as the affected platform's IRQ handling is fixed.
49 * App note sbaa036 talks in more detail about accurate sampling...
50 * that ought to help in situations like LCDs inducing noise (which
51 * can also be helped by using synch signals) and more generally.
52 * This driver tries to utilize the measures described in the app
53 * note. The strength of filtering can be set in the board-* specific
57 #define TS_POLL_DELAY 1 /* ms delay before the first sample */
58 #define TS_POLL_PERIOD 5 /* ms delay between samples */
60 /* this driver doesn't aim at the peak continuous sample rate */
61 #define SAMPLE_BITS (8 /*cmd*/ + 16 /*sample*/ + 2 /* before, after */)
65 * For portability, we can't read 12 bit values using SPI (which
66 * would make the controller deliver them as native byte order u16
67 * with msbs zeroed). Instead, we read them as two 8-bit values,
68 * *** WHICH NEED BYTESWAPPING *** and range adjustment.
79 * We allocate this separately to avoid cache line sharing issues when
80 * driver is used with DMA-based SPI controllers (like atmel_spi) on
81 * systems where main memory is not DMA-coherent (most non-x86 boards).
83 struct ads7846_packet
{
84 u8 read_x
, read_y
, read_z1
, read_z2
, pwrdown
;
85 u16 dummy
; /* for the pwrdown read */
87 /* for ads7845 with mpc5121 psc spi we use 3-byte buffers */
88 u8 read_x_cmd
[3], read_y_cmd
[3], pwrdown_cmd
[3];
92 struct input_dev
*input
;
96 struct spi_device
*spi
;
97 struct regulator
*reg
;
99 #if defined(CONFIG_HWMON) || defined(CONFIG_HWMON_MODULE)
100 struct attribute_group
*attr_group
;
101 struct device
*hwmon
;
106 u16 vref_delay_usecs
;
112 struct ads7846_packet
*packet
;
114 struct spi_transfer xfer
[18];
115 struct spi_message msg
[5];
117 wait_queue_head_t wait
;
129 u16 penirq_recheck_delay_usecs
;
132 bool stopped
; /* P: lock */
133 bool disabled
; /* P: lock */
134 bool suspended
; /* P: lock */
136 int (*filter
)(void *data
, int data_idx
, int *val
);
138 void (*filter_cleanup
)(void *data
);
139 int (*get_pendown_state
)(void);
142 void (*wait_for_sync
)(void);
145 /* leave chip selected when we're done, for quicker re-select? */
147 #define CS_CHANGE(xfer) ((xfer).cs_change = 1)
149 #define CS_CHANGE(xfer) ((xfer).cs_change = 0)
152 /*--------------------------------------------------------------------------*/
154 /* The ADS7846 has touchscreen and other sensors.
155 * Earlier ads784x chips are somewhat compatible.
157 #define ADS_START (1 << 7)
158 #define ADS_A2A1A0_d_y (1 << 4) /* differential */
159 #define ADS_A2A1A0_d_z1 (3 << 4) /* differential */
160 #define ADS_A2A1A0_d_z2 (4 << 4) /* differential */
161 #define ADS_A2A1A0_d_x (5 << 4) /* differential */
162 #define ADS_A2A1A0_temp0 (0 << 4) /* non-differential */
163 #define ADS_A2A1A0_vbatt (2 << 4) /* non-differential */
164 #define ADS_A2A1A0_vaux (6 << 4) /* non-differential */
165 #define ADS_A2A1A0_temp1 (7 << 4) /* non-differential */
166 #define ADS_8_BIT (1 << 3)
167 #define ADS_12_BIT (0 << 3)
168 #define ADS_SER (1 << 2) /* non-differential */
169 #define ADS_DFR (0 << 2) /* differential */
170 #define ADS_PD10_PDOWN (0 << 0) /* low power mode + penirq */
171 #define ADS_PD10_ADC_ON (1 << 0) /* ADC on */
172 #define ADS_PD10_REF_ON (2 << 0) /* vREF on + penirq */
173 #define ADS_PD10_ALL_ON (3 << 0) /* ADC + vREF on */
175 #define MAX_12BIT ((1<<12)-1)
177 /* leave ADC powered up (disables penirq) between differential samples */
178 #define READ_12BIT_DFR(x, adc, vref) (ADS_START | ADS_A2A1A0_d_ ## x \
179 | ADS_12_BIT | ADS_DFR | \
180 (adc ? ADS_PD10_ADC_ON : 0) | (vref ? ADS_PD10_REF_ON : 0))
182 #define READ_Y(vref) (READ_12BIT_DFR(y, 1, vref))
183 #define READ_Z1(vref) (READ_12BIT_DFR(z1, 1, vref))
184 #define READ_Z2(vref) (READ_12BIT_DFR(z2, 1, vref))
186 #define READ_X(vref) (READ_12BIT_DFR(x, 1, vref))
187 #define PWRDOWN (READ_12BIT_DFR(y, 0, 0)) /* LAST */
189 /* single-ended samples need to first power up reference voltage;
190 * we leave both ADC and VREF powered
192 #define READ_12BIT_SER(x) (ADS_START | ADS_A2A1A0_ ## x \
193 | ADS_12_BIT | ADS_SER)
195 #define REF_ON (READ_12BIT_DFR(x, 1, 1))
196 #define REF_OFF (READ_12BIT_DFR(y, 0, 0))
198 /* Must be called with ts->lock held */
199 static void ads7846_stop(struct ads7846
*ts
)
201 if (!ts
->disabled
&& !ts
->suspended
) {
202 /* Signal IRQ thread to stop polling and disable the handler. */
206 disable_irq(ts
->spi
->irq
);
210 /* Must be called with ts->lock held */
211 static void ads7846_restart(struct ads7846
*ts
)
213 if (!ts
->disabled
&& !ts
->suspended
) {
214 /* Tell IRQ thread that it may poll the device. */
217 enable_irq(ts
->spi
->irq
);
221 /* Must be called with ts->lock held */
222 static void __ads7846_disable(struct ads7846
*ts
)
225 regulator_disable(ts
->reg
);
228 * We know the chip's in low power mode since we always
229 * leave it that way after every request
233 /* Must be called with ts->lock held */
234 static void __ads7846_enable(struct ads7846
*ts
)
236 regulator_enable(ts
->reg
);
240 static void ads7846_disable(struct ads7846
*ts
)
242 mutex_lock(&ts
->lock
);
247 __ads7846_disable(ts
);
252 mutex_unlock(&ts
->lock
);
255 static void ads7846_enable(struct ads7846
*ts
)
257 mutex_lock(&ts
->lock
);
261 ts
->disabled
= false;
264 __ads7846_enable(ts
);
267 mutex_unlock(&ts
->lock
);
270 /*--------------------------------------------------------------------------*/
273 * Non-touchscreen sensors only use single-ended conversions.
274 * The range is GND..vREF. The ads7843 and ads7835 must use external vREF;
275 * ads7846 lets that pin be unconnected, to use internal vREF.
284 struct spi_message msg
;
285 struct spi_transfer xfer
[6];
288 struct ads7845_ser_req
{
292 struct spi_message msg
;
293 struct spi_transfer xfer
[2];
296 static int ads7846_read12_ser(struct device
*dev
, unsigned command
)
298 struct spi_device
*spi
= to_spi_device(dev
);
299 struct ads7846
*ts
= dev_get_drvdata(dev
);
304 req
= kzalloc(sizeof *req
, GFP_KERNEL
);
308 spi_message_init(&req
->msg
);
310 /* FIXME boards with ads7846 might use external vref instead ... */
311 use_internal
= (ts
->model
== 7846);
313 /* maybe turn on internal vREF, and let it settle */
315 req
->ref_on
= REF_ON
;
316 req
->xfer
[0].tx_buf
= &req
->ref_on
;
317 req
->xfer
[0].len
= 1;
318 spi_message_add_tail(&req
->xfer
[0], &req
->msg
);
320 req
->xfer
[1].rx_buf
= &req
->scratch
;
321 req
->xfer
[1].len
= 2;
323 /* for 1uF, settle for 800 usec; no cap, 100 usec. */
324 req
->xfer
[1].delay_usecs
= ts
->vref_delay_usecs
;
325 spi_message_add_tail(&req
->xfer
[1], &req
->msg
);
329 req
->command
= (u8
) command
;
330 req
->xfer
[2].tx_buf
= &req
->command
;
331 req
->xfer
[2].len
= 1;
332 spi_message_add_tail(&req
->xfer
[2], &req
->msg
);
334 req
->xfer
[3].rx_buf
= &req
->sample
;
335 req
->xfer
[3].len
= 2;
336 spi_message_add_tail(&req
->xfer
[3], &req
->msg
);
338 /* REVISIT: take a few more samples, and compare ... */
340 /* converter in low power mode & enable PENIRQ */
341 req
->ref_off
= PWRDOWN
;
342 req
->xfer
[4].tx_buf
= &req
->ref_off
;
343 req
->xfer
[4].len
= 1;
344 spi_message_add_tail(&req
->xfer
[4], &req
->msg
);
346 req
->xfer
[5].rx_buf
= &req
->scratch
;
347 req
->xfer
[5].len
= 2;
348 CS_CHANGE(req
->xfer
[5]);
349 spi_message_add_tail(&req
->xfer
[5], &req
->msg
);
351 mutex_lock(&ts
->lock
);
353 status
= spi_sync(spi
, &req
->msg
);
355 mutex_unlock(&ts
->lock
);
358 /* on-wire is a must-ignore bit, a BE12 value, then padding */
359 status
= be16_to_cpu(req
->sample
);
360 status
= status
>> 3;
368 static int ads7845_read12_ser(struct device
*dev
, unsigned command
)
370 struct spi_device
*spi
= to_spi_device(dev
);
371 struct ads7846
*ts
= dev_get_drvdata(dev
);
372 struct ads7845_ser_req
*req
;
375 req
= kzalloc(sizeof *req
, GFP_KERNEL
);
379 spi_message_init(&req
->msg
);
381 req
->command
[0] = (u8
) command
;
382 req
->xfer
[0].tx_buf
= req
->command
;
383 req
->xfer
[0].rx_buf
= req
->sample
;
384 req
->xfer
[0].len
= 3;
385 spi_message_add_tail(&req
->xfer
[0], &req
->msg
);
387 mutex_lock(&ts
->lock
);
389 status
= spi_sync(spi
, &req
->msg
);
391 mutex_unlock(&ts
->lock
);
394 /* BE12 value, then padding */
395 status
= be16_to_cpu(*((u16
*)&req
->sample
[1]));
396 status
= status
>> 3;
404 #if defined(CONFIG_HWMON) || defined(CONFIG_HWMON_MODULE)
406 #define SHOW(name, var, adjust) static ssize_t \
407 name ## _show(struct device *dev, struct device_attribute *attr, char *buf) \
409 struct ads7846 *ts = dev_get_drvdata(dev); \
410 ssize_t v = ads7846_read12_ser(dev, \
411 READ_12BIT_SER(var) | ADS_PD10_ALL_ON); \
414 return sprintf(buf, "%u\n", adjust(ts, v)); \
416 static DEVICE_ATTR(name, S_IRUGO, name ## _show, NULL);
419 /* Sysfs conventions report temperatures in millidegrees Celsius.
420 * ADS7846 could use the low-accuracy two-sample scheme, but can't do the high
421 * accuracy scheme without calibration data. For now we won't try either;
422 * userspace sees raw sensor values, and must scale/calibrate appropriately.
424 static inline unsigned null_adjust(struct ads7846
*ts
, ssize_t v
)
429 SHOW(temp0
, temp0
, null_adjust
) /* temp1_input */
430 SHOW(temp1
, temp1
, null_adjust
) /* temp2_input */
433 /* sysfs conventions report voltages in millivolts. We can convert voltages
434 * if we know vREF. userspace may need to scale vAUX to match the board's
435 * external resistors; we assume that vBATT only uses the internal ones.
437 static inline unsigned vaux_adjust(struct ads7846
*ts
, ssize_t v
)
441 /* external resistors may scale vAUX into 0..vREF */
442 retval
*= ts
->vref_mv
;
443 retval
= retval
>> 12;
448 static inline unsigned vbatt_adjust(struct ads7846
*ts
, ssize_t v
)
450 unsigned retval
= vaux_adjust(ts
, v
);
452 /* ads7846 has a resistor ladder to scale this signal down */
453 if (ts
->model
== 7846)
459 SHOW(in0_input
, vaux
, vaux_adjust
)
460 SHOW(in1_input
, vbatt
, vbatt_adjust
)
462 static struct attribute
*ads7846_attributes
[] = {
463 &dev_attr_temp0
.attr
,
464 &dev_attr_temp1
.attr
,
465 &dev_attr_in0_input
.attr
,
466 &dev_attr_in1_input
.attr
,
470 static struct attribute_group ads7846_attr_group
= {
471 .attrs
= ads7846_attributes
,
474 static struct attribute
*ads7843_attributes
[] = {
475 &dev_attr_in0_input
.attr
,
476 &dev_attr_in1_input
.attr
,
480 static struct attribute_group ads7843_attr_group
= {
481 .attrs
= ads7843_attributes
,
484 static struct attribute
*ads7845_attributes
[] = {
485 &dev_attr_in0_input
.attr
,
489 static struct attribute_group ads7845_attr_group
= {
490 .attrs
= ads7845_attributes
,
493 static int ads784x_hwmon_register(struct spi_device
*spi
, struct ads7846
*ts
)
495 struct device
*hwmon
;
498 /* hwmon sensors need a reference voltage */
502 dev_dbg(&spi
->dev
, "assuming 2.5V internal vREF\n");
510 "external vREF for ADS%d not specified\n",
517 /* different chips have different sensor groups */
520 ts
->attr_group
= &ads7846_attr_group
;
523 ts
->attr_group
= &ads7845_attr_group
;
526 ts
->attr_group
= &ads7843_attr_group
;
529 dev_dbg(&spi
->dev
, "ADS%d not recognized\n", ts
->model
);
533 err
= sysfs_create_group(&spi
->dev
.kobj
, ts
->attr_group
);
537 hwmon
= hwmon_device_register(&spi
->dev
);
539 sysfs_remove_group(&spi
->dev
.kobj
, ts
->attr_group
);
540 return PTR_ERR(hwmon
);
547 static void ads784x_hwmon_unregister(struct spi_device
*spi
,
551 sysfs_remove_group(&spi
->dev
.kobj
, ts
->attr_group
);
552 hwmon_device_unregister(ts
->hwmon
);
557 static inline int ads784x_hwmon_register(struct spi_device
*spi
,
563 static inline void ads784x_hwmon_unregister(struct spi_device
*spi
,
569 static ssize_t
ads7846_pen_down_show(struct device
*dev
,
570 struct device_attribute
*attr
, char *buf
)
572 struct ads7846
*ts
= dev_get_drvdata(dev
);
574 return sprintf(buf
, "%u\n", ts
->pendown
);
577 static DEVICE_ATTR(pen_down
, S_IRUGO
, ads7846_pen_down_show
, NULL
);
579 static ssize_t
ads7846_disable_show(struct device
*dev
,
580 struct device_attribute
*attr
, char *buf
)
582 struct ads7846
*ts
= dev_get_drvdata(dev
);
584 return sprintf(buf
, "%u\n", ts
->disabled
);
587 static ssize_t
ads7846_disable_store(struct device
*dev
,
588 struct device_attribute
*attr
,
589 const char *buf
, size_t count
)
591 struct ads7846
*ts
= dev_get_drvdata(dev
);
594 if (strict_strtoul(buf
, 10, &i
))
605 static DEVICE_ATTR(disable
, 0664, ads7846_disable_show
, ads7846_disable_store
);
607 static struct attribute
*ads784x_attributes
[] = {
608 &dev_attr_pen_down
.attr
,
609 &dev_attr_disable
.attr
,
613 static struct attribute_group ads784x_attr_group
= {
614 .attrs
= ads784x_attributes
,
617 /*--------------------------------------------------------------------------*/
619 static int get_pendown_state(struct ads7846
*ts
)
621 if (ts
->get_pendown_state
)
622 return ts
->get_pendown_state();
624 return !gpio_get_value(ts
->gpio_pendown
);
627 static void null_wait_for_sync(void)
631 static int ads7846_debounce_filter(void *ads
, int data_idx
, int *val
)
633 struct ads7846
*ts
= ads
;
635 if (!ts
->read_cnt
|| (abs(ts
->last_read
- *val
) > ts
->debounce_tol
)) {
636 /* Start over collecting consistent readings. */
639 * Repeat it, if this was the first read or the read
640 * wasn't consistent enough.
642 if (ts
->read_cnt
< ts
->debounce_max
) {
643 ts
->last_read
= *val
;
645 return ADS7846_FILTER_REPEAT
;
648 * Maximum number of debouncing reached and still
649 * not enough number of consistent readings. Abort
650 * the whole sample, repeat it in the next sampling
654 return ADS7846_FILTER_IGNORE
;
657 if (++ts
->read_rep
> ts
->debounce_rep
) {
659 * Got a good reading for this coordinate,
660 * go for the next one.
664 return ADS7846_FILTER_OK
;
666 /* Read more values that are consistent. */
668 return ADS7846_FILTER_REPEAT
;
673 static int ads7846_no_filter(void *ads
, int data_idx
, int *val
)
675 return ADS7846_FILTER_OK
;
678 static int ads7846_get_value(struct ads7846
*ts
, struct spi_message
*m
)
680 struct spi_transfer
*t
=
681 list_entry(m
->transfers
.prev
, struct spi_transfer
, transfer_list
);
683 if (ts
->model
== 7845) {
684 return be16_to_cpup((__be16
*)&(((char*)t
->rx_buf
)[1])) >> 3;
687 * adjust: on-wire is a must-ignore bit, a BE12 value, then
688 * padding; built from two 8 bit values written msb-first.
690 return be16_to_cpup((__be16
*)t
->rx_buf
) >> 3;
694 static void ads7846_update_value(struct spi_message
*m
, int val
)
696 struct spi_transfer
*t
=
697 list_entry(m
->transfers
.prev
, struct spi_transfer
, transfer_list
);
699 *(u16
*)t
->rx_buf
= val
;
702 static void ads7846_read_state(struct ads7846
*ts
)
704 struct ads7846_packet
*packet
= ts
->packet
;
705 struct spi_message
*m
;
711 while (msg_idx
< ts
->msg_count
) {
715 m
= &ts
->msg
[msg_idx
];
716 error
= spi_sync(ts
->spi
, m
);
718 dev_err(&ts
->spi
->dev
, "spi_async --> %d\n", error
);
719 packet
->tc
.ignore
= true;
724 * Last message is power down request, no need to convert
725 * or filter the value.
727 if (msg_idx
< ts
->msg_count
- 1) {
729 val
= ads7846_get_value(ts
, m
);
731 action
= ts
->filter(ts
->filter_data
, msg_idx
, &val
);
733 case ADS7846_FILTER_REPEAT
:
736 case ADS7846_FILTER_IGNORE
:
737 packet
->tc
.ignore
= true;
738 msg_idx
= ts
->msg_count
- 1;
741 case ADS7846_FILTER_OK
:
742 ads7846_update_value(m
, val
);
743 packet
->tc
.ignore
= false;
756 static void ads7846_report_state(struct ads7846
*ts
)
758 struct ads7846_packet
*packet
= ts
->packet
;
763 * ads7846_get_value() does in-place conversion (including byte swap)
764 * from on-the-wire format as part of debouncing to get stable
767 if (ts
->model
== 7845) {
768 x
= *(u16
*)packet
->tc
.x_buf
;
769 y
= *(u16
*)packet
->tc
.y_buf
;
779 /* range filtering */
783 if (ts
->model
== 7843) {
784 Rt
= ts
->pressure_max
/ 2;
785 } else if (ts
->model
== 7845) {
786 if (get_pendown_state(ts
))
787 Rt
= ts
->pressure_max
/ 2;
790 dev_vdbg(&ts
->spi
->dev
, "x/y: %d/%d, PD %d\n", x
, y
, Rt
);
791 } else if (likely(x
&& z1
)) {
792 /* compute touch pressure resistance using equation #2 */
796 Rt
*= ts
->x_plate_ohms
;
798 Rt
= (Rt
+ 2047) >> 12;
804 * Sample found inconsistent by debouncing or pressure is beyond
805 * the maximum. Don't report it to user space, repeat at least
806 * once more the measurement
808 if (packet
->tc
.ignore
|| Rt
> ts
->pressure_max
) {
809 dev_vdbg(&ts
->spi
->dev
, "ignored %d pressure %d\n",
810 packet
->tc
.ignore
, Rt
);
815 * Maybe check the pendown state before reporting. This discards
816 * false readings when the pen is lifted.
818 if (ts
->penirq_recheck_delay_usecs
) {
819 udelay(ts
->penirq_recheck_delay_usecs
);
820 if (!get_pendown_state(ts
))
825 * NOTE: We can't rely on the pressure to determine the pen down
826 * state, even this controller has a pressure sensor. The pressure
827 * value can fluctuate for quite a while after lifting the pen and
828 * in some cases may not even settle at the expected value.
830 * The only safe way to check for the pen up condition is in the
831 * timer by reading the pen signal state (it's a GPIO _and_ IRQ).
834 struct input_dev
*input
= ts
->input
;
840 input_report_key(input
, BTN_TOUCH
, 1);
842 dev_vdbg(&ts
->spi
->dev
, "DOWN\n");
845 input_report_abs(input
, ABS_X
, x
);
846 input_report_abs(input
, ABS_Y
, y
);
847 input_report_abs(input
, ABS_PRESSURE
, ts
->pressure_max
- Rt
);
850 dev_vdbg(&ts
->spi
->dev
, "%4d/%4d/%4d\n", x
, y
, Rt
);
854 static irqreturn_t
ads7846_hard_irq(int irq
, void *handle
)
856 struct ads7846
*ts
= handle
;
858 return get_pendown_state(ts
) ? IRQ_WAKE_THREAD
: IRQ_HANDLED
;
862 static irqreturn_t
ads7846_irq(int irq
, void *handle
)
864 struct ads7846
*ts
= handle
;
866 /* Start with a small delay before checking pendown state */
867 msleep(TS_POLL_DELAY
);
869 while (!ts
->stopped
&& get_pendown_state(ts
)) {
871 /* pen is down, continue with the measurement */
872 ads7846_read_state(ts
);
875 ads7846_report_state(ts
);
877 wait_event_timeout(ts
->wait
, ts
->stopped
,
878 msecs_to_jiffies(TS_POLL_PERIOD
));
882 struct input_dev
*input
= ts
->input
;
884 input_report_key(input
, BTN_TOUCH
, 0);
885 input_report_abs(input
, ABS_PRESSURE
, 0);
889 dev_vdbg(&ts
->spi
->dev
, "UP\n");
895 static int ads7846_suspend(struct spi_device
*spi
, pm_message_t message
)
897 struct ads7846
*ts
= dev_get_drvdata(&spi
->dev
);
899 mutex_lock(&ts
->lock
);
901 if (!ts
->suspended
) {
904 __ads7846_disable(ts
);
906 if (device_may_wakeup(&ts
->spi
->dev
))
907 enable_irq_wake(ts
->spi
->irq
);
909 ts
->suspended
= true;
912 mutex_unlock(&ts
->lock
);
917 static int ads7846_resume(struct spi_device
*spi
)
919 struct ads7846
*ts
= dev_get_drvdata(&spi
->dev
);
921 mutex_lock(&ts
->lock
);
925 ts
->suspended
= false;
927 if (device_may_wakeup(&ts
->spi
->dev
))
928 disable_irq_wake(ts
->spi
->irq
);
931 __ads7846_enable(ts
);
934 mutex_unlock(&ts
->lock
);
939 static int __devinit
ads7846_setup_pendown(struct spi_device
*spi
, struct ads7846
*ts
)
941 struct ads7846_platform_data
*pdata
= spi
->dev
.platform_data
;
945 * REVISIT when the irq can be triggered active-low, or if for some
946 * reason the touchscreen isn't hooked up, we don't need to access
950 if (pdata
->get_pendown_state
) {
951 ts
->get_pendown_state
= pdata
->get_pendown_state
;
952 } else if (gpio_is_valid(pdata
->gpio_pendown
)) {
954 err
= gpio_request(pdata
->gpio_pendown
, "ads7846_pendown");
956 dev_err(&spi
->dev
, "failed to request pendown GPIO%d\n",
957 pdata
->gpio_pendown
);
961 ts
->gpio_pendown
= pdata
->gpio_pendown
;
964 dev_err(&spi
->dev
, "no get_pendown_state nor gpio_pendown?\n");
972 * Set up the transfers to read touchscreen state; this assumes we
973 * use formula #2 for pressure, not #3.
975 static void __devinit
ads7846_setup_spi_msg(struct ads7846
*ts
,
976 const struct ads7846_platform_data
*pdata
)
978 struct spi_message
*m
= &ts
->msg
[0];
979 struct spi_transfer
*x
= ts
->xfer
;
980 struct ads7846_packet
*packet
= ts
->packet
;
981 int vref
= pdata
->keep_vref_on
;
983 if (ts
->model
== 7873) {
985 * The AD7873 is almost identical to the ADS7846
986 * keep VREF off during differential/ratiometric
997 if (ts
->model
== 7845) {
998 packet
->read_y_cmd
[0] = READ_Y(vref
);
999 packet
->read_y_cmd
[1] = 0;
1000 packet
->read_y_cmd
[2] = 0;
1001 x
->tx_buf
= &packet
->read_y_cmd
[0];
1002 x
->rx_buf
= &packet
->tc
.y_buf
[0];
1004 spi_message_add_tail(x
, m
);
1006 /* y- still on; turn on only y+ (and ADC) */
1007 packet
->read_y
= READ_Y(vref
);
1008 x
->tx_buf
= &packet
->read_y
;
1010 spi_message_add_tail(x
, m
);
1013 x
->rx_buf
= &packet
->tc
.y
;
1015 spi_message_add_tail(x
, m
);
1019 * The first sample after switching drivers can be low quality;
1020 * optionally discard it, using a second one after the signals
1021 * have had enough time to stabilize.
1023 if (pdata
->settle_delay_usecs
) {
1024 x
->delay_usecs
= pdata
->settle_delay_usecs
;
1027 x
->tx_buf
= &packet
->read_y
;
1029 spi_message_add_tail(x
, m
);
1032 x
->rx_buf
= &packet
->tc
.y
;
1034 spi_message_add_tail(x
, m
);
1039 spi_message_init(m
);
1042 if (ts
->model
== 7845) {
1044 packet
->read_x_cmd
[0] = READ_X(vref
);
1045 packet
->read_x_cmd
[1] = 0;
1046 packet
->read_x_cmd
[2] = 0;
1047 x
->tx_buf
= &packet
->read_x_cmd
[0];
1048 x
->rx_buf
= &packet
->tc
.x_buf
[0];
1050 spi_message_add_tail(x
, m
);
1052 /* turn y- off, x+ on, then leave in lowpower */
1054 packet
->read_x
= READ_X(vref
);
1055 x
->tx_buf
= &packet
->read_x
;
1057 spi_message_add_tail(x
, m
);
1060 x
->rx_buf
= &packet
->tc
.x
;
1062 spi_message_add_tail(x
, m
);
1065 /* ... maybe discard first sample ... */
1066 if (pdata
->settle_delay_usecs
) {
1067 x
->delay_usecs
= pdata
->settle_delay_usecs
;
1070 x
->tx_buf
= &packet
->read_x
;
1072 spi_message_add_tail(x
, m
);
1075 x
->rx_buf
= &packet
->tc
.x
;
1077 spi_message_add_tail(x
, m
);
1080 /* turn y+ off, x- on; we'll use formula #2 */
1081 if (ts
->model
== 7846) {
1084 spi_message_init(m
);
1088 packet
->read_z1
= READ_Z1(vref
);
1089 x
->tx_buf
= &packet
->read_z1
;
1091 spi_message_add_tail(x
, m
);
1094 x
->rx_buf
= &packet
->tc
.z1
;
1096 spi_message_add_tail(x
, m
);
1098 /* ... maybe discard first sample ... */
1099 if (pdata
->settle_delay_usecs
) {
1100 x
->delay_usecs
= pdata
->settle_delay_usecs
;
1103 x
->tx_buf
= &packet
->read_z1
;
1105 spi_message_add_tail(x
, m
);
1108 x
->rx_buf
= &packet
->tc
.z1
;
1110 spi_message_add_tail(x
, m
);
1115 spi_message_init(m
);
1119 packet
->read_z2
= READ_Z2(vref
);
1120 x
->tx_buf
= &packet
->read_z2
;
1122 spi_message_add_tail(x
, m
);
1125 x
->rx_buf
= &packet
->tc
.z2
;
1127 spi_message_add_tail(x
, m
);
1129 /* ... maybe discard first sample ... */
1130 if (pdata
->settle_delay_usecs
) {
1131 x
->delay_usecs
= pdata
->settle_delay_usecs
;
1134 x
->tx_buf
= &packet
->read_z2
;
1136 spi_message_add_tail(x
, m
);
1139 x
->rx_buf
= &packet
->tc
.z2
;
1141 spi_message_add_tail(x
, m
);
1148 spi_message_init(m
);
1151 if (ts
->model
== 7845) {
1153 packet
->pwrdown_cmd
[0] = PWRDOWN
;
1154 packet
->pwrdown_cmd
[1] = 0;
1155 packet
->pwrdown_cmd
[2] = 0;
1156 x
->tx_buf
= &packet
->pwrdown_cmd
[0];
1160 packet
->pwrdown
= PWRDOWN
;
1161 x
->tx_buf
= &packet
->pwrdown
;
1163 spi_message_add_tail(x
, m
);
1166 x
->rx_buf
= &packet
->dummy
;
1171 spi_message_add_tail(x
, m
);
1174 static int __devinit
ads7846_probe(struct spi_device
*spi
)
1177 struct ads7846_packet
*packet
;
1178 struct input_dev
*input_dev
;
1179 struct ads7846_platform_data
*pdata
= spi
->dev
.platform_data
;
1180 unsigned long irq_flags
;
1184 dev_dbg(&spi
->dev
, "no IRQ?\n");
1189 dev_dbg(&spi
->dev
, "no platform data?\n");
1193 /* don't exceed max specified sample rate */
1194 if (spi
->max_speed_hz
> (125000 * SAMPLE_BITS
)) {
1195 dev_dbg(&spi
->dev
, "f(sample) %d KHz?\n",
1196 (spi
->max_speed_hz
/SAMPLE_BITS
)/1000);
1200 /* We'd set TX word size 8 bits and RX word size to 13 bits ... except
1201 * that even if the hardware can do that, the SPI controller driver
1202 * may not. So we stick to very-portable 8 bit words, both RX and TX.
1204 spi
->bits_per_word
= 8;
1205 spi
->mode
= SPI_MODE_0
;
1206 err
= spi_setup(spi
);
1210 ts
= kzalloc(sizeof(struct ads7846
), GFP_KERNEL
);
1211 packet
= kzalloc(sizeof(struct ads7846_packet
), GFP_KERNEL
);
1212 input_dev
= input_allocate_device();
1213 if (!ts
|| !packet
|| !input_dev
) {
1218 dev_set_drvdata(&spi
->dev
, ts
);
1220 ts
->packet
= packet
;
1222 ts
->input
= input_dev
;
1223 ts
->vref_mv
= pdata
->vref_mv
;
1224 ts
->swap_xy
= pdata
->swap_xy
;
1226 mutex_init(&ts
->lock
);
1227 init_waitqueue_head(&ts
->wait
);
1229 ts
->model
= pdata
->model
? : 7846;
1230 ts
->vref_delay_usecs
= pdata
->vref_delay_usecs
? : 100;
1231 ts
->x_plate_ohms
= pdata
->x_plate_ohms
? : 400;
1232 ts
->pressure_max
= pdata
->pressure_max
? : ~0;
1234 if (pdata
->filter
!= NULL
) {
1235 if (pdata
->filter_init
!= NULL
) {
1236 err
= pdata
->filter_init(pdata
, &ts
->filter_data
);
1240 ts
->filter
= pdata
->filter
;
1241 ts
->filter_cleanup
= pdata
->filter_cleanup
;
1242 } else if (pdata
->debounce_max
) {
1243 ts
->debounce_max
= pdata
->debounce_max
;
1244 if (ts
->debounce_max
< 2)
1245 ts
->debounce_max
= 2;
1246 ts
->debounce_tol
= pdata
->debounce_tol
;
1247 ts
->debounce_rep
= pdata
->debounce_rep
;
1248 ts
->filter
= ads7846_debounce_filter
;
1249 ts
->filter_data
= ts
;
1251 ts
->filter
= ads7846_no_filter
;
1254 err
= ads7846_setup_pendown(spi
, ts
);
1256 goto err_cleanup_filter
;
1258 if (pdata
->penirq_recheck_delay_usecs
)
1259 ts
->penirq_recheck_delay_usecs
=
1260 pdata
->penirq_recheck_delay_usecs
;
1262 ts
->wait_for_sync
= pdata
->wait_for_sync
? : null_wait_for_sync
;
1264 snprintf(ts
->phys
, sizeof(ts
->phys
), "%s/input0", dev_name(&spi
->dev
));
1265 snprintf(ts
->name
, sizeof(ts
->name
), "ADS%d Touchscreen", ts
->model
);
1267 input_dev
->name
= ts
->name
;
1268 input_dev
->phys
= ts
->phys
;
1269 input_dev
->dev
.parent
= &spi
->dev
;
1271 input_dev
->evbit
[0] = BIT_MASK(EV_KEY
) | BIT_MASK(EV_ABS
);
1272 input_dev
->keybit
[BIT_WORD(BTN_TOUCH
)] = BIT_MASK(BTN_TOUCH
);
1273 input_set_abs_params(input_dev
, ABS_X
,
1275 pdata
->x_max
? : MAX_12BIT
,
1277 input_set_abs_params(input_dev
, ABS_Y
,
1279 pdata
->y_max
? : MAX_12BIT
,
1281 input_set_abs_params(input_dev
, ABS_PRESSURE
,
1282 pdata
->pressure_min
, pdata
->pressure_max
, 0, 0);
1284 ads7846_setup_spi_msg(ts
, pdata
);
1286 ts
->reg
= regulator_get(&spi
->dev
, "vcc");
1287 if (IS_ERR(ts
->reg
)) {
1288 err
= PTR_ERR(ts
->reg
);
1289 dev_err(&spi
->dev
, "unable to get regulator: %d\n", err
);
1293 err
= regulator_enable(ts
->reg
);
1295 dev_err(&spi
->dev
, "unable to enable regulator: %d\n", err
);
1296 goto err_put_regulator
;
1299 irq_flags
= pdata
->irq_flags
? : IRQF_TRIGGER_FALLING
;
1300 irq_flags
|= IRQF_ONESHOT
;
1302 err
= request_threaded_irq(spi
->irq
, ads7846_hard_irq
, ads7846_irq
,
1303 irq_flags
, spi
->dev
.driver
->name
, ts
);
1304 if (err
&& !pdata
->irq_flags
) {
1306 "trying pin change workaround on irq %d\n", spi
->irq
);
1307 irq_flags
|= IRQF_TRIGGER_RISING
;
1308 err
= request_threaded_irq(spi
->irq
,
1309 ads7846_hard_irq
, ads7846_irq
,
1310 irq_flags
, spi
->dev
.driver
->name
, ts
);
1314 dev_dbg(&spi
->dev
, "irq %d busy?\n", spi
->irq
);
1315 goto err_disable_regulator
;
1318 err
= ads784x_hwmon_register(spi
, ts
);
1322 dev_info(&spi
->dev
, "touchscreen, irq %d\n", spi
->irq
);
1325 * Take a first sample, leaving nPENIRQ active and vREF off; avoid
1326 * the touchscreen, in case it's not connected.
1328 if (ts
->model
== 7845)
1329 ads7845_read12_ser(&spi
->dev
, PWRDOWN
);
1331 (void) ads7846_read12_ser(&spi
->dev
,
1332 READ_12BIT_SER(vaux
) | ADS_PD10_ALL_ON
);
1334 err
= sysfs_create_group(&spi
->dev
.kobj
, &ads784x_attr_group
);
1336 goto err_remove_hwmon
;
1338 err
= input_register_device(input_dev
);
1340 goto err_remove_attr_group
;
1342 device_init_wakeup(&spi
->dev
, pdata
->wakeup
);
1346 err_remove_attr_group
:
1347 sysfs_remove_group(&spi
->dev
.kobj
, &ads784x_attr_group
);
1349 ads784x_hwmon_unregister(spi
, ts
);
1351 free_irq(spi
->irq
, ts
);
1352 err_disable_regulator
:
1353 regulator_disable(ts
->reg
);
1355 regulator_put(ts
->reg
);
1357 if (!ts
->get_pendown_state
)
1358 gpio_free(ts
->gpio_pendown
);
1360 if (ts
->filter_cleanup
)
1361 ts
->filter_cleanup(ts
->filter_data
);
1363 input_free_device(input_dev
);
1369 static int __devexit
ads7846_remove(struct spi_device
*spi
)
1371 struct ads7846
*ts
= dev_get_drvdata(&spi
->dev
);
1373 device_init_wakeup(&spi
->dev
, false);
1375 sysfs_remove_group(&spi
->dev
.kobj
, &ads784x_attr_group
);
1377 ads7846_disable(ts
);
1378 free_irq(ts
->spi
->irq
, ts
);
1380 input_unregister_device(ts
->input
);
1382 ads784x_hwmon_unregister(spi
, ts
);
1384 regulator_disable(ts
->reg
);
1385 regulator_put(ts
->reg
);
1387 if (!ts
->get_pendown_state
) {
1389 * If we are not using specialized pendown method we must
1390 * have been relying on gpio we set up ourselves.
1392 gpio_free(ts
->gpio_pendown
);
1395 if (ts
->filter_cleanup
)
1396 ts
->filter_cleanup(ts
->filter_data
);
1401 dev_dbg(&spi
->dev
, "unregistered touchscreen\n");
1406 static struct spi_driver ads7846_driver
= {
1409 .bus
= &spi_bus_type
,
1410 .owner
= THIS_MODULE
,
1412 .probe
= ads7846_probe
,
1413 .remove
= __devexit_p(ads7846_remove
),
1414 .suspend
= ads7846_suspend
,
1415 .resume
= ads7846_resume
,
1418 static int __init
ads7846_init(void)
1420 return spi_register_driver(&ads7846_driver
);
1422 module_init(ads7846_init
);
1424 static void __exit
ads7846_exit(void)
1426 spi_unregister_driver(&ads7846_driver
);
1428 module_exit(ads7846_exit
);
1430 MODULE_DESCRIPTION("ADS7846 TouchScreen Driver");
1431 MODULE_LICENSE("GPL");
1432 MODULE_ALIAS("spi:ads7846");