admv4420.c 10.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398
  1. // SPDX-License-Identifier: GPL-2.0 OR BSD-2-Clause
  2. /*
  3. * ADMV4420
  4. *
  5. * Copyright 2021 Analog Devices Inc.
  6. */
  7. #include <linux/bitfield.h>
  8. #include <linux/iio/iio.h>
  9. #include <linux/iio/sysfs.h>
  10. #include <linux/module.h>
  11. #include <linux/regmap.h>
  12. #include <linux/spi/spi.h>
  13. #include <linux/units.h>
  14. #include <asm/unaligned.h>
  15. /* ADMV4420 Register Map */
  16. #define ADMV4420_SPI_CONFIG_1 0x00
  17. #define ADMV4420_SPI_CONFIG_2 0x01
  18. #define ADMV4420_CHIPTYPE 0x03
  19. #define ADMV4420_PRODUCT_ID_L 0x04
  20. #define ADMV4420_PRODUCT_ID_H 0x05
  21. #define ADMV4420_SCRATCHPAD 0x0A
  22. #define ADMV4420_SPI_REV 0x0B
  23. #define ADMV4420_ENABLES 0x103
  24. #define ADMV4420_SDO_LEVEL 0x108
  25. #define ADMV4420_INT_L 0x200
  26. #define ADMV4420_INT_H 0x201
  27. #define ADMV4420_FRAC_L 0x202
  28. #define ADMV4420_FRAC_M 0x203
  29. #define ADMV4420_FRAC_H 0x204
  30. #define ADMV4420_MOD_L 0x208
  31. #define ADMV4420_MOD_M 0x209
  32. #define ADMV4420_MOD_H 0x20A
  33. #define ADMV4420_R_DIV_L 0x20C
  34. #define ADMV4420_R_DIV_H 0x20D
  35. #define ADMV4420_REFERENCE 0x20E
  36. #define ADMV4420_VCO_DATA_READBACK1 0x211
  37. #define ADMV4420_VCO_DATA_READBACK2 0x212
  38. #define ADMV4420_PLL_MUX_SEL 0x213
  39. #define ADMV4420_LOCK_DETECT 0x214
  40. #define ADMV4420_BAND_SELECT 0x215
  41. #define ADMV4420_VCO_ALC_TIMEOUT 0x216
  42. #define ADMV4420_VCO_MANUAL 0x217
  43. #define ADMV4420_ALC 0x219
  44. #define ADMV4420_VCO_TIMEOUT1 0x21C
  45. #define ADMV4420_VCO_TIMEOUT2 0x21D
  46. #define ADMV4420_VCO_BAND_DIV 0x21E
  47. #define ADMV4420_VCO_READBACK_SEL 0x21F
  48. #define ADMV4420_AUTOCAL 0x226
  49. #define ADMV4420_CP_STATE 0x22C
  50. #define ADMV4420_CP_BLEED_EN 0x22D
  51. #define ADMV4420_CP_CURRENT 0x22E
  52. #define ADMV4420_CP_BLEED 0x22F
  53. #define ADMV4420_SPI_CONFIG_1_SDOACTIVE (BIT(4) | BIT(3))
  54. #define ADMV4420_SPI_CONFIG_1_ENDIAN (BIT(5) | BIT(2))
  55. #define ADMV4420_SPI_CONFIG_1_SOFTRESET (BIT(7) | BIT(1))
  56. #define ADMV4420_REFERENCE_DIVIDE_BY_2_MASK BIT(0)
  57. #define ADMV4420_REFERENCE_MODE_MASK BIT(1)
  58. #define ADMV4420_REFERENCE_DOUBLER_MASK BIT(2)
  59. #define ADMV4420_REF_DIVIDER_MAX_VAL GENMASK(9, 0)
  60. #define ADMV4420_N_COUNTER_INT_MAX GENMASK(15, 0)
  61. #define ADMV4420_N_COUNTER_FRAC_MAX GENMASK(23, 0)
  62. #define ADMV4420_N_COUNTER_MOD_MAX GENMASK(23, 0)
  63. #define ENABLE_PLL BIT(6)
  64. #define ENABLE_LO BIT(5)
  65. #define ENABLE_VCO BIT(3)
  66. #define ENABLE_IFAMP BIT(2)
  67. #define ENABLE_MIXER BIT(1)
  68. #define ENABLE_LNA BIT(0)
  69. #define ADMV4420_SCRATCH_PAD_VAL_1 0xAD
  70. #define ADMV4420_SCRATCH_PAD_VAL_2 0xEA
  71. #define ADMV4420_REF_FREQ_HZ 50000000
  72. #define MAX_N_COUNTER 655360UL
  73. #define MAX_R_DIVIDER 1024
  74. #define ADMV4420_DEFAULT_LO_FREQ_HZ 16750000000ULL
  75. enum admv4420_mux_sel {
  76. ADMV4420_LOW = 0,
  77. ADMV4420_LOCK_DTCT = 1,
  78. ADMV4420_R_COUNTER_PER_2 = 4,
  79. ADMV4420_N_CONUTER_PER_2 = 5,
  80. ADMV4420_HIGH = 8,
  81. };
  82. struct admv4420_reference_block {
  83. bool doubler_en;
  84. bool divide_by_2_en;
  85. bool ref_single_ended;
  86. u32 divider;
  87. };
  88. struct admv4420_n_counter {
  89. u32 int_val;
  90. u32 frac_val;
  91. u32 mod_val;
  92. u32 n_counter;
  93. };
  94. struct admv4420_state {
  95. struct spi_device *spi;
  96. struct regmap *regmap;
  97. u64 vco_freq_hz;
  98. u64 lo_freq_hz;
  99. struct admv4420_reference_block ref_block;
  100. struct admv4420_n_counter n_counter;
  101. enum admv4420_mux_sel mux_sel;
  102. struct mutex lock;
  103. u8 transf_buf[4] __aligned(IIO_DMA_MINALIGN);
  104. };
  105. static const struct regmap_config admv4420_regmap_config = {
  106. .reg_bits = 16,
  107. .val_bits = 8,
  108. .read_flag_mask = BIT(7),
  109. };
  110. static int admv4420_reg_access(struct iio_dev *indio_dev,
  111. u32 reg, u32 writeval,
  112. u32 *readval)
  113. {
  114. struct admv4420_state *st = iio_priv(indio_dev);
  115. if (readval)
  116. return regmap_read(st->regmap, reg, readval);
  117. else
  118. return regmap_write(st->regmap, reg, writeval);
  119. }
  120. static int admv4420_set_n_counter(struct admv4420_state *st, u32 int_val,
  121. u32 frac_val, u32 mod_val)
  122. {
  123. int ret;
  124. put_unaligned_le32(frac_val, st->transf_buf);
  125. ret = regmap_bulk_write(st->regmap, ADMV4420_FRAC_L, st->transf_buf, 3);
  126. if (ret)
  127. return ret;
  128. put_unaligned_le32(mod_val, st->transf_buf);
  129. ret = regmap_bulk_write(st->regmap, ADMV4420_MOD_L, st->transf_buf, 3);
  130. if (ret)
  131. return ret;
  132. put_unaligned_le32(int_val, st->transf_buf);
  133. return regmap_bulk_write(st->regmap, ADMV4420_INT_L, st->transf_buf, 2);
  134. }
  135. static int admv4420_read_raw(struct iio_dev *indio_dev,
  136. struct iio_chan_spec const *chan,
  137. int *val, int *val2, long info)
  138. {
  139. struct admv4420_state *st = iio_priv(indio_dev);
  140. switch (info) {
  141. case IIO_CHAN_INFO_FREQUENCY:
  142. *val = div_u64_rem(st->lo_freq_hz, MICRO, val2);
  143. return IIO_VAL_INT_PLUS_MICRO;
  144. default:
  145. return -EINVAL;
  146. }
  147. }
  148. static const struct iio_info admv4420_info = {
  149. .read_raw = admv4420_read_raw,
  150. .debugfs_reg_access = &admv4420_reg_access,
  151. };
  152. static const struct iio_chan_spec admv4420_channels[] = {
  153. {
  154. .type = IIO_ALTVOLTAGE,
  155. .output = 0,
  156. .indexed = 1,
  157. .channel = 0,
  158. .info_mask_separate = BIT(IIO_CHAN_INFO_FREQUENCY),
  159. },
  160. };
  161. static void admv4420_fw_parse(struct admv4420_state *st)
  162. {
  163. struct device *dev = &st->spi->dev;
  164. u32 tmp;
  165. int ret;
  166. ret = device_property_read_u32(dev, "adi,lo-freq-khz", &tmp);
  167. if (!ret)
  168. st->lo_freq_hz = (u64)tmp * KILO;
  169. st->ref_block.ref_single_ended = device_property_read_bool(dev,
  170. "adi,ref-ext-single-ended-en");
  171. }
  172. static inline uint64_t admv4420_calc_pfd_vco(struct admv4420_state *st)
  173. {
  174. return div_u64(st->vco_freq_hz * 10, st->n_counter.n_counter);
  175. }
  176. static inline uint32_t admv4420_calc_pfd_ref(struct admv4420_state *st)
  177. {
  178. uint32_t tmp;
  179. u8 doubler, divide_by_2;
  180. doubler = st->ref_block.doubler_en ? 2 : 1;
  181. divide_by_2 = st->ref_block.divide_by_2_en ? 2 : 1;
  182. tmp = ADMV4420_REF_FREQ_HZ * doubler;
  183. return (tmp / (st->ref_block.divider * divide_by_2));
  184. }
  185. static int admv4420_calc_parameters(struct admv4420_state *st)
  186. {
  187. u64 pfd_ref, pfd_vco;
  188. bool sol_found = false;
  189. st->ref_block.doubler_en = false;
  190. st->ref_block.divide_by_2_en = false;
  191. st->vco_freq_hz = div_u64(st->lo_freq_hz, 2);
  192. for (st->ref_block.divider = 1; st->ref_block.divider < MAX_R_DIVIDER;
  193. st->ref_block.divider++) {
  194. pfd_ref = admv4420_calc_pfd_ref(st);
  195. for (st->n_counter.n_counter = 1; st->n_counter.n_counter < MAX_N_COUNTER;
  196. st->n_counter.n_counter++) {
  197. pfd_vco = admv4420_calc_pfd_vco(st);
  198. if (pfd_ref == pfd_vco) {
  199. sol_found = true;
  200. break;
  201. }
  202. }
  203. if (sol_found)
  204. break;
  205. st->n_counter.n_counter = 1;
  206. }
  207. if (!sol_found)
  208. return -1;
  209. st->n_counter.int_val = div_u64_rem(st->n_counter.n_counter, 10, &st->n_counter.frac_val);
  210. st->n_counter.mod_val = 10;
  211. return 0;
  212. }
  213. static int admv4420_setup(struct iio_dev *indio_dev)
  214. {
  215. struct admv4420_state *st = iio_priv(indio_dev);
  216. struct device *dev = indio_dev->dev.parent;
  217. u32 val;
  218. int ret;
  219. ret = regmap_write(st->regmap, ADMV4420_SPI_CONFIG_1,
  220. ADMV4420_SPI_CONFIG_1_SOFTRESET);
  221. if (ret)
  222. return ret;
  223. ret = regmap_write(st->regmap, ADMV4420_SPI_CONFIG_1,
  224. ADMV4420_SPI_CONFIG_1_SDOACTIVE |
  225. ADMV4420_SPI_CONFIG_1_ENDIAN);
  226. if (ret)
  227. return ret;
  228. ret = regmap_write(st->regmap,
  229. ADMV4420_SCRATCHPAD,
  230. ADMV4420_SCRATCH_PAD_VAL_1);
  231. if (ret)
  232. return ret;
  233. ret = regmap_read(st->regmap, ADMV4420_SCRATCHPAD, &val);
  234. if (ret)
  235. return ret;
  236. if (val != ADMV4420_SCRATCH_PAD_VAL_1) {
  237. dev_err(dev, "Failed ADMV4420 to read/write scratchpad %x ", val);
  238. return -EIO;
  239. }
  240. ret = regmap_write(st->regmap,
  241. ADMV4420_SCRATCHPAD,
  242. ADMV4420_SCRATCH_PAD_VAL_2);
  243. if (ret)
  244. return ret;
  245. ret = regmap_read(st->regmap, ADMV4420_SCRATCHPAD, &val);
  246. if (ret)
  247. return ret;
  248. if (val != ADMV4420_SCRATCH_PAD_VAL_2) {
  249. dev_err(dev, "Failed to read/write scratchpad %x ", val);
  250. return -EIO;
  251. }
  252. st->mux_sel = ADMV4420_LOCK_DTCT;
  253. st->lo_freq_hz = ADMV4420_DEFAULT_LO_FREQ_HZ;
  254. admv4420_fw_parse(st);
  255. ret = admv4420_calc_parameters(st);
  256. if (ret) {
  257. dev_err(dev, "Failed calc parameters for %lld ", st->vco_freq_hz);
  258. return ret;
  259. }
  260. ret = regmap_write(st->regmap, ADMV4420_R_DIV_L,
  261. FIELD_GET(0xFF, st->ref_block.divider));
  262. if (ret)
  263. return ret;
  264. ret = regmap_write(st->regmap, ADMV4420_R_DIV_H,
  265. FIELD_GET(0xFF00, st->ref_block.divider));
  266. if (ret)
  267. return ret;
  268. ret = regmap_write(st->regmap, ADMV4420_REFERENCE,
  269. st->ref_block.divide_by_2_en |
  270. FIELD_PREP(ADMV4420_REFERENCE_MODE_MASK, st->ref_block.ref_single_ended) |
  271. FIELD_PREP(ADMV4420_REFERENCE_DOUBLER_MASK, st->ref_block.doubler_en));
  272. if (ret)
  273. return ret;
  274. ret = admv4420_set_n_counter(st, st->n_counter.int_val,
  275. st->n_counter.frac_val,
  276. st->n_counter.mod_val);
  277. if (ret)
  278. return ret;
  279. ret = regmap_write(st->regmap, ADMV4420_PLL_MUX_SEL, st->mux_sel);
  280. if (ret)
  281. return ret;
  282. return regmap_write(st->regmap, ADMV4420_ENABLES,
  283. ENABLE_PLL | ENABLE_LO | ENABLE_VCO |
  284. ENABLE_IFAMP | ENABLE_MIXER | ENABLE_LNA);
  285. }
  286. static int admv4420_probe(struct spi_device *spi)
  287. {
  288. struct iio_dev *indio_dev;
  289. struct admv4420_state *st;
  290. struct regmap *regmap;
  291. int ret;
  292. indio_dev = devm_iio_device_alloc(&spi->dev, sizeof(*st));
  293. if (!indio_dev)
  294. return -ENOMEM;
  295. regmap = devm_regmap_init_spi(spi, &admv4420_regmap_config);
  296. if (IS_ERR(regmap))
  297. return dev_err_probe(&spi->dev, PTR_ERR(regmap),
  298. "Failed to initializing spi regmap\n");
  299. st = iio_priv(indio_dev);
  300. st->spi = spi;
  301. st->regmap = regmap;
  302. indio_dev->name = "admv4420";
  303. indio_dev->info = &admv4420_info;
  304. indio_dev->channels = admv4420_channels;
  305. indio_dev->num_channels = ARRAY_SIZE(admv4420_channels);
  306. ret = admv4420_setup(indio_dev);
  307. if (ret) {
  308. dev_err(&spi->dev, "Setup ADMV4420 failed (%d)\n", ret);
  309. return ret;
  310. }
  311. return devm_iio_device_register(&spi->dev, indio_dev);
  312. }
  313. static const struct of_device_id admv4420_of_match[] = {
  314. { .compatible = "adi,admv4420" },
  315. { }
  316. };
  317. MODULE_DEVICE_TABLE(of, admv4420_of_match);
  318. static struct spi_driver admv4420_driver = {
  319. .driver = {
  320. .name = "admv4420",
  321. .of_match_table = admv4420_of_match,
  322. },
  323. .probe = admv4420_probe,
  324. };
  325. module_spi_driver(admv4420_driver);
  326. MODULE_AUTHOR("Cristian Pop <[email protected]>");
  327. MODULE_DESCRIPTION("Analog Devices ADMV44200 K Band Downconverter");
  328. MODULE_LICENSE("Dual BSD/GPL");