2 * AD5755, AD5755-1, AD5757, AD5735, AD5737 Digital to analog converters driver
4 * Copyright 2012 Analog Devices Inc.
6 * Licensed under the GPL-2.
9 #include <linux/device.h>
10 #include <linux/err.h>
11 #include <linux/module.h>
12 #include <linux/kernel.h>
13 #include <linux/spi/spi.h>
14 #include <linux/slab.h>
15 #include <linux/sysfs.h>
16 #include <linux/delay.h>
17 #include <linux/iio/iio.h>
18 #include <linux/iio/sysfs.h>
19 #include <linux/platform_data/ad5755.h>
21 #define AD5755_NUM_CHANNELS 4
23 #define AD5755_ADDR(x) ((x) << 16)
25 #define AD5755_WRITE_REG_DATA(chan) (chan)
26 #define AD5755_WRITE_REG_GAIN(chan) (0x08 | (chan))
27 #define AD5755_WRITE_REG_OFFSET(chan) (0x10 | (chan))
28 #define AD5755_WRITE_REG_CTRL(chan) (0x1c | (chan))
30 #define AD5755_READ_REG_DATA(chan) (chan)
31 #define AD5755_READ_REG_CTRL(chan) (0x4 | (chan))
32 #define AD5755_READ_REG_GAIN(chan) (0x8 | (chan))
33 #define AD5755_READ_REG_OFFSET(chan) (0xc | (chan))
34 #define AD5755_READ_REG_CLEAR(chan) (0x10 | (chan))
35 #define AD5755_READ_REG_SLEW(chan) (0x14 | (chan))
36 #define AD5755_READ_REG_STATUS 0x18
37 #define AD5755_READ_REG_MAIN 0x19
38 #define AD5755_READ_REG_DC_DC 0x1a
40 #define AD5755_CTRL_REG_SLEW 0x0
41 #define AD5755_CTRL_REG_MAIN 0x1
42 #define AD5755_CTRL_REG_DAC 0x2
43 #define AD5755_CTRL_REG_DC_DC 0x3
44 #define AD5755_CTRL_REG_SW 0x4
46 #define AD5755_READ_FLAG 0x800000
48 #define AD5755_NOOP 0x1CE000
50 #define AD5755_DAC_INT_EN BIT(8)
51 #define AD5755_DAC_CLR_EN BIT(7)
52 #define AD5755_DAC_OUT_EN BIT(6)
53 #define AD5755_DAC_INT_CURRENT_SENSE_RESISTOR BIT(5)
54 #define AD5755_DAC_DC_DC_EN BIT(4)
55 #define AD5755_DAC_VOLTAGE_OVERRANGE_EN BIT(3)
57 #define AD5755_DC_DC_MAXV 0
58 #define AD5755_DC_DC_FREQ_SHIFT 2
59 #define AD5755_DC_DC_PHASE_SHIFT 4
60 #define AD5755_EXT_DC_DC_COMP_RES BIT(6)
62 #define AD5755_SLEW_STEP_SIZE_SHIFT 0
63 #define AD5755_SLEW_RATE_SHIFT 3
64 #define AD5755_SLEW_ENABLE BIT(12)
67 * struct ad5755_chip_info - chip specific information
68 * @channel_template: channel specification
69 * @calib_shift: shift for the calibration data registers
70 * @has_voltage_out: whether the chip has voltage outputs
72 struct ad5755_chip_info
{
73 const struct iio_chan_spec channel_template
;
74 unsigned int calib_shift
;
79 * struct ad5755_state - driver instance specific data
80 * @spi: spi device the driver is attached to
81 * @chip_info: chip model specific constants, available modes etc
82 * @pwr_down: bitmask which contains hether a channel is powered down or not
83 * @ctrl: software shadow of the channel ctrl registers
84 * @channels: iio channel spec for the device
85 * @data: spi transfer buffers
88 struct spi_device
*spi
;
89 const struct ad5755_chip_info
*chip_info
;
90 unsigned int pwr_down
;
91 unsigned int ctrl
[AD5755_NUM_CHANNELS
];
92 struct iio_chan_spec channels
[AD5755_NUM_CHANNELS
];
95 * DMA (thus cache coherency maintenance) requires the
96 * transfer buffers to live in their own cache lines.
102 } data
[2] ____cacheline_aligned
;
112 static int ad5755_write_unlocked(struct iio_dev
*indio_dev
,
113 unsigned int reg
, unsigned int val
)
115 struct ad5755_state
*st
= iio_priv(indio_dev
);
117 st
->data
[0].d32
= cpu_to_be32((reg
<< 16) | val
);
119 return spi_write(st
->spi
, &st
->data
[0].d8
[1], 3);
122 static int ad5755_write_ctrl_unlocked(struct iio_dev
*indio_dev
,
123 unsigned int channel
, unsigned int reg
, unsigned int val
)
125 return ad5755_write_unlocked(indio_dev
,
126 AD5755_WRITE_REG_CTRL(channel
), (reg
<< 13) | val
);
129 static int ad5755_write(struct iio_dev
*indio_dev
, unsigned int reg
,
134 mutex_lock(&indio_dev
->mlock
);
135 ret
= ad5755_write_unlocked(indio_dev
, reg
, val
);
136 mutex_unlock(&indio_dev
->mlock
);
141 static int ad5755_write_ctrl(struct iio_dev
*indio_dev
, unsigned int channel
,
142 unsigned int reg
, unsigned int val
)
146 mutex_lock(&indio_dev
->mlock
);
147 ret
= ad5755_write_ctrl_unlocked(indio_dev
, channel
, reg
, val
);
148 mutex_unlock(&indio_dev
->mlock
);
153 static int ad5755_read(struct iio_dev
*indio_dev
, unsigned int addr
)
155 struct ad5755_state
*st
= iio_priv(indio_dev
);
157 struct spi_transfer t
[] = {
159 .tx_buf
= &st
->data
[0].d8
[1],
163 .tx_buf
= &st
->data
[1].d8
[1],
164 .rx_buf
= &st
->data
[1].d8
[1],
169 mutex_lock(&indio_dev
->mlock
);
171 st
->data
[0].d32
= cpu_to_be32(AD5755_READ_FLAG
| (addr
<< 16));
172 st
->data
[1].d32
= cpu_to_be32(AD5755_NOOP
);
174 ret
= spi_sync_transfer(st
->spi
, t
, ARRAY_SIZE(t
));
176 ret
= be32_to_cpu(st
->data
[1].d32
) & 0xffff;
178 mutex_unlock(&indio_dev
->mlock
);
183 static int ad5755_update_dac_ctrl(struct iio_dev
*indio_dev
,
184 unsigned int channel
, unsigned int set
, unsigned int clr
)
186 struct ad5755_state
*st
= iio_priv(indio_dev
);
189 st
->ctrl
[channel
] |= set
;
190 st
->ctrl
[channel
] &= ~clr
;
192 ret
= ad5755_write_ctrl_unlocked(indio_dev
, channel
,
193 AD5755_CTRL_REG_DAC
, st
->ctrl
[channel
]);
198 static int ad5755_set_channel_pwr_down(struct iio_dev
*indio_dev
,
199 unsigned int channel
, bool pwr_down
)
201 struct ad5755_state
*st
= iio_priv(indio_dev
);
202 unsigned int mask
= BIT(channel
);
204 mutex_lock(&indio_dev
->mlock
);
206 if ((bool)(st
->pwr_down
& mask
) == pwr_down
)
210 st
->pwr_down
&= ~mask
;
211 ad5755_update_dac_ctrl(indio_dev
, channel
,
212 AD5755_DAC_INT_EN
| AD5755_DAC_DC_DC_EN
, 0);
214 ad5755_update_dac_ctrl(indio_dev
, channel
,
215 AD5755_DAC_OUT_EN
, 0);
217 st
->pwr_down
|= mask
;
218 ad5755_update_dac_ctrl(indio_dev
, channel
,
219 0, AD5755_DAC_INT_EN
| AD5755_DAC_OUT_EN
|
220 AD5755_DAC_DC_DC_EN
);
224 mutex_unlock(&indio_dev
->mlock
);
229 static const int ad5755_min_max_table
[][2] = {
230 [AD5755_MODE_VOLTAGE_0V_5V
] = { 0, 5000 },
231 [AD5755_MODE_VOLTAGE_0V_10V
] = { 0, 10000 },
232 [AD5755_MODE_VOLTAGE_PLUSMINUS_5V
] = { -5000, 5000 },
233 [AD5755_MODE_VOLTAGE_PLUSMINUS_10V
] = { -10000, 10000 },
234 [AD5755_MODE_CURRENT_4mA_20mA
] = { 4, 20 },
235 [AD5755_MODE_CURRENT_0mA_20mA
] = { 0, 20 },
236 [AD5755_MODE_CURRENT_0mA_24mA
] = { 0, 24 },
239 static void ad5755_get_min_max(struct ad5755_state
*st
,
240 struct iio_chan_spec
const *chan
, int *min
, int *max
)
242 enum ad5755_mode mode
= st
->ctrl
[chan
->channel
] & 7;
243 *min
= ad5755_min_max_table
[mode
][0];
244 *max
= ad5755_min_max_table
[mode
][1];
247 static inline int ad5755_get_offset(struct ad5755_state
*st
,
248 struct iio_chan_spec
const *chan
)
252 ad5755_get_min_max(st
, chan
, &min
, &max
);
253 return (min
* (1 << chan
->scan_type
.realbits
)) / (max
- min
);
256 static inline int ad5755_get_scale(struct ad5755_state
*st
,
257 struct iio_chan_spec
const *chan
)
261 ad5755_get_min_max(st
, chan
, &min
, &max
);
262 return ((max
- min
) * 1000000000ULL) >> chan
->scan_type
.realbits
;
265 static int ad5755_chan_reg_info(struct ad5755_state
*st
,
266 struct iio_chan_spec
const *chan
, long info
, bool write
,
267 unsigned int *reg
, unsigned int *shift
, unsigned int *offset
)
270 case IIO_CHAN_INFO_RAW
:
272 *reg
= AD5755_WRITE_REG_DATA(chan
->address
);
274 *reg
= AD5755_READ_REG_DATA(chan
->address
);
275 *shift
= chan
->scan_type
.shift
;
278 case IIO_CHAN_INFO_CALIBBIAS
:
280 *reg
= AD5755_WRITE_REG_OFFSET(chan
->address
);
282 *reg
= AD5755_READ_REG_OFFSET(chan
->address
);
283 *shift
= st
->chip_info
->calib_shift
;
286 case IIO_CHAN_INFO_CALIBSCALE
:
288 *reg
= AD5755_WRITE_REG_GAIN(chan
->address
);
290 *reg
= AD5755_READ_REG_GAIN(chan
->address
);
291 *shift
= st
->chip_info
->calib_shift
;
301 static int ad5755_read_raw(struct iio_dev
*indio_dev
,
302 const struct iio_chan_spec
*chan
, int *val
, int *val2
, long info
)
304 struct ad5755_state
*st
= iio_priv(indio_dev
);
305 unsigned int reg
, shift
, offset
;
309 case IIO_CHAN_INFO_SCALE
:
311 *val2
= ad5755_get_scale(st
, chan
);
312 return IIO_VAL_INT_PLUS_NANO
;
313 case IIO_CHAN_INFO_OFFSET
:
314 *val
= ad5755_get_offset(st
, chan
);
317 ret
= ad5755_chan_reg_info(st
, chan
, info
, false,
318 ®
, &shift
, &offset
);
322 ret
= ad5755_read(indio_dev
, reg
);
326 *val
= (ret
- offset
) >> shift
;
334 static int ad5755_write_raw(struct iio_dev
*indio_dev
,
335 const struct iio_chan_spec
*chan
, int val
, int val2
, long info
)
337 struct ad5755_state
*st
= iio_priv(indio_dev
);
338 unsigned int shift
, reg
, offset
;
341 ret
= ad5755_chan_reg_info(st
, chan
, info
, true,
342 ®
, &shift
, &offset
);
349 if (val
< 0 || val
> 0xffff)
352 return ad5755_write(indio_dev
, reg
, val
);
355 static ssize_t
ad5755_read_powerdown(struct iio_dev
*indio_dev
, uintptr_t priv
,
356 const struct iio_chan_spec
*chan
, char *buf
)
358 struct ad5755_state
*st
= iio_priv(indio_dev
);
360 return sprintf(buf
, "%d\n",
361 (bool)(st
->pwr_down
& (1 << chan
->channel
)));
364 static ssize_t
ad5755_write_powerdown(struct iio_dev
*indio_dev
, uintptr_t priv
,
365 struct iio_chan_spec
const *chan
, const char *buf
, size_t len
)
370 ret
= strtobool(buf
, &pwr_down
);
374 ret
= ad5755_set_channel_pwr_down(indio_dev
, chan
->channel
, pwr_down
);
375 return ret
? ret
: len
;
378 static const struct iio_info ad5755_info
= {
379 .read_raw
= ad5755_read_raw
,
380 .write_raw
= ad5755_write_raw
,
381 .driver_module
= THIS_MODULE
,
384 static const struct iio_chan_spec_ext_info ad5755_ext_info
[] = {
387 .read
= ad5755_read_powerdown
,
388 .write
= ad5755_write_powerdown
,
393 #define AD5755_CHANNEL(_bits) { \
396 .info_mask_separate = BIT(IIO_CHAN_INFO_RAW) | \
397 BIT(IIO_CHAN_INFO_SCALE) | \
398 BIT(IIO_CHAN_INFO_OFFSET) | \
399 BIT(IIO_CHAN_INFO_CALIBSCALE) | \
400 BIT(IIO_CHAN_INFO_CALIBBIAS), \
401 .scan_type = IIO_ST('u', (_bits), 16, 16 - (_bits)), \
402 .ext_info = ad5755_ext_info, \
405 static const struct ad5755_chip_info ad5755_chip_info_tbl
[] = {
407 .channel_template
= AD5755_CHANNEL(14),
408 .has_voltage_out
= true,
412 .channel_template
= AD5755_CHANNEL(14),
413 .has_voltage_out
= false,
417 .channel_template
= AD5755_CHANNEL(16),
418 .has_voltage_out
= true,
422 .channel_template
= AD5755_CHANNEL(16),
423 .has_voltage_out
= false,
428 static bool ad5755_is_valid_mode(struct ad5755_state
*st
, enum ad5755_mode mode
)
431 case AD5755_MODE_VOLTAGE_0V_5V
:
432 case AD5755_MODE_VOLTAGE_0V_10V
:
433 case AD5755_MODE_VOLTAGE_PLUSMINUS_5V
:
434 case AD5755_MODE_VOLTAGE_PLUSMINUS_10V
:
435 return st
->chip_info
->has_voltage_out
;
436 case AD5755_MODE_CURRENT_4mA_20mA
:
437 case AD5755_MODE_CURRENT_0mA_20mA
:
438 case AD5755_MODE_CURRENT_0mA_24mA
:
445 static int ad5755_setup_pdata(struct iio_dev
*indio_dev
,
446 const struct ad5755_platform_data
*pdata
)
448 struct ad5755_state
*st
= iio_priv(indio_dev
);
453 if (pdata
->dc_dc_phase
> AD5755_DC_DC_PHASE_90_DEGREE
||
454 pdata
->dc_dc_freq
> AD5755_DC_DC_FREQ_650kHZ
||
455 pdata
->dc_dc_maxv
> AD5755_DC_DC_MAXV_29V5
)
458 val
= pdata
->dc_dc_maxv
<< AD5755_DC_DC_MAXV
;
459 val
|= pdata
->dc_dc_freq
<< AD5755_DC_DC_FREQ_SHIFT
;
460 val
|= pdata
->dc_dc_phase
<< AD5755_DC_DC_PHASE_SHIFT
;
461 if (pdata
->ext_dc_dc_compenstation_resistor
)
462 val
|= AD5755_EXT_DC_DC_COMP_RES
;
464 ret
= ad5755_write_ctrl(indio_dev
, 0, AD5755_CTRL_REG_DC_DC
, val
);
468 for (i
= 0; i
< ARRAY_SIZE(pdata
->dac
); ++i
) {
469 val
= pdata
->dac
[i
].slew
.step_size
<<
470 AD5755_SLEW_STEP_SIZE_SHIFT
;
471 val
|= pdata
->dac
[i
].slew
.rate
<<
472 AD5755_SLEW_RATE_SHIFT
;
473 if (pdata
->dac
[i
].slew
.enable
)
474 val
|= AD5755_SLEW_ENABLE
;
476 ret
= ad5755_write_ctrl(indio_dev
, i
,
477 AD5755_CTRL_REG_SLEW
, val
);
482 for (i
= 0; i
< ARRAY_SIZE(pdata
->dac
); ++i
) {
483 if (!ad5755_is_valid_mode(st
, pdata
->dac
[i
].mode
))
487 if (!pdata
->dac
[i
].ext_current_sense_resistor
)
488 val
|= AD5755_DAC_INT_CURRENT_SENSE_RESISTOR
;
489 if (pdata
->dac
[i
].enable_voltage_overrange
)
490 val
|= AD5755_DAC_VOLTAGE_OVERRANGE_EN
;
491 val
|= pdata
->dac
[i
].mode
;
493 ret
= ad5755_update_dac_ctrl(indio_dev
, i
, val
, 0);
501 static bool ad5755_is_voltage_mode(enum ad5755_mode mode
)
504 case AD5755_MODE_VOLTAGE_0V_5V
:
505 case AD5755_MODE_VOLTAGE_0V_10V
:
506 case AD5755_MODE_VOLTAGE_PLUSMINUS_5V
:
507 case AD5755_MODE_VOLTAGE_PLUSMINUS_10V
:
514 static int ad5755_init_channels(struct iio_dev
*indio_dev
,
515 const struct ad5755_platform_data
*pdata
)
517 struct ad5755_state
*st
= iio_priv(indio_dev
);
518 struct iio_chan_spec
*channels
= st
->channels
;
521 for (i
= 0; i
< AD5755_NUM_CHANNELS
; ++i
) {
522 channels
[i
] = st
->chip_info
->channel_template
;
523 channels
[i
].channel
= i
;
524 channels
[i
].address
= i
;
525 if (pdata
&& ad5755_is_voltage_mode(pdata
->dac
[i
].mode
))
526 channels
[i
].type
= IIO_VOLTAGE
;
528 channels
[i
].type
= IIO_CURRENT
;
531 indio_dev
->channels
= channels
;
536 #define AD5755_DEFAULT_DAC_PDATA { \
537 .mode = AD5755_MODE_CURRENT_4mA_20mA, \
538 .ext_current_sense_resistor = true, \
539 .enable_voltage_overrange = false, \
542 .rate = AD5755_SLEW_RATE_64k, \
543 .step_size = AD5755_SLEW_STEP_SIZE_1, \
547 static const struct ad5755_platform_data ad5755_default_pdata
= {
548 .ext_dc_dc_compenstation_resistor
= false,
549 .dc_dc_phase
= AD5755_DC_DC_PHASE_ALL_SAME_EDGE
,
550 .dc_dc_freq
= AD5755_DC_DC_FREQ_410kHZ
,
551 .dc_dc_maxv
= AD5755_DC_DC_MAXV_23V
,
553 [0] = AD5755_DEFAULT_DAC_PDATA
,
554 [1] = AD5755_DEFAULT_DAC_PDATA
,
555 [2] = AD5755_DEFAULT_DAC_PDATA
,
556 [3] = AD5755_DEFAULT_DAC_PDATA
,
560 static int ad5755_probe(struct spi_device
*spi
)
562 enum ad5755_type type
= spi_get_device_id(spi
)->driver_data
;
563 const struct ad5755_platform_data
*pdata
= dev_get_platdata(&spi
->dev
);
564 struct iio_dev
*indio_dev
;
565 struct ad5755_state
*st
;
568 indio_dev
= devm_iio_device_alloc(&spi
->dev
, sizeof(*st
));
569 if (indio_dev
== NULL
) {
570 dev_err(&spi
->dev
, "Failed to allocate iio device\n");
574 st
= iio_priv(indio_dev
);
575 spi_set_drvdata(spi
, indio_dev
);
577 st
->chip_info
= &ad5755_chip_info_tbl
[type
];
581 indio_dev
->dev
.parent
= &spi
->dev
;
582 indio_dev
->name
= spi_get_device_id(spi
)->name
;
583 indio_dev
->info
= &ad5755_info
;
584 indio_dev
->modes
= INDIO_DIRECT_MODE
;
585 indio_dev
->num_channels
= AD5755_NUM_CHANNELS
;
588 pdata
= &ad5755_default_pdata
;
590 ret
= ad5755_init_channels(indio_dev
, pdata
);
594 ret
= ad5755_setup_pdata(indio_dev
, pdata
);
598 ret
= iio_device_register(indio_dev
);
600 dev_err(&spi
->dev
, "Failed to register iio device: %d\n", ret
);
607 static int ad5755_remove(struct spi_device
*spi
)
609 struct iio_dev
*indio_dev
= spi_get_drvdata(spi
);
611 iio_device_unregister(indio_dev
);
616 static const struct spi_device_id ad5755_id
[] = {
617 { "ad5755", ID_AD5755
},
618 { "ad5755-1", ID_AD5755
},
619 { "ad5757", ID_AD5757
},
620 { "ad5735", ID_AD5735
},
621 { "ad5737", ID_AD5737
},
624 MODULE_DEVICE_TABLE(spi
, ad5755_id
);
626 static struct spi_driver ad5755_driver
= {
629 .owner
= THIS_MODULE
,
631 .probe
= ad5755_probe
,
632 .remove
= ad5755_remove
,
633 .id_table
= ad5755_id
,
635 module_spi_driver(ad5755_driver
);
637 MODULE_AUTHOR("Lars-Peter Clausen <lars@metafoo.de>");
638 MODULE_DESCRIPTION("Analog Devices AD5755/55-1/57/35/37 DAC");
639 MODULE_LICENSE("GPL v2");