4 * Copyright (C) 2000 Chen-Yuan Wu <gwu@esoft.com>
5 * Copyright (C) 2003-2009 Jean Delvare <khali@linux-fr.org>
7 * The ADM1025 is a sensor chip made by Analog Devices. It reports up to 6
8 * voltages (including its own power source) and up to two temperatures
9 * (its own plus up to one external one). Voltages are scaled internally
10 * (which is not the common way) with ratios such that the nominal value
11 * of each voltage correspond to a register value of 192 (which means a
12 * resolution of about 0.5% of the nominal value). Temperature values are
13 * reported with a 1 deg resolution and a 3 deg accuracy. Complete
14 * datasheet can be obtained from Analog's website at:
15 * http://www.analog.com/Analog_Root/productPage/productHome/0,2121,ADM1025,00.html
17 * This driver also supports the ADM1025A, which differs from the ADM1025
18 * only in that it has "open-drain VID inputs while the ADM1025 has
19 * on-chip 100k pull-ups on the VID inputs". It doesn't make any
22 * This driver also supports the NE1619, a sensor chip made by Philips.
23 * That chip is similar to the ADM1025A, with a few differences. The only
24 * difference that matters to us is that the NE1619 has only two possible
25 * addresses while the ADM1025A has a third one. Complete datasheet can be
26 * obtained from Philips's website at:
27 * http://www.semiconductors.philips.com/pip/NE1619DS.html
29 * Since the ADM1025 was the first chipset supported by this driver, most
30 * comments will refer to this chipset, but are actually general and
31 * concern all supported chipsets, unless mentioned otherwise.
33 * This program is free software; you can redistribute it and/or modify
34 * it under the terms of the GNU General Public License as published by
35 * the Free Software Foundation; either version 2 of the License, or
36 * (at your option) any later version.
38 * This program is distributed in the hope that it will be useful,
39 * but WITHOUT ANY WARRANTY; without even the implied warranty of
40 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
41 * GNU General Public License for more details.
43 * You should have received a copy of the GNU General Public License
44 * along with this program; if not, write to the Free Software
45 * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
48 #include <linux/module.h>
49 #include <linux/init.h>
50 #include <linux/slab.h>
51 #include <linux/jiffies.h>
52 #include <linux/i2c.h>
53 #include <linux/hwmon.h>
54 #include <linux/hwmon-sysfs.h>
55 #include <linux/hwmon-vid.h>
56 #include <linux/err.h>
57 #include <linux/mutex.h>
61 * ADM1025 and ADM1025A have three possible addresses: 0x2c, 0x2d and 0x2e.
62 * NE1619 has two possible addresses: 0x2c and 0x2d.
65 static const unsigned short normal_i2c
[] = { 0x2c, 0x2d, 0x2e, I2C_CLIENT_END
};
67 enum chips
{ adm1025
, ne1619
};
70 * The ADM1025 registers
73 #define ADM1025_REG_MAN_ID 0x3E
74 #define ADM1025_REG_CHIP_ID 0x3F
75 #define ADM1025_REG_CONFIG 0x40
76 #define ADM1025_REG_STATUS1 0x41
77 #define ADM1025_REG_STATUS2 0x42
78 #define ADM1025_REG_IN(nr) (0x20 + (nr))
79 #define ADM1025_REG_IN_MAX(nr) (0x2B + (nr) * 2)
80 #define ADM1025_REG_IN_MIN(nr) (0x2C + (nr) * 2)
81 #define ADM1025_REG_TEMP(nr) (0x26 + (nr))
82 #define ADM1025_REG_TEMP_HIGH(nr) (0x37 + (nr) * 2)
83 #define ADM1025_REG_TEMP_LOW(nr) (0x38 + (nr) * 2)
84 #define ADM1025_REG_VID 0x47
85 #define ADM1025_REG_VID4 0x49
88 * Conversions and various macros
89 * The ADM1025 uses signed 8-bit values for temperatures.
92 static const int in_scale
[6] = { 2500, 2250, 3300, 5000, 12000, 3300 };
94 #define IN_FROM_REG(reg,scale) (((reg) * (scale) + 96) / 192)
95 #define IN_TO_REG(val,scale) ((val) <= 0 ? 0 : \
96 (val) * 192 >= (scale) * 255 ? 255 : \
97 ((val) * 192 + (scale)/2) / (scale))
99 #define TEMP_FROM_REG(reg) ((reg) * 1000)
100 #define TEMP_TO_REG(val) ((val) <= -127500 ? -128 : \
101 (val) >= 126500 ? 127 : \
102 (((val) < 0 ? (val)-500 : (val)+500) / 1000))
105 * Functions declaration
108 static int adm1025_probe(struct i2c_client
*client
,
109 const struct i2c_device_id
*id
);
110 static int adm1025_detect(struct i2c_client
*client
,
111 struct i2c_board_info
*info
);
112 static void adm1025_init_client(struct i2c_client
*client
);
113 static int adm1025_remove(struct i2c_client
*client
);
114 static struct adm1025_data
*adm1025_update_device(struct device
*dev
);
117 * Driver data (common to all clients)
120 static const struct i2c_device_id adm1025_id
[] = {
121 { "adm1025", adm1025
},
122 { "ne1619", ne1619
},
125 MODULE_DEVICE_TABLE(i2c
, adm1025_id
);
127 static struct i2c_driver adm1025_driver
= {
128 .class = I2C_CLASS_HWMON
,
132 .probe
= adm1025_probe
,
133 .remove
= adm1025_remove
,
134 .id_table
= adm1025_id
,
135 .detect
= adm1025_detect
,
136 .address_list
= normal_i2c
,
140 * Client data (each client gets its own)
143 struct adm1025_data
{
144 struct device
*hwmon_dev
;
145 struct mutex update_lock
;
146 char valid
; /* zero until following fields are valid */
147 unsigned long last_updated
; /* in jiffies */
149 u8 in
[6]; /* register value */
150 u8 in_max
[6]; /* register value */
151 u8 in_min
[6]; /* register value */
152 s8 temp
[2]; /* register value */
153 s8 temp_min
[2]; /* register value */
154 s8 temp_max
[2]; /* register value */
155 u16 alarms
; /* register values, combined */
156 u8 vid
; /* register values, combined */
165 show_in(struct device
*dev
, struct device_attribute
*attr
, char *buf
)
167 int index
= to_sensor_dev_attr(attr
)->index
;
168 struct adm1025_data
*data
= adm1025_update_device(dev
);
169 return sprintf(buf
, "%u\n", IN_FROM_REG(data
->in
[index
],
174 show_in_min(struct device
*dev
, struct device_attribute
*attr
, char *buf
)
176 int index
= to_sensor_dev_attr(attr
)->index
;
177 struct adm1025_data
*data
= adm1025_update_device(dev
);
178 return sprintf(buf
, "%u\n", IN_FROM_REG(data
->in_min
[index
],
183 show_in_max(struct device
*dev
, struct device_attribute
*attr
, char *buf
)
185 int index
= to_sensor_dev_attr(attr
)->index
;
186 struct adm1025_data
*data
= adm1025_update_device(dev
);
187 return sprintf(buf
, "%u\n", IN_FROM_REG(data
->in_max
[index
],
192 show_temp(struct device
*dev
, struct device_attribute
*attr
, char *buf
)
194 int index
= to_sensor_dev_attr(attr
)->index
;
195 struct adm1025_data
*data
= adm1025_update_device(dev
);
196 return sprintf(buf
, "%d\n", TEMP_FROM_REG(data
->temp
[index
]));
200 show_temp_min(struct device
*dev
, struct device_attribute
*attr
, char *buf
)
202 int index
= to_sensor_dev_attr(attr
)->index
;
203 struct adm1025_data
*data
= adm1025_update_device(dev
);
204 return sprintf(buf
, "%d\n", TEMP_FROM_REG(data
->temp_min
[index
]));
208 show_temp_max(struct device
*dev
, struct device_attribute
*attr
, char *buf
)
210 int index
= to_sensor_dev_attr(attr
)->index
;
211 struct adm1025_data
*data
= adm1025_update_device(dev
);
212 return sprintf(buf
, "%d\n", TEMP_FROM_REG(data
->temp_max
[index
]));
215 static ssize_t
set_in_min(struct device
*dev
, struct device_attribute
*attr
,
216 const char *buf
, size_t count
)
218 int index
= to_sensor_dev_attr(attr
)->index
;
219 struct i2c_client
*client
= to_i2c_client(dev
);
220 struct adm1025_data
*data
= i2c_get_clientdata(client
);
221 long val
= simple_strtol(buf
, NULL
, 10);
223 mutex_lock(&data
->update_lock
);
224 data
->in_min
[index
] = IN_TO_REG(val
, in_scale
[index
]);
225 i2c_smbus_write_byte_data(client
, ADM1025_REG_IN_MIN(index
),
226 data
->in_min
[index
]);
227 mutex_unlock(&data
->update_lock
);
231 static ssize_t
set_in_max(struct device
*dev
, struct device_attribute
*attr
,
232 const char *buf
, size_t count
)
234 int index
= to_sensor_dev_attr(attr
)->index
;
235 struct i2c_client
*client
= to_i2c_client(dev
);
236 struct adm1025_data
*data
= i2c_get_clientdata(client
);
237 long val
= simple_strtol(buf
, NULL
, 10);
239 mutex_lock(&data
->update_lock
);
240 data
->in_max
[index
] = IN_TO_REG(val
, in_scale
[index
]);
241 i2c_smbus_write_byte_data(client
, ADM1025_REG_IN_MAX(index
),
242 data
->in_max
[index
]);
243 mutex_unlock(&data
->update_lock
);
247 #define set_in(offset) \
248 static SENSOR_DEVICE_ATTR(in##offset##_input, S_IRUGO, \
249 show_in, NULL, offset); \
250 static SENSOR_DEVICE_ATTR(in##offset##_min, S_IWUSR | S_IRUGO, \
251 show_in_min, set_in_min, offset); \
252 static SENSOR_DEVICE_ATTR(in##offset##_max, S_IWUSR | S_IRUGO, \
253 show_in_max, set_in_max, offset)
261 static ssize_t
set_temp_min(struct device
*dev
, struct device_attribute
*attr
,
262 const char *buf
, size_t count
)
264 int index
= to_sensor_dev_attr(attr
)->index
;
265 struct i2c_client
*client
= to_i2c_client(dev
);
266 struct adm1025_data
*data
= i2c_get_clientdata(client
);
267 long val
= simple_strtol(buf
, NULL
, 10);
269 mutex_lock(&data
->update_lock
);
270 data
->temp_min
[index
] = TEMP_TO_REG(val
);
271 i2c_smbus_write_byte_data(client
, ADM1025_REG_TEMP_LOW(index
),
272 data
->temp_min
[index
]);
273 mutex_unlock(&data
->update_lock
);
277 static ssize_t
set_temp_max(struct device
*dev
, struct device_attribute
*attr
,
278 const char *buf
, size_t count
)
280 int index
= to_sensor_dev_attr(attr
)->index
;
281 struct i2c_client
*client
= to_i2c_client(dev
);
282 struct adm1025_data
*data
= i2c_get_clientdata(client
);
283 long val
= simple_strtol(buf
, NULL
, 10);
285 mutex_lock(&data
->update_lock
);
286 data
->temp_max
[index
] = TEMP_TO_REG(val
);
287 i2c_smbus_write_byte_data(client
, ADM1025_REG_TEMP_HIGH(index
),
288 data
->temp_max
[index
]);
289 mutex_unlock(&data
->update_lock
);
293 #define set_temp(offset) \
294 static SENSOR_DEVICE_ATTR(temp##offset##_input, S_IRUGO, \
295 show_temp, NULL, offset - 1); \
296 static SENSOR_DEVICE_ATTR(temp##offset##_min, S_IWUSR | S_IRUGO, \
297 show_temp_min, set_temp_min, offset - 1); \
298 static SENSOR_DEVICE_ATTR(temp##offset##_max, S_IWUSR | S_IRUGO, \
299 show_temp_max, set_temp_max, offset - 1)
304 show_alarms(struct device
*dev
, struct device_attribute
*attr
, char *buf
)
306 struct adm1025_data
*data
= adm1025_update_device(dev
);
307 return sprintf(buf
, "%u\n", data
->alarms
);
309 static DEVICE_ATTR(alarms
, S_IRUGO
, show_alarms
, NULL
);
312 show_alarm(struct device
*dev
, struct device_attribute
*attr
, char *buf
)
314 int bitnr
= to_sensor_dev_attr(attr
)->index
;
315 struct adm1025_data
*data
= adm1025_update_device(dev
);
316 return sprintf(buf
, "%u\n", (data
->alarms
>> bitnr
) & 1);
318 static SENSOR_DEVICE_ATTR(in0_alarm
, S_IRUGO
, show_alarm
, NULL
, 0);
319 static SENSOR_DEVICE_ATTR(in1_alarm
, S_IRUGO
, show_alarm
, NULL
, 1);
320 static SENSOR_DEVICE_ATTR(in2_alarm
, S_IRUGO
, show_alarm
, NULL
, 2);
321 static SENSOR_DEVICE_ATTR(in3_alarm
, S_IRUGO
, show_alarm
, NULL
, 3);
322 static SENSOR_DEVICE_ATTR(in4_alarm
, S_IRUGO
, show_alarm
, NULL
, 8);
323 static SENSOR_DEVICE_ATTR(in5_alarm
, S_IRUGO
, show_alarm
, NULL
, 9);
324 static SENSOR_DEVICE_ATTR(temp1_alarm
, S_IRUGO
, show_alarm
, NULL
, 5);
325 static SENSOR_DEVICE_ATTR(temp2_alarm
, S_IRUGO
, show_alarm
, NULL
, 4);
326 static SENSOR_DEVICE_ATTR(temp1_fault
, S_IRUGO
, show_alarm
, NULL
, 14);
329 show_vid(struct device
*dev
, struct device_attribute
*attr
, char *buf
)
331 struct adm1025_data
*data
= adm1025_update_device(dev
);
332 return sprintf(buf
, "%u\n", vid_from_reg(data
->vid
, data
->vrm
));
334 static DEVICE_ATTR(cpu0_vid
, S_IRUGO
, show_vid
, NULL
);
337 show_vrm(struct device
*dev
, struct device_attribute
*attr
, char *buf
)
339 struct adm1025_data
*data
= dev_get_drvdata(dev
);
340 return sprintf(buf
, "%u\n", data
->vrm
);
342 static ssize_t
set_vrm(struct device
*dev
, struct device_attribute
*attr
,
343 const char *buf
, size_t count
)
345 struct adm1025_data
*data
= dev_get_drvdata(dev
);
346 data
->vrm
= simple_strtoul(buf
, NULL
, 10);
349 static DEVICE_ATTR(vrm
, S_IRUGO
| S_IWUSR
, show_vrm
, set_vrm
);
355 static struct attribute
*adm1025_attributes
[] = {
356 &sensor_dev_attr_in0_input
.dev_attr
.attr
,
357 &sensor_dev_attr_in1_input
.dev_attr
.attr
,
358 &sensor_dev_attr_in2_input
.dev_attr
.attr
,
359 &sensor_dev_attr_in3_input
.dev_attr
.attr
,
360 &sensor_dev_attr_in5_input
.dev_attr
.attr
,
361 &sensor_dev_attr_in0_min
.dev_attr
.attr
,
362 &sensor_dev_attr_in1_min
.dev_attr
.attr
,
363 &sensor_dev_attr_in2_min
.dev_attr
.attr
,
364 &sensor_dev_attr_in3_min
.dev_attr
.attr
,
365 &sensor_dev_attr_in5_min
.dev_attr
.attr
,
366 &sensor_dev_attr_in0_max
.dev_attr
.attr
,
367 &sensor_dev_attr_in1_max
.dev_attr
.attr
,
368 &sensor_dev_attr_in2_max
.dev_attr
.attr
,
369 &sensor_dev_attr_in3_max
.dev_attr
.attr
,
370 &sensor_dev_attr_in5_max
.dev_attr
.attr
,
371 &sensor_dev_attr_in0_alarm
.dev_attr
.attr
,
372 &sensor_dev_attr_in1_alarm
.dev_attr
.attr
,
373 &sensor_dev_attr_in2_alarm
.dev_attr
.attr
,
374 &sensor_dev_attr_in3_alarm
.dev_attr
.attr
,
375 &sensor_dev_attr_in5_alarm
.dev_attr
.attr
,
376 &sensor_dev_attr_temp1_input
.dev_attr
.attr
,
377 &sensor_dev_attr_temp2_input
.dev_attr
.attr
,
378 &sensor_dev_attr_temp1_min
.dev_attr
.attr
,
379 &sensor_dev_attr_temp2_min
.dev_attr
.attr
,
380 &sensor_dev_attr_temp1_max
.dev_attr
.attr
,
381 &sensor_dev_attr_temp2_max
.dev_attr
.attr
,
382 &sensor_dev_attr_temp1_alarm
.dev_attr
.attr
,
383 &sensor_dev_attr_temp2_alarm
.dev_attr
.attr
,
384 &sensor_dev_attr_temp1_fault
.dev_attr
.attr
,
385 &dev_attr_alarms
.attr
,
386 &dev_attr_cpu0_vid
.attr
,
391 static const struct attribute_group adm1025_group
= {
392 .attrs
= adm1025_attributes
,
395 static struct attribute
*adm1025_attributes_in4
[] = {
396 &sensor_dev_attr_in4_input
.dev_attr
.attr
,
397 &sensor_dev_attr_in4_min
.dev_attr
.attr
,
398 &sensor_dev_attr_in4_max
.dev_attr
.attr
,
399 &sensor_dev_attr_in4_alarm
.dev_attr
.attr
,
403 static const struct attribute_group adm1025_group_in4
= {
404 .attrs
= adm1025_attributes_in4
,
407 /* Return 0 if detection is successful, -ENODEV otherwise */
408 static int adm1025_detect(struct i2c_client
*client
,
409 struct i2c_board_info
*info
)
411 struct i2c_adapter
*adapter
= client
->adapter
;
415 if (!i2c_check_functionality(adapter
, I2C_FUNC_SMBUS_BYTE_DATA
))
418 /* Check for unused bits */
419 if ((i2c_smbus_read_byte_data(client
, ADM1025_REG_CONFIG
) & 0x80)
420 || (i2c_smbus_read_byte_data(client
, ADM1025_REG_STATUS1
) & 0xC0)
421 || (i2c_smbus_read_byte_data(client
, ADM1025_REG_STATUS2
) & 0xBC)) {
422 dev_dbg(&adapter
->dev
, "ADM1025 detection failed at 0x%02x\n",
428 chip_id
= i2c_smbus_read_byte_data(client
, ADM1025_REG_CHIP_ID
);
429 if ((chip_id
& 0xF0) != 0x20)
432 man_id
= i2c_smbus_read_byte_data(client
, ADM1025_REG_MAN_ID
);
435 else if (man_id
== 0xA1 && client
->addr
!= 0x2E)
440 strlcpy(info
->type
, name
, I2C_NAME_SIZE
);
445 static int adm1025_probe(struct i2c_client
*client
,
446 const struct i2c_device_id
*id
)
448 struct adm1025_data
*data
;
452 data
= kzalloc(sizeof(struct adm1025_data
), GFP_KERNEL
);
458 i2c_set_clientdata(client
, data
);
459 mutex_init(&data
->update_lock
);
461 /* Initialize the ADM1025 chip */
462 adm1025_init_client(client
);
464 /* Register sysfs hooks */
465 if ((err
= sysfs_create_group(&client
->dev
.kobj
, &adm1025_group
)))
468 /* Pin 11 is either in4 (+12V) or VID4 */
469 config
= i2c_smbus_read_byte_data(client
, ADM1025_REG_CONFIG
);
470 if (!(config
& 0x20)) {
471 if ((err
= sysfs_create_group(&client
->dev
.kobj
,
472 &adm1025_group_in4
)))
476 data
->hwmon_dev
= hwmon_device_register(&client
->dev
);
477 if (IS_ERR(data
->hwmon_dev
)) {
478 err
= PTR_ERR(data
->hwmon_dev
);
485 sysfs_remove_group(&client
->dev
.kobj
, &adm1025_group
);
486 sysfs_remove_group(&client
->dev
.kobj
, &adm1025_group_in4
);
493 static void adm1025_init_client(struct i2c_client
*client
)
496 struct adm1025_data
*data
= i2c_get_clientdata(client
);
499 data
->vrm
= vid_which_vrm();
503 * Usually we avoid setting limits on driver init, but it happens
504 * that the ADM1025 comes with stupid default limits (all registers
505 * set to 0). In case the chip has not gone through any limit
506 * setting yet, we better set the high limits to the max so that
509 for (i
=0; i
<6; i
++) {
510 reg
= i2c_smbus_read_byte_data(client
,
511 ADM1025_REG_IN_MAX(i
));
513 i2c_smbus_write_byte_data(client
,
514 ADM1025_REG_IN_MAX(i
),
517 for (i
=0; i
<2; i
++) {
518 reg
= i2c_smbus_read_byte_data(client
,
519 ADM1025_REG_TEMP_HIGH(i
));
521 i2c_smbus_write_byte_data(client
,
522 ADM1025_REG_TEMP_HIGH(i
),
527 * Start the conversions
529 reg
= i2c_smbus_read_byte_data(client
, ADM1025_REG_CONFIG
);
531 i2c_smbus_write_byte_data(client
, ADM1025_REG_CONFIG
,
535 static int adm1025_remove(struct i2c_client
*client
)
537 struct adm1025_data
*data
= i2c_get_clientdata(client
);
539 hwmon_device_unregister(data
->hwmon_dev
);
540 sysfs_remove_group(&client
->dev
.kobj
, &adm1025_group
);
541 sysfs_remove_group(&client
->dev
.kobj
, &adm1025_group_in4
);
547 static struct adm1025_data
*adm1025_update_device(struct device
*dev
)
549 struct i2c_client
*client
= to_i2c_client(dev
);
550 struct adm1025_data
*data
= i2c_get_clientdata(client
);
552 mutex_lock(&data
->update_lock
);
554 if (time_after(jiffies
, data
->last_updated
+ HZ
* 2) || !data
->valid
) {
557 dev_dbg(&client
->dev
, "Updating data.\n");
558 for (i
=0; i
<6; i
++) {
559 data
->in
[i
] = i2c_smbus_read_byte_data(client
,
561 data
->in_min
[i
] = i2c_smbus_read_byte_data(client
,
562 ADM1025_REG_IN_MIN(i
));
563 data
->in_max
[i
] = i2c_smbus_read_byte_data(client
,
564 ADM1025_REG_IN_MAX(i
));
566 for (i
=0; i
<2; i
++) {
567 data
->temp
[i
] = i2c_smbus_read_byte_data(client
,
568 ADM1025_REG_TEMP(i
));
569 data
->temp_min
[i
] = i2c_smbus_read_byte_data(client
,
570 ADM1025_REG_TEMP_LOW(i
));
571 data
->temp_max
[i
] = i2c_smbus_read_byte_data(client
,
572 ADM1025_REG_TEMP_HIGH(i
));
574 data
->alarms
= i2c_smbus_read_byte_data(client
,
576 | (i2c_smbus_read_byte_data(client
,
577 ADM1025_REG_STATUS2
) << 8);
578 data
->vid
= (i2c_smbus_read_byte_data(client
,
579 ADM1025_REG_VID
) & 0x0f)
580 | ((i2c_smbus_read_byte_data(client
,
581 ADM1025_REG_VID4
) & 0x01) << 4);
583 data
->last_updated
= jiffies
;
587 mutex_unlock(&data
->update_lock
);
592 static int __init
sensors_adm1025_init(void)
594 return i2c_add_driver(&adm1025_driver
);
597 static void __exit
sensors_adm1025_exit(void)
599 i2c_del_driver(&adm1025_driver
);
602 MODULE_AUTHOR("Jean Delvare <khali@linux-fr.org>");
603 MODULE_DESCRIPTION("ADM1025 driver");
604 MODULE_LICENSE("GPL");
606 module_init(sensors_adm1025_init
);
607 module_exit(sensors_adm1025_exit
);