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 { | |
1beeffe4 | 123 | struct device *hwmon_dev; |
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 | ||
1da177e4 LT |
154 | static void ds1621_init_client(struct i2c_client *client) |
155 | { | |
cd6c8a42 RC |
156 | u8 conf, new_conf, sreg, resol; |
157 | struct ds1621_data *data = i2c_get_clientdata(client); | |
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 | { | |
200 | struct i2c_client *client = to_i2c_client(dev); | |
201 | struct ds1621_data *data = i2c_get_clientdata(client); | |
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); | |
250 | struct i2c_client *client = to_i2c_client(dev); | |
e4879e28 | 251 | struct ds1621_data *data = i2c_get_clientdata(client); |
19f2c059 GR |
252 | long val; |
253 | int err; | |
254 | ||
255 | err = kstrtol(buf, 10, &val); | |
256 | if (err) | |
257 | return err; | |
1da177e4 | 258 | |
46a2e71c | 259 | mutex_lock(&data->update_lock); |
a50d9a4d | 260 | data->temp[attr->index] = DS1621_TEMP_TO_REG(val, data->zbits); |
90f4102c JD |
261 | i2c_smbus_write_word_swapped(client, DS1621_REG_TEMP[attr->index], |
262 | data->temp[attr->index]); | |
46a2e71c JD |
263 | mutex_unlock(&data->update_lock); |
264 | return count; | |
265 | } | |
1da177e4 | 266 | |
46a2e71c JD |
267 | static ssize_t show_alarms(struct device *dev, struct device_attribute *da, |
268 | char *buf) | |
1da177e4 LT |
269 | { |
270 | struct ds1621_data *data = ds1621_update_client(dev); | |
271 | return sprintf(buf, "%d\n", ALARMS_FROM_REG(data->conf)); | |
272 | } | |
273 | ||
87f0f31b JD |
274 | static ssize_t show_alarm(struct device *dev, struct device_attribute *da, |
275 | char *buf) | |
276 | { | |
277 | struct sensor_device_attribute *attr = to_sensor_dev_attr(da); | |
278 | struct ds1621_data *data = ds1621_update_client(dev); | |
279 | return sprintf(buf, "%d\n", !!(data->conf & attr->index)); | |
280 | } | |
281 | ||
3a8fe331 RC |
282 | static ssize_t show_convrate(struct device *dev, struct device_attribute *da, |
283 | char *buf) | |
284 | { | |
285 | struct i2c_client *client = to_i2c_client(dev); | |
286 | struct ds1621_data *data = i2c_get_clientdata(client); | |
287 | return scnprintf(buf, PAGE_SIZE, "%hu\n", data->update_interval); | |
288 | } | |
289 | ||
290 | static ssize_t set_convrate(struct device *dev, struct device_attribute *da, | |
291 | const char *buf, size_t count) | |
292 | { | |
293 | struct i2c_client *client = to_i2c_client(dev); | |
294 | struct ds1621_data *data = i2c_get_clientdata(client); | |
295 | unsigned long convrate; | |
296 | s32 err; | |
297 | int resol = 0; | |
298 | ||
299 | err = kstrtoul(buf, 10, &convrate); | |
300 | if (err) | |
301 | return err; | |
302 | ||
303 | /* Convert rate into resolution bits */ | |
304 | while (resol < (ARRAY_SIZE(ds1721_convrates) - 1) && | |
305 | convrate > ds1721_convrates[resol]) | |
306 | resol++; | |
307 | ||
308 | mutex_lock(&data->update_lock); | |
309 | data->conf = i2c_smbus_read_byte_data(client, DS1621_REG_CONF); | |
310 | data->conf &= ~DS1621_REG_CONFIG_RESOL; | |
311 | data->conf |= (resol << DS1621_REG_CONFIG_RESOL_SHIFT); | |
312 | i2c_smbus_write_byte_data(client, DS1621_REG_CONF, data->conf); | |
313 | data->update_interval = ds1721_convrates[resol]; | |
314 | mutex_unlock(&data->update_lock); | |
315 | ||
316 | return count; | |
317 | } | |
318 | ||
1da177e4 | 319 | static DEVICE_ATTR(alarms, S_IRUGO, show_alarms, NULL); |
3a8fe331 RC |
320 | static DEVICE_ATTR(update_interval, S_IWUSR | S_IRUGO, show_convrate, |
321 | set_convrate); | |
322 | ||
46a2e71c JD |
323 | static SENSOR_DEVICE_ATTR(temp1_input, S_IRUGO, show_temp, NULL, 0); |
324 | static SENSOR_DEVICE_ATTR(temp1_min, S_IWUSR | S_IRUGO, show_temp, set_temp, 1); | |
325 | static SENSOR_DEVICE_ATTR(temp1_max, S_IWUSR | S_IRUGO, show_temp, set_temp, 2); | |
87f0f31b JD |
326 | static SENSOR_DEVICE_ATTR(temp1_min_alarm, S_IRUGO, show_alarm, NULL, |
327 | DS1621_ALARM_TEMP_LOW); | |
328 | static SENSOR_DEVICE_ATTR(temp1_max_alarm, S_IRUGO, show_alarm, NULL, | |
329 | DS1621_ALARM_TEMP_HIGH); | |
1da177e4 | 330 | |
a5ebe668 | 331 | static struct attribute *ds1621_attributes[] = { |
46a2e71c JD |
332 | &sensor_dev_attr_temp1_input.dev_attr.attr, |
333 | &sensor_dev_attr_temp1_min.dev_attr.attr, | |
334 | &sensor_dev_attr_temp1_max.dev_attr.attr, | |
87f0f31b JD |
335 | &sensor_dev_attr_temp1_min_alarm.dev_attr.attr, |
336 | &sensor_dev_attr_temp1_max_alarm.dev_attr.attr, | |
a5ebe668 | 337 | &dev_attr_alarms.attr, |
3a8fe331 | 338 | &dev_attr_update_interval.attr, |
a5ebe668 JD |
339 | NULL |
340 | }; | |
341 | ||
3a8fe331 RC |
342 | static umode_t ds1621_attribute_visible(struct kobject *kobj, |
343 | struct attribute *attr, int index) | |
344 | { | |
345 | struct device *dev = container_of(kobj, struct device, kobj); | |
346 | struct i2c_client *client = to_i2c_client(dev); | |
347 | struct ds1621_data *data = i2c_get_clientdata(client); | |
348 | ||
349 | if (attr == &dev_attr_update_interval.attr) | |
79c1cc1c | 350 | if (data->kind == ds1621 || data->kind == ds1625) |
3a8fe331 RC |
351 | /* shhh, we're hiding update_interval */ |
352 | return 0; | |
353 | return attr->mode; | |
354 | } | |
355 | ||
a5ebe668 JD |
356 | static const struct attribute_group ds1621_group = { |
357 | .attrs = ds1621_attributes, | |
3a8fe331 | 358 | .is_visible = ds1621_attribute_visible |
a5ebe668 JD |
359 | }; |
360 | ||
70313eab JD |
361 | static int ds1621_probe(struct i2c_client *client, |
362 | const struct i2c_device_id *id) | |
363 | { | |
364 | struct ds1621_data *data; | |
365 | int err; | |
366 | ||
e20b4b38 GR |
367 | data = devm_kzalloc(&client->dev, sizeof(struct ds1621_data), |
368 | GFP_KERNEL); | |
369 | if (!data) | |
370 | return -ENOMEM; | |
70313eab JD |
371 | |
372 | i2c_set_clientdata(client, data); | |
373 | mutex_init(&data->update_lock); | |
1da177e4 | 374 | |
cd6c8a42 RC |
375 | data->kind = id->driver_data; |
376 | ||
1da177e4 | 377 | /* Initialize the DS1621 chip */ |
75819f01 | 378 | ds1621_init_client(client); |
1da177e4 LT |
379 | |
380 | /* Register sysfs hooks */ | |
19f2c059 GR |
381 | err = sysfs_create_group(&client->dev.kobj, &ds1621_group); |
382 | if (err) | |
e20b4b38 | 383 | return err; |
a5ebe668 | 384 | |
1beeffe4 TJ |
385 | data->hwmon_dev = hwmon_device_register(&client->dev); |
386 | if (IS_ERR(data->hwmon_dev)) { | |
387 | err = PTR_ERR(data->hwmon_dev); | |
a5ebe668 | 388 | goto exit_remove_files; |
943b0830 MH |
389 | } |
390 | ||
1da177e4 LT |
391 | return 0; |
392 | ||
19f2c059 | 393 | exit_remove_files: |
75819f01 | 394 | sysfs_remove_group(&client->dev.kobj, &ds1621_group); |
1da177e4 LT |
395 | return err; |
396 | } | |
397 | ||
70313eab | 398 | static int ds1621_remove(struct i2c_client *client) |
1da177e4 | 399 | { |
943b0830 | 400 | struct ds1621_data *data = i2c_get_clientdata(client); |
1da177e4 | 401 | |
1beeffe4 | 402 | hwmon_device_unregister(data->hwmon_dev); |
a5ebe668 | 403 | sysfs_remove_group(&client->dev.kobj, &ds1621_group); |
943b0830 | 404 | |
1da177e4 LT |
405 | return 0; |
406 | } | |
407 | ||
9202add6 | 408 | static const struct i2c_device_id ds1621_id[] = { |
cd6c8a42 RC |
409 | { "ds1621", ds1621 }, |
410 | { "ds1625", ds1625 }, | |
79c1cc1c | 411 | { "ds1631", ds1631 }, |
cd6c8a42 | 412 | { "ds1721", ds1721 }, |
260f81ff | 413 | { "ds1731", ds1731 }, |
9202add6 JD |
414 | { } |
415 | }; | |
416 | MODULE_DEVICE_TABLE(i2c, ds1621_id); | |
1da177e4 | 417 | |
9202add6 JD |
418 | /* This is the driver that will be inserted */ |
419 | static struct i2c_driver ds1621_driver = { | |
420 | .class = I2C_CLASS_HWMON, | |
421 | .driver = { | |
422 | .name = "ds1621", | |
423 | }, | |
424 | .probe = ds1621_probe, | |
425 | .remove = ds1621_remove, | |
426 | .id_table = ds1621_id, | |
9202add6 | 427 | }; |
1da177e4 | 428 | |
f0967eea | 429 | module_i2c_driver(ds1621_driver); |
1da177e4 LT |
430 | |
431 | MODULE_AUTHOR("Christian W. Zuckschwerdt <zany@triq.net>"); | |
432 | MODULE_DESCRIPTION("DS1621 driver"); | |
433 | MODULE_LICENSE("GPL"); |