drivers/staging/iio/dac/max517.c

   1 /*
   2  *  max517.c - Support for Maxim MAX517, MAX518 and MAX519
   3  *
   4  *  Copyright (C) 2010, 2011 Roland Stigge <stigge@antcom.de>
   5  *
   6  *  This program is free software; you can redistribute it and/or modify
   7  *  it under the terms of the GNU General Public License as published by
   8  *  the Free Software Foundation; either version 2 of the License, or
   9  *  (at your option) any later version.
  10  *
  11  *  This program is distributed in the hope that it will be useful,
  12  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14  *  GNU General Public License for more details.
  15  *
  16  *  You should have received a copy of the GNU General Public License
  17  *  along with this program; if not, write to the Free Software
  18  *  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  19  */
  20
  21 #include <linux/module.h>
  22 #include <linux/init.h>
  23 #include <linux/slab.h>
  24 #include <linux/jiffies.h>
  25 #include <linux/i2c.h>
  26 #include <linux/err.h>
  27
  28 #include "../iio.h"
  29 #include "../sysfs.h"
  30 #include "dac.h"
  31
  32 #include "max517.h"
  33
  34 #define MAX517_DRV_NAME "max517"
  35
  36 /* Commands */
  37 #define COMMAND_CHANNEL0        0x00
  38 #define COMMAND_CHANNEL1        0x01 /* for MAX518 and MAX519 */
  39 #define COMMAND_PD              0x08 /* Power Down */
  40
  41 enum max517_device_ids {
  42         ID_MAX517,
  43         ID_MAX518,
  44         ID_MAX519,
  45 };
  46
  47 struct max517_data {
  48         struct iio_dev          *indio_dev;
  49         struct i2c_client       *client;
  50         unsigned short          vref_mv[2];
  51 };
  52
  53 /*
  54  * channel: bit 0: channel 1
  55  *          bit 1: channel 2
  56  * (this way, it's possible to set both channels at once)
  57  */
  58 static ssize_t max517_set_value(struct device *dev,
  59                                  struct device_attribute *attr,
  60                                  const char *buf, size_t count, int channel)
  61 {
  62         struct iio_dev *dev_info = dev_get_drvdata(dev);
  63         struct max517_data *data = iio_priv(dev_info);
  64         struct i2c_client *client = data->client;
  65         u8 outbuf[4]; /* 1x or 2x command + value */
  66         int outbuf_size = 0;
  67         int res;
  68         long val;
  69
  70         res = strict_strtol(buf, 10, &val);
  71
  72         if (res)
  73                 return res;
  74
  75         if (val < 0 || val > 255)
  76                 return -EINVAL;
  77
  78         if (channel & 1) {
  79                 outbuf[outbuf_size++] = COMMAND_CHANNEL0;
  80                 outbuf[outbuf_size++] = val;
  81         }
  82         if (channel & 2) {
  83                 outbuf[outbuf_size++] = COMMAND_CHANNEL1;
  84                 outbuf[outbuf_size++] = val;
  85         }
  86
  87         /*
  88          * At this point, there are always 1 or 2 two-byte commands in
  89          * outbuf. With 2 commands, the device can set two outputs
  90          * simultaneously, latching the values upon the end of the I2C
  91          * transfer.
  92          */
  93
  94         res = i2c_master_send(client, outbuf, outbuf_size);
  95         if (res < 0)
  96                 return res;
  97
  98         return count;
  99 }
 100
 101 static ssize_t max517_set_value_1(struct device *dev,
 102                                  struct device_attribute *attr,
 103                                  const char *buf, size_t count)
 104 {
 105         return max517_set_value(dev, attr, buf, count, 1);
 106 }
 107 static IIO_DEV_ATTR_OUT_RAW(1, max517_set_value_1, 0);
 108
 109 static ssize_t max517_set_value_2(struct device *dev,
 110                                  struct device_attribute *attr,
 111                                  const char *buf, size_t count)
 112 {
 113         return max517_set_value(dev, attr, buf, count, 2);
 114 }
 115 static IIO_DEV_ATTR_OUT_RAW(2, max517_set_value_2, 1);
 116
 117 static ssize_t max517_set_value_both(struct device *dev,
 118                                  struct device_attribute *attr,
 119                                  const char *buf, size_t count)
 120 {
 121         return max517_set_value(dev, attr, buf, count, 3);
 122 }
 123 static IIO_DEVICE_ATTR_NAMED(out1and2_raw, out1&2_raw, S_IWUSR, NULL,
 124                 max517_set_value_both, -1);
 125
 126 static ssize_t max517_show_scale(struct device *dev,
 127                                 struct device_attribute *attr,
 128                                 char *buf, int channel)
 129 {
 130         struct iio_dev *dev_info = dev_get_drvdata(dev);
 131         struct max517_data *data = iio_priv(dev_info);
 132         /* Corresponds to Vref / 2^(bits) */
 133         unsigned int scale_uv = (data->vref_mv[channel - 1] * 1000) >> 8;
 134
 135         return sprintf(buf, "%d.%03d\n", scale_uv / 1000, scale_uv % 1000);
 136 }
 137
 138 static ssize_t max517_show_scale1(struct device *dev,
 139                                 struct device_attribute *attr,
 140                                 char *buf)
 141 {
 142         return max517_show_scale(dev, attr, buf, 1);
 143 }
 144 static IIO_DEVICE_ATTR(out1_scale, S_IRUGO, max517_show_scale1, NULL, 0);
 145
 146 static ssize_t max517_show_scale2(struct device *dev,
 147                                 struct device_attribute *attr,
 148                                 char *buf)
 149 {
 150         return max517_show_scale(dev, attr, buf, 2);
 151 }
 152 static IIO_DEVICE_ATTR(out2_scale, S_IRUGO, max517_show_scale2, NULL, 0);
 153
 154 /* On MAX517 variant, we have one output */
 155 static struct attribute *max517_attributes[] = {
 156         &iio_dev_attr_out1_raw.dev_attr.attr,
 157         &iio_dev_attr_out1_scale.dev_attr.attr,
 158         NULL
 159 };
 160
 161 static struct attribute_group max517_attribute_group = {
 162         .attrs = max517_attributes,
 163 };
 164
 165 /* On MAX518 and MAX519 variant, we have two outputs */
 166 static struct attribute *max518_attributes[] = {
 167         &iio_dev_attr_out1_raw.dev_attr.attr,
 168         &iio_dev_attr_out1_scale.dev_attr.attr,
 169         &iio_dev_attr_out2_raw.dev_attr.attr,
 170         &iio_dev_attr_out2_scale.dev_attr.attr,
 171         &iio_dev_attr_out1and2_raw.dev_attr.attr,
 172         NULL
 173 };
 174
 175 static struct attribute_group max518_attribute_group = {
 176         .attrs = max518_attributes,
 177 };
 178
 179 static int max517_suspend(struct i2c_client *client, pm_message_t mesg)
 180 {
 181         u8 outbuf = COMMAND_PD;
 182
 183         return i2c_master_send(client, &outbuf, 1);
 184 }
 185
 186 static int max517_resume(struct i2c_client *client)
 187 {
 188         u8 outbuf = 0;
 189
 190         return i2c_master_send(client, &outbuf, 1);
 191 }
 192
 193 static const struct iio_info max517_info = {
 194         .attrs = &max517_attribute_group,
 195         .driver_module = THIS_MODULE,
 196 };
 197
 198 static const struct iio_info max518_info = {
 199         .attrs = &max518_attribute_group,
 200         .driver_module = THIS_MODULE,
 201 };
 202
 203 static int max517_probe(struct i2c_client *client,
 204                         const struct i2c_device_id *id)
 205 {
 206         struct max517_data *data;
 207         struct iio_dev *indio_dev;
 208         struct max517_platform_data *platform_data = client->dev.platform_data;
 209         int err;
 210
 211         indio_dev = iio_allocate_device(sizeof(*data));
 212         if (indio_dev == NULL) {
 213                 err = -ENOMEM;
 214                 goto exit;
 215         }
 216         data = iio_priv(indio_dev);
 217         i2c_set_clientdata(client, indio_dev);
 218         data->client = client;
 219
 220         /* establish that the iio_dev is a child of the i2c device */
 221         indio_dev->dev.parent = &client->dev;
 222
 223         /* reduced attribute set for MAX517 */
 224         if (id->driver_data == ID_MAX517)
 225                 indio_dev->info = &max517_info;
 226         else
 227                 indio_dev->info = &max518_info;
 228         indio_dev->modes = INDIO_DIRECT_MODE;
 229
 230         /*
 231          * Reference voltage on MAX518 and default is 5V, else take vref_mv
 232          * from platform_data
 233          */
 234         if (id->driver_data == ID_MAX518 || !platform_data) {
 235                 data->vref_mv[0] = data->vref_mv[1] = 5000; /* mV */
 236         } else {
 237                 data->vref_mv[0] = platform_data->vref_mv[0];
 238                 data->vref_mv[1] = platform_data->vref_mv[1];
 239         }
 240
 241         err = iio_device_register(indio_dev);
 242         if (err)
 243                 goto exit_free_device;
 244
 245         dev_info(&client->dev, "DAC registered\n");
 246
 247         return 0;
 248
 249 exit_free_device:
 250         iio_free_device(indio_dev);
 251 exit:
 252         return err;
 253 }
 254
 255 static int max517_remove(struct i2c_client *client)
 256 {
 257         iio_free_device(i2c_get_clientdata(client));
 258
 259         return 0;
 260 }
 261
 262 static const struct i2c_device_id max517_id[] = {
 263         { "max517", ID_MAX517 },
 264         { "max518", ID_MAX518 },
 265         { "max519", ID_MAX519 },
 266         { }
 267 };
 268 MODULE_DEVICE_TABLE(i2c, max517_id);
 269
 270 static struct i2c_driver max517_driver = {
 271         .driver = {
 272                 .name   = MAX517_DRV_NAME,
 273         },
 274         .probe          = max517_probe,
 275         .remove         = max517_remove,
 276         .suspend        = max517_suspend,
 277         .resume         = max517_resume,
 278         .id_table       = max517_id,
 279 };
 280
 281 static int __init max517_init(void)
 282 {
 283         return i2c_add_driver(&max517_driver);
 284 }
 285
 286 static void __exit max517_exit(void)
 287 {
 288         i2c_del_driver(&max517_driver);
 289 }
 290
 291 MODULE_AUTHOR("Roland Stigge <stigge@antcom.de>");
 292 MODULE_DESCRIPTION("MAX517/MAX518/MAX519 8-bit DAC");
 293 MODULE_LICENSE("GPL");
 294
 295 module_init(max517_init);
 296 module_exit(max517_exit);