ad7923.c 10 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400
  1. // SPDX-License-Identifier: GPL-2.0-only
  2. /*
  3. * AD7904/AD7914/AD7923/AD7924/AD7908/AD7918/AD7928 SPI ADC driver
  4. *
  5. * Copyright 2011 Analog Devices Inc (from AD7923 Driver)
  6. * Copyright 2012 CS Systemes d'Information
  7. */
  8. #include <linux/device.h>
  9. #include <linux/kernel.h>
  10. #include <linux/property.h>
  11. #include <linux/slab.h>
  12. #include <linux/sysfs.h>
  13. #include <linux/spi/spi.h>
  14. #include <linux/regulator/consumer.h>
  15. #include <linux/err.h>
  16. #include <linux/delay.h>
  17. #include <linux/module.h>
  18. #include <linux/interrupt.h>
  19. #include <linux/iio/iio.h>
  20. #include <linux/iio/sysfs.h>
  21. #include <linux/iio/buffer.h>
  22. #include <linux/iio/trigger_consumer.h>
  23. #include <linux/iio/triggered_buffer.h>
  24. #define AD7923_WRITE_CR BIT(11) /* write control register */
  25. #define AD7923_RANGE BIT(1) /* range to REFin */
  26. #define AD7923_CODING BIT(0) /* coding is straight binary */
  27. #define AD7923_PM_MODE_AS (1) /* auto shutdown */
  28. #define AD7923_PM_MODE_FS (2) /* full shutdown */
  29. #define AD7923_PM_MODE_OPS (3) /* normal operation */
  30. #define AD7923_SEQUENCE_OFF (0) /* no sequence fonction */
  31. #define AD7923_SEQUENCE_PROTECT (2) /* no interrupt write cycle */
  32. #define AD7923_SEQUENCE_ON (3) /* continuous sequence */
  33. #define AD7923_PM_MODE_WRITE(mode) ((mode) << 4) /* write mode */
  34. #define AD7923_CHANNEL_WRITE(channel) ((channel) << 6) /* write channel */
  35. #define AD7923_SEQUENCE_WRITE(sequence) ((((sequence) & 1) << 3) \
  36. + (((sequence) & 2) << 9))
  37. /* write sequence fonction */
  38. /* left shift for CR : bit 11 transmit in first */
  39. #define AD7923_SHIFT_REGISTER 4
  40. /* val = value, dec = left shift, bits = number of bits of the mask */
  41. #define EXTRACT(val, dec, bits) (((val) >> (dec)) & ((1 << (bits)) - 1))
  42. struct ad7923_state {
  43. struct spi_device *spi;
  44. struct spi_transfer ring_xfer[5];
  45. struct spi_transfer scan_single_xfer[2];
  46. struct spi_message ring_msg;
  47. struct spi_message scan_single_msg;
  48. struct regulator *reg;
  49. unsigned int settings;
  50. /*
  51. * DMA (thus cache coherency maintenance) may require the
  52. * transfer buffers to live in their own cache lines.
  53. * Ensure rx_buf can be directly used in iio_push_to_buffers_with_timetamp
  54. * Length = 8 channels + 4 extra for 8 byte timestamp
  55. */
  56. __be16 rx_buf[12] __aligned(IIO_DMA_MINALIGN);
  57. __be16 tx_buf[4];
  58. };
  59. struct ad7923_chip_info {
  60. const struct iio_chan_spec *channels;
  61. unsigned int num_channels;
  62. };
  63. enum ad7923_id {
  64. AD7904,
  65. AD7914,
  66. AD7924,
  67. AD7908,
  68. AD7918,
  69. AD7928
  70. };
  71. #define AD7923_V_CHAN(index, bits) \
  72. { \
  73. .type = IIO_VOLTAGE, \
  74. .indexed = 1, \
  75. .channel = index, \
  76. .info_mask_separate = BIT(IIO_CHAN_INFO_RAW), \
  77. .info_mask_shared_by_type = BIT(IIO_CHAN_INFO_SCALE), \
  78. .address = index, \
  79. .scan_index = index, \
  80. .scan_type = { \
  81. .sign = 'u', \
  82. .realbits = (bits), \
  83. .storagebits = 16, \
  84. .shift = 12 - (bits), \
  85. .endianness = IIO_BE, \
  86. }, \
  87. }
  88. #define DECLARE_AD7923_CHANNELS(name, bits) \
  89. const struct iio_chan_spec name ## _channels[] = { \
  90. AD7923_V_CHAN(0, bits), \
  91. AD7923_V_CHAN(1, bits), \
  92. AD7923_V_CHAN(2, bits), \
  93. AD7923_V_CHAN(3, bits), \
  94. IIO_CHAN_SOFT_TIMESTAMP(4), \
  95. }
  96. #define DECLARE_AD7908_CHANNELS(name, bits) \
  97. const struct iio_chan_spec name ## _channels[] = { \
  98. AD7923_V_CHAN(0, bits), \
  99. AD7923_V_CHAN(1, bits), \
  100. AD7923_V_CHAN(2, bits), \
  101. AD7923_V_CHAN(3, bits), \
  102. AD7923_V_CHAN(4, bits), \
  103. AD7923_V_CHAN(5, bits), \
  104. AD7923_V_CHAN(6, bits), \
  105. AD7923_V_CHAN(7, bits), \
  106. IIO_CHAN_SOFT_TIMESTAMP(8), \
  107. }
  108. static DECLARE_AD7923_CHANNELS(ad7904, 8);
  109. static DECLARE_AD7923_CHANNELS(ad7914, 10);
  110. static DECLARE_AD7923_CHANNELS(ad7924, 12);
  111. static DECLARE_AD7908_CHANNELS(ad7908, 8);
  112. static DECLARE_AD7908_CHANNELS(ad7918, 10);
  113. static DECLARE_AD7908_CHANNELS(ad7928, 12);
  114. static const struct ad7923_chip_info ad7923_chip_info[] = {
  115. [AD7904] = {
  116. .channels = ad7904_channels,
  117. .num_channels = ARRAY_SIZE(ad7904_channels),
  118. },
  119. [AD7914] = {
  120. .channels = ad7914_channels,
  121. .num_channels = ARRAY_SIZE(ad7914_channels),
  122. },
  123. [AD7924] = {
  124. .channels = ad7924_channels,
  125. .num_channels = ARRAY_SIZE(ad7924_channels),
  126. },
  127. [AD7908] = {
  128. .channels = ad7908_channels,
  129. .num_channels = ARRAY_SIZE(ad7908_channels),
  130. },
  131. [AD7918] = {
  132. .channels = ad7918_channels,
  133. .num_channels = ARRAY_SIZE(ad7918_channels),
  134. },
  135. [AD7928] = {
  136. .channels = ad7928_channels,
  137. .num_channels = ARRAY_SIZE(ad7928_channels),
  138. },
  139. };
  140. /*
  141. * ad7923_update_scan_mode() setup the spi transfer buffer for the new scan mask
  142. */
  143. static int ad7923_update_scan_mode(struct iio_dev *indio_dev,
  144. const unsigned long *active_scan_mask)
  145. {
  146. struct ad7923_state *st = iio_priv(indio_dev);
  147. int i, cmd, len;
  148. len = 0;
  149. /*
  150. * For this driver the last channel is always the software timestamp so
  151. * skip that one.
  152. */
  153. for_each_set_bit(i, active_scan_mask, indio_dev->num_channels - 1) {
  154. cmd = AD7923_WRITE_CR | AD7923_CHANNEL_WRITE(i) |
  155. AD7923_SEQUENCE_WRITE(AD7923_SEQUENCE_OFF) |
  156. st->settings;
  157. cmd <<= AD7923_SHIFT_REGISTER;
  158. st->tx_buf[len++] = cpu_to_be16(cmd);
  159. }
  160. /* build spi ring message */
  161. st->ring_xfer[0].tx_buf = &st->tx_buf[0];
  162. st->ring_xfer[0].len = len;
  163. st->ring_xfer[0].cs_change = 1;
  164. spi_message_init(&st->ring_msg);
  165. spi_message_add_tail(&st->ring_xfer[0], &st->ring_msg);
  166. for (i = 0; i < len; i++) {
  167. st->ring_xfer[i + 1].rx_buf = &st->rx_buf[i];
  168. st->ring_xfer[i + 1].len = 2;
  169. st->ring_xfer[i + 1].cs_change = 1;
  170. spi_message_add_tail(&st->ring_xfer[i + 1], &st->ring_msg);
  171. }
  172. /* make sure last transfer cs_change is not set */
  173. st->ring_xfer[i + 1].cs_change = 0;
  174. return 0;
  175. }
  176. static irqreturn_t ad7923_trigger_handler(int irq, void *p)
  177. {
  178. struct iio_poll_func *pf = p;
  179. struct iio_dev *indio_dev = pf->indio_dev;
  180. struct ad7923_state *st = iio_priv(indio_dev);
  181. int b_sent;
  182. b_sent = spi_sync(st->spi, &st->ring_msg);
  183. if (b_sent)
  184. goto done;
  185. iio_push_to_buffers_with_timestamp(indio_dev, st->rx_buf,
  186. iio_get_time_ns(indio_dev));
  187. done:
  188. iio_trigger_notify_done(indio_dev->trig);
  189. return IRQ_HANDLED;
  190. }
  191. static int ad7923_scan_direct(struct ad7923_state *st, unsigned int ch)
  192. {
  193. int ret, cmd;
  194. cmd = AD7923_WRITE_CR | AD7923_CHANNEL_WRITE(ch) |
  195. AD7923_SEQUENCE_WRITE(AD7923_SEQUENCE_OFF) |
  196. st->settings;
  197. cmd <<= AD7923_SHIFT_REGISTER;
  198. st->tx_buf[0] = cpu_to_be16(cmd);
  199. ret = spi_sync(st->spi, &st->scan_single_msg);
  200. if (ret)
  201. return ret;
  202. return be16_to_cpu(st->rx_buf[0]);
  203. }
  204. static int ad7923_get_range(struct ad7923_state *st)
  205. {
  206. int vref;
  207. vref = regulator_get_voltage(st->reg);
  208. if (vref < 0)
  209. return vref;
  210. vref /= 1000;
  211. if (!(st->settings & AD7923_RANGE))
  212. vref *= 2;
  213. return vref;
  214. }
  215. static int ad7923_read_raw(struct iio_dev *indio_dev,
  216. struct iio_chan_spec const *chan,
  217. int *val,
  218. int *val2,
  219. long m)
  220. {
  221. int ret;
  222. struct ad7923_state *st = iio_priv(indio_dev);
  223. switch (m) {
  224. case IIO_CHAN_INFO_RAW:
  225. ret = iio_device_claim_direct_mode(indio_dev);
  226. if (ret)
  227. return ret;
  228. ret = ad7923_scan_direct(st, chan->address);
  229. iio_device_release_direct_mode(indio_dev);
  230. if (ret < 0)
  231. return ret;
  232. if (chan->address == EXTRACT(ret, 12, 4))
  233. *val = EXTRACT(ret, chan->scan_type.shift,
  234. chan->scan_type.realbits);
  235. else
  236. return -EIO;
  237. return IIO_VAL_INT;
  238. case IIO_CHAN_INFO_SCALE:
  239. ret = ad7923_get_range(st);
  240. if (ret < 0)
  241. return ret;
  242. *val = ret;
  243. *val2 = chan->scan_type.realbits;
  244. return IIO_VAL_FRACTIONAL_LOG2;
  245. }
  246. return -EINVAL;
  247. }
  248. static const struct iio_info ad7923_info = {
  249. .read_raw = &ad7923_read_raw,
  250. .update_scan_mode = ad7923_update_scan_mode,
  251. };
  252. static void ad7923_regulator_disable(void *data)
  253. {
  254. struct ad7923_state *st = data;
  255. regulator_disable(st->reg);
  256. }
  257. static int ad7923_probe(struct spi_device *spi)
  258. {
  259. u32 ad7923_range = AD7923_RANGE;
  260. struct ad7923_state *st;
  261. struct iio_dev *indio_dev;
  262. const struct ad7923_chip_info *info;
  263. int ret;
  264. indio_dev = devm_iio_device_alloc(&spi->dev, sizeof(*st));
  265. if (!indio_dev)
  266. return -ENOMEM;
  267. st = iio_priv(indio_dev);
  268. if (device_property_read_bool(&spi->dev, "adi,range-double"))
  269. ad7923_range = 0;
  270. st->spi = spi;
  271. st->settings = AD7923_CODING | ad7923_range |
  272. AD7923_PM_MODE_WRITE(AD7923_PM_MODE_OPS);
  273. info = &ad7923_chip_info[spi_get_device_id(spi)->driver_data];
  274. indio_dev->name = spi_get_device_id(spi)->name;
  275. indio_dev->modes = INDIO_DIRECT_MODE;
  276. indio_dev->channels = info->channels;
  277. indio_dev->num_channels = info->num_channels;
  278. indio_dev->info = &ad7923_info;
  279. /* Setup default message */
  280. st->scan_single_xfer[0].tx_buf = &st->tx_buf[0];
  281. st->scan_single_xfer[0].len = 2;
  282. st->scan_single_xfer[0].cs_change = 1;
  283. st->scan_single_xfer[1].rx_buf = &st->rx_buf[0];
  284. st->scan_single_xfer[1].len = 2;
  285. spi_message_init(&st->scan_single_msg);
  286. spi_message_add_tail(&st->scan_single_xfer[0], &st->scan_single_msg);
  287. spi_message_add_tail(&st->scan_single_xfer[1], &st->scan_single_msg);
  288. st->reg = devm_regulator_get(&spi->dev, "refin");
  289. if (IS_ERR(st->reg))
  290. return PTR_ERR(st->reg);
  291. ret = regulator_enable(st->reg);
  292. if (ret)
  293. return ret;
  294. ret = devm_add_action_or_reset(&spi->dev, ad7923_regulator_disable, st);
  295. if (ret)
  296. return ret;
  297. ret = devm_iio_triggered_buffer_setup(&spi->dev, indio_dev, NULL,
  298. &ad7923_trigger_handler, NULL);
  299. if (ret)
  300. return ret;
  301. return devm_iio_device_register(&spi->dev, indio_dev);
  302. }
  303. static const struct spi_device_id ad7923_id[] = {
  304. {"ad7904", AD7904},
  305. {"ad7914", AD7914},
  306. {"ad7923", AD7924},
  307. {"ad7924", AD7924},
  308. {"ad7908", AD7908},
  309. {"ad7918", AD7918},
  310. {"ad7928", AD7928},
  311. {}
  312. };
  313. MODULE_DEVICE_TABLE(spi, ad7923_id);
  314. static const struct of_device_id ad7923_of_match[] = {
  315. { .compatible = "adi,ad7904", },
  316. { .compatible = "adi,ad7914", },
  317. { .compatible = "adi,ad7923", },
  318. { .compatible = "adi,ad7924", },
  319. { .compatible = "adi,ad7908", },
  320. { .compatible = "adi,ad7918", },
  321. { .compatible = "adi,ad7928", },
  322. { },
  323. };
  324. MODULE_DEVICE_TABLE(of, ad7923_of_match);
  325. static struct spi_driver ad7923_driver = {
  326. .driver = {
  327. .name = "ad7923",
  328. .of_match_table = ad7923_of_match,
  329. },
  330. .probe = ad7923_probe,
  331. .id_table = ad7923_id,
  332. };
  333. module_spi_driver(ad7923_driver);
  334. MODULE_AUTHOR("Michael Hennerich <[email protected]>");
  335. MODULE_AUTHOR("Patrick Vasseur <[email protected]>");
  336. MODULE_DESCRIPTION("Analog Devices AD7923 and similar ADC");
  337. MODULE_LICENSE("GPL v2");