drivers/staging/iio/meter/ade7753.c

   1 /*
   2  * ADE7753 Single-Phase Multifunction Metering IC with di/dt Sensor Interface
   3  *
   4  * Copyright 2010 Analog Devices Inc.
   5  *
   6  * Licensed under the GPL-2 or later.
   7  */
   8
   9 #include <linux/interrupt.h>
  10 #include <linux/irq.h>
  11 #include <linux/delay.h>
  12 #include <linux/mutex.h>
  13 #include <linux/device.h>
  14 #include <linux/kernel.h>
  15 #include <linux/spi/spi.h>
  16 #include <linux/slab.h>
  17 #include <linux/sysfs.h>
  18 #include <linux/list.h>
  19 #include <linux/module.h>
  20
  21 #include <linux/iio/iio.h>
  22 #include <linux/iio/sysfs.h>
  23 #include "meter.h"
  24 #include "ade7753.h"
  25
  26 static int ade7753_spi_write_reg_8(struct device *dev,
  27                                    u8 reg_address,
  28                                    u8 val)
  29 {
  30         int ret;
  31         struct iio_dev *indio_dev = dev_to_iio_dev(dev);
  32         struct ade7753_state *st = iio_priv(indio_dev);
  33
  34         mutex_lock(&st->buf_lock);
  35         st->tx[0] = ADE7753_WRITE_REG(reg_address);
  36         st->tx[1] = val;
  37
  38         ret = spi_write(st->us, st->tx, 2);
  39         mutex_unlock(&st->buf_lock);
  40
  41         return ret;
  42 }
  43
  44 static int ade7753_spi_write_reg_16(struct device *dev,
  45                 u8 reg_address,
  46                 u16 value)
  47 {
  48         int ret;
  49         struct iio_dev *indio_dev = dev_to_iio_dev(dev);
  50         struct ade7753_state *st = iio_priv(indio_dev);
  51
  52         mutex_lock(&st->buf_lock);
  53         st->tx[0] = ADE7753_WRITE_REG(reg_address);
  54         st->tx[1] = (value >> 8) & 0xFF;
  55         st->tx[2] = value & 0xFF;
  56         ret = spi_write(st->us, st->tx, 3);
  57         mutex_unlock(&st->buf_lock);
  58
  59         return ret;
  60 }
  61
  62 static int ade7753_spi_read_reg_8(struct device *dev,
  63                 u8 reg_address,
  64                 u8 *val)
  65 {
  66         struct iio_dev *indio_dev = dev_to_iio_dev(dev);
  67         struct ade7753_state *st = iio_priv(indio_dev);
  68         ssize_t ret;
  69
  70         ret = spi_w8r8(st->us, ADE7753_READ_REG(reg_address));
  71         if (ret < 0) {
  72                 dev_err(&st->us->dev, "problem when reading 8 bit register 0x%02X",
  73                                 reg_address);
  74                 return ret;
  75         }
  76         *val = ret;
  77
  78         return 0;
  79 }
  80
  81 static int ade7753_spi_read_reg_16(struct device *dev,
  82                 u8 reg_address,
  83                 u16 *val)
  84 {
  85         struct iio_dev *indio_dev = dev_to_iio_dev(dev);
  86         struct ade7753_state *st = iio_priv(indio_dev);
  87         ssize_t ret;
  88
  89         ret = spi_w8r16(st->us, ADE7753_READ_REG(reg_address));
  90         if (ret < 0) {
  91                 dev_err(&st->us->dev, "problem when reading 16 bit register 0x%02X",
  92                         reg_address);
  93                 return ret;
  94         }
  95
  96         *val = ret;
  97         *val = be16_to_cpup(val);
  98
  99         return 0;
 100 }
 101
 102 static int ade7753_spi_read_reg_24(struct device *dev,
 103                 u8 reg_address,
 104                 u32 *val)
 105 {
 106         struct iio_dev *indio_dev = dev_to_iio_dev(dev);
 107         struct ade7753_state *st = iio_priv(indio_dev);
 108         int ret;
 109         struct spi_transfer xfers[] = {
 110                 {
 111                         .tx_buf = st->tx,
 112                         .bits_per_word = 8,
 113                         .len = 1,
 114                 }, {
 115                         .rx_buf = st->tx,
 116                         .bits_per_word = 8,
 117                         .len = 3,
 118                 }
 119         };
 120
 121         mutex_lock(&st->buf_lock);
 122         st->tx[0] = ADE7753_READ_REG(reg_address);
 123
 124         ret = spi_sync_transfer(st->us, xfers, ARRAY_SIZE(xfers));
 125         if (ret) {
 126                 dev_err(&st->us->dev, "problem when reading 24 bit register 0x%02X",
 127                                 reg_address);
 128                 goto error_ret;
 129         }
 130         *val = (st->rx[0] << 16) | (st->rx[1] << 8) | st->rx[2];
 131
 132 error_ret:
 133         mutex_unlock(&st->buf_lock);
 134         return ret;
 135 }
 136
 137 static ssize_t ade7753_read_8bit(struct device *dev,
 138                 struct device_attribute *attr,
 139                 char *buf)
 140 {
 141         int ret;
 142         u8 val;
 143         struct iio_dev_attr *this_attr = to_iio_dev_attr(attr);
 144
 145         ret = ade7753_spi_read_reg_8(dev, this_attr->address, &val);
 146         if (ret)
 147                 return ret;
 148
 149         return sprintf(buf, "%u\n", val);
 150 }
 151
 152 static ssize_t ade7753_read_16bit(struct device *dev,
 153                 struct device_attribute *attr,
 154                 char *buf)
 155 {
 156         int ret;
 157         u16 val;
 158         struct iio_dev_attr *this_attr = to_iio_dev_attr(attr);
 159
 160         ret = ade7753_spi_read_reg_16(dev, this_attr->address, &val);
 161         if (ret)
 162                 return ret;
 163
 164         return sprintf(buf, "%u\n", val);
 165 }
 166
 167 static ssize_t ade7753_read_24bit(struct device *dev,
 168                 struct device_attribute *attr,
 169                 char *buf)
 170 {
 171         int ret;
 172         u32 val;
 173         struct iio_dev_attr *this_attr = to_iio_dev_attr(attr);
 174
 175         ret = ade7753_spi_read_reg_24(dev, this_attr->address, &val);
 176         if (ret)
 177                 return ret;
 178
 179         return sprintf(buf, "%u\n", val);
 180 }
 181
 182 static ssize_t ade7753_write_8bit(struct device *dev,
 183                 struct device_attribute *attr,
 184                 const char *buf,
 185                 size_t len)
 186 {
 187         struct iio_dev_attr *this_attr = to_iio_dev_attr(attr);
 188         int ret;
 189         long val;
 190
 191         ret = strict_strtol(buf, 10, &val);
 192         if (ret)
 193                 goto error_ret;
 194         ret = ade7753_spi_write_reg_8(dev, this_attr->address, val);
 195
 196 error_ret:
 197         return ret ? ret : len;
 198 }
 199
 200 static ssize_t ade7753_write_16bit(struct device *dev,
 201                 struct device_attribute *attr,
 202                 const char *buf,
 203                 size_t len)
 204 {
 205         struct iio_dev_attr *this_attr = to_iio_dev_attr(attr);
 206         int ret;
 207         long val;
 208
 209         ret = strict_strtol(buf, 10, &val);
 210         if (ret)
 211                 goto error_ret;
 212         ret = ade7753_spi_write_reg_16(dev, this_attr->address, val);
 213
 214 error_ret:
 215         return ret ? ret : len;
 216 }
 217
 218 static int ade7753_reset(struct device *dev)
 219 {
 220         u16 val;
 221
 222         ade7753_spi_read_reg_16(dev, ADE7753_MODE, &val);
 223         val |= 1 << 6; /* Software Chip Reset */
 224
 225         return ade7753_spi_write_reg_16(dev, ADE7753_MODE, val);
 226 }
 227
 228 static IIO_DEV_ATTR_AENERGY(ade7753_read_24bit, ADE7753_AENERGY);
 229 static IIO_DEV_ATTR_LAENERGY(ade7753_read_24bit, ADE7753_LAENERGY);
 230 static IIO_DEV_ATTR_VAENERGY(ade7753_read_24bit, ADE7753_VAENERGY);
 231 static IIO_DEV_ATTR_LVAENERGY(ade7753_read_24bit, ADE7753_LVAENERGY);
 232 static IIO_DEV_ATTR_CFDEN(S_IWUSR | S_IRUGO,
 233                 ade7753_read_16bit,
 234                 ade7753_write_16bit,
 235                 ADE7753_CFDEN);
 236 static IIO_DEV_ATTR_CFNUM(S_IWUSR | S_IRUGO,
 237                 ade7753_read_8bit,
 238                 ade7753_write_8bit,
 239                 ADE7753_CFNUM);
 240 static IIO_DEV_ATTR_CHKSUM(ade7753_read_8bit, ADE7753_CHKSUM);
 241 static IIO_DEV_ATTR_PHCAL(S_IWUSR | S_IRUGO,
 242                 ade7753_read_16bit,
 243                 ade7753_write_16bit,
 244                 ADE7753_PHCAL);
 245 static IIO_DEV_ATTR_APOS(S_IWUSR | S_IRUGO,
 246                 ade7753_read_16bit,
 247                 ade7753_write_16bit,
 248                 ADE7753_APOS);
 249 static IIO_DEV_ATTR_SAGCYC(S_IWUSR | S_IRUGO,
 250                 ade7753_read_8bit,
 251                 ade7753_write_8bit,
 252                 ADE7753_SAGCYC);
 253 static IIO_DEV_ATTR_SAGLVL(S_IWUSR | S_IRUGO,
 254                 ade7753_read_8bit,
 255                 ade7753_write_8bit,
 256                 ADE7753_SAGLVL);
 257 static IIO_DEV_ATTR_LINECYC(S_IWUSR | S_IRUGO,
 258                 ade7753_read_8bit,
 259                 ade7753_write_8bit,
 260                 ADE7753_LINECYC);
 261 static IIO_DEV_ATTR_WDIV(S_IWUSR | S_IRUGO,
 262                 ade7753_read_8bit,
 263                 ade7753_write_8bit,
 264                 ADE7753_WDIV);
 265 static IIO_DEV_ATTR_IRMS(S_IWUSR | S_IRUGO,
 266                 ade7753_read_24bit,
 267                 NULL,
 268                 ADE7753_IRMS);
 269 static IIO_DEV_ATTR_VRMS(S_IRUGO,
 270                 ade7753_read_24bit,
 271                 NULL,
 272                 ADE7753_VRMS);
 273 static IIO_DEV_ATTR_IRMSOS(S_IWUSR | S_IRUGO,
 274                 ade7753_read_16bit,
 275                 ade7753_write_16bit,
 276                 ADE7753_IRMSOS);
 277 static IIO_DEV_ATTR_VRMSOS(S_IWUSR | S_IRUGO,
 278                 ade7753_read_16bit,
 279                 ade7753_write_16bit,
 280                 ADE7753_VRMSOS);
 281 static IIO_DEV_ATTR_WGAIN(S_IWUSR | S_IRUGO,
 282                 ade7753_read_16bit,
 283                 ade7753_write_16bit,
 284                 ADE7753_WGAIN);
 285 static IIO_DEV_ATTR_VAGAIN(S_IWUSR | S_IRUGO,
 286                 ade7753_read_16bit,
 287                 ade7753_write_16bit,
 288                 ADE7753_VAGAIN);
 289 static IIO_DEV_ATTR_PGA_GAIN(S_IWUSR | S_IRUGO,
 290                 ade7753_read_16bit,
 291                 ade7753_write_16bit,
 292                 ADE7753_GAIN);
 293 static IIO_DEV_ATTR_IPKLVL(S_IWUSR | S_IRUGO,
 294                 ade7753_read_8bit,
 295                 ade7753_write_8bit,
 296                 ADE7753_IPKLVL);
 297 static IIO_DEV_ATTR_VPKLVL(S_IWUSR | S_IRUGO,
 298                 ade7753_read_8bit,
 299                 ade7753_write_8bit,
 300                 ADE7753_VPKLVL);
 301 static IIO_DEV_ATTR_IPEAK(S_IRUGO,
 302                 ade7753_read_24bit,
 303                 NULL,
 304                 ADE7753_IPEAK);
 305 static IIO_DEV_ATTR_VPEAK(S_IRUGO,
 306                 ade7753_read_24bit,
 307                 NULL,
 308                 ADE7753_VPEAK);
 309 static IIO_DEV_ATTR_VPERIOD(S_IRUGO,
 310                 ade7753_read_16bit,
 311                 NULL,
 312                 ADE7753_PERIOD);
 313 static IIO_DEV_ATTR_CH_OFF(1, S_IWUSR | S_IRUGO,
 314                 ade7753_read_8bit,
 315                 ade7753_write_8bit,
 316                 ADE7753_CH1OS);
 317 static IIO_DEV_ATTR_CH_OFF(2, S_IWUSR | S_IRUGO,
 318                 ade7753_read_8bit,
 319                 ade7753_write_8bit,
 320                 ADE7753_CH2OS);
 321
 322 static int ade7753_set_irq(struct device *dev, bool enable)
 323 {
 324         int ret;
 325         u8 irqen;
 326         ret = ade7753_spi_read_reg_8(dev, ADE7753_IRQEN, &irqen);
 327         if (ret)
 328                 goto error_ret;
 329
 330         if (enable)
 331                 irqen |= 1 << 3; /* Enables an interrupt when a data is
 332                                     present in the waveform register */
 333         else
 334                 irqen &= ~(1 << 3);
 335
 336         ret = ade7753_spi_write_reg_8(dev, ADE7753_IRQEN, irqen);
 337
 338 error_ret:
 339         return ret;
 340 }
 341
 342 /* Power down the device */
 343 static int ade7753_stop_device(struct device *dev)
 344 {
 345         u16 val;
 346
 347         ade7753_spi_read_reg_16(dev, ADE7753_MODE, &val);
 348         val |= 1 << 4;  /* AD converters can be turned off */
 349
 350         return ade7753_spi_write_reg_16(dev, ADE7753_MODE, val);
 351 }
 352
 353 static int ade7753_initial_setup(struct iio_dev *indio_dev)
 354 {
 355         int ret;
 356         struct device *dev = &indio_dev->dev;
 357         struct ade7753_state *st = iio_priv(indio_dev);
 358
 359         /* use low spi speed for init */
 360         st->us->mode = SPI_MODE_3;
 361         spi_setup(st->us);
 362
 363         /* Disable IRQ */
 364         ret = ade7753_set_irq(dev, false);
 365         if (ret) {
 366                 dev_err(dev, "disable irq failed");
 367                 goto err_ret;
 368         }
 369
 370         ade7753_reset(dev);
 371         msleep(ADE7753_STARTUP_DELAY);
 372
 373 err_ret:
 374         return ret;
 375 }
 376
 377 static ssize_t ade7753_read_frequency(struct device *dev,
 378                 struct device_attribute *attr,
 379                 char *buf)
 380 {
 381         int ret, len = 0;
 382         u16 t;
 383         int sps;
 384         ret = ade7753_spi_read_reg_16(dev, ADE7753_MODE, &t);
 385         if (ret)
 386                 return ret;
 387
 388         t = (t >> 11) & 0x3;
 389         sps = 27900 / (1 + t);
 390
 391         len = sprintf(buf, "%d\n", sps);
 392         return len;
 393 }
 394
 395 static ssize_t ade7753_write_frequency(struct device *dev,
 396                 struct device_attribute *attr,
 397                 const char *buf,
 398                 size_t len)
 399 {
 400         struct iio_dev *indio_dev = dev_to_iio_dev(dev);
 401         struct ade7753_state *st = iio_priv(indio_dev);
 402         unsigned long val;
 403         int ret;
 404         u16 reg, t;
 405
 406         ret = strict_strtol(buf, 10, &val);
 407         if (ret)
 408                 return ret;
 409         if (val == 0)
 410                 return -EINVAL;
 411
 412         mutex_lock(&indio_dev->mlock);
 413
 414         t = (27900 / val);
 415         if (t > 0)
 416                 t--;
 417
 418         if (t > 1)
 419                 st->us->max_speed_hz = ADE7753_SPI_SLOW;
 420         else
 421                 st->us->max_speed_hz = ADE7753_SPI_FAST;
 422
 423         ret = ade7753_spi_read_reg_16(dev, ADE7753_MODE, &reg);
 424         if (ret)
 425                 goto out;
 426
 427         reg &= ~(3 << 11);
 428         reg |= t << 11;
 429
 430         ret = ade7753_spi_write_reg_16(dev, ADE7753_MODE, reg);
 431
 432 out:
 433         mutex_unlock(&indio_dev->mlock);
 434
 435         return ret ? ret : len;
 436 }
 437
 438 static IIO_DEV_ATTR_TEMP_RAW(ade7753_read_8bit);
 439 static IIO_CONST_ATTR(in_temp_offset, "-25 C");
 440 static IIO_CONST_ATTR(in_temp_scale, "0.67 C");
 441
 442 static IIO_DEV_ATTR_SAMP_FREQ(S_IWUSR | S_IRUGO,
 443                 ade7753_read_frequency,
 444                 ade7753_write_frequency);
 445
 446 static IIO_CONST_ATTR_SAMP_FREQ_AVAIL("27900 14000 7000 3500");
 447
 448 static struct attribute *ade7753_attributes[] = {
 449         &iio_dev_attr_in_temp_raw.dev_attr.attr,
 450         &iio_const_attr_in_temp_offset.dev_attr.attr,
 451         &iio_const_attr_in_temp_scale.dev_attr.attr,
 452         &iio_dev_attr_sampling_frequency.dev_attr.attr,
 453         &iio_const_attr_sampling_frequency_available.dev_attr.attr,
 454         &iio_dev_attr_phcal.dev_attr.attr,
 455         &iio_dev_attr_cfden.dev_attr.attr,
 456         &iio_dev_attr_aenergy.dev_attr.attr,
 457         &iio_dev_attr_laenergy.dev_attr.attr,
 458         &iio_dev_attr_vaenergy.dev_attr.attr,
 459         &iio_dev_attr_lvaenergy.dev_attr.attr,
 460         &iio_dev_attr_cfnum.dev_attr.attr,
 461         &iio_dev_attr_apos.dev_attr.attr,
 462         &iio_dev_attr_sagcyc.dev_attr.attr,
 463         &iio_dev_attr_saglvl.dev_attr.attr,
 464         &iio_dev_attr_linecyc.dev_attr.attr,
 465         &iio_dev_attr_chksum.dev_attr.attr,
 466         &iio_dev_attr_pga_gain.dev_attr.attr,
 467         &iio_dev_attr_wgain.dev_attr.attr,
 468         &iio_dev_attr_choff_1.dev_attr.attr,
 469         &iio_dev_attr_choff_2.dev_attr.attr,
 470         &iio_dev_attr_wdiv.dev_attr.attr,
 471         &iio_dev_attr_irms.dev_attr.attr,
 472         &iio_dev_attr_vrms.dev_attr.attr,
 473         &iio_dev_attr_irmsos.dev_attr.attr,
 474         &iio_dev_attr_vrmsos.dev_attr.attr,
 475         &iio_dev_attr_vagain.dev_attr.attr,
 476         &iio_dev_attr_ipklvl.dev_attr.attr,
 477         &iio_dev_attr_vpklvl.dev_attr.attr,
 478         &iio_dev_attr_ipeak.dev_attr.attr,
 479         &iio_dev_attr_vpeak.dev_attr.attr,
 480         &iio_dev_attr_vperiod.dev_attr.attr,
 481         NULL,
 482 };
 483
 484 static const struct attribute_group ade7753_attribute_group = {
 485         .attrs = ade7753_attributes,
 486 };
 487
 488 static const struct iio_info ade7753_info = {
 489         .attrs = &ade7753_attribute_group,
 490         .driver_module = THIS_MODULE,
 491 };
 492
 493 static int ade7753_probe(struct spi_device *spi)
 494 {
 495         int ret;
 496         struct ade7753_state *st;
 497         struct iio_dev *indio_dev;
 498
 499         /* setup the industrialio driver allocated elements */
 500         indio_dev = iio_device_alloc(sizeof(*st));
 501         if (indio_dev == NULL) {
 502                 ret = -ENOMEM;
 503                 goto error_ret;
 504         }
 505         /* this is only used for removal purposes */
 506         spi_set_drvdata(spi, indio_dev);
 507
 508         st = iio_priv(indio_dev);
 509         st->us = spi;
 510         mutex_init(&st->buf_lock);
 511
 512         indio_dev->name = spi->dev.driver->name;
 513         indio_dev->dev.parent = &spi->dev;
 514         indio_dev->info = &ade7753_info;
 515         indio_dev->modes = INDIO_DIRECT_MODE;
 516
 517         /* Get the device into a sane initial state */
 518         ret = ade7753_initial_setup(indio_dev);
 519         if (ret)
 520                 goto error_free_dev;
 521
 522         ret = iio_device_register(indio_dev);
 523         if (ret)
 524                 goto error_free_dev;
 525
 526         return 0;
 527
 528 error_free_dev:
 529         iio_device_free(indio_dev);
 530
 531 error_ret:
 532         return ret;
 533 }
 534
 535 /* fixme, confirm ordering in this function */
 536 static int ade7753_remove(struct spi_device *spi)
 537 {
 538         struct iio_dev *indio_dev = spi_get_drvdata(spi);
 539
 540         iio_device_unregister(indio_dev);
 541         ade7753_stop_device(&indio_dev->dev);
 542         iio_device_free(indio_dev);
 543
 544         return 0;
 545 }
 546
 547 static struct spi_driver ade7753_driver = {
 548         .driver = {
 549                 .name = "ade7753",
 550                 .owner = THIS_MODULE,
 551         },
 552         .probe = ade7753_probe,
 553         .remove = ade7753_remove,
 554 };
 555 module_spi_driver(ade7753_driver);
 556
 557 MODULE_AUTHOR("Barry Song <21cnbao@gmail.com>");
 558 MODULE_DESCRIPTION("Analog Devices ADE7753/6 Single-Phase Multifunction Meter");
 559 MODULE_LICENSE("GPL v2");
 560 MODULE_ALIAS("spi:ade7753");