adi-axi-adc.c 12 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473
  1. // SPDX-License-Identifier: GPL-2.0-only
  2. /*
  3. * Analog Devices Generic AXI ADC IP core
  4. * Link: https://wiki.analog.com/resources/fpga/docs/axi_adc_ip
  5. *
  6. * Copyright 2012-2020 Analog Devices Inc.
  7. */
  8. #include <linux/bitfield.h>
  9. #include <linux/clk.h>
  10. #include <linux/io.h>
  11. #include <linux/delay.h>
  12. #include <linux/module.h>
  13. #include <linux/of_device.h>
  14. #include <linux/platform_device.h>
  15. #include <linux/slab.h>
  16. #include <linux/iio/iio.h>
  17. #include <linux/iio/sysfs.h>
  18. #include <linux/iio/buffer.h>
  19. #include <linux/iio/buffer-dmaengine.h>
  20. #include <linux/fpga/adi-axi-common.h>
  21. #include <linux/iio/adc/adi-axi-adc.h>
  22. /*
  23. * Register definitions:
  24. * https://wiki.analog.com/resources/fpga/docs/axi_adc_ip#register_map
  25. */
  26. /* ADC controls */
  27. #define ADI_AXI_REG_RSTN 0x0040
  28. #define ADI_AXI_REG_RSTN_CE_N BIT(2)
  29. #define ADI_AXI_REG_RSTN_MMCM_RSTN BIT(1)
  30. #define ADI_AXI_REG_RSTN_RSTN BIT(0)
  31. /* ADC Channel controls */
  32. #define ADI_AXI_REG_CHAN_CTRL(c) (0x0400 + (c) * 0x40)
  33. #define ADI_AXI_REG_CHAN_CTRL_LB_OWR BIT(11)
  34. #define ADI_AXI_REG_CHAN_CTRL_PN_SEL_OWR BIT(10)
  35. #define ADI_AXI_REG_CHAN_CTRL_IQCOR_EN BIT(9)
  36. #define ADI_AXI_REG_CHAN_CTRL_DCFILT_EN BIT(8)
  37. #define ADI_AXI_REG_CHAN_CTRL_FMT_SIGNEXT BIT(6)
  38. #define ADI_AXI_REG_CHAN_CTRL_FMT_TYPE BIT(5)
  39. #define ADI_AXI_REG_CHAN_CTRL_FMT_EN BIT(4)
  40. #define ADI_AXI_REG_CHAN_CTRL_PN_TYPE_OWR BIT(1)
  41. #define ADI_AXI_REG_CHAN_CTRL_ENABLE BIT(0)
  42. #define ADI_AXI_REG_CHAN_CTRL_DEFAULTS \
  43. (ADI_AXI_REG_CHAN_CTRL_FMT_SIGNEXT | \
  44. ADI_AXI_REG_CHAN_CTRL_FMT_EN | \
  45. ADI_AXI_REG_CHAN_CTRL_ENABLE)
  46. struct adi_axi_adc_core_info {
  47. unsigned int version;
  48. };
  49. struct adi_axi_adc_state {
  50. struct mutex lock;
  51. struct adi_axi_adc_client *client;
  52. void __iomem *regs;
  53. };
  54. struct adi_axi_adc_client {
  55. struct list_head entry;
  56. struct adi_axi_adc_conv conv;
  57. struct adi_axi_adc_state *state;
  58. struct device *dev;
  59. const struct adi_axi_adc_core_info *info;
  60. };
  61. static LIST_HEAD(registered_clients);
  62. static DEFINE_MUTEX(registered_clients_lock);
  63. static struct adi_axi_adc_client *conv_to_client(struct adi_axi_adc_conv *conv)
  64. {
  65. return container_of(conv, struct adi_axi_adc_client, conv);
  66. }
  67. void *adi_axi_adc_conv_priv(struct adi_axi_adc_conv *conv)
  68. {
  69. struct adi_axi_adc_client *cl = conv_to_client(conv);
  70. return (char *)cl + ALIGN(sizeof(struct adi_axi_adc_client),
  71. IIO_DMA_MINALIGN);
  72. }
  73. EXPORT_SYMBOL_NS_GPL(adi_axi_adc_conv_priv, IIO_ADI_AXI);
  74. static void adi_axi_adc_write(struct adi_axi_adc_state *st,
  75. unsigned int reg,
  76. unsigned int val)
  77. {
  78. iowrite32(val, st->regs + reg);
  79. }
  80. static unsigned int adi_axi_adc_read(struct adi_axi_adc_state *st,
  81. unsigned int reg)
  82. {
  83. return ioread32(st->regs + reg);
  84. }
  85. static int adi_axi_adc_config_dma_buffer(struct device *dev,
  86. struct iio_dev *indio_dev)
  87. {
  88. const char *dma_name;
  89. if (!device_property_present(dev, "dmas"))
  90. return 0;
  91. if (device_property_read_string(dev, "dma-names", &dma_name))
  92. dma_name = "rx";
  93. return devm_iio_dmaengine_buffer_setup(indio_dev->dev.parent,
  94. indio_dev, dma_name);
  95. }
  96. static int adi_axi_adc_read_raw(struct iio_dev *indio_dev,
  97. struct iio_chan_spec const *chan,
  98. int *val, int *val2, long mask)
  99. {
  100. struct adi_axi_adc_state *st = iio_priv(indio_dev);
  101. struct adi_axi_adc_conv *conv = &st->client->conv;
  102. if (!conv->read_raw)
  103. return -EOPNOTSUPP;
  104. return conv->read_raw(conv, chan, val, val2, mask);
  105. }
  106. static int adi_axi_adc_write_raw(struct iio_dev *indio_dev,
  107. struct iio_chan_spec const *chan,
  108. int val, int val2, long mask)
  109. {
  110. struct adi_axi_adc_state *st = iio_priv(indio_dev);
  111. struct adi_axi_adc_conv *conv = &st->client->conv;
  112. if (!conv->write_raw)
  113. return -EOPNOTSUPP;
  114. return conv->write_raw(conv, chan, val, val2, mask);
  115. }
  116. static int adi_axi_adc_update_scan_mode(struct iio_dev *indio_dev,
  117. const unsigned long *scan_mask)
  118. {
  119. struct adi_axi_adc_state *st = iio_priv(indio_dev);
  120. struct adi_axi_adc_conv *conv = &st->client->conv;
  121. unsigned int i, ctrl;
  122. for (i = 0; i < conv->chip_info->num_channels; i++) {
  123. ctrl = adi_axi_adc_read(st, ADI_AXI_REG_CHAN_CTRL(i));
  124. if (test_bit(i, scan_mask))
  125. ctrl |= ADI_AXI_REG_CHAN_CTRL_ENABLE;
  126. else
  127. ctrl &= ~ADI_AXI_REG_CHAN_CTRL_ENABLE;
  128. adi_axi_adc_write(st, ADI_AXI_REG_CHAN_CTRL(i), ctrl);
  129. }
  130. return 0;
  131. }
  132. static struct adi_axi_adc_conv *adi_axi_adc_conv_register(struct device *dev,
  133. size_t sizeof_priv)
  134. {
  135. struct adi_axi_adc_client *cl;
  136. size_t alloc_size;
  137. alloc_size = ALIGN(sizeof(struct adi_axi_adc_client), IIO_DMA_MINALIGN);
  138. if (sizeof_priv)
  139. alloc_size += ALIGN(sizeof_priv, IIO_DMA_MINALIGN);
  140. cl = kzalloc(alloc_size, GFP_KERNEL);
  141. if (!cl)
  142. return ERR_PTR(-ENOMEM);
  143. mutex_lock(&registered_clients_lock);
  144. cl->dev = get_device(dev);
  145. list_add_tail(&cl->entry, &registered_clients);
  146. mutex_unlock(&registered_clients_lock);
  147. return &cl->conv;
  148. }
  149. static void adi_axi_adc_conv_unregister(struct adi_axi_adc_conv *conv)
  150. {
  151. struct adi_axi_adc_client *cl = conv_to_client(conv);
  152. mutex_lock(&registered_clients_lock);
  153. list_del(&cl->entry);
  154. put_device(cl->dev);
  155. mutex_unlock(&registered_clients_lock);
  156. kfree(cl);
  157. }
  158. static void devm_adi_axi_adc_conv_release(void *conv)
  159. {
  160. adi_axi_adc_conv_unregister(conv);
  161. }
  162. struct adi_axi_adc_conv *devm_adi_axi_adc_conv_register(struct device *dev,
  163. size_t sizeof_priv)
  164. {
  165. struct adi_axi_adc_conv *conv;
  166. int ret;
  167. conv = adi_axi_adc_conv_register(dev, sizeof_priv);
  168. if (IS_ERR(conv))
  169. return conv;
  170. ret = devm_add_action_or_reset(dev, devm_adi_axi_adc_conv_release,
  171. conv);
  172. if (ret)
  173. return ERR_PTR(ret);
  174. return conv;
  175. }
  176. EXPORT_SYMBOL_NS_GPL(devm_adi_axi_adc_conv_register, IIO_ADI_AXI);
  177. static ssize_t in_voltage_scale_available_show(struct device *dev,
  178. struct device_attribute *attr,
  179. char *buf)
  180. {
  181. struct iio_dev *indio_dev = dev_to_iio_dev(dev);
  182. struct adi_axi_adc_state *st = iio_priv(indio_dev);
  183. struct adi_axi_adc_conv *conv = &st->client->conv;
  184. size_t len = 0;
  185. int i;
  186. for (i = 0; i < conv->chip_info->num_scales; i++) {
  187. const unsigned int *s = conv->chip_info->scale_table[i];
  188. len += scnprintf(buf + len, PAGE_SIZE - len,
  189. "%u.%06u ", s[0], s[1]);
  190. }
  191. buf[len - 1] = '\n';
  192. return len;
  193. }
  194. static IIO_DEVICE_ATTR_RO(in_voltage_scale_available, 0);
  195. enum {
  196. ADI_AXI_ATTR_SCALE_AVAIL,
  197. };
  198. #define ADI_AXI_ATTR(_en_, _file_) \
  199. [ADI_AXI_ATTR_##_en_] = &iio_dev_attr_##_file_.dev_attr.attr
  200. static struct attribute *adi_axi_adc_attributes[] = {
  201. ADI_AXI_ATTR(SCALE_AVAIL, in_voltage_scale_available),
  202. NULL
  203. };
  204. static umode_t axi_adc_attr_is_visible(struct kobject *kobj,
  205. struct attribute *attr, int n)
  206. {
  207. struct device *dev = kobj_to_dev(kobj);
  208. struct iio_dev *indio_dev = dev_to_iio_dev(dev);
  209. struct adi_axi_adc_state *st = iio_priv(indio_dev);
  210. struct adi_axi_adc_conv *conv = &st->client->conv;
  211. switch (n) {
  212. case ADI_AXI_ATTR_SCALE_AVAIL:
  213. if (!conv->chip_info->num_scales)
  214. return 0;
  215. return attr->mode;
  216. default:
  217. return attr->mode;
  218. }
  219. }
  220. static const struct attribute_group adi_axi_adc_attribute_group = {
  221. .attrs = adi_axi_adc_attributes,
  222. .is_visible = axi_adc_attr_is_visible,
  223. };
  224. static const struct iio_info adi_axi_adc_info = {
  225. .read_raw = &adi_axi_adc_read_raw,
  226. .write_raw = &adi_axi_adc_write_raw,
  227. .attrs = &adi_axi_adc_attribute_group,
  228. .update_scan_mode = &adi_axi_adc_update_scan_mode,
  229. };
  230. static const struct adi_axi_adc_core_info adi_axi_adc_10_0_a_info = {
  231. .version = ADI_AXI_PCORE_VER(10, 0, 'a'),
  232. };
  233. static struct adi_axi_adc_client *adi_axi_adc_attach_client(struct device *dev)
  234. {
  235. const struct adi_axi_adc_core_info *info;
  236. struct adi_axi_adc_client *cl;
  237. struct device_node *cln;
  238. info = of_device_get_match_data(dev);
  239. if (!info)
  240. return ERR_PTR(-ENODEV);
  241. cln = of_parse_phandle(dev->of_node, "adi,adc-dev", 0);
  242. if (!cln) {
  243. dev_err(dev, "No 'adi,adc-dev' node defined\n");
  244. return ERR_PTR(-ENODEV);
  245. }
  246. mutex_lock(&registered_clients_lock);
  247. list_for_each_entry(cl, &registered_clients, entry) {
  248. if (!cl->dev)
  249. continue;
  250. if (cl->dev->of_node != cln)
  251. continue;
  252. if (!try_module_get(cl->dev->driver->owner)) {
  253. mutex_unlock(&registered_clients_lock);
  254. of_node_put(cln);
  255. return ERR_PTR(-ENODEV);
  256. }
  257. get_device(cl->dev);
  258. cl->info = info;
  259. mutex_unlock(&registered_clients_lock);
  260. of_node_put(cln);
  261. return cl;
  262. }
  263. mutex_unlock(&registered_clients_lock);
  264. of_node_put(cln);
  265. return ERR_PTR(-EPROBE_DEFER);
  266. }
  267. static int adi_axi_adc_setup_channels(struct device *dev,
  268. struct adi_axi_adc_state *st)
  269. {
  270. struct adi_axi_adc_conv *conv = &st->client->conv;
  271. int i, ret;
  272. if (conv->preenable_setup) {
  273. ret = conv->preenable_setup(conv);
  274. if (ret)
  275. return ret;
  276. }
  277. for (i = 0; i < conv->chip_info->num_channels; i++) {
  278. adi_axi_adc_write(st, ADI_AXI_REG_CHAN_CTRL(i),
  279. ADI_AXI_REG_CHAN_CTRL_DEFAULTS);
  280. }
  281. return 0;
  282. }
  283. static void axi_adc_reset(struct adi_axi_adc_state *st)
  284. {
  285. adi_axi_adc_write(st, ADI_AXI_REG_RSTN, 0);
  286. mdelay(10);
  287. adi_axi_adc_write(st, ADI_AXI_REG_RSTN, ADI_AXI_REG_RSTN_MMCM_RSTN);
  288. mdelay(10);
  289. adi_axi_adc_write(st, ADI_AXI_REG_RSTN,
  290. ADI_AXI_REG_RSTN_RSTN | ADI_AXI_REG_RSTN_MMCM_RSTN);
  291. }
  292. static void adi_axi_adc_cleanup(void *data)
  293. {
  294. struct adi_axi_adc_client *cl = data;
  295. put_device(cl->dev);
  296. module_put(cl->dev->driver->owner);
  297. }
  298. static int adi_axi_adc_probe(struct platform_device *pdev)
  299. {
  300. struct adi_axi_adc_conv *conv;
  301. struct iio_dev *indio_dev;
  302. struct adi_axi_adc_client *cl;
  303. struct adi_axi_adc_state *st;
  304. unsigned int ver;
  305. int ret;
  306. cl = adi_axi_adc_attach_client(&pdev->dev);
  307. if (IS_ERR(cl))
  308. return PTR_ERR(cl);
  309. ret = devm_add_action_or_reset(&pdev->dev, adi_axi_adc_cleanup, cl);
  310. if (ret)
  311. return ret;
  312. indio_dev = devm_iio_device_alloc(&pdev->dev, sizeof(*st));
  313. if (indio_dev == NULL)
  314. return -ENOMEM;
  315. st = iio_priv(indio_dev);
  316. st->client = cl;
  317. cl->state = st;
  318. mutex_init(&st->lock);
  319. st->regs = devm_platform_ioremap_resource(pdev, 0);
  320. if (IS_ERR(st->regs))
  321. return PTR_ERR(st->regs);
  322. conv = &st->client->conv;
  323. axi_adc_reset(st);
  324. ver = adi_axi_adc_read(st, ADI_AXI_REG_VERSION);
  325. if (cl->info->version > ver) {
  326. dev_err(&pdev->dev,
  327. "IP core version is too old. Expected %d.%.2d.%c, Reported %d.%.2d.%c\n",
  328. ADI_AXI_PCORE_VER_MAJOR(cl->info->version),
  329. ADI_AXI_PCORE_VER_MINOR(cl->info->version),
  330. ADI_AXI_PCORE_VER_PATCH(cl->info->version),
  331. ADI_AXI_PCORE_VER_MAJOR(ver),
  332. ADI_AXI_PCORE_VER_MINOR(ver),
  333. ADI_AXI_PCORE_VER_PATCH(ver));
  334. return -ENODEV;
  335. }
  336. indio_dev->info = &adi_axi_adc_info;
  337. indio_dev->name = "adi-axi-adc";
  338. indio_dev->modes = INDIO_DIRECT_MODE;
  339. indio_dev->num_channels = conv->chip_info->num_channels;
  340. indio_dev->channels = conv->chip_info->channels;
  341. ret = adi_axi_adc_config_dma_buffer(&pdev->dev, indio_dev);
  342. if (ret)
  343. return ret;
  344. ret = adi_axi_adc_setup_channels(&pdev->dev, st);
  345. if (ret)
  346. return ret;
  347. ret = devm_iio_device_register(&pdev->dev, indio_dev);
  348. if (ret)
  349. return ret;
  350. dev_info(&pdev->dev, "AXI ADC IP core (%d.%.2d.%c) probed\n",
  351. ADI_AXI_PCORE_VER_MAJOR(ver),
  352. ADI_AXI_PCORE_VER_MINOR(ver),
  353. ADI_AXI_PCORE_VER_PATCH(ver));
  354. return 0;
  355. }
  356. /* Match table for of_platform binding */
  357. static const struct of_device_id adi_axi_adc_of_match[] = {
  358. { .compatible = "adi,axi-adc-10.0.a", .data = &adi_axi_adc_10_0_a_info },
  359. { /* end of list */ }
  360. };
  361. MODULE_DEVICE_TABLE(of, adi_axi_adc_of_match);
  362. static struct platform_driver adi_axi_adc_driver = {
  363. .driver = {
  364. .name = KBUILD_MODNAME,
  365. .of_match_table = adi_axi_adc_of_match,
  366. },
  367. .probe = adi_axi_adc_probe,
  368. };
  369. module_platform_driver(adi_axi_adc_driver);
  370. MODULE_AUTHOR("Michael Hennerich <[email protected]>");
  371. MODULE_DESCRIPTION("Analog Devices Generic AXI ADC IP core driver");
  372. MODULE_LICENSE("GPL v2");