]>
Commit | Line | Data |
---|---|---|
1da177e4 | 1 | /* |
19f2c059 GR |
2 | * ds1621.c - Part of lm_sensors, Linux kernel modules for hardware |
3 | * monitoring | |
4 | * Christian W. Zuckschwerdt <zany@triq.net> 2000-11-23 | |
5 | * based on lm75.c by Frodo Looijaard <frodol@dds.nl> | |
6 | * Ported to Linux 2.6 by Aurelien Jarno <aurelien@aurel32.net> with | |
7 | * the help of Jean Delvare <khali@linux-fr.org> | |
8 | * | |
cd6c8a42 RC |
9 | * The DS1621 device is a digital temperature/thermometer with 9-bit |
10 | * resolution, a thermal alarm output (Tout), and user-defined minimum | |
11 | * and maximum temperature thresholds (TH and TL). | |
12 | * | |
260f81ff RC |
13 | * The DS1625, DS1631, DS1721, and DS1731 are pin compatible with the DS1621 |
14 | * and similar in operation, with slight variations as noted in the device | |
cd6c8a42 RC |
15 | * datasheets (please refer to www.maximintegrated.com for specific |
16 | * device information). | |
17 | * | |
18 | * Since the DS1621 was the first chipset supported by this driver, | |
19 | * most comments will refer to this chipset, but are actually general | |
20 | * and concern all supported chipsets, unless mentioned otherwise. | |
21 | * | |
19f2c059 GR |
22 | * This program is free software; you can redistribute it and/or modify |
23 | * it under the terms of the GNU General Public License as published by | |
24 | * the Free Software Foundation; either version 2 of the License, or | |
25 | * (at your option) any later version. | |
26 | * | |
27 | * This program is distributed in the hope that it will be useful, | |
28 | * but WITHOUT ANY WARRANTY; without even the implied warranty of | |
29 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
30 | * GNU General Public License for more details. | |
31 | * | |
32 | * You should have received a copy of the GNU General Public License | |
33 | * along with this program; if not, write to the Free Software | |
34 | * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. | |
35 | */ | |
1da177e4 LT |
36 | |
37 | #include <linux/module.h> | |
38 | #include <linux/init.h> | |
39 | #include <linux/slab.h> | |
40 | #include <linux/jiffies.h> | |
41 | #include <linux/i2c.h> | |
943b0830 | 42 | #include <linux/hwmon.h> |
46a2e71c | 43 | #include <linux/hwmon-sysfs.h> |
943b0830 | 44 | #include <linux/err.h> |
9a61bf63 | 45 | #include <linux/mutex.h> |
a5ebe668 | 46 | #include <linux/sysfs.h> |
cd6c8a42 | 47 | #include <linux/kernel.h> |
1da177e4 | 48 | |
cd6c8a42 | 49 | /* Supported devices */ |
260f81ff | 50 | enum chips { ds1621, ds1625, ds1631, ds1721, ds1731 }; |
cd6c8a42 | 51 | |
1da177e4 | 52 | /* Insmod parameters */ |
1da177e4 LT |
53 | static int polarity = -1; |
54 | module_param(polarity, int, 0); | |
55 | MODULE_PARM_DESC(polarity, "Output's polarity: 0 = active high, 1 = active low"); | |
56 | ||
cd6c8a42 RC |
57 | /* |
58 | * The Configuration/Status register | |
59 | * | |
60 | * - DS1621: | |
61 | * 7 6 5 4 3 2 1 0 | |
62 | * |Done|THF |TLF |NVB | X | X |POL |1SHOT| | |
63 | * | |
64 | * - DS1625: | |
65 | * 7 6 5 4 3 2 1 0 | |
66 | * |Done|THF |TLF |NVB | 1 | 0 |POL |1SHOT| | |
67 | * | |
260f81ff | 68 | * - DS1631, DS1731: |
79c1cc1c RC |
69 | * 7 6 5 4 3 2 1 0 |
70 | * |Done|THF |TLF |NVB | R1 | R0 |POL |1SHOT| | |
71 | * | |
cd6c8a42 RC |
72 | * - DS1721: |
73 | * 7 6 5 4 3 2 1 0 | |
74 | * |Done| X | X | U | R1 | R0 |POL |1SHOT| | |
75 | * | |
76 | * Where: | |
77 | * - 'X' is Reserved | |
78 | * - 'U' is Undefined | |
79 | */ | |
1da177e4 | 80 | #define DS1621_REG_CONFIG_NVB 0x10 |
cd6c8a42 | 81 | #define DS1621_REG_CONFIG_RESOL 0x0C |
1da177e4 LT |
82 | #define DS1621_REG_CONFIG_POLARITY 0x02 |
83 | #define DS1621_REG_CONFIG_1SHOT 0x01 | |
84 | #define DS1621_REG_CONFIG_DONE 0x80 | |
85 | ||
cd6c8a42 RC |
86 | #define DS1621_REG_CONFIG_RESOL_SHIFT 2 |
87 | ||
88 | /* ds1721 conversion rates: {C/LSB, time(ms), resolution bit setting} */ | |
89 | static const unsigned short ds1721_convrates[] = { | |
90 | 94, /* 9-bits (0.5, 93.75, RES[0..1] = 0 */ | |
91 | 188, /* 10-bits (0.25, 187.5, RES[0..1] = 1 */ | |
92 | 375, /* 11-bits (0.125, 375, RES[0..1] = 2 */ | |
93 | 750, /* 12-bits (0.0625, 750, RES[0..1] = 3 */ | |
94 | }; | |
95 | ||
96 | #define DS1621_CONVERSION_MAX 750 | |
97 | #define DS1625_CONVERSION_MAX 500 | |
98 | ||
99 | #define DS1621_TEMP_MAX 125000 | |
100 | #define DS1621_TEMP_MIN (-55000) | |
101 | ||
102 | /* The DS1621 temperature registers */ | |
46a2e71c JD |
103 | static const u8 DS1621_REG_TEMP[3] = { |
104 | 0xAA, /* input, word, RO */ | |
105 | 0xA2, /* min, word, RW */ | |
106 | 0xA1, /* max, word, RW */ | |
107 | }; | |
1da177e4 LT |
108 | #define DS1621_REG_CONF 0xAC /* byte, RW */ |
109 | #define DS1621_COM_START 0xEE /* no data */ | |
cd6c8a42 | 110 | #define DS1721_COM_START 0x51 /* no data */ |
1da177e4 LT |
111 | #define DS1621_COM_STOP 0x22 /* no data */ |
112 | ||
113 | /* The DS1621 configuration register */ | |
114 | #define DS1621_ALARM_TEMP_HIGH 0x40 | |
115 | #define DS1621_ALARM_TEMP_LOW 0x20 | |
116 | ||
75819f01 | 117 | /* Conversions */ |
1da177e4 | 118 | #define ALARMS_FROM_REG(val) ((val) & \ |
19f2c059 | 119 | (DS1621_ALARM_TEMP_HIGH | DS1621_ALARM_TEMP_LOW)) |
1da177e4 LT |
120 | |
121 | /* Each client has this additional data */ | |
122 | struct ds1621_data { | |
8269b75a | 123 | struct i2c_client *client; |
9a61bf63 | 124 | struct mutex update_lock; |
1da177e4 LT |
125 | char valid; /* !=0 if following fields are valid */ |
126 | unsigned long last_updated; /* In jiffies */ | |
cd6c8a42 | 127 | enum chips kind; /* device type */ |
1da177e4 | 128 | |
46a2e71c | 129 | u16 temp[3]; /* Register values, word */ |
1da177e4 | 130 | u8 conf; /* Register encoding, combined */ |
a50d9a4d GR |
131 | u8 zbits; /* Resolution encoded as number of |
132 | * zero bits */ | |
cd6c8a42 | 133 | u16 update_interval; /* Conversion rate in milliseconds */ |
1da177e4 LT |
134 | }; |
135 | ||
cd6c8a42 RC |
136 | static inline int DS1621_TEMP_FROM_REG(u16 reg) |
137 | { | |
138 | return DIV_ROUND_CLOSEST(((s16)reg / 16) * 625, 10); | |
139 | } | |
140 | ||
141 | /* | |
142 | * TEMP: 0.001C/bit (-55C to +125C) | |
143 | * REG: | |
a50d9a4d GR |
144 | * - 1621, 1625: 0.5C/bit, 7 zero-bits |
145 | * - 1631, 1721, 1731: 0.0625C/bit, 4 zero-bits | |
cd6c8a42 | 146 | */ |
a50d9a4d | 147 | static inline u16 DS1621_TEMP_TO_REG(long temp, u8 zbits) |
cd6c8a42 | 148 | { |
a50d9a4d GR |
149 | temp = clamp_val(temp, DS1621_TEMP_MIN, DS1621_TEMP_MAX); |
150 | temp = DIV_ROUND_CLOSEST(temp * (1 << (8 - zbits)), 1000) << zbits; | |
151 | return temp; | |
cd6c8a42 RC |
152 | } |
153 | ||
8269b75a GR |
154 | static void ds1621_init_client(struct ds1621_data *data, |
155 | struct i2c_client *client) | |
1da177e4 | 156 | { |
cd6c8a42 | 157 | u8 conf, new_conf, sreg, resol; |
e4879e28 JD |
158 | |
159 | new_conf = conf = i2c_smbus_read_byte_data(client, DS1621_REG_CONF); | |
44bbe87e | 160 | /* switch to continuous conversion mode */ |
e4879e28 | 161 | new_conf &= ~DS1621_REG_CONFIG_1SHOT; |
1da177e4 LT |
162 | |
163 | /* setup output polarity */ | |
164 | if (polarity == 0) | |
e4879e28 | 165 | new_conf &= ~DS1621_REG_CONFIG_POLARITY; |
1da177e4 | 166 | else if (polarity == 1) |
e4879e28 | 167 | new_conf |= DS1621_REG_CONFIG_POLARITY; |
19f2c059 | 168 | |
e4879e28 JD |
169 | if (conf != new_conf) |
170 | i2c_smbus_write_byte_data(client, DS1621_REG_CONF, new_conf); | |
19f2c059 | 171 | |
cd6c8a42 RC |
172 | switch (data->kind) { |
173 | case ds1625: | |
174 | data->update_interval = DS1625_CONVERSION_MAX; | |
a50d9a4d | 175 | data->zbits = 7; |
cd6c8a42 RC |
176 | sreg = DS1621_COM_START; |
177 | break; | |
79c1cc1c | 178 | case ds1631: |
cd6c8a42 | 179 | case ds1721: |
260f81ff | 180 | case ds1731: |
cd6c8a42 RC |
181 | resol = (new_conf & DS1621_REG_CONFIG_RESOL) >> |
182 | DS1621_REG_CONFIG_RESOL_SHIFT; | |
183 | data->update_interval = ds1721_convrates[resol]; | |
a50d9a4d | 184 | data->zbits = 7 - resol; |
cd6c8a42 RC |
185 | sreg = DS1721_COM_START; |
186 | break; | |
187 | default: | |
188 | data->update_interval = DS1621_CONVERSION_MAX; | |
a50d9a4d | 189 | data->zbits = 7; |
cd6c8a42 RC |
190 | sreg = DS1621_COM_START; |
191 | break; | |
192 | } | |
193 | ||
1da177e4 | 194 | /* start conversion */ |
cd6c8a42 | 195 | i2c_smbus_write_byte(client, sreg); |
1da177e4 LT |
196 | } |
197 | ||
9202add6 JD |
198 | static struct ds1621_data *ds1621_update_client(struct device *dev) |
199 | { | |
8269b75a GR |
200 | struct ds1621_data *data = dev_get_drvdata(dev); |
201 | struct i2c_client *client = data->client; | |
9202add6 JD |
202 | u8 new_conf; |
203 | ||
204 | mutex_lock(&data->update_lock); | |
205 | ||
cd6c8a42 RC |
206 | if (time_after(jiffies, data->last_updated + data->update_interval) || |
207 | !data->valid) { | |
9202add6 JD |
208 | int i; |
209 | ||
210 | dev_dbg(&client->dev, "Starting ds1621 update\n"); | |
211 | ||
594592dc | 212 | data->conf = i2c_smbus_read_byte_data(client, DS1621_REG_CONF); |
9202add6 JD |
213 | |
214 | for (i = 0; i < ARRAY_SIZE(data->temp); i++) | |
90f4102c | 215 | data->temp[i] = i2c_smbus_read_word_swapped(client, |
594592dc | 216 | DS1621_REG_TEMP[i]); |
9202add6 JD |
217 | |
218 | /* reset alarms if necessary */ | |
219 | new_conf = data->conf; | |
220 | if (data->temp[0] > data->temp[1]) /* input > min */ | |
221 | new_conf &= ~DS1621_ALARM_TEMP_LOW; | |
222 | if (data->temp[0] < data->temp[2]) /* input < max */ | |
223 | new_conf &= ~DS1621_ALARM_TEMP_HIGH; | |
224 | if (data->conf != new_conf) | |
594592dc JD |
225 | i2c_smbus_write_byte_data(client, DS1621_REG_CONF, |
226 | new_conf); | |
9202add6 JD |
227 | |
228 | data->last_updated = jiffies; | |
229 | data->valid = 1; | |
230 | } | |
231 | ||
232 | mutex_unlock(&data->update_lock); | |
233 | ||
234 | return data; | |
235 | } | |
236 | ||
46a2e71c JD |
237 | static ssize_t show_temp(struct device *dev, struct device_attribute *da, |
238 | char *buf) | |
239 | { | |
240 | struct sensor_device_attribute *attr = to_sensor_dev_attr(da); | |
241 | struct ds1621_data *data = ds1621_update_client(dev); | |
242 | return sprintf(buf, "%d\n", | |
cd6c8a42 | 243 | DS1621_TEMP_FROM_REG(data->temp[attr->index])); |
1da177e4 LT |
244 | } |
245 | ||
46a2e71c JD |
246 | static ssize_t set_temp(struct device *dev, struct device_attribute *da, |
247 | const char *buf, size_t count) | |
248 | { | |
249 | struct sensor_device_attribute *attr = to_sensor_dev_attr(da); | |
8269b75a | 250 | struct ds1621_data *data = dev_get_drvdata(dev); |
19f2c059 GR |
251 | long val; |
252 | int err; | |
253 | ||
254 | err = kstrtol(buf, 10, &val); | |
255 | if (err) | |
256 | return err; | |
1da177e4 | 257 | |
46a2e71c | 258 | mutex_lock(&data->update_lock); |
a50d9a4d | 259 | data->temp[attr->index] = DS1621_TEMP_TO_REG(val, data->zbits); |
8269b75a | 260 | i2c_smbus_write_word_swapped(data->client, DS1621_REG_TEMP[attr->index], |
90f4102c | 261 | data->temp[attr->index]); |
46a2e71c JD |
262 | mutex_unlock(&data->update_lock); |
263 | return count; | |
264 | } | |
1da177e4 | 265 | |
46a2e71c JD |
266 | static ssize_t show_alarms(struct device *dev, struct device_attribute *da, |
267 | char *buf) | |
1da177e4 LT |
268 | { |
269 | struct ds1621_data *data = ds1621_update_client(dev); | |
270 | return sprintf(buf, "%d\n", ALARMS_FROM_REG(data->conf)); | |
271 | } | |
272 | ||
87f0f31b JD |
273 | static ssize_t show_alarm(struct device *dev, struct device_attribute *da, |
274 | char *buf) | |
275 | { | |
276 | struct sensor_device_attribute *attr = to_sensor_dev_attr(da); | |
277 | struct ds1621_data *data = ds1621_update_client(dev); | |
278 | return sprintf(buf, "%d\n", !!(data->conf & attr->index)); | |
279 | } | |
280 | ||
3a8fe331 RC |
281 | static ssize_t show_convrate(struct device *dev, struct device_attribute *da, |
282 | char *buf) | |
283 | { | |
8269b75a | 284 | struct ds1621_data *data = dev_get_drvdata(dev); |
3a8fe331 RC |
285 | return scnprintf(buf, PAGE_SIZE, "%hu\n", data->update_interval); |
286 | } | |
287 | ||
288 | static ssize_t set_convrate(struct device *dev, struct device_attribute *da, | |
289 | const char *buf, size_t count) | |
290 | { | |
8269b75a GR |
291 | struct ds1621_data *data = dev_get_drvdata(dev); |
292 | struct i2c_client *client = data->client; | |
3a8fe331 RC |
293 | unsigned long convrate; |
294 | s32 err; | |
295 | int resol = 0; | |
296 | ||
297 | err = kstrtoul(buf, 10, &convrate); | |
298 | if (err) | |
299 | return err; | |
300 | ||
301 | /* Convert rate into resolution bits */ | |
302 | while (resol < (ARRAY_SIZE(ds1721_convrates) - 1) && | |
303 | convrate > ds1721_convrates[resol]) | |
304 | resol++; | |
305 | ||
306 | mutex_lock(&data->update_lock); | |
307 | data->conf = i2c_smbus_read_byte_data(client, DS1621_REG_CONF); | |
308 | data->conf &= ~DS1621_REG_CONFIG_RESOL; | |
309 | data->conf |= (resol << DS1621_REG_CONFIG_RESOL_SHIFT); | |
310 | i2c_smbus_write_byte_data(client, DS1621_REG_CONF, data->conf); | |
311 | data->update_interval = ds1721_convrates[resol]; | |
312 | mutex_unlock(&data->update_lock); | |
313 | ||
314 | return count; | |
315 | } | |
316 | ||
1da177e4 | 317 | static DEVICE_ATTR(alarms, S_IRUGO, show_alarms, NULL); |
3a8fe331 RC |
318 | static DEVICE_ATTR(update_interval, S_IWUSR | S_IRUGO, show_convrate, |
319 | set_convrate); | |
320 | ||
46a2e71c JD |
321 | static SENSOR_DEVICE_ATTR(temp1_input, S_IRUGO, show_temp, NULL, 0); |
322 | static SENSOR_DEVICE_ATTR(temp1_min, S_IWUSR | S_IRUGO, show_temp, set_temp, 1); | |
323 | static SENSOR_DEVICE_ATTR(temp1_max, S_IWUSR | S_IRUGO, show_temp, set_temp, 2); | |
87f0f31b JD |
324 | static SENSOR_DEVICE_ATTR(temp1_min_alarm, S_IRUGO, show_alarm, NULL, |
325 | DS1621_ALARM_TEMP_LOW); | |
326 | static SENSOR_DEVICE_ATTR(temp1_max_alarm, S_IRUGO, show_alarm, NULL, | |
327 | DS1621_ALARM_TEMP_HIGH); | |
1da177e4 | 328 | |
a5ebe668 | 329 | static struct attribute *ds1621_attributes[] = { |
46a2e71c JD |
330 | &sensor_dev_attr_temp1_input.dev_attr.attr, |
331 | &sensor_dev_attr_temp1_min.dev_attr.attr, | |
332 | &sensor_dev_attr_temp1_max.dev_attr.attr, | |
87f0f31b JD |
333 | &sensor_dev_attr_temp1_min_alarm.dev_attr.attr, |
334 | &sensor_dev_attr_temp1_max_alarm.dev_attr.attr, | |
a5ebe668 | 335 | &dev_attr_alarms.attr, |
3a8fe331 | 336 | &dev_attr_update_interval.attr, |
a5ebe668 JD |
337 | NULL |
338 | }; | |
339 | ||
3a8fe331 RC |
340 | static umode_t ds1621_attribute_visible(struct kobject *kobj, |
341 | struct attribute *attr, int index) | |
342 | { | |
343 | struct device *dev = container_of(kobj, struct device, kobj); | |
8269b75a | 344 | struct ds1621_data *data = dev_get_drvdata(dev); |
3a8fe331 RC |
345 | |
346 | if (attr == &dev_attr_update_interval.attr) | |
79c1cc1c | 347 | if (data->kind == ds1621 || data->kind == ds1625) |
3a8fe331 RC |
348 | /* shhh, we're hiding update_interval */ |
349 | return 0; | |
350 | return attr->mode; | |
351 | } | |
352 | ||
a5ebe668 JD |
353 | static const struct attribute_group ds1621_group = { |
354 | .attrs = ds1621_attributes, | |
3a8fe331 | 355 | .is_visible = ds1621_attribute_visible |
a5ebe668 | 356 | }; |
0d36dce0 | 357 | __ATTRIBUTE_GROUPS(ds1621); |
8269b75a | 358 | |
70313eab JD |
359 | static int ds1621_probe(struct i2c_client *client, |
360 | const struct i2c_device_id *id) | |
361 | { | |
362 | struct ds1621_data *data; | |
8269b75a | 363 | struct device *hwmon_dev; |
70313eab | 364 | |
e20b4b38 GR |
365 | data = devm_kzalloc(&client->dev, sizeof(struct ds1621_data), |
366 | GFP_KERNEL); | |
367 | if (!data) | |
368 | return -ENOMEM; | |
70313eab | 369 | |
70313eab | 370 | mutex_init(&data->update_lock); |
1da177e4 | 371 | |
cd6c8a42 | 372 | data->kind = id->driver_data; |
8269b75a | 373 | data->client = client; |
cd6c8a42 | 374 | |
1da177e4 | 375 | /* Initialize the DS1621 chip */ |
8269b75a | 376 | ds1621_init_client(data, client); |
1da177e4 | 377 | |
0d36dce0 GR |
378 | hwmon_dev = devm_hwmon_device_register_with_groups(&client->dev, |
379 | client->name, data, | |
380 | ds1621_groups); | |
8269b75a GR |
381 | if (IS_ERR(hwmon_dev)) |
382 | return PTR_ERR(hwmon_dev); | |
a5ebe668 | 383 | |
1da177e4 LT |
384 | return 0; |
385 | } | |
386 | ||
9202add6 | 387 | static const struct i2c_device_id ds1621_id[] = { |
cd6c8a42 RC |
388 | { "ds1621", ds1621 }, |
389 | { "ds1625", ds1625 }, | |
79c1cc1c | 390 | { "ds1631", ds1631 }, |
cd6c8a42 | 391 | { "ds1721", ds1721 }, |
260f81ff | 392 | { "ds1731", ds1731 }, |
9202add6 JD |
393 | { } |
394 | }; | |
395 | MODULE_DEVICE_TABLE(i2c, ds1621_id); | |
1da177e4 | 396 | |
9202add6 JD |
397 | /* This is the driver that will be inserted */ |
398 | static struct i2c_driver ds1621_driver = { | |
399 | .class = I2C_CLASS_HWMON, | |
400 | .driver = { | |
401 | .name = "ds1621", | |
402 | }, | |
403 | .probe = ds1621_probe, | |
9202add6 | 404 | .id_table = ds1621_id, |
9202add6 | 405 | }; |
1da177e4 | 406 | |
f0967eea | 407 | module_i2c_driver(ds1621_driver); |
1da177e4 LT |
408 | |
409 | MODULE_AUTHOR("Christian W. Zuckschwerdt <zany@triq.net>"); | |
410 | MODULE_DESCRIPTION("DS1621 driver"); | |
411 | MODULE_LICENSE("GPL"); |