]> git.proxmox.com Git - mirror_ubuntu-zesty-kernel.git/blob - drivers/media/dvb/frontends/stb6100.c
Fix common misspellings
[mirror_ubuntu-zesty-kernel.git] / drivers / media / dvb / frontends / stb6100.c
1 /*
2 STB6100 Silicon Tuner
3 Copyright (C) Manu Abraham (abraham.manu@gmail.com)
4
5 Copyright (C) ST Microelectronics
6
7 This program is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 2 of the License, or
10 (at your option) any later version.
11
12 This program is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
16
17 You should have received a copy of the GNU General Public License
18 along with this program; if not, write to the Free Software
19 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
20 */
21
22 #include <linux/init.h>
23 #include <linux/kernel.h>
24 #include <linux/module.h>
25 #include <linux/slab.h>
26 #include <linux/string.h>
27
28 #include "dvb_frontend.h"
29 #include "stb6100.h"
30
31 static unsigned int verbose;
32 module_param(verbose, int, 0644);
33
34
35 #define FE_ERROR 0
36 #define FE_NOTICE 1
37 #define FE_INFO 2
38 #define FE_DEBUG 3
39
40 #define dprintk(x, y, z, format, arg...) do { \
41 if (z) { \
42 if ((x > FE_ERROR) && (x > y)) \
43 printk(KERN_ERR "%s: " format "\n", __func__ , ##arg); \
44 else if ((x > FE_NOTICE) && (x > y)) \
45 printk(KERN_NOTICE "%s: " format "\n", __func__ , ##arg); \
46 else if ((x > FE_INFO) && (x > y)) \
47 printk(KERN_INFO "%s: " format "\n", __func__ , ##arg); \
48 else if ((x > FE_DEBUG) && (x > y)) \
49 printk(KERN_DEBUG "%s: " format "\n", __func__ , ##arg); \
50 } else { \
51 if (x > y) \
52 printk(format, ##arg); \
53 } \
54 } while (0)
55
56 struct stb6100_lkup {
57 u32 val_low;
58 u32 val_high;
59 u8 reg;
60 };
61
62 static int stb6100_release(struct dvb_frontend *fe);
63
64 static const struct stb6100_lkup lkup[] = {
65 { 0, 950000, 0x0a },
66 { 950000, 1000000, 0x0a },
67 { 1000000, 1075000, 0x0c },
68 { 1075000, 1200000, 0x00 },
69 { 1200000, 1300000, 0x01 },
70 { 1300000, 1370000, 0x02 },
71 { 1370000, 1470000, 0x04 },
72 { 1470000, 1530000, 0x05 },
73 { 1530000, 1650000, 0x06 },
74 { 1650000, 1800000, 0x08 },
75 { 1800000, 1950000, 0x0a },
76 { 1950000, 2150000, 0x0c },
77 { 2150000, 9999999, 0x0c },
78 { 0, 0, 0x00 }
79 };
80
81 /* Register names for easy debugging. */
82 static const char *stb6100_regnames[] = {
83 [STB6100_LD] = "LD",
84 [STB6100_VCO] = "VCO",
85 [STB6100_NI] = "NI",
86 [STB6100_NF_LSB] = "NF",
87 [STB6100_K] = "K",
88 [STB6100_G] = "G",
89 [STB6100_F] = "F",
90 [STB6100_DLB] = "DLB",
91 [STB6100_TEST1] = "TEST1",
92 [STB6100_FCCK] = "FCCK",
93 [STB6100_LPEN] = "LPEN",
94 [STB6100_TEST3] = "TEST3",
95 };
96
97 /* Template for normalisation, i.e. setting unused or undocumented
98 * bits as required according to the documentation.
99 */
100 struct stb6100_regmask {
101 u8 mask;
102 u8 set;
103 };
104
105 static const struct stb6100_regmask stb6100_template[] = {
106 [STB6100_LD] = { 0xff, 0x00 },
107 [STB6100_VCO] = { 0xff, 0x00 },
108 [STB6100_NI] = { 0xff, 0x00 },
109 [STB6100_NF_LSB] = { 0xff, 0x00 },
110 [STB6100_K] = { 0xc7, 0x38 },
111 [STB6100_G] = { 0xef, 0x10 },
112 [STB6100_F] = { 0x1f, 0xc0 },
113 [STB6100_DLB] = { 0x38, 0xc4 },
114 [STB6100_TEST1] = { 0x00, 0x8f },
115 [STB6100_FCCK] = { 0x40, 0x0d },
116 [STB6100_LPEN] = { 0xf0, 0x0b },
117 [STB6100_TEST3] = { 0x00, 0xde },
118 };
119
120 /*
121 * Currently unused. Some boards might need it in the future
122 */
123 static inline void stb6100_normalise_regs(u8 regs[])
124 {
125 int i;
126
127 for (i = 0; i < STB6100_NUMREGS; i++)
128 regs[i] = (regs[i] & stb6100_template[i].mask) | stb6100_template[i].set;
129 }
130
131 static int stb6100_read_regs(struct stb6100_state *state, u8 regs[])
132 {
133 int rc;
134 struct i2c_msg msg = {
135 .addr = state->config->tuner_address,
136 .flags = I2C_M_RD,
137 .buf = regs,
138 .len = STB6100_NUMREGS
139 };
140
141 rc = i2c_transfer(state->i2c, &msg, 1);
142 if (unlikely(rc != 1)) {
143 dprintk(verbose, FE_ERROR, 1, "Read (0x%x) err, rc=[%d]",
144 state->config->tuner_address, rc);
145
146 return -EREMOTEIO;
147 }
148 if (unlikely(verbose > FE_DEBUG)) {
149 int i;
150
151 dprintk(verbose, FE_DEBUG, 1, " Read from 0x%02x", state->config->tuner_address);
152 for (i = 0; i < STB6100_NUMREGS; i++)
153 dprintk(verbose, FE_DEBUG, 1, " %s: 0x%02x", stb6100_regnames[i], regs[i]);
154 }
155 return 0;
156 }
157
158 static int stb6100_read_reg(struct stb6100_state *state, u8 reg)
159 {
160 u8 regs[STB6100_NUMREGS];
161 int rc;
162
163 struct i2c_msg msg = {
164 .addr = state->config->tuner_address + reg,
165 .flags = I2C_M_RD,
166 .buf = regs,
167 .len = 1
168 };
169
170 rc = i2c_transfer(state->i2c, &msg, 1);
171
172 if (unlikely(reg >= STB6100_NUMREGS)) {
173 dprintk(verbose, FE_ERROR, 1, "Invalid register offset 0x%x", reg);
174 return -EINVAL;
175 }
176 if (unlikely(verbose > FE_DEBUG)) {
177 dprintk(verbose, FE_DEBUG, 1, " Read from 0x%02x", state->config->tuner_address);
178 dprintk(verbose, FE_DEBUG, 1, " %s: 0x%02x", stb6100_regnames[reg], regs[0]);
179 }
180
181 return (unsigned int)regs[0];
182 }
183
184 static int stb6100_write_reg_range(struct stb6100_state *state, u8 buf[], int start, int len)
185 {
186 int rc;
187 u8 cmdbuf[len + 1];
188 struct i2c_msg msg = {
189 .addr = state->config->tuner_address,
190 .flags = 0,
191 .buf = cmdbuf,
192 .len = len + 1
193 };
194
195 if (unlikely(start < 1 || start + len > STB6100_NUMREGS)) {
196 dprintk(verbose, FE_ERROR, 1, "Invalid register range %d:%d",
197 start, len);
198 return -EINVAL;
199 }
200 memcpy(&cmdbuf[1], buf, len);
201 cmdbuf[0] = start;
202
203 if (unlikely(verbose > FE_DEBUG)) {
204 int i;
205
206 dprintk(verbose, FE_DEBUG, 1, " Write @ 0x%02x: [%d:%d]", state->config->tuner_address, start, len);
207 for (i = 0; i < len; i++)
208 dprintk(verbose, FE_DEBUG, 1, " %s: 0x%02x", stb6100_regnames[start + i], buf[i]);
209 }
210 rc = i2c_transfer(state->i2c, &msg, 1);
211 if (unlikely(rc != 1)) {
212 dprintk(verbose, FE_ERROR, 1, "(0x%x) write err [%d:%d], rc=[%d]",
213 (unsigned int)state->config->tuner_address, start, len, rc);
214 return -EREMOTEIO;
215 }
216 return 0;
217 }
218
219 static int stb6100_write_reg(struct stb6100_state *state, u8 reg, u8 data)
220 {
221 if (unlikely(reg >= STB6100_NUMREGS)) {
222 dprintk(verbose, FE_ERROR, 1, "Invalid register offset 0x%x", reg);
223 return -EREMOTEIO;
224 }
225 data = (data & stb6100_template[reg].mask) | stb6100_template[reg].set;
226 return stb6100_write_reg_range(state, &data, reg, 1);
227 }
228
229
230 static int stb6100_get_status(struct dvb_frontend *fe, u32 *status)
231 {
232 int rc;
233 struct stb6100_state *state = fe->tuner_priv;
234
235 rc = stb6100_read_reg(state, STB6100_LD);
236 if (rc < 0) {
237 dprintk(verbose, FE_ERROR, 1, "%s failed", __func__);
238 return rc;
239 }
240 return (rc & STB6100_LD_LOCK) ? TUNER_STATUS_LOCKED : 0;
241 }
242
243 static int stb6100_get_bandwidth(struct dvb_frontend *fe, u32 *bandwidth)
244 {
245 int rc;
246 u8 f;
247 struct stb6100_state *state = fe->tuner_priv;
248
249 rc = stb6100_read_reg(state, STB6100_F);
250 if (rc < 0)
251 return rc;
252 f = rc & STB6100_F_F;
253
254 state->status.bandwidth = (f + 5) * 2000; /* x2 for ZIF */
255
256 *bandwidth = state->bandwidth = state->status.bandwidth * 1000;
257 dprintk(verbose, FE_DEBUG, 1, "bandwidth = %u Hz", state->bandwidth);
258 return 0;
259 }
260
261 static int stb6100_set_bandwidth(struct dvb_frontend *fe, u32 bandwidth)
262 {
263 u32 tmp;
264 int rc;
265 struct stb6100_state *state = fe->tuner_priv;
266
267 dprintk(verbose, FE_DEBUG, 1, "set bandwidth to %u Hz", bandwidth);
268
269 bandwidth /= 2; /* ZIF */
270
271 if (bandwidth >= 36000000) /* F[4:0] BW/2 max =31+5=36 mhz for F=31 */
272 tmp = 31;
273 else if (bandwidth <= 5000000) /* bw/2 min = 5Mhz for F=0 */
274 tmp = 0;
275 else /* if 5 < bw/2 < 36 */
276 tmp = (bandwidth + 500000) / 1000000 - 5;
277
278 /* Turn on LPF bandwidth setting clock control,
279 * set bandwidth, wait 10ms, turn off.
280 */
281 rc = stb6100_write_reg(state, STB6100_FCCK, 0x0d | STB6100_FCCK_FCCK);
282 if (rc < 0)
283 return rc;
284 rc = stb6100_write_reg(state, STB6100_F, 0xc0 | tmp);
285 if (rc < 0)
286 return rc;
287
288 msleep(5); /* This is dangerous as another (related) thread may start */
289
290 rc = stb6100_write_reg(state, STB6100_FCCK, 0x0d);
291 if (rc < 0)
292 return rc;
293
294 msleep(10); /* This is dangerous as another (related) thread may start */
295
296 return 0;
297 }
298
299 static int stb6100_get_frequency(struct dvb_frontend *fe, u32 *frequency)
300 {
301 int rc;
302 u32 nint, nfrac, fvco;
303 int psd2, odiv;
304 struct stb6100_state *state = fe->tuner_priv;
305 u8 regs[STB6100_NUMREGS];
306
307 rc = stb6100_read_regs(state, regs);
308 if (rc < 0)
309 return rc;
310
311 odiv = (regs[STB6100_VCO] & STB6100_VCO_ODIV) >> STB6100_VCO_ODIV_SHIFT;
312 psd2 = (regs[STB6100_K] & STB6100_K_PSD2) >> STB6100_K_PSD2_SHIFT;
313 nint = regs[STB6100_NI];
314 nfrac = ((regs[STB6100_K] & STB6100_K_NF_MSB) << 8) | regs[STB6100_NF_LSB];
315 fvco = (nfrac * state->reference >> (9 - psd2)) + (nint * state->reference << psd2);
316 *frequency = state->frequency = fvco >> (odiv + 1);
317
318 dprintk(verbose, FE_DEBUG, 1,
319 "frequency = %u kHz, odiv = %u, psd2 = %u, fxtal = %u kHz, fvco = %u kHz, N(I) = %u, N(F) = %u",
320 state->frequency, odiv, psd2, state->reference, fvco, nint, nfrac);
321 return 0;
322 }
323
324
325 static int stb6100_set_frequency(struct dvb_frontend *fe, u32 frequency)
326 {
327 int rc;
328 const struct stb6100_lkup *ptr;
329 struct stb6100_state *state = fe->tuner_priv;
330 struct dvb_frontend_parameters p;
331
332 u32 srate = 0, fvco, nint, nfrac;
333 u8 regs[STB6100_NUMREGS];
334 u8 g, psd2, odiv;
335
336 dprintk(verbose, FE_DEBUG, 1, "Version 2010-8-14 13:51");
337
338 if (fe->ops.get_frontend) {
339 dprintk(verbose, FE_DEBUG, 1, "Get frontend parameters");
340 fe->ops.get_frontend(fe, &p);
341 }
342 srate = p.u.qpsk.symbol_rate;
343
344 /* Set up tuner cleanly, LPF calibration on */
345 rc = stb6100_write_reg(state, STB6100_FCCK, 0x4d | STB6100_FCCK_FCCK);
346 if (rc < 0)
347 return rc; /* allow LPF calibration */
348
349 /* PLL Loop disabled, bias on, VCO on, synth on */
350 regs[STB6100_LPEN] = 0xeb;
351 rc = stb6100_write_reg(state, STB6100_LPEN, regs[STB6100_LPEN]);
352 if (rc < 0)
353 return rc;
354
355 /* Program the registers with their data values */
356
357 /* VCO divide ratio (LO divide ratio, VCO prescaler enable). */
358 if (frequency <= 1075000)
359 odiv = 1;
360 else
361 odiv = 0;
362
363 /* VCO enabled, search clock off as per LL3.7, 3.4.1 */
364 regs[STB6100_VCO] = 0xe0 | (odiv << STB6100_VCO_ODIV_SHIFT);
365
366 /* OSM */
367 for (ptr = lkup;
368 (ptr->val_high != 0) && !CHKRANGE(frequency, ptr->val_low, ptr->val_high);
369 ptr++);
370
371 if (ptr->val_high == 0) {
372 printk(KERN_ERR "%s: frequency out of range: %u kHz\n", __func__, frequency);
373 return -EINVAL;
374 }
375 regs[STB6100_VCO] = (regs[STB6100_VCO] & ~STB6100_VCO_OSM) | ptr->reg;
376 rc = stb6100_write_reg(state, STB6100_VCO, regs[STB6100_VCO]);
377 if (rc < 0)
378 return rc;
379
380 if ((frequency > 1075000) && (frequency <= 1325000))
381 psd2 = 0;
382 else
383 psd2 = 1;
384 /* F(VCO) = F(LO) * (ODIV == 0 ? 2 : 4) */
385 fvco = frequency << (1 + odiv);
386 /* N(I) = floor(f(VCO) / (f(XTAL) * (PSD2 ? 2 : 1))) */
387 nint = fvco / (state->reference << psd2);
388 /* N(F) = round(f(VCO) / f(XTAL) * (PSD2 ? 2 : 1) - N(I)) * 2 ^ 9 */
389 nfrac = DIV_ROUND_CLOSEST((fvco - (nint * state->reference << psd2))
390 << (9 - psd2), state->reference);
391
392 /* NI */
393 regs[STB6100_NI] = nint;
394 rc = stb6100_write_reg(state, STB6100_NI, regs[STB6100_NI]);
395 if (rc < 0)
396 return rc;
397
398 /* NF */
399 regs[STB6100_NF_LSB] = nfrac;
400 rc = stb6100_write_reg(state, STB6100_NF_LSB, regs[STB6100_NF_LSB]);
401 if (rc < 0)
402 return rc;
403
404 /* K */
405 regs[STB6100_K] = (0x38 & ~STB6100_K_PSD2) | (psd2 << STB6100_K_PSD2_SHIFT);
406 regs[STB6100_K] = (regs[STB6100_K] & ~STB6100_K_NF_MSB) | ((nfrac >> 8) & STB6100_K_NF_MSB);
407 rc = stb6100_write_reg(state, STB6100_K, regs[STB6100_K]);
408 if (rc < 0)
409 return rc;
410
411 /* G Baseband gain. */
412 if (srate >= 15000000)
413 g = 9; /* +4 dB */
414 else if (srate >= 5000000)
415 g = 11; /* +8 dB */
416 else
417 g = 14; /* +14 dB */
418
419 regs[STB6100_G] = (0x10 & ~STB6100_G_G) | g;
420 regs[STB6100_G] &= ~STB6100_G_GCT; /* mask GCT */
421 regs[STB6100_G] |= (1 << 5); /* 2Vp-p Mode */
422 rc = stb6100_write_reg(state, STB6100_G, regs[STB6100_G]);
423 if (rc < 0)
424 return rc;
425
426 /* F we don't write as it is set up in BW set */
427
428 /* DLB set DC servo loop BW to 160Hz (LLA 3.8 / 2.1) */
429 regs[STB6100_DLB] = 0xcc;
430 rc = stb6100_write_reg(state, STB6100_DLB, regs[STB6100_DLB]);
431 if (rc < 0)
432 return rc;
433
434 dprintk(verbose, FE_DEBUG, 1,
435 "frequency = %u, srate = %u, g = %u, odiv = %u, psd2 = %u, fxtal = %u, osm = %u, fvco = %u, N(I) = %u, N(F) = %u",
436 frequency, srate, (unsigned int)g, (unsigned int)odiv,
437 (unsigned int)psd2, state->reference,
438 ptr->reg, fvco, nint, nfrac);
439
440 /* Set up the test registers */
441 regs[STB6100_TEST1] = 0x8f;
442 rc = stb6100_write_reg(state, STB6100_TEST1, regs[STB6100_TEST1]);
443 if (rc < 0)
444 return rc;
445 regs[STB6100_TEST3] = 0xde;
446 rc = stb6100_write_reg(state, STB6100_TEST3, regs[STB6100_TEST3]);
447 if (rc < 0)
448 return rc;
449
450 /* Bring up tuner according to LLA 3.7 3.4.1, step 2 */
451 regs[STB6100_LPEN] = 0xfb; /* PLL Loop enabled, bias on, VCO on, synth on */
452 rc = stb6100_write_reg(state, STB6100_LPEN, regs[STB6100_LPEN]);
453 if (rc < 0)
454 return rc;
455
456 msleep(2);
457
458 /* Bring up tuner according to LLA 3.7 3.4.1, step 3 */
459 regs[STB6100_VCO] &= ~STB6100_VCO_OCK; /* VCO fast search */
460 rc = stb6100_write_reg(state, STB6100_VCO, regs[STB6100_VCO]);
461 if (rc < 0)
462 return rc;
463
464 msleep(10); /* This is dangerous as another (related) thread may start */ /* wait for LO to lock */
465
466 regs[STB6100_VCO] &= ~STB6100_VCO_OSCH; /* vco search disabled */
467 regs[STB6100_VCO] |= STB6100_VCO_OCK; /* search clock off */
468 rc = stb6100_write_reg(state, STB6100_VCO, regs[STB6100_VCO]);
469 if (rc < 0)
470 return rc;
471
472 rc = stb6100_write_reg(state, STB6100_FCCK, 0x0d);
473 if (rc < 0)
474 return rc; /* Stop LPF calibration */
475
476 msleep(10); /* This is dangerous as another (related) thread may start */
477 /* wait for stabilisation, (should not be necessary) */
478 return 0;
479 }
480
481 static int stb6100_sleep(struct dvb_frontend *fe)
482 {
483 /* TODO: power down */
484 return 0;
485 }
486
487 static int stb6100_init(struct dvb_frontend *fe)
488 {
489 struct stb6100_state *state = fe->tuner_priv;
490 struct tuner_state *status = &state->status;
491
492 status->tunerstep = 125000;
493 status->ifreq = 0;
494 status->refclock = 27000000; /* Hz */
495 status->iqsense = 1;
496 status->bandwidth = 36000; /* kHz */
497 state->bandwidth = status->bandwidth * 1000; /* Hz */
498 state->reference = status->refclock / 1000; /* kHz */
499
500 /* Set default bandwidth. Modified, PN 13-May-10 */
501 return 0;
502 }
503
504 static int stb6100_get_state(struct dvb_frontend *fe,
505 enum tuner_param param,
506 struct tuner_state *state)
507 {
508 switch (param) {
509 case DVBFE_TUNER_FREQUENCY:
510 stb6100_get_frequency(fe, &state->frequency);
511 break;
512 case DVBFE_TUNER_TUNERSTEP:
513 break;
514 case DVBFE_TUNER_IFFREQ:
515 break;
516 case DVBFE_TUNER_BANDWIDTH:
517 stb6100_get_bandwidth(fe, &state->bandwidth);
518 break;
519 case DVBFE_TUNER_REFCLOCK:
520 break;
521 default:
522 break;
523 }
524
525 return 0;
526 }
527
528 static int stb6100_set_state(struct dvb_frontend *fe,
529 enum tuner_param param,
530 struct tuner_state *state)
531 {
532 struct stb6100_state *tstate = fe->tuner_priv;
533
534 switch (param) {
535 case DVBFE_TUNER_FREQUENCY:
536 stb6100_set_frequency(fe, state->frequency);
537 tstate->frequency = state->frequency;
538 break;
539 case DVBFE_TUNER_TUNERSTEP:
540 break;
541 case DVBFE_TUNER_IFFREQ:
542 break;
543 case DVBFE_TUNER_BANDWIDTH:
544 stb6100_set_bandwidth(fe, state->bandwidth);
545 tstate->bandwidth = state->bandwidth;
546 break;
547 case DVBFE_TUNER_REFCLOCK:
548 break;
549 default:
550 break;
551 }
552
553 return 0;
554 }
555
556 static struct dvb_tuner_ops stb6100_ops = {
557 .info = {
558 .name = "STB6100 Silicon Tuner",
559 .frequency_min = 950000,
560 .frequency_max = 2150000,
561 .frequency_step = 0,
562 },
563
564 .init = stb6100_init,
565 .sleep = stb6100_sleep,
566 .get_status = stb6100_get_status,
567 .get_state = stb6100_get_state,
568 .set_state = stb6100_set_state,
569 .release = stb6100_release
570 };
571
572 struct dvb_frontend *stb6100_attach(struct dvb_frontend *fe,
573 const struct stb6100_config *config,
574 struct i2c_adapter *i2c)
575 {
576 struct stb6100_state *state = NULL;
577
578 state = kzalloc(sizeof (struct stb6100_state), GFP_KERNEL);
579 if (state == NULL)
580 goto error;
581
582 state->config = config;
583 state->i2c = i2c;
584 state->frontend = fe;
585 state->reference = config->refclock / 1000; /* kHz */
586 fe->tuner_priv = state;
587 fe->ops.tuner_ops = stb6100_ops;
588
589 printk("%s: Attaching STB6100 \n", __func__);
590 return fe;
591
592 error:
593 kfree(state);
594 return NULL;
595 }
596
597 static int stb6100_release(struct dvb_frontend *fe)
598 {
599 struct stb6100_state *state = fe->tuner_priv;
600
601 fe->tuner_priv = NULL;
602 kfree(state);
603
604 return 0;
605 }
606
607 EXPORT_SYMBOL(stb6100_attach);
608 MODULE_PARM_DESC(verbose, "Set Verbosity level");
609
610 MODULE_AUTHOR("Manu Abraham");
611 MODULE_DESCRIPTION("STB6100 Silicon tuner");
612 MODULE_LICENSE("GPL");