ad5791.c 11 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466
  1. // SPDX-License-Identifier: GPL-2.0-only
  2. /*
  3. * AD5760, AD5780, AD5781, AD5790, AD5791 Voltage Output Digital to Analog
  4. * Converter
  5. *
  6. * Copyright 2011 Analog Devices Inc.
  7. */
  8. #include <linux/interrupt.h>
  9. #include <linux/fs.h>
  10. #include <linux/device.h>
  11. #include <linux/kernel.h>
  12. #include <linux/spi/spi.h>
  13. #include <linux/slab.h>
  14. #include <linux/sysfs.h>
  15. #include <linux/regulator/consumer.h>
  16. #include <linux/module.h>
  17. #include <linux/bitops.h>
  18. #include <linux/iio/iio.h>
  19. #include <linux/iio/sysfs.h>
  20. #include <linux/iio/dac/ad5791.h>
  21. #define AD5791_DAC_MASK GENMASK(19, 0)
  22. #define AD5791_CMD_READ BIT(23)
  23. #define AD5791_CMD_WRITE 0
  24. #define AD5791_ADDR(addr) ((addr) << 20)
  25. /* Registers */
  26. #define AD5791_ADDR_NOOP 0
  27. #define AD5791_ADDR_DAC0 1
  28. #define AD5791_ADDR_CTRL 2
  29. #define AD5791_ADDR_CLRCODE 3
  30. #define AD5791_ADDR_SW_CTRL 4
  31. /* Control Register */
  32. #define AD5791_CTRL_RBUF BIT(1)
  33. #define AD5791_CTRL_OPGND BIT(2)
  34. #define AD5791_CTRL_DACTRI BIT(3)
  35. #define AD5791_CTRL_BIN2SC BIT(4)
  36. #define AD5791_CTRL_SDODIS BIT(5)
  37. #define AD5761_CTRL_LINCOMP(x) ((x) << 6)
  38. #define AD5791_LINCOMP_0_10 0
  39. #define AD5791_LINCOMP_10_12 1
  40. #define AD5791_LINCOMP_12_16 2
  41. #define AD5791_LINCOMP_16_19 3
  42. #define AD5791_LINCOMP_19_20 12
  43. #define AD5780_LINCOMP_0_10 0
  44. #define AD5780_LINCOMP_10_20 12
  45. /* Software Control Register */
  46. #define AD5791_SWCTRL_LDAC BIT(0)
  47. #define AD5791_SWCTRL_CLR BIT(1)
  48. #define AD5791_SWCTRL_RESET BIT(2)
  49. #define AD5791_DAC_PWRDN_6K 0
  50. #define AD5791_DAC_PWRDN_3STATE 1
  51. /**
  52. * struct ad5791_chip_info - chip specific information
  53. * @get_lin_comp: function pointer to the device specific function
  54. */
  55. struct ad5791_chip_info {
  56. int (*get_lin_comp) (unsigned int span);
  57. };
  58. /**
  59. * struct ad5791_state - driver instance specific data
  60. * @spi: spi_device
  61. * @reg_vdd: positive supply regulator
  62. * @reg_vss: negative supply regulator
  63. * @chip_info: chip model specific constants
  64. * @vref_mv: actual reference voltage used
  65. * @vref_neg_mv: voltage of the negative supply
  66. * @ctrl: control register cache
  67. * @pwr_down_mode: current power down mode
  68. * @pwr_down: true if device is powered down
  69. * @data: spi transfer buffers
  70. */
  71. struct ad5791_state {
  72. struct spi_device *spi;
  73. struct regulator *reg_vdd;
  74. struct regulator *reg_vss;
  75. const struct ad5791_chip_info *chip_info;
  76. unsigned short vref_mv;
  77. unsigned int vref_neg_mv;
  78. unsigned ctrl;
  79. unsigned pwr_down_mode;
  80. bool pwr_down;
  81. union {
  82. __be32 d32;
  83. u8 d8[4];
  84. } data[3] __aligned(IIO_DMA_MINALIGN);
  85. };
  86. enum ad5791_supported_device_ids {
  87. ID_AD5760,
  88. ID_AD5780,
  89. ID_AD5781,
  90. ID_AD5791,
  91. };
  92. static int ad5791_spi_write(struct ad5791_state *st, u8 addr, u32 val)
  93. {
  94. st->data[0].d32 = cpu_to_be32(AD5791_CMD_WRITE |
  95. AD5791_ADDR(addr) |
  96. (val & AD5791_DAC_MASK));
  97. return spi_write(st->spi, &st->data[0].d8[1], 3);
  98. }
  99. static int ad5791_spi_read(struct ad5791_state *st, u8 addr, u32 *val)
  100. {
  101. int ret;
  102. struct spi_transfer xfers[] = {
  103. {
  104. .tx_buf = &st->data[0].d8[1],
  105. .bits_per_word = 8,
  106. .len = 3,
  107. .cs_change = 1,
  108. }, {
  109. .tx_buf = &st->data[1].d8[1],
  110. .rx_buf = &st->data[2].d8[1],
  111. .bits_per_word = 8,
  112. .len = 3,
  113. },
  114. };
  115. st->data[0].d32 = cpu_to_be32(AD5791_CMD_READ |
  116. AD5791_ADDR(addr));
  117. st->data[1].d32 = cpu_to_be32(AD5791_ADDR(AD5791_ADDR_NOOP));
  118. ret = spi_sync_transfer(st->spi, xfers, ARRAY_SIZE(xfers));
  119. *val = be32_to_cpu(st->data[2].d32);
  120. return ret;
  121. }
  122. static const char * const ad5791_powerdown_modes[] = {
  123. "6kohm_to_gnd",
  124. "three_state",
  125. };
  126. static int ad5791_get_powerdown_mode(struct iio_dev *indio_dev,
  127. const struct iio_chan_spec *chan)
  128. {
  129. struct ad5791_state *st = iio_priv(indio_dev);
  130. return st->pwr_down_mode;
  131. }
  132. static int ad5791_set_powerdown_mode(struct iio_dev *indio_dev,
  133. const struct iio_chan_spec *chan, unsigned int mode)
  134. {
  135. struct ad5791_state *st = iio_priv(indio_dev);
  136. st->pwr_down_mode = mode;
  137. return 0;
  138. }
  139. static const struct iio_enum ad5791_powerdown_mode_enum = {
  140. .items = ad5791_powerdown_modes,
  141. .num_items = ARRAY_SIZE(ad5791_powerdown_modes),
  142. .get = ad5791_get_powerdown_mode,
  143. .set = ad5791_set_powerdown_mode,
  144. };
  145. static ssize_t ad5791_read_dac_powerdown(struct iio_dev *indio_dev,
  146. uintptr_t private, const struct iio_chan_spec *chan, char *buf)
  147. {
  148. struct ad5791_state *st = iio_priv(indio_dev);
  149. return sysfs_emit(buf, "%d\n", st->pwr_down);
  150. }
  151. static ssize_t ad5791_write_dac_powerdown(struct iio_dev *indio_dev,
  152. uintptr_t private, const struct iio_chan_spec *chan, const char *buf,
  153. size_t len)
  154. {
  155. bool pwr_down;
  156. int ret;
  157. struct ad5791_state *st = iio_priv(indio_dev);
  158. ret = kstrtobool(buf, &pwr_down);
  159. if (ret)
  160. return ret;
  161. if (!pwr_down) {
  162. st->ctrl &= ~(AD5791_CTRL_OPGND | AD5791_CTRL_DACTRI);
  163. } else {
  164. if (st->pwr_down_mode == AD5791_DAC_PWRDN_6K)
  165. st->ctrl |= AD5791_CTRL_OPGND;
  166. else if (st->pwr_down_mode == AD5791_DAC_PWRDN_3STATE)
  167. st->ctrl |= AD5791_CTRL_DACTRI;
  168. }
  169. st->pwr_down = pwr_down;
  170. ret = ad5791_spi_write(st, AD5791_ADDR_CTRL, st->ctrl);
  171. return ret ? ret : len;
  172. }
  173. static int ad5791_get_lin_comp(unsigned int span)
  174. {
  175. if (span <= 10000)
  176. return AD5791_LINCOMP_0_10;
  177. else if (span <= 12000)
  178. return AD5791_LINCOMP_10_12;
  179. else if (span <= 16000)
  180. return AD5791_LINCOMP_12_16;
  181. else if (span <= 19000)
  182. return AD5791_LINCOMP_16_19;
  183. else
  184. return AD5791_LINCOMP_19_20;
  185. }
  186. static int ad5780_get_lin_comp(unsigned int span)
  187. {
  188. if (span <= 10000)
  189. return AD5780_LINCOMP_0_10;
  190. else
  191. return AD5780_LINCOMP_10_20;
  192. }
  193. static const struct ad5791_chip_info ad5791_chip_info_tbl[] = {
  194. [ID_AD5760] = {
  195. .get_lin_comp = ad5780_get_lin_comp,
  196. },
  197. [ID_AD5780] = {
  198. .get_lin_comp = ad5780_get_lin_comp,
  199. },
  200. [ID_AD5781] = {
  201. .get_lin_comp = ad5791_get_lin_comp,
  202. },
  203. [ID_AD5791] = {
  204. .get_lin_comp = ad5791_get_lin_comp,
  205. },
  206. };
  207. static int ad5791_read_raw(struct iio_dev *indio_dev,
  208. struct iio_chan_spec const *chan,
  209. int *val,
  210. int *val2,
  211. long m)
  212. {
  213. struct ad5791_state *st = iio_priv(indio_dev);
  214. u64 val64;
  215. int ret;
  216. switch (m) {
  217. case IIO_CHAN_INFO_RAW:
  218. ret = ad5791_spi_read(st, chan->address, val);
  219. if (ret)
  220. return ret;
  221. *val &= AD5791_DAC_MASK;
  222. *val >>= chan->scan_type.shift;
  223. return IIO_VAL_INT;
  224. case IIO_CHAN_INFO_SCALE:
  225. *val = st->vref_mv;
  226. *val2 = (1 << chan->scan_type.realbits) - 1;
  227. return IIO_VAL_FRACTIONAL;
  228. case IIO_CHAN_INFO_OFFSET:
  229. val64 = (((u64)st->vref_neg_mv) << chan->scan_type.realbits);
  230. do_div(val64, st->vref_mv);
  231. *val = -val64;
  232. return IIO_VAL_INT;
  233. default:
  234. return -EINVAL;
  235. }
  236. };
  237. static const struct iio_chan_spec_ext_info ad5791_ext_info[] = {
  238. {
  239. .name = "powerdown",
  240. .shared = IIO_SHARED_BY_TYPE,
  241. .read = ad5791_read_dac_powerdown,
  242. .write = ad5791_write_dac_powerdown,
  243. },
  244. IIO_ENUM("powerdown_mode", IIO_SHARED_BY_TYPE,
  245. &ad5791_powerdown_mode_enum),
  246. IIO_ENUM_AVAILABLE("powerdown_mode", IIO_SHARED_BY_TYPE, &ad5791_powerdown_mode_enum),
  247. { },
  248. };
  249. #define AD5791_CHAN(bits, _shift) { \
  250. .type = IIO_VOLTAGE, \
  251. .output = 1, \
  252. .indexed = 1, \
  253. .address = AD5791_ADDR_DAC0, \
  254. .channel = 0, \
  255. .info_mask_separate = BIT(IIO_CHAN_INFO_RAW), \
  256. .info_mask_shared_by_type = BIT(IIO_CHAN_INFO_SCALE) | \
  257. BIT(IIO_CHAN_INFO_OFFSET), \
  258. .scan_type = { \
  259. .sign = 'u', \
  260. .realbits = (bits), \
  261. .storagebits = 24, \
  262. .shift = (_shift), \
  263. }, \
  264. .ext_info = ad5791_ext_info, \
  265. }
  266. static const struct iio_chan_spec ad5791_channels[] = {
  267. [ID_AD5760] = AD5791_CHAN(16, 4),
  268. [ID_AD5780] = AD5791_CHAN(18, 2),
  269. [ID_AD5781] = AD5791_CHAN(18, 2),
  270. [ID_AD5791] = AD5791_CHAN(20, 0)
  271. };
  272. static int ad5791_write_raw(struct iio_dev *indio_dev,
  273. struct iio_chan_spec const *chan,
  274. int val,
  275. int val2,
  276. long mask)
  277. {
  278. struct ad5791_state *st = iio_priv(indio_dev);
  279. switch (mask) {
  280. case IIO_CHAN_INFO_RAW:
  281. val &= GENMASK(chan->scan_type.realbits - 1, 0);
  282. val <<= chan->scan_type.shift;
  283. return ad5791_spi_write(st, chan->address, val);
  284. default:
  285. return -EINVAL;
  286. }
  287. }
  288. static const struct iio_info ad5791_info = {
  289. .read_raw = &ad5791_read_raw,
  290. .write_raw = &ad5791_write_raw,
  291. };
  292. static int ad5791_probe(struct spi_device *spi)
  293. {
  294. struct ad5791_platform_data *pdata = spi->dev.platform_data;
  295. struct iio_dev *indio_dev;
  296. struct ad5791_state *st;
  297. int ret, pos_voltage_uv = 0, neg_voltage_uv = 0;
  298. indio_dev = devm_iio_device_alloc(&spi->dev, sizeof(*st));
  299. if (!indio_dev)
  300. return -ENOMEM;
  301. st = iio_priv(indio_dev);
  302. st->reg_vdd = devm_regulator_get(&spi->dev, "vdd");
  303. if (!IS_ERR(st->reg_vdd)) {
  304. ret = regulator_enable(st->reg_vdd);
  305. if (ret)
  306. return ret;
  307. ret = regulator_get_voltage(st->reg_vdd);
  308. if (ret < 0)
  309. goto error_disable_reg_pos;
  310. pos_voltage_uv = ret;
  311. }
  312. st->reg_vss = devm_regulator_get(&spi->dev, "vss");
  313. if (!IS_ERR(st->reg_vss)) {
  314. ret = regulator_enable(st->reg_vss);
  315. if (ret)
  316. goto error_disable_reg_pos;
  317. ret = regulator_get_voltage(st->reg_vss);
  318. if (ret < 0)
  319. goto error_disable_reg_neg;
  320. neg_voltage_uv = ret;
  321. }
  322. st->pwr_down = true;
  323. st->spi = spi;
  324. if (!IS_ERR(st->reg_vss) && !IS_ERR(st->reg_vdd)) {
  325. st->vref_mv = (pos_voltage_uv + neg_voltage_uv) / 1000;
  326. st->vref_neg_mv = neg_voltage_uv / 1000;
  327. } else if (pdata) {
  328. st->vref_mv = pdata->vref_pos_mv + pdata->vref_neg_mv;
  329. st->vref_neg_mv = pdata->vref_neg_mv;
  330. } else {
  331. dev_warn(&spi->dev, "reference voltage unspecified\n");
  332. }
  333. ret = ad5791_spi_write(st, AD5791_ADDR_SW_CTRL, AD5791_SWCTRL_RESET);
  334. if (ret)
  335. goto error_disable_reg_neg;
  336. st->chip_info = &ad5791_chip_info_tbl[spi_get_device_id(spi)
  337. ->driver_data];
  338. st->ctrl = AD5761_CTRL_LINCOMP(st->chip_info->get_lin_comp(st->vref_mv))
  339. | ((pdata && pdata->use_rbuf_gain2) ? 0 : AD5791_CTRL_RBUF) |
  340. AD5791_CTRL_BIN2SC;
  341. ret = ad5791_spi_write(st, AD5791_ADDR_CTRL, st->ctrl |
  342. AD5791_CTRL_OPGND | AD5791_CTRL_DACTRI);
  343. if (ret)
  344. goto error_disable_reg_neg;
  345. spi_set_drvdata(spi, indio_dev);
  346. indio_dev->info = &ad5791_info;
  347. indio_dev->modes = INDIO_DIRECT_MODE;
  348. indio_dev->channels
  349. = &ad5791_channels[spi_get_device_id(spi)->driver_data];
  350. indio_dev->num_channels = 1;
  351. indio_dev->name = spi_get_device_id(st->spi)->name;
  352. ret = iio_device_register(indio_dev);
  353. if (ret)
  354. goto error_disable_reg_neg;
  355. return 0;
  356. error_disable_reg_neg:
  357. if (!IS_ERR(st->reg_vss))
  358. regulator_disable(st->reg_vss);
  359. error_disable_reg_pos:
  360. if (!IS_ERR(st->reg_vdd))
  361. regulator_disable(st->reg_vdd);
  362. return ret;
  363. }
  364. static void ad5791_remove(struct spi_device *spi)
  365. {
  366. struct iio_dev *indio_dev = spi_get_drvdata(spi);
  367. struct ad5791_state *st = iio_priv(indio_dev);
  368. iio_device_unregister(indio_dev);
  369. if (!IS_ERR(st->reg_vdd))
  370. regulator_disable(st->reg_vdd);
  371. if (!IS_ERR(st->reg_vss))
  372. regulator_disable(st->reg_vss);
  373. }
  374. static const struct spi_device_id ad5791_id[] = {
  375. {"ad5760", ID_AD5760},
  376. {"ad5780", ID_AD5780},
  377. {"ad5781", ID_AD5781},
  378. {"ad5790", ID_AD5791},
  379. {"ad5791", ID_AD5791},
  380. {}
  381. };
  382. MODULE_DEVICE_TABLE(spi, ad5791_id);
  383. static struct spi_driver ad5791_driver = {
  384. .driver = {
  385. .name = "ad5791",
  386. },
  387. .probe = ad5791_probe,
  388. .remove = ad5791_remove,
  389. .id_table = ad5791_id,
  390. };
  391. module_spi_driver(ad5791_driver);
  392. MODULE_AUTHOR("Michael Hennerich <[email protected]>");
  393. MODULE_DESCRIPTION("Analog Devices AD5760/AD5780/AD5781/AD5790/AD5791 DAC");
  394. MODULE_LICENSE("GPL v2");