2 TDA10021 - Single Chip Cable Channel Receiver driver module
3 used on the the Siemens DVB-C cards
5 Copyright (C) 1999 Convergence Integrated Media GmbH <ralph@convergence.de>
6 Copyright (C) 2004 Markus Schulz <msc@antzsystem.de>
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.
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 GNU General Public License for more details.
19 You should have received a copy of the GNU General Public License
20 along with this program; if not, write to the Free Software
21 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
24 #include <linux/config.h>
25 #include <linux/delay.h>
26 #include <linux/errno.h>
27 #include <linux/init.h>
28 #include <linux/kernel.h>
29 #include <linux/module.h>
30 #include <linux/string.h>
31 #include <linux/slab.h>
33 #include "dvb_frontend.h"
37 struct tda10021_state {
39 struct i2c_adapter* i2c;
41 struct dvb_frontend_ops ops;
43 /* configuration settings */
44 const struct tda10021_config* config;
46 struct dvb_frontend frontend;
54 #define dprintk(x...) printk(x)
61 #define XIN 57840000UL
62 #define DISABLE_INVERSION(reg0) do { reg0 |= 0x20; } while (0)
63 #define ENABLE_INVERSION(reg0) do { reg0 &= ~0x20; } while (0)
64 #define HAS_INVERSION(reg0) (!(reg0 & 0x20))
66 #define FIN (XIN >> 4)
68 int tda10021_inittab_size = 0x40;
69 static u8 tda10021_inittab[0x40]=
71 0x73, 0x6a, 0x23, 0x0a, 0x02, 0x37, 0x77, 0x1a,
72 0x37, 0x6a, 0x17, 0x8a, 0x1e, 0x86, 0x43, 0x40,
73 0xb8, 0x3f, 0xa1, 0x00, 0xcd, 0x01, 0x00, 0xff,
74 0x11, 0x00, 0x7c, 0x31, 0x30, 0x20, 0x00, 0x00,
75 0x02, 0x00, 0x00, 0x7d, 0x00, 0x00, 0x00, 0x00,
76 0x07, 0x00, 0x33, 0x11, 0x0d, 0x95, 0x08, 0x58,
77 0x00, 0x00, 0x80, 0x00, 0x80, 0xff, 0x00, 0x00,
78 0x04, 0x2d, 0x2f, 0xff, 0x00, 0x00, 0x00, 0x00,
81 static int tda10021_writereg (struct tda10021_state* state, u8 reg, u8 data)
83 u8 buf[] = { reg, data };
84 struct i2c_msg msg = { .addr = state->config->demod_address, .flags = 0, .buf = buf, .len = 2 };
87 ret = i2c_transfer (state->i2c, &msg, 1);
89 printk("DVB: TDA10021(%d): %s, writereg error "
90 "(reg == 0x%02x, val == 0x%02x, ret == %i)\n",
91 state->frontend.dvb->num, __FUNCTION__, reg, data, ret);
94 return (ret != 1) ? -EREMOTEIO : 0;
98 static u8 tda10021_readreg (struct tda10021_state* state, u8 reg)
102 struct i2c_msg msg [] = { { .addr = state->config->demod_address, .flags = 0, .buf = b0, .len = 1 },
103 { .addr = state->config->demod_address, .flags = I2C_M_RD, .buf = b1, .len = 1 } };
106 ret = i2c_transfer (state->i2c, msg, 2);
108 printk("DVB: TDA10021(%d): %s: readreg error (ret == %i)\n",
109 state->frontend.dvb->num, __FUNCTION__, ret);
113 //get access to tuner
114 static int lock_tuner(struct tda10021_state* state)
116 u8 buf[2] = { 0x0f, tda10021_inittab[0x0f] | 0x80 };
117 struct i2c_msg msg = {.addr=state->config->demod_address, .flags=0, .buf=buf, .len=2};
119 if(i2c_transfer(state->i2c, &msg, 1) != 1)
121 printk("tda10021: lock tuner fails\n");
127 //release access from tuner
128 static int unlock_tuner(struct tda10021_state* state)
130 u8 buf[2] = { 0x0f, tda10021_inittab[0x0f] & 0x7f };
131 struct i2c_msg msg_post={.addr=state->config->demod_address, .flags=0, .buf=buf, .len=2};
133 if(i2c_transfer(state->i2c, &msg_post, 1) != 1)
135 printk("tda10021: unlock tuner fails\n");
141 static int tda10021_setup_reg0 (struct tda10021_state* state, u8 reg0,
142 fe_spectral_inversion_t inversion)
144 reg0 |= state->reg0 & 0x63;
146 if (INVERSION_ON == inversion)
147 ENABLE_INVERSION(reg0);
148 else if (INVERSION_OFF == inversion)
149 DISABLE_INVERSION(reg0);
151 tda10021_writereg (state, 0x00, reg0 & 0xfe);
152 tda10021_writereg (state, 0x00, reg0 | 0x01);
158 static int tda10021_set_symbolrate (struct tda10021_state* state, u32 symbolrate)
166 if (symbolrate > XIN/2)
168 if (symbolrate < 500000)
171 if (symbolrate < XIN/16) NDEC = 1;
172 if (symbolrate < XIN/32) NDEC = 2;
173 if (symbolrate < XIN/64) NDEC = 3;
175 if (symbolrate < (u32)(XIN/12.3)) SFIL = 1;
176 if (symbolrate < (u32)(XIN/16)) SFIL = 0;
177 if (symbolrate < (u32)(XIN/24.6)) SFIL = 1;
178 if (symbolrate < (u32)(XIN/32)) SFIL = 0;
179 if (symbolrate < (u32)(XIN/49.2)) SFIL = 1;
180 if (symbolrate < (u32)(XIN/64)) SFIL = 0;
181 if (symbolrate < (u32)(XIN/98.4)) SFIL = 1;
184 ratio = (symbolrate << 4) / FIN;
185 tmp = ((symbolrate << 4) % FIN) << 8;
186 ratio = (ratio << 8) + tmp / FIN;
187 tmp = (tmp % FIN) << 8;
188 ratio = (ratio << 8) + (tmp + FIN/2) / FIN;
191 BDRI = (((XIN << 5) / symbolrate) + 1) / 2;
196 SFIL = (SFIL << 4) | tda10021_inittab[0x0E];
198 NDEC = (NDEC << 6) | tda10021_inittab[0x03];
200 tda10021_writereg (state, 0x03, NDEC);
201 tda10021_writereg (state, 0x0a, BDR&0xff);
202 tda10021_writereg (state, 0x0b, (BDR>> 8)&0xff);
203 tda10021_writereg (state, 0x0c, (BDR>>16)&0x3f);
205 tda10021_writereg (state, 0x0d, BDRI);
206 tda10021_writereg (state, 0x0e, SFIL);
220 static int tda10021_init (struct dvb_frontend *fe)
222 struct tda10021_state* state = (struct tda10021_state*) fe->demodulator_priv;
225 dprintk("DVB: TDA10021(%d): init chip\n", fe->adapter->num);
227 //tda10021_writereg (fe, 0, 0);
229 for (i=0; i<tda10021_inittab_size; i++)
230 tda10021_writereg (state, i, tda10021_inittab[i]);
232 tda10021_writereg (state, 0x34, state->pwm);
235 //0x2A[3-0] == PDIV -> P multiplaying factor (P=PDIV+1)(default 0)
236 //0x2A[4] == BYPPLL -> Power down mode (default 1)
237 //0x2A[5] == LCK -> PLL Lock Flag
238 //0x2A[6] == POLAXIN -> Polarity of the input reference clock (default 0)
241 tda10021_writereg(state, 0x2a, tda10021_inittab[0x2a] & 0xef);
243 if (state->config->pll_init) {
245 state->config->pll_init(fe);
252 static int tda10021_set_parameters (struct dvb_frontend *fe,
253 struct dvb_frontend_parameters *p)
255 struct tda10021_state* state = (struct tda10021_state*) fe->demodulator_priv;
257 //table for QAM4-QAM256 ready QAM4 QAM16 QAM32 QAM64 QAM128 QAM256
259 static const u8 reg0x00 [] = { 0x14, 0x00, 0x04, 0x08, 0x0c, 0x10 };
261 static const u8 reg0x01 [] = { 0x78, 0x8c, 0x8c, 0x6a, 0x78, 0x5c };
263 static const u8 reg0x05 [] = { 0x78, 0x87, 0x64, 0x46, 0x36, 0x26 };
265 static const u8 reg0x08 [] = { 0x8c, 0xa2, 0x74, 0x43, 0x34, 0x23 };
267 static const u8 reg0x09 [] = { 0x96, 0x91, 0x96, 0x6a, 0x7e, 0x6b };
269 int qam = p->u.qam.modulation;
271 if (qam < 0 || qam > 5)
274 //printk("tda10021: set frequency to %d qam=%d symrate=%d\n", p->frequency,qam,p->u.qam.symbol_rate);
277 state->config->pll_set(fe, p);
280 tda10021_set_symbolrate (state, p->u.qam.symbol_rate);
281 tda10021_writereg (state, 0x34, state->pwm);
283 tda10021_writereg (state, 0x01, reg0x01[qam]);
284 tda10021_writereg (state, 0x05, reg0x05[qam]);
285 tda10021_writereg (state, 0x08, reg0x08[qam]);
286 tda10021_writereg (state, 0x09, reg0x09[qam]);
288 tda10021_setup_reg0 (state, reg0x00[qam], p->inversion);
293 static int tda10021_read_status(struct dvb_frontend* fe, fe_status_t* status)
295 struct tda10021_state* state = (struct tda10021_state*) fe->demodulator_priv;
299 //0x11[0] == EQALGO -> Equalizer algorithms state
300 //0x11[1] == CARLOCK -> Carrier locked
301 //0x11[2] == FSYNC -> Frame synchronisation
302 //0x11[3] == FEL -> Front End locked
303 //0x11[6] == NODVB -> DVB Mode Information
304 sync = tda10021_readreg (state, 0x11);
307 *status |= FE_HAS_SIGNAL|FE_HAS_CARRIER;
310 *status |= FE_HAS_SYNC|FE_HAS_VITERBI;
313 *status |= FE_HAS_LOCK;
318 static int tda10021_read_ber(struct dvb_frontend* fe, u32* ber)
320 struct tda10021_state* state = (struct tda10021_state*) fe->demodulator_priv;
322 u32 _ber = tda10021_readreg(state, 0x14) |
323 (tda10021_readreg(state, 0x15) << 8) |
324 ((tda10021_readreg(state, 0x16) & 0x0f) << 16);
330 static int tda10021_read_signal_strength(struct dvb_frontend* fe, u16* strength)
332 struct tda10021_state* state = (struct tda10021_state*) fe->demodulator_priv;
334 u8 gain = tda10021_readreg(state, 0x17);
335 *strength = (gain << 8) | gain;
340 static int tda10021_read_snr(struct dvb_frontend* fe, u16* snr)
342 struct tda10021_state* state = (struct tda10021_state*) fe->demodulator_priv;
344 u8 quality = ~tda10021_readreg(state, 0x18);
345 *snr = (quality << 8) | quality;
350 static int tda10021_read_ucblocks(struct dvb_frontend* fe, u32* ucblocks)
352 struct tda10021_state* state = (struct tda10021_state*) fe->demodulator_priv;
354 *ucblocks = tda10021_readreg (state, 0x13) & 0x7f;
355 if (*ucblocks == 0x7f)
356 *ucblocks = 0xffffffff;
358 /* reset uncorrected block counter */
359 tda10021_writereg (state, 0x10, tda10021_inittab[0x10] & 0xdf);
360 tda10021_writereg (state, 0x10, tda10021_inittab[0x10]);
365 static int tda10021_get_frontend(struct dvb_frontend* fe, struct dvb_frontend_parameters *p)
367 struct tda10021_state* state = (struct tda10021_state*) fe->demodulator_priv;
371 sync = tda10021_readreg(state, 0x11);
372 afc = tda10021_readreg(state, 0x19);
374 /* AFC only valid when carrier has been recovered */
375 printk(sync & 2 ? "DVB: TDA10021(%d): AFC (%d) %dHz\n" :
376 "DVB: TDA10021(%d): [AFC (%d) %dHz]\n",
377 state->frontend.dvb->num, afc,
378 -((s32)p->u.qam.symbol_rate * afc) >> 10);
381 p->inversion = HAS_INVERSION(state->reg0) ? INVERSION_ON : INVERSION_OFF;
382 p->u.qam.modulation = ((state->reg0 >> 2) & 7) + QAM_16;
384 p->u.qam.fec_inner = FEC_NONE;
385 p->frequency = ((p->frequency + 31250) / 62500) * 62500;
388 p->frequency -= ((s32)p->u.qam.symbol_rate * afc) >> 10;
393 static int tda10021_sleep(struct dvb_frontend* fe)
395 struct tda10021_state* state = (struct tda10021_state*) fe->demodulator_priv;
397 tda10021_writereg (state, 0x1b, 0x02); /* pdown ADC */
398 tda10021_writereg (state, 0x00, 0x80); /* standby */
403 static void tda10021_release(struct dvb_frontend* fe)
405 struct tda10021_state* state = (struct tda10021_state*) fe->demodulator_priv;
409 static struct dvb_frontend_ops tda10021_ops;
411 struct dvb_frontend* tda10021_attach(const struct tda10021_config* config,
412 struct i2c_adapter* i2c,
415 struct tda10021_state* state = NULL;
417 /* allocate memory for the internal state */
418 state = (struct tda10021_state*) kmalloc(sizeof(struct tda10021_state), GFP_KERNEL);
419 if (state == NULL) goto error;
421 /* setup the state */
422 state->config = config;
424 memcpy(&state->ops, &tda10021_ops, sizeof(struct dvb_frontend_ops));
426 state->reg0 = tda10021_inittab[0];
428 /* check if the demod is there */
429 if ((tda10021_readreg(state, 0x1a) & 0xf0) != 0x70) goto error;
431 /* create dvb_frontend */
432 state->frontend.ops = &state->ops;
433 state->frontend.demodulator_priv = state;
434 return &state->frontend;
437 if (state) kfree(state);
441 static struct dvb_frontend_ops tda10021_ops = {
444 .name = "Philips TDA10021 DVB-C",
446 .frequency_stepsize = 62500,
447 .frequency_min = 51000000,
448 .frequency_max = 858000000,
449 .symbol_rate_min = (XIN/2)/64, /* SACLK/64 == (XIN/2)/64 */
450 .symbol_rate_max = (XIN/2)/4, /* SACLK/4 */
452 .frequency_tolerance = ???,
453 .symbol_rate_tolerance = ???, /* ppm */ /* == 8% (spec p. 5) */
455 .caps = 0x400 | //FE_CAN_QAM_4
456 FE_CAN_QAM_16 | FE_CAN_QAM_32 | FE_CAN_QAM_64 |
457 FE_CAN_QAM_128 | FE_CAN_QAM_256 |
461 .release = tda10021_release,
463 .init = tda10021_init,
464 .sleep = tda10021_sleep,
466 .set_frontend = tda10021_set_parameters,
467 .get_frontend = tda10021_get_frontend,
469 .read_status = tda10021_read_status,
470 .read_ber = tda10021_read_ber,
471 .read_signal_strength = tda10021_read_signal_strength,
472 .read_snr = tda10021_read_snr,
473 .read_ucblocks = tda10021_read_ucblocks,
476 module_param(verbose, int, 0644);
477 MODULE_PARM_DESC(verbose, "print AFC offset after tuning for debugging the PWM setting");
479 MODULE_DESCRIPTION("Philips TDA10021 DVB-C demodulator driver");
480 MODULE_AUTHOR("Ralph Metzler, Holger Waechtler, Markus Schulz");
481 MODULE_LICENSE("GPL");
483 EXPORT_SYMBOL(tda10021_attach);