1 /* 2 * AD5686R, AD5685R, AD5684R Digital to analog converters driver 3 * 4 * Copyright 2011 Analog Devices Inc. 5 * 6 * Licensed under the GPL-2. 7 */ 8 9 #include <linux/interrupt.h> 10 #include <linux/fs.h> 11 #include <linux/device.h> 12 #include <linux/module.h> 13 #include <linux/kernel.h> 14 #include <linux/spi/spi.h> 15 #include <linux/slab.h> 16 #include <linux/sysfs.h> 17 #include <linux/regulator/consumer.h> 18 19 #include <linux/iio/iio.h> 20 #include <linux/iio/sysfs.h> 21 22 #define AD5686_DAC_CHANNELS 4 23 24 #define AD5686_ADDR(x) ((x) << 16) 25 #define AD5686_CMD(x) ((x) << 20) 26 27 #define AD5686_ADDR_DAC(chan) (0x1 << (chan)) 28 #define AD5686_ADDR_ALL_DAC 0xF 29 30 #define AD5686_CMD_NOOP 0x0 31 #define AD5686_CMD_WRITE_INPUT_N 0x1 32 #define AD5686_CMD_UPDATE_DAC_N 0x2 33 #define AD5686_CMD_WRITE_INPUT_N_UPDATE_N 0x3 34 #define AD5686_CMD_POWERDOWN_DAC 0x4 35 #define AD5686_CMD_LDAC_MASK 0x5 36 #define AD5686_CMD_RESET 0x6 37 #define AD5686_CMD_INTERNAL_REFER_SETUP 0x7 38 #define AD5686_CMD_DAISY_CHAIN_ENABLE 0x8 39 #define AD5686_CMD_READBACK_ENABLE 0x9 40 41 #define AD5686_LDAC_PWRDN_NONE 0x0 42 #define AD5686_LDAC_PWRDN_1K 0x1 43 #define AD5686_LDAC_PWRDN_100K 0x2 44 #define AD5686_LDAC_PWRDN_3STATE 0x3 45 46 /** 47 * struct ad5686_chip_info - chip specific information 48 * @int_vref_mv: AD5620/40/60: the internal reference voltage 49 * @channel: channel specification 50 */ 51 52 struct ad5686_chip_info { 53 u16 int_vref_mv; 54 struct iio_chan_spec channel[AD5686_DAC_CHANNELS]; 55 }; 56 57 /** 58 * struct ad5446_state - driver instance specific data 59 * @spi: spi_device 60 * @chip_info: chip model specific constants, available modes etc 61 * @reg: supply regulator 62 * @vref_mv: actual reference voltage used 63 * @pwr_down_mask: power down mask 64 * @pwr_down_mode: current power down mode 65 * @data: spi transfer buffers 66 */ 67 68 struct ad5686_state { 69 struct spi_device *spi; 70 const struct ad5686_chip_info *chip_info; 71 struct regulator *reg; 72 unsigned short vref_mv; 73 unsigned pwr_down_mask; 74 unsigned pwr_down_mode; 75 /* 76 * DMA (thus cache coherency maintenance) requires the 77 * transfer buffers to live in their own cache lines. 78 */ 79 80 union { 81 __be32 d32; 82 u8 d8[4]; 83 } data[3] ____cacheline_aligned; 84 }; 85 86 /** 87 * ad5686_supported_device_ids: 88 */ 89 90 enum ad5686_supported_device_ids { 91 ID_AD5684, 92 ID_AD5685, 93 ID_AD5686, 94 }; 95 static int ad5686_spi_write(struct ad5686_state *st, 96 u8 cmd, u8 addr, u16 val, u8 shift) 97 { 98 val <<= shift; 99 100 st->data[0].d32 = cpu_to_be32(AD5686_CMD(cmd) | 101 AD5686_ADDR(addr) | 102 val); 103 104 return spi_write(st->spi, &st->data[0].d8[1], 3); 105 } 106 107 static int ad5686_spi_read(struct ad5686_state *st, u8 addr) 108 { 109 struct spi_transfer t[] = { 110 { 111 .tx_buf = &st->data[0].d8[1], 112 .len = 3, 113 .cs_change = 1, 114 }, { 115 .tx_buf = &st->data[1].d8[1], 116 .rx_buf = &st->data[2].d8[1], 117 .len = 3, 118 }, 119 }; 120 int ret; 121 122 st->data[0].d32 = cpu_to_be32(AD5686_CMD(AD5686_CMD_READBACK_ENABLE) | 123 AD5686_ADDR(addr)); 124 st->data[1].d32 = cpu_to_be32(AD5686_CMD(AD5686_CMD_NOOP)); 125 126 ret = spi_sync_transfer(st->spi, t, ARRAY_SIZE(t)); 127 if (ret < 0) 128 return ret; 129 130 return be32_to_cpu(st->data[2].d32); 131 } 132 133 static const char * const ad5686_powerdown_modes[] = { 134 "1kohm_to_gnd", 135 "100kohm_to_gnd", 136 "three_state" 137 }; 138 139 static int ad5686_get_powerdown_mode(struct iio_dev *indio_dev, 140 const struct iio_chan_spec *chan) 141 { 142 struct ad5686_state *st = iio_priv(indio_dev); 143 144 return ((st->pwr_down_mode >> (chan->channel * 2)) & 0x3) - 1; 145 } 146 147 static int ad5686_set_powerdown_mode(struct iio_dev *indio_dev, 148 const struct iio_chan_spec *chan, unsigned int mode) 149 { 150 struct ad5686_state *st = iio_priv(indio_dev); 151 152 st->pwr_down_mode &= ~(0x3 << (chan->channel * 2)); 153 st->pwr_down_mode |= ((mode + 1) << (chan->channel * 2)); 154 155 return 0; 156 } 157 158 static const struct iio_enum ad5686_powerdown_mode_enum = { 159 .items = ad5686_powerdown_modes, 160 .num_items = ARRAY_SIZE(ad5686_powerdown_modes), 161 .get = ad5686_get_powerdown_mode, 162 .set = ad5686_set_powerdown_mode, 163 }; 164 165 static ssize_t ad5686_read_dac_powerdown(struct iio_dev *indio_dev, 166 uintptr_t private, const struct iio_chan_spec *chan, char *buf) 167 { 168 struct ad5686_state *st = iio_priv(indio_dev); 169 170 return sprintf(buf, "%d\n", !!(st->pwr_down_mask & 171 (0x3 << (chan->channel * 2)))); 172 } 173 174 static ssize_t ad5686_write_dac_powerdown(struct iio_dev *indio_dev, 175 uintptr_t private, const struct iio_chan_spec *chan, const char *buf, 176 size_t len) 177 { 178 bool readin; 179 int ret; 180 struct ad5686_state *st = iio_priv(indio_dev); 181 182 ret = strtobool(buf, &readin); 183 if (ret) 184 return ret; 185 186 if (readin) 187 st->pwr_down_mask |= (0x3 << (chan->channel * 2)); 188 else 189 st->pwr_down_mask &= ~(0x3 << (chan->channel * 2)); 190 191 ret = ad5686_spi_write(st, AD5686_CMD_POWERDOWN_DAC, 0, 192 st->pwr_down_mask & st->pwr_down_mode, 0); 193 194 return ret ? ret : len; 195 } 196 197 static int ad5686_read_raw(struct iio_dev *indio_dev, 198 struct iio_chan_spec const *chan, 199 int *val, 200 int *val2, 201 long m) 202 { 203 struct ad5686_state *st = iio_priv(indio_dev); 204 int ret; 205 206 switch (m) { 207 case IIO_CHAN_INFO_RAW: 208 mutex_lock(&indio_dev->mlock); 209 ret = ad5686_spi_read(st, chan->address); 210 mutex_unlock(&indio_dev->mlock); 211 if (ret < 0) 212 return ret; 213 *val = ret; 214 return IIO_VAL_INT; 215 case IIO_CHAN_INFO_SCALE: 216 *val = st->vref_mv; 217 *val2 = chan->scan_type.realbits; 218 return IIO_VAL_FRACTIONAL_LOG2; 219 } 220 return -EINVAL; 221 } 222 223 static int ad5686_write_raw(struct iio_dev *indio_dev, 224 struct iio_chan_spec const *chan, 225 int val, 226 int val2, 227 long mask) 228 { 229 struct ad5686_state *st = iio_priv(indio_dev); 230 int ret; 231 232 switch (mask) { 233 case IIO_CHAN_INFO_RAW: 234 if (val > (1 << chan->scan_type.realbits) || val < 0) 235 return -EINVAL; 236 237 mutex_lock(&indio_dev->mlock); 238 ret = ad5686_spi_write(st, 239 AD5686_CMD_WRITE_INPUT_N_UPDATE_N, 240 chan->address, 241 val, 242 chan->scan_type.shift); 243 mutex_unlock(&indio_dev->mlock); 244 break; 245 default: 246 ret = -EINVAL; 247 } 248 249 return ret; 250 } 251 252 static const struct iio_info ad5686_info = { 253 .read_raw = ad5686_read_raw, 254 .write_raw = ad5686_write_raw, 255 .driver_module = THIS_MODULE, 256 }; 257 258 static const struct iio_chan_spec_ext_info ad5686_ext_info[] = { 259 { 260 .name = "powerdown", 261 .read = ad5686_read_dac_powerdown, 262 .write = ad5686_write_dac_powerdown, 263 .shared = IIO_SEPARATE, 264 }, 265 IIO_ENUM("powerdown_mode", IIO_SEPARATE, &ad5686_powerdown_mode_enum), 266 IIO_ENUM_AVAILABLE("powerdown_mode", &ad5686_powerdown_mode_enum), 267 { }, 268 }; 269 270 #define AD5868_CHANNEL(chan, bits, _shift) { \ 271 .type = IIO_VOLTAGE, \ 272 .indexed = 1, \ 273 .output = 1, \ 274 .channel = chan, \ 275 .info_mask_separate = BIT(IIO_CHAN_INFO_RAW), \ 276 .info_mask_shared_by_type = BIT(IIO_CHAN_INFO_SCALE),\ 277 .address = AD5686_ADDR_DAC(chan), \ 278 .scan_type = { \ 279 .sign = 'u', \ 280 .realbits = (bits), \ 281 .storagebits = 16, \ 282 .shift = (_shift), \ 283 }, \ 284 .ext_info = ad5686_ext_info, \ 285 } 286 287 static const struct ad5686_chip_info ad5686_chip_info_tbl[] = { 288 [ID_AD5684] = { 289 .channel[0] = AD5868_CHANNEL(0, 12, 4), 290 .channel[1] = AD5868_CHANNEL(1, 12, 4), 291 .channel[2] = AD5868_CHANNEL(2, 12, 4), 292 .channel[3] = AD5868_CHANNEL(3, 12, 4), 293 .int_vref_mv = 2500, 294 }, 295 [ID_AD5685] = { 296 .channel[0] = AD5868_CHANNEL(0, 14, 2), 297 .channel[1] = AD5868_CHANNEL(1, 14, 2), 298 .channel[2] = AD5868_CHANNEL(2, 14, 2), 299 .channel[3] = AD5868_CHANNEL(3, 14, 2), 300 .int_vref_mv = 2500, 301 }, 302 [ID_AD5686] = { 303 .channel[0] = AD5868_CHANNEL(0, 16, 0), 304 .channel[1] = AD5868_CHANNEL(1, 16, 0), 305 .channel[2] = AD5868_CHANNEL(2, 16, 0), 306 .channel[3] = AD5868_CHANNEL(3, 16, 0), 307 .int_vref_mv = 2500, 308 }, 309 }; 310 311 312 static int ad5686_probe(struct spi_device *spi) 313 { 314 struct ad5686_state *st; 315 struct iio_dev *indio_dev; 316 int ret, voltage_uv = 0; 317 318 indio_dev = devm_iio_device_alloc(&spi->dev, sizeof(*st)); 319 if (indio_dev == NULL) 320 return -ENOMEM; 321 322 st = iio_priv(indio_dev); 323 spi_set_drvdata(spi, indio_dev); 324 325 st->reg = devm_regulator_get_optional(&spi->dev, "vcc"); 326 if (!IS_ERR(st->reg)) { 327 ret = regulator_enable(st->reg); 328 if (ret) 329 return ret; 330 331 ret = regulator_get_voltage(st->reg); 332 if (ret < 0) 333 goto error_disable_reg; 334 335 voltage_uv = ret; 336 } 337 338 st->chip_info = 339 &ad5686_chip_info_tbl[spi_get_device_id(spi)->driver_data]; 340 341 if (voltage_uv) 342 st->vref_mv = voltage_uv / 1000; 343 else 344 st->vref_mv = st->chip_info->int_vref_mv; 345 346 st->spi = spi; 347 348 /* Set all the power down mode for all channels to 1K pulldown */ 349 st->pwr_down_mode = 0x55; 350 351 indio_dev->dev.parent = &spi->dev; 352 indio_dev->name = spi_get_device_id(spi)->name; 353 indio_dev->info = &ad5686_info; 354 indio_dev->modes = INDIO_DIRECT_MODE; 355 indio_dev->channels = st->chip_info->channel; 356 indio_dev->num_channels = AD5686_DAC_CHANNELS; 357 358 ret = ad5686_spi_write(st, AD5686_CMD_INTERNAL_REFER_SETUP, 0, 359 !!voltage_uv, 0); 360 if (ret) 361 goto error_disable_reg; 362 363 ret = iio_device_register(indio_dev); 364 if (ret) 365 goto error_disable_reg; 366 367 return 0; 368 369 error_disable_reg: 370 if (!IS_ERR(st->reg)) 371 regulator_disable(st->reg); 372 return ret; 373 } 374 375 static int ad5686_remove(struct spi_device *spi) 376 { 377 struct iio_dev *indio_dev = spi_get_drvdata(spi); 378 struct ad5686_state *st = iio_priv(indio_dev); 379 380 iio_device_unregister(indio_dev); 381 if (!IS_ERR(st->reg)) 382 regulator_disable(st->reg); 383 384 return 0; 385 } 386 387 static const struct spi_device_id ad5686_id[] = { 388 {"ad5684", ID_AD5684}, 389 {"ad5685", ID_AD5685}, 390 {"ad5686", ID_AD5686}, 391 {} 392 }; 393 MODULE_DEVICE_TABLE(spi, ad5686_id); 394 395 static struct spi_driver ad5686_driver = { 396 .driver = { 397 .name = "ad5686", 398 .owner = THIS_MODULE, 399 }, 400 .probe = ad5686_probe, 401 .remove = ad5686_remove, 402 .id_table = ad5686_id, 403 }; 404 module_spi_driver(ad5686_driver); 405 406 MODULE_AUTHOR("Michael Hennerich <hennerich@blackfin.uclinux.org>"); 407 MODULE_DESCRIPTION("Analog Devices AD5686/85/84 DAC"); 408 MODULE_LICENSE("GPL v2"); 409