Linux Audio

Check our new training course

Loading...
v6.8
  1// SPDX-License-Identifier: GPL-2.0-or-later
  2/*
  3 * adm1025.c
  4 *
  5 * Copyright (C) 2000       Chen-Yuan Wu <gwu@esoft.com>
  6 * Copyright (C) 2003-2009  Jean Delvare <jdelvare@suse.de>
  7 *
  8 * The ADM1025 is a sensor chip made by Analog Devices. It reports up to 6
  9 * voltages (including its own power source) and up to two temperatures
 10 * (its own plus up to one external one). Voltages are scaled internally
 11 * (which is not the common way) with ratios such that the nominal value
 12 * of each voltage correspond to a register value of 192 (which means a
 13 * resolution of about 0.5% of the nominal value). Temperature values are
 14 * reported with a 1 deg resolution and a 3 deg accuracy. Complete
 15 * datasheet can be obtained from Analog's website at:
 16 *   https://www.onsemi.com/PowerSolutions/product.do?id=ADM1025
 17 *
 18 * This driver also supports the ADM1025A, which differs from the ADM1025
 19 * only in that it has "open-drain VID inputs while the ADM1025 has
 20 * on-chip 100k pull-ups on the VID inputs". It doesn't make any
 21 * difference for us.
 22 *
 23 * This driver also supports the NE1619, a sensor chip made by Philips.
 24 * That chip is similar to the ADM1025A, with a few differences. The only
 25 * difference that matters to us is that the NE1619 has only two possible
 26 * addresses while the ADM1025A has a third one. Complete datasheet can be
 27 * obtained from Philips's website at:
 28 *   http://www.semiconductors.philips.com/pip/NE1619DS.html
 29 *
 30 * Since the ADM1025 was the first chipset supported by this driver, most
 31 * comments will refer to this chipset, but are actually general and
 32 * concern all supported chipsets, unless mentioned otherwise.
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 33 */
 34
 35#include <linux/module.h>
 36#include <linux/init.h>
 37#include <linux/slab.h>
 38#include <linux/jiffies.h>
 39#include <linux/i2c.h>
 40#include <linux/hwmon.h>
 41#include <linux/hwmon-sysfs.h>
 42#include <linux/hwmon-vid.h>
 43#include <linux/err.h>
 44#include <linux/mutex.h>
 45
 46/*
 47 * Addresses to scan
 48 * ADM1025 and ADM1025A have three possible addresses: 0x2c, 0x2d and 0x2e.
 49 * NE1619 has two possible addresses: 0x2c and 0x2d.
 50 */
 51
 52static const unsigned short normal_i2c[] = { 0x2c, 0x2d, 0x2e, I2C_CLIENT_END };
 53
 54enum chips { adm1025, ne1619 };
 55
 56/*
 57 * The ADM1025 registers
 58 */
 59
 60#define ADM1025_REG_MAN_ID		0x3E
 61#define ADM1025_REG_CHIP_ID		0x3F
 62#define ADM1025_REG_CONFIG		0x40
 63#define ADM1025_REG_STATUS1		0x41
 64#define ADM1025_REG_STATUS2		0x42
 65#define ADM1025_REG_IN(nr)		(0x20 + (nr))
 66#define ADM1025_REG_IN_MAX(nr)		(0x2B + (nr) * 2)
 67#define ADM1025_REG_IN_MIN(nr)		(0x2C + (nr) * 2)
 68#define ADM1025_REG_TEMP(nr)		(0x26 + (nr))
 69#define ADM1025_REG_TEMP_HIGH(nr)	(0x37 + (nr) * 2)
 70#define ADM1025_REG_TEMP_LOW(nr)	(0x38 + (nr) * 2)
 71#define ADM1025_REG_VID			0x47
 72#define ADM1025_REG_VID4		0x49
 73
 74/*
 75 * Conversions and various macros
 76 * The ADM1025 uses signed 8-bit values for temperatures.
 77 */
 78
 79static const int in_scale[6] = { 2500, 2250, 3300, 5000, 12000, 3300 };
 80
 81#define IN_FROM_REG(reg, scale)	(((reg) * (scale) + 96) / 192)
 82#define IN_TO_REG(val, scale)	((val) <= 0 ? 0 : \
 83				 (val) >= (scale) * 255 / 192 ? 255 : \
 84				 ((val) * 192 + (scale) / 2) / (scale))
 85
 86#define TEMP_FROM_REG(reg)	((reg) * 1000)
 87#define TEMP_TO_REG(val)	((val) <= -127500 ? -128 : \
 88				 (val) >= 126500 ? 127 : \
 89				 (((val) < 0 ? (val) - 500 : \
 90				   (val) + 500) / 1000))
 91
 92/*
 93 * Client data (each client gets its own)
 94 */
 95
 96struct adm1025_data {
 97	struct i2c_client *client;
 98	const struct attribute_group *groups[3];
 99	struct mutex update_lock;
100	bool valid; /* false until following fields are valid */
101	unsigned long last_updated; /* in jiffies */
102
103	u8 in[6];		/* register value */
104	u8 in_max[6];		/* register value */
105	u8 in_min[6];		/* register value */
106	s8 temp[2];		/* register value */
107	s8 temp_min[2];		/* register value */
108	s8 temp_max[2];		/* register value */
109	u16 alarms;		/* register values, combined */
110	u8 vid;			/* register values, combined */
111	u8 vrm;
112};
113
114static struct adm1025_data *adm1025_update_device(struct device *dev)
115{
116	struct adm1025_data *data = dev_get_drvdata(dev);
117	struct i2c_client *client = data->client;
118
119	mutex_lock(&data->update_lock);
120
121	if (time_after(jiffies, data->last_updated + HZ * 2) || !data->valid) {
122		int i;
123
124		dev_dbg(&client->dev, "Updating data.\n");
125		for (i = 0; i < 6; i++) {
126			data->in[i] = i2c_smbus_read_byte_data(client,
127				      ADM1025_REG_IN(i));
128			data->in_min[i] = i2c_smbus_read_byte_data(client,
129					  ADM1025_REG_IN_MIN(i));
130			data->in_max[i] = i2c_smbus_read_byte_data(client,
131					  ADM1025_REG_IN_MAX(i));
132		}
133		for (i = 0; i < 2; i++) {
134			data->temp[i] = i2c_smbus_read_byte_data(client,
135					ADM1025_REG_TEMP(i));
136			data->temp_min[i] = i2c_smbus_read_byte_data(client,
137					    ADM1025_REG_TEMP_LOW(i));
138			data->temp_max[i] = i2c_smbus_read_byte_data(client,
139					    ADM1025_REG_TEMP_HIGH(i));
140		}
141		data->alarms = i2c_smbus_read_byte_data(client,
142			       ADM1025_REG_STATUS1)
143			     | (i2c_smbus_read_byte_data(client,
144				ADM1025_REG_STATUS2) << 8);
145		data->vid = (i2c_smbus_read_byte_data(client,
146			     ADM1025_REG_VID) & 0x0f)
147			  | ((i2c_smbus_read_byte_data(client,
148			      ADM1025_REG_VID4) & 0x01) << 4);
149
150		data->last_updated = jiffies;
151		data->valid = true;
152	}
153
154	mutex_unlock(&data->update_lock);
155
156	return data;
157}
158
159/*
160 * Sysfs stuff
161 */
162
163static ssize_t
164in_show(struct device *dev, struct device_attribute *attr, char *buf)
165{
166	int index = to_sensor_dev_attr(attr)->index;
167	struct adm1025_data *data = adm1025_update_device(dev);
168	return sprintf(buf, "%u\n", IN_FROM_REG(data->in[index],
169		       in_scale[index]));
170}
171
172static ssize_t
173in_min_show(struct device *dev, struct device_attribute *attr, char *buf)
174{
175	int index = to_sensor_dev_attr(attr)->index;
176	struct adm1025_data *data = adm1025_update_device(dev);
177	return sprintf(buf, "%u\n", IN_FROM_REG(data->in_min[index],
178		       in_scale[index]));
179}
180
181static ssize_t
182in_max_show(struct device *dev, struct device_attribute *attr, char *buf)
183{
184	int index = to_sensor_dev_attr(attr)->index;
185	struct adm1025_data *data = adm1025_update_device(dev);
186	return sprintf(buf, "%u\n", IN_FROM_REG(data->in_max[index],
187		       in_scale[index]));
188}
189
190static ssize_t
191temp_show(struct device *dev, struct device_attribute *attr, char *buf)
192{
193	int index = to_sensor_dev_attr(attr)->index;
194	struct adm1025_data *data = adm1025_update_device(dev);
195	return sprintf(buf, "%d\n", TEMP_FROM_REG(data->temp[index]));
196}
197
198static ssize_t
199temp_min_show(struct device *dev, struct device_attribute *attr, char *buf)
200{
201	int index = to_sensor_dev_attr(attr)->index;
202	struct adm1025_data *data = adm1025_update_device(dev);
203	return sprintf(buf, "%d\n", TEMP_FROM_REG(data->temp_min[index]));
204}
205
206static ssize_t
207temp_max_show(struct device *dev, struct device_attribute *attr, char *buf)
208{
209	int index = to_sensor_dev_attr(attr)->index;
210	struct adm1025_data *data = adm1025_update_device(dev);
211	return sprintf(buf, "%d\n", TEMP_FROM_REG(data->temp_max[index]));
212}
213
214static ssize_t in_min_store(struct device *dev, struct device_attribute *attr,
215			    const char *buf, size_t count)
216{
217	int index = to_sensor_dev_attr(attr)->index;
218	struct adm1025_data *data = dev_get_drvdata(dev);
219	struct i2c_client *client = data->client;
220	long val;
221	int err;
222
223	err = kstrtol(buf, 10, &val);
224	if (err)
225		return err;
226
227	mutex_lock(&data->update_lock);
228	data->in_min[index] = IN_TO_REG(val, in_scale[index]);
229	i2c_smbus_write_byte_data(client, ADM1025_REG_IN_MIN(index),
230				  data->in_min[index]);
231	mutex_unlock(&data->update_lock);
232	return count;
233}
234
235static ssize_t in_max_store(struct device *dev, struct device_attribute *attr,
236			    const char *buf, size_t count)
237{
238	int index = to_sensor_dev_attr(attr)->index;
239	struct adm1025_data *data = dev_get_drvdata(dev);
240	struct i2c_client *client = data->client;
241	long val;
242	int err;
243
244	err = kstrtol(buf, 10, &val);
245	if (err)
246		return err;
247
248	mutex_lock(&data->update_lock);
249	data->in_max[index] = IN_TO_REG(val, in_scale[index]);
250	i2c_smbus_write_byte_data(client, ADM1025_REG_IN_MAX(index),
251				  data->in_max[index]);
252	mutex_unlock(&data->update_lock);
253	return count;
254}
255
256static SENSOR_DEVICE_ATTR_RO(in0_input, in, 0);
257static SENSOR_DEVICE_ATTR_RW(in0_min, in_min, 0);
258static SENSOR_DEVICE_ATTR_RW(in0_max, in_max, 0);
259static SENSOR_DEVICE_ATTR_RO(in1_input, in, 1);
260static SENSOR_DEVICE_ATTR_RW(in1_min, in_min, 1);
261static SENSOR_DEVICE_ATTR_RW(in1_max, in_max, 1);
262static SENSOR_DEVICE_ATTR_RO(in2_input, in, 2);
263static SENSOR_DEVICE_ATTR_RW(in2_min, in_min, 2);
264static SENSOR_DEVICE_ATTR_RW(in2_max, in_max, 2);
265static SENSOR_DEVICE_ATTR_RO(in3_input, in, 3);
266static SENSOR_DEVICE_ATTR_RW(in3_min, in_min, 3);
267static SENSOR_DEVICE_ATTR_RW(in3_max, in_max, 3);
268static SENSOR_DEVICE_ATTR_RO(in4_input, in, 4);
269static SENSOR_DEVICE_ATTR_RW(in4_min, in_min, 4);
270static SENSOR_DEVICE_ATTR_RW(in4_max, in_max, 4);
271static SENSOR_DEVICE_ATTR_RO(in5_input, in, 5);
272static SENSOR_DEVICE_ATTR_RW(in5_min, in_min, 5);
273static SENSOR_DEVICE_ATTR_RW(in5_max, in_max, 5);
274
275static ssize_t temp_min_store(struct device *dev,
276			      struct device_attribute *attr, const char *buf,
277			      size_t count)
278{
279	int index = to_sensor_dev_attr(attr)->index;
280	struct adm1025_data *data = dev_get_drvdata(dev);
281	struct i2c_client *client = data->client;
282	long val;
283	int err;
284
285	err = kstrtol(buf, 10, &val);
286	if (err)
287		return err;
288
289	mutex_lock(&data->update_lock);
290	data->temp_min[index] = TEMP_TO_REG(val);
291	i2c_smbus_write_byte_data(client, ADM1025_REG_TEMP_LOW(index),
292				  data->temp_min[index]);
293	mutex_unlock(&data->update_lock);
294	return count;
295}
296
297static ssize_t temp_max_store(struct device *dev,
298			      struct device_attribute *attr, const char *buf,
299			      size_t count)
300{
301	int index = to_sensor_dev_attr(attr)->index;
302	struct adm1025_data *data = dev_get_drvdata(dev);
303	struct i2c_client *client = data->client;
304	long val;
305	int err;
306
307	err = kstrtol(buf, 10, &val);
308	if (err)
309		return err;
310
311	mutex_lock(&data->update_lock);
312	data->temp_max[index] = TEMP_TO_REG(val);
313	i2c_smbus_write_byte_data(client, ADM1025_REG_TEMP_HIGH(index),
314				  data->temp_max[index]);
315	mutex_unlock(&data->update_lock);
316	return count;
317}
318
319static SENSOR_DEVICE_ATTR_RO(temp1_input, temp, 0);
320static SENSOR_DEVICE_ATTR_RW(temp1_min, temp_min, 0);
321static SENSOR_DEVICE_ATTR_RW(temp1_max, temp_max, 0);
322static SENSOR_DEVICE_ATTR_RO(temp2_input, temp, 1);
323static SENSOR_DEVICE_ATTR_RW(temp2_min, temp_min, 1);
324static SENSOR_DEVICE_ATTR_RW(temp2_max, temp_max, 1);
 
 
 
325
326static ssize_t
327alarms_show(struct device *dev, struct device_attribute *attr, char *buf)
328{
329	struct adm1025_data *data = adm1025_update_device(dev);
330	return sprintf(buf, "%u\n", data->alarms);
331}
332static DEVICE_ATTR_RO(alarms);
333
334static ssize_t
335alarm_show(struct device *dev, struct device_attribute *attr, char *buf)
336{
337	int bitnr = to_sensor_dev_attr(attr)->index;
338	struct adm1025_data *data = adm1025_update_device(dev);
339	return sprintf(buf, "%u\n", (data->alarms >> bitnr) & 1);
340}
341static SENSOR_DEVICE_ATTR_RO(in0_alarm, alarm, 0);
342static SENSOR_DEVICE_ATTR_RO(in1_alarm, alarm, 1);
343static SENSOR_DEVICE_ATTR_RO(in2_alarm, alarm, 2);
344static SENSOR_DEVICE_ATTR_RO(in3_alarm, alarm, 3);
345static SENSOR_DEVICE_ATTR_RO(in4_alarm, alarm, 8);
346static SENSOR_DEVICE_ATTR_RO(in5_alarm, alarm, 9);
347static SENSOR_DEVICE_ATTR_RO(temp1_alarm, alarm, 5);
348static SENSOR_DEVICE_ATTR_RO(temp2_alarm, alarm, 4);
349static SENSOR_DEVICE_ATTR_RO(temp1_fault, alarm, 14);
350
351static ssize_t
352cpu0_vid_show(struct device *dev, struct device_attribute *attr, char *buf)
353{
354	struct adm1025_data *data = adm1025_update_device(dev);
355	return sprintf(buf, "%u\n", vid_from_reg(data->vid, data->vrm));
356}
357static DEVICE_ATTR_RO(cpu0_vid);
358
359static ssize_t
360vrm_show(struct device *dev, struct device_attribute *attr, char *buf)
361{
362	struct adm1025_data *data = dev_get_drvdata(dev);
363	return sprintf(buf, "%u\n", data->vrm);
364}
365static ssize_t vrm_store(struct device *dev, struct device_attribute *attr,
366			 const char *buf, size_t count)
367{
368	struct adm1025_data *data = dev_get_drvdata(dev);
369	unsigned long val;
370	int err;
371
372	err = kstrtoul(buf, 10, &val);
373	if (err)
374		return err;
375
376	if (val > 255)
377		return -EINVAL;
378
379	data->vrm = val;
380	return count;
381}
382static DEVICE_ATTR_RW(vrm);
383
384/*
385 * Real code
386 */
387
388static struct attribute *adm1025_attributes[] = {
389	&sensor_dev_attr_in0_input.dev_attr.attr,
390	&sensor_dev_attr_in1_input.dev_attr.attr,
391	&sensor_dev_attr_in2_input.dev_attr.attr,
392	&sensor_dev_attr_in3_input.dev_attr.attr,
393	&sensor_dev_attr_in5_input.dev_attr.attr,
394	&sensor_dev_attr_in0_min.dev_attr.attr,
395	&sensor_dev_attr_in1_min.dev_attr.attr,
396	&sensor_dev_attr_in2_min.dev_attr.attr,
397	&sensor_dev_attr_in3_min.dev_attr.attr,
398	&sensor_dev_attr_in5_min.dev_attr.attr,
399	&sensor_dev_attr_in0_max.dev_attr.attr,
400	&sensor_dev_attr_in1_max.dev_attr.attr,
401	&sensor_dev_attr_in2_max.dev_attr.attr,
402	&sensor_dev_attr_in3_max.dev_attr.attr,
403	&sensor_dev_attr_in5_max.dev_attr.attr,
404	&sensor_dev_attr_in0_alarm.dev_attr.attr,
405	&sensor_dev_attr_in1_alarm.dev_attr.attr,
406	&sensor_dev_attr_in2_alarm.dev_attr.attr,
407	&sensor_dev_attr_in3_alarm.dev_attr.attr,
408	&sensor_dev_attr_in5_alarm.dev_attr.attr,
409	&sensor_dev_attr_temp1_input.dev_attr.attr,
410	&sensor_dev_attr_temp2_input.dev_attr.attr,
411	&sensor_dev_attr_temp1_min.dev_attr.attr,
412	&sensor_dev_attr_temp2_min.dev_attr.attr,
413	&sensor_dev_attr_temp1_max.dev_attr.attr,
414	&sensor_dev_attr_temp2_max.dev_attr.attr,
415	&sensor_dev_attr_temp1_alarm.dev_attr.attr,
416	&sensor_dev_attr_temp2_alarm.dev_attr.attr,
417	&sensor_dev_attr_temp1_fault.dev_attr.attr,
418	&dev_attr_alarms.attr,
419	&dev_attr_cpu0_vid.attr,
420	&dev_attr_vrm.attr,
421	NULL
422};
423
424static const struct attribute_group adm1025_group = {
425	.attrs = adm1025_attributes,
426};
427
428static struct attribute *adm1025_attributes_in4[] = {
429	&sensor_dev_attr_in4_input.dev_attr.attr,
430	&sensor_dev_attr_in4_min.dev_attr.attr,
431	&sensor_dev_attr_in4_max.dev_attr.attr,
432	&sensor_dev_attr_in4_alarm.dev_attr.attr,
433	NULL
434};
435
436static const struct attribute_group adm1025_group_in4 = {
437	.attrs = adm1025_attributes_in4,
438};
439
440/* Return 0 if detection is successful, -ENODEV otherwise */
441static int adm1025_detect(struct i2c_client *client,
442			  struct i2c_board_info *info)
443{
444	struct i2c_adapter *adapter = client->adapter;
445	const char *name;
446	u8 man_id, chip_id;
447
448	if (!i2c_check_functionality(adapter, I2C_FUNC_SMBUS_BYTE_DATA))
449		return -ENODEV;
450
451	/* Check for unused bits */
452	if ((i2c_smbus_read_byte_data(client, ADM1025_REG_CONFIG) & 0x80)
453	 || (i2c_smbus_read_byte_data(client, ADM1025_REG_STATUS1) & 0xC0)
454	 || (i2c_smbus_read_byte_data(client, ADM1025_REG_STATUS2) & 0xBC)) {
455		dev_dbg(&adapter->dev, "ADM1025 detection failed at 0x%02x\n",
456			client->addr);
457		return -ENODEV;
458	}
459
460	/* Identification */
461	chip_id = i2c_smbus_read_byte_data(client, ADM1025_REG_CHIP_ID);
462	if ((chip_id & 0xF0) != 0x20)
463		return -ENODEV;
464
465	man_id = i2c_smbus_read_byte_data(client, ADM1025_REG_MAN_ID);
466	if (man_id == 0x41)
467		name = "adm1025";
468	else if (man_id == 0xA1 && client->addr != 0x2E)
469		name = "ne1619";
470	else
471		return -ENODEV;
472
473	strscpy(info->type, name, I2C_NAME_SIZE);
474
475	return 0;
476}
477
478static void adm1025_init_client(struct i2c_client *client)
479{
480	u8 reg;
481	struct adm1025_data *data = i2c_get_clientdata(client);
482	int i;
483
484	data->vrm = vid_which_vrm();
485
486	/*
487	 * Set high limits
488	 * Usually we avoid setting limits on driver init, but it happens
489	 * that the ADM1025 comes with stupid default limits (all registers
490	 * set to 0). In case the chip has not gone through any limit
491	 * setting yet, we better set the high limits to the max so that
492	 * no alarm triggers.
493	 */
494	for (i = 0; i < 6; i++) {
495		reg = i2c_smbus_read_byte_data(client,
496					       ADM1025_REG_IN_MAX(i));
497		if (reg == 0)
498			i2c_smbus_write_byte_data(client,
499						  ADM1025_REG_IN_MAX(i),
500						  0xFF);
501	}
502	for (i = 0; i < 2; i++) {
503		reg = i2c_smbus_read_byte_data(client,
504					       ADM1025_REG_TEMP_HIGH(i));
505		if (reg == 0)
506			i2c_smbus_write_byte_data(client,
507						  ADM1025_REG_TEMP_HIGH(i),
508						  0x7F);
509	}
510
511	/*
512	 * Start the conversions
513	 */
514	reg = i2c_smbus_read_byte_data(client, ADM1025_REG_CONFIG);
515	if (!(reg & 0x01))
516		i2c_smbus_write_byte_data(client, ADM1025_REG_CONFIG,
517					  (reg&0x7E)|0x01);
518}
519
520static int adm1025_probe(struct i2c_client *client)
 
521{
522	struct device *dev = &client->dev;
523	struct device *hwmon_dev;
524	struct adm1025_data *data;
525	u8 config;
526
527	data = devm_kzalloc(dev, sizeof(struct adm1025_data), GFP_KERNEL);
528	if (!data)
529		return -ENOMEM;
530
531	i2c_set_clientdata(client, data);
532	data->client = client;
533	mutex_init(&data->update_lock);
534
535	/* Initialize the ADM1025 chip */
536	adm1025_init_client(client);
537
538	/* sysfs hooks */
539	data->groups[0] = &adm1025_group;
540	/* Pin 11 is either in4 (+12V) or VID4 */
541	config = i2c_smbus_read_byte_data(client, ADM1025_REG_CONFIG);
542	if (!(config & 0x20))
543		data->groups[1] = &adm1025_group_in4;
544
545	hwmon_dev = devm_hwmon_device_register_with_groups(dev, client->name,
546							   data, data->groups);
547	return PTR_ERR_OR_ZERO(hwmon_dev);
548}
549
550static const struct i2c_device_id adm1025_id[] = {
551	{ "adm1025", adm1025 },
552	{ "ne1619", ne1619 },
553	{ }
554};
555MODULE_DEVICE_TABLE(i2c, adm1025_id);
556
557static struct i2c_driver adm1025_driver = {
558	.class		= I2C_CLASS_HWMON,
559	.driver = {
560		.name	= "adm1025",
561	},
562	.probe		= adm1025_probe,
563	.id_table	= adm1025_id,
564	.detect		= adm1025_detect,
565	.address_list	= normal_i2c,
566};
567
568module_i2c_driver(adm1025_driver);
569
570MODULE_AUTHOR("Jean Delvare <jdelvare@suse.de>");
571MODULE_DESCRIPTION("ADM1025 driver");
572MODULE_LICENSE("GPL");
v4.6
 
  1/*
  2 * adm1025.c
  3 *
  4 * Copyright (C) 2000       Chen-Yuan Wu <gwu@esoft.com>
  5 * Copyright (C) 2003-2009  Jean Delvare <jdelvare@suse.de>
  6 *
  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.onsemi.com/PowerSolutions/product.do?id=ADM1025
 16 *
 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
 20 * difference for us.
 21 *
 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
 28 *
 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.
 32 *
 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.
 37 *
 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.
 42 *
 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.
 46 */
 47
 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>
 58
 59/*
 60 * Addresses to scan
 61 * ADM1025 and ADM1025A have three possible addresses: 0x2c, 0x2d and 0x2e.
 62 * NE1619 has two possible addresses: 0x2c and 0x2d.
 63 */
 64
 65static const unsigned short normal_i2c[] = { 0x2c, 0x2d, 0x2e, I2C_CLIENT_END };
 66
 67enum chips { adm1025, ne1619 };
 68
 69/*
 70 * The ADM1025 registers
 71 */
 72
 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
 86
 87/*
 88 * Conversions and various macros
 89 * The ADM1025 uses signed 8-bit values for temperatures.
 90 */
 91
 92static const int in_scale[6] = { 2500, 2250, 3300, 5000, 12000, 3300 };
 93
 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))
 98
 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 : \
103				   (val) + 500) / 1000))
104
105/*
106 * Client data (each client gets its own)
107 */
108
109struct adm1025_data {
110	struct i2c_client *client;
111	const struct attribute_group *groups[3];
112	struct mutex update_lock;
113	char valid; /* zero until following fields are valid */
114	unsigned long last_updated; /* in jiffies */
115
116	u8 in[6];		/* register value */
117	u8 in_max[6];		/* register value */
118	u8 in_min[6];		/* register value */
119	s8 temp[2];		/* register value */
120	s8 temp_min[2];		/* register value */
121	s8 temp_max[2];		/* register value */
122	u16 alarms;		/* register values, combined */
123	u8 vid;			/* register values, combined */
124	u8 vrm;
125};
126
127static struct adm1025_data *adm1025_update_device(struct device *dev)
128{
129	struct adm1025_data *data = dev_get_drvdata(dev);
130	struct i2c_client *client = data->client;
131
132	mutex_lock(&data->update_lock);
133
134	if (time_after(jiffies, data->last_updated + HZ * 2) || !data->valid) {
135		int i;
136
137		dev_dbg(&client->dev, "Updating data.\n");
138		for (i = 0; i < 6; i++) {
139			data->in[i] = i2c_smbus_read_byte_data(client,
140				      ADM1025_REG_IN(i));
141			data->in_min[i] = i2c_smbus_read_byte_data(client,
142					  ADM1025_REG_IN_MIN(i));
143			data->in_max[i] = i2c_smbus_read_byte_data(client,
144					  ADM1025_REG_IN_MAX(i));
145		}
146		for (i = 0; i < 2; i++) {
147			data->temp[i] = i2c_smbus_read_byte_data(client,
148					ADM1025_REG_TEMP(i));
149			data->temp_min[i] = i2c_smbus_read_byte_data(client,
150					    ADM1025_REG_TEMP_LOW(i));
151			data->temp_max[i] = i2c_smbus_read_byte_data(client,
152					    ADM1025_REG_TEMP_HIGH(i));
153		}
154		data->alarms = i2c_smbus_read_byte_data(client,
155			       ADM1025_REG_STATUS1)
156			     | (i2c_smbus_read_byte_data(client,
157				ADM1025_REG_STATUS2) << 8);
158		data->vid = (i2c_smbus_read_byte_data(client,
159			     ADM1025_REG_VID) & 0x0f)
160			  | ((i2c_smbus_read_byte_data(client,
161			      ADM1025_REG_VID4) & 0x01) << 4);
162
163		data->last_updated = jiffies;
164		data->valid = 1;
165	}
166
167	mutex_unlock(&data->update_lock);
168
169	return data;
170}
171
172/*
173 * Sysfs stuff
174 */
175
176static ssize_t
177show_in(struct device *dev, struct device_attribute *attr, char *buf)
178{
179	int index = to_sensor_dev_attr(attr)->index;
180	struct adm1025_data *data = adm1025_update_device(dev);
181	return sprintf(buf, "%u\n", IN_FROM_REG(data->in[index],
182		       in_scale[index]));
183}
184
185static ssize_t
186show_in_min(struct device *dev, struct device_attribute *attr, char *buf)
187{
188	int index = to_sensor_dev_attr(attr)->index;
189	struct adm1025_data *data = adm1025_update_device(dev);
190	return sprintf(buf, "%u\n", IN_FROM_REG(data->in_min[index],
191		       in_scale[index]));
192}
193
194static ssize_t
195show_in_max(struct device *dev, struct device_attribute *attr, char *buf)
196{
197	int index = to_sensor_dev_attr(attr)->index;
198	struct adm1025_data *data = adm1025_update_device(dev);
199	return sprintf(buf, "%u\n", IN_FROM_REG(data->in_max[index],
200		       in_scale[index]));
201}
202
203static ssize_t
204show_temp(struct device *dev, struct device_attribute *attr, char *buf)
205{
206	int index = to_sensor_dev_attr(attr)->index;
207	struct adm1025_data *data = adm1025_update_device(dev);
208	return sprintf(buf, "%d\n", TEMP_FROM_REG(data->temp[index]));
209}
210
211static ssize_t
212show_temp_min(struct device *dev, struct device_attribute *attr, char *buf)
213{
214	int index = to_sensor_dev_attr(attr)->index;
215	struct adm1025_data *data = adm1025_update_device(dev);
216	return sprintf(buf, "%d\n", TEMP_FROM_REG(data->temp_min[index]));
217}
218
219static ssize_t
220show_temp_max(struct device *dev, struct device_attribute *attr, char *buf)
221{
222	int index = to_sensor_dev_attr(attr)->index;
223	struct adm1025_data *data = adm1025_update_device(dev);
224	return sprintf(buf, "%d\n", TEMP_FROM_REG(data->temp_max[index]));
225}
226
227static ssize_t set_in_min(struct device *dev, struct device_attribute *attr,
228			  const char *buf, size_t count)
229{
230	int index = to_sensor_dev_attr(attr)->index;
231	struct adm1025_data *data = dev_get_drvdata(dev);
232	struct i2c_client *client = data->client;
233	long val;
234	int err;
235
236	err = kstrtol(buf, 10, &val);
237	if (err)
238		return err;
239
240	mutex_lock(&data->update_lock);
241	data->in_min[index] = IN_TO_REG(val, in_scale[index]);
242	i2c_smbus_write_byte_data(client, ADM1025_REG_IN_MIN(index),
243				  data->in_min[index]);
244	mutex_unlock(&data->update_lock);
245	return count;
246}
247
248static ssize_t set_in_max(struct device *dev, struct device_attribute *attr,
249			  const char *buf, size_t count)
250{
251	int index = to_sensor_dev_attr(attr)->index;
252	struct adm1025_data *data = dev_get_drvdata(dev);
253	struct i2c_client *client = data->client;
254	long val;
255	int err;
256
257	err = kstrtol(buf, 10, &val);
258	if (err)
259		return err;
260
261	mutex_lock(&data->update_lock);
262	data->in_max[index] = IN_TO_REG(val, in_scale[index]);
263	i2c_smbus_write_byte_data(client, ADM1025_REG_IN_MAX(index),
264				  data->in_max[index]);
265	mutex_unlock(&data->update_lock);
266	return count;
267}
268
269#define set_in(offset) \
270static SENSOR_DEVICE_ATTR(in##offset##_input, S_IRUGO, \
271	show_in, NULL, offset); \
272static SENSOR_DEVICE_ATTR(in##offset##_min, S_IWUSR | S_IRUGO, \
273	show_in_min, set_in_min, offset); \
274static SENSOR_DEVICE_ATTR(in##offset##_max, S_IWUSR | S_IRUGO, \
275	show_in_max, set_in_max, offset)
276set_in(0);
277set_in(1);
278set_in(2);
279set_in(3);
280set_in(4);
281set_in(5);
282
283static ssize_t set_temp_min(struct device *dev, struct device_attribute *attr,
284			    const char *buf, size_t count)
 
 
 
 
 
 
285{
286	int index = to_sensor_dev_attr(attr)->index;
287	struct adm1025_data *data = dev_get_drvdata(dev);
288	struct i2c_client *client = data->client;
289	long val;
290	int err;
291
292	err = kstrtol(buf, 10, &val);
293	if (err)
294		return err;
295
296	mutex_lock(&data->update_lock);
297	data->temp_min[index] = TEMP_TO_REG(val);
298	i2c_smbus_write_byte_data(client, ADM1025_REG_TEMP_LOW(index),
299				  data->temp_min[index]);
300	mutex_unlock(&data->update_lock);
301	return count;
302}
303
304static ssize_t set_temp_max(struct device *dev, struct device_attribute *attr,
305	const char *buf, size_t count)
 
306{
307	int index = to_sensor_dev_attr(attr)->index;
308	struct adm1025_data *data = dev_get_drvdata(dev);
309	struct i2c_client *client = data->client;
310	long val;
311	int err;
312
313	err = kstrtol(buf, 10, &val);
314	if (err)
315		return err;
316
317	mutex_lock(&data->update_lock);
318	data->temp_max[index] = TEMP_TO_REG(val);
319	i2c_smbus_write_byte_data(client, ADM1025_REG_TEMP_HIGH(index),
320				  data->temp_max[index]);
321	mutex_unlock(&data->update_lock);
322	return count;
323}
324
325#define set_temp(offset) \
326static SENSOR_DEVICE_ATTR(temp##offset##_input, S_IRUGO, \
327	show_temp, NULL, offset - 1); \
328static SENSOR_DEVICE_ATTR(temp##offset##_min, S_IWUSR | S_IRUGO, \
329	show_temp_min, set_temp_min, offset - 1); \
330static SENSOR_DEVICE_ATTR(temp##offset##_max, S_IWUSR | S_IRUGO, \
331	show_temp_max, set_temp_max, offset - 1)
332set_temp(1);
333set_temp(2);
334
335static ssize_t
336show_alarms(struct device *dev, struct device_attribute *attr, char *buf)
337{
338	struct adm1025_data *data = adm1025_update_device(dev);
339	return sprintf(buf, "%u\n", data->alarms);
340}
341static DEVICE_ATTR(alarms, S_IRUGO, show_alarms, NULL);
342
343static ssize_t
344show_alarm(struct device *dev, struct device_attribute *attr, char *buf)
345{
346	int bitnr = to_sensor_dev_attr(attr)->index;
347	struct adm1025_data *data = adm1025_update_device(dev);
348	return sprintf(buf, "%u\n", (data->alarms >> bitnr) & 1);
349}
350static SENSOR_DEVICE_ATTR(in0_alarm, S_IRUGO, show_alarm, NULL, 0);
351static SENSOR_DEVICE_ATTR(in1_alarm, S_IRUGO, show_alarm, NULL, 1);
352static SENSOR_DEVICE_ATTR(in2_alarm, S_IRUGO, show_alarm, NULL, 2);
353static SENSOR_DEVICE_ATTR(in3_alarm, S_IRUGO, show_alarm, NULL, 3);
354static SENSOR_DEVICE_ATTR(in4_alarm, S_IRUGO, show_alarm, NULL, 8);
355static SENSOR_DEVICE_ATTR(in5_alarm, S_IRUGO, show_alarm, NULL, 9);
356static SENSOR_DEVICE_ATTR(temp1_alarm, S_IRUGO, show_alarm, NULL, 5);
357static SENSOR_DEVICE_ATTR(temp2_alarm, S_IRUGO, show_alarm, NULL, 4);
358static SENSOR_DEVICE_ATTR(temp1_fault, S_IRUGO, show_alarm, NULL, 14);
359
360static ssize_t
361show_vid(struct device *dev, struct device_attribute *attr, char *buf)
362{
363	struct adm1025_data *data = adm1025_update_device(dev);
364	return sprintf(buf, "%u\n", vid_from_reg(data->vid, data->vrm));
365}
366static DEVICE_ATTR(cpu0_vid, S_IRUGO, show_vid, NULL);
367
368static ssize_t
369show_vrm(struct device *dev, struct device_attribute *attr, char *buf)
370{
371	struct adm1025_data *data = dev_get_drvdata(dev);
372	return sprintf(buf, "%u\n", data->vrm);
373}
374static ssize_t set_vrm(struct device *dev, struct device_attribute *attr,
375		       const char *buf, size_t count)
376{
377	struct adm1025_data *data = dev_get_drvdata(dev);
378	unsigned long val;
379	int err;
380
381	err = kstrtoul(buf, 10, &val);
382	if (err)
383		return err;
384
385	if (val > 255)
386		return -EINVAL;
387
388	data->vrm = val;
389	return count;
390}
391static DEVICE_ATTR(vrm, S_IRUGO | S_IWUSR, show_vrm, set_vrm);
392
393/*
394 * Real code
395 */
396
397static struct attribute *adm1025_attributes[] = {
398	&sensor_dev_attr_in0_input.dev_attr.attr,
399	&sensor_dev_attr_in1_input.dev_attr.attr,
400	&sensor_dev_attr_in2_input.dev_attr.attr,
401	&sensor_dev_attr_in3_input.dev_attr.attr,
402	&sensor_dev_attr_in5_input.dev_attr.attr,
403	&sensor_dev_attr_in0_min.dev_attr.attr,
404	&sensor_dev_attr_in1_min.dev_attr.attr,
405	&sensor_dev_attr_in2_min.dev_attr.attr,
406	&sensor_dev_attr_in3_min.dev_attr.attr,
407	&sensor_dev_attr_in5_min.dev_attr.attr,
408	&sensor_dev_attr_in0_max.dev_attr.attr,
409	&sensor_dev_attr_in1_max.dev_attr.attr,
410	&sensor_dev_attr_in2_max.dev_attr.attr,
411	&sensor_dev_attr_in3_max.dev_attr.attr,
412	&sensor_dev_attr_in5_max.dev_attr.attr,
413	&sensor_dev_attr_in0_alarm.dev_attr.attr,
414	&sensor_dev_attr_in1_alarm.dev_attr.attr,
415	&sensor_dev_attr_in2_alarm.dev_attr.attr,
416	&sensor_dev_attr_in3_alarm.dev_attr.attr,
417	&sensor_dev_attr_in5_alarm.dev_attr.attr,
418	&sensor_dev_attr_temp1_input.dev_attr.attr,
419	&sensor_dev_attr_temp2_input.dev_attr.attr,
420	&sensor_dev_attr_temp1_min.dev_attr.attr,
421	&sensor_dev_attr_temp2_min.dev_attr.attr,
422	&sensor_dev_attr_temp1_max.dev_attr.attr,
423	&sensor_dev_attr_temp2_max.dev_attr.attr,
424	&sensor_dev_attr_temp1_alarm.dev_attr.attr,
425	&sensor_dev_attr_temp2_alarm.dev_attr.attr,
426	&sensor_dev_attr_temp1_fault.dev_attr.attr,
427	&dev_attr_alarms.attr,
428	&dev_attr_cpu0_vid.attr,
429	&dev_attr_vrm.attr,
430	NULL
431};
432
433static const struct attribute_group adm1025_group = {
434	.attrs = adm1025_attributes,
435};
436
437static struct attribute *adm1025_attributes_in4[] = {
438	&sensor_dev_attr_in4_input.dev_attr.attr,
439	&sensor_dev_attr_in4_min.dev_attr.attr,
440	&sensor_dev_attr_in4_max.dev_attr.attr,
441	&sensor_dev_attr_in4_alarm.dev_attr.attr,
442	NULL
443};
444
445static const struct attribute_group adm1025_group_in4 = {
446	.attrs = adm1025_attributes_in4,
447};
448
449/* Return 0 if detection is successful, -ENODEV otherwise */
450static int adm1025_detect(struct i2c_client *client,
451			  struct i2c_board_info *info)
452{
453	struct i2c_adapter *adapter = client->adapter;
454	const char *name;
455	u8 man_id, chip_id;
456
457	if (!i2c_check_functionality(adapter, I2C_FUNC_SMBUS_BYTE_DATA))
458		return -ENODEV;
459
460	/* Check for unused bits */
461	if ((i2c_smbus_read_byte_data(client, ADM1025_REG_CONFIG) & 0x80)
462	 || (i2c_smbus_read_byte_data(client, ADM1025_REG_STATUS1) & 0xC0)
463	 || (i2c_smbus_read_byte_data(client, ADM1025_REG_STATUS2) & 0xBC)) {
464		dev_dbg(&adapter->dev, "ADM1025 detection failed at 0x%02x\n",
465			client->addr);
466		return -ENODEV;
467	}
468
469	/* Identification */
470	chip_id = i2c_smbus_read_byte_data(client, ADM1025_REG_CHIP_ID);
471	if ((chip_id & 0xF0) != 0x20)
472		return -ENODEV;
473
474	man_id = i2c_smbus_read_byte_data(client, ADM1025_REG_MAN_ID);
475	if (man_id == 0x41)
476		name = "adm1025";
477	else if (man_id == 0xA1 && client->addr != 0x2E)
478		name = "ne1619";
479	else
480		return -ENODEV;
481
482	strlcpy(info->type, name, I2C_NAME_SIZE);
483
484	return 0;
485}
486
487static void adm1025_init_client(struct i2c_client *client)
488{
489	u8 reg;
490	struct adm1025_data *data = i2c_get_clientdata(client);
491	int i;
492
493	data->vrm = vid_which_vrm();
494
495	/*
496	 * Set high limits
497	 * Usually we avoid setting limits on driver init, but it happens
498	 * that the ADM1025 comes with stupid default limits (all registers
499	 * set to 0). In case the chip has not gone through any limit
500	 * setting yet, we better set the high limits to the max so that
501	 * no alarm triggers.
502	 */
503	for (i = 0; i < 6; i++) {
504		reg = i2c_smbus_read_byte_data(client,
505					       ADM1025_REG_IN_MAX(i));
506		if (reg == 0)
507			i2c_smbus_write_byte_data(client,
508						  ADM1025_REG_IN_MAX(i),
509						  0xFF);
510	}
511	for (i = 0; i < 2; i++) {
512		reg = i2c_smbus_read_byte_data(client,
513					       ADM1025_REG_TEMP_HIGH(i));
514		if (reg == 0)
515			i2c_smbus_write_byte_data(client,
516						  ADM1025_REG_TEMP_HIGH(i),
517						  0x7F);
518	}
519
520	/*
521	 * Start the conversions
522	 */
523	reg = i2c_smbus_read_byte_data(client, ADM1025_REG_CONFIG);
524	if (!(reg & 0x01))
525		i2c_smbus_write_byte_data(client, ADM1025_REG_CONFIG,
526					  (reg&0x7E)|0x01);
527}
528
529static int adm1025_probe(struct i2c_client *client,
530			 const struct i2c_device_id *id)
531{
532	struct device *dev = &client->dev;
533	struct device *hwmon_dev;
534	struct adm1025_data *data;
535	u8 config;
536
537	data = devm_kzalloc(dev, sizeof(struct adm1025_data), GFP_KERNEL);
538	if (!data)
539		return -ENOMEM;
540
541	i2c_set_clientdata(client, data);
542	data->client = client;
543	mutex_init(&data->update_lock);
544
545	/* Initialize the ADM1025 chip */
546	adm1025_init_client(client);
547
548	/* sysfs hooks */
549	data->groups[0] = &adm1025_group;
550	/* Pin 11 is either in4 (+12V) or VID4 */
551	config = i2c_smbus_read_byte_data(client, ADM1025_REG_CONFIG);
552	if (!(config & 0x20))
553		data->groups[1] = &adm1025_group_in4;
554
555	hwmon_dev = devm_hwmon_device_register_with_groups(dev, client->name,
556							   data, data->groups);
557	return PTR_ERR_OR_ZERO(hwmon_dev);
558}
559
560static const struct i2c_device_id adm1025_id[] = {
561	{ "adm1025", adm1025 },
562	{ "ne1619", ne1619 },
563	{ }
564};
565MODULE_DEVICE_TABLE(i2c, adm1025_id);
566
567static struct i2c_driver adm1025_driver = {
568	.class		= I2C_CLASS_HWMON,
569	.driver = {
570		.name	= "adm1025",
571	},
572	.probe		= adm1025_probe,
573	.id_table	= adm1025_id,
574	.detect		= adm1025_detect,
575	.address_list	= normal_i2c,
576};
577
578module_i2c_driver(adm1025_driver);
579
580MODULE_AUTHOR("Jean Delvare <jdelvare@suse.de>");
581MODULE_DESCRIPTION("ADM1025 driver");
582MODULE_LICENSE("GPL");