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