xref: /openbmc/linux/drivers/iio/adc/ti-tsc2046.c (revision ac73d4bf)
1 // SPDX-License-Identifier: GPL-2.0
2 /*
3  * Texas Instruments TSC2046 SPI ADC driver
4  *
5  * Copyright (c) 2021 Oleksij Rempel <kernel@pengutronix.de>, Pengutronix
6  */
7 
8 #include <linux/bitfield.h>
9 #include <linux/delay.h>
10 #include <linux/module.h>
11 #include <linux/regulator/consumer.h>
12 #include <linux/spi/spi.h>
13 #include <linux/units.h>
14 
15 #include <asm/unaligned.h>
16 
17 #include <linux/iio/buffer.h>
18 #include <linux/iio/trigger_consumer.h>
19 #include <linux/iio/triggered_buffer.h>
20 #include <linux/iio/trigger.h>
21 
22 /*
23  * The PENIRQ of TSC2046 controller is implemented as level shifter attached to
24  * the X+ line. If voltage of the X+ line reaches a specific level the IRQ will
25  * be activated or deactivated.
26  * To make this kind of IRQ reusable as trigger following additions were
27  * implemented:
28  * - rate limiting:
29  *   For typical touchscreen use case, we need to trigger about each 10ms.
30  * - hrtimer:
31  *   Continue triggering at least once after the IRQ was deactivated. Then
32  *   deactivate this trigger to stop sampling in order to reduce power
33  *   consumption.
34  */
35 
36 #define TI_TSC2046_NAME				"tsc2046"
37 
38 /* This driver doesn't aim at the peak continuous sample rate */
39 #define	TI_TSC2046_MAX_SAMPLE_RATE		125000
40 #define	TI_TSC2046_SAMPLE_BITS \
41 	BITS_PER_TYPE(struct tsc2046_adc_atom)
42 #define	TI_TSC2046_MAX_CLK_FREQ \
43 	(TI_TSC2046_MAX_SAMPLE_RATE * TI_TSC2046_SAMPLE_BITS)
44 
45 #define TI_TSC2046_SAMPLE_INTERVAL_US		10000
46 
47 #define TI_TSC2046_START			BIT(7)
48 #define TI_TSC2046_ADDR				GENMASK(6, 4)
49 #define TI_TSC2046_ADDR_TEMP1			7
50 #define TI_TSC2046_ADDR_AUX			6
51 #define TI_TSC2046_ADDR_X			5
52 #define TI_TSC2046_ADDR_Z2			4
53 #define TI_TSC2046_ADDR_Z1			3
54 #define TI_TSC2046_ADDR_VBAT			2
55 #define TI_TSC2046_ADDR_Y			1
56 #define TI_TSC2046_ADDR_TEMP0			0
57 
58 /*
59  * The mode bit sets the resolution of the ADC. With this bit low, the next
60  * conversion has 12-bit resolution, whereas with this bit high, the next
61  * conversion has 8-bit resolution. This driver is optimized for 12-bit mode.
62  * So, for this driver, this bit should stay zero.
63  */
64 #define TI_TSC2046_8BIT_MODE			BIT(3)
65 
66 /*
67  * SER/DFR - The SER/DFR bit controls the reference mode, either single-ended
68  * (high) or differential (low).
69  */
70 #define TI_TSC2046_SER				BIT(2)
71 
72 /*
73  * If VREF_ON and ADC_ON are both zero, then the chip operates in
74  * auto-wake/suspend mode. In most case this bits should stay zero.
75  */
76 #define TI_TSC2046_PD1_VREF_ON			BIT(1)
77 #define TI_TSC2046_PD0_ADC_ON			BIT(0)
78 
79 /*
80  * All supported devices can do 8 or 12bit resolution. This driver
81  * supports only 12bit mode, here we have a 16bit data transfer, where
82  * the MSB and the 3 LSB are 0.
83  */
84 #define TI_TSC2046_DATA_12BIT			GENMASK(14, 3)
85 
86 #define TI_TSC2046_MAX_CHAN			8
87 #define TI_TSC2046_MIN_POLL_CNT			3
88 #define TI_TSC2046_EXT_POLL_CNT			3
89 #define TI_TSC2046_POLL_CNT \
90 	(TI_TSC2046_MIN_POLL_CNT + TI_TSC2046_EXT_POLL_CNT)
91 #define TI_TSC2046_INT_VREF			2500
92 
93 /* Represents a HW sample */
94 struct tsc2046_adc_atom {
95 	/*
96 	 * Command transmitted to the controller. This field is empty on the RX
97 	 * buffer.
98 	 */
99 	u8 cmd;
100 	/*
101 	 * Data received from the controller. This field is empty for the TX
102 	 * buffer
103 	 */
104 	__be16 data;
105 } __packed;
106 
107 /* Layout of atomic buffers within big buffer */
108 struct tsc2046_adc_group_layout {
109 	/* Group offset within the SPI RX buffer */
110 	unsigned int offset;
111 	/*
112 	 * Amount of tsc2046_adc_atom structs within the same command gathered
113 	 * within same group.
114 	 */
115 	unsigned int count;
116 	/*
117 	 * Settling samples (tsc2046_adc_atom structs) which should be skipped
118 	 * before good samples will start.
119 	 */
120 	unsigned int skip;
121 };
122 
123 struct tsc2046_adc_dcfg {
124 	const struct iio_chan_spec *channels;
125 	unsigned int num_channels;
126 };
127 
128 struct tsc2046_adc_ch_cfg {
129 	unsigned int settling_time_us;
130 	unsigned int oversampling_ratio;
131 };
132 
133 enum tsc2046_state {
134 	TSC2046_STATE_SHUTDOWN,
135 	TSC2046_STATE_STANDBY,
136 	TSC2046_STATE_POLL,
137 	TSC2046_STATE_POLL_IRQ_DISABLE,
138 	TSC2046_STATE_ENABLE_IRQ,
139 };
140 
141 struct tsc2046_adc_priv {
142 	struct spi_device *spi;
143 	const struct tsc2046_adc_dcfg *dcfg;
144 	struct regulator *vref_reg;
145 
146 	struct iio_trigger *trig;
147 	struct hrtimer trig_timer;
148 	enum tsc2046_state state;
149 	int poll_cnt;
150 	spinlock_t state_lock;
151 
152 	struct spi_transfer xfer;
153 	struct spi_message msg;
154 
155 	struct {
156 		/* Scan data for each channel */
157 		u16 data[TI_TSC2046_MAX_CHAN];
158 		/* Timestamp */
159 		s64 ts __aligned(8);
160 	} scan_buf;
161 
162 	/*
163 	 * Lock to protect the layout and the SPI transfer buffer.
164 	 * tsc2046_adc_group_layout can be changed within update_scan_mode(),
165 	 * in this case the l[] and tx/rx buffer will be out of sync to each
166 	 * other.
167 	 */
168 	struct mutex slock;
169 	struct tsc2046_adc_group_layout l[TI_TSC2046_MAX_CHAN];
170 	struct tsc2046_adc_atom *rx;
171 	struct tsc2046_adc_atom *tx;
172 
173 	unsigned int count;
174 	unsigned int groups;
175 	u32 effective_speed_hz;
176 	u32 scan_interval_us;
177 	u32 time_per_scan_us;
178 	u32 time_per_bit_ns;
179 	unsigned int vref_mv;
180 
181 	struct tsc2046_adc_ch_cfg ch_cfg[TI_TSC2046_MAX_CHAN];
182 };
183 
184 #define TI_TSC2046_V_CHAN(index, bits, name)			\
185 {								\
186 	.type = IIO_VOLTAGE,					\
187 	.indexed = 1,						\
188 	.channel = index,					\
189 	.info_mask_separate = BIT(IIO_CHAN_INFO_RAW),		\
190 	.info_mask_shared_by_type = BIT(IIO_CHAN_INFO_SCALE),	\
191 	.datasheet_name = "#name",				\
192 	.scan_index = index,					\
193 	.scan_type = {						\
194 		.sign = 'u',					\
195 		.realbits = bits,				\
196 		.storagebits = 16,				\
197 		.endianness = IIO_CPU,				\
198 	},							\
199 }
200 
201 #define DECLARE_TI_TSC2046_8_CHANNELS(name, bits) \
202 const struct iio_chan_spec name ## _channels[] = { \
203 	TI_TSC2046_V_CHAN(0, bits, TEMP0), \
204 	TI_TSC2046_V_CHAN(1, bits, Y), \
205 	TI_TSC2046_V_CHAN(2, bits, VBAT), \
206 	TI_TSC2046_V_CHAN(3, bits, Z1), \
207 	TI_TSC2046_V_CHAN(4, bits, Z2), \
208 	TI_TSC2046_V_CHAN(5, bits, X), \
209 	TI_TSC2046_V_CHAN(6, bits, AUX), \
210 	TI_TSC2046_V_CHAN(7, bits, TEMP1), \
211 	IIO_CHAN_SOFT_TIMESTAMP(8), \
212 }
213 
214 static DECLARE_TI_TSC2046_8_CHANNELS(tsc2046_adc, 12);
215 
216 static const struct tsc2046_adc_dcfg tsc2046_adc_dcfg_tsc2046e = {
217 	.channels = tsc2046_adc_channels,
218 	.num_channels = ARRAY_SIZE(tsc2046_adc_channels),
219 };
220 
221 /*
222  * Convert time to a number of samples which can be transferred within this
223  * time.
224  */
225 static unsigned int tsc2046_adc_time_to_count(struct tsc2046_adc_priv *priv,
226 					      unsigned long time)
227 {
228 	unsigned int bit_count, sample_count;
229 
230 	bit_count = DIV_ROUND_UP(time * NSEC_PER_USEC, priv->time_per_bit_ns);
231 	sample_count = DIV_ROUND_UP(bit_count, TI_TSC2046_SAMPLE_BITS);
232 
233 	dev_dbg(&priv->spi->dev, "Effective speed %u, time per bit: %u, count bits: %u, count samples: %u\n",
234 		priv->effective_speed_hz, priv->time_per_bit_ns,
235 		bit_count, sample_count);
236 
237 	return sample_count;
238 }
239 
240 static u8 tsc2046_adc_get_cmd(struct tsc2046_adc_priv *priv, int ch_idx,
241 			      bool keep_power)
242 {
243 	u32 pd;
244 
245 	/*
246 	 * if PD bits are 0, controller will automatically disable ADC, VREF and
247 	 * enable IRQ.
248 	 */
249 	if (keep_power)
250 		pd = TI_TSC2046_PD0_ADC_ON;
251 	else
252 		pd = 0;
253 
254 	switch (ch_idx) {
255 	case TI_TSC2046_ADDR_TEMP1:
256 	case TI_TSC2046_ADDR_AUX:
257 	case TI_TSC2046_ADDR_VBAT:
258 	case TI_TSC2046_ADDR_TEMP0:
259 		pd |= TI_TSC2046_SER;
260 		if (!priv->vref_reg)
261 			pd |= TI_TSC2046_PD1_VREF_ON;
262 	}
263 
264 	return TI_TSC2046_START | FIELD_PREP(TI_TSC2046_ADDR, ch_idx) | pd;
265 }
266 
267 static u16 tsc2046_adc_get_value(struct tsc2046_adc_atom *buf)
268 {
269 	return FIELD_GET(TI_TSC2046_DATA_12BIT, get_unaligned_be16(&buf->data));
270 }
271 
272 static int tsc2046_adc_read_one(struct tsc2046_adc_priv *priv, int ch_idx,
273 				u32 *effective_speed_hz)
274 {
275 	struct tsc2046_adc_ch_cfg *ch = &priv->ch_cfg[ch_idx];
276 	struct tsc2046_adc_atom *rx_buf, *tx_buf;
277 	unsigned int val, val_normalized = 0;
278 	int ret, i, count_skip = 0, max_count;
279 	struct spi_transfer xfer;
280 	struct spi_message msg;
281 	u8 cmd;
282 
283 	if (!effective_speed_hz) {
284 		count_skip = tsc2046_adc_time_to_count(priv, ch->settling_time_us);
285 		max_count = count_skip + ch->oversampling_ratio;
286 	} else {
287 		max_count = 1;
288 	}
289 
290 	if (sizeof(*tx_buf) * max_count > PAGE_SIZE)
291 		return -ENOSPC;
292 
293 	tx_buf = kcalloc(max_count, sizeof(*tx_buf), GFP_KERNEL);
294 	if (!tx_buf)
295 		return -ENOMEM;
296 
297 	rx_buf = kcalloc(max_count, sizeof(*rx_buf), GFP_KERNEL);
298 	if (!rx_buf) {
299 		ret = -ENOMEM;
300 		goto free_tx;
301 	}
302 
303 	/*
304 	 * Do not enable automatic power down on working samples. Otherwise the
305 	 * plates will never be completely charged.
306 	 */
307 	cmd = tsc2046_adc_get_cmd(priv, ch_idx, true);
308 
309 	for (i = 0; i < max_count - 1; i++)
310 		tx_buf[i].cmd = cmd;
311 
312 	/* automatically power down on last sample */
313 	tx_buf[i].cmd = tsc2046_adc_get_cmd(priv, ch_idx, false);
314 
315 	memset(&xfer, 0, sizeof(xfer));
316 	xfer.tx_buf = tx_buf;
317 	xfer.rx_buf = rx_buf;
318 	xfer.len = sizeof(*tx_buf) * max_count;
319 	spi_message_init_with_transfers(&msg, &xfer, 1);
320 
321 	/*
322 	 * We aren't using spi_write_then_read() because we need to be able
323 	 * to get hold of the effective_speed_hz from the xfer
324 	 */
325 	ret = spi_sync(priv->spi, &msg);
326 	if (ret) {
327 		dev_err_ratelimited(&priv->spi->dev, "SPI transfer failed %pe\n",
328 				    ERR_PTR(ret));
329 		goto free_bufs;
330 	}
331 
332 	if (effective_speed_hz)
333 		*effective_speed_hz = xfer.effective_speed_hz;
334 
335 	for (i = 0; i < max_count - count_skip; i++) {
336 		val = tsc2046_adc_get_value(&rx_buf[count_skip + i]);
337 		val_normalized += val;
338 	}
339 
340 	ret = DIV_ROUND_UP(val_normalized, max_count - count_skip);
341 
342 free_bufs:
343 	kfree(rx_buf);
344 free_tx:
345 	kfree(tx_buf);
346 
347 	return ret;
348 }
349 
350 static size_t tsc2046_adc_group_set_layout(struct tsc2046_adc_priv *priv,
351 					   unsigned int group,
352 					   unsigned int ch_idx)
353 {
354 	struct tsc2046_adc_ch_cfg *ch = &priv->ch_cfg[ch_idx];
355 	struct tsc2046_adc_group_layout *cur;
356 	unsigned int max_count, count_skip;
357 	unsigned int offset = 0;
358 
359 	if (group)
360 		offset = priv->l[group - 1].offset + priv->l[group - 1].count;
361 
362 	count_skip = tsc2046_adc_time_to_count(priv, ch->settling_time_us);
363 	max_count = count_skip + ch->oversampling_ratio;
364 
365 	cur = &priv->l[group];
366 	cur->offset = offset;
367 	cur->count = max_count;
368 	cur->skip = count_skip;
369 
370 	return sizeof(*priv->tx) * max_count;
371 }
372 
373 static void tsc2046_adc_group_set_cmd(struct tsc2046_adc_priv *priv,
374 				      unsigned int group, int ch_idx)
375 {
376 	struct tsc2046_adc_group_layout *l = &priv->l[group];
377 	unsigned int i;
378 	u8 cmd;
379 
380 	/*
381 	 * Do not enable automatic power down on working samples. Otherwise the
382 	 * plates will never be completely charged.
383 	 */
384 	cmd = tsc2046_adc_get_cmd(priv, ch_idx, true);
385 
386 	for (i = 0; i < l->count - 1; i++)
387 		priv->tx[l->offset + i].cmd = cmd;
388 
389 	/* automatically power down on last sample */
390 	priv->tx[l->offset + i].cmd = tsc2046_adc_get_cmd(priv, ch_idx, false);
391 }
392 
393 static u16 tsc2046_adc_get_val(struct tsc2046_adc_priv *priv, int group)
394 {
395 	struct tsc2046_adc_group_layout *l;
396 	unsigned int val, val_normalized = 0;
397 	int valid_count, i;
398 
399 	l = &priv->l[group];
400 	valid_count = l->count - l->skip;
401 
402 	for (i = 0; i < valid_count; i++) {
403 		val = tsc2046_adc_get_value(&priv->rx[l->offset + l->skip + i]);
404 		val_normalized += val;
405 	}
406 
407 	return DIV_ROUND_UP(val_normalized, valid_count);
408 }
409 
410 static int tsc2046_adc_scan(struct iio_dev *indio_dev)
411 {
412 	struct tsc2046_adc_priv *priv = iio_priv(indio_dev);
413 	struct device *dev = &priv->spi->dev;
414 	int group;
415 	int ret;
416 
417 	ret = spi_sync(priv->spi, &priv->msg);
418 	if (ret < 0) {
419 		dev_err_ratelimited(dev, "SPI transfer failed: %pe\n", ERR_PTR(ret));
420 		return ret;
421 	}
422 
423 	for (group = 0; group < priv->groups; group++)
424 		priv->scan_buf.data[group] = tsc2046_adc_get_val(priv, group);
425 
426 	ret = iio_push_to_buffers_with_timestamp(indio_dev, &priv->scan_buf,
427 						 iio_get_time_ns(indio_dev));
428 	/* If the consumer is kfifo, we may get a EBUSY here - ignore it. */
429 	if (ret < 0 && ret != -EBUSY) {
430 		dev_err_ratelimited(dev, "Failed to push scan buffer %pe\n",
431 				    ERR_PTR(ret));
432 
433 		return ret;
434 	}
435 
436 	return 0;
437 }
438 
439 static irqreturn_t tsc2046_adc_trigger_handler(int irq, void *p)
440 {
441 	struct iio_poll_func *pf = p;
442 	struct iio_dev *indio_dev = pf->indio_dev;
443 	struct tsc2046_adc_priv *priv = iio_priv(indio_dev);
444 
445 	mutex_lock(&priv->slock);
446 	tsc2046_adc_scan(indio_dev);
447 	mutex_unlock(&priv->slock);
448 
449 	iio_trigger_notify_done(indio_dev->trig);
450 
451 	return IRQ_HANDLED;
452 }
453 
454 static int tsc2046_adc_read_raw(struct iio_dev *indio_dev,
455 				struct iio_chan_spec const *chan,
456 				int *val, int *val2, long m)
457 {
458 	struct tsc2046_adc_priv *priv = iio_priv(indio_dev);
459 	int ret;
460 
461 	switch (m) {
462 	case IIO_CHAN_INFO_RAW:
463 		ret = tsc2046_adc_read_one(priv, chan->channel, NULL);
464 		if (ret < 0)
465 			return ret;
466 
467 		*val = ret;
468 
469 		return IIO_VAL_INT;
470 	case IIO_CHAN_INFO_SCALE:
471 		/*
472 		 * Note: the TSC2046 has internal voltage divider on the VBAT
473 		 * line. This divider can be influenced by external divider.
474 		 * So, it is better to use external voltage-divider driver
475 		 * instead, which is calculating complete chain.
476 		 */
477 		*val = priv->vref_mv;
478 		*val2 = chan->scan_type.realbits;
479 		return IIO_VAL_FRACTIONAL_LOG2;
480 	}
481 
482 	return -EINVAL;
483 }
484 
485 static int tsc2046_adc_update_scan_mode(struct iio_dev *indio_dev,
486 					const unsigned long *active_scan_mask)
487 {
488 	struct tsc2046_adc_priv *priv = iio_priv(indio_dev);
489 	unsigned int ch_idx, group = 0;
490 	size_t size;
491 
492 	mutex_lock(&priv->slock);
493 
494 	size = 0;
495 	for_each_set_bit(ch_idx, active_scan_mask, ARRAY_SIZE(priv->l)) {
496 		size += tsc2046_adc_group_set_layout(priv, group, ch_idx);
497 		tsc2046_adc_group_set_cmd(priv, group, ch_idx);
498 		group++;
499 	}
500 
501 	priv->groups = group;
502 	priv->xfer.len = size;
503 	priv->time_per_scan_us = size * 8 * priv->time_per_bit_ns / NSEC_PER_USEC;
504 
505 	if (priv->scan_interval_us < priv->time_per_scan_us)
506 		dev_warn(&priv->spi->dev, "The scan interval (%d) is less then calculated scan time (%d)\n",
507 			 priv->scan_interval_us, priv->time_per_scan_us);
508 
509 	mutex_unlock(&priv->slock);
510 
511 	return 0;
512 }
513 
514 static const struct iio_info tsc2046_adc_info = {
515 	.read_raw	  = tsc2046_adc_read_raw,
516 	.update_scan_mode = tsc2046_adc_update_scan_mode,
517 };
518 
519 static enum hrtimer_restart tsc2046_adc_timer(struct hrtimer *hrtimer)
520 {
521 	struct tsc2046_adc_priv *priv = container_of(hrtimer,
522 						     struct tsc2046_adc_priv,
523 						     trig_timer);
524 	unsigned long flags;
525 
526 	/*
527 	 * This state machine should address following challenges :
528 	 * - the interrupt source is based on level shifter attached to the X
529 	 *   channel of ADC. It will change the state every time we switch
530 	 *   between channels. So, we need to disable IRQ if we do
531 	 *   iio_trigger_poll().
532 	 * - we should do iio_trigger_poll() at some reduced sample rate
533 	 * - we should still trigger for some amount of time after last
534 	 *   interrupt with enabled IRQ was processed.
535 	 */
536 
537 	spin_lock_irqsave(&priv->state_lock, flags);
538 	switch (priv->state) {
539 	case TSC2046_STATE_ENABLE_IRQ:
540 		if (priv->poll_cnt < TI_TSC2046_POLL_CNT) {
541 			priv->poll_cnt++;
542 			hrtimer_start(&priv->trig_timer,
543 				      ns_to_ktime(priv->scan_interval_us *
544 						  NSEC_PER_USEC),
545 				      HRTIMER_MODE_REL_SOFT);
546 
547 			if (priv->poll_cnt >= TI_TSC2046_MIN_POLL_CNT) {
548 				priv->state = TSC2046_STATE_POLL_IRQ_DISABLE;
549 				enable_irq(priv->spi->irq);
550 			} else {
551 				priv->state = TSC2046_STATE_POLL;
552 			}
553 		} else {
554 			priv->state = TSC2046_STATE_STANDBY;
555 			enable_irq(priv->spi->irq);
556 		}
557 		break;
558 	case TSC2046_STATE_POLL_IRQ_DISABLE:
559 		disable_irq_nosync(priv->spi->irq);
560 		fallthrough;
561 	case TSC2046_STATE_POLL:
562 		priv->state = TSC2046_STATE_ENABLE_IRQ;
563 		/* iio_trigger_poll() starts hrtimer */
564 		iio_trigger_poll(priv->trig);
565 		break;
566 	case TSC2046_STATE_SHUTDOWN:
567 		break;
568 	case TSC2046_STATE_STANDBY:
569 		fallthrough;
570 	default:
571 		dev_warn(&priv->spi->dev, "Got unexpected state: %i\n",
572 			 priv->state);
573 		break;
574 	}
575 	spin_unlock_irqrestore(&priv->state_lock, flags);
576 
577 	return HRTIMER_NORESTART;
578 }
579 
580 static irqreturn_t tsc2046_adc_irq(int irq, void *dev_id)
581 {
582 	struct iio_dev *indio_dev = dev_id;
583 	struct tsc2046_adc_priv *priv = iio_priv(indio_dev);
584 	unsigned long flags;
585 
586 	hrtimer_try_to_cancel(&priv->trig_timer);
587 
588 	spin_lock_irqsave(&priv->state_lock, flags);
589 	if (priv->state != TSC2046_STATE_SHUTDOWN) {
590 		priv->state = TSC2046_STATE_ENABLE_IRQ;
591 		priv->poll_cnt = 0;
592 
593 		/* iio_trigger_poll() starts hrtimer */
594 		disable_irq_nosync(priv->spi->irq);
595 		iio_trigger_poll(priv->trig);
596 	}
597 	spin_unlock_irqrestore(&priv->state_lock, flags);
598 
599 	return IRQ_HANDLED;
600 }
601 
602 static void tsc2046_adc_reenable_trigger(struct iio_trigger *trig)
603 {
604 	struct iio_dev *indio_dev = iio_trigger_get_drvdata(trig);
605 	struct tsc2046_adc_priv *priv = iio_priv(indio_dev);
606 	ktime_t tim;
607 
608 	/*
609 	 * We can sample it as fast as we can, but usually we do not need so
610 	 * many samples. Reduce the sample rate for default (touchscreen) use
611 	 * case.
612 	 */
613 	tim = ns_to_ktime((priv->scan_interval_us - priv->time_per_scan_us) *
614 			  NSEC_PER_USEC);
615 	hrtimer_start(&priv->trig_timer, tim, HRTIMER_MODE_REL_SOFT);
616 }
617 
618 static int tsc2046_adc_set_trigger_state(struct iio_trigger *trig, bool enable)
619 {
620 	struct iio_dev *indio_dev = iio_trigger_get_drvdata(trig);
621 	struct tsc2046_adc_priv *priv = iio_priv(indio_dev);
622 	unsigned long flags;
623 
624 	if (enable) {
625 		spin_lock_irqsave(&priv->state_lock, flags);
626 		if (priv->state == TSC2046_STATE_SHUTDOWN) {
627 			priv->state = TSC2046_STATE_STANDBY;
628 			enable_irq(priv->spi->irq);
629 		}
630 		spin_unlock_irqrestore(&priv->state_lock, flags);
631 	} else {
632 		spin_lock_irqsave(&priv->state_lock, flags);
633 
634 		if (priv->state == TSC2046_STATE_STANDBY ||
635 		    priv->state == TSC2046_STATE_POLL_IRQ_DISABLE)
636 			disable_irq_nosync(priv->spi->irq);
637 
638 		priv->state = TSC2046_STATE_SHUTDOWN;
639 		spin_unlock_irqrestore(&priv->state_lock, flags);
640 
641 		hrtimer_cancel(&priv->trig_timer);
642 	}
643 
644 	return 0;
645 }
646 
647 static const struct iio_trigger_ops tsc2046_adc_trigger_ops = {
648 	.set_trigger_state = tsc2046_adc_set_trigger_state,
649 	.reenable = tsc2046_adc_reenable_trigger,
650 };
651 
652 static int tsc2046_adc_setup_spi_msg(struct tsc2046_adc_priv *priv)
653 {
654 	unsigned int ch_idx;
655 	size_t size;
656 	int ret;
657 
658 	/*
659 	 * Make dummy read to set initial power state and get real SPI clock
660 	 * freq. It seems to be not important which channel is used for this
661 	 * case.
662 	 */
663 	ret = tsc2046_adc_read_one(priv, TI_TSC2046_ADDR_TEMP0,
664 				   &priv->effective_speed_hz);
665 	if (ret < 0)
666 		return ret;
667 
668 	/*
669 	 * In case SPI controller do not report effective_speed_hz, use
670 	 * configure value and hope it will match.
671 	 */
672 	if (!priv->effective_speed_hz)
673 		priv->effective_speed_hz = priv->spi->max_speed_hz;
674 
675 
676 	priv->scan_interval_us = TI_TSC2046_SAMPLE_INTERVAL_US;
677 	priv->time_per_bit_ns = DIV_ROUND_UP(NSEC_PER_SEC,
678 					     priv->effective_speed_hz);
679 
680 	/*
681 	 * Calculate and allocate maximal size buffer if all channels are
682 	 * enabled.
683 	 */
684 	size = 0;
685 	for (ch_idx = 0; ch_idx < ARRAY_SIZE(priv->l); ch_idx++)
686 		size += tsc2046_adc_group_set_layout(priv, ch_idx, ch_idx);
687 
688 	if (size > PAGE_SIZE) {
689 		dev_err(&priv->spi->dev,
690 			"Calculated scan buffer is too big. Try to reduce spi-max-frequency, settling-time-us or oversampling-ratio\n");
691 		return -ENOSPC;
692 	}
693 
694 	priv->tx = devm_kzalloc(&priv->spi->dev, size, GFP_KERNEL);
695 	if (!priv->tx)
696 		return -ENOMEM;
697 
698 	priv->rx = devm_kzalloc(&priv->spi->dev, size, GFP_KERNEL);
699 	if (!priv->rx)
700 		return -ENOMEM;
701 
702 	priv->xfer.tx_buf = priv->tx;
703 	priv->xfer.rx_buf = priv->rx;
704 	priv->xfer.len = size;
705 	spi_message_init_with_transfers(&priv->msg, &priv->xfer, 1);
706 
707 	return 0;
708 }
709 
710 static void tsc2046_adc_parse_fwnode(struct tsc2046_adc_priv *priv)
711 {
712 	struct fwnode_handle *child;
713 	struct device *dev = &priv->spi->dev;
714 	unsigned int i;
715 
716 	for (i = 0; i < ARRAY_SIZE(priv->ch_cfg); i++) {
717 		priv->ch_cfg[i].settling_time_us = 1;
718 		priv->ch_cfg[i].oversampling_ratio = 1;
719 	}
720 
721 	device_for_each_child_node(dev, child) {
722 		u32 stl, overs, reg;
723 		int ret;
724 
725 		ret = fwnode_property_read_u32(child, "reg", &reg);
726 		if (ret) {
727 			dev_err(dev, "invalid reg on %pfw, err: %pe\n", child,
728 				ERR_PTR(ret));
729 			continue;
730 		}
731 
732 		if (reg >= ARRAY_SIZE(priv->ch_cfg)) {
733 			dev_err(dev, "%pfw: Unsupported reg value: %i, max supported is: %zu.\n",
734 				child, reg, ARRAY_SIZE(priv->ch_cfg));
735 			continue;
736 		}
737 
738 		ret = fwnode_property_read_u32(child, "settling-time-us", &stl);
739 		if (!ret)
740 			priv->ch_cfg[reg].settling_time_us = stl;
741 
742 		ret = fwnode_property_read_u32(child, "oversampling-ratio",
743 					       &overs);
744 		if (!ret)
745 			priv->ch_cfg[reg].oversampling_ratio = overs;
746 	}
747 }
748 
749 static void tsc2046_adc_regulator_disable(void *data)
750 {
751 	struct tsc2046_adc_priv *priv = data;
752 
753 	regulator_disable(priv->vref_reg);
754 }
755 
756 static int tsc2046_adc_configure_regulator(struct tsc2046_adc_priv *priv)
757 {
758 	struct device *dev = &priv->spi->dev;
759 	int ret;
760 
761 	priv->vref_reg = devm_regulator_get_optional(dev, "vref");
762 	if (IS_ERR(priv->vref_reg)) {
763 		/* If regulator exists but can't be get, return an error */
764 		if (PTR_ERR(priv->vref_reg) != -ENODEV)
765 			return PTR_ERR(priv->vref_reg);
766 		priv->vref_reg = NULL;
767 	}
768 	if (!priv->vref_reg) {
769 		/* Use internal reference */
770 		priv->vref_mv = TI_TSC2046_INT_VREF;
771 		return 0;
772 	}
773 
774 	ret = regulator_enable(priv->vref_reg);
775 	if (ret)
776 		return ret;
777 
778 	ret = devm_add_action_or_reset(dev, tsc2046_adc_regulator_disable,
779 				       priv);
780 	if (ret)
781 		return ret;
782 
783 	ret = regulator_get_voltage(priv->vref_reg);
784 	if (ret < 0)
785 		return ret;
786 
787 	priv->vref_mv = ret / MILLI;
788 
789 	return 0;
790 }
791 
792 static int tsc2046_adc_probe(struct spi_device *spi)
793 {
794 	const struct tsc2046_adc_dcfg *dcfg;
795 	struct device *dev = &spi->dev;
796 	struct tsc2046_adc_priv *priv;
797 	struct iio_dev *indio_dev;
798 	struct iio_trigger *trig;
799 	int ret;
800 
801 	if (spi->max_speed_hz > TI_TSC2046_MAX_CLK_FREQ) {
802 		dev_err(dev, "SPI max_speed_hz is too high: %d Hz. Max supported freq is %zu Hz\n",
803 			spi->max_speed_hz, TI_TSC2046_MAX_CLK_FREQ);
804 		return -EINVAL;
805 	}
806 
807 	dcfg = device_get_match_data(dev);
808 	if (!dcfg) {
809 		const struct spi_device_id *id = spi_get_device_id(spi);
810 
811 		dcfg = (const struct tsc2046_adc_dcfg *)id->driver_data;
812 	}
813 	if (!dcfg)
814 		return -EINVAL;
815 
816 	spi->bits_per_word = 8;
817 	spi->mode &= ~SPI_MODE_X_MASK;
818 	spi->mode |= SPI_MODE_0;
819 	ret = spi_setup(spi);
820 	if (ret < 0)
821 		return dev_err_probe(dev, ret, "Error in SPI setup\n");
822 
823 	indio_dev = devm_iio_device_alloc(dev, sizeof(*priv));
824 	if (!indio_dev)
825 		return -ENOMEM;
826 
827 	priv = iio_priv(indio_dev);
828 	priv->dcfg = dcfg;
829 
830 	priv->spi = spi;
831 
832 	indio_dev->name = TI_TSC2046_NAME;
833 	indio_dev->modes = INDIO_DIRECT_MODE;
834 	indio_dev->channels = dcfg->channels;
835 	indio_dev->num_channels = dcfg->num_channels;
836 	indio_dev->info = &tsc2046_adc_info;
837 
838 	ret = tsc2046_adc_configure_regulator(priv);
839 	if (ret)
840 		return ret;
841 
842 	tsc2046_adc_parse_fwnode(priv);
843 
844 	ret = tsc2046_adc_setup_spi_msg(priv);
845 	if (ret)
846 		return ret;
847 
848 	mutex_init(&priv->slock);
849 
850 	ret = devm_request_irq(dev, spi->irq, &tsc2046_adc_irq,
851 			       IRQF_NO_AUTOEN, indio_dev->name, indio_dev);
852 	if (ret)
853 		return ret;
854 
855 	trig = devm_iio_trigger_alloc(dev, "touchscreen-%s", indio_dev->name);
856 	if (!trig)
857 		return -ENOMEM;
858 
859 	priv->trig = trig;
860 	iio_trigger_set_drvdata(trig, indio_dev);
861 	trig->ops = &tsc2046_adc_trigger_ops;
862 
863 	spin_lock_init(&priv->state_lock);
864 	priv->state = TSC2046_STATE_SHUTDOWN;
865 	hrtimer_init(&priv->trig_timer, CLOCK_MONOTONIC,
866 		     HRTIMER_MODE_REL_SOFT);
867 	priv->trig_timer.function = tsc2046_adc_timer;
868 
869 	ret = devm_iio_trigger_register(dev, trig);
870 	if (ret) {
871 		dev_err(dev, "failed to register trigger\n");
872 		return ret;
873 	}
874 
875 	ret = devm_iio_triggered_buffer_setup(dev, indio_dev, NULL,
876 					      &tsc2046_adc_trigger_handler, NULL);
877 	if (ret) {
878 		dev_err(dev, "Failed to setup triggered buffer\n");
879 		return ret;
880 	}
881 
882 	/* set default trigger */
883 	indio_dev->trig = iio_trigger_get(priv->trig);
884 
885 	return devm_iio_device_register(dev, indio_dev);
886 }
887 
888 static const struct of_device_id ads7950_of_table[] = {
889 	{ .compatible = "ti,tsc2046e-adc", .data = &tsc2046_adc_dcfg_tsc2046e },
890 	{ }
891 };
892 MODULE_DEVICE_TABLE(of, ads7950_of_table);
893 
894 static const struct spi_device_id tsc2046_adc_spi_ids[] = {
895 	{ "tsc2046e-adc", (unsigned long)&tsc2046_adc_dcfg_tsc2046e },
896 	{ }
897 };
898 MODULE_DEVICE_TABLE(spi, tsc2046_adc_spi_ids);
899 
900 static struct spi_driver tsc2046_adc_driver = {
901 	.driver = {
902 		.name = "tsc2046",
903 		.of_match_table = ads7950_of_table,
904 	},
905 	.id_table = tsc2046_adc_spi_ids,
906 	.probe = tsc2046_adc_probe,
907 };
908 module_spi_driver(tsc2046_adc_driver);
909 
910 MODULE_AUTHOR("Oleksij Rempel <kernel@pengutronix.de>");
911 MODULE_DESCRIPTION("TI TSC2046 ADC");
912 MODULE_LICENSE("GPL v2");
913