drivers/iio/potentiometer/mcp4531.c

   1 /*
   2  * Industrial I/O driver for Microchip digital potentiometers
   3  * Copyright (c) 2015  Axentia Technologies AB
   4  * Author: Peter Rosin <peda@axentia.se>
   5  *
   6  * Datasheet: http://www.microchip.com/downloads/en/DeviceDoc/22096b.pdf
   7  *
   8  * DEVID        #Wipers #Positions      Resistor Opts (kOhm)    i2c address
   9  * mcp4531      1       129             5, 10, 50, 100          010111x
  10  * mcp4532      1       129             5, 10, 50, 100          01011xx
  11  * mcp4541      1       129             5, 10, 50, 100          010111x
  12  * mcp4542      1       129             5, 10, 50, 100          01011xx
  13  * mcp4551      1       257             5, 10, 50, 100          010111x
  14  * mcp4552      1       257             5, 10, 50, 100          01011xx
  15  * mcp4561      1       257             5, 10, 50, 100          010111x
  16  * mcp4562      1       257             5, 10, 50, 100          01011xx
  17  * mcp4631      2       129             5, 10, 50, 100          0101xxx
  18  * mcp4632      2       129             5, 10, 50, 100          01011xx
  19  * mcp4641      2       129             5, 10, 50, 100          0101xxx
  20  * mcp4642      2       129             5, 10, 50, 100          01011xx
  21  * mcp4651      2       257             5, 10, 50, 100          0101xxx
  22  * mcp4652      2       257             5, 10, 50, 100          01011xx
  23  * mcp4661      2       257             5, 10, 50, 100          0101xxx
  24  * mcp4662      2       257             5, 10, 50, 100          01011xx
  25  *
  26  * This program is free software; you can redistribute it and/or modify it
  27  * under the terms of the GNU General Public License version 2 as published by
  28  * the Free Software Foundation.
  29  */
  30
  31 #include <linux/module.h>
  32 #include <linux/i2c.h>
  33 #include <linux/err.h>
  34 #include <linux/of.h>
  35 #include <linux/of_device.h>
  36
  37 #include <linux/iio/iio.h>
  38
  39 struct mcp4531_cfg {
  40         int wipers;
  41         int avail[3];
  42         int kohms;
  43 };
  44
  45 enum mcp4531_type {
  46         MCP453x_502,
  47         MCP453x_103,
  48         MCP453x_503,
  49         MCP453x_104,
  50         MCP454x_502,
  51         MCP454x_103,
  52         MCP454x_503,
  53         MCP454x_104,
  54         MCP455x_502,
  55         MCP455x_103,
  56         MCP455x_503,
  57         MCP455x_104,
  58         MCP456x_502,
  59         MCP456x_103,
  60         MCP456x_503,
  61         MCP456x_104,
  62         MCP463x_502,
  63         MCP463x_103,
  64         MCP463x_503,
  65         MCP463x_104,
  66         MCP464x_502,
  67         MCP464x_103,
  68         MCP464x_503,
  69         MCP464x_104,
  70         MCP465x_502,
  71         MCP465x_103,
  72         MCP465x_503,
  73         MCP465x_104,
  74         MCP466x_502,
  75         MCP466x_103,
  76         MCP466x_503,
  77         MCP466x_104,
  78 };
  79
  80 static const struct mcp4531_cfg mcp4531_cfg[] = {
  81         [MCP453x_502] = { .wipers = 1, .avail = { 0, 1, 128 }, .kohms =   5, },
  82         [MCP453x_103] = { .wipers = 1, .avail = { 0, 1, 128 }, .kohms =  10, },
  83         [MCP453x_503] = { .wipers = 1, .avail = { 0, 1, 128 }, .kohms =  50, },
  84         [MCP453x_104] = { .wipers = 1, .avail = { 0, 1, 128 }, .kohms = 100, },
  85         [MCP454x_502] = { .wipers = 1, .avail = { 0, 1, 128 }, .kohms =   5, },
  86         [MCP454x_103] = { .wipers = 1, .avail = { 0, 1, 128 }, .kohms =  10, },
  87         [MCP454x_503] = { .wipers = 1, .avail = { 0, 1, 128 }, .kohms =  50, },
  88         [MCP454x_104] = { .wipers = 1, .avail = { 0, 1, 128 }, .kohms = 100, },
  89         [MCP455x_502] = { .wipers = 1, .avail = { 0, 1, 256 }, .kohms =   5, },
  90         [MCP455x_103] = { .wipers = 1, .avail = { 0, 1, 256 }, .kohms =  10, },
  91         [MCP455x_503] = { .wipers = 1, .avail = { 0, 1, 256 }, .kohms =  50, },
  92         [MCP455x_104] = { .wipers = 1, .avail = { 0, 1, 256 }, .kohms = 100, },
  93         [MCP456x_502] = { .wipers = 1, .avail = { 0, 1, 256 }, .kohms =   5, },
  94         [MCP456x_103] = { .wipers = 1, .avail = { 0, 1, 256 }, .kohms =  10, },
  95         [MCP456x_503] = { .wipers = 1, .avail = { 0, 1, 256 }, .kohms =  50, },
  96         [MCP456x_104] = { .wipers = 1, .avail = { 0, 1, 256 }, .kohms = 100, },
  97         [MCP463x_502] = { .wipers = 2, .avail = { 0, 1, 128 }, .kohms =   5, },
  98         [MCP463x_103] = { .wipers = 2, .avail = { 0, 1, 128 }, .kohms =  10, },
  99         [MCP463x_503] = { .wipers = 2, .avail = { 0, 1, 128 }, .kohms =  50, },
 100         [MCP463x_104] = { .wipers = 2, .avail = { 0, 1, 128 }, .kohms = 100, },
 101         [MCP464x_502] = { .wipers = 2, .avail = { 0, 1, 128 }, .kohms =   5, },
 102         [MCP464x_103] = { .wipers = 2, .avail = { 0, 1, 128 }, .kohms =  10, },
 103         [MCP464x_503] = { .wipers = 2, .avail = { 0, 1, 128 }, .kohms =  50, },
 104         [MCP464x_104] = { .wipers = 2, .avail = { 0, 1, 128 }, .kohms = 100, },
 105         [MCP465x_502] = { .wipers = 2, .avail = { 0, 1, 256 }, .kohms =   5, },
 106         [MCP465x_103] = { .wipers = 2, .avail = { 0, 1, 256 }, .kohms =  10, },
 107         [MCP465x_503] = { .wipers = 2, .avail = { 0, 1, 256 }, .kohms =  50, },
 108         [MCP465x_104] = { .wipers = 2, .avail = { 0, 1, 256 }, .kohms = 100, },
 109         [MCP466x_502] = { .wipers = 2, .avail = { 0, 1, 256 }, .kohms =   5, },
 110         [MCP466x_103] = { .wipers = 2, .avail = { 0, 1, 256 }, .kohms =  10, },
 111         [MCP466x_503] = { .wipers = 2, .avail = { 0, 1, 256 }, .kohms =  50, },
 112         [MCP466x_104] = { .wipers = 2, .avail = { 0, 1, 256 }, .kohms = 100, },
 113 };
 114
 115 #define MCP4531_WRITE (0 << 2)
 116 #define MCP4531_INCR  (1 << 2)
 117 #define MCP4531_DECR  (2 << 2)
 118 #define MCP4531_READ  (3 << 2)
 119
 120 #define MCP4531_WIPER_SHIFT (4)
 121
 122 struct mcp4531_data {
 123         struct i2c_client *client;
 124         const struct mcp4531_cfg *cfg;
 125 };
 126
 127 #define MCP4531_CHANNEL(ch) {                                           \
 128         .type = IIO_RESISTANCE,                                         \
 129         .indexed = 1,                                                   \
 130         .output = 1,                                                    \
 131         .channel = (ch),                                                \
 132         .info_mask_separate = BIT(IIO_CHAN_INFO_RAW),                   \
 133         .info_mask_shared_by_type = BIT(IIO_CHAN_INFO_SCALE),           \
 134         .info_mask_shared_by_type_available = BIT(IIO_CHAN_INFO_RAW),   \
 135 }
 136
 137 static const struct iio_chan_spec mcp4531_channels[] = {
 138         MCP4531_CHANNEL(0),
 139         MCP4531_CHANNEL(1),
 140 };
 141
 142 static int mcp4531_read_raw(struct iio_dev *indio_dev,
 143                             struct iio_chan_spec const *chan,
 144                             int *val, int *val2, long mask)
 145 {
 146         struct mcp4531_data *data = iio_priv(indio_dev);
 147         int address = chan->channel << MCP4531_WIPER_SHIFT;
 148         s32 ret;
 149
 150         switch (mask) {
 151         case IIO_CHAN_INFO_RAW:
 152                 ret = i2c_smbus_read_word_swapped(data->client,
 153                                                   MCP4531_READ | address);
 154                 if (ret < 0)
 155                         return ret;
 156                 *val = ret;
 157                 return IIO_VAL_INT;
 158         case IIO_CHAN_INFO_SCALE:
 159                 *val = 1000 * data->cfg->kohms;
 160                 *val2 = data->cfg->avail[2];
 161                 return IIO_VAL_FRACTIONAL;
 162         }
 163
 164         return -EINVAL;
 165 }
 166
 167 static int mcp4531_read_avail(struct iio_dev *indio_dev,
 168                               struct iio_chan_spec const *chan,
 169                               const int **vals, int *type, int *length,
 170                               long mask)
 171 {
 172         struct mcp4531_data *data = iio_priv(indio_dev);
 173
 174         switch (mask) {
 175         case IIO_CHAN_INFO_RAW:
 176                 *length = ARRAY_SIZE(data->cfg->avail);
 177                 *vals = data->cfg->avail;
 178                 *type = IIO_VAL_INT;
 179                 return IIO_AVAIL_RANGE;
 180         }
 181
 182         return -EINVAL;
 183 }
 184
 185 static int mcp4531_write_raw(struct iio_dev *indio_dev,
 186                              struct iio_chan_spec const *chan,
 187                              int val, int val2, long mask)
 188 {
 189         struct mcp4531_data *data = iio_priv(indio_dev);
 190         int address = chan->channel << MCP4531_WIPER_SHIFT;
 191
 192         switch (mask) {
 193         case IIO_CHAN_INFO_RAW:
 194                 if (val > data->cfg->avail[2] || val < 0)
 195                         return -EINVAL;
 196                 break;
 197         default:
 198                 return -EINVAL;
 199         }
 200
 201         return i2c_smbus_write_byte_data(data->client,
 202                                          MCP4531_WRITE | address | (val >> 8),
 203                                          val & 0xff);
 204 }
 205
 206 static const struct iio_info mcp4531_info = {
 207         .read_raw = mcp4531_read_raw,
 208         .read_avail = mcp4531_read_avail,
 209         .write_raw = mcp4531_write_raw,
 210         .driver_module = THIS_MODULE,
 211 };
 212
 213 #ifdef CONFIG_OF
 214
 215 #define MCP4531_COMPATIBLE(of_compatible, cfg) {        \
 216                         .compatible = of_compatible,    \
 217                         .data = &mcp4531_cfg[cfg],      \
 218 }
 219
 220 static const struct of_device_id mcp4531_of_match[] = {
 221         MCP4531_COMPATIBLE("microchip,mcp4531-502", MCP453x_502),
 222         MCP4531_COMPATIBLE("microchip,mcp4531-103", MCP453x_103),
 223         MCP4531_COMPATIBLE("microchip,mcp4531-503", MCP453x_503),
 224         MCP4531_COMPATIBLE("microchip,mcp4531-104", MCP453x_104),
 225         MCP4531_COMPATIBLE("microchip,mcp4532-502", MCP453x_502),
 226         MCP4531_COMPATIBLE("microchip,mcp4532-103", MCP453x_103),
 227         MCP4531_COMPATIBLE("microchip,mcp4532-503", MCP453x_503),
 228         MCP4531_COMPATIBLE("microchip,mcp4532-104", MCP453x_104),
 229         MCP4531_COMPATIBLE("microchip,mcp4541-502", MCP454x_502),
 230         MCP4531_COMPATIBLE("microchip,mcp4541-103", MCP454x_103),
 231         MCP4531_COMPATIBLE("microchip,mcp4541-503", MCP454x_503),
 232         MCP4531_COMPATIBLE("microchip,mcp4541-104", MCP454x_104),
 233         MCP4531_COMPATIBLE("microchip,mcp4542-502", MCP454x_502),
 234         MCP4531_COMPATIBLE("microchip,mcp4542-103", MCP454x_103),
 235         MCP4531_COMPATIBLE("microchip,mcp4542-503", MCP454x_503),
 236         MCP4531_COMPATIBLE("microchip,mcp4542-104", MCP454x_104),
 237         MCP4531_COMPATIBLE("microchip,mcp4551-502", MCP455x_502),
 238         MCP4531_COMPATIBLE("microchip,mcp4551-103", MCP455x_103),
 239         MCP4531_COMPATIBLE("microchip,mcp4551-503", MCP455x_503),
 240         MCP4531_COMPATIBLE("microchip,mcp4551-104", MCP455x_104),
 241         MCP4531_COMPATIBLE("microchip,mcp4552-502", MCP455x_502),
 242         MCP4531_COMPATIBLE("microchip,mcp4552-103", MCP455x_103),
 243         MCP4531_COMPATIBLE("microchip,mcp4552-503", MCP455x_503),
 244         MCP4531_COMPATIBLE("microchip,mcp4552-104", MCP455x_104),
 245         MCP4531_COMPATIBLE("microchip,mcp4561-502", MCP456x_502),
 246         MCP4531_COMPATIBLE("microchip,mcp4561-103", MCP456x_103),
 247         MCP4531_COMPATIBLE("microchip,mcp4561-503", MCP456x_503),
 248         MCP4531_COMPATIBLE("microchip,mcp4561-104", MCP456x_104),
 249         MCP4531_COMPATIBLE("microchip,mcp4562-502", MCP456x_502),
 250         MCP4531_COMPATIBLE("microchip,mcp4562-103", MCP456x_103),
 251         MCP4531_COMPATIBLE("microchip,mcp4562-503", MCP456x_503),
 252         MCP4531_COMPATIBLE("microchip,mcp4562-104", MCP456x_104),
 253         MCP4531_COMPATIBLE("microchip,mcp4631-502", MCP463x_502),
 254         MCP4531_COMPATIBLE("microchip,mcp4631-103", MCP463x_103),
 255         MCP4531_COMPATIBLE("microchip,mcp4631-503", MCP463x_503),
 256         MCP4531_COMPATIBLE("microchip,mcp4631-104", MCP463x_104),
 257         MCP4531_COMPATIBLE("microchip,mcp4632-502", MCP463x_502),
 258         MCP4531_COMPATIBLE("microchip,mcp4632-103", MCP463x_103),
 259         MCP4531_COMPATIBLE("microchip,mcp4632-503", MCP463x_503),
 260         MCP4531_COMPATIBLE("microchip,mcp4632-104", MCP463x_104),
 261         MCP4531_COMPATIBLE("microchip,mcp4641-502", MCP464x_502),
 262         MCP4531_COMPATIBLE("microchip,mcp4641-103", MCP464x_103),
 263         MCP4531_COMPATIBLE("microchip,mcp4641-503", MCP464x_503),
 264         MCP4531_COMPATIBLE("microchip,mcp4641-104", MCP464x_104),
 265         MCP4531_COMPATIBLE("microchip,mcp4642-502", MCP464x_502),
 266         MCP4531_COMPATIBLE("microchip,mcp4642-103", MCP464x_103),
 267         MCP4531_COMPATIBLE("microchip,mcp4642-503", MCP464x_503),
 268         MCP4531_COMPATIBLE("microchip,mcp4642-104", MCP464x_104),
 269         MCP4531_COMPATIBLE("microchip,mcp4651-502", MCP465x_502),
 270         MCP4531_COMPATIBLE("microchip,mcp4651-103", MCP465x_103),
 271         MCP4531_COMPATIBLE("microchip,mcp4651-503", MCP465x_503),
 272         MCP4531_COMPATIBLE("microchip,mcp4651-104", MCP465x_104),
 273         MCP4531_COMPATIBLE("microchip,mcp4652-502", MCP465x_502),
 274         MCP4531_COMPATIBLE("microchip,mcp4652-103", MCP465x_103),
 275         MCP4531_COMPATIBLE("microchip,mcp4652-503", MCP465x_503),
 276         MCP4531_COMPATIBLE("microchip,mcp4652-104", MCP465x_104),
 277         MCP4531_COMPATIBLE("microchip,mcp4661-502", MCP466x_502),
 278         MCP4531_COMPATIBLE("microchip,mcp4661-103", MCP466x_103),
 279         MCP4531_COMPATIBLE("microchip,mcp4661-503", MCP466x_503),
 280         MCP4531_COMPATIBLE("microchip,mcp4661-104", MCP466x_104),
 281         MCP4531_COMPATIBLE("microchip,mcp4662-502", MCP466x_502),
 282         MCP4531_COMPATIBLE("microchip,mcp4662-103", MCP466x_103),
 283         MCP4531_COMPATIBLE("microchip,mcp4662-503", MCP466x_503),
 284         MCP4531_COMPATIBLE("microchip,mcp4662-104", MCP466x_104),
 285         { /* sentinel */ }
 286 };
 287 MODULE_DEVICE_TABLE(of, mcp4531_of_match);
 288 #endif
 289
 290 static int mcp4531_probe(struct i2c_client *client,
 291                          const struct i2c_device_id *id)
 292 {
 293         struct device *dev = &client->dev;
 294         struct mcp4531_data *data;
 295         struct iio_dev *indio_dev;
 296         const struct of_device_id *match;
 297
 298         if (!i2c_check_functionality(client->adapter,
 299                                      I2C_FUNC_SMBUS_WORD_DATA)) {
 300                 dev_err(dev, "SMBUS Word Data not supported\n");
 301                 return -EOPNOTSUPP;
 302         }
 303
 304         indio_dev = devm_iio_device_alloc(dev, sizeof(*data));
 305         if (!indio_dev)
 306                 return -ENOMEM;
 307         data = iio_priv(indio_dev);
 308         i2c_set_clientdata(client, indio_dev);
 309         data->client = client;
 310
 311         match = of_match_device(of_match_ptr(mcp4531_of_match), dev);
 312         if (match)
 313                 data->cfg = of_device_get_match_data(dev);
 314         else
 315                 data->cfg = &mcp4531_cfg[id->driver_data];
 316
 317         indio_dev->dev.parent = dev;
 318         indio_dev->info = &mcp4531_info;
 319         indio_dev->channels = mcp4531_channels;
 320         indio_dev->num_channels = data->cfg->wipers;
 321         indio_dev->name = client->name;
 322
 323         return devm_iio_device_register(dev, indio_dev);
 324 }
 325
 326 static const struct i2c_device_id mcp4531_id[] = {
 327         { "mcp4531-502", MCP453x_502 },
 328         { "mcp4531-103", MCP453x_103 },
 329         { "mcp4531-503", MCP453x_503 },
 330         { "mcp4531-104", MCP453x_104 },
 331         { "mcp4532-502", MCP453x_502 },
 332         { "mcp4532-103", MCP453x_103 },
 333         { "mcp4532-503", MCP453x_503 },
 334         { "mcp4532-104", MCP453x_104 },
 335         { "mcp4541-502", MCP454x_502 },
 336         { "mcp4541-103", MCP454x_103 },
 337         { "mcp4541-503", MCP454x_503 },
 338         { "mcp4541-104", MCP454x_104 },
 339         { "mcp4542-502", MCP454x_502 },
 340         { "mcp4542-103", MCP454x_103 },
 341         { "mcp4542-503", MCP454x_503 },
 342         { "mcp4542-104", MCP454x_104 },
 343         { "mcp4551-502", MCP455x_502 },
 344         { "mcp4551-103", MCP455x_103 },
 345         { "mcp4551-503", MCP455x_503 },
 346         { "mcp4551-104", MCP455x_104 },
 347         { "mcp4552-502", MCP455x_502 },
 348         { "mcp4552-103", MCP455x_103 },
 349         { "mcp4552-503", MCP455x_503 },
 350         { "mcp4552-104", MCP455x_104 },
 351         { "mcp4561-502", MCP456x_502 },
 352         { "mcp4561-103", MCP456x_103 },
 353         { "mcp4561-503", MCP456x_503 },
 354         { "mcp4561-104", MCP456x_104 },
 355         { "mcp4562-502", MCP456x_502 },
 356         { "mcp4562-103", MCP456x_103 },
 357         { "mcp4562-503", MCP456x_503 },
 358         { "mcp4562-104", MCP456x_104 },
 359         { "mcp4631-502", MCP463x_502 },
 360         { "mcp4631-103", MCP463x_103 },
 361         { "mcp4631-503", MCP463x_503 },
 362         { "mcp4631-104", MCP463x_104 },
 363         { "mcp4632-502", MCP463x_502 },
 364         { "mcp4632-103", MCP463x_103 },
 365         { "mcp4632-503", MCP463x_503 },
 366         { "mcp4632-104", MCP463x_104 },
 367         { "mcp4641-502", MCP464x_502 },
 368         { "mcp4641-103", MCP464x_103 },
 369         { "mcp4641-503", MCP464x_503 },
 370         { "mcp4641-104", MCP464x_104 },
 371         { "mcp4642-502", MCP464x_502 },
 372         { "mcp4642-103", MCP464x_103 },
 373         { "mcp4642-503", MCP464x_503 },
 374         { "mcp4642-104", MCP464x_104 },
 375         { "mcp4651-502", MCP465x_502 },
 376         { "mcp4651-103", MCP465x_103 },
 377         { "mcp4651-503", MCP465x_503 },
 378         { "mcp4651-104", MCP465x_104 },
 379         { "mcp4652-502", MCP465x_502 },
 380         { "mcp4652-103", MCP465x_103 },
 381         { "mcp4652-503", MCP465x_503 },
 382         { "mcp4652-104", MCP465x_104 },
 383         { "mcp4661-502", MCP466x_502 },
 384         { "mcp4661-103", MCP466x_103 },
 385         { "mcp4661-503", MCP466x_503 },
 386         { "mcp4661-104", MCP466x_104 },
 387         { "mcp4662-502", MCP466x_502 },
 388         { "mcp4662-103", MCP466x_103 },
 389         { "mcp4662-503", MCP466x_503 },
 390         { "mcp4662-104", MCP466x_104 },
 391         {}
 392 };
 393 MODULE_DEVICE_TABLE(i2c, mcp4531_id);
 394
 395 static struct i2c_driver mcp4531_driver = {
 396         .driver = {
 397                 .name   = "mcp4531",
 398                 .of_match_table = of_match_ptr(mcp4531_of_match),
 399         },
 400         .probe          = mcp4531_probe,
 401         .id_table       = mcp4531_id,
 402 };
 403
 404 module_i2c_driver(mcp4531_driver);
 405
 406 MODULE_AUTHOR("Peter Rosin <peda@axentia.se>");
 407 MODULE_DESCRIPTION("MCP4531 digital potentiometer");
 408 MODULE_LICENSE("GPL");