xref: /OK3568_Linux_fs/kernel/drivers/iio/adc/ltc2471.c (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1*4882a593Smuzhiyun // SPDX-License-Identifier: GPL-2.0-only
2*4882a593Smuzhiyun /*
3*4882a593Smuzhiyun  * Driver for Linear Technology LTC2471 and LTC2473 voltage monitors
4*4882a593Smuzhiyun  * The LTC2473 is identical to the 2471, but reports a differential signal.
5*4882a593Smuzhiyun  *
6*4882a593Smuzhiyun  * Copyright (C) 2017 Topic Embedded Products
7*4882a593Smuzhiyun  * Author: Mike Looijmans <mike.looijmans@topic.nl>
8*4882a593Smuzhiyun  */
9*4882a593Smuzhiyun 
10*4882a593Smuzhiyun #include <linux/err.h>
11*4882a593Smuzhiyun #include <linux/i2c.h>
12*4882a593Smuzhiyun #include <linux/kernel.h>
13*4882a593Smuzhiyun #include <linux/module.h>
14*4882a593Smuzhiyun #include <linux/iio/iio.h>
15*4882a593Smuzhiyun #include <linux/iio/sysfs.h>
16*4882a593Smuzhiyun 
17*4882a593Smuzhiyun enum ltc2471_chips {
18*4882a593Smuzhiyun 	ltc2471,
19*4882a593Smuzhiyun 	ltc2473,
20*4882a593Smuzhiyun };
21*4882a593Smuzhiyun 
22*4882a593Smuzhiyun struct ltc2471_data {
23*4882a593Smuzhiyun 	struct i2c_client *client;
24*4882a593Smuzhiyun };
25*4882a593Smuzhiyun 
26*4882a593Smuzhiyun /* Reference voltage is 1.25V */
27*4882a593Smuzhiyun #define LTC2471_VREF 1250
28*4882a593Smuzhiyun 
29*4882a593Smuzhiyun /* Read two bytes from the I2C bus to obtain the ADC result */
ltc2471_get_value(struct i2c_client * client)30*4882a593Smuzhiyun static int ltc2471_get_value(struct i2c_client *client)
31*4882a593Smuzhiyun {
32*4882a593Smuzhiyun 	int ret;
33*4882a593Smuzhiyun 	__be16 buf;
34*4882a593Smuzhiyun 
35*4882a593Smuzhiyun 	ret = i2c_master_recv(client, (char *)&buf, sizeof(buf));
36*4882a593Smuzhiyun 	if (ret < 0)
37*4882a593Smuzhiyun 		return ret;
38*4882a593Smuzhiyun 	if (ret != sizeof(buf))
39*4882a593Smuzhiyun 		return -EIO;
40*4882a593Smuzhiyun 
41*4882a593Smuzhiyun 	/* MSB first */
42*4882a593Smuzhiyun 	return be16_to_cpu(buf);
43*4882a593Smuzhiyun }
44*4882a593Smuzhiyun 
ltc2471_read_raw(struct iio_dev * indio_dev,struct iio_chan_spec const * chan,int * val,int * val2,long info)45*4882a593Smuzhiyun static int ltc2471_read_raw(struct iio_dev *indio_dev,
46*4882a593Smuzhiyun 			    struct iio_chan_spec const *chan,
47*4882a593Smuzhiyun 			    int *val, int *val2, long info)
48*4882a593Smuzhiyun {
49*4882a593Smuzhiyun 	struct ltc2471_data *data = iio_priv(indio_dev);
50*4882a593Smuzhiyun 	int ret;
51*4882a593Smuzhiyun 
52*4882a593Smuzhiyun 	switch (info) {
53*4882a593Smuzhiyun 	case IIO_CHAN_INFO_RAW:
54*4882a593Smuzhiyun 		ret = ltc2471_get_value(data->client);
55*4882a593Smuzhiyun 		if (ret < 0)
56*4882a593Smuzhiyun 			return ret;
57*4882a593Smuzhiyun 		*val = ret;
58*4882a593Smuzhiyun 		return IIO_VAL_INT;
59*4882a593Smuzhiyun 
60*4882a593Smuzhiyun 	case IIO_CHAN_INFO_SCALE:
61*4882a593Smuzhiyun 		if (chan->differential)
62*4882a593Smuzhiyun 			/* Output ranges from -VREF to +VREF */
63*4882a593Smuzhiyun 			*val = 2 * LTC2471_VREF;
64*4882a593Smuzhiyun 		else
65*4882a593Smuzhiyun 			/* Output ranges from 0 to VREF */
66*4882a593Smuzhiyun 			*val = LTC2471_VREF;
67*4882a593Smuzhiyun 		*val2 = 16;	/* 16 data bits */
68*4882a593Smuzhiyun 		return IIO_VAL_FRACTIONAL_LOG2;
69*4882a593Smuzhiyun 
70*4882a593Smuzhiyun 	case IIO_CHAN_INFO_OFFSET:
71*4882a593Smuzhiyun 		/* Only differential chip has this property */
72*4882a593Smuzhiyun 		*val = -LTC2471_VREF;
73*4882a593Smuzhiyun 		return IIO_VAL_INT;
74*4882a593Smuzhiyun 
75*4882a593Smuzhiyun 	default:
76*4882a593Smuzhiyun 		return -EINVAL;
77*4882a593Smuzhiyun 	}
78*4882a593Smuzhiyun }
79*4882a593Smuzhiyun 
80*4882a593Smuzhiyun static const struct iio_chan_spec ltc2471_channel[] = {
81*4882a593Smuzhiyun 	{
82*4882a593Smuzhiyun 		.type = IIO_VOLTAGE,
83*4882a593Smuzhiyun 		.info_mask_separate = BIT(IIO_CHAN_INFO_RAW),
84*4882a593Smuzhiyun 		.info_mask_shared_by_type = BIT(IIO_CHAN_INFO_SCALE),
85*4882a593Smuzhiyun 	},
86*4882a593Smuzhiyun };
87*4882a593Smuzhiyun 
88*4882a593Smuzhiyun static const struct iio_chan_spec ltc2473_channel[] = {
89*4882a593Smuzhiyun 	{
90*4882a593Smuzhiyun 		.type = IIO_VOLTAGE,
91*4882a593Smuzhiyun 		.info_mask_separate = BIT(IIO_CHAN_INFO_RAW),
92*4882a593Smuzhiyun 		.info_mask_shared_by_type = BIT(IIO_CHAN_INFO_SCALE) |
93*4882a593Smuzhiyun 					    BIT(IIO_CHAN_INFO_OFFSET),
94*4882a593Smuzhiyun 		.differential = 1,
95*4882a593Smuzhiyun 	},
96*4882a593Smuzhiyun };
97*4882a593Smuzhiyun 
98*4882a593Smuzhiyun static const struct iio_info ltc2471_info = {
99*4882a593Smuzhiyun 	.read_raw = ltc2471_read_raw,
100*4882a593Smuzhiyun };
101*4882a593Smuzhiyun 
ltc2471_i2c_probe(struct i2c_client * client,const struct i2c_device_id * id)102*4882a593Smuzhiyun static int ltc2471_i2c_probe(struct i2c_client *client,
103*4882a593Smuzhiyun 			     const struct i2c_device_id *id)
104*4882a593Smuzhiyun {
105*4882a593Smuzhiyun 	struct iio_dev *indio_dev;
106*4882a593Smuzhiyun 	struct ltc2471_data *data;
107*4882a593Smuzhiyun 	int ret;
108*4882a593Smuzhiyun 
109*4882a593Smuzhiyun 	if (!i2c_check_functionality(client->adapter, I2C_FUNC_I2C))
110*4882a593Smuzhiyun 		return -EOPNOTSUPP;
111*4882a593Smuzhiyun 
112*4882a593Smuzhiyun 	indio_dev = devm_iio_device_alloc(&client->dev, sizeof(*data));
113*4882a593Smuzhiyun 	if (!indio_dev)
114*4882a593Smuzhiyun 		return -ENOMEM;
115*4882a593Smuzhiyun 
116*4882a593Smuzhiyun 	data = iio_priv(indio_dev);
117*4882a593Smuzhiyun 	data->client = client;
118*4882a593Smuzhiyun 
119*4882a593Smuzhiyun 	indio_dev->name = id->name;
120*4882a593Smuzhiyun 	indio_dev->info = &ltc2471_info;
121*4882a593Smuzhiyun 	indio_dev->modes = INDIO_DIRECT_MODE;
122*4882a593Smuzhiyun 	if (id->driver_data == ltc2473)
123*4882a593Smuzhiyun 		indio_dev->channels = ltc2473_channel;
124*4882a593Smuzhiyun 	else
125*4882a593Smuzhiyun 		indio_dev->channels = ltc2471_channel;
126*4882a593Smuzhiyun 	indio_dev->num_channels = 1;
127*4882a593Smuzhiyun 
128*4882a593Smuzhiyun 	/* Trigger once to start conversion and check if chip is there */
129*4882a593Smuzhiyun 	ret = ltc2471_get_value(client);
130*4882a593Smuzhiyun 	if (ret < 0) {
131*4882a593Smuzhiyun 		dev_err(&client->dev, "Cannot read from device.\n");
132*4882a593Smuzhiyun 		return ret;
133*4882a593Smuzhiyun 	}
134*4882a593Smuzhiyun 
135*4882a593Smuzhiyun 	return devm_iio_device_register(&client->dev, indio_dev);
136*4882a593Smuzhiyun }
137*4882a593Smuzhiyun 
138*4882a593Smuzhiyun static const struct i2c_device_id ltc2471_i2c_id[] = {
139*4882a593Smuzhiyun 	{ "ltc2471", ltc2471 },
140*4882a593Smuzhiyun 	{ "ltc2473", ltc2473 },
141*4882a593Smuzhiyun 	{}
142*4882a593Smuzhiyun };
143*4882a593Smuzhiyun MODULE_DEVICE_TABLE(i2c, ltc2471_i2c_id);
144*4882a593Smuzhiyun 
145*4882a593Smuzhiyun static struct i2c_driver ltc2471_i2c_driver = {
146*4882a593Smuzhiyun 	.driver = {
147*4882a593Smuzhiyun 		.name = "ltc2471",
148*4882a593Smuzhiyun 	},
149*4882a593Smuzhiyun 	.probe    = ltc2471_i2c_probe,
150*4882a593Smuzhiyun 	.id_table = ltc2471_i2c_id,
151*4882a593Smuzhiyun };
152*4882a593Smuzhiyun 
153*4882a593Smuzhiyun module_i2c_driver(ltc2471_i2c_driver);
154*4882a593Smuzhiyun 
155*4882a593Smuzhiyun MODULE_DESCRIPTION("LTC2471/LTC2473 ADC driver");
156*4882a593Smuzhiyun MODULE_AUTHOR("Topic Embedded Products");
157*4882a593Smuzhiyun MODULE_LICENSE("GPL v2");
158