2
* ads1015.c - lm_sensors driver for ads1015 12-bit 4-input ADC
4
* Dirk Eibach, Guntermann & Drunck GmbH <eibach@gdsys.de>
6
* Based on the ads7828 driver by Steve Hardy.
8
* Datasheet available at: http://focus.ti.com/lit/ds/symlink/ads1015.pdf
10
* This program is free software; you can redistribute it and/or modify
11
* it under the terms of the GNU General Public License as published by
12
* the Free Software Foundation; either version 2 of the License, or
13
* (at your option) any later version.
15
* This program is distributed in the hope that it will be useful,
16
* but WITHOUT ANY WARRANTY; without even the implied warranty of
17
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18
* GNU General Public License for more details.
20
* You should have received a copy of the GNU General Public License
21
* along with this program; if not, write to the Free Software
22
* Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
25
#include <linux/module.h>
26
#include <linux/init.h>
27
#include <linux/slab.h>
28
#include <linux/delay.h>
29
#include <linux/i2c.h>
30
#include <linux/hwmon.h>
31
#include <linux/hwmon-sysfs.h>
32
#include <linux/err.h>
33
#include <linux/mutex.h>
36
#include <linux/i2c/ads1015.h>
38
/* ADS1015 registers */
40
ADS1015_CONVERSION = 0,
44
/* PGA fullscale voltages in mV */
45
static const unsigned int fullscale_table[8] = {
46
6144, 4096, 2048, 1024, 512, 256, 256, 256 };
48
/* Data rates in samples per second */
49
static const unsigned int data_rate_table[8] = {
50
128, 250, 490, 920, 1600, 2400, 3300, 3300 };
52
#define ADS1015_DEFAULT_CHANNELS 0xff
53
#define ADS1015_DEFAULT_PGA 2
54
#define ADS1015_DEFAULT_DATA_RATE 4
57
struct device *hwmon_dev;
58
struct mutex update_lock; /* mutex protect updates */
59
struct ads1015_channel_data channel_data[ADS1015_CHANNELS];
62
static s32 ads1015_read_reg(struct i2c_client *client, unsigned int reg)
64
s32 data = i2c_smbus_read_word_data(client, reg);
66
return (data < 0) ? data : swab16(data);
69
static s32 ads1015_write_reg(struct i2c_client *client, unsigned int reg,
72
return i2c_smbus_write_word_data(client, reg, swab16(val));
75
static int ads1015_read_value(struct i2c_client *client, unsigned int channel,
80
struct ads1015_data *data = i2c_get_clientdata(client);
81
unsigned int pga = data->channel_data[channel].pga;
83
unsigned int data_rate = data->channel_data[channel].data_rate;
84
unsigned int conversion_time_ms;
87
mutex_lock(&data->update_lock);
89
/* get channel parameters */
90
res = ads1015_read_reg(client, ADS1015_CONFIG);
94
fullscale = fullscale_table[pga];
95
conversion_time_ms = DIV_ROUND_UP(1000, data_rate_table[data_rate]);
97
/* setup and start single conversion */
99
config |= (1 << 15) | (1 << 8);
100
config |= (channel & 0x0007) << 12;
101
config |= (pga & 0x0007) << 9;
102
config |= (data_rate & 0x0007) << 5;
104
res = ads1015_write_reg(client, ADS1015_CONFIG, config);
108
/* wait until conversion finished */
109
msleep(conversion_time_ms);
110
res = ads1015_read_reg(client, ADS1015_CONFIG);
114
if (!(config & (1 << 15))) {
115
/* conversion not finished in time */
120
res = ads1015_read_reg(client, ADS1015_CONVERSION);
125
mutex_unlock(&data->update_lock);
127
*value = DIV_ROUND_CLOSEST(conversion * fullscale, 0x7ff0);
132
mutex_unlock(&data->update_lock);
136
/* sysfs callback function */
137
static ssize_t show_in(struct device *dev, struct device_attribute *da,
140
struct sensor_device_attribute *attr = to_sensor_dev_attr(da);
141
struct i2c_client *client = to_i2c_client(dev);
145
res = ads1015_read_value(client, attr->index, &in);
147
return (res < 0) ? res : sprintf(buf, "%d\n", in);
150
static const struct sensor_device_attribute ads1015_in[] = {
151
SENSOR_ATTR(in0_input, S_IRUGO, show_in, NULL, 0),
152
SENSOR_ATTR(in1_input, S_IRUGO, show_in, NULL, 1),
153
SENSOR_ATTR(in2_input, S_IRUGO, show_in, NULL, 2),
154
SENSOR_ATTR(in3_input, S_IRUGO, show_in, NULL, 3),
155
SENSOR_ATTR(in4_input, S_IRUGO, show_in, NULL, 4),
156
SENSOR_ATTR(in5_input, S_IRUGO, show_in, NULL, 5),
157
SENSOR_ATTR(in6_input, S_IRUGO, show_in, NULL, 6),
158
SENSOR_ATTR(in7_input, S_IRUGO, show_in, NULL, 7),
165
static int ads1015_remove(struct i2c_client *client)
167
struct ads1015_data *data = i2c_get_clientdata(client);
170
hwmon_device_unregister(data->hwmon_dev);
171
for (k = 0; k < ADS1015_CHANNELS; ++k)
172
device_remove_file(&client->dev, &ads1015_in[k].dev_attr);
178
static int ads1015_get_channels_config_of(struct i2c_client *client)
180
struct ads1015_data *data = i2c_get_clientdata(client);
181
struct device_node *node;
183
if (!client->dev.of_node
184
|| !of_get_next_child(client->dev.of_node, NULL))
187
for_each_child_of_node(client->dev.of_node, node) {
188
const __be32 *property;
190
unsigned int channel;
191
unsigned int pga = ADS1015_DEFAULT_PGA;
192
unsigned int data_rate = ADS1015_DEFAULT_DATA_RATE;
194
property = of_get_property(node, "reg", &len);
195
if (!property || len != sizeof(int)) {
196
dev_err(&client->dev, "invalid reg on %s\n",
201
channel = be32_to_cpup(property);
202
if (channel > ADS1015_CHANNELS) {
203
dev_err(&client->dev,
204
"invalid channel index %d on %s\n",
205
channel, node->full_name);
209
property = of_get_property(node, "ti,gain", &len);
210
if (property && len == sizeof(int)) {
211
pga = be32_to_cpup(property);
213
dev_err(&client->dev,
214
"invalid gain on %s\n",
219
property = of_get_property(node, "ti,datarate", &len);
220
if (property && len == sizeof(int)) {
221
data_rate = be32_to_cpup(property);
223
dev_err(&client->dev,
224
"invalid data_rate on %s\n",
229
data->channel_data[channel].enabled = true;
230
data->channel_data[channel].pga = pga;
231
data->channel_data[channel].data_rate = data_rate;
238
static void ads1015_get_channels_config(struct i2c_client *client)
241
struct ads1015_data *data = i2c_get_clientdata(client);
242
struct ads1015_platform_data *pdata = dev_get_platdata(&client->dev);
244
/* prefer platform data */
246
memcpy(data->channel_data, pdata->channel_data,
247
sizeof(data->channel_data));
252
if (!ads1015_get_channels_config_of(client))
256
/* fallback on default configuration */
257
for (k = 0; k < ADS1015_CHANNELS; ++k) {
258
data->channel_data[k].enabled = true;
259
data->channel_data[k].pga = ADS1015_DEFAULT_PGA;
260
data->channel_data[k].data_rate = ADS1015_DEFAULT_DATA_RATE;
264
static int ads1015_probe(struct i2c_client *client,
265
const struct i2c_device_id *id)
267
struct ads1015_data *data;
271
data = kzalloc(sizeof(struct ads1015_data), GFP_KERNEL);
277
i2c_set_clientdata(client, data);
278
mutex_init(&data->update_lock);
280
/* build sysfs attribute group */
281
ads1015_get_channels_config(client);
282
for (k = 0; k < ADS1015_CHANNELS; ++k) {
283
if (!data->channel_data[k].enabled)
285
err = device_create_file(&client->dev, &ads1015_in[k].dev_attr);
290
data->hwmon_dev = hwmon_device_register(&client->dev);
291
if (IS_ERR(data->hwmon_dev)) {
292
err = PTR_ERR(data->hwmon_dev);
299
for (k = 0; k < ADS1015_CHANNELS; ++k)
300
device_remove_file(&client->dev, &ads1015_in[k].dev_attr);
307
static const struct i2c_device_id ads1015_id[] = {
311
MODULE_DEVICE_TABLE(i2c, ads1015_id);
313
static struct i2c_driver ads1015_driver = {
317
.probe = ads1015_probe,
318
.remove = ads1015_remove,
319
.id_table = ads1015_id,
322
static int __init sensors_ads1015_init(void)
324
return i2c_add_driver(&ads1015_driver);
327
static void __exit sensors_ads1015_exit(void)
329
i2c_del_driver(&ads1015_driver);
332
MODULE_AUTHOR("Dirk Eibach <eibach@gdsys.de>");
333
MODULE_DESCRIPTION("ADS1015 driver");
334
MODULE_LICENSE("GPL");
336
module_init(sensors_ads1015_init);
337
module_exit(sensors_ads1015_exit);