2 cx24110 - Single Chip Satellite Channel Receiver driver module
4 Copyright (C) 2002 Peter Hettkamp <peter.hettkamp@htp-tel.de> based on
6 Copyright (C) 1999 Convergence Integrated Media GmbH <ralph@convergence.de>
8 This program is free software; you can redistribute it and/or modify
9 it under the terms of the GNU General Public License as published by
10 the Free Software Foundation; either version 2 of the License, or
11 (at your option) any later version.
13 This program is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 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.
25 #include <linux/slab.h>
26 #include <linux/kernel.h>
27 #include <linux/module.h>
28 #include <linux/moduleparam.h>
29 #include <linux/init.h>
31 #include "dvb_frontend.h"
35 struct cx24110_state {
37 struct i2c_adapter* i2c;
39 struct dvb_frontend_ops ops;
41 const struct cx24110_config* config;
43 struct dvb_frontend frontend;
51 #define dprintk(args...) \
53 if (debug) printk(KERN_DEBUG "cx24110: " args); \
56 static struct {u8 reg; u8 data;} cx24110_regdata[]=
57 /* Comments beginning with @ denote this value should
59 {{0x09,0x01}, /* SoftResetAll */
60 {0x09,0x00}, /* release reset */
61 {0x01,0xe8}, /* MSB of code rate 27.5MS/s */
62 {0x02,0x17}, /* middle byte " */
63 {0x03,0x29}, /* LSB " */
64 {0x05,0x03}, /* @ DVB mode, standard code rate 3/4 */
65 {0x06,0xa5}, /* @ PLL 60MHz */
66 {0x07,0x01}, /* @ Fclk, i.e. sampling clock, 60MHz */
67 {0x0a,0x00}, /* @ partial chip disables, do not set */
68 {0x0b,0x01}, /* set output clock in gapped mode, start signal low
69 active for first byte */
70 {0x0c,0x11}, /* no parity bytes, large hold time, serial data out */
71 {0x0d,0x6f}, /* @ RS Sync/Unsync thresholds */
72 {0x10,0x40}, /* chip doc is misleading here: write bit 6 as 1
73 to avoid starting the BER counter. Reset the
74 CRC test bit. Finite counting selected */
75 {0x15,0xff}, /* @ size of the limited time window for RS BER
76 estimation. It is <value>*256 RS blocks, this
77 gives approx. 2.6 sec at 27.5MS/s, rate 3/4 */
78 {0x16,0x00}, /* @ enable all RS output ports */
79 {0x17,0x04}, /* @ time window allowed for the RS to sync */
80 {0x18,0xae}, /* @ allow all standard DVB code rates to be scanned
82 /* leave the current code rate and normalization
83 registers as they are after reset... */
84 {0x21,0x10}, /* @ during AutoAcq, search each viterbi setting
86 {0x23,0x18}, /* @ size of the limited time window for Viterbi BER
87 estimation. It is <value>*65536 channel bits, i.e.
88 approx. 38ms at 27.5MS/s, rate 3/4 */
89 {0x24,0x24}, /* do not trigger Viterbi CRC test. Finite count window */
90 /* leave front-end AGC parameters at default values */
91 /* leave decimation AGC parameters at default values */
92 {0x35,0x40}, /* disable all interrupts. They are not connected anyway */
93 {0x36,0xff}, /* clear all interrupt pending flags */
94 {0x37,0x00}, /* @ fully enable AutoAcqq state machine */
95 {0x38,0x07}, /* @ enable fade recovery, but not autostart AutoAcq */
96 /* leave the equalizer parameters on their default values */
97 /* leave the final AGC parameters on their default values */
98 {0x41,0x00}, /* @ MSB of front-end derotator frequency */
99 {0x42,0x00}, /* @ middle bytes " */
100 {0x43,0x00}, /* @ LSB " */
101 /* leave the carrier tracking loop parameters on default */
102 /* leave the bit timing loop parameters at gefault */
103 {0x56,0x4d}, /* set the filtune voltage to 2.7V, as recommended by */
104 /* the cx24108 data sheet for symbol rates above 15MS/s */
105 {0x57,0x00}, /* @ Filter sigma delta enabled, positive */
106 {0x61,0x95}, /* GPIO pins 1-4 have special function */
107 {0x62,0x05}, /* GPIO pin 5 has special function, pin 6 is GPIO */
108 {0x63,0x00}, /* All GPIO pins use CMOS output characteristics */
109 {0x64,0x20}, /* GPIO 6 is input, all others are outputs */
110 {0x6d,0x30}, /* tuner auto mode clock freq 62kHz */
111 {0x70,0x15}, /* use auto mode, tuner word is 21 bits long */
112 {0x73,0x00}, /* @ disable several demod bypasses */
113 {0x74,0x00}, /* @ " */
114 {0x75,0x00} /* @ " */
115 /* the remaining registers are for SEC */
119 static int cx24110_writereg (struct cx24110_state* state, int reg, int data)
121 u8 buf [] = { reg, data };
122 struct i2c_msg msg = { .addr = state->config->demod_address, .flags = 0, .buf = buf, .len = 2 };
125 if ((err = i2c_transfer(state->i2c, &msg, 1)) != 1) {
126 dprintk ("%s: writereg error (err == %i, reg == 0x%02x,"
127 " data == 0x%02x)\n", __FUNCTION__, err, reg, data);
134 static int cx24110_readreg (struct cx24110_state* state, u8 reg)
139 struct i2c_msg msg [] = { { .addr = state->config->demod_address, .flags = 0, .buf = b0, .len = 1 },
140 { .addr = state->config->demod_address, .flags = I2C_M_RD, .buf = b1, .len = 1 } };
142 ret = i2c_transfer(state->i2c, msg, 2);
144 if (ret != 2) return ret;
149 static int cx24110_set_inversion (struct cx24110_state* state, fe_spectral_inversion_t inversion)
151 /* fixme (low): error handling */
155 cx24110_writereg(state,0x37,cx24110_readreg(state,0x37)|0x1);
156 /* AcqSpectrInvDis on. No idea why someone should want this */
157 cx24110_writereg(state,0x5,cx24110_readreg(state,0x5)&0xf7);
158 /* Initial value 0 at start of acq */
159 cx24110_writereg(state,0x22,cx24110_readreg(state,0x22)&0xef);
160 /* current value 0 */
161 /* The cx24110 manual tells us this reg is read-only.
162 But what the heck... set it ayways */
165 cx24110_writereg(state,0x37,cx24110_readreg(state,0x37)|0x1);
166 /* AcqSpectrInvDis on. No idea why someone should want this */
167 cx24110_writereg(state,0x5,cx24110_readreg(state,0x5)|0x08);
168 /* Initial value 1 at start of acq */
169 cx24110_writereg(state,0x22,cx24110_readreg(state,0x22)|0x10);
170 /* current value 1 */
173 cx24110_writereg(state,0x37,cx24110_readreg(state,0x37)&0xfe);
174 /* AcqSpectrInvDis off. Leave initial & current states as is */
183 static int cx24110_set_fec (struct cx24110_state* state, fe_code_rate_t fec)
185 /* fixme (low): error handling */
187 static const int rate[]={-1,1,2,3,5,7,-1};
188 static const int g1[]={-1,0x01,0x02,0x05,0x15,0x45,-1};
189 static const int g2[]={-1,0x01,0x03,0x06,0x1a,0x7a,-1};
191 /* Well, the AutoAcq engine of the cx24106 and 24110 automatically
192 searches all enabled viterbi rates, and can handle non-standard
198 if (fec==FEC_AUTO) { /* (re-)establish AutoAcq behaviour */
199 cx24110_writereg(state,0x37,cx24110_readreg(state,0x37)&0xdf);
200 /* clear AcqVitDis bit */
201 cx24110_writereg(state,0x18,0xae);
202 /* allow all DVB standard code rates */
203 cx24110_writereg(state,0x05,(cx24110_readreg(state,0x05)&0xf0)|0x3);
204 /* set nominal Viterbi rate 3/4 */
205 cx24110_writereg(state,0x22,(cx24110_readreg(state,0x22)&0xf0)|0x3);
206 /* set current Viterbi rate 3/4 */
207 cx24110_writereg(state,0x1a,0x05); cx24110_writereg(state,0x1b,0x06);
208 /* set the puncture registers for code rate 3/4 */
211 cx24110_writereg(state,0x37,cx24110_readreg(state,0x37)|0x20);
212 /* set AcqVitDis bit */
214 cx24110_writereg(state,0x05,(cx24110_readreg(state,0x05)&0xf0)|rate[fec]);
215 /* set nominal Viterbi rate */
216 cx24110_writereg(state,0x22,(cx24110_readreg(state,0x22)&0xf0)|rate[fec]);
217 /* set current Viterbi rate */
218 cx24110_writereg(state,0x1a,g1[fec]);
219 cx24110_writereg(state,0x1b,g2[fec]);
220 /* not sure if this is the right way: I always used AutoAcq mode */
223 /* fixme (low): which is the correct return code? */
228 static fe_code_rate_t cx24110_get_fec (struct cx24110_state* state)
232 i=cx24110_readreg(state,0x22)&0x0f;
234 return FEC_1_2 + i - 1;
236 /* fixme (low): a special code rate has been selected. In theory, we need to
237 return a denominator value, a numerator value, and a pair of puncture
238 maps to correctly describe this mode. But this should never happen in
239 practice, because it cannot be set by cx24110_get_fec. */
244 static int cx24110_set_symbolrate (struct cx24110_state* state, u32 srate)
246 /* fixme (low): add error handling */
250 static const u32 bands[]={5000000UL,15000000UL,90999000UL/2};
253 dprintk("cx24110 debug: entering %s(%d)\n",__FUNCTION__,srate);
254 if (srate>90999000UL/2)
259 for(i=0;(i<sizeof(bands)/sizeof(bands[0]))&&(srate>bands[i]);i++)
261 /* first, check which sample rate is appropriate: 45, 60 80 or 90 MHz,
262 and set the PLL accordingly (R07[1:0] Fclk, R06[7:4] PLLmult,
263 R06[3:0] PLLphaseDetGain */
264 tmp=cx24110_readreg(state,0x07)&0xfc;
265 if(srate<90999000UL/4) { /* sample rate 45MHz*/
266 cx24110_writereg(state,0x07,tmp);
267 cx24110_writereg(state,0x06,0x78);
269 } else if(srate<60666000UL/2) { /* sample rate 60MHz */
270 cx24110_writereg(state,0x07,tmp|0x1);
271 cx24110_writereg(state,0x06,0xa5);
273 } else if(srate<80888000UL/2) { /* sample rate 80MHz */
274 cx24110_writereg(state,0x07,tmp|0x2);
275 cx24110_writereg(state,0x06,0x87);
277 } else { /* sample rate 90MHz */
278 cx24110_writereg(state,0x07,tmp|0x3);
279 cx24110_writereg(state,0x06,0x78);
282 dprintk("cx24110 debug: fclk %d Hz\n",fclk);
283 /* we need to divide two integers with approx. 27 bits in 32 bit
284 arithmetic giving a 25 bit result */
285 /* the maximum dividend is 90999000/2, 0x02b6446c, this number is
286 also the most complex divisor. Hence, the dividend has,
287 assuming 32bit unsigned arithmetic, 6 clear bits on top, the
288 divisor 2 unused bits at the bottom. Also, the quotient is
289 always less than 1/2. Borrowed from VES1893.c, of course */
296 ratio=(ratio<<8)+(tmp/BDRI);
299 ratio=(ratio<<8)+(tmp/BDRI);
302 ratio=(ratio<<1)+(tmp/BDRI);
304 dprintk("srate= %d (range %d, up to %d)\n", srate,i,bands[i]);
305 dprintk("fclk = %d\n", fclk);
306 dprintk("ratio= %08x\n", ratio);
308 cx24110_writereg(state, 0x1, (ratio>>16)&0xff);
309 cx24110_writereg(state, 0x2, (ratio>>8)&0xff);
310 cx24110_writereg(state, 0x3, (ratio)&0xff);
316 int cx24110_pll_write (struct dvb_frontend* fe, u32 data)
318 struct cx24110_state *state = fe->demodulator_priv;
320 /* tuner data is 21 bits long, must be left-aligned in data */
321 /* tuner cx24108 is written through a dedicated 3wire interface on the demod chip */
322 /* FIXME (low): add error handling, avoid infinite loops if HW fails... */
324 dprintk("cx24110 debug: cx24108_write(%8.8x)\n",data);
326 cx24110_writereg(state,0x6d,0x30); /* auto mode at 62kHz */
327 cx24110_writereg(state,0x70,0x15); /* auto mode 21 bits */
329 /* if the auto tuner writer is still busy, clear it out */
330 while (cx24110_readreg(state,0x6d)&0x80)
331 cx24110_writereg(state,0x72,0);
333 /* write the topmost 8 bits */
334 cx24110_writereg(state,0x72,(data>>24)&0xff);
336 /* wait for the send to be completed */
337 while ((cx24110_readreg(state,0x6d)&0xc0)==0x80)
340 /* send another 8 bytes */
341 cx24110_writereg(state,0x72,(data>>16)&0xff);
342 while ((cx24110_readreg(state,0x6d)&0xc0)==0x80)
345 /* and the topmost 5 bits of this byte */
346 cx24110_writereg(state,0x72,(data>>8)&0xff);
347 while ((cx24110_readreg(state,0x6d)&0xc0)==0x80)
350 /* now strobe the enable line once */
351 cx24110_writereg(state,0x6d,0x32);
352 cx24110_writereg(state,0x6d,0x30);
357 static int cx24110_initfe(struct dvb_frontend* fe)
359 struct cx24110_state *state = fe->demodulator_priv;
360 /* fixme (low): error handling */
363 dprintk("%s: init chip\n", __FUNCTION__);
365 for(i=0;i<sizeof(cx24110_regdata)/sizeof(cx24110_regdata[0]);i++) {
366 cx24110_writereg(state, cx24110_regdata[i].reg, cx24110_regdata[i].data);
369 if (state->config->pll_init) state->config->pll_init(fe);
374 static int cx24110_sleep(struct dvb_frontend *fe)
376 struct cx24110_state *state = fe->demodulator_priv;
378 if (state->config->pll_sleep)
379 return state->config->pll_sleep(fe);
383 static int cx24110_set_voltage (struct dvb_frontend* fe, fe_sec_voltage_t voltage)
385 struct cx24110_state *state = fe->demodulator_priv;
389 return cx24110_writereg(state,0x76,(cx24110_readreg(state,0x76)&0x3b)|0xc0);
391 return cx24110_writereg(state,0x76,(cx24110_readreg(state,0x76)&0x3b)|0x40);
397 static int cx24110_diseqc_send_burst(struct dvb_frontend* fe, fe_sec_mini_cmd_t burst)
400 struct cx24110_state *state = fe->demodulator_priv;
401 unsigned long timeout;
403 if (burst == SEC_MINI_A)
405 else if (burst == SEC_MINI_B)
410 rv = cx24110_readreg(state, 0x77);
412 cx24110_writereg(state, 0x77, rv | 0x04);
414 rv = cx24110_readreg(state, 0x76);
415 cx24110_writereg(state, 0x76, ((rv & 0x90) | 0x40 | bit));
416 timeout = jiffies + msecs_to_jiffies(100);
417 while (!time_after(jiffies, timeout) && !(cx24110_readreg(state, 0x76) & 0x40))
418 ; /* wait for LNB ready */
423 static int cx24110_send_diseqc_msg(struct dvb_frontend* fe,
424 struct dvb_diseqc_master_cmd *cmd)
427 struct cx24110_state *state = fe->demodulator_priv;
428 unsigned long timeout;
430 if (cmd->msg_len < 3 || cmd->msg_len > 6)
431 return -EINVAL; /* not implemented */
433 for (i = 0; i < cmd->msg_len; i++)
434 cx24110_writereg(state, 0x79 + i, cmd->msg[i]);
436 rv = cx24110_readreg(state, 0x77);
438 cx24110_writereg(state, 0x77, rv & ~0x04);
439 msleep(30); /* reportedly fixes switching problems */
442 rv = cx24110_readreg(state, 0x76);
444 cx24110_writereg(state, 0x76, ((rv & 0x90) | 0x40) | ((cmd->msg_len-3) & 3));
445 timeout = jiffies + msecs_to_jiffies(100);
446 while (!time_after(jiffies, timeout) && !(cx24110_readreg(state, 0x76) & 0x40))
447 ; /* wait for LNB ready */
452 static int cx24110_read_status(struct dvb_frontend* fe, fe_status_t* status)
454 struct cx24110_state *state = fe->demodulator_priv;
456 int sync = cx24110_readreg (state, 0x55);
461 *status |= FE_HAS_SIGNAL;
464 *status |= FE_HAS_CARRIER;
466 sync = cx24110_readreg (state, 0x08);
469 *status |= FE_HAS_VITERBI;
472 *status |= FE_HAS_SYNC;
474 if ((sync & 0x60) == 0x60)
475 *status |= FE_HAS_LOCK;
480 static int cx24110_read_ber(struct dvb_frontend* fe, u32* ber)
482 struct cx24110_state *state = fe->demodulator_priv;
484 /* fixme (maybe): value range is 16 bit. Scale? */
485 if(cx24110_readreg(state,0x24)&0x10) {
486 /* the Viterbi error counter has finished one counting window */
487 cx24110_writereg(state,0x24,0x04); /* select the ber reg */
488 state->lastber=cx24110_readreg(state,0x25)|
489 (cx24110_readreg(state,0x26)<<8);
490 cx24110_writereg(state,0x24,0x04); /* start new count window */
491 cx24110_writereg(state,0x24,0x14);
493 *ber = state->lastber;
498 static int cx24110_read_signal_strength(struct dvb_frontend* fe, u16* signal_strength)
500 struct cx24110_state *state = fe->demodulator_priv;
502 /* no provision in hardware. Read the frontend AGC accumulator. No idea how to scale this, but I know it is 2s complement */
503 u8 signal = cx24110_readreg (state, 0x27)+128;
504 *signal_strength = (signal << 8) | signal;
509 static int cx24110_read_snr(struct dvb_frontend* fe, u16* snr)
511 struct cx24110_state *state = fe->demodulator_priv;
513 /* no provision in hardware. Can be computed from the Es/N0 estimator, but I don't know how. */
514 if(cx24110_readreg(state,0x6a)&0x80) {
515 /* the Es/N0 error counter has finished one counting window */
516 state->lastesn0=cx24110_readreg(state,0x69)|
517 (cx24110_readreg(state,0x68)<<8);
518 cx24110_writereg(state,0x6a,0x84); /* start new count window */
520 *snr = state->lastesn0;
525 static int cx24110_read_ucblocks(struct dvb_frontend* fe, u32* ucblocks)
527 struct cx24110_state *state = fe->demodulator_priv;
530 if(cx24110_readreg(state,0x10)&0x40) {
531 /* the RS error counter has finished one counting window */
532 cx24110_writereg(state,0x10,0x60); /* select the byer reg */
533 lastbyer=cx24110_readreg(state,0x12)|
534 (cx24110_readreg(state,0x13)<<8)|
535 (cx24110_readreg(state,0x14)<<16);
536 cx24110_writereg(state,0x10,0x70); /* select the bler reg */
537 state->lastbler=cx24110_readreg(state,0x12)|
538 (cx24110_readreg(state,0x13)<<8)|
539 (cx24110_readreg(state,0x14)<<16);
540 cx24110_writereg(state,0x10,0x20); /* start new count window */
542 *ucblocks = state->lastbler;
547 static int cx24110_set_frontend(struct dvb_frontend* fe, struct dvb_frontend_parameters *p)
549 struct cx24110_state *state = fe->demodulator_priv;
551 state->config->pll_set(fe, p);
552 cx24110_set_inversion (state, p->inversion);
553 cx24110_set_fec (state, p->u.qpsk.fec_inner);
554 cx24110_set_symbolrate (state, p->u.qpsk.symbol_rate);
555 cx24110_writereg(state,0x04,0x05); /* start aquisition */
560 static int cx24110_get_frontend(struct dvb_frontend* fe, struct dvb_frontend_parameters *p)
562 struct cx24110_state *state = fe->demodulator_priv;
563 s32 afc; unsigned sclk;
565 /* cannot read back tuner settings (freq). Need to have some private storage */
567 sclk = cx24110_readreg (state, 0x07) & 0x03;
568 /* ok, real AFC (FEDR) freq. is afc/2^24*fsamp, fsamp=45/60/80/90MHz.
569 * Need 64 bit arithmetic. Is thiss possible in the kernel? */
570 if (sclk==0) sclk=90999000L/2L;
571 else if (sclk==1) sclk=60666000L;
572 else if (sclk==2) sclk=80888000L;
575 afc = sclk*(cx24110_readreg (state, 0x44)&0x1f)+
576 ((sclk*cx24110_readreg (state, 0x45))>>8)+
577 ((sclk*cx24110_readreg (state, 0x46))>>16);
580 p->inversion = (cx24110_readreg (state, 0x22) & 0x10) ?
581 INVERSION_ON : INVERSION_OFF;
582 p->u.qpsk.fec_inner = cx24110_get_fec (state);
587 static int cx24110_set_tone(struct dvb_frontend* fe, fe_sec_tone_mode_t tone)
589 struct cx24110_state *state = fe->demodulator_priv;
591 return cx24110_writereg(state,0x76,(cx24110_readreg(state,0x76)&~0x10)|(((tone==SEC_TONE_ON))?0x10:0));
594 static void cx24110_release(struct dvb_frontend* fe)
596 struct cx24110_state* state = fe->demodulator_priv;
600 static struct dvb_frontend_ops cx24110_ops;
602 struct dvb_frontend* cx24110_attach(const struct cx24110_config* config,
603 struct i2c_adapter* i2c)
605 struct cx24110_state* state = NULL;
608 /* allocate memory for the internal state */
609 state = kmalloc(sizeof(struct cx24110_state), GFP_KERNEL);
610 if (state == NULL) goto error;
612 /* setup the state */
613 state->config = config;
615 memcpy(&state->ops, &cx24110_ops, sizeof(struct dvb_frontend_ops));
620 /* check if the demod is there */
621 ret = cx24110_readreg(state, 0x00);
622 if ((ret != 0x5a) && (ret != 0x69)) goto error;
624 /* create dvb_frontend */
625 state->frontend.ops = &state->ops;
626 state->frontend.demodulator_priv = state;
627 return &state->frontend;
634 static struct dvb_frontend_ops cx24110_ops = {
637 .name = "Conexant CX24110 DVB-S",
639 .frequency_min = 950000,
640 .frequency_max = 2150000,
641 .frequency_stepsize = 1011, /* kHz for QPSK frontends */
642 .frequency_tolerance = 29500,
643 .symbol_rate_min = 1000000,
644 .symbol_rate_max = 45000000,
645 .caps = FE_CAN_INVERSION_AUTO |
646 FE_CAN_FEC_1_2 | FE_CAN_FEC_2_3 | FE_CAN_FEC_3_4 |
647 FE_CAN_FEC_5_6 | FE_CAN_FEC_7_8 | FE_CAN_FEC_AUTO |
648 FE_CAN_QPSK | FE_CAN_RECOVER
651 .release = cx24110_release,
653 .init = cx24110_initfe,
654 .sleep = cx24110_sleep,
655 .set_frontend = cx24110_set_frontend,
656 .get_frontend = cx24110_get_frontend,
657 .read_status = cx24110_read_status,
658 .read_ber = cx24110_read_ber,
659 .read_signal_strength = cx24110_read_signal_strength,
660 .read_snr = cx24110_read_snr,
661 .read_ucblocks = cx24110_read_ucblocks,
663 .diseqc_send_master_cmd = cx24110_send_diseqc_msg,
664 .set_tone = cx24110_set_tone,
665 .set_voltage = cx24110_set_voltage,
666 .diseqc_send_burst = cx24110_diseqc_send_burst,
669 module_param(debug, int, 0644);
670 MODULE_PARM_DESC(debug, "Turn on/off frontend debugging (default:off).");
672 MODULE_DESCRIPTION("Conexant CX24110 DVB-S Demodulator driver");
673 MODULE_AUTHOR("Peter Hettkamp");
674 MODULE_LICENSE("GPL");
676 EXPORT_SYMBOL(cx24110_attach);
677 EXPORT_SYMBOL(cx24110_pll_write);