1 /*
2     Driver for Zarlink VP310/MT312/ZL10313 Satellite Channel Decoder
3 
4     Copyright (C) 2003 Andreas Oberritter <obi@linuxtv.org>
5     Copyright (C) 2008 Matthias Schwarzott <zzam@gentoo.org>
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 
16     GNU General Public License for more details.
17 
18     You should have received a copy of the GNU General Public License
19     along with this program; if not, write to the Free Software
20     Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
21 
22     References:
23     http://products.zarlink.com/product_profiles/MT312.htm
24     http://products.zarlink.com/product_profiles/SL1935.htm
25 */
26 
27 #include <linux/delay.h>
28 #include <linux/errno.h>
29 #include <linux/init.h>
30 #include <linux/kernel.h>
31 #include <linux/module.h>
32 #include <linux/string.h>
33 #include <linux/slab.h>
34 
35 #include "dvb_frontend.h"
36 #include "mt312_priv.h"
37 #include "mt312.h"
38 
39 /* Max transfer size done by I2C transfer functions */
40 #define MAX_XFER_SIZE  64
41 
42 struct mt312_state {
43 	struct i2c_adapter *i2c;
44 	/* configuration settings */
45 	const struct mt312_config *config;
46 	struct dvb_frontend frontend;
47 
48 	u8 id;
49 	unsigned long xtal;
50 	u8 freq_mult;
51 };
52 
53 static int debug;
54 #define dprintk(args...) \
55 	do { \
56 		if (debug) \
57 			printk(KERN_DEBUG "mt312: " args); \
58 	} while (0)
59 
60 #define MT312_PLL_CLK		10000000UL	/* 10 MHz */
61 #define MT312_PLL_CLK_10_111	10111000UL	/* 10.111 MHz */
62 
63 static int mt312_read(struct mt312_state *state, const enum mt312_reg_addr reg,
64 		      u8 *buf, const size_t count)
65 {
66 	int ret;
67 	struct i2c_msg msg[2];
68 	u8 regbuf[1] = { reg };
69 
70 	msg[0].addr = state->config->demod_address;
71 	msg[0].flags = 0;
72 	msg[0].buf = regbuf;
73 	msg[0].len = 1;
74 	msg[1].addr = state->config->demod_address;
75 	msg[1].flags = I2C_M_RD;
76 	msg[1].buf = buf;
77 	msg[1].len = count;
78 
79 	ret = i2c_transfer(state->i2c, msg, 2);
80 
81 	if (ret != 2) {
82 		printk(KERN_DEBUG "%s: ret == %d\n", __func__, ret);
83 		return -EREMOTEIO;
84 	}
85 
86 	if (debug) {
87 		int i;
88 		dprintk("R(%d):", reg & 0x7f);
89 		for (i = 0; i < count; i++)
90 			printk(KERN_CONT " %02x", buf[i]);
91 		printk("\n");
92 	}
93 
94 	return 0;
95 }
96 
97 static int mt312_write(struct mt312_state *state, const enum mt312_reg_addr reg,
98 		       const u8 *src, const size_t count)
99 {
100 	int ret;
101 	u8 buf[MAX_XFER_SIZE];
102 	struct i2c_msg msg;
103 
104 	if (1 + count > sizeof(buf)) {
105 		printk(KERN_WARNING
106 		       "mt312: write: len=%zd is too big!\n", count);
107 		return -EINVAL;
108 	}
109 
110 	if (debug) {
111 		int i;
112 		dprintk("W(%d):", reg & 0x7f);
113 		for (i = 0; i < count; i++)
114 			printk(KERN_CONT " %02x", src[i]);
115 		printk("\n");
116 	}
117 
118 	buf[0] = reg;
119 	memcpy(&buf[1], src, count);
120 
121 	msg.addr = state->config->demod_address;
122 	msg.flags = 0;
123 	msg.buf = buf;
124 	msg.len = count + 1;
125 
126 	ret = i2c_transfer(state->i2c, &msg, 1);
127 
128 	if (ret != 1) {
129 		dprintk("%s: ret == %d\n", __func__, ret);
130 		return -EREMOTEIO;
131 	}
132 
133 	return 0;
134 }
135 
136 static inline int mt312_readreg(struct mt312_state *state,
137 				const enum mt312_reg_addr reg, u8 *val)
138 {
139 	return mt312_read(state, reg, val, 1);
140 }
141 
142 static inline int mt312_writereg(struct mt312_state *state,
143 				 const enum mt312_reg_addr reg, const u8 val)
144 {
145 	return mt312_write(state, reg, &val, 1);
146 }
147 
148 static inline u32 mt312_div(u32 a, u32 b)
149 {
150 	return (a + (b / 2)) / b;
151 }
152 
153 static int mt312_reset(struct mt312_state *state, const u8 full)
154 {
155 	return mt312_writereg(state, RESET, full ? 0x80 : 0x40);
156 }
157 
158 static int mt312_get_inversion(struct mt312_state *state,
159 			       fe_spectral_inversion_t *i)
160 {
161 	int ret;
162 	u8 vit_mode;
163 
164 	ret = mt312_readreg(state, VIT_MODE, &vit_mode);
165 	if (ret < 0)
166 		return ret;
167 
168 	if (vit_mode & 0x80)	/* auto inversion was used */
169 		*i = (vit_mode & 0x40) ? INVERSION_ON : INVERSION_OFF;
170 
171 	return 0;
172 }
173 
174 static int mt312_get_symbol_rate(struct mt312_state *state, u32 *sr)
175 {
176 	int ret;
177 	u8 sym_rate_h;
178 	u8 dec_ratio;
179 	u16 sym_rat_op;
180 	u16 monitor;
181 	u8 buf[2];
182 
183 	ret = mt312_readreg(state, SYM_RATE_H, &sym_rate_h);
184 	if (ret < 0)
185 		return ret;
186 
187 	if (sym_rate_h & 0x80) {
188 		/* symbol rate search was used */
189 		ret = mt312_writereg(state, MON_CTRL, 0x03);
190 		if (ret < 0)
191 			return ret;
192 
193 		ret = mt312_read(state, MONITOR_H, buf, sizeof(buf));
194 		if (ret < 0)
195 			return ret;
196 
197 		monitor = (buf[0] << 8) | buf[1];
198 
199 		dprintk("sr(auto) = %u\n",
200 		       mt312_div(monitor * 15625, 4));
201 	} else {
202 		ret = mt312_writereg(state, MON_CTRL, 0x05);
203 		if (ret < 0)
204 			return ret;
205 
206 		ret = mt312_read(state, MONITOR_H, buf, sizeof(buf));
207 		if (ret < 0)
208 			return ret;
209 
210 		dec_ratio = ((buf[0] >> 5) & 0x07) * 32;
211 
212 		ret = mt312_read(state, SYM_RAT_OP_H, buf, sizeof(buf));
213 		if (ret < 0)
214 			return ret;
215 
216 		sym_rat_op = (buf[0] << 8) | buf[1];
217 
218 		dprintk("sym_rat_op=%d dec_ratio=%d\n",
219 		       sym_rat_op, dec_ratio);
220 		dprintk("*sr(manual) = %lu\n",
221 		       (((state->xtal * 8192) / (sym_rat_op + 8192)) *
222 			2) - dec_ratio);
223 	}
224 
225 	return 0;
226 }
227 
228 static int mt312_get_code_rate(struct mt312_state *state, fe_code_rate_t *cr)
229 {
230 	const fe_code_rate_t fec_tab[8] =
231 	    { FEC_1_2, FEC_2_3, FEC_3_4, FEC_5_6, FEC_6_7, FEC_7_8,
232 		FEC_AUTO, FEC_AUTO };
233 
234 	int ret;
235 	u8 fec_status;
236 
237 	ret = mt312_readreg(state, FEC_STATUS, &fec_status);
238 	if (ret < 0)
239 		return ret;
240 
241 	*cr = fec_tab[(fec_status >> 4) & 0x07];
242 
243 	return 0;
244 }
245 
246 static int mt312_initfe(struct dvb_frontend *fe)
247 {
248 	struct mt312_state *state = fe->demodulator_priv;
249 	int ret;
250 	u8 buf[2];
251 
252 	/* wake up */
253 	ret = mt312_writereg(state, CONFIG,
254 			(state->freq_mult == 6 ? 0x88 : 0x8c));
255 	if (ret < 0)
256 		return ret;
257 
258 	/* wait at least 150 usec */
259 	udelay(150);
260 
261 	/* full reset */
262 	ret = mt312_reset(state, 1);
263 	if (ret < 0)
264 		return ret;
265 
266 /* Per datasheet, write correct values. 09/28/03 ACCJr.
267  * If we don't do this, we won't get FE_HAS_VITERBI in the VP310. */
268 	{
269 		u8 buf_def[8] = { 0x14, 0x12, 0x03, 0x02,
270 				  0x01, 0x00, 0x00, 0x00 };
271 
272 		ret = mt312_write(state, VIT_SETUP, buf_def, sizeof(buf_def));
273 		if (ret < 0)
274 			return ret;
275 	}
276 
277 	switch (state->id) {
278 	case ID_ZL10313:
279 		/* enable ADC */
280 		ret = mt312_writereg(state, GPP_CTRL, 0x80);
281 		if (ret < 0)
282 			return ret;
283 
284 		/* configure ZL10313 for optimal ADC performance */
285 		buf[0] = 0x80;
286 		buf[1] = 0xB0;
287 		ret = mt312_write(state, HW_CTRL, buf, 2);
288 		if (ret < 0)
289 			return ret;
290 
291 		/* enable MPEG output and ADCs */
292 		ret = mt312_writereg(state, HW_CTRL, 0x00);
293 		if (ret < 0)
294 			return ret;
295 
296 		ret = mt312_writereg(state, MPEG_CTRL, 0x00);
297 		if (ret < 0)
298 			return ret;
299 
300 		break;
301 	}
302 
303 	/* SYS_CLK */
304 	buf[0] = mt312_div(state->xtal * state->freq_mult * 2, 1000000);
305 
306 	/* DISEQC_RATIO */
307 	buf[1] = mt312_div(state->xtal, 22000 * 4);
308 
309 	ret = mt312_write(state, SYS_CLK, buf, sizeof(buf));
310 	if (ret < 0)
311 		return ret;
312 
313 	ret = mt312_writereg(state, SNR_THS_HIGH, 0x32);
314 	if (ret < 0)
315 		return ret;
316 
317 	/* different MOCLK polarity */
318 	switch (state->id) {
319 	case ID_ZL10313:
320 		buf[0] = 0x33;
321 		break;
322 	default:
323 		buf[0] = 0x53;
324 		break;
325 	}
326 
327 	ret = mt312_writereg(state, OP_CTRL, buf[0]);
328 	if (ret < 0)
329 		return ret;
330 
331 	/* TS_SW_LIM */
332 	buf[0] = 0x8c;
333 	buf[1] = 0x98;
334 
335 	ret = mt312_write(state, TS_SW_LIM_L, buf, sizeof(buf));
336 	if (ret < 0)
337 		return ret;
338 
339 	ret = mt312_writereg(state, CS_SW_LIM, 0x69);
340 	if (ret < 0)
341 		return ret;
342 
343 	return 0;
344 }
345 
346 static int mt312_send_master_cmd(struct dvb_frontend *fe,
347 				 struct dvb_diseqc_master_cmd *c)
348 {
349 	struct mt312_state *state = fe->demodulator_priv;
350 	int ret;
351 	u8 diseqc_mode;
352 
353 	if ((c->msg_len == 0) || (c->msg_len > sizeof(c->msg)))
354 		return -EINVAL;
355 
356 	ret = mt312_readreg(state, DISEQC_MODE, &diseqc_mode);
357 	if (ret < 0)
358 		return ret;
359 
360 	ret = mt312_write(state, (0x80 | DISEQC_INSTR), c->msg, c->msg_len);
361 	if (ret < 0)
362 		return ret;
363 
364 	ret = mt312_writereg(state, DISEQC_MODE,
365 			     (diseqc_mode & 0x40) | ((c->msg_len - 1) << 3)
366 			     | 0x04);
367 	if (ret < 0)
368 		return ret;
369 
370 	/* is there a better way to wait for message to be transmitted */
371 	msleep(100);
372 
373 	/* set DISEQC_MODE[2:0] to zero if a return message is expected */
374 	if (c->msg[0] & 0x02) {
375 		ret = mt312_writereg(state, DISEQC_MODE, (diseqc_mode & 0x40));
376 		if (ret < 0)
377 			return ret;
378 	}
379 
380 	return 0;
381 }
382 
383 static int mt312_send_burst(struct dvb_frontend *fe, const fe_sec_mini_cmd_t c)
384 {
385 	struct mt312_state *state = fe->demodulator_priv;
386 	const u8 mini_tab[2] = { 0x02, 0x03 };
387 
388 	int ret;
389 	u8 diseqc_mode;
390 
391 	if (c > SEC_MINI_B)
392 		return -EINVAL;
393 
394 	ret = mt312_readreg(state, DISEQC_MODE, &diseqc_mode);
395 	if (ret < 0)
396 		return ret;
397 
398 	ret = mt312_writereg(state, DISEQC_MODE,
399 			     (diseqc_mode & 0x40) | mini_tab[c]);
400 	if (ret < 0)
401 		return ret;
402 
403 	return 0;
404 }
405 
406 static int mt312_set_tone(struct dvb_frontend *fe, const fe_sec_tone_mode_t t)
407 {
408 	struct mt312_state *state = fe->demodulator_priv;
409 	const u8 tone_tab[2] = { 0x01, 0x00 };
410 
411 	int ret;
412 	u8 diseqc_mode;
413 
414 	if (t > SEC_TONE_OFF)
415 		return -EINVAL;
416 
417 	ret = mt312_readreg(state, DISEQC_MODE, &diseqc_mode);
418 	if (ret < 0)
419 		return ret;
420 
421 	ret = mt312_writereg(state, DISEQC_MODE,
422 			     (diseqc_mode & 0x40) | tone_tab[t]);
423 	if (ret < 0)
424 		return ret;
425 
426 	return 0;
427 }
428 
429 static int mt312_set_voltage(struct dvb_frontend *fe, const fe_sec_voltage_t v)
430 {
431 	struct mt312_state *state = fe->demodulator_priv;
432 	const u8 volt_tab[3] = { 0x00, 0x40, 0x00 };
433 	u8 val;
434 
435 	if (v > SEC_VOLTAGE_OFF)
436 		return -EINVAL;
437 
438 	val = volt_tab[v];
439 	if (state->config->voltage_inverted)
440 		val ^= 0x40;
441 
442 	return mt312_writereg(state, DISEQC_MODE, val);
443 }
444 
445 static int mt312_read_status(struct dvb_frontend *fe, fe_status_t *s)
446 {
447 	struct mt312_state *state = fe->demodulator_priv;
448 	int ret;
449 	u8 status[3];
450 
451 	*s = 0;
452 
453 	ret = mt312_read(state, QPSK_STAT_H, status, sizeof(status));
454 	if (ret < 0)
455 		return ret;
456 
457 	dprintk("QPSK_STAT_H: 0x%02x, QPSK_STAT_L: 0x%02x,"
458 		" FEC_STATUS: 0x%02x\n", status[0], status[1], status[2]);
459 
460 	if (status[0] & 0xc0)
461 		*s |= FE_HAS_SIGNAL;	/* signal noise ratio */
462 	if (status[0] & 0x04)
463 		*s |= FE_HAS_CARRIER;	/* qpsk carrier lock */
464 	if (status[2] & 0x02)
465 		*s |= FE_HAS_VITERBI;	/* viterbi lock */
466 	if (status[2] & 0x04)
467 		*s |= FE_HAS_SYNC;	/* byte align lock */
468 	if (status[0] & 0x01)
469 		*s |= FE_HAS_LOCK;	/* qpsk lock */
470 
471 	return 0;
472 }
473 
474 static int mt312_read_ber(struct dvb_frontend *fe, u32 *ber)
475 {
476 	struct mt312_state *state = fe->demodulator_priv;
477 	int ret;
478 	u8 buf[3];
479 
480 	ret = mt312_read(state, RS_BERCNT_H, buf, 3);
481 	if (ret < 0)
482 		return ret;
483 
484 	*ber = ((buf[0] << 16) | (buf[1] << 8) | buf[2]) * 64;
485 
486 	return 0;
487 }
488 
489 static int mt312_read_signal_strength(struct dvb_frontend *fe,
490 				      u16 *signal_strength)
491 {
492 	struct mt312_state *state = fe->demodulator_priv;
493 	int ret;
494 	u8 buf[3];
495 	u16 agc;
496 	s16 err_db;
497 
498 	ret = mt312_read(state, AGC_H, buf, sizeof(buf));
499 	if (ret < 0)
500 		return ret;
501 
502 	agc = (buf[0] << 6) | (buf[1] >> 2);
503 	err_db = (s16) (((buf[1] & 0x03) << 14) | buf[2] << 6) >> 6;
504 
505 	*signal_strength = agc;
506 
507 	dprintk("agc=%08x err_db=%hd\n", agc, err_db);
508 
509 	return 0;
510 }
511 
512 static int mt312_read_snr(struct dvb_frontend *fe, u16 *snr)
513 {
514 	struct mt312_state *state = fe->demodulator_priv;
515 	int ret;
516 	u8 buf[2];
517 
518 	ret = mt312_read(state, M_SNR_H, buf, sizeof(buf));
519 	if (ret < 0)
520 		return ret;
521 
522 	*snr = 0xFFFF - ((((buf[0] & 0x7f) << 8) | buf[1]) << 1);
523 
524 	return 0;
525 }
526 
527 static int mt312_read_ucblocks(struct dvb_frontend *fe, u32 *ubc)
528 {
529 	struct mt312_state *state = fe->demodulator_priv;
530 	int ret;
531 	u8 buf[2];
532 
533 	ret = mt312_read(state, RS_UBC_H, buf, sizeof(buf));
534 	if (ret < 0)
535 		return ret;
536 
537 	*ubc = (buf[0] << 8) | buf[1];
538 
539 	return 0;
540 }
541 
542 static int mt312_set_frontend(struct dvb_frontend *fe)
543 {
544 	struct dtv_frontend_properties *p = &fe->dtv_property_cache;
545 	struct mt312_state *state = fe->demodulator_priv;
546 	int ret;
547 	u8 buf[5], config_val;
548 	u16 sr;
549 
550 	const u8 fec_tab[10] =
551 	    { 0x00, 0x01, 0x02, 0x04, 0x3f, 0x08, 0x10, 0x20, 0x3f, 0x3f };
552 	const u8 inv_tab[3] = { 0x00, 0x40, 0x80 };
553 
554 	dprintk("%s: Freq %d\n", __func__, p->frequency);
555 
556 	if ((p->frequency < fe->ops.info.frequency_min)
557 	    || (p->frequency > fe->ops.info.frequency_max))
558 		return -EINVAL;
559 
560 	if (((int)p->inversion < INVERSION_OFF)
561 	    || (p->inversion > INVERSION_ON))
562 		return -EINVAL;
563 
564 	if ((p->symbol_rate < fe->ops.info.symbol_rate_min)
565 	    || (p->symbol_rate > fe->ops.info.symbol_rate_max))
566 		return -EINVAL;
567 
568 	if (((int)p->fec_inner < FEC_NONE)
569 	    || (p->fec_inner > FEC_AUTO))
570 		return -EINVAL;
571 
572 	if ((p->fec_inner == FEC_4_5)
573 	    || (p->fec_inner == FEC_8_9))
574 		return -EINVAL;
575 
576 	switch (state->id) {
577 	case ID_VP310:
578 	/* For now we will do this only for the VP310.
579 	 * It should be better for the mt312 as well,
580 	 * but tuning will be slower. ACCJr 09/29/03
581 	 */
582 		ret = mt312_readreg(state, CONFIG, &config_val);
583 		if (ret < 0)
584 			return ret;
585 		if (p->symbol_rate >= 30000000) {
586 			/* Note that 30MS/s should use 90MHz */
587 			if (state->freq_mult == 6) {
588 				/* We are running 60MHz */
589 				state->freq_mult = 9;
590 				ret = mt312_initfe(fe);
591 				if (ret < 0)
592 					return ret;
593 			}
594 		} else {
595 			if (state->freq_mult == 9) {
596 				/* We are running 90MHz */
597 				state->freq_mult = 6;
598 				ret = mt312_initfe(fe);
599 				if (ret < 0)
600 					return ret;
601 			}
602 		}
603 		break;
604 
605 	case ID_MT312:
606 	case ID_ZL10313:
607 		break;
608 
609 	default:
610 		return -EINVAL;
611 	}
612 
613 	if (fe->ops.tuner_ops.set_params) {
614 		fe->ops.tuner_ops.set_params(fe);
615 		if (fe->ops.i2c_gate_ctrl)
616 			fe->ops.i2c_gate_ctrl(fe, 0);
617 	}
618 
619 	/* sr = (u16)(sr * 256.0 / 1000000.0) */
620 	sr = mt312_div(p->symbol_rate * 4, 15625);
621 
622 	/* SYM_RATE */
623 	buf[0] = (sr >> 8) & 0x3f;
624 	buf[1] = (sr >> 0) & 0xff;
625 
626 	/* VIT_MODE */
627 	buf[2] = inv_tab[p->inversion] | fec_tab[p->fec_inner];
628 
629 	/* QPSK_CTRL */
630 	buf[3] = 0x40;		/* swap I and Q before QPSK demodulation */
631 
632 	if (p->symbol_rate < 10000000)
633 		buf[3] |= 0x04;	/* use afc mode */
634 
635 	/* GO */
636 	buf[4] = 0x01;
637 
638 	ret = mt312_write(state, SYM_RATE_H, buf, sizeof(buf));
639 	if (ret < 0)
640 		return ret;
641 
642 	mt312_reset(state, 0);
643 
644 	return 0;
645 }
646 
647 static int mt312_get_frontend(struct dvb_frontend *fe)
648 {
649 	struct dtv_frontend_properties *p = &fe->dtv_property_cache;
650 	struct mt312_state *state = fe->demodulator_priv;
651 	int ret;
652 
653 	ret = mt312_get_inversion(state, &p->inversion);
654 	if (ret < 0)
655 		return ret;
656 
657 	ret = mt312_get_symbol_rate(state, &p->symbol_rate);
658 	if (ret < 0)
659 		return ret;
660 
661 	ret = mt312_get_code_rate(state, &p->fec_inner);
662 	if (ret < 0)
663 		return ret;
664 
665 	return 0;
666 }
667 
668 static int mt312_i2c_gate_ctrl(struct dvb_frontend *fe, int enable)
669 {
670 	struct mt312_state *state = fe->demodulator_priv;
671 
672 	u8 val = 0x00;
673 	int ret;
674 
675 	switch (state->id) {
676 	case ID_ZL10313:
677 		ret = mt312_readreg(state, GPP_CTRL, &val);
678 		if (ret < 0)
679 			goto error;
680 
681 		/* preserve this bit to not accidentally shutdown ADC */
682 		val &= 0x80;
683 		break;
684 	}
685 
686 	if (enable)
687 		val |= 0x40;
688 	else
689 		val &= ~0x40;
690 
691 	ret = mt312_writereg(state, GPP_CTRL, val);
692 
693 error:
694 	return ret;
695 }
696 
697 static int mt312_sleep(struct dvb_frontend *fe)
698 {
699 	struct mt312_state *state = fe->demodulator_priv;
700 	int ret;
701 	u8 config;
702 
703 	/* reset all registers to defaults */
704 	ret = mt312_reset(state, 1);
705 	if (ret < 0)
706 		return ret;
707 
708 	if (state->id == ID_ZL10313) {
709 		/* reset ADC */
710 		ret = mt312_writereg(state, GPP_CTRL, 0x00);
711 		if (ret < 0)
712 			return ret;
713 
714 		/* full shutdown of ADCs, mpeg bus tristated */
715 		ret = mt312_writereg(state, HW_CTRL, 0x0d);
716 		if (ret < 0)
717 			return ret;
718 	}
719 
720 	ret = mt312_readreg(state, CONFIG, &config);
721 	if (ret < 0)
722 		return ret;
723 
724 	/* enter standby */
725 	ret = mt312_writereg(state, CONFIG, config & 0x7f);
726 	if (ret < 0)
727 		return ret;
728 
729 	return 0;
730 }
731 
732 static int mt312_get_tune_settings(struct dvb_frontend *fe,
733 		struct dvb_frontend_tune_settings *fesettings)
734 {
735 	fesettings->min_delay_ms = 50;
736 	fesettings->step_size = 0;
737 	fesettings->max_drift = 0;
738 	return 0;
739 }
740 
741 static void mt312_release(struct dvb_frontend *fe)
742 {
743 	struct mt312_state *state = fe->demodulator_priv;
744 	kfree(state);
745 }
746 
747 #define MT312_SYS_CLK		90000000UL	/* 90 MHz */
748 static struct dvb_frontend_ops mt312_ops = {
749 	.delsys = { SYS_DVBS },
750 	.info = {
751 		.name = "Zarlink ???? DVB-S",
752 		.frequency_min = 950000,
753 		.frequency_max = 2150000,
754 		/* FIXME: adjust freq to real used xtal */
755 		.frequency_stepsize = (MT312_PLL_CLK / 1000) / 128,
756 		.symbol_rate_min = MT312_SYS_CLK / 128, /* FIXME as above */
757 		.symbol_rate_max = MT312_SYS_CLK / 2,
758 		.caps =
759 		    FE_CAN_FEC_1_2 | FE_CAN_FEC_2_3 |
760 		    FE_CAN_FEC_3_4 | FE_CAN_FEC_5_6 | FE_CAN_FEC_7_8 |
761 		    FE_CAN_FEC_AUTO | FE_CAN_QPSK | FE_CAN_MUTE_TS |
762 		    FE_CAN_RECOVER
763 	},
764 
765 	.release = mt312_release,
766 
767 	.init = mt312_initfe,
768 	.sleep = mt312_sleep,
769 	.i2c_gate_ctrl = mt312_i2c_gate_ctrl,
770 
771 	.set_frontend = mt312_set_frontend,
772 	.get_frontend = mt312_get_frontend,
773 	.get_tune_settings = mt312_get_tune_settings,
774 
775 	.read_status = mt312_read_status,
776 	.read_ber = mt312_read_ber,
777 	.read_signal_strength = mt312_read_signal_strength,
778 	.read_snr = mt312_read_snr,
779 	.read_ucblocks = mt312_read_ucblocks,
780 
781 	.diseqc_send_master_cmd = mt312_send_master_cmd,
782 	.diseqc_send_burst = mt312_send_burst,
783 	.set_tone = mt312_set_tone,
784 	.set_voltage = mt312_set_voltage,
785 };
786 
787 struct dvb_frontend *mt312_attach(const struct mt312_config *config,
788 					struct i2c_adapter *i2c)
789 {
790 	struct mt312_state *state = NULL;
791 
792 	/* allocate memory for the internal state */
793 	state = kzalloc(sizeof(struct mt312_state), GFP_KERNEL);
794 	if (state == NULL)
795 		goto error;
796 
797 	/* setup the state */
798 	state->config = config;
799 	state->i2c = i2c;
800 
801 	/* check if the demod is there */
802 	if (mt312_readreg(state, ID, &state->id) < 0)
803 		goto error;
804 
805 	/* create dvb_frontend */
806 	memcpy(&state->frontend.ops, &mt312_ops,
807 		sizeof(struct dvb_frontend_ops));
808 	state->frontend.demodulator_priv = state;
809 
810 	switch (state->id) {
811 	case ID_VP310:
812 		strcpy(state->frontend.ops.info.name, "Zarlink VP310 DVB-S");
813 		state->xtal = MT312_PLL_CLK;
814 		state->freq_mult = 9;
815 		break;
816 	case ID_MT312:
817 		strcpy(state->frontend.ops.info.name, "Zarlink MT312 DVB-S");
818 		state->xtal = MT312_PLL_CLK;
819 		state->freq_mult = 6;
820 		break;
821 	case ID_ZL10313:
822 		strcpy(state->frontend.ops.info.name, "Zarlink ZL10313 DVB-S");
823 		state->xtal = MT312_PLL_CLK_10_111;
824 		state->freq_mult = 9;
825 		break;
826 	default:
827 		printk(KERN_WARNING "Only Zarlink VP310/MT312/ZL10313"
828 			" are supported chips.\n");
829 		goto error;
830 	}
831 
832 	return &state->frontend;
833 
834 error:
835 	kfree(state);
836 	return NULL;
837 }
838 EXPORT_SYMBOL(mt312_attach);
839 
840 module_param(debug, int, 0644);
841 MODULE_PARM_DESC(debug, "Turn on/off frontend debugging (default:off).");
842 
843 MODULE_DESCRIPTION("Zarlink VP310/MT312/ZL10313 DVB-S Demodulator driver");
844 MODULE_AUTHOR("Andreas Oberritter <obi@linuxtv.org>");
845 MODULE_AUTHOR("Matthias Schwarzott <zzam@gentoo.org>");
846 MODULE_LICENSE("GPL");
847 
848