2 * wm9713.c -- Codec touch driver for Wolfson WM9713 AC97 Codec.
4 * Copyright 2003, 2004, 2005, 2006, 2007, 2008 Wolfson Microelectronics PLC.
5 * Author: Liam Girdwood <lrg@slimlogic.co.uk>
6 * Parts Copyright : Ian Molton <spyro@f2s.com>
7 * Andrew Zabolotny <zap@homelink.ru>
8 * Russell King <rmk@arm.linux.org.uk>
10 * This program is free software; you can redistribute it and/or modify it
11 * under the terms of the GNU General Public License as published by the
12 * Free Software Foundation; either version 2 of the License, or (at your
13 * option) any later version.
17 #include <linux/module.h>
18 #include <linux/moduleparam.h>
19 #include <linux/version.h>
20 #include <linux/kernel.h>
21 #include <linux/input.h>
22 #include <linux/delay.h>
23 #include <linux/bitops.h>
24 #include <linux/wm97xx.h>
26 #define TS_NAME "wm97xx"
27 #define WM9713_VERSION "1.00"
28 #define DEFAULT_PRESSURE 0xb0c0
35 * Set internal pull up for pen detect.
37 * Pull up is in the range 1.02k (least sensitive) to 64k (most sensitive)
38 * i.e. pull up resistance = 64k Ohms / rpu.
40 * Adjust this value if you are having problems with pen detect not
41 * detecting any down event.
44 module_param(rpu
, int, 0);
45 MODULE_PARM_DESC(rpu
, "Set internal pull up resitor for pen detect.");
48 * Set current used for pressure measurement.
50 * Set pil = 2 to use 400uA
51 * pil = 1 to use 200uA and
52 * pil = 0 to disable pressure measurement.
54 * This is used to increase the range of values returned by the adc
55 * when measureing touchpanel pressure.
58 module_param(pil
, int, 0);
59 MODULE_PARM_DESC(pil
, "Set current used for pressure measurement.");
62 * Set threshold for pressure measurement.
64 * Pen down pressure below threshold is ignored.
66 static int pressure
= DEFAULT_PRESSURE
& 0xfff;
67 module_param(pressure
, int, 0);
68 MODULE_PARM_DESC(pressure
, "Set threshold for pressure measurement.");
71 * Set adc sample delay.
73 * For accurate touchpanel measurements, some settling time may be
74 * required between the switch matrix applying a voltage across the
75 * touchpanel plate and the ADC sampling the signal.
77 * This delay can be set by setting delay = n, where n is the array
78 * position of the delay in the array delay_table below.
79 * Long delays > 1ms are supported for completeness, but are not
83 module_param(delay
, int, 0);
84 MODULE_PARM_DESC(delay
, "Set adc sample delay.");
87 * Set five_wire = 1 to use a 5 wire touchscreen.
89 * NOTE: Five wire mode does not allow for readback of pressure.
92 module_param(five_wire
, int, 0);
93 MODULE_PARM_DESC(five_wire
, "Set to '1' to use 5-wire touchscreen.");
96 * Set adc mask function.
98 * Sources of glitch noise, such as signals driving an LCD display, may feed
99 * through to the touch screen plates and affect measurement accuracy. In
100 * order to minimise this, a signal may be applied to the MASK pin to delay or
101 * synchronise the sampling.
103 * 0 = No delay or sync
104 * 1 = High on pin stops conversions
105 * 2 = Edge triggered, edge on pin delays conversion by delay param (above)
106 * 3 = Edge triggered, edge on pin starts conversion after delay param
109 module_param(mask
, int, 0);
110 MODULE_PARM_DESC(mask
, "Set adc mask function.");
113 * Coordinate Polling Enable.
115 * Set to 1 to enable coordinate polling. e.g. x,y[,p] is sampled together
119 module_param(coord
, int, 0);
120 MODULE_PARM_DESC(coord
, "Polling coordinate mode");
123 * ADC sample delay times in uS
125 static const int delay_table
[] = {
126 21, /* 1 AC97 Link frames */
141 0 /* No delay, switch matrix always on */
145 * Delay after issuing a POLL command.
147 * The delay is 3 AC97 link frames + the touchpanel settling delay
149 static inline void poll_delay(int d
)
151 udelay(3 * AC97_LINK_FRAME
+ delay_table
[d
]);
155 * set up the physical settings of the WM9713
157 static void wm9713_phy_init(struct wm97xx
*wm
)
159 u16 dig1
= 0, dig2
, dig3
;
162 dig2
= WM97XX_DELAY(4) | WM97XX_SLT(5);
163 dig3
= WM9712_RPU(1);
168 dig3
|= WM9712_RPU(rpu
);
169 dev_info(wm
->dev
, "setting pen detect pull-up to %d Ohms\n",
173 /* Five wire panel? */
176 dev_info(wm
->dev
, "setting 5-wire touchscreen mode.");
180 "Pressure measurement not supported in 5 "
181 "wire mode, disabling\n");
186 /* touchpanel pressure */
190 "setting pressure measurement current to 400uA.");
193 "setting pressure measurement current to 200uA.");
197 /* sample settling delay */
198 if (delay
< 0 || delay
> 15) {
199 dev_info(wm
->dev
, "supplied delay out of range.");
201 dev_info(wm
->dev
, "setting adc sample delay to %d u Secs.",
205 dig2
|= WM97XX_DELAY(delay
);
208 dig3
|= ((mask
& 0x3) << 4);
212 wm
->misc
= wm97xx_reg_read(wm
, 0x5a);
214 wm97xx_reg_write(wm
, AC97_WM9713_DIG1
, dig1
);
215 wm97xx_reg_write(wm
, AC97_WM9713_DIG2
, dig2
);
216 wm97xx_reg_write(wm
, AC97_WM9713_DIG3
, dig3
);
217 wm97xx_reg_write(wm
, AC97_GPIO_STICKY
, 0x0);
220 static void wm9713_dig_enable(struct wm97xx
*wm
, int enable
)
225 val
= wm97xx_reg_read(wm
, AC97_EXTENDED_MID
);
226 wm97xx_reg_write(wm
, AC97_EXTENDED_MID
, val
& 0x7fff);
227 wm97xx_reg_write(wm
, AC97_WM9713_DIG3
, wm
->dig
[2] |
229 wm97xx_reg_read(wm
, AC97_WM97XX_DIGITISER_RD
); /* dummy read */
231 wm97xx_reg_write(wm
, AC97_WM9713_DIG3
, wm
->dig
[2] &
232 ~WM97XX_PRP_DET_DIG
);
233 val
= wm97xx_reg_read(wm
, AC97_EXTENDED_MID
);
234 wm97xx_reg_write(wm
, AC97_EXTENDED_MID
, val
| 0x8000);
238 static void wm9713_dig_restore(struct wm97xx
*wm
)
240 wm97xx_reg_write(wm
, AC97_WM9713_DIG1
, wm
->dig_save
[0]);
241 wm97xx_reg_write(wm
, AC97_WM9713_DIG2
, wm
->dig_save
[1]);
242 wm97xx_reg_write(wm
, AC97_WM9713_DIG3
, wm
->dig_save
[2]);
245 static void wm9713_aux_prepare(struct wm97xx
*wm
)
247 memcpy(wm
->dig_save
, wm
->dig
, sizeof(wm
->dig
));
248 wm97xx_reg_write(wm
, AC97_WM9713_DIG1
, 0);
249 wm97xx_reg_write(wm
, AC97_WM9713_DIG2
, 0);
250 wm97xx_reg_write(wm
, AC97_WM9713_DIG3
, WM97XX_PRP_DET_DIG
);
253 static inline int is_pden(struct wm97xx
*wm
)
255 return wm
->dig
[2] & WM9713_PDEN
;
259 * Read a sample from the WM9713 adc in polling mode.
261 static int wm9713_poll_sample(struct wm97xx
*wm
, int adcsel
, int *sample
)
264 int timeout
= 5 * delay
;
266 if (!wm
->pen_probably_down
) {
267 u16 data
= wm97xx_reg_read(wm
, AC97_WM97XX_DIGITISER_RD
);
268 if (!(data
& WM97XX_PEN_DOWN
))
270 wm
->pen_probably_down
= 1;
273 /* set up digitiser */
275 adcsel
= 1 << ((adcsel
& 0x7fff) + 3);
277 dig1
= wm97xx_reg_read(wm
, AC97_WM9713_DIG1
);
278 dig1
&= ~WM9713_ADCSEL_MASK
;
280 if (wm
->mach_ops
&& wm
->mach_ops
->pre_sample
)
281 wm
->mach_ops
->pre_sample(adcsel
);
282 wm97xx_reg_write(wm
, AC97_WM9713_DIG1
, dig1
| adcsel
| WM9713_POLL
);
284 /* wait 3 AC97 time slots + delay for conversion */
287 /* wait for POLL to go low */
288 while ((wm97xx_reg_read(wm
, AC97_WM9713_DIG1
) & WM9713_POLL
) &&
290 udelay(AC97_LINK_FRAME
);
295 /* If PDEN is set, we can get a timeout when pen goes up */
297 wm
->pen_probably_down
= 0;
299 dev_dbg(wm
->dev
, "adc sample timeout");
303 *sample
= wm97xx_reg_read(wm
, AC97_WM97XX_DIGITISER_RD
);
304 if (wm
->mach_ops
&& wm
->mach_ops
->post_sample
)
305 wm
->mach_ops
->post_sample(adcsel
);
307 /* check we have correct sample */
308 if ((*sample
& WM97XX_ADCSRC_MASK
) != ffs(adcsel
>> 1) << 12) {
309 dev_dbg(wm
->dev
, "adc wrong sample, read %x got %x", adcsel
,
310 *sample
& WM97XX_ADCSRC_MASK
);
314 if (!(*sample
& WM97XX_PEN_DOWN
)) {
315 wm
->pen_probably_down
= 0;
323 * Read a coordinate from the WM9713 adc in polling mode.
325 static int wm9713_poll_coord(struct wm97xx
*wm
, struct wm97xx_data
*data
)
328 int timeout
= 5 * delay
;
330 if (!wm
->pen_probably_down
) {
331 u16 val
= wm97xx_reg_read(wm
, AC97_WM97XX_DIGITISER_RD
);
332 if (!(val
& WM97XX_PEN_DOWN
))
334 wm
->pen_probably_down
= 1;
337 /* set up digitiser */
338 dig1
= wm97xx_reg_read(wm
, AC97_WM9713_DIG1
);
339 dig1
&= ~WM9713_ADCSEL_MASK
;
341 dig1
|= WM9713_ADCSEL_PRES
;
343 if (wm
->mach_ops
&& wm
->mach_ops
->pre_sample
)
344 wm
->mach_ops
->pre_sample(WM97XX_ADCSEL_X
| WM97XX_ADCSEL_Y
);
345 wm97xx_reg_write(wm
, AC97_WM9713_DIG1
,
346 dig1
| WM9713_POLL
| WM9713_COO
);
348 /* wait 3 AC97 time slots + delay for conversion */
350 data
->x
= wm97xx_reg_read(wm
, AC97_WM97XX_DIGITISER_RD
);
351 /* wait for POLL to go low */
352 while ((wm97xx_reg_read(wm
, AC97_WM9713_DIG1
) & WM9713_POLL
)
354 udelay(AC97_LINK_FRAME
);
359 /* If PDEN is set, we can get a timeout when pen goes up */
361 wm
->pen_probably_down
= 0;
363 dev_dbg(wm
->dev
, "adc sample timeout");
368 data
->y
= wm97xx_reg_read(wm
, AC97_WM97XX_DIGITISER_RD
);
370 data
->p
= wm97xx_reg_read(wm
, AC97_WM97XX_DIGITISER_RD
);
372 data
->p
= DEFAULT_PRESSURE
;
374 if (wm
->mach_ops
&& wm
->mach_ops
->post_sample
)
375 wm
->mach_ops
->post_sample(WM97XX_ADCSEL_X
| WM97XX_ADCSEL_Y
);
377 /* check we have correct sample */
378 if (!(data
->x
& WM97XX_ADCSEL_X
) || !(data
->y
& WM97XX_ADCSEL_Y
))
380 if (pil
&& !(data
->p
& WM97XX_ADCSEL_PRES
))
383 if (!(data
->x
& WM97XX_PEN_DOWN
) || !(data
->y
& WM97XX_PEN_DOWN
)) {
384 wm
->pen_probably_down
= 0;
393 * Sample the WM9713 touchscreen in polling mode
395 static int wm9713_poll_touch(struct wm97xx
*wm
, struct wm97xx_data
*data
)
400 rc
= wm9713_poll_coord(wm
, data
);
404 rc
= wm9713_poll_sample(wm
, WM9713_ADCSEL_X
, &data
->x
);
407 rc
= wm9713_poll_sample(wm
, WM9713_ADCSEL_Y
, &data
->y
);
411 rc
= wm9713_poll_sample(wm
, WM9713_ADCSEL_PRES
,
416 data
->p
= DEFAULT_PRESSURE
;
422 * Enable WM9713 continuous mode, i.e. touch data is streamed across
425 static int wm9713_acc_enable(struct wm97xx
*wm
, int enable
)
427 u16 dig1
, dig2
, dig3
;
436 if (wm
->mach_ops
->acc_startup
&&
437 (ret
= wm
->mach_ops
->acc_startup(wm
)) < 0)
440 dig1
&= ~WM9713_ADCSEL_MASK
;
441 dig1
|= WM9713_CTC
| WM9713_COO
| WM9713_ADCSEL_X
|
444 dig1
|= WM9713_ADCSEL_PRES
;
445 dig2
&= ~(WM97XX_DELAY_MASK
| WM97XX_SLT_MASK
|
446 WM97XX_CM_RATE_MASK
);
447 dig2
|= WM97XX_SLEN
| WM97XX_DELAY(delay
) |
448 WM97XX_SLT(wm
->acc_slot
) | WM97XX_RATE(wm
->acc_rate
);
451 dig1
&= ~(WM9713_CTC
| WM9713_COO
);
452 dig2
&= ~WM97XX_SLEN
;
453 dig3
&= ~WM9713_PDEN
;
454 if (wm
->mach_ops
->acc_shutdown
)
455 wm
->mach_ops
->acc_shutdown(wm
);
458 wm97xx_reg_write(wm
, AC97_WM9713_DIG1
, dig1
);
459 wm97xx_reg_write(wm
, AC97_WM9713_DIG2
, dig2
);
460 wm97xx_reg_write(wm
, AC97_WM9713_DIG3
, dig3
);
465 struct wm97xx_codec_drv wm9713_codec
= {
468 .poll_sample
= wm9713_poll_sample
,
469 .poll_touch
= wm9713_poll_touch
,
470 .acc_enable
= wm9713_acc_enable
,
471 .phy_init
= wm9713_phy_init
,
472 .dig_enable
= wm9713_dig_enable
,
473 .dig_restore
= wm9713_dig_restore
,
474 .aux_prepare
= wm9713_aux_prepare
,
476 EXPORT_SYMBOL_GPL(wm9713_codec
);
478 /* Module information */
479 MODULE_AUTHOR("Liam Girdwood <lrg@slimlogic.co.uk>");
480 MODULE_DESCRIPTION("WM9713 Touch Screen Driver");
481 MODULE_LICENSE("GPL");