Linux-2.6.12-rc2
[cascardo/linux.git] / drivers / i2c / chips / adm1025.c
1 /*
2  * adm1025.c
3  *
4  * Copyright (C) 2000       Chen-Yuan Wu <gwu@esoft.com>
5  * Copyright (C) 2003-2004  Jean Delvare <khali@linux-fr.org>
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.analog.com/Analog_Root/productPage/productHome/0,2121,ADM1025,00.html
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/config.h>
49 #include <linux/module.h>
50 #include <linux/init.h>
51 #include <linux/slab.h>
52 #include <linux/jiffies.h>
53 #include <linux/i2c.h>
54 #include <linux/i2c-sensor.h>
55 #include <linux/i2c-vid.h>
56
57 /*
58  * Addresses to scan
59  * ADM1025 and ADM1025A have three possible addresses: 0x2c, 0x2d and 0x2e.
60  * NE1619 has two possible addresses: 0x2c and 0x2d.
61  */
62
63 static unsigned short normal_i2c[] = { 0x2c, 0x2d, 0x2e, I2C_CLIENT_END };
64 static unsigned int normal_isa[] = { I2C_CLIENT_ISA_END };
65
66 /*
67  * Insmod parameters
68  */
69
70 SENSORS_INSMOD_2(adm1025, ne1619);
71
72 /*
73  * The ADM1025 registers
74  */
75
76 #define ADM1025_REG_MAN_ID              0x3E
77 #define ADM1025_REG_CHIP_ID             0x3F
78 #define ADM1025_REG_CONFIG              0x40
79 #define ADM1025_REG_STATUS1             0x41
80 #define ADM1025_REG_STATUS2             0x42
81 #define ADM1025_REG_IN(nr)              (0x20 + (nr))
82 #define ADM1025_REG_IN_MAX(nr)          (0x2B + (nr) * 2)
83 #define ADM1025_REG_IN_MIN(nr)          (0x2C + (nr) * 2)
84 #define ADM1025_REG_TEMP(nr)            (0x26 + (nr))
85 #define ADM1025_REG_TEMP_HIGH(nr)       (0x37 + (nr) * 2)
86 #define ADM1025_REG_TEMP_LOW(nr)        (0x38 + (nr) * 2)
87 #define ADM1025_REG_VID                 0x47
88 #define ADM1025_REG_VID4                0x49
89
90 /*
91  * Conversions and various macros
92  * The ADM1025 uses signed 8-bit values for temperatures.
93  */
94
95 static int in_scale[6] = { 2500, 2250, 3300, 5000, 12000, 3300 };
96
97 #define IN_FROM_REG(reg,scale)  (((reg) * (scale) + 96) / 192)
98 #define IN_TO_REG(val,scale)    ((val) <= 0 ? 0 : \
99                                  (val) * 192 >= (scale) * 255 ? 255 : \
100                                  ((val) * 192 + (scale)/2) / (scale))
101
102 #define TEMP_FROM_REG(reg)      ((reg) * 1000)
103 #define TEMP_TO_REG(val)        ((val) <= -127500 ? -128 : \
104                                  (val) >= 126500 ? 127 : \
105                                  (((val) < 0 ? (val)-500 : (val)+500) / 1000))
106
107 /*
108  * Functions declaration
109  */
110
111 static int adm1025_attach_adapter(struct i2c_adapter *adapter);
112 static int adm1025_detect(struct i2c_adapter *adapter, int address, int kind);
113 static void adm1025_init_client(struct i2c_client *client);
114 static int adm1025_detach_client(struct i2c_client *client);
115 static struct adm1025_data *adm1025_update_device(struct device *dev);
116
117 /*
118  * Driver data (common to all clients)
119  */
120
121 static struct i2c_driver adm1025_driver = {
122         .owner          = THIS_MODULE,
123         .name           = "adm1025",
124         .id             = I2C_DRIVERID_ADM1025,
125         .flags          = I2C_DF_NOTIFY,
126         .attach_adapter = adm1025_attach_adapter,
127         .detach_client  = adm1025_detach_client,
128 };
129
130 /*
131  * Client data (each client gets its own)
132  */
133
134 struct adm1025_data {
135         struct i2c_client client;
136         struct semaphore update_lock;
137         char valid; /* zero until following fields are valid */
138         unsigned long last_updated; /* in jiffies */
139
140         u8 in[6];               /* register value */
141         u8 in_max[6];           /* register value */
142         u8 in_min[6];           /* register value */
143         s8 temp[2];             /* register value */
144         s8 temp_min[2];         /* register value */
145         s8 temp_max[2];         /* register value */
146         u16 alarms;             /* register values, combined */
147         u8 vid;                 /* register values, combined */
148         u8 vrm;
149 };
150
151 /*
152  * Sysfs stuff
153  */
154
155 #define show_in(offset) \
156 static ssize_t show_in##offset(struct device *dev, char *buf) \
157 { \
158         struct adm1025_data *data = adm1025_update_device(dev); \
159         return sprintf(buf, "%u\n", IN_FROM_REG(data->in[offset], \
160                        in_scale[offset])); \
161 } \
162 static ssize_t show_in##offset##_min(struct device *dev, char *buf) \
163 { \
164         struct adm1025_data *data = adm1025_update_device(dev); \
165         return sprintf(buf, "%u\n", IN_FROM_REG(data->in_min[offset], \
166                        in_scale[offset])); \
167 } \
168 static ssize_t show_in##offset##_max(struct device *dev, char *buf) \
169 { \
170         struct adm1025_data *data = adm1025_update_device(dev); \
171         return sprintf(buf, "%u\n", IN_FROM_REG(data->in_max[offset], \
172                        in_scale[offset])); \
173 } \
174 static DEVICE_ATTR(in##offset##_input, S_IRUGO, show_in##offset, NULL);
175 show_in(0);
176 show_in(1);
177 show_in(2);
178 show_in(3);
179 show_in(4);
180 show_in(5);
181
182 #define show_temp(offset) \
183 static ssize_t show_temp##offset(struct device *dev, char *buf) \
184 { \
185         struct adm1025_data *data = adm1025_update_device(dev); \
186         return sprintf(buf, "%d\n", TEMP_FROM_REG(data->temp[offset-1])); \
187 } \
188 static ssize_t show_temp##offset##_min(struct device *dev, char *buf) \
189 { \
190         struct adm1025_data *data = adm1025_update_device(dev); \
191         return sprintf(buf, "%d\n", TEMP_FROM_REG(data->temp_min[offset-1])); \
192 } \
193 static ssize_t show_temp##offset##_max(struct device *dev, char *buf) \
194 { \
195         struct adm1025_data *data = adm1025_update_device(dev); \
196         return sprintf(buf, "%d\n", TEMP_FROM_REG(data->temp_max[offset-1])); \
197 }\
198 static DEVICE_ATTR(temp##offset##_input, S_IRUGO, show_temp##offset, NULL);
199 show_temp(1);
200 show_temp(2);
201
202 #define set_in(offset) \
203 static ssize_t set_in##offset##_min(struct device *dev, const char *buf, \
204         size_t count) \
205 { \
206         struct i2c_client *client = to_i2c_client(dev); \
207         struct adm1025_data *data = i2c_get_clientdata(client); \
208         long val = simple_strtol(buf, NULL, 10); \
209  \
210         down(&data->update_lock); \
211         data->in_min[offset] = IN_TO_REG(val, in_scale[offset]); \
212         i2c_smbus_write_byte_data(client, ADM1025_REG_IN_MIN(offset), \
213                                   data->in_min[offset]); \
214         up(&data->update_lock); \
215         return count; \
216 } \
217 static ssize_t set_in##offset##_max(struct device *dev, const char *buf, \
218         size_t count) \
219 { \
220         struct i2c_client *client = to_i2c_client(dev); \
221         struct adm1025_data *data = i2c_get_clientdata(client); \
222         long val = simple_strtol(buf, NULL, 10); \
223  \
224         down(&data->update_lock); \
225         data->in_max[offset] = IN_TO_REG(val, in_scale[offset]); \
226         i2c_smbus_write_byte_data(client, ADM1025_REG_IN_MAX(offset), \
227                                   data->in_max[offset]); \
228         up(&data->update_lock); \
229         return count; \
230 } \
231 static DEVICE_ATTR(in##offset##_min, S_IWUSR | S_IRUGO, \
232         show_in##offset##_min, set_in##offset##_min); \
233 static DEVICE_ATTR(in##offset##_max, S_IWUSR | S_IRUGO, \
234         show_in##offset##_max, set_in##offset##_max);
235 set_in(0);
236 set_in(1);
237 set_in(2);
238 set_in(3);
239 set_in(4);
240 set_in(5);
241
242 #define set_temp(offset) \
243 static ssize_t set_temp##offset##_min(struct device *dev, const char *buf, \
244         size_t count) \
245 { \
246         struct i2c_client *client = to_i2c_client(dev); \
247         struct adm1025_data *data = i2c_get_clientdata(client); \
248         long val = simple_strtol(buf, NULL, 10); \
249  \
250         down(&data->update_lock); \
251         data->temp_min[offset-1] = TEMP_TO_REG(val); \
252         i2c_smbus_write_byte_data(client, ADM1025_REG_TEMP_LOW(offset-1), \
253                                   data->temp_min[offset-1]); \
254         up(&data->update_lock); \
255         return count; \
256 } \
257 static ssize_t set_temp##offset##_max(struct device *dev, const char *buf, \
258         size_t count) \
259 { \
260         struct i2c_client *client = to_i2c_client(dev); \
261         struct adm1025_data *data = i2c_get_clientdata(client); \
262         long val = simple_strtol(buf, NULL, 10); \
263  \
264         down(&data->update_lock); \
265         data->temp_max[offset-1] = TEMP_TO_REG(val); \
266         i2c_smbus_write_byte_data(client, ADM1025_REG_TEMP_HIGH(offset-1), \
267                                   data->temp_max[offset-1]); \
268         up(&data->update_lock); \
269         return count; \
270 } \
271 static DEVICE_ATTR(temp##offset##_min, S_IWUSR | S_IRUGO, \
272         show_temp##offset##_min, set_temp##offset##_min); \
273 static DEVICE_ATTR(temp##offset##_max, S_IWUSR | S_IRUGO, \
274         show_temp##offset##_max, set_temp##offset##_max);
275 set_temp(1);
276 set_temp(2);
277
278 static ssize_t show_alarms(struct device *dev, char *buf)
279 {
280         struct adm1025_data *data = adm1025_update_device(dev);
281         return sprintf(buf, "%u\n", data->alarms);
282 }
283 static DEVICE_ATTR(alarms, S_IRUGO, show_alarms, NULL);
284
285 static ssize_t show_vid(struct device *dev, char *buf)
286 {
287         struct adm1025_data *data = adm1025_update_device(dev);
288         return sprintf(buf, "%u\n", vid_from_reg(data->vid, data->vrm));
289 }
290 static DEVICE_ATTR(in1_ref, S_IRUGO, show_vid, NULL);
291
292 static ssize_t show_vrm(struct device *dev, char *buf)
293 {
294         struct adm1025_data *data = adm1025_update_device(dev);
295         return sprintf(buf, "%u\n", data->vrm);
296 }
297 static ssize_t set_vrm(struct device *dev, const char *buf, size_t count)
298 {
299         struct i2c_client *client = to_i2c_client(dev);
300         struct adm1025_data *data = i2c_get_clientdata(client);
301         data->vrm = simple_strtoul(buf, NULL, 10);
302         return count;
303 }
304 static DEVICE_ATTR(vrm, S_IRUGO | S_IWUSR, show_vrm, set_vrm);
305
306 /*
307  * Real code
308  */
309
310 static int adm1025_attach_adapter(struct i2c_adapter *adapter)
311 {
312         if (!(adapter->class & I2C_CLASS_HWMON))
313                 return 0;
314         return i2c_detect(adapter, &addr_data, adm1025_detect);
315 }
316
317 /*
318  * The following function does more than just detection. If detection
319  * succeeds, it also registers the new chip.
320  */
321 static int adm1025_detect(struct i2c_adapter *adapter, int address, int kind)
322 {
323         struct i2c_client *new_client;
324         struct adm1025_data *data;
325         int err = 0;
326         const char *name = "";
327         u8 config;
328
329         if (!i2c_check_functionality(adapter, I2C_FUNC_SMBUS_BYTE_DATA))
330                 goto exit;
331
332         if (!(data = kmalloc(sizeof(struct adm1025_data), GFP_KERNEL))) {
333                 err = -ENOMEM;
334                 goto exit;
335         }
336         memset(data, 0, sizeof(struct adm1025_data));
337
338         /* The common I2C client data is placed right before the
339            ADM1025-specific data. */
340         new_client = &data->client;
341         i2c_set_clientdata(new_client, data);
342         new_client->addr = address;
343         new_client->adapter = adapter;
344         new_client->driver = &adm1025_driver;
345         new_client->flags = 0;
346
347         /*
348          * Now we do the remaining detection. A negative kind means that
349          * the driver was loaded with no force parameter (default), so we
350          * must both detect and identify the chip. A zero kind means that
351          * the driver was loaded with the force parameter, the detection
352          * step shall be skipped. A positive kind means that the driver
353          * was loaded with the force parameter and a given kind of chip is
354          * requested, so both the detection and the identification steps
355          * are skipped.
356          */
357         config = i2c_smbus_read_byte_data(new_client, ADM1025_REG_CONFIG);
358         if (kind < 0) { /* detection */
359                 if ((config & 0x80) != 0x00
360                  || (i2c_smbus_read_byte_data(new_client,
361                      ADM1025_REG_STATUS1) & 0xC0) != 0x00
362                  || (i2c_smbus_read_byte_data(new_client,
363                      ADM1025_REG_STATUS2) & 0xBC) != 0x00) {
364                         dev_dbg(&adapter->dev,
365                                 "ADM1025 detection failed at 0x%02x.\n",
366                                 address);
367                         goto exit_free;
368                 }
369         }
370
371         if (kind <= 0) { /* identification */
372                 u8 man_id, chip_id;
373
374                 man_id = i2c_smbus_read_byte_data(new_client,
375                          ADM1025_REG_MAN_ID);
376                 chip_id = i2c_smbus_read_byte_data(new_client,
377                           ADM1025_REG_CHIP_ID);
378                 
379                 if (man_id == 0x41) { /* Analog Devices */
380                         if ((chip_id & 0xF0) == 0x20) { /* ADM1025/ADM1025A */
381                                 kind = adm1025;
382                         }
383                 } else
384                 if (man_id == 0xA1) { /* Philips */
385                         if (address != 0x2E
386                          && (chip_id & 0xF0) == 0x20) { /* NE1619 */
387                                 kind = ne1619;
388                         }
389                 }
390
391                 if (kind <= 0) { /* identification failed */
392                         dev_info(&adapter->dev,
393                             "Unsupported chip (man_id=0x%02X, "
394                             "chip_id=0x%02X).\n", man_id, chip_id);
395                         goto exit_free;
396                 }
397         }
398
399         if (kind == adm1025) {
400                 name = "adm1025";
401         } else if (kind == ne1619) {
402                 name = "ne1619";
403         }
404
405         /* We can fill in the remaining client fields */
406         strlcpy(new_client->name, name, I2C_NAME_SIZE);
407         data->valid = 0;
408         init_MUTEX(&data->update_lock);
409
410         /* Tell the I2C layer a new client has arrived */
411         if ((err = i2c_attach_client(new_client)))
412                 goto exit_free;
413
414         /* Initialize the ADM1025 chip */
415         adm1025_init_client(new_client);
416
417         /* Register sysfs hooks */
418         device_create_file(&new_client->dev, &dev_attr_in0_input);
419         device_create_file(&new_client->dev, &dev_attr_in1_input);
420         device_create_file(&new_client->dev, &dev_attr_in2_input);
421         device_create_file(&new_client->dev, &dev_attr_in3_input);
422         device_create_file(&new_client->dev, &dev_attr_in5_input);
423         device_create_file(&new_client->dev, &dev_attr_in0_min);
424         device_create_file(&new_client->dev, &dev_attr_in1_min);
425         device_create_file(&new_client->dev, &dev_attr_in2_min);
426         device_create_file(&new_client->dev, &dev_attr_in3_min);
427         device_create_file(&new_client->dev, &dev_attr_in5_min);
428         device_create_file(&new_client->dev, &dev_attr_in0_max);
429         device_create_file(&new_client->dev, &dev_attr_in1_max);
430         device_create_file(&new_client->dev, &dev_attr_in2_max);
431         device_create_file(&new_client->dev, &dev_attr_in3_max);
432         device_create_file(&new_client->dev, &dev_attr_in5_max);
433         device_create_file(&new_client->dev, &dev_attr_temp1_input);
434         device_create_file(&new_client->dev, &dev_attr_temp2_input);
435         device_create_file(&new_client->dev, &dev_attr_temp1_min);
436         device_create_file(&new_client->dev, &dev_attr_temp2_min);
437         device_create_file(&new_client->dev, &dev_attr_temp1_max);
438         device_create_file(&new_client->dev, &dev_attr_temp2_max);
439         device_create_file(&new_client->dev, &dev_attr_alarms);
440         device_create_file(&new_client->dev, &dev_attr_in1_ref);
441         device_create_file(&new_client->dev, &dev_attr_vrm);
442
443         /* Pin 11 is either in4 (+12V) or VID4 */
444         if (!(config & 0x20)) {
445                 device_create_file(&new_client->dev, &dev_attr_in4_input);
446                 device_create_file(&new_client->dev, &dev_attr_in4_min);
447                 device_create_file(&new_client->dev, &dev_attr_in4_max);
448         }
449
450         return 0;
451
452 exit_free:
453         kfree(data);
454 exit:
455         return err;
456 }
457
458 static void adm1025_init_client(struct i2c_client *client)
459 {
460         u8 reg;
461         struct adm1025_data *data = i2c_get_clientdata(client);
462         int i;
463
464         data->vrm = i2c_which_vrm();
465
466         /*
467          * Set high limits
468          * Usually we avoid setting limits on driver init, but it happens
469          * that the ADM1025 comes with stupid default limits (all registers
470          * set to 0). In case the chip has not gone through any limit
471          * setting yet, we better set the high limits to the max so that
472          * no alarm triggers.
473          */
474         for (i=0; i<6; i++) {
475                 reg = i2c_smbus_read_byte_data(client,
476                                                ADM1025_REG_IN_MAX(i));
477                 if (reg == 0)
478                         i2c_smbus_write_byte_data(client,
479                                                   ADM1025_REG_IN_MAX(i),
480                                                   0xFF);
481         }
482         for (i=0; i<2; i++) {
483                 reg = i2c_smbus_read_byte_data(client,
484                                                ADM1025_REG_TEMP_HIGH(i));
485                 if (reg == 0)
486                         i2c_smbus_write_byte_data(client,
487                                                   ADM1025_REG_TEMP_HIGH(i),
488                                                   0x7F);
489         }
490
491         /*
492          * Start the conversions
493          */
494         reg = i2c_smbus_read_byte_data(client, ADM1025_REG_CONFIG);
495         if (!(reg & 0x01))
496                 i2c_smbus_write_byte_data(client, ADM1025_REG_CONFIG,
497                                           (reg&0x7E)|0x01);
498 }
499
500 static int adm1025_detach_client(struct i2c_client *client)
501 {
502         int err;
503
504         if ((err = i2c_detach_client(client))) {
505                 dev_err(&client->dev, "Client deregistration failed, "
506                         "client not detached.\n");
507                 return err;
508         }
509
510         kfree(i2c_get_clientdata(client));
511         return 0;
512 }
513
514 static struct adm1025_data *adm1025_update_device(struct device *dev)
515 {
516         struct i2c_client *client = to_i2c_client(dev);
517         struct adm1025_data *data = i2c_get_clientdata(client);
518
519         down(&data->update_lock);
520
521         if (time_after(jiffies, data->last_updated + HZ * 2) || !data->valid) {
522                 int i;
523
524                 dev_dbg(&client->dev, "Updating data.\n");
525                 for (i=0; i<6; i++) {
526                         data->in[i] = i2c_smbus_read_byte_data(client,
527                                       ADM1025_REG_IN(i));
528                         data->in_min[i] = i2c_smbus_read_byte_data(client,
529                                           ADM1025_REG_IN_MIN(i));
530                         data->in_max[i] = i2c_smbus_read_byte_data(client,
531                                           ADM1025_REG_IN_MAX(i));
532                 }
533                 for (i=0; i<2; i++) {
534                         data->temp[i] = i2c_smbus_read_byte_data(client,
535                                         ADM1025_REG_TEMP(i));
536                         data->temp_min[i] = i2c_smbus_read_byte_data(client,
537                                             ADM1025_REG_TEMP_LOW(i));
538                         data->temp_max[i] = i2c_smbus_read_byte_data(client,
539                                             ADM1025_REG_TEMP_HIGH(i));
540                 }
541                 data->alarms = i2c_smbus_read_byte_data(client,
542                                ADM1025_REG_STATUS1)
543                              | (i2c_smbus_read_byte_data(client,
544                                 ADM1025_REG_STATUS2) << 8);
545                 data->vid = (i2c_smbus_read_byte_data(client,
546                              ADM1025_REG_VID) & 0x0f)
547                           | ((i2c_smbus_read_byte_data(client,
548                               ADM1025_REG_VID4) & 0x01) << 4);
549
550                 data->last_updated = jiffies;
551                 data->valid = 1;
552         }
553
554         up(&data->update_lock);
555
556         return data;
557 }
558
559 static int __init sensors_adm1025_init(void)
560 {
561         return i2c_add_driver(&adm1025_driver);
562 }
563
564 static void __exit sensors_adm1025_exit(void)
565 {
566         i2c_del_driver(&adm1025_driver);
567 }
568
569 MODULE_AUTHOR("Jean Delvare <khali@linux-fr.org>");
570 MODULE_DESCRIPTION("ADM1025 driver");
571 MODULE_LICENSE("GPL");
572
573 module_init(sensors_adm1025_init);
574 module_exit(sensors_adm1025_exit);