xref: /linux/drivers/iio/adc/twl4030-madc.c (revision e2be04c7f9958dde770eeb8b30e829ca969b37bb)
1 /*
2  *
3  * TWL4030 MADC module driver-This driver monitors the real time
4  * conversion of analog signals like battery temperature,
5  * battery type, battery level etc.
6  *
7  * Copyright (C) 2011 Texas Instruments Incorporated - http://www.ti.com/
8  * J Keerthy <j-keerthy@ti.com>
9  *
10  * Based on twl4030-madc.c
11  * Copyright (C) 2008 Nokia Corporation
12  * Mikko Ylinen <mikko.k.ylinen@nokia.com>
13  *
14  * Amit Kucheria <amit.kucheria@canonical.com>
15  *
16  * This program is free software; you can redistribute it and/or
17  * modify it under the terms of the GNU General Public License
18  * version 2 as published by the Free Software Foundation.
19  *
20  * This program is distributed in the hope that it will be useful, but
21  * WITHOUT ANY WARRANTY; without even the implied warranty of
22  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
23  * General Public License for more details.
24  *
25  * You should have received a copy of the GNU General Public License
26  * along with this program; if not, write to the Free Software
27  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
28  * 02110-1301 USA
29  *
30  */
31 
32 #include <linux/device.h>
33 #include <linux/interrupt.h>
34 #include <linux/kernel.h>
35 #include <linux/delay.h>
36 #include <linux/platform_device.h>
37 #include <linux/slab.h>
38 #include <linux/mfd/twl.h>
39 #include <linux/module.h>
40 #include <linux/stddef.h>
41 #include <linux/mutex.h>
42 #include <linux/bitops.h>
43 #include <linux/jiffies.h>
44 #include <linux/types.h>
45 #include <linux/gfp.h>
46 #include <linux/err.h>
47 #include <linux/regulator/consumer.h>
48 
49 #include <linux/iio/iio.h>
50 
51 #define TWL4030_MADC_MAX_CHANNELS 16
52 
53 #define TWL4030_MADC_CTRL1		0x00
54 #define TWL4030_MADC_CTRL2		0x01
55 
56 #define TWL4030_MADC_RTSELECT_LSB	0x02
57 #define TWL4030_MADC_SW1SELECT_LSB	0x06
58 #define TWL4030_MADC_SW2SELECT_LSB	0x0A
59 
60 #define TWL4030_MADC_RTAVERAGE_LSB	0x04
61 #define TWL4030_MADC_SW1AVERAGE_LSB	0x08
62 #define TWL4030_MADC_SW2AVERAGE_LSB	0x0C
63 
64 #define TWL4030_MADC_CTRL_SW1		0x12
65 #define TWL4030_MADC_CTRL_SW2		0x13
66 
67 #define TWL4030_MADC_RTCH0_LSB		0x17
68 #define TWL4030_MADC_GPCH0_LSB		0x37
69 
70 #define TWL4030_MADC_MADCON	(1 << 0)	/* MADC power on */
71 #define TWL4030_MADC_BUSY	(1 << 0)	/* MADC busy */
72 /* MADC conversion completion */
73 #define TWL4030_MADC_EOC_SW	(1 << 1)
74 /* MADC SWx start conversion */
75 #define TWL4030_MADC_SW_START	(1 << 5)
76 #define TWL4030_MADC_ADCIN0	(1 << 0)
77 #define TWL4030_MADC_ADCIN1	(1 << 1)
78 #define TWL4030_MADC_ADCIN2	(1 << 2)
79 #define TWL4030_MADC_ADCIN3	(1 << 3)
80 #define TWL4030_MADC_ADCIN4	(1 << 4)
81 #define TWL4030_MADC_ADCIN5	(1 << 5)
82 #define TWL4030_MADC_ADCIN6	(1 << 6)
83 #define TWL4030_MADC_ADCIN7	(1 << 7)
84 #define TWL4030_MADC_ADCIN8	(1 << 8)
85 #define TWL4030_MADC_ADCIN9	(1 << 9)
86 #define TWL4030_MADC_ADCIN10	(1 << 10)
87 #define TWL4030_MADC_ADCIN11	(1 << 11)
88 #define TWL4030_MADC_ADCIN12	(1 << 12)
89 #define TWL4030_MADC_ADCIN13	(1 << 13)
90 #define TWL4030_MADC_ADCIN14	(1 << 14)
91 #define TWL4030_MADC_ADCIN15	(1 << 15)
92 
93 /* Fixed channels */
94 #define TWL4030_MADC_BTEMP	TWL4030_MADC_ADCIN1
95 #define TWL4030_MADC_VBUS	TWL4030_MADC_ADCIN8
96 #define TWL4030_MADC_VBKB	TWL4030_MADC_ADCIN9
97 #define TWL4030_MADC_ICHG	TWL4030_MADC_ADCIN10
98 #define TWL4030_MADC_VCHG	TWL4030_MADC_ADCIN11
99 #define TWL4030_MADC_VBAT	TWL4030_MADC_ADCIN12
100 
101 /* Step size and prescaler ratio */
102 #define TEMP_STEP_SIZE          147
103 #define TEMP_PSR_R              100
104 #define CURR_STEP_SIZE		147
105 #define CURR_PSR_R1		44
106 #define CURR_PSR_R2		88
107 
108 #define TWL4030_BCI_BCICTL1	0x23
109 #define TWL4030_BCI_CGAIN	0x020
110 #define TWL4030_BCI_MESBAT	(1 << 1)
111 #define TWL4030_BCI_TYPEN	(1 << 4)
112 #define TWL4030_BCI_ITHEN	(1 << 3)
113 
114 #define REG_BCICTL2             0x024
115 #define TWL4030_BCI_ITHSENS	0x007
116 
117 /* Register and bits for GPBR1 register */
118 #define TWL4030_REG_GPBR1		0x0c
119 #define TWL4030_GPBR1_MADC_HFCLK_EN	(1 << 7)
120 
121 #define TWL4030_USB_SEL_MADC_MCPC	(1<<3)
122 #define TWL4030_USB_CARKIT_ANA_CTRL	0xBB
123 
124 struct twl4030_madc_conversion_method {
125 	u8 sel;
126 	u8 avg;
127 	u8 rbase;
128 	u8 ctrl;
129 };
130 
131 /**
132  * struct twl4030_madc_request - madc request packet for channel conversion
133  * @channels:	16 bit bitmap for individual channels
134  * @do_avg:	sample the input channel for 4 consecutive cycles
135  * @method:	RT, SW1, SW2
136  * @type:	Polling or interrupt based method
137  * @active:	Flag if request is active
138  * @result_pending: Flag from irq handler, that result is ready
139  * @raw:	Return raw value, do not convert it
140  * @rbuf:	Result buffer
141  */
142 struct twl4030_madc_request {
143 	unsigned long channels;
144 	bool do_avg;
145 	u16 method;
146 	u16 type;
147 	bool active;
148 	bool result_pending;
149 	bool raw;
150 	int rbuf[TWL4030_MADC_MAX_CHANNELS];
151 };
152 
153 enum conversion_methods {
154 	TWL4030_MADC_RT,
155 	TWL4030_MADC_SW1,
156 	TWL4030_MADC_SW2,
157 	TWL4030_MADC_NUM_METHODS
158 };
159 
160 enum sample_type {
161 	TWL4030_MADC_WAIT,
162 	TWL4030_MADC_IRQ_ONESHOT,
163 	TWL4030_MADC_IRQ_REARM
164 };
165 
166 /**
167  * struct twl4030_madc_data - a container for madc info
168  * @dev:		Pointer to device structure for madc
169  * @lock:		Mutex protecting this data structure
170  * @regulator:		Pointer to bias regulator for madc
171  * @requests:		Array of request struct corresponding to SW1, SW2 and RT
172  * @use_second_irq:	IRQ selection (main or co-processor)
173  * @imr:		Interrupt mask register of MADC
174  * @isr:		Interrupt status register of MADC
175  */
176 struct twl4030_madc_data {
177 	struct device *dev;
178 	struct mutex lock;	/* mutex protecting this data structure */
179 	struct regulator *usb3v1;
180 	struct twl4030_madc_request requests[TWL4030_MADC_NUM_METHODS];
181 	bool use_second_irq;
182 	u8 imr;
183 	u8 isr;
184 };
185 
186 static int twl4030_madc_conversion(struct twl4030_madc_request *req);
187 
188 static int twl4030_madc_read(struct iio_dev *iio_dev,
189 			     const struct iio_chan_spec *chan,
190 			     int *val, int *val2, long mask)
191 {
192 	struct twl4030_madc_data *madc = iio_priv(iio_dev);
193 	struct twl4030_madc_request req;
194 	int ret;
195 
196 	req.method = madc->use_second_irq ? TWL4030_MADC_SW2 : TWL4030_MADC_SW1;
197 
198 	req.channels = BIT(chan->channel);
199 	req.active = false;
200 	req.type = TWL4030_MADC_WAIT;
201 	req.raw = !(mask == IIO_CHAN_INFO_PROCESSED);
202 	req.do_avg = (mask == IIO_CHAN_INFO_AVERAGE_RAW);
203 
204 	ret = twl4030_madc_conversion(&req);
205 	if (ret < 0)
206 		return ret;
207 
208 	*val = req.rbuf[chan->channel];
209 
210 	return IIO_VAL_INT;
211 }
212 
213 static const struct iio_info twl4030_madc_iio_info = {
214 	.read_raw = &twl4030_madc_read,
215 	.driver_module = THIS_MODULE,
216 };
217 
218 #define TWL4030_ADC_CHANNEL(_channel, _type, _name) {	\
219 	.type = _type,					\
220 	.channel = _channel,				\
221 	.info_mask_separate = BIT(IIO_CHAN_INFO_RAW) |  \
222 			      BIT(IIO_CHAN_INFO_AVERAGE_RAW) | \
223 			      BIT(IIO_CHAN_INFO_PROCESSED), \
224 	.datasheet_name = _name,			\
225 	.indexed = 1,					\
226 }
227 
228 static const struct iio_chan_spec twl4030_madc_iio_channels[] = {
229 	TWL4030_ADC_CHANNEL(0, IIO_VOLTAGE, "ADCIN0"),
230 	TWL4030_ADC_CHANNEL(1, IIO_TEMP, "ADCIN1"),
231 	TWL4030_ADC_CHANNEL(2, IIO_VOLTAGE, "ADCIN2"),
232 	TWL4030_ADC_CHANNEL(3, IIO_VOLTAGE, "ADCIN3"),
233 	TWL4030_ADC_CHANNEL(4, IIO_VOLTAGE, "ADCIN4"),
234 	TWL4030_ADC_CHANNEL(5, IIO_VOLTAGE, "ADCIN5"),
235 	TWL4030_ADC_CHANNEL(6, IIO_VOLTAGE, "ADCIN6"),
236 	TWL4030_ADC_CHANNEL(7, IIO_VOLTAGE, "ADCIN7"),
237 	TWL4030_ADC_CHANNEL(8, IIO_VOLTAGE, "ADCIN8"),
238 	TWL4030_ADC_CHANNEL(9, IIO_VOLTAGE, "ADCIN9"),
239 	TWL4030_ADC_CHANNEL(10, IIO_CURRENT, "ADCIN10"),
240 	TWL4030_ADC_CHANNEL(11, IIO_VOLTAGE, "ADCIN11"),
241 	TWL4030_ADC_CHANNEL(12, IIO_VOLTAGE, "ADCIN12"),
242 	TWL4030_ADC_CHANNEL(13, IIO_VOLTAGE, "ADCIN13"),
243 	TWL4030_ADC_CHANNEL(14, IIO_VOLTAGE, "ADCIN14"),
244 	TWL4030_ADC_CHANNEL(15, IIO_VOLTAGE, "ADCIN15"),
245 };
246 
247 static struct twl4030_madc_data *twl4030_madc;
248 
249 struct twl4030_prescale_divider_ratios {
250 	s16 numerator;
251 	s16 denominator;
252 };
253 
254 static const struct twl4030_prescale_divider_ratios
255 twl4030_divider_ratios[16] = {
256 	{1, 1},		/* CHANNEL 0 No Prescaler */
257 	{1, 1},		/* CHANNEL 1 No Prescaler */
258 	{6, 10},	/* CHANNEL 2 */
259 	{6, 10},	/* CHANNEL 3 */
260 	{6, 10},	/* CHANNEL 4 */
261 	{6, 10},	/* CHANNEL 5 */
262 	{6, 10},	/* CHANNEL 6 */
263 	{6, 10},	/* CHANNEL 7 */
264 	{3, 14},	/* CHANNEL 8 */
265 	{1, 3},		/* CHANNEL 9 */
266 	{1, 1},		/* CHANNEL 10 No Prescaler */
267 	{15, 100},	/* CHANNEL 11 */
268 	{1, 4},		/* CHANNEL 12 */
269 	{1, 1},		/* CHANNEL 13 Reserved channels */
270 	{1, 1},		/* CHANNEL 14 Reseved channels */
271 	{5, 11},	/* CHANNEL 15 */
272 };
273 
274 
275 /* Conversion table from -3 to 55 degrees Celcius */
276 static int twl4030_therm_tbl[] = {
277 	30800,	29500,	28300,	27100,
278 	26000,	24900,	23900,	22900,	22000,	21100,	20300,	19400,	18700,
279 	17900,	17200,	16500,	15900,	15300,	14700,	14100,	13600,	13100,
280 	12600,	12100,	11600,	11200,	10800,	10400,	10000,	9630,	9280,
281 	8950,	8620,	8310,	8020,	7730,	7460,	7200,	6950,	6710,
282 	6470,	6250,	6040,	5830,	5640,	5450,	5260,	5090,	4920,
283 	4760,	4600,	4450,	4310,	4170,	4040,	3910,	3790,	3670,
284 	3550
285 };
286 
287 /*
288  * Structure containing the registers
289  * of different conversion methods supported by MADC.
290  * Hardware or RT real time conversion request initiated by external host
291  * processor for RT Signal conversions.
292  * External host processors can also request for non RT conversions
293  * SW1 and SW2 software conversions also called asynchronous or GPC request.
294  */
295 static
296 const struct twl4030_madc_conversion_method twl4030_conversion_methods[] = {
297 	[TWL4030_MADC_RT] = {
298 			     .sel = TWL4030_MADC_RTSELECT_LSB,
299 			     .avg = TWL4030_MADC_RTAVERAGE_LSB,
300 			     .rbase = TWL4030_MADC_RTCH0_LSB,
301 			     },
302 	[TWL4030_MADC_SW1] = {
303 			      .sel = TWL4030_MADC_SW1SELECT_LSB,
304 			      .avg = TWL4030_MADC_SW1AVERAGE_LSB,
305 			      .rbase = TWL4030_MADC_GPCH0_LSB,
306 			      .ctrl = TWL4030_MADC_CTRL_SW1,
307 			      },
308 	[TWL4030_MADC_SW2] = {
309 			      .sel = TWL4030_MADC_SW2SELECT_LSB,
310 			      .avg = TWL4030_MADC_SW2AVERAGE_LSB,
311 			      .rbase = TWL4030_MADC_GPCH0_LSB,
312 			      .ctrl = TWL4030_MADC_CTRL_SW2,
313 			      },
314 };
315 
316 /**
317  * twl4030_madc_channel_raw_read() - Function to read a particular channel value
318  * @madc:	pointer to struct twl4030_madc_data
319  * @reg:	lsb of ADC Channel
320  *
321  * Return: 0 on success, an error code otherwise.
322  */
323 static int twl4030_madc_channel_raw_read(struct twl4030_madc_data *madc, u8 reg)
324 {
325 	u16 val;
326 	int ret;
327 	/*
328 	 * For each ADC channel, we have MSB and LSB register pair. MSB address
329 	 * is always LSB address+1. reg parameter is the address of LSB register
330 	 */
331 	ret = twl_i2c_read_u16(TWL4030_MODULE_MADC, &val, reg);
332 	if (ret) {
333 		dev_err(madc->dev, "unable to read register 0x%X\n", reg);
334 		return ret;
335 	}
336 
337 	return (int)(val >> 6);
338 }
339 
340 /*
341  * Return battery temperature in degrees Celsius
342  * Or < 0 on failure.
343  */
344 static int twl4030battery_temperature(int raw_volt)
345 {
346 	u8 val;
347 	int temp, curr, volt, res, ret;
348 
349 	volt = (raw_volt * TEMP_STEP_SIZE) / TEMP_PSR_R;
350 	/* Getting and calculating the supply current in micro amperes */
351 	ret = twl_i2c_read_u8(TWL_MODULE_MAIN_CHARGE, &val,
352 		REG_BCICTL2);
353 	if (ret < 0)
354 		return ret;
355 
356 	curr = ((val & TWL4030_BCI_ITHSENS) + 1) * 10;
357 	/* Getting and calculating the thermistor resistance in ohms */
358 	res = volt * 1000 / curr;
359 	/* calculating temperature */
360 	for (temp = 58; temp >= 0; temp--) {
361 		int actual = twl4030_therm_tbl[temp];
362 		if ((actual - res) >= 0)
363 			break;
364 	}
365 
366 	return temp + 1;
367 }
368 
369 static int twl4030battery_current(int raw_volt)
370 {
371 	int ret;
372 	u8 val;
373 
374 	ret = twl_i2c_read_u8(TWL_MODULE_MAIN_CHARGE, &val,
375 		TWL4030_BCI_BCICTL1);
376 	if (ret)
377 		return ret;
378 	if (val & TWL4030_BCI_CGAIN) /* slope of 0.44 mV/mA */
379 		return (raw_volt * CURR_STEP_SIZE) / CURR_PSR_R1;
380 	else /* slope of 0.88 mV/mA */
381 		return (raw_volt * CURR_STEP_SIZE) / CURR_PSR_R2;
382 }
383 
384 /*
385  * Function to read channel values
386  * @madc - pointer to twl4030_madc_data struct
387  * @reg_base - Base address of the first channel
388  * @Channels - 16 bit bitmap. If the bit is set, channel's value is read
389  * @buf - The channel values are stored here. if read fails error
390  * @raw - Return raw values without conversion
391  * value is stored
392  * Returns the number of successfully read channels.
393  */
394 static int twl4030_madc_read_channels(struct twl4030_madc_data *madc,
395 				      u8 reg_base, unsigned
396 				      long channels, int *buf,
397 				      bool raw)
398 {
399 	int count = 0;
400 	int i;
401 	u8 reg;
402 
403 	for_each_set_bit(i, &channels, TWL4030_MADC_MAX_CHANNELS) {
404 		reg = reg_base + (2 * i);
405 		buf[i] = twl4030_madc_channel_raw_read(madc, reg);
406 		if (buf[i] < 0) {
407 			dev_err(madc->dev, "Unable to read register 0x%X\n",
408 				reg);
409 			return buf[i];
410 		}
411 		if (raw) {
412 			count++;
413 			continue;
414 		}
415 		switch (i) {
416 		case 10:
417 			buf[i] = twl4030battery_current(buf[i]);
418 			if (buf[i] < 0) {
419 				dev_err(madc->dev, "err reading current\n");
420 				return buf[i];
421 			} else {
422 				count++;
423 				buf[i] = buf[i] - 750;
424 			}
425 			break;
426 		case 1:
427 			buf[i] = twl4030battery_temperature(buf[i]);
428 			if (buf[i] < 0) {
429 				dev_err(madc->dev, "err reading temperature\n");
430 				return buf[i];
431 			} else {
432 				buf[i] -= 3;
433 				count++;
434 			}
435 			break;
436 		default:
437 			count++;
438 			/* Analog Input (V) = conv_result * step_size / R
439 			 * conv_result = decimal value of 10-bit conversion
440 			 *		 result
441 			 * step size = 1.5 / (2 ^ 10 -1)
442 			 * R = Prescaler ratio for input channels.
443 			 * Result given in mV hence multiplied by 1000.
444 			 */
445 			buf[i] = (buf[i] * 3 * 1000 *
446 				 twl4030_divider_ratios[i].denominator)
447 				/ (2 * 1023 *
448 				twl4030_divider_ratios[i].numerator);
449 		}
450 	}
451 
452 	return count;
453 }
454 
455 /*
456  * Disables irq.
457  * @madc - pointer to twl4030_madc_data struct
458  * @id - irq number to be disabled
459  * can take one of TWL4030_MADC_RT, TWL4030_MADC_SW1, TWL4030_MADC_SW2
460  * corresponding to RT, SW1, SW2 conversion requests.
461  * Returns error if i2c read/write fails.
462  */
463 static int twl4030_madc_disable_irq(struct twl4030_madc_data *madc, u8 id)
464 {
465 	u8 val;
466 	int ret;
467 
468 	ret = twl_i2c_read_u8(TWL4030_MODULE_MADC, &val, madc->imr);
469 	if (ret) {
470 		dev_err(madc->dev, "unable to read imr register 0x%X\n",
471 			madc->imr);
472 		return ret;
473 	}
474 	val |= (1 << id);
475 	ret = twl_i2c_write_u8(TWL4030_MODULE_MADC, val, madc->imr);
476 	if (ret) {
477 		dev_err(madc->dev,
478 			"unable to write imr register 0x%X\n", madc->imr);
479 		return ret;
480 	}
481 
482 	return 0;
483 }
484 
485 static irqreturn_t twl4030_madc_threaded_irq_handler(int irq, void *_madc)
486 {
487 	struct twl4030_madc_data *madc = _madc;
488 	const struct twl4030_madc_conversion_method *method;
489 	u8 isr_val, imr_val;
490 	int i, len, ret;
491 	struct twl4030_madc_request *r;
492 
493 	mutex_lock(&madc->lock);
494 	ret = twl_i2c_read_u8(TWL4030_MODULE_MADC, &isr_val, madc->isr);
495 	if (ret) {
496 		dev_err(madc->dev, "unable to read isr register 0x%X\n",
497 			madc->isr);
498 		goto err_i2c;
499 	}
500 	ret = twl_i2c_read_u8(TWL4030_MODULE_MADC, &imr_val, madc->imr);
501 	if (ret) {
502 		dev_err(madc->dev, "unable to read imr register 0x%X\n",
503 			madc->imr);
504 		goto err_i2c;
505 	}
506 	isr_val &= ~imr_val;
507 	for (i = 0; i < TWL4030_MADC_NUM_METHODS; i++) {
508 		if (!(isr_val & (1 << i)))
509 			continue;
510 		ret = twl4030_madc_disable_irq(madc, i);
511 		if (ret < 0)
512 			dev_dbg(madc->dev, "Disable interrupt failed %d\n", i);
513 		madc->requests[i].result_pending = 1;
514 	}
515 	for (i = 0; i < TWL4030_MADC_NUM_METHODS; i++) {
516 		r = &madc->requests[i];
517 		/* No pending results for this method, move to next one */
518 		if (!r->result_pending)
519 			continue;
520 		method = &twl4030_conversion_methods[r->method];
521 		/* Read results */
522 		len = twl4030_madc_read_channels(madc, method->rbase,
523 						 r->channels, r->rbuf, r->raw);
524 		/* Free request */
525 		r->result_pending = 0;
526 		r->active = 0;
527 	}
528 	mutex_unlock(&madc->lock);
529 
530 	return IRQ_HANDLED;
531 
532 err_i2c:
533 	/*
534 	 * In case of error check whichever request is active
535 	 * and service the same.
536 	 */
537 	for (i = 0; i < TWL4030_MADC_NUM_METHODS; i++) {
538 		r = &madc->requests[i];
539 		if (r->active == 0)
540 			continue;
541 		method = &twl4030_conversion_methods[r->method];
542 		/* Read results */
543 		len = twl4030_madc_read_channels(madc, method->rbase,
544 						 r->channels, r->rbuf, r->raw);
545 		/* Free request */
546 		r->result_pending = 0;
547 		r->active = 0;
548 	}
549 	mutex_unlock(&madc->lock);
550 
551 	return IRQ_HANDLED;
552 }
553 
554 /*
555  * Function which enables the madc conversion
556  * by writing to the control register.
557  * @madc - pointer to twl4030_madc_data struct
558  * @conv_method - can be TWL4030_MADC_RT, TWL4030_MADC_SW2, TWL4030_MADC_SW1
559  * corresponding to RT SW1 or SW2 conversion methods.
560  * Returns 0 if succeeds else a negative error value
561  */
562 static int twl4030_madc_start_conversion(struct twl4030_madc_data *madc,
563 					 int conv_method)
564 {
565 	const struct twl4030_madc_conversion_method *method;
566 	int ret = 0;
567 
568 	if (conv_method != TWL4030_MADC_SW1 && conv_method != TWL4030_MADC_SW2)
569 		return -ENOTSUPP;
570 
571 	method = &twl4030_conversion_methods[conv_method];
572 	ret = twl_i2c_write_u8(TWL4030_MODULE_MADC, TWL4030_MADC_SW_START,
573 			       method->ctrl);
574 	if (ret) {
575 		dev_err(madc->dev, "unable to write ctrl register 0x%X\n",
576 			method->ctrl);
577 		return ret;
578 	}
579 
580 	return 0;
581 }
582 
583 /*
584  * Function that waits for conversion to be ready
585  * @madc - pointer to twl4030_madc_data struct
586  * @timeout_ms - timeout value in milliseconds
587  * @status_reg - ctrl register
588  * returns 0 if succeeds else a negative error value
589  */
590 static int twl4030_madc_wait_conversion_ready(struct twl4030_madc_data *madc,
591 					      unsigned int timeout_ms,
592 					      u8 status_reg)
593 {
594 	unsigned long timeout;
595 	int ret;
596 
597 	timeout = jiffies + msecs_to_jiffies(timeout_ms);
598 	do {
599 		u8 reg;
600 
601 		ret = twl_i2c_read_u8(TWL4030_MODULE_MADC, &reg, status_reg);
602 		if (ret) {
603 			dev_err(madc->dev,
604 				"unable to read status register 0x%X\n",
605 				status_reg);
606 			return ret;
607 		}
608 		if (!(reg & TWL4030_MADC_BUSY) && (reg & TWL4030_MADC_EOC_SW))
609 			return 0;
610 		usleep_range(500, 2000);
611 	} while (!time_after(jiffies, timeout));
612 	dev_err(madc->dev, "conversion timeout!\n");
613 
614 	return -EAGAIN;
615 }
616 
617 /*
618  * An exported function which can be called from other kernel drivers.
619  * @req twl4030_madc_request structure
620  * req->rbuf will be filled with read values of channels based on the
621  * channel index. If a particular channel reading fails there will
622  * be a negative error value in the corresponding array element.
623  * returns 0 if succeeds else error value
624  */
625 static int twl4030_madc_conversion(struct twl4030_madc_request *req)
626 {
627 	const struct twl4030_madc_conversion_method *method;
628 	int ret;
629 
630 	if (!req || !twl4030_madc)
631 		return -EINVAL;
632 
633 	mutex_lock(&twl4030_madc->lock);
634 	if (req->method < TWL4030_MADC_RT || req->method > TWL4030_MADC_SW2) {
635 		ret = -EINVAL;
636 		goto out;
637 	}
638 	/* Do we have a conversion request ongoing */
639 	if (twl4030_madc->requests[req->method].active) {
640 		ret = -EBUSY;
641 		goto out;
642 	}
643 	method = &twl4030_conversion_methods[req->method];
644 	/* Select channels to be converted */
645 	ret = twl_i2c_write_u16(TWL4030_MODULE_MADC, req->channels, method->sel);
646 	if (ret) {
647 		dev_err(twl4030_madc->dev,
648 			"unable to write sel register 0x%X\n", method->sel);
649 		goto out;
650 	}
651 	/* Select averaging for all channels if do_avg is set */
652 	if (req->do_avg) {
653 		ret = twl_i2c_write_u16(TWL4030_MODULE_MADC, req->channels,
654 				       method->avg);
655 		if (ret) {
656 			dev_err(twl4030_madc->dev,
657 				"unable to write avg register 0x%X\n",
658 				method->avg);
659 			goto out;
660 		}
661 	}
662 	/* With RT method we should not be here anymore */
663 	if (req->method == TWL4030_MADC_RT) {
664 		ret = -EINVAL;
665 		goto out;
666 	}
667 	ret = twl4030_madc_start_conversion(twl4030_madc, req->method);
668 	if (ret < 0)
669 		goto out;
670 	twl4030_madc->requests[req->method].active = 1;
671 	/* Wait until conversion is ready (ctrl register returns EOC) */
672 	ret = twl4030_madc_wait_conversion_ready(twl4030_madc, 5, method->ctrl);
673 	if (ret) {
674 		twl4030_madc->requests[req->method].active = 0;
675 		goto out;
676 	}
677 	ret = twl4030_madc_read_channels(twl4030_madc, method->rbase,
678 					 req->channels, req->rbuf, req->raw);
679 	twl4030_madc->requests[req->method].active = 0;
680 
681 out:
682 	mutex_unlock(&twl4030_madc->lock);
683 
684 	return ret;
685 }
686 
687 /**
688  * twl4030_madc_set_current_generator() - setup bias current
689  *
690  * @madc:	pointer to twl4030_madc_data struct
691  * @chan:	can be one of the two values:
692  *		0 - Enables bias current for main battery type reading
693  *		1 - Enables bias current for main battery temperature sensing
694  * @on:		enable or disable chan.
695  *
696  * Function to enable or disable bias current for
697  * main battery type reading or temperature sensing
698  */
699 static int twl4030_madc_set_current_generator(struct twl4030_madc_data *madc,
700 					      int chan, int on)
701 {
702 	int ret;
703 	int regmask;
704 	u8 regval;
705 
706 	ret = twl_i2c_read_u8(TWL_MODULE_MAIN_CHARGE,
707 			      &regval, TWL4030_BCI_BCICTL1);
708 	if (ret) {
709 		dev_err(madc->dev, "unable to read BCICTL1 reg 0x%X",
710 			TWL4030_BCI_BCICTL1);
711 		return ret;
712 	}
713 
714 	regmask = chan ? TWL4030_BCI_ITHEN : TWL4030_BCI_TYPEN;
715 	if (on)
716 		regval |= regmask;
717 	else
718 		regval &= ~regmask;
719 
720 	ret = twl_i2c_write_u8(TWL_MODULE_MAIN_CHARGE,
721 			       regval, TWL4030_BCI_BCICTL1);
722 	if (ret) {
723 		dev_err(madc->dev, "unable to write BCICTL1 reg 0x%X\n",
724 			TWL4030_BCI_BCICTL1);
725 		return ret;
726 	}
727 
728 	return 0;
729 }
730 
731 /*
732  * Function that sets MADC software power on bit to enable MADC
733  * @madc - pointer to twl4030_madc_data struct
734  * @on - Enable or disable MADC software power on bit.
735  * returns error if i2c read/write fails else 0
736  */
737 static int twl4030_madc_set_power(struct twl4030_madc_data *madc, int on)
738 {
739 	u8 regval;
740 	int ret;
741 
742 	ret = twl_i2c_read_u8(TWL_MODULE_MAIN_CHARGE,
743 			      &regval, TWL4030_MADC_CTRL1);
744 	if (ret) {
745 		dev_err(madc->dev, "unable to read madc ctrl1 reg 0x%X\n",
746 			TWL4030_MADC_CTRL1);
747 		return ret;
748 	}
749 	if (on)
750 		regval |= TWL4030_MADC_MADCON;
751 	else
752 		regval &= ~TWL4030_MADC_MADCON;
753 	ret = twl_i2c_write_u8(TWL4030_MODULE_MADC, regval, TWL4030_MADC_CTRL1);
754 	if (ret) {
755 		dev_err(madc->dev, "unable to write madc ctrl1 reg 0x%X\n",
756 			TWL4030_MADC_CTRL1);
757 		return ret;
758 	}
759 
760 	return 0;
761 }
762 
763 /*
764  * Initialize MADC and request for threaded irq
765  */
766 static int twl4030_madc_probe(struct platform_device *pdev)
767 {
768 	struct twl4030_madc_data *madc;
769 	struct twl4030_madc_platform_data *pdata = dev_get_platdata(&pdev->dev);
770 	struct device_node *np = pdev->dev.of_node;
771 	int irq, ret;
772 	u8 regval;
773 	struct iio_dev *iio_dev = NULL;
774 
775 	if (!pdata && !np) {
776 		dev_err(&pdev->dev, "neither platform data nor Device Tree node available\n");
777 		return -EINVAL;
778 	}
779 
780 	iio_dev = devm_iio_device_alloc(&pdev->dev, sizeof(*madc));
781 	if (!iio_dev) {
782 		dev_err(&pdev->dev, "failed allocating iio device\n");
783 		return -ENOMEM;
784 	}
785 
786 	madc = iio_priv(iio_dev);
787 	madc->dev = &pdev->dev;
788 
789 	iio_dev->name = dev_name(&pdev->dev);
790 	iio_dev->dev.parent = &pdev->dev;
791 	iio_dev->dev.of_node = pdev->dev.of_node;
792 	iio_dev->info = &twl4030_madc_iio_info;
793 	iio_dev->modes = INDIO_DIRECT_MODE;
794 	iio_dev->channels = twl4030_madc_iio_channels;
795 	iio_dev->num_channels = ARRAY_SIZE(twl4030_madc_iio_channels);
796 
797 	/*
798 	 * Phoenix provides 2 interrupt lines. The first one is connected to
799 	 * the OMAP. The other one can be connected to the other processor such
800 	 * as modem. Hence two separate ISR and IMR registers.
801 	 */
802 	if (pdata)
803 		madc->use_second_irq = (pdata->irq_line != 1);
804 	else
805 		madc->use_second_irq = of_property_read_bool(np,
806 				       "ti,system-uses-second-madc-irq");
807 
808 	madc->imr = madc->use_second_irq ? TWL4030_MADC_IMR2 :
809 					   TWL4030_MADC_IMR1;
810 	madc->isr = madc->use_second_irq ? TWL4030_MADC_ISR2 :
811 					   TWL4030_MADC_ISR1;
812 
813 	ret = twl4030_madc_set_power(madc, 1);
814 	if (ret < 0)
815 		return ret;
816 	ret = twl4030_madc_set_current_generator(madc, 0, 1);
817 	if (ret < 0)
818 		goto err_current_generator;
819 
820 	ret = twl_i2c_read_u8(TWL_MODULE_MAIN_CHARGE,
821 			      &regval, TWL4030_BCI_BCICTL1);
822 	if (ret) {
823 		dev_err(&pdev->dev, "unable to read reg BCI CTL1 0x%X\n",
824 			TWL4030_BCI_BCICTL1);
825 		goto err_i2c;
826 	}
827 	regval |= TWL4030_BCI_MESBAT;
828 	ret = twl_i2c_write_u8(TWL_MODULE_MAIN_CHARGE,
829 			       regval, TWL4030_BCI_BCICTL1);
830 	if (ret) {
831 		dev_err(&pdev->dev, "unable to write reg BCI Ctl1 0x%X\n",
832 			TWL4030_BCI_BCICTL1);
833 		goto err_i2c;
834 	}
835 
836 	/* Check that MADC clock is on */
837 	ret = twl_i2c_read_u8(TWL4030_MODULE_INTBR, &regval, TWL4030_REG_GPBR1);
838 	if (ret) {
839 		dev_err(&pdev->dev, "unable to read reg GPBR1 0x%X\n",
840 				TWL4030_REG_GPBR1);
841 		goto err_i2c;
842 	}
843 
844 	/* If MADC clk is not on, turn it on */
845 	if (!(regval & TWL4030_GPBR1_MADC_HFCLK_EN)) {
846 		dev_info(&pdev->dev, "clk disabled, enabling\n");
847 		regval |= TWL4030_GPBR1_MADC_HFCLK_EN;
848 		ret = twl_i2c_write_u8(TWL4030_MODULE_INTBR, regval,
849 				       TWL4030_REG_GPBR1);
850 		if (ret) {
851 			dev_err(&pdev->dev, "unable to write reg GPBR1 0x%X\n",
852 					TWL4030_REG_GPBR1);
853 			goto err_i2c;
854 		}
855 	}
856 
857 	platform_set_drvdata(pdev, iio_dev);
858 	mutex_init(&madc->lock);
859 
860 	irq = platform_get_irq(pdev, 0);
861 	ret = devm_request_threaded_irq(&pdev->dev, irq, NULL,
862 				   twl4030_madc_threaded_irq_handler,
863 				   IRQF_TRIGGER_RISING | IRQF_ONESHOT,
864 				   "twl4030_madc", madc);
865 	if (ret) {
866 		dev_err(&pdev->dev, "could not request irq\n");
867 		goto err_i2c;
868 	}
869 	twl4030_madc = madc;
870 
871 	/* Configure MADC[3:6] */
872 	ret = twl_i2c_read_u8(TWL_MODULE_USB, &regval,
873 			TWL4030_USB_CARKIT_ANA_CTRL);
874 	if (ret) {
875 		dev_err(&pdev->dev, "unable to read reg CARKIT_ANA_CTRL  0x%X\n",
876 				TWL4030_USB_CARKIT_ANA_CTRL);
877 		goto err_i2c;
878 	}
879 	regval |= TWL4030_USB_SEL_MADC_MCPC;
880 	ret = twl_i2c_write_u8(TWL_MODULE_USB, regval,
881 				 TWL4030_USB_CARKIT_ANA_CTRL);
882 	if (ret) {
883 		dev_err(&pdev->dev, "unable to write reg CARKIT_ANA_CTRL 0x%X\n",
884 				TWL4030_USB_CARKIT_ANA_CTRL);
885 		goto err_i2c;
886 	}
887 
888 	/* Enable 3v1 bias regulator for MADC[3:6] */
889 	madc->usb3v1 = devm_regulator_get(madc->dev, "vusb3v1");
890 	if (IS_ERR(madc->usb3v1)) {
891 		ret = -ENODEV;
892 		goto err_i2c;
893 	}
894 
895 	ret = regulator_enable(madc->usb3v1);
896 	if (ret) {
897 		dev_err(madc->dev, "could not enable 3v1 bias regulator\n");
898 		goto err_i2c;
899 	}
900 
901 	ret = iio_device_register(iio_dev);
902 	if (ret) {
903 		dev_err(&pdev->dev, "could not register iio device\n");
904 		goto err_usb3v1;
905 	}
906 
907 	return 0;
908 
909 err_usb3v1:
910 	regulator_disable(madc->usb3v1);
911 err_i2c:
912 	twl4030_madc_set_current_generator(madc, 0, 0);
913 err_current_generator:
914 	twl4030_madc_set_power(madc, 0);
915 	return ret;
916 }
917 
918 static int twl4030_madc_remove(struct platform_device *pdev)
919 {
920 	struct iio_dev *iio_dev = platform_get_drvdata(pdev);
921 	struct twl4030_madc_data *madc = iio_priv(iio_dev);
922 
923 	iio_device_unregister(iio_dev);
924 
925 	twl4030_madc_set_current_generator(madc, 0, 0);
926 	twl4030_madc_set_power(madc, 0);
927 
928 	regulator_disable(madc->usb3v1);
929 
930 	return 0;
931 }
932 
933 #ifdef CONFIG_OF
934 static const struct of_device_id twl_madc_of_match[] = {
935 	{ .compatible = "ti,twl4030-madc", },
936 	{ },
937 };
938 MODULE_DEVICE_TABLE(of, twl_madc_of_match);
939 #endif
940 
941 static struct platform_driver twl4030_madc_driver = {
942 	.probe = twl4030_madc_probe,
943 	.remove = twl4030_madc_remove,
944 	.driver = {
945 		   .name = "twl4030_madc",
946 		   .of_match_table = of_match_ptr(twl_madc_of_match),
947 	},
948 };
949 
950 module_platform_driver(twl4030_madc_driver);
951 
952 MODULE_DESCRIPTION("TWL4030 ADC driver");
953 MODULE_LICENSE("GPL");
954 MODULE_AUTHOR("J Keerthy");
955 MODULE_ALIAS("platform:twl4030_madc");
956