2 * Driver for Xceive XC5000 "QAM/8VSB single chip tuner"
4 * Copyright (c) 2007 Xceive Corporation
5 * Copyright (c) 2007 Steven Toth <stoth@linuxtv.org>
6 * Copyright (c) 2009 Devin Heitmueller <dheitmueller@kernellabs.com>
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.
24 #include <linux/module.h>
25 #include <linux/moduleparam.h>
26 #include <linux/videodev2.h>
27 #include <linux/delay.h>
28 #include <linux/workqueue.h>
29 #include <linux/dvb/frontend.h>
30 #include <linux/i2c.h>
32 #include "dvb_frontend.h"
35 #include "tuner-i2c.h"
38 module_param(debug, int, 0644);
39 MODULE_PARM_DESC(debug, "Turn on/off debugging (default:off).");
41 static int no_poweroff;
42 module_param(no_poweroff, int, 0644);
43 MODULE_PARM_DESC(no_poweroff, "0 (default) powers device off when not used.\n"
44 "\t\t1 keep device energized and with tuner ready all the times.\n"
45 "\t\tFaster, but consumes more power and keeps the device hotter");
47 static DEFINE_MUTEX(xc5000_list_mutex);
48 static LIST_HEAD(hybrid_tuner_instance_list);
50 #define dprintk(level, fmt, arg...) if (debug >= level) \
51 printk(KERN_INFO "%s: " fmt, "xc5000", ## arg)
54 struct tuner_i2c_props i2c_props;
55 struct list_head hybrid_tuner_instance_list;
59 u32 freq_hz, freq_offset;
68 u8 init_status_supported;
69 u8 fw_checksum_supported;
71 struct dvb_frontend *fe;
72 struct delayed_work timer_sleep;
76 #define MAX_TV_STANDARD 24
77 #define XC_MAX_I2C_WRITE_LENGTH 64
79 /* Time to suspend after the .sleep callback is called */
80 #define XC5000_SLEEP_TIME 5000 /* ms */
83 #define XC_RF_MODE_AIR 0
84 #define XC_RF_MODE_CABLE 1
87 #define XC_PRODUCT_ID_FW_NOT_LOADED 0x2000
88 #define XC_PRODUCT_ID_FW_LOADED 0x1388
91 #define XREG_INIT 0x00
92 #define XREG_VIDEO_MODE 0x01
93 #define XREG_AUDIO_MODE 0x02
94 #define XREG_RF_FREQ 0x03
95 #define XREG_D_CODE 0x04
96 #define XREG_IF_OUT 0x05
97 #define XREG_SEEK_MODE 0x07
98 #define XREG_POWER_DOWN 0x0A /* Obsolete */
99 /* Set the output amplitude - SIF for analog, DTVP/DTVN for digital */
100 #define XREG_OUTPUT_AMP 0x0B
101 #define XREG_SIGNALSOURCE 0x0D /* 0=Air, 1=Cable */
102 #define XREG_SMOOTHEDCVBS 0x0E
103 #define XREG_XTALFREQ 0x0F
104 #define XREG_FINERFREQ 0x10
105 #define XREG_DDIMODE 0x11
107 #define XREG_ADC_ENV 0x00
108 #define XREG_QUALITY 0x01
109 #define XREG_FRAME_LINES 0x02
110 #define XREG_HSYNC_FREQ 0x03
111 #define XREG_LOCK 0x04
112 #define XREG_FREQ_ERROR 0x05
113 #define XREG_SNR 0x06
114 #define XREG_VERSION 0x07
115 #define XREG_PRODUCT_ID 0x08
116 #define XREG_BUSY 0x09
117 #define XREG_BUILD 0x0D
118 #define XREG_TOTALGAIN 0x0F
119 #define XREG_FW_CHECKSUM 0x12
120 #define XREG_INIT_STATUS 0x13
123 Basic firmware description. This will remain with
124 the driver for documentation purposes.
126 This represents an I2C firmware file encoded as a
127 string of unsigned char. Format is as follows:
129 char[0 ]=len0_MSB -> len = len_MSB * 256 + len_LSB
130 char[1 ]=len0_LSB -> length of first write transaction
131 char[2 ]=data0 -> first byte to be sent
135 char[M ]=dataN -> last byte to be sent
136 char[M+1]=len1_MSB -> len = len_MSB * 256 + len_LSB
137 char[M+2]=len1_LSB -> length of second write transaction
143 The [len] value should be interpreted as follows:
145 len= len_MSB _ len_LSB
146 len=1111_1111_1111_1111 : End of I2C_SEQUENCE
147 len=0000_0000_0000_0000 : Reset command: Do hardware reset
148 len=0NNN_NNNN_NNNN_NNNN : Normal transaction: number of bytes = {1:32767)
149 len=1WWW_WWWW_WWWW_WWWW : Wait command: wait for {1:32767} ms
151 For the RESET and WAIT commands, the two following bytes will contain
152 immediately the length of the following transaction.
155 struct XC_TV_STANDARD {
161 /* Tuner standards */
162 #define MN_NTSC_PAL_BTSC 0
163 #define MN_NTSC_PAL_A2 1
164 #define MN_NTSC_PAL_EIAJ 2
165 #define MN_NTSC_PAL_MONO 3
167 #define BG_PAL_NICAM 5
168 #define BG_PAL_MONO 6
169 #define I_PAL_NICAM 7
170 #define I_PAL_NICAM_MONO 8
172 #define DK_PAL_NICAM 10
173 #define DK_PAL_MONO 11
174 #define DK_SECAM_A2DK1 12
175 #define DK_SECAM_A2LDK3 13
176 #define DK_SECAM_A2MONO 14
177 #define L_SECAM_NICAM 15
178 #define LC_SECAM_NICAM 16
183 #define FM_RADIO_INPUT2 21
184 #define FM_RADIO_INPUT1 22
185 #define FM_RADIO_INPUT1_MONO 23
187 static struct XC_TV_STANDARD xc5000_standard[MAX_TV_STANDARD] = {
188 {"M/N-NTSC/PAL-BTSC", 0x0400, 0x8020},
189 {"M/N-NTSC/PAL-A2", 0x0600, 0x8020},
190 {"M/N-NTSC/PAL-EIAJ", 0x0440, 0x8020},
191 {"M/N-NTSC/PAL-Mono", 0x0478, 0x8020},
192 {"B/G-PAL-A2", 0x0A00, 0x8049},
193 {"B/G-PAL-NICAM", 0x0C04, 0x8049},
194 {"B/G-PAL-MONO", 0x0878, 0x8059},
195 {"I-PAL-NICAM", 0x1080, 0x8009},
196 {"I-PAL-NICAM-MONO", 0x0E78, 0x8009},
197 {"D/K-PAL-A2", 0x1600, 0x8009},
198 {"D/K-PAL-NICAM", 0x0E80, 0x8009},
199 {"D/K-PAL-MONO", 0x1478, 0x8009},
200 {"D/K-SECAM-A2 DK1", 0x1200, 0x8009},
201 {"D/K-SECAM-A2 L/DK3", 0x0E00, 0x8009},
202 {"D/K-SECAM-A2 MONO", 0x1478, 0x8009},
203 {"L-SECAM-NICAM", 0x8E82, 0x0009},
204 {"L'-SECAM-NICAM", 0x8E82, 0x4009},
205 {"DTV6", 0x00C0, 0x8002},
206 {"DTV8", 0x00C0, 0x800B},
207 {"DTV7/8", 0x00C0, 0x801B},
208 {"DTV7", 0x00C0, 0x8007},
209 {"FM Radio-INPUT2", 0x9802, 0x9002},
210 {"FM Radio-INPUT1", 0x0208, 0x9002},
211 {"FM Radio-INPUT1_MONO", 0x0278, 0x9002}
215 struct xc5000_fw_cfg {
219 u8 init_status_supported;
220 u8 fw_checksum_supported;
223 #define XC5000A_FIRMWARE "dvb-fe-xc5000-1.6.114.fw"
224 static const struct xc5000_fw_cfg xc5000a_1_6_114 = {
225 .name = XC5000A_FIRMWARE,
230 #define XC5000C_FIRMWARE "dvb-fe-xc5000c-4.1.30.7.fw"
231 static const struct xc5000_fw_cfg xc5000c_41_024_5 = {
232 .name = XC5000C_FIRMWARE,
235 .init_status_supported = 1,
236 .fw_checksum_supported = 1,
239 static inline const struct xc5000_fw_cfg *xc5000_assign_firmware(int chip_id)
244 return &xc5000a_1_6_114;
246 return &xc5000c_41_024_5;
250 static int xc_load_fw_and_init_tuner(struct dvb_frontend *fe, int force);
251 static int xc5000_is_firmware_loaded(struct dvb_frontend *fe);
252 static int xc5000_readreg(struct xc5000_priv *priv, u16 reg, u16 *val);
253 static int xc5000_tuner_reset(struct dvb_frontend *fe);
255 static int xc_send_i2c_data(struct xc5000_priv *priv, u8 *buf, int len)
257 struct i2c_msg msg = { .addr = priv->i2c_props.addr,
258 .flags = 0, .buf = buf, .len = len };
260 if (i2c_transfer(priv->i2c_props.adap, &msg, 1) != 1) {
261 printk(KERN_ERR "xc5000: I2C write failed (len=%i)\n", len);
268 /* This routine is never used because the only time we read data from the
269 i2c bus is when we read registers, and we want that to be an atomic i2c
270 transaction in case we are on a multi-master bus */
271 static int xc_read_i2c_data(struct xc5000_priv *priv, u8 *buf, int len)
273 struct i2c_msg msg = { .addr = priv->i2c_props.addr,
274 .flags = I2C_M_RD, .buf = buf, .len = len };
276 if (i2c_transfer(priv->i2c_props.adap, &msg, 1) != 1) {
277 printk(KERN_ERR "xc5000 I2C read failed (len=%i)\n", len);
284 static int xc5000_readreg(struct xc5000_priv *priv, u16 reg, u16 *val)
286 u8 buf[2] = { reg >> 8, reg & 0xff };
287 u8 bval[2] = { 0, 0 };
288 struct i2c_msg msg[2] = {
289 { .addr = priv->i2c_props.addr,
290 .flags = 0, .buf = &buf[0], .len = 2 },
291 { .addr = priv->i2c_props.addr,
292 .flags = I2C_M_RD, .buf = &bval[0], .len = 2 },
295 if (i2c_transfer(priv->i2c_props.adap, msg, 2) != 2) {
296 printk(KERN_WARNING "xc5000: I2C read failed\n");
300 *val = (bval[0] << 8) | bval[1];
304 static int xc5000_tuner_reset(struct dvb_frontend *fe)
306 struct xc5000_priv *priv = fe->tuner_priv;
309 dprintk(1, "%s()\n", __func__);
312 ret = fe->callback(((fe->dvb) && (fe->dvb->priv)) ?
314 priv->i2c_props.adap->algo_data,
315 DVB_FRONTEND_COMPONENT_TUNER,
316 XC5000_TUNER_RESET, 0);
318 printk(KERN_ERR "xc5000: reset failed\n");
322 printk(KERN_ERR "xc5000: no tuner reset callback function, fatal\n");
328 static int xc_write_reg(struct xc5000_priv *priv, u16 reg_addr, u16 i2c_data)
331 int watch_dog_timer = 100;
334 buf[0] = (reg_addr >> 8) & 0xFF;
335 buf[1] = reg_addr & 0xFF;
336 buf[2] = (i2c_data >> 8) & 0xFF;
337 buf[3] = i2c_data & 0xFF;
338 result = xc_send_i2c_data(priv, buf, 4);
340 /* wait for busy flag to clear */
341 while ((watch_dog_timer > 0) && (result == 0)) {
342 result = xc5000_readreg(priv, XREG_BUSY, (u16 *)buf);
344 if ((buf[0] == 0) && (buf[1] == 0)) {
345 /* busy flag cleared */
348 msleep(5); /* wait 5 ms */
354 if (watch_dog_timer <= 0)
360 static int xc_load_i2c_sequence(struct dvb_frontend *fe, const u8 *i2c_sequence)
362 struct xc5000_priv *priv = fe->tuner_priv;
364 int i, nbytes_to_send, result;
365 unsigned int len, pos, index;
366 u8 buf[XC_MAX_I2C_WRITE_LENGTH];
369 while ((i2c_sequence[index] != 0xFF) ||
370 (i2c_sequence[index + 1] != 0xFF)) {
371 len = i2c_sequence[index] * 256 + i2c_sequence[index+1];
374 result = xc5000_tuner_reset(fe);
378 } else if (len & 0x8000) {
380 msleep(len & 0x7FFF);
383 /* Send i2c data whilst ensuring individual transactions
384 * do not exceed XC_MAX_I2C_WRITE_LENGTH bytes.
387 buf[0] = i2c_sequence[index];
388 buf[1] = i2c_sequence[index + 1];
391 if ((len - pos) > XC_MAX_I2C_WRITE_LENGTH - 2)
393 XC_MAX_I2C_WRITE_LENGTH;
395 nbytes_to_send = (len - pos + 2);
396 for (i = 2; i < nbytes_to_send; i++) {
397 buf[i] = i2c_sequence[index + pos +
400 result = xc_send_i2c_data(priv, buf,
406 pos += nbytes_to_send - 2;
414 static int xc_initialize(struct xc5000_priv *priv)
416 dprintk(1, "%s()\n", __func__);
417 return xc_write_reg(priv, XREG_INIT, 0);
420 static int xc_set_tv_standard(struct xc5000_priv *priv,
421 u16 video_mode, u16 audio_mode, u8 radio_mode)
424 dprintk(1, "%s(0x%04x,0x%04x)\n", __func__, video_mode, audio_mode);
426 dprintk(1, "%s() Standard = %s\n",
428 xc5000_standard[radio_mode].name);
430 dprintk(1, "%s() Standard = %s\n",
432 xc5000_standard[priv->video_standard].name);
435 ret = xc_write_reg(priv, XREG_VIDEO_MODE, video_mode);
437 ret = xc_write_reg(priv, XREG_AUDIO_MODE, audio_mode);
442 static int xc_set_signal_source(struct xc5000_priv *priv, u16 rf_mode)
444 dprintk(1, "%s(%d) Source = %s\n", __func__, rf_mode,
445 rf_mode == XC_RF_MODE_AIR ? "ANTENNA" : "CABLE");
447 if ((rf_mode != XC_RF_MODE_AIR) && (rf_mode != XC_RF_MODE_CABLE)) {
448 rf_mode = XC_RF_MODE_CABLE;
450 "%s(), Invalid mode, defaulting to CABLE",
453 return xc_write_reg(priv, XREG_SIGNALSOURCE, rf_mode);
456 static const struct dvb_tuner_ops xc5000_tuner_ops;
458 static int xc_set_rf_frequency(struct xc5000_priv *priv, u32 freq_hz)
462 dprintk(1, "%s(%u)\n", __func__, freq_hz);
464 if ((freq_hz > xc5000_tuner_ops.info.frequency_max) ||
465 (freq_hz < xc5000_tuner_ops.info.frequency_min))
468 freq_code = (u16)(freq_hz / 15625);
470 /* Starting in firmware version 1.1.44, Xceive recommends using the
471 FINERFREQ for all normal tuning (the doc indicates reg 0x03 should
472 only be used for fast scanning for channel lock) */
473 return xc_write_reg(priv, XREG_FINERFREQ, freq_code);
477 static int xc_set_IF_frequency(struct xc5000_priv *priv, u32 freq_khz)
479 u32 freq_code = (freq_khz * 1024)/1000;
480 dprintk(1, "%s(freq_khz = %d) freq_code = 0x%x\n",
481 __func__, freq_khz, freq_code);
483 return xc_write_reg(priv, XREG_IF_OUT, freq_code);
487 static int xc_get_adc_envelope(struct xc5000_priv *priv, u16 *adc_envelope)
489 return xc5000_readreg(priv, XREG_ADC_ENV, adc_envelope);
492 static int xc_get_frequency_error(struct xc5000_priv *priv, u32 *freq_error_hz)
498 result = xc5000_readreg(priv, XREG_FREQ_ERROR, ®_data);
503 (*freq_error_hz) = (tmp * 15625) / 1000;
507 static int xc_get_lock_status(struct xc5000_priv *priv, u16 *lock_status)
509 return xc5000_readreg(priv, XREG_LOCK, lock_status);
512 static int xc_get_version(struct xc5000_priv *priv,
513 u8 *hw_majorversion, u8 *hw_minorversion,
514 u8 *fw_majorversion, u8 *fw_minorversion)
519 result = xc5000_readreg(priv, XREG_VERSION, &data);
523 (*hw_majorversion) = (data >> 12) & 0x0F;
524 (*hw_minorversion) = (data >> 8) & 0x0F;
525 (*fw_majorversion) = (data >> 4) & 0x0F;
526 (*fw_minorversion) = data & 0x0F;
531 static int xc_get_buildversion(struct xc5000_priv *priv, u16 *buildrev)
533 return xc5000_readreg(priv, XREG_BUILD, buildrev);
536 static int xc_get_hsync_freq(struct xc5000_priv *priv, u32 *hsync_freq_hz)
541 result = xc5000_readreg(priv, XREG_HSYNC_FREQ, ®_data);
545 (*hsync_freq_hz) = ((reg_data & 0x0fff) * 763)/100;
549 static int xc_get_frame_lines(struct xc5000_priv *priv, u16 *frame_lines)
551 return xc5000_readreg(priv, XREG_FRAME_LINES, frame_lines);
554 static int xc_get_quality(struct xc5000_priv *priv, u16 *quality)
556 return xc5000_readreg(priv, XREG_QUALITY, quality);
559 static int xc_get_analogsnr(struct xc5000_priv *priv, u16 *snr)
561 return xc5000_readreg(priv, XREG_SNR, snr);
564 static int xc_get_totalgain(struct xc5000_priv *priv, u16 *totalgain)
566 return xc5000_readreg(priv, XREG_TOTALGAIN, totalgain);
569 static u16 wait_for_lock(struct xc5000_priv *priv)
572 int watch_dog_count = 40;
574 while ((lock_state == 0) && (watch_dog_count > 0)) {
575 xc_get_lock_status(priv, &lock_state);
576 if (lock_state != 1) {
584 #define XC_TUNE_ANALOG 0
585 #define XC_TUNE_DIGITAL 1
586 static int xc_tune_channel(struct xc5000_priv *priv, u32 freq_hz, int mode)
590 dprintk(1, "%s(%u)\n", __func__, freq_hz);
592 if (xc_set_rf_frequency(priv, freq_hz) != 0)
595 if (mode == XC_TUNE_ANALOG) {
596 if (wait_for_lock(priv) == 1)
603 static int xc_set_xtal(struct dvb_frontend *fe)
605 struct xc5000_priv *priv = fe->tuner_priv;
608 switch (priv->chip_id) {
611 /* 32.000 MHz xtal is default */
614 switch (priv->xtal_khz) {
617 /* 32.000 MHz xtal is default */
620 /* 31.875 MHz xtal configuration */
621 ret = xc_write_reg(priv, 0x000f, 0x8081);
629 static int xc5000_fwupload(struct dvb_frontend *fe,
630 const struct xc5000_fw_cfg *desired_fw,
631 const struct firmware *fw)
633 struct xc5000_priv *priv = fe->tuner_priv;
636 /* request the firmware, this will block and timeout */
637 dprintk(1, "waiting for firmware upload (%s)...\n",
640 priv->pll_register_no = desired_fw->pll_reg;
641 priv->init_status_supported = desired_fw->init_status_supported;
642 priv->fw_checksum_supported = desired_fw->fw_checksum_supported;
645 dprintk(1, "firmware uploading...\n");
646 ret = xc_load_i2c_sequence(fe, fw->data);
648 ret = xc_set_xtal(fe);
649 dprintk(1, "Firmware upload complete...\n");
651 printk(KERN_ERR "xc5000: firmware upload failed...\n");
656 static void xc_debug_dump(struct xc5000_priv *priv)
659 u32 freq_error_hz = 0;
661 u32 hsync_freq_hz = 0;
666 u8 hw_majorversion = 0, hw_minorversion = 0;
667 u8 fw_majorversion = 0, fw_minorversion = 0;
668 u16 fw_buildversion = 0;
671 /* Wait for stats to stabilize.
672 * Frame Lines needs two frame times after initial lock
673 * before it is valid.
677 xc_get_adc_envelope(priv, &adc_envelope);
678 dprintk(1, "*** ADC envelope (0-1023) = %d\n", adc_envelope);
680 xc_get_frequency_error(priv, &freq_error_hz);
681 dprintk(1, "*** Frequency error = %d Hz\n", freq_error_hz);
683 xc_get_lock_status(priv, &lock_status);
684 dprintk(1, "*** Lock status (0-Wait, 1-Locked, 2-No-signal) = %d\n",
687 xc_get_version(priv, &hw_majorversion, &hw_minorversion,
688 &fw_majorversion, &fw_minorversion);
689 xc_get_buildversion(priv, &fw_buildversion);
690 dprintk(1, "*** HW: V%d.%d, FW: V %d.%d.%d\n",
691 hw_majorversion, hw_minorversion,
692 fw_majorversion, fw_minorversion, fw_buildversion);
694 xc_get_hsync_freq(priv, &hsync_freq_hz);
695 dprintk(1, "*** Horizontal sync frequency = %d Hz\n", hsync_freq_hz);
697 xc_get_frame_lines(priv, &frame_lines);
698 dprintk(1, "*** Frame lines = %d\n", frame_lines);
700 xc_get_quality(priv, &quality);
701 dprintk(1, "*** Quality (0:<8dB, 7:>56dB) = %d\n", quality & 0x07);
703 xc_get_analogsnr(priv, &snr);
704 dprintk(1, "*** Unweighted analog SNR = %d dB\n", snr & 0x3f);
706 xc_get_totalgain(priv, &totalgain);
707 dprintk(1, "*** Total gain = %d.%d dB\n", totalgain / 256,
708 (totalgain % 256) * 100 / 256);
710 if (priv->pll_register_no) {
711 xc5000_readreg(priv, priv->pll_register_no, ®val);
712 dprintk(1, "*** PLL lock status = 0x%04x\n", regval);
716 static int xc5000_tune_digital(struct dvb_frontend *fe)
718 struct xc5000_priv *priv = fe->tuner_priv;
720 u32 bw = fe->dtv_property_cache.bandwidth_hz;
722 ret = xc_set_signal_source(priv, priv->rf_mode);
725 "xc5000: xc_set_signal_source(%d) failed\n",
730 ret = xc_set_tv_standard(priv,
731 xc5000_standard[priv->video_standard].video_mode,
732 xc5000_standard[priv->video_standard].audio_mode, 0);
734 printk(KERN_ERR "xc5000: xc_set_tv_standard failed\n");
738 ret = xc_set_IF_frequency(priv, priv->if_khz);
740 printk(KERN_ERR "xc5000: xc_Set_IF_frequency(%d) failed\n",
745 xc_write_reg(priv, XREG_OUTPUT_AMP, 0x8a);
747 xc_tune_channel(priv, priv->freq_hz, XC_TUNE_DIGITAL);
752 priv->bandwidth = bw;
757 static int xc5000_set_digital_params(struct dvb_frontend *fe)
760 struct xc5000_priv *priv = fe->tuner_priv;
761 u32 bw = fe->dtv_property_cache.bandwidth_hz;
762 u32 freq = fe->dtv_property_cache.frequency;
763 u32 delsys = fe->dtv_property_cache.delivery_system;
765 if (xc_load_fw_and_init_tuner(fe, 0) != 0) {
766 dprintk(1, "Unable to load firmware and init tuner\n");
770 dprintk(1, "%s() frequency=%d (Hz)\n", __func__, freq);
774 dprintk(1, "%s() VSB modulation\n", __func__);
775 priv->rf_mode = XC_RF_MODE_AIR;
776 priv->freq_offset = 1750000;
777 priv->video_standard = DTV6;
779 case SYS_DVBC_ANNEX_B:
780 dprintk(1, "%s() QAM modulation\n", __func__);
781 priv->rf_mode = XC_RF_MODE_CABLE;
782 priv->freq_offset = 1750000;
783 priv->video_standard = DTV6;
786 /* All ISDB-T are currently for 6 MHz bw */
789 /* fall to OFDM handling */
793 dprintk(1, "%s() OFDM\n", __func__);
796 priv->video_standard = DTV6;
797 priv->freq_offset = 1750000;
800 priv->video_standard = DTV7;
801 priv->freq_offset = 2250000;
804 priv->video_standard = DTV8;
805 priv->freq_offset = 2750000;
808 printk(KERN_ERR "xc5000 bandwidth not set!\n");
811 priv->rf_mode = XC_RF_MODE_AIR;
813 case SYS_DVBC_ANNEX_A:
814 case SYS_DVBC_ANNEX_C:
815 dprintk(1, "%s() QAM modulation\n", __func__);
816 priv->rf_mode = XC_RF_MODE_CABLE;
818 priv->video_standard = DTV6;
819 priv->freq_offset = 1750000;
821 } else if (bw <= 7000000) {
822 priv->video_standard = DTV7;
823 priv->freq_offset = 2250000;
826 priv->video_standard = DTV7_8;
827 priv->freq_offset = 2750000;
830 dprintk(1, "%s() Bandwidth %dMHz (%d)\n", __func__,
834 printk(KERN_ERR "xc5000: delivery system is not supported!\n");
838 priv->freq_hz = freq - priv->freq_offset;
839 priv->mode = V4L2_TUNER_DIGITAL_TV;
841 dprintk(1, "%s() frequency=%d (compensated to %d)\n",
842 __func__, freq, priv->freq_hz);
844 return xc5000_tune_digital(fe);
847 static int xc5000_is_firmware_loaded(struct dvb_frontend *fe)
849 struct xc5000_priv *priv = fe->tuner_priv;
853 ret = xc5000_readreg(priv, XREG_PRODUCT_ID, &id);
855 if (id == XC_PRODUCT_ID_FW_NOT_LOADED)
861 dprintk(1, "%s() returns %s id = 0x%x\n", __func__,
862 ret == 0 ? "True" : "False", id);
866 static void xc5000_config_tv(struct dvb_frontend *fe,
867 struct analog_parameters *params)
869 struct xc5000_priv *priv = fe->tuner_priv;
871 dprintk(1, "%s() frequency=%d (in units of 62.5khz)\n",
872 __func__, params->frequency);
874 /* Fix me: it could be air. */
875 priv->rf_mode = params->mode;
876 if (params->mode > XC_RF_MODE_CABLE)
877 priv->rf_mode = XC_RF_MODE_CABLE;
879 /* params->frequency is in units of 62.5khz */
880 priv->freq_hz = params->frequency * 62500;
882 /* FIX ME: Some video standards may have several possible audio
883 standards. We simply default to one of them here.
885 if (params->std & V4L2_STD_MN) {
886 /* default to BTSC audio standard */
887 priv->video_standard = MN_NTSC_PAL_BTSC;
891 if (params->std & V4L2_STD_PAL_BG) {
892 /* default to NICAM audio standard */
893 priv->video_standard = BG_PAL_NICAM;
897 if (params->std & V4L2_STD_PAL_I) {
898 /* default to NICAM audio standard */
899 priv->video_standard = I_PAL_NICAM;
903 if (params->std & V4L2_STD_PAL_DK) {
904 /* default to NICAM audio standard */
905 priv->video_standard = DK_PAL_NICAM;
909 if (params->std & V4L2_STD_SECAM_DK) {
910 /* default to A2 DK1 audio standard */
911 priv->video_standard = DK_SECAM_A2DK1;
915 if (params->std & V4L2_STD_SECAM_L) {
916 priv->video_standard = L_SECAM_NICAM;
920 if (params->std & V4L2_STD_SECAM_LC) {
921 priv->video_standard = LC_SECAM_NICAM;
926 static int xc5000_set_tv_freq(struct dvb_frontend *fe)
928 struct xc5000_priv *priv = fe->tuner_priv;
933 ret = xc_set_signal_source(priv, priv->rf_mode);
936 "xc5000: xc_set_signal_source(%d) failed\n",
941 ret = xc_set_tv_standard(priv,
942 xc5000_standard[priv->video_standard].video_mode,
943 xc5000_standard[priv->video_standard].audio_mode, 0);
945 printk(KERN_ERR "xc5000: xc_set_tv_standard failed\n");
949 xc_write_reg(priv, XREG_OUTPUT_AMP, 0x09);
951 xc_tune_channel(priv, priv->freq_hz, XC_TUNE_ANALOG);
956 if (priv->pll_register_no != 0) {
958 xc5000_readreg(priv, priv->pll_register_no, &pll_lock_status);
959 if (pll_lock_status > 63) {
960 /* PLL is unlocked, force reload of the firmware */
961 dprintk(1, "xc5000: PLL not locked (0x%x). Reloading...\n",
963 if (xc_load_fw_and_init_tuner(fe, 1) != 0) {
964 printk(KERN_ERR "xc5000: Unable to reload fw\n");
974 static int xc5000_config_radio(struct dvb_frontend *fe,
975 struct analog_parameters *params)
978 struct xc5000_priv *priv = fe->tuner_priv;
980 dprintk(1, "%s() frequency=%d (in units of khz)\n",
981 __func__, params->frequency);
983 if (priv->radio_input == XC5000_RADIO_NOT_CONFIGURED) {
984 dprintk(1, "%s() radio input not configured\n", __func__);
988 priv->freq_hz = params->frequency * 125 / 2;
989 priv->rf_mode = XC_RF_MODE_AIR;
994 static int xc5000_set_radio_freq(struct dvb_frontend *fe)
996 struct xc5000_priv *priv = fe->tuner_priv;
1000 if (priv->radio_input == XC5000_RADIO_FM1)
1001 radio_input = FM_RADIO_INPUT1;
1002 else if (priv->radio_input == XC5000_RADIO_FM2)
1003 radio_input = FM_RADIO_INPUT2;
1004 else if (priv->radio_input == XC5000_RADIO_FM1_MONO)
1005 radio_input = FM_RADIO_INPUT1_MONO;
1007 dprintk(1, "%s() unknown radio input %d\n", __func__,
1012 ret = xc_set_tv_standard(priv, xc5000_standard[radio_input].video_mode,
1013 xc5000_standard[radio_input].audio_mode, radio_input);
1016 printk(KERN_ERR "xc5000: xc_set_tv_standard failed\n");
1020 ret = xc_set_signal_source(priv, priv->rf_mode);
1023 "xc5000: xc_set_signal_source(%d) failed\n",
1028 if ((priv->radio_input == XC5000_RADIO_FM1) ||
1029 (priv->radio_input == XC5000_RADIO_FM2))
1030 xc_write_reg(priv, XREG_OUTPUT_AMP, 0x09);
1031 else if (priv->radio_input == XC5000_RADIO_FM1_MONO)
1032 xc_write_reg(priv, XREG_OUTPUT_AMP, 0x06);
1034 xc_tune_channel(priv, priv->freq_hz, XC_TUNE_ANALOG);
1039 static int xc5000_set_params(struct dvb_frontend *fe)
1041 struct xc5000_priv *priv = fe->tuner_priv;
1043 switch (priv->mode) {
1044 case V4L2_TUNER_RADIO:
1045 return xc5000_set_radio_freq(fe);
1046 case V4L2_TUNER_ANALOG_TV:
1047 return xc5000_set_tv_freq(fe);
1048 case V4L2_TUNER_DIGITAL_TV:
1049 return xc5000_tune_digital(fe);
1055 static int xc5000_set_analog_params(struct dvb_frontend *fe,
1056 struct analog_parameters *params)
1058 struct xc5000_priv *priv = fe->tuner_priv;
1061 if (priv->i2c_props.adap == NULL)
1064 if (xc_load_fw_and_init_tuner(fe, 0) != 0) {
1065 dprintk(1, "Unable to load firmware and init tuner\n");
1069 switch (params->mode) {
1070 case V4L2_TUNER_RADIO:
1071 ret = xc5000_config_radio(fe, params);
1075 case V4L2_TUNER_ANALOG_TV:
1076 xc5000_config_tv(fe, params);
1081 priv->mode = params->mode;
1083 return xc5000_set_params(fe);
1086 static int xc5000_get_frequency(struct dvb_frontend *fe, u32 *freq)
1088 struct xc5000_priv *priv = fe->tuner_priv;
1089 dprintk(1, "%s()\n", __func__);
1090 *freq = priv->freq_hz + priv->freq_offset;
1094 static int xc5000_get_if_frequency(struct dvb_frontend *fe, u32 *freq)
1096 struct xc5000_priv *priv = fe->tuner_priv;
1097 dprintk(1, "%s()\n", __func__);
1098 *freq = priv->if_khz * 1000;
1102 static int xc5000_get_bandwidth(struct dvb_frontend *fe, u32 *bw)
1104 struct xc5000_priv *priv = fe->tuner_priv;
1105 dprintk(1, "%s()\n", __func__);
1107 *bw = priv->bandwidth;
1111 static int xc5000_get_status(struct dvb_frontend *fe, u32 *status)
1113 struct xc5000_priv *priv = fe->tuner_priv;
1114 u16 lock_status = 0;
1116 xc_get_lock_status(priv, &lock_status);
1118 dprintk(1, "%s() lock_status = 0x%08x\n", __func__, lock_status);
1120 *status = lock_status;
1125 static int xc_load_fw_and_init_tuner(struct dvb_frontend *fe, int force)
1127 struct xc5000_priv *priv = fe->tuner_priv;
1128 const struct xc5000_fw_cfg *desired_fw = xc5000_assign_firmware(priv->chip_id);
1129 const struct firmware *fw;
1131 u16 pll_lock_status;
1134 cancel_delayed_work(&priv->timer_sleep);
1136 if (!force && xc5000_is_firmware_loaded(fe) == 0)
1139 ret = request_firmware(&fw, desired_fw->name,
1140 priv->i2c_props.adap->dev.parent);
1142 printk(KERN_ERR "xc5000: Upload failed. (file not found?)\n");
1146 dprintk(1, "firmware read %Zu bytes.\n", fw->size);
1148 if (fw->size != desired_fw->size) {
1149 printk(KERN_ERR "xc5000: Firmware file with incorrect size\n");
1154 /* Try up to 5 times to load firmware */
1155 for (i = 0; i < 5; i++) {
1157 printk(KERN_CONT " - retrying to upload firmware.\n");
1159 ret = xc5000_fwupload(fe, desired_fw, fw);
1165 if (priv->fw_checksum_supported) {
1166 if (xc5000_readreg(priv, XREG_FW_CHECKSUM, &fw_ck)) {
1168 "xc5000: FW checksum reading failed.");
1174 "xc5000: FW checksum failed = 0x%04x.",
1180 /* Start the tuner self-calibration process */
1181 ret = xc_initialize(priv);
1184 "xc5000: Can't request Self-callibration.");
1188 /* Wait for calibration to complete.
1189 * We could continue but XC5000 will clock stretch subsequent
1190 * I2C transactions until calibration is complete. This way we
1191 * don't have to rely on clock stretching working.
1195 if (priv->init_status_supported) {
1196 if (xc5000_readreg(priv, XREG_INIT_STATUS, &fw_ck)) {
1198 "xc5000: FW failed reading init status.");
1204 "xc5000: FW init status failed = 0x%04x.",
1210 if (priv->pll_register_no) {
1211 xc5000_readreg(priv, priv->pll_register_no,
1213 if (pll_lock_status > 63) {
1214 /* PLL is unlocked, force reload of the firmware */
1216 "xc5000: PLL not running after fwload.");
1221 /* Default to "CABLE" mode */
1222 ret = xc_write_reg(priv, XREG_SIGNALSOURCE, XC_RF_MODE_CABLE);
1225 printk(KERN_ERR "xc5000: can't set to cable mode.");
1230 printk(KERN_INFO "xc5000: Firmware %s loaded and running.\n",
1233 printk(KERN_CONT " - too many retries. Giving up\n");
1235 release_firmware(fw);
1239 static void xc5000_do_timer_sleep(struct work_struct *timer_sleep)
1241 struct xc5000_priv *priv =container_of(timer_sleep, struct xc5000_priv,
1243 struct dvb_frontend *fe = priv->fe;
1246 dprintk(1, "%s()\n", __func__);
1248 /* According to Xceive technical support, the "powerdown" register
1249 was removed in newer versions of the firmware. The "supported"
1250 way to sleep the tuner is to pull the reset pin low for 10ms */
1251 ret = xc5000_tuner_reset(fe);
1254 "xc5000: %s() unable to shutdown tuner\n",
1258 static int xc5000_sleep(struct dvb_frontend *fe)
1260 struct xc5000_priv *priv = fe->tuner_priv;
1262 dprintk(1, "%s()\n", __func__);
1264 /* Avoid firmware reload on slow devices */
1268 schedule_delayed_work(&priv->timer_sleep,
1269 msecs_to_jiffies(XC5000_SLEEP_TIME));
1274 static int xc5000_suspend(struct dvb_frontend *fe)
1276 struct xc5000_priv *priv = fe->tuner_priv;
1279 dprintk(1, "%s()\n", __func__);
1281 cancel_delayed_work(&priv->timer_sleep);
1283 ret = xc5000_tuner_reset(fe);
1286 "xc5000: %s() unable to shutdown tuner\n",
1292 static int xc5000_init(struct dvb_frontend *fe)
1294 struct xc5000_priv *priv = fe->tuner_priv;
1295 dprintk(1, "%s()\n", __func__);
1297 if (xc_load_fw_and_init_tuner(fe, 0) != 0) {
1298 printk(KERN_ERR "xc5000: Unable to initialise tuner\n");
1303 xc_debug_dump(priv);
1308 static int xc5000_release(struct dvb_frontend *fe)
1310 struct xc5000_priv *priv = fe->tuner_priv;
1312 dprintk(1, "%s()\n", __func__);
1314 mutex_lock(&xc5000_list_mutex);
1317 cancel_delayed_work(&priv->timer_sleep);
1318 hybrid_tuner_release_state(priv);
1321 mutex_unlock(&xc5000_list_mutex);
1323 fe->tuner_priv = NULL;
1328 static int xc5000_set_config(struct dvb_frontend *fe, void *priv_cfg)
1330 struct xc5000_priv *priv = fe->tuner_priv;
1331 struct xc5000_config *p = priv_cfg;
1333 dprintk(1, "%s()\n", __func__);
1336 priv->if_khz = p->if_khz;
1339 priv->radio_input = p->radio_input;
1345 static const struct dvb_tuner_ops xc5000_tuner_ops = {
1347 .name = "Xceive XC5000",
1348 .frequency_min = 1000000,
1349 .frequency_max = 1023000000,
1350 .frequency_step = 50000,
1353 .release = xc5000_release,
1354 .init = xc5000_init,
1355 .sleep = xc5000_sleep,
1356 .suspend = xc5000_suspend,
1357 .resume = xc5000_set_params,
1359 .set_config = xc5000_set_config,
1360 .set_params = xc5000_set_digital_params,
1361 .set_analog_params = xc5000_set_analog_params,
1362 .get_frequency = xc5000_get_frequency,
1363 .get_if_frequency = xc5000_get_if_frequency,
1364 .get_bandwidth = xc5000_get_bandwidth,
1365 .get_status = xc5000_get_status
1368 struct dvb_frontend *xc5000_attach(struct dvb_frontend *fe,
1369 struct i2c_adapter *i2c,
1370 const struct xc5000_config *cfg)
1372 struct xc5000_priv *priv = NULL;
1376 dprintk(1, "%s(%d-%04x)\n", __func__,
1377 i2c ? i2c_adapter_id(i2c) : -1,
1378 cfg ? cfg->i2c_address : -1);
1380 mutex_lock(&xc5000_list_mutex);
1382 instance = hybrid_tuner_request_state(struct xc5000_priv, priv,
1383 hybrid_tuner_instance_list,
1384 i2c, cfg->i2c_address, "xc5000");
1389 /* new tuner instance */
1390 priv->bandwidth = 6000000;
1391 fe->tuner_priv = priv;
1393 INIT_DELAYED_WORK(&priv->timer_sleep, xc5000_do_timer_sleep);
1396 /* existing tuner instance */
1397 fe->tuner_priv = priv;
1401 if (priv->if_khz == 0) {
1402 /* If the IF hasn't been set yet, use the value provided by
1403 the caller (occurs in hybrid devices where the analog
1404 call to xc5000_attach occurs before the digital side) */
1405 priv->if_khz = cfg->if_khz;
1408 if (priv->xtal_khz == 0)
1409 priv->xtal_khz = cfg->xtal_khz;
1411 if (priv->radio_input == 0)
1412 priv->radio_input = cfg->radio_input;
1414 /* don't override chip id if it's already been set
1415 unless explicitly specified */
1416 if ((priv->chip_id == 0) || (cfg->chip_id))
1417 /* use default chip id if none specified, set to 0 so
1418 it can be overridden if this is a hybrid driver */
1419 priv->chip_id = (cfg->chip_id) ? cfg->chip_id : 0;
1421 /* Check if firmware has been loaded. It is possible that another
1422 instance of the driver has loaded the firmware.
1424 if (xc5000_readreg(priv, XREG_PRODUCT_ID, &id) != 0)
1428 case XC_PRODUCT_ID_FW_LOADED:
1430 "xc5000: Successfully identified at address 0x%02x\n",
1433 "xc5000: Firmware has been loaded previously\n");
1435 case XC_PRODUCT_ID_FW_NOT_LOADED:
1437 "xc5000: Successfully identified at address 0x%02x\n",
1440 "xc5000: Firmware has not been loaded previously\n");
1444 "xc5000: Device not found at addr 0x%02x (0x%x)\n",
1445 cfg->i2c_address, id);
1449 mutex_unlock(&xc5000_list_mutex);
1451 memcpy(&fe->ops.tuner_ops, &xc5000_tuner_ops,
1452 sizeof(struct dvb_tuner_ops));
1456 mutex_unlock(&xc5000_list_mutex);
1461 EXPORT_SYMBOL(xc5000_attach);
1463 MODULE_AUTHOR("Steven Toth");
1464 MODULE_DESCRIPTION("Xceive xc5000 silicon tuner driver");
1465 MODULE_LICENSE("GPL");
1466 MODULE_FIRMWARE(XC5000A_FIRMWARE);
1467 MODULE_FIRMWARE(XC5000C_FIRMWARE);