drivers/hwmon/ds1621.c

   1 /*
   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  *
   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  *
  13  * The DS1625, DS1631, and DS1721 are pin compatible with the DS1621 and
  14  * similar in operation, with slight variations as noted in the device
  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  *
  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  */
  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>
  42 #include <linux/hwmon.h>
  43 #include <linux/hwmon-sysfs.h>
  44 #include <linux/err.h>
  45 #include <linux/mutex.h>
  46 #include <linux/sysfs.h>
  47 #include <linux/kernel.h>
  48
  49 /* Supported devices */
  50 enum chips { ds1621, ds1625, ds1631, ds1721 };
  51
  52 /* Insmod parameters */
  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
  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  *
  68  * - DS1631:
  69  *   7    6    5    4    3    2    1    0
  70  * |Done|THF |TLF |NVB | R1 | R0 |POL |1SHOT|
  71  *
  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  */
  80 #define DS1621_REG_CONFIG_NVB           0x10
  81 #define DS1621_REG_CONFIG_RESOL         0x0C
  82 #define DS1621_REG_CONFIG_POLARITY      0x02
  83 #define DS1621_REG_CONFIG_1SHOT         0x01
  84 #define DS1621_REG_CONFIG_DONE          0x80
  85
  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 */
 103 static const u8 DS1621_REG_TEMP[3] = {
 104         0xAA,           /* input, word, RO */
 105         0xA2,           /* min, word, RW */
 106         0xA1,           /* max, word, RW */
 107 };
 108 #define DS1621_REG_CONF                 0xAC /* byte, RW */
 109 #define DS1621_COM_START                0xEE /* no data */
 110 #define DS1721_COM_START                0x51 /* no data */
 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
 117 /* Conversions */
 118 #define ALARMS_FROM_REG(val) ((val) & \
 119                         (DS1621_ALARM_TEMP_HIGH | DS1621_ALARM_TEMP_LOW))
 120
 121 /* Each client has this additional data */
 122 struct ds1621_data {
 123         struct device *hwmon_dev;
 124         struct mutex update_lock;
 125         char valid;                     /* !=0 if following fields are valid */
 126         unsigned long last_updated;     /* In jiffies */
 127         enum chips kind;                /* device type */
 128
 129         u16 temp[3];                    /* Register values, word */
 130         u8 conf;                        /* Register encoding, combined */
 131         u16 update_interval;            /* Conversion rate in milliseconds */
 132 };
 133
 134 static inline int DS1621_TEMP_FROM_REG(u16 reg)
 135 {
 136         return DIV_ROUND_CLOSEST(((s16)reg / 16) * 625, 10);
 137 }
 138
 139 /*
 140  * TEMP: 0.001C/bit (-55C to +125C)
 141  * REG:
 142  *  - 1621, 1625: 0.5C/bit
 143  *  - 1631, 1721: 0.0625C/bit
 144  * Assume highest resolution and let the bits fall where they may..
 145  */
 146 static inline u16 DS1621_TEMP_TO_REG(long temp)
 147 {
 148         int ntemp = clamp_val(temp, DS1621_TEMP_MIN, DS1621_TEMP_MAX);
 149         ntemp += (ntemp < 0 ? -31 : 31);
 150         ntemp = DIV_ROUND_CLOSEST(ntemp * 10, 625) << 4;
 151         return (u16)ntemp;
 152 }
 153
 154 static void ds1621_init_client(struct i2c_client *client)
 155 {
 156         u8 conf, new_conf, sreg, resol;
 157         struct ds1621_data *data = i2c_get_clientdata(client);
 158
 159         new_conf = conf = i2c_smbus_read_byte_data(client, DS1621_REG_CONF);
 160         /* switch to continuous conversion mode */
 161         new_conf &= ~DS1621_REG_CONFIG_1SHOT;
 162
 163         /* setup output polarity */
 164         if (polarity == 0)
 165                 new_conf &= ~DS1621_REG_CONFIG_POLARITY;
 166         else if (polarity == 1)
 167                 new_conf |= DS1621_REG_CONFIG_POLARITY;
 168
 169         if (conf != new_conf)
 170                 i2c_smbus_write_byte_data(client, DS1621_REG_CONF, new_conf);
 171
 172         switch (data->kind) {
 173         case ds1625:
 174                 data->update_interval = DS1625_CONVERSION_MAX;
 175                 sreg = DS1621_COM_START;
 176                 break;
 177         case ds1631:
 178         case ds1721:
 179                 resol = (new_conf & DS1621_REG_CONFIG_RESOL) >>
 180                          DS1621_REG_CONFIG_RESOL_SHIFT;
 181                 data->update_interval = ds1721_convrates[resol];
 182                 sreg = DS1721_COM_START;
 183                 break;
 184         default:
 185                 data->update_interval = DS1621_CONVERSION_MAX;
 186                 sreg = DS1621_COM_START;
 187                 break;
 188         }
 189
 190         /* start conversion */
 191         i2c_smbus_write_byte(client, sreg);
 192 }
 193
 194 static struct ds1621_data *ds1621_update_client(struct device *dev)
 195 {
 196         struct i2c_client *client = to_i2c_client(dev);
 197         struct ds1621_data *data = i2c_get_clientdata(client);
 198         u8 new_conf;
 199
 200         mutex_lock(&data->update_lock);
 201
 202         if (time_after(jiffies, data->last_updated + data->update_interval) ||
 203             !data->valid) {
 204                 int i;
 205
 206                 dev_dbg(&client->dev, "Starting ds1621 update\n");
 207
 208                 data->conf = i2c_smbus_read_byte_data(client, DS1621_REG_CONF);
 209
 210                 for (i = 0; i < ARRAY_SIZE(data->temp); i++)
 211                         data->temp[i] = i2c_smbus_read_word_swapped(client,
 212                                                          DS1621_REG_TEMP[i]);
 213
 214                 /* reset alarms if necessary */
 215                 new_conf = data->conf;
 216                 if (data->temp[0] > data->temp[1])      /* input > min */
 217                         new_conf &= ~DS1621_ALARM_TEMP_LOW;
 218                 if (data->temp[0] < data->temp[2])      /* input < max */
 219                         new_conf &= ~DS1621_ALARM_TEMP_HIGH;
 220                 if (data->conf != new_conf)
 221                         i2c_smbus_write_byte_data(client, DS1621_REG_CONF,
 222                                                   new_conf);
 223
 224                 data->last_updated = jiffies;
 225                 data->valid = 1;
 226         }
 227
 228         mutex_unlock(&data->update_lock);
 229
 230         return data;
 231 }
 232
 233 static ssize_t show_temp(struct device *dev, struct device_attribute *da,
 234                          char *buf)
 235 {
 236         struct sensor_device_attribute *attr = to_sensor_dev_attr(da);
 237         struct ds1621_data *data = ds1621_update_client(dev);
 238         return sprintf(buf, "%d\n",
 239                        DS1621_TEMP_FROM_REG(data->temp[attr->index]));
 240 }
 241
 242 static ssize_t set_temp(struct device *dev, struct device_attribute *da,
 243                         const char *buf, size_t count)
 244 {
 245         struct sensor_device_attribute *attr = to_sensor_dev_attr(da);
 246         struct i2c_client *client = to_i2c_client(dev);
 247         struct ds1621_data *data = i2c_get_clientdata(client);
 248         long val;
 249         int err;
 250
 251         err = kstrtol(buf, 10, &val);
 252         if (err)
 253                 return err;
 254
 255         mutex_lock(&data->update_lock);
 256         data->temp[attr->index] = DS1621_TEMP_TO_REG(val);
 257         i2c_smbus_write_word_swapped(client, DS1621_REG_TEMP[attr->index],
 258                                      data->temp[attr->index]);
 259         mutex_unlock(&data->update_lock);
 260         return count;
 261 }
 262
 263 static ssize_t show_alarms(struct device *dev, struct device_attribute *da,
 264                            char *buf)
 265 {
 266         struct ds1621_data *data = ds1621_update_client(dev);
 267         return sprintf(buf, "%d\n", ALARMS_FROM_REG(data->conf));
 268 }
 269
 270 static ssize_t show_alarm(struct device *dev, struct device_attribute *da,
 271                           char *buf)
 272 {
 273         struct sensor_device_attribute *attr = to_sensor_dev_attr(da);
 274         struct ds1621_data *data = ds1621_update_client(dev);
 275         return sprintf(buf, "%d\n", !!(data->conf & attr->index));
 276 }
 277
 278 static ssize_t show_convrate(struct device *dev, struct device_attribute *da,
 279                           char *buf)
 280 {
 281         struct i2c_client *client = to_i2c_client(dev);
 282         struct ds1621_data *data = i2c_get_clientdata(client);
 283         return scnprintf(buf, PAGE_SIZE, "%hu\n", data->update_interval);
 284 }
 285
 286 static ssize_t set_convrate(struct device *dev, struct device_attribute *da,
 287                             const char *buf, size_t count)
 288 {
 289         struct i2c_client *client = to_i2c_client(dev);
 290         struct ds1621_data *data = i2c_get_clientdata(client);
 291         unsigned long convrate;
 292         s32 err;
 293         int resol = 0;
 294
 295         err = kstrtoul(buf, 10, &convrate);
 296         if (err)
 297                 return err;
 298
 299         /* Convert rate into resolution bits */
 300         while (resol < (ARRAY_SIZE(ds1721_convrates) - 1) &&
 301                convrate > ds1721_convrates[resol])
 302                 resol++;
 303
 304         mutex_lock(&data->update_lock);
 305         data->conf = i2c_smbus_read_byte_data(client, DS1621_REG_CONF);
 306         data->conf &= ~DS1621_REG_CONFIG_RESOL;
 307         data->conf |= (resol << DS1621_REG_CONFIG_RESOL_SHIFT);
 308         i2c_smbus_write_byte_data(client, DS1621_REG_CONF, data->conf);
 309         data->update_interval = ds1721_convrates[resol];
 310         mutex_unlock(&data->update_lock);
 311
 312         return count;
 313 }
 314
 315 static DEVICE_ATTR(alarms, S_IRUGO, show_alarms, NULL);
 316 static DEVICE_ATTR(update_interval, S_IWUSR | S_IRUGO, show_convrate,
 317                    set_convrate);
 318
 319 static SENSOR_DEVICE_ATTR(temp1_input, S_IRUGO, show_temp, NULL, 0);
 320 static SENSOR_DEVICE_ATTR(temp1_min, S_IWUSR | S_IRUGO, show_temp, set_temp, 1);
 321 static SENSOR_DEVICE_ATTR(temp1_max, S_IWUSR | S_IRUGO, show_temp, set_temp, 2);
 322 static SENSOR_DEVICE_ATTR(temp1_min_alarm, S_IRUGO, show_alarm, NULL,
 323                 DS1621_ALARM_TEMP_LOW);
 324 static SENSOR_DEVICE_ATTR(temp1_max_alarm, S_IRUGO, show_alarm, NULL,
 325                 DS1621_ALARM_TEMP_HIGH);
 326
 327 static struct attribute *ds1621_attributes[] = {
 328         &sensor_dev_attr_temp1_input.dev_attr.attr,
 329         &sensor_dev_attr_temp1_min.dev_attr.attr,
 330         &sensor_dev_attr_temp1_max.dev_attr.attr,
 331         &sensor_dev_attr_temp1_min_alarm.dev_attr.attr,
 332         &sensor_dev_attr_temp1_max_alarm.dev_attr.attr,
 333         &dev_attr_alarms.attr,
 334         &dev_attr_update_interval.attr,
 335         NULL
 336 };
 337
 338 static umode_t ds1621_attribute_visible(struct kobject *kobj,
 339                                         struct attribute *attr, int index)
 340 {
 341         struct device *dev = container_of(kobj, struct device, kobj);
 342         struct i2c_client *client = to_i2c_client(dev);
 343         struct ds1621_data *data = i2c_get_clientdata(client);
 344
 345         if (attr == &dev_attr_update_interval.attr)
 346                 if (data->kind == ds1621 || data->kind == ds1625)
 347                         /* shhh, we're hiding update_interval */
 348                         return 0;
 349         return attr->mode;
 350 }
 351
 352 static const struct attribute_group ds1621_group = {
 353         .attrs = ds1621_attributes,
 354         .is_visible = ds1621_attribute_visible
 355 };
 356
 357 static int ds1621_probe(struct i2c_client *client,
 358                         const struct i2c_device_id *id)
 359 {
 360         struct ds1621_data *data;
 361         int err;
 362
 363         data = devm_kzalloc(&client->dev, sizeof(struct ds1621_data),
 364                             GFP_KERNEL);
 365         if (!data)
 366                 return -ENOMEM;
 367
 368         i2c_set_clientdata(client, data);
 369         mutex_init(&data->update_lock);
 370
 371         data->kind = id->driver_data;
 372
 373         /* Initialize the DS1621 chip */
 374         ds1621_init_client(client);
 375
 376         /* Register sysfs hooks */
 377         err = sysfs_create_group(&client->dev.kobj, &ds1621_group);
 378         if (err)
 379                 return err;
 380
 381         data->hwmon_dev = hwmon_device_register(&client->dev);
 382         if (IS_ERR(data->hwmon_dev)) {
 383                 err = PTR_ERR(data->hwmon_dev);
 384                 goto exit_remove_files;
 385         }
 386
 387         return 0;
 388
 389  exit_remove_files:
 390         sysfs_remove_group(&client->dev.kobj, &ds1621_group);
 391         return err;
 392 }
 393
 394 static int ds1621_remove(struct i2c_client *client)
 395 {
 396         struct ds1621_data *data = i2c_get_clientdata(client);
 397
 398         hwmon_device_unregister(data->hwmon_dev);
 399         sysfs_remove_group(&client->dev.kobj, &ds1621_group);
 400
 401         return 0;
 402 }
 403
 404 static const struct i2c_device_id ds1621_id[] = {
 405         { "ds1621", ds1621 },
 406         { "ds1625", ds1625 },
 407         { "ds1631", ds1631 },
 408         { "ds1721", ds1721 },
 409         { }
 410 };
 411 MODULE_DEVICE_TABLE(i2c, ds1621_id);
 412
 413 /* This is the driver that will be inserted */
 414 static struct i2c_driver ds1621_driver = {
 415         .class          = I2C_CLASS_HWMON,
 416         .driver = {
 417                 .name   = "ds1621",
 418         },
 419         .probe          = ds1621_probe,
 420         .remove         = ds1621_remove,
 421         .id_table       = ds1621_id,
 422 };
 423
 424 module_i2c_driver(ds1621_driver);
 425
 426 MODULE_AUTHOR("Christian W. Zuckschwerdt <zany@triq.net>");
 427 MODULE_DESCRIPTION("DS1621 driver");
 428 MODULE_LICENSE("GPL");