1 /*
2     Driver for VES1893 and VES1993 QPSK Demodulators
3 
4     Copyright (C) 1999 Convergence Integrated Media GmbH <ralph@convergence.de>
5     Copyright (C) 2001 Ronny Strutz <3des@elitedvb.de>
6     Copyright (C) 2002 Dennis Noermann <dennis.noermann@noernet.de>
7     Copyright (C) 2002-2003 Andreas Oberritter <obi@linuxtv.org>
8 
9     This program is free software; you can redistribute it and/or modify
10     it under the terms of the GNU General Public License as published by
11     the Free Software Foundation; either version 2 of the License, or
12     (at your option) any later version.
13 
14     This program is distributed in the hope that it will be useful,
15     but WITHOUT ANY WARRANTY; without even the implied warranty of
16     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
17 
18     GNU General Public License for more details.
19 
20     You should have received a copy of the GNU General Public License
21     along with this program; if not, write to the Free Software
22     Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
23 
24 */
25 
26 #include <linux/kernel.h>
27 #include <linux/module.h>
28 #include <linux/init.h>
29 #include <linux/string.h>
30 #include <linux/slab.h>
31 #include <linux/delay.h>
32 
33 #include <media/dvb_frontend.h>
34 #include "ves1x93.h"
35 
36 
37 struct ves1x93_state {
38 	struct i2c_adapter* i2c;
39 	/* configuration settings */
40 	const struct ves1x93_config* config;
41 	struct dvb_frontend frontend;
42 
43 	/* previous uncorrected block counter */
44 	enum fe_spectral_inversion inversion;
45 	u8 *init_1x93_tab;
46 	u8 *init_1x93_wtab;
47 	u8 tab_size;
48 	u8 demod_type;
49 	u32 frequency;
50 };
51 
52 static int debug;
53 #define dprintk	if (debug) printk
54 
55 #define DEMOD_VES1893		0
56 #define DEMOD_VES1993		1
57 
58 static u8 init_1893_tab [] = {
59 	0x01, 0xa4, 0x35, 0x80, 0x2a, 0x0b, 0x55, 0xc4,
60 	0x09, 0x69, 0x00, 0x86, 0x4c, 0x28, 0x7f, 0x00,
61 	0x00, 0x81, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
62 	0x80, 0x00, 0x21, 0xb0, 0x14, 0x00, 0xdc, 0x00,
63 	0x81, 0x80, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
64 	0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
65 	0x00, 0x55, 0x00, 0x00, 0x7f, 0x00
66 };
67 
68 static u8 init_1993_tab [] = {
69 	0x00, 0x9c, 0x35, 0x80, 0x6a, 0x09, 0x72, 0x8c,
70 	0x09, 0x6b, 0x00, 0x00, 0x4c, 0x08, 0x00, 0x00,
71 	0x00, 0x81, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
72 	0x80, 0x40, 0x21, 0xb0, 0x00, 0x00, 0x00, 0x10,
73 	0x81, 0x80, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
74 	0x00, 0x00, 0x80, 0x80, 0x00, 0x00, 0x00, 0x00,
75 	0x00, 0x55, 0x03, 0x00, 0x00, 0x00, 0x00, 0x03,
76 	0x00, 0x00, 0x0e, 0x80, 0x00
77 };
78 
79 static u8 init_1893_wtab[] =
80 {
81 	1,1,1,1,1,1,1,1, 1,1,0,0,1,1,0,0,
82 	0,1,0,0,0,0,0,0, 1,0,1,1,0,0,0,1,
83 	1,1,1,0,0,0,0,0, 0,0,1,1,0,0,0,0,
84 	1,1,1,0,1,1
85 };
86 
87 static u8 init_1993_wtab[] =
88 {
89 	1,1,1,1,1,1,1,1, 1,1,0,0,1,1,0,0,
90 	0,1,0,0,0,0,0,0, 1,1,1,1,0,0,0,1,
91 	1,1,1,0,0,0,0,0, 0,0,1,1,0,0,0,0,
92 	1,1,1,0,1,1,1,1, 1,1,1,1,1
93 };
94 
95 static int ves1x93_writereg (struct ves1x93_state* state, u8 reg, u8 data)
96 {
97 	u8 buf [] = { 0x00, reg, data };
98 	struct i2c_msg msg = { .addr = state->config->demod_address, .flags = 0, .buf = buf, .len = 3 };
99 	int err;
100 
101 	if ((err = i2c_transfer (state->i2c, &msg, 1)) != 1) {
102 		dprintk ("%s: writereg error (err == %i, reg == 0x%02x, data == 0x%02x)\n", __func__, err, reg, data);
103 		return -EREMOTEIO;
104 	}
105 
106 	return 0;
107 }
108 
109 static u8 ves1x93_readreg (struct ves1x93_state* state, u8 reg)
110 {
111 	int ret;
112 	u8 b0 [] = { 0x00, reg };
113 	u8 b1 [] = { 0 };
114 	struct i2c_msg msg [] = { { .addr = state->config->demod_address, .flags = 0, .buf = b0, .len = 2 },
115 			   { .addr = state->config->demod_address, .flags = I2C_M_RD, .buf = b1, .len = 1 } };
116 
117 	ret = i2c_transfer (state->i2c, msg, 2);
118 
119 	if (ret != 2) return ret;
120 
121 	return b1[0];
122 }
123 
124 static int ves1x93_clr_bit (struct ves1x93_state* state)
125 {
126 	msleep(10);
127 	ves1x93_writereg (state, 0, state->init_1x93_tab[0] & 0xfe);
128 	ves1x93_writereg (state, 0, state->init_1x93_tab[0]);
129 	msleep(50);
130 	return 0;
131 }
132 
133 static int ves1x93_set_inversion(struct ves1x93_state *state,
134 				 enum fe_spectral_inversion inversion)
135 {
136 	u8 val;
137 
138 	/*
139 	 * inversion on/off are interchanged because i and q seem to
140 	 * be swapped on the hardware
141 	 */
142 
143 	switch (inversion) {
144 	case INVERSION_OFF:
145 		val = 0xc0;
146 		break;
147 	case INVERSION_ON:
148 		val = 0x80;
149 		break;
150 	case INVERSION_AUTO:
151 		val = 0x00;
152 		break;
153 	default:
154 		return -EINVAL;
155 	}
156 
157 	return ves1x93_writereg (state, 0x0c, (state->init_1x93_tab[0x0c] & 0x3f) | val);
158 }
159 
160 static int ves1x93_set_fec(struct ves1x93_state *state, enum fe_code_rate fec)
161 {
162 	if (fec == FEC_AUTO)
163 		return ves1x93_writereg (state, 0x0d, 0x08);
164 	else if (fec < FEC_1_2 || fec > FEC_8_9)
165 		return -EINVAL;
166 	else
167 		return ves1x93_writereg (state, 0x0d, fec - FEC_1_2);
168 }
169 
170 static enum fe_code_rate ves1x93_get_fec(struct ves1x93_state *state)
171 {
172 	return FEC_1_2 + ((ves1x93_readreg (state, 0x0d) >> 4) & 0x7);
173 }
174 
175 static int ves1x93_set_symbolrate (struct ves1x93_state* state, u32 srate)
176 {
177 	u32 BDR;
178 	u32 ratio;
179 	u8  ADCONF, FCONF, FNR, AGCR;
180 	u32 BDRI;
181 	u32 tmp;
182 	u32 FIN;
183 
184 	dprintk("%s: srate == %d\n", __func__, (unsigned int) srate);
185 
186 	if (srate > state->config->xin/2)
187 		srate = state->config->xin/2;
188 
189 	if (srate < 500000)
190 		srate = 500000;
191 
192 #define MUL (1UL<<26)
193 
194 	FIN = (state->config->xin + 6000) >> 4;
195 
196 	tmp = srate << 6;
197 	ratio = tmp / FIN;
198 
199 	tmp = (tmp % FIN) << 8;
200 	ratio = (ratio << 8) + tmp / FIN;
201 
202 	tmp = (tmp % FIN) << 8;
203 	ratio = (ratio << 8) + tmp / FIN;
204 
205 	FNR = 0xff;
206 
207 	if (ratio < MUL/3)	     FNR = 0;
208 	if (ratio < (MUL*11)/50)     FNR = 1;
209 	if (ratio < MUL/6)	     FNR = 2;
210 	if (ratio < MUL/9)	     FNR = 3;
211 	if (ratio < MUL/12)	     FNR = 4;
212 	if (ratio < (MUL*11)/200)    FNR = 5;
213 	if (ratio < MUL/24)	     FNR = 6;
214 	if (ratio < (MUL*27)/1000)   FNR = 7;
215 	if (ratio < MUL/48)	     FNR = 8;
216 	if (ratio < (MUL*137)/10000) FNR = 9;
217 
218 	if (FNR == 0xff) {
219 		ADCONF = 0x89;
220 		FCONF  = 0x80;
221 		FNR	= 0;
222 	} else {
223 		ADCONF = 0x81;
224 		FCONF  = 0x88 | (FNR >> 1) | ((FNR & 0x01) << 5);
225 		/*FCONF	 = 0x80 | ((FNR & 0x01) << 5) | (((FNR > 1) & 0x03) << 3) | ((FNR >> 1) & 0x07);*/
226 	}
227 
228 	BDR = (( (ratio << (FNR >> 1)) >> 4) + 1) >> 1;
229 	BDRI = ( ((FIN << 8) / ((srate << (FNR >> 1)) >> 2)) + 1) >> 1;
230 
231 	dprintk("FNR= %d\n", FNR);
232 	dprintk("ratio= %08x\n", (unsigned int) ratio);
233 	dprintk("BDR= %08x\n", (unsigned int) BDR);
234 	dprintk("BDRI= %02x\n", (unsigned int) BDRI);
235 
236 	if (BDRI > 0xff)
237 		BDRI = 0xff;
238 
239 	ves1x93_writereg (state, 0x06, 0xff & BDR);
240 	ves1x93_writereg (state, 0x07, 0xff & (BDR >> 8));
241 	ves1x93_writereg (state, 0x08, 0x0f & (BDR >> 16));
242 
243 	ves1x93_writereg (state, 0x09, BDRI);
244 	ves1x93_writereg (state, 0x20, ADCONF);
245 	ves1x93_writereg (state, 0x21, FCONF);
246 
247 	AGCR = state->init_1x93_tab[0x05];
248 	if (state->config->invert_pwm)
249 		AGCR |= 0x20;
250 
251 	if (srate < 6000000)
252 		AGCR |= 0x80;
253 	else
254 		AGCR &= ~0x80;
255 
256 	ves1x93_writereg (state, 0x05, AGCR);
257 
258 	/* ves1993 hates this, will lose lock */
259 	if (state->demod_type != DEMOD_VES1993)
260 		ves1x93_clr_bit (state);
261 
262 	return 0;
263 }
264 
265 static int ves1x93_init (struct dvb_frontend* fe)
266 {
267 	struct ves1x93_state* state = fe->demodulator_priv;
268 	int i;
269 	int val;
270 
271 	dprintk("%s: init chip\n", __func__);
272 
273 	for (i = 0; i < state->tab_size; i++) {
274 		if (state->init_1x93_wtab[i]) {
275 			val = state->init_1x93_tab[i];
276 
277 			if (state->config->invert_pwm && (i == 0x05)) val |= 0x20; /* invert PWM */
278 			ves1x93_writereg (state, i, val);
279 		}
280 	}
281 
282 	return 0;
283 }
284 
285 static int ves1x93_set_voltage(struct dvb_frontend *fe,
286 			       enum fe_sec_voltage voltage)
287 {
288 	struct ves1x93_state* state = fe->demodulator_priv;
289 
290 	switch (voltage) {
291 	case SEC_VOLTAGE_13:
292 		return ves1x93_writereg (state, 0x1f, 0x20);
293 	case SEC_VOLTAGE_18:
294 		return ves1x93_writereg (state, 0x1f, 0x30);
295 	case SEC_VOLTAGE_OFF:
296 		return ves1x93_writereg (state, 0x1f, 0x00);
297 	default:
298 		return -EINVAL;
299 	}
300 }
301 
302 static int ves1x93_read_status(struct dvb_frontend *fe,
303 			       enum fe_status *status)
304 {
305 	struct ves1x93_state* state = fe->demodulator_priv;
306 
307 	u8 sync = ves1x93_readreg (state, 0x0e);
308 
309 	/*
310 	 * The ves1893 sometimes returns sync values that make no sense,
311 	 * because, e.g., the SIGNAL bit is 0, while some of the higher
312 	 * bits are 1 (and how can there be a CARRIER w/o a SIGNAL?).
313 	 * Tests showed that the VITERBI and SYNC bits are returned
314 	 * reliably, while the SIGNAL and CARRIER bits ar sometimes wrong.
315 	 * If such a case occurs, we read the value again, until we get a
316 	 * valid value.
317 	 */
318 	int maxtry = 10; /* just for safety - let's not get stuck here */
319 	while ((sync & 0x03) != 0x03 && (sync & 0x0c) && maxtry--) {
320 		msleep(10);
321 		sync = ves1x93_readreg (state, 0x0e);
322 	}
323 
324 	*status = 0;
325 
326 	if (sync & 1)
327 		*status |= FE_HAS_SIGNAL;
328 
329 	if (sync & 2)
330 		*status |= FE_HAS_CARRIER;
331 
332 	if (sync & 4)
333 		*status |= FE_HAS_VITERBI;
334 
335 	if (sync & 8)
336 		*status |= FE_HAS_SYNC;
337 
338 	if ((sync & 0x1f) == 0x1f)
339 		*status |= FE_HAS_LOCK;
340 
341 	return 0;
342 }
343 
344 static int ves1x93_read_ber(struct dvb_frontend* fe, u32* ber)
345 {
346 	struct ves1x93_state* state = fe->demodulator_priv;
347 
348 	*ber = ves1x93_readreg (state, 0x15);
349 	*ber |= (ves1x93_readreg (state, 0x16) << 8);
350 	*ber |= ((ves1x93_readreg (state, 0x17) & 0x0F) << 16);
351 	*ber *= 10;
352 
353 	return 0;
354 }
355 
356 static int ves1x93_read_signal_strength(struct dvb_frontend* fe, u16* strength)
357 {
358 	struct ves1x93_state* state = fe->demodulator_priv;
359 
360 	u8 signal = ~ves1x93_readreg (state, 0x0b);
361 	*strength = (signal << 8) | signal;
362 
363 	return 0;
364 }
365 
366 static int ves1x93_read_snr(struct dvb_frontend* fe, u16* snr)
367 {
368 	struct ves1x93_state* state = fe->demodulator_priv;
369 
370 	u8 _snr = ~ves1x93_readreg (state, 0x1c);
371 	*snr = (_snr << 8) | _snr;
372 
373 	return 0;
374 }
375 
376 static int ves1x93_read_ucblocks(struct dvb_frontend* fe, u32* ucblocks)
377 {
378 	struct ves1x93_state* state = fe->demodulator_priv;
379 
380 	*ucblocks = ves1x93_readreg (state, 0x18) & 0x7f;
381 
382 	if (*ucblocks == 0x7f)
383 		*ucblocks = 0xffffffff;   /* counter overflow... */
384 
385 	ves1x93_writereg (state, 0x18, 0x00);  /* reset the counter */
386 	ves1x93_writereg (state, 0x18, 0x80);  /* dto. */
387 
388 	return 0;
389 }
390 
391 static int ves1x93_set_frontend(struct dvb_frontend *fe)
392 {
393 	struct dtv_frontend_properties *p = &fe->dtv_property_cache;
394 	struct ves1x93_state* state = fe->demodulator_priv;
395 
396 	if (fe->ops.tuner_ops.set_params) {
397 		fe->ops.tuner_ops.set_params(fe);
398 		if (fe->ops.i2c_gate_ctrl) fe->ops.i2c_gate_ctrl(fe, 0);
399 	}
400 	ves1x93_set_inversion (state, p->inversion);
401 	ves1x93_set_fec(state, p->fec_inner);
402 	ves1x93_set_symbolrate(state, p->symbol_rate);
403 	state->inversion = p->inversion;
404 	state->frequency = p->frequency;
405 
406 	return 0;
407 }
408 
409 static int ves1x93_get_frontend(struct dvb_frontend *fe,
410 				struct dtv_frontend_properties *p)
411 {
412 	struct ves1x93_state* state = fe->demodulator_priv;
413 	int afc;
414 
415 	afc = ((int)((char)(ves1x93_readreg (state, 0x0a) << 1)))/2;
416 	afc = (afc * (int)(p->symbol_rate/1000/8))/16;
417 
418 	p->frequency = state->frequency - afc;
419 
420 	/*
421 	 * inversion indicator is only valid
422 	 * if auto inversion was used
423 	 */
424 	if (state->inversion == INVERSION_AUTO)
425 		p->inversion = (ves1x93_readreg (state, 0x0f) & 2) ?
426 				INVERSION_OFF : INVERSION_ON;
427 	p->fec_inner = ves1x93_get_fec(state);
428 	/*  XXX FIXME: timing offset !! */
429 
430 	return 0;
431 }
432 
433 static int ves1x93_sleep(struct dvb_frontend* fe)
434 {
435 	struct ves1x93_state* state = fe->demodulator_priv;
436 
437 	return ves1x93_writereg (state, 0x00, 0x08);
438 }
439 
440 static void ves1x93_release(struct dvb_frontend* fe)
441 {
442 	struct ves1x93_state* state = fe->demodulator_priv;
443 	kfree(state);
444 }
445 
446 static int ves1x93_i2c_gate_ctrl(struct dvb_frontend* fe, int enable)
447 {
448 	struct ves1x93_state* state = fe->demodulator_priv;
449 
450 	if (enable) {
451 		return ves1x93_writereg(state, 0x00, 0x11);
452 	} else {
453 		return ves1x93_writereg(state, 0x00, 0x01);
454 	}
455 }
456 
457 static const struct dvb_frontend_ops ves1x93_ops;
458 
459 struct dvb_frontend* ves1x93_attach(const struct ves1x93_config* config,
460 				    struct i2c_adapter* i2c)
461 {
462 	struct ves1x93_state* state = NULL;
463 	u8 identity;
464 
465 	/* allocate memory for the internal state */
466 	state = kzalloc(sizeof(struct ves1x93_state), GFP_KERNEL);
467 	if (state == NULL) goto error;
468 
469 	/* setup the state */
470 	state->config = config;
471 	state->i2c = i2c;
472 	state->inversion = INVERSION_OFF;
473 
474 	/* check if the demod is there + identify it */
475 	identity = ves1x93_readreg(state, 0x1e);
476 	switch (identity) {
477 	case 0xdc: /* VES1893A rev1 */
478 		printk("ves1x93: Detected ves1893a rev1\n");
479 		state->demod_type = DEMOD_VES1893;
480 		state->init_1x93_tab = init_1893_tab;
481 		state->init_1x93_wtab = init_1893_wtab;
482 		state->tab_size = sizeof(init_1893_tab);
483 		break;
484 
485 	case 0xdd: /* VES1893A rev2 */
486 		printk("ves1x93: Detected ves1893a rev2\n");
487 		state->demod_type = DEMOD_VES1893;
488 		state->init_1x93_tab = init_1893_tab;
489 		state->init_1x93_wtab = init_1893_wtab;
490 		state->tab_size = sizeof(init_1893_tab);
491 		break;
492 
493 	case 0xde: /* VES1993 */
494 		printk("ves1x93: Detected ves1993\n");
495 		state->demod_type = DEMOD_VES1993;
496 		state->init_1x93_tab = init_1993_tab;
497 		state->init_1x93_wtab = init_1993_wtab;
498 		state->tab_size = sizeof(init_1993_tab);
499 		break;
500 
501 	default:
502 		goto error;
503 	}
504 
505 	/* create dvb_frontend */
506 	memcpy(&state->frontend.ops, &ves1x93_ops, sizeof(struct dvb_frontend_ops));
507 	state->frontend.demodulator_priv = state;
508 	return &state->frontend;
509 
510 error:
511 	kfree(state);
512 	return NULL;
513 }
514 
515 static const struct dvb_frontend_ops ves1x93_ops = {
516 	.delsys = { SYS_DVBS },
517 	.info = {
518 		.name			= "VLSI VES1x93 DVB-S",
519 		.frequency_min		= 950000,
520 		.frequency_max		= 2150000,
521 		.frequency_stepsize	= 125,		 /* kHz for QPSK frontends */
522 		.frequency_tolerance	= 29500,
523 		.symbol_rate_min	= 1000000,
524 		.symbol_rate_max	= 45000000,
525 	/*	.symbol_rate_tolerance	=	???,*/
526 		.caps = FE_CAN_INVERSION_AUTO |
527 			FE_CAN_FEC_1_2 | FE_CAN_FEC_2_3 | FE_CAN_FEC_3_4 |
528 			FE_CAN_FEC_5_6 | FE_CAN_FEC_7_8 | FE_CAN_FEC_AUTO |
529 			FE_CAN_QPSK
530 	},
531 
532 	.release = ves1x93_release,
533 
534 	.init = ves1x93_init,
535 	.sleep = ves1x93_sleep,
536 	.i2c_gate_ctrl = ves1x93_i2c_gate_ctrl,
537 
538 	.set_frontend = ves1x93_set_frontend,
539 	.get_frontend = ves1x93_get_frontend,
540 
541 	.read_status = ves1x93_read_status,
542 	.read_ber = ves1x93_read_ber,
543 	.read_signal_strength = ves1x93_read_signal_strength,
544 	.read_snr = ves1x93_read_snr,
545 	.read_ucblocks = ves1x93_read_ucblocks,
546 
547 	.set_voltage = ves1x93_set_voltage,
548 };
549 
550 module_param(debug, int, 0644);
551 
552 MODULE_DESCRIPTION("VLSI VES1x93 DVB-S Demodulator driver");
553 MODULE_AUTHOR("Ralph Metzler");
554 MODULE_LICENSE("GPL");
555 
556 EXPORT_SYMBOL(ves1x93_attach);
557