2 * Driver for Xceive XC4000 "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>
7 * Copyright (c) 2009 Davide Ferri <d.ferri@zero11.it>
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
18 * GNU General Public License for more details.
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.
25 #include <linux/module.h>
26 #include <linux/moduleparam.h>
27 #include <linux/videodev2.h>
28 #include <linux/delay.h>
29 #include <linux/dvb/frontend.h>
30 #include <linux/i2c.h>
31 #include <asm/unaligned.h>
33 #include "dvb_frontend.h"
36 #include "tuner-i2c.h"
37 #include "tuner-xc2028-types.h"
40 module_param(debug, int, 0644);
41 MODULE_PARM_DESC(debug, "Turn on/off debugging (default:off).");
43 static int no_poweroff;
44 module_param(no_poweroff, int, 0644);
45 MODULE_PARM_DESC(no_poweroff, "0 (default) powers device off when not used.\n"
46 "\t\t1 keep device energized and with tuner ready all the times.\n"
47 "\t\tFaster, but consumes more power and keeps the device hotter");
49 static DEFINE_MUTEX(xc4000_list_mutex);
50 static LIST_HEAD(hybrid_tuner_instance_list);
52 #define dprintk(level, fmt, arg...) if (debug >= level) \
53 printk(KERN_INFO "%s: " fmt, "xc4000", ## arg)
55 /* Note that the last version digit is my internal build number (so I can
56 rev the firmware even if the core Xceive firmware was unchanged) */
57 #define XC4000_DEFAULT_FIRMWARE "dvb-fe-xc4000-1.4.1.fw"
59 /* struct for storing firmware table */
60 struct firmware_description {
68 struct firmware_properties {
73 unsigned int scode_table;
78 struct tuner_i2c_props i2c_props;
79 struct list_head hybrid_tuner_instance_list;
80 struct firmware_description *firm;
88 u8 ignore_i2c_write_errors;
89 /* struct xc2028_ctrl ctrl; */
90 struct firmware_properties cur_fw;
96 #define MAX_TV_STANDARD 24
97 #define XC_MAX_I2C_WRITE_LENGTH 64
100 #define XC_RF_MODE_AIR 0
101 #define XC_RF_MODE_CABLE 1
104 #define XC_RESULT_SUCCESS 0
105 #define XC_RESULT_RESET_FAILURE 1
106 #define XC_RESULT_I2C_WRITE_FAILURE 2
107 #define XC_RESULT_I2C_READ_FAILURE 3
108 #define XC_RESULT_OUT_OF_RANGE 5
111 #define XC_PRODUCT_ID_FW_NOT_LOADED 0x2000
112 #define XC_PRODUCT_ID_FW_LOADED 0x0FA0
114 /* Registers (Write-only) */
115 #define XREG_INIT 0x00
116 #define XREG_VIDEO_MODE 0x01
117 #define XREG_AUDIO_MODE 0x02
118 #define XREG_RF_FREQ 0x03
119 #define XREG_D_CODE 0x04
120 #define XREG_DIRECTSITTING_MODE 0x05
121 #define XREG_SEEK_MODE 0x06
122 #define XREG_POWER_DOWN 0x08
123 #define XREG_SIGNALSOURCE 0x0A
124 #define XREG_AMPLITUDE 0x10
126 /* Registers (Read-only) */
127 #define XREG_ADC_ENV 0x00
128 #define XREG_QUALITY 0x01
129 #define XREG_FRAME_LINES 0x02
130 #define XREG_HSYNC_FREQ 0x03
131 #define XREG_LOCK 0x04
132 #define XREG_FREQ_ERROR 0x05
133 #define XREG_SNR 0x06
134 #define XREG_VERSION 0x07
135 #define XREG_PRODUCT_ID 0x08
138 Basic firmware description. This will remain with
139 the driver for documentation purposes.
141 This represents an I2C firmware file encoded as a
142 string of unsigned char. Format is as follows:
144 char[0 ]=len0_MSB -> len = len_MSB * 256 + len_LSB
145 char[1 ]=len0_LSB -> length of first write transaction
146 char[2 ]=data0 -> first byte to be sent
150 char[M ]=dataN -> last byte to be sent
151 char[M+1]=len1_MSB -> len = len_MSB * 256 + len_LSB
152 char[M+2]=len1_LSB -> length of second write transaction
158 The [len] value should be interpreted as follows:
160 len= len_MSB _ len_LSB
161 len=1111_1111_1111_1111 : End of I2C_SEQUENCE
162 len=0000_0000_0000_0000 : Reset command: Do hardware reset
163 len=0NNN_NNNN_NNNN_NNNN : Normal transaction: number of bytes = {1:32767)
164 len=1WWW_WWWW_WWWW_WWWW : Wait command: wait for {1:32767} ms
166 For the RESET and WAIT commands, the two following bytes will contain
167 immediately the length of the following transaction.
170 struct XC_TV_STANDARD {
177 /* Tuner standards */
178 #define XC4000_MN_NTSC_PAL_BTSC 0
179 #define XC4000_MN_NTSC_PAL_A2 1
180 #define XC4000_MN_NTSC_PAL_EIAJ 2
181 #define XC4000_MN_NTSC_PAL_Mono 3
182 #define XC4000_BG_PAL_A2 4
183 #define XC4000_BG_PAL_NICAM 5
184 #define XC4000_BG_PAL_MONO 6
185 #define XC4000_I_PAL_NICAM 7
186 #define XC4000_I_PAL_NICAM_MONO 8
187 #define XC4000_DK_PAL_A2 9
188 #define XC4000_DK_PAL_NICAM 10
189 #define XC4000_DK_PAL_MONO 11
190 #define XC4000_DK_SECAM_A2DK1 12
191 #define XC4000_DK_SECAM_A2LDK3 13
192 #define XC4000_DK_SECAM_A2MONO 14
193 #define XC4000_DK_SECAM_NICAM 15
194 #define XC4000_L_SECAM_NICAM 16
195 #define XC4000_LC_SECAM_NICAM 17
196 #define XC4000_DTV6 18
197 #define XC4000_DTV8 19
198 #define XC4000_DTV7_8 20
199 #define XC4000_DTV7 21
200 #define XC4000_FM_Radio_INPUT2 22
201 #define XC4000_FM_Radio_INPUT1 23
203 static struct XC_TV_STANDARD XC4000_Standard[MAX_TV_STANDARD] = {
204 {"M/N-NTSC/PAL-BTSC", 0x0000, 0x80A0, 4500},
205 {"M/N-NTSC/PAL-A2", 0x0000, 0x80A0, 4600},
206 {"M/N-NTSC/PAL-EIAJ", 0x0040, 0x80A0, 4500},
207 {"M/N-NTSC/PAL-Mono", 0x0078, 0x80A0, 4500},
208 {"B/G-PAL-A2", 0x0000, 0x8159, 5640},
209 {"B/G-PAL-NICAM", 0x0004, 0x8159, 5740},
210 {"B/G-PAL-MONO", 0x0078, 0x8159, 5500},
211 {"I-PAL-NICAM", 0x0080, 0x8049, 6240},
212 {"I-PAL-NICAM-MONO", 0x0078, 0x8049, 6000},
213 {"D/K-PAL-A2", 0x0000, 0x8049, 6380},
214 {"D/K-PAL-NICAM", 0x0080, 0x8049, 6200},
215 {"D/K-PAL-MONO", 0x0078, 0x8049, 6500},
216 {"D/K-SECAM-A2 DK1", 0x0000, 0x8049, 6340},
217 {"D/K-SECAM-A2 L/DK3", 0x0000, 0x8049, 6000},
218 {"D/K-SECAM-A2 MONO", 0x0078, 0x8049, 6500},
219 {"D/K-SECAM-NICAM", 0x0080, 0x8049, 6200},
220 {"L-SECAM-NICAM", 0x8080, 0x0009, 6200},
221 {"L'-SECAM-NICAM", 0x8080, 0x4009, 6200},
222 {"DTV6", 0x00C0, 0x8002, 0},
223 {"DTV8", 0x00C0, 0x800B, 0},
224 {"DTV7/8", 0x00C0, 0x801B, 0},
225 {"DTV7", 0x00C0, 0x8007, 0},
226 {"FM Radio-INPUT2", 0x0008, 0x9800,10700},
227 {"FM Radio-INPUT1", 0x0008, 0x9000,10700}
230 static int xc4000_readreg(struct xc4000_priv *priv, u16 reg, u16 *val);
231 static int xc4000_TunerReset(struct dvb_frontend *fe);
233 static int xc_send_i2c_data(struct xc4000_priv *priv, u8 *buf, int len)
235 struct i2c_msg msg = { .addr = priv->i2c_props.addr,
236 .flags = 0, .buf = buf, .len = len };
237 if (i2c_transfer(priv->i2c_props.adap, &msg, 1) != 1) {
238 if (priv->ignore_i2c_write_errors == 0) {
239 printk(KERN_ERR "xc4000: I2C write failed (len=%i)\n",
242 printk("bytes %02x %02x %02x %02x\n", buf[0],
243 buf[1], buf[2], buf[3]);
245 return XC_RESULT_I2C_WRITE_FAILURE;
248 return XC_RESULT_SUCCESS;
251 static void xc_wait(int wait_ms)
256 static int xc4000_TunerReset(struct dvb_frontend *fe)
258 struct xc4000_priv *priv = fe->tuner_priv;
261 dprintk(1, "%s()\n", __func__);
264 ret = fe->callback(((fe->dvb) && (fe->dvb->priv)) ?
266 priv->i2c_props.adap->algo_data,
267 DVB_FRONTEND_COMPONENT_TUNER,
268 XC4000_TUNER_RESET, 0);
270 printk(KERN_ERR "xc4000: reset failed\n");
271 return XC_RESULT_RESET_FAILURE;
274 printk(KERN_ERR "xc4000: no tuner reset callback function, fatal\n");
275 return XC_RESULT_RESET_FAILURE;
277 return XC_RESULT_SUCCESS;
280 static int xc_write_reg(struct xc4000_priv *priv, u16 regAddr, u16 i2cData)
285 buf[0] = (regAddr >> 8) & 0xFF;
286 buf[1] = regAddr & 0xFF;
287 buf[2] = (i2cData >> 8) & 0xFF;
288 buf[3] = i2cData & 0xFF;
289 result = xc_send_i2c_data(priv, buf, 4);
294 static int xc_load_i2c_sequence(struct dvb_frontend *fe, const u8 *i2c_sequence)
296 struct xc4000_priv *priv = fe->tuner_priv;
298 int i, nbytes_to_send, result;
299 unsigned int len, pos, index;
300 u8 buf[XC_MAX_I2C_WRITE_LENGTH];
303 while ((i2c_sequence[index] != 0xFF) ||
304 (i2c_sequence[index + 1] != 0xFF)) {
305 len = i2c_sequence[index] * 256 + i2c_sequence[index+1];
308 result = xc4000_TunerReset(fe);
310 if (result != XC_RESULT_SUCCESS)
312 } else if (len & 0x8000) {
314 xc_wait(len & 0x7FFF);
317 /* Send i2c data whilst ensuring individual transactions
318 * do not exceed XC_MAX_I2C_WRITE_LENGTH bytes.
321 buf[0] = i2c_sequence[index];
322 buf[1] = i2c_sequence[index + 1];
325 if ((len - pos) > XC_MAX_I2C_WRITE_LENGTH - 2)
327 XC_MAX_I2C_WRITE_LENGTH;
329 nbytes_to_send = (len - pos + 2);
330 for (i = 2; i < nbytes_to_send; i++) {
331 buf[i] = i2c_sequence[index + pos +
334 result = xc_send_i2c_data(priv, buf,
337 if (result != XC_RESULT_SUCCESS)
340 pos += nbytes_to_send - 2;
345 return XC_RESULT_SUCCESS;
348 static int xc_SetTVStandard(struct xc4000_priv *priv,
349 u16 VideoMode, u16 AudioMode)
352 dprintk(1, "%s(0x%04x,0x%04x)\n", __func__, VideoMode, AudioMode);
353 dprintk(1, "%s() Standard = %s\n",
355 XC4000_Standard[priv->video_standard].Name);
357 /* Don't complain when the request fails because of i2c stretching */
358 priv->ignore_i2c_write_errors = 1;
360 ret = xc_write_reg(priv, XREG_VIDEO_MODE, VideoMode);
361 if (ret == XC_RESULT_SUCCESS)
362 ret = xc_write_reg(priv, XREG_AUDIO_MODE, AudioMode);
364 priv->ignore_i2c_write_errors = 0;
369 static int xc_SetSignalSource(struct xc4000_priv *priv, u16 rf_mode)
371 dprintk(1, "%s(%d) Source = %s\n", __func__, rf_mode,
372 rf_mode == XC_RF_MODE_AIR ? "ANTENNA" : "CABLE");
374 if ((rf_mode != XC_RF_MODE_AIR) && (rf_mode != XC_RF_MODE_CABLE)) {
375 rf_mode = XC_RF_MODE_CABLE;
377 "%s(), Invalid mode, defaulting to CABLE",
380 return xc_write_reg(priv, XREG_SIGNALSOURCE, rf_mode);
383 static const struct dvb_tuner_ops xc4000_tuner_ops;
385 static int xc_set_RF_frequency(struct xc4000_priv *priv, u32 freq_hz)
389 dprintk(1, "%s(%u)\n", __func__, freq_hz);
391 if ((freq_hz > xc4000_tuner_ops.info.frequency_max) ||
392 (freq_hz < xc4000_tuner_ops.info.frequency_min))
393 return XC_RESULT_OUT_OF_RANGE;
395 freq_code = (u16)(freq_hz / 15625);
397 /* WAS: Starting in firmware version 1.1.44, Xceive recommends using the
398 FINERFREQ for all normal tuning (the doc indicates reg 0x03 should
399 only be used for fast scanning for channel lock) */
400 return xc_write_reg(priv, XREG_RF_FREQ, freq_code); /* WAS: XREG_FINERFREQ */
403 static int xc_get_ADC_Envelope(struct xc4000_priv *priv, u16 *adc_envelope)
405 return xc4000_readreg(priv, XREG_ADC_ENV, adc_envelope);
408 static int xc_get_frequency_error(struct xc4000_priv *priv, u32 *freq_error_hz)
414 result = xc4000_readreg(priv, XREG_FREQ_ERROR, ®Data);
415 if (result != XC_RESULT_SUCCESS)
419 (*freq_error_hz) = (tmp * 15625) / 1000;
423 static int xc_get_lock_status(struct xc4000_priv *priv, u16 *lock_status)
425 return xc4000_readreg(priv, XREG_LOCK, lock_status);
428 static int xc_get_version(struct xc4000_priv *priv,
429 u8 *hw_majorversion, u8 *hw_minorversion,
430 u8 *fw_majorversion, u8 *fw_minorversion)
435 result = xc4000_readreg(priv, XREG_VERSION, &data);
436 if (result != XC_RESULT_SUCCESS)
439 (*hw_majorversion) = (data >> 12) & 0x0F;
440 (*hw_minorversion) = (data >> 8) & 0x0F;
441 (*fw_majorversion) = (data >> 4) & 0x0F;
442 (*fw_minorversion) = data & 0x0F;
447 static int xc_get_hsync_freq(struct xc4000_priv *priv, u32 *hsync_freq_hz)
452 result = xc4000_readreg(priv, XREG_HSYNC_FREQ, ®Data);
453 if (result != XC_RESULT_SUCCESS)
456 (*hsync_freq_hz) = ((regData & 0x0fff) * 763)/100;
460 static int xc_get_frame_lines(struct xc4000_priv *priv, u16 *frame_lines)
462 return xc4000_readreg(priv, XREG_FRAME_LINES, frame_lines);
465 static int xc_get_quality(struct xc4000_priv *priv, u16 *quality)
467 return xc4000_readreg(priv, XREG_QUALITY, quality);
470 static u16 WaitForLock(struct xc4000_priv *priv)
473 int watchDogCount = 40;
475 while ((lockState == 0) && (watchDogCount > 0)) {
476 xc_get_lock_status(priv, &lockState);
477 if (lockState != 1) {
485 #define XC_TUNE_ANALOG 0
486 #define XC_TUNE_DIGITAL 1
487 static int xc_tune_channel(struct xc4000_priv *priv, u32 freq_hz, int mode)
492 dprintk(1, "%s(%u)\n", __func__, freq_hz);
494 /* Don't complain when the request fails because of i2c stretching */
495 priv->ignore_i2c_write_errors = 1;
496 result = xc_set_RF_frequency(priv, freq_hz);
497 priv->ignore_i2c_write_errors = 0;
499 if (result != XC_RESULT_SUCCESS)
502 if (mode == XC_TUNE_ANALOG) {
503 if (WaitForLock(priv) == 1)
510 static int xc4000_readreg(struct xc4000_priv *priv, u16 reg, u16 *val)
512 u8 buf[2] = { reg >> 8, reg & 0xff };
513 u8 bval[2] = { 0, 0 };
514 struct i2c_msg msg[2] = {
515 { .addr = priv->i2c_props.addr,
516 .flags = 0, .buf = &buf[0], .len = 2 },
517 { .addr = priv->i2c_props.addr,
518 .flags = I2C_M_RD, .buf = &bval[0], .len = 2 },
521 if (i2c_transfer(priv->i2c_props.adap, msg, 2) != 2) {
522 printk(KERN_WARNING "xc4000: I2C read failed\n");
526 *val = (bval[0] << 8) | bval[1];
527 return XC_RESULT_SUCCESS;
530 #define dump_firm_type(t) dump_firm_type_and_int_freq(t, 0)
531 static void dump_firm_type_and_int_freq(unsigned int type, u16 int_freq)
577 if (type & TOYOTA388)
578 printk("TOYOTA388 ");
579 if (type & TOYOTA794)
580 printk("TOYOTA794 ");
583 if (type & ZARLINK456)
584 printk("ZARLINK456 ");
594 printk("HAS_IF_%d ", int_freq);
597 static int seek_firmware(struct dvb_frontend *fe, unsigned int type,
600 struct xc4000_priv *priv = fe->tuner_priv;
601 int i, best_i = -1, best_nr_matches = 0;
602 unsigned int type_mask = 0;
605 printk("Error! firmware not loaded\n");
609 if (((type & ~SCODE) == 0) && (*id == 0))
613 type_mask = BASE_TYPES;
614 else if (type & SCODE) {
616 type_mask = SCODE_TYPES & ~HAS_IF;
617 } else if (type & DTV_TYPES)
618 type_mask = DTV_TYPES;
619 else if (type & STD_SPECIFIC_TYPES)
620 type_mask = STD_SPECIFIC_TYPES;
627 /* Seek for exact match */
628 for (i = 0; i < priv->firm_size; i++) {
629 if ((type == (priv->firm[i].type & type_mask)) &&
630 (*id == priv->firm[i].id))
634 /* Seek for generic video standard match */
635 for (i = 0; i < priv->firm_size; i++) {
636 v4l2_std_id match_mask;
639 if (type != (priv->firm[i].type & type_mask))
642 match_mask = *id & priv->firm[i].id;
646 if ((*id & match_mask) == *id)
647 goto found; /* Supports all the requested standards */
649 nr_matches = hweight64(match_mask);
650 if (nr_matches > best_nr_matches) {
651 best_nr_matches = nr_matches;
656 if (best_nr_matches > 0) {
657 printk("Selecting best matching firmware (%d bits) for "
658 "type=", best_nr_matches);
659 printk("(%x), id %016llx:\n", type, (unsigned long long)*id);
664 /*FIXME: Would make sense to seek for type "hint" match ? */
670 *id = priv->firm[i].id;
674 printk("%s firmware for type=", (i < 0) ? "Can't find" :
676 dump_firm_type(type);
677 printk("(%x), id %016llx.\n", type, (unsigned long long)*id);
682 static int load_firmware(struct dvb_frontend *fe, unsigned int type,
685 struct xc4000_priv *priv = fe->tuner_priv;
689 pos = seek_firmware(fe, type, id);
693 p = priv->firm[pos].ptr;
695 /* Don't complain when the request fails because of i2c stretching */
696 priv->ignore_i2c_write_errors = 1;
698 rc = xc_load_i2c_sequence(fe, p);
700 priv->ignore_i2c_write_errors = 0;
705 static int xc4000_fwupload(struct dvb_frontend *fe)
707 struct xc4000_priv *priv = fe->tuner_priv;
708 const struct firmware *fw = NULL;
709 const unsigned char *p, *endp;
715 fname = XC4000_DEFAULT_FIRMWARE;
717 printk("Reading firmware %s\n", fname);
718 rc = request_firmware(&fw, fname, priv->i2c_props.adap->dev.parent);
721 printk("Error: firmware %s not found.\n",
724 printk("Error %d while requesting firmware %s \n",
732 if (fw->size < sizeof(name) - 1 + 2 + 2) {
733 printk("Error: firmware file %s has invalid size!\n",
738 memcpy(name, p, sizeof(name) - 1);
739 name[sizeof(name) - 1] = 0;
740 p += sizeof(name) - 1;
742 priv->firm_version = get_unaligned_le16(p);
745 n_array = get_unaligned_le16(p);
748 dprintk(1, "Loading %d firmware images from %s, type: %s, ver %d.%d\n",
749 n_array, fname, name,
750 priv->firm_version >> 8, priv->firm_version & 0xff);
752 priv->firm = kzalloc(sizeof(*priv->firm) * n_array, GFP_KERNEL);
753 if (priv->firm == NULL) {
754 printk("Not enough memory to load firmware file.\n");
758 priv->firm_size = n_array;
768 printk("More firmware images in file than "
773 /* Checks if there's enough bytes to read */
774 if (endp - p < sizeof(type) + sizeof(id) + sizeof(size))
777 type = get_unaligned_le32(p);
780 id = get_unaligned_le64(p);
784 int_freq = get_unaligned_le16(p);
785 p += sizeof(int_freq);
786 if (endp - p < sizeof(size))
790 size = get_unaligned_le32(p);
793 if (!size || size > endp - p) {
794 printk("Firmware type ");
795 printk("(%x), id %llx is corrupted "
796 "(size=%d, expected %d)\n",
797 type, (unsigned long long)id,
798 (unsigned)(endp - p), size);
802 priv->firm[n].ptr = kzalloc(size, GFP_KERNEL);
803 if (priv->firm[n].ptr == NULL) {
804 printk("Not enough memory to load firmware file.\n");
810 printk("Reading firmware type ");
811 dump_firm_type_and_int_freq(type, int_freq);
812 printk("(%x), id %llx, size=%d.\n",
813 type, (unsigned long long)id, size);
816 memcpy(priv->firm[n].ptr, p, size);
817 priv->firm[n].type = type;
818 priv->firm[n].id = id;
819 priv->firm[n].size = size;
820 priv->firm[n].int_freq = int_freq;
825 if (n + 1 != priv->firm_size) {
826 printk("Firmware file is incomplete!\n");
833 printk("Firmware header is incomplete!\n");
836 printk("Error: firmware file is corrupted!\n");
839 printk("Releasing partially loaded firmware file.\n");
842 release_firmware(fw);
844 dprintk(1, "Firmware files loaded.\n");
849 static int load_scode(struct dvb_frontend *fe, unsigned int type,
850 v4l2_std_id *id, __u16 int_freq, int scode)
852 struct xc4000_priv *priv = fe->tuner_priv;
858 dprintk(1, "%s called int_freq=%d\n", __func__, int_freq);
861 pos = seek_firmware(fe, type, id);
865 for (pos = 0; pos < priv->firm_size; pos++) {
866 if ((priv->firm[pos].int_freq == int_freq) &&
867 (priv->firm[pos].type & HAS_IF))
870 if (pos == priv->firm_size)
874 p = priv->firm[pos].ptr;
876 if (priv->firm[pos].type & HAS_IF) {
877 if (priv->firm[pos].size != 12 * 16 || scode >= 16)
881 /* 16 SCODE entries per file; each SCODE entry is 12 bytes and
882 * has a 2-byte size header in the firmware format. */
883 if (priv->firm[pos].size != 14 * 16 || scode >= 16 ||
884 le16_to_cpu(*(__u16 *)(p + 14 * scode)) != 12)
889 tuner_info("Loading SCODE for type=");
890 dump_firm_type_and_int_freq(priv->firm[pos].type,
891 priv->firm[pos].int_freq);
892 printk("(%x), id %016llx.\n", priv->firm[pos].type,
893 (unsigned long long)*id);
896 memcpy(&scode_buf[1], p, 12);
898 /* Enter direct-mode */
899 rc = xc_write_reg(priv, XREG_DIRECTSITTING_MODE, 0);
901 printk("failed to put device into direct mode!\n");
905 rc = xc_send_i2c_data(priv, scode_buf, 13);
906 if (rc != XC_RESULT_SUCCESS) {
907 /* Even if the send failed, make sure we set back to indirect
909 printk("Failed to set scode %d\n", rc);
912 /* Switch back to indirect-mode */
913 memset(indirect_mode, 0, sizeof(indirect_mode));
914 indirect_mode[4] = 0x88;
915 xc_send_i2c_data(priv, indirect_mode, sizeof(indirect_mode));
921 static int check_firmware(struct dvb_frontend *fe, unsigned int type,
922 v4l2_std_id std, __u16 int_freq)
924 struct xc4000_priv *priv = fe->tuner_priv;
925 struct firmware_properties new_fw;
926 int rc = 0, is_retry = 0;
927 u16 version, hwmodel;
929 u8 hw_major, hw_minor, fw_major, fw_minor;
931 dprintk(1, "%s called\n", __func__);
934 rc = xc4000_fwupload(fe);
940 if (priv->ctrl.mts && !(type & FM))
947 new_fw.std_req = std;
948 new_fw.scode_table = SCODE /* | priv->ctrl.scode_table */;
950 new_fw.int_freq = int_freq;
952 dprintk(1, "checking firmware, user requested type=");
954 dump_firm_type(new_fw.type);
955 printk("(%x), id %016llx, ", new_fw.type,
956 (unsigned long long)new_fw.std_req);
958 printk("scode_tbl ");
960 dump_firm_type(priv->ctrl.scode_table);
961 printk("(%x), ", priv->ctrl.scode_table);
964 printk("int_freq %d, ", new_fw.int_freq);
965 printk("scode_nr %d\n", new_fw.scode_nr);
968 /* No need to reload base firmware if it matches */
969 if (((BASE | new_fw.type) & BASE_TYPES) ==
970 (priv->cur_fw.type & BASE_TYPES)) {
971 dprintk(1, "BASE firmware not changed.\n");
975 /* Updating BASE - forget about all currently loaded firmware */
976 memset(&priv->cur_fw, 0, sizeof(priv->cur_fw));
978 /* Reset is needed before loading firmware */
979 rc = xc4000_TunerReset(fe);
983 /* BASE firmwares are all std0 */
985 rc = load_firmware(fe, BASE | new_fw.type, &std0);
987 printk("Error %d while loading base firmware\n", rc);
991 /* Load INIT1, if needed */
992 dprintk(1, "Load init1 firmware, if exists\n");
994 rc = load_firmware(fe, BASE | INIT1 | new_fw.type, &std0);
996 rc = load_firmware(fe, (BASE | INIT1 | new_fw.type) & ~F8MHZ,
998 if (rc < 0 && rc != -ENOENT) {
999 tuner_err("Error %d while loading init1 firmware\n",
1006 * No need to reload standard specific firmware if base firmware
1007 * was not reloaded and requested video standards have not changed.
1009 if (priv->cur_fw.type == (BASE | new_fw.type) &&
1010 priv->cur_fw.std_req == std) {
1011 dprintk(1, "Std-specific firmware already loaded.\n");
1012 goto skip_std_specific;
1015 /* Reloading std-specific firmware forces a SCODE update */
1016 priv->cur_fw.scode_table = 0;
1018 /* Load the standard firmware */
1019 rc = load_firmware(fe, new_fw.type, &new_fw.id);
1025 if (priv->cur_fw.scode_table == new_fw.scode_table &&
1026 priv->cur_fw.scode_nr == new_fw.scode_nr) {
1027 dprintk(1, "SCODE firmware already loaded.\n");
1031 if (new_fw.type & FM)
1034 /* Load SCODE firmware, if exists */
1035 rc = load_scode(fe, new_fw.type | new_fw.scode_table, &new_fw.id,
1036 new_fw.int_freq, new_fw.scode_nr);
1037 if (rc != XC_RESULT_SUCCESS)
1038 dprintk(1, "load scode failed %d\n", rc);
1041 rc = xc4000_readreg(priv, XREG_PRODUCT_ID, &hwmodel);
1043 if (xc_get_version(priv, &hw_major, &hw_minor, &fw_major,
1044 &fw_minor) != XC_RESULT_SUCCESS) {
1045 printk("Unable to read tuner registers.\n");
1049 dprintk(1, "Device is Xceive %d version %d.%d, "
1050 "firmware version %d.%d\n",
1051 hwmodel, hw_major, hw_minor, fw_major, fw_minor);
1053 /* Check firmware version against what we downloaded. */
1055 if (priv->firm_version != ((version & 0xf0) << 4 | (version & 0x0f))) {
1056 printk("Incorrect readback of firmware version %x.\n",
1062 /* Check that the tuner hardware model remains consistent over time. */
1063 if (priv->hwmodel == 0 && hwmodel == 4000) {
1064 priv->hwmodel = hwmodel;
1065 priv->hwvers = version & 0xff00;
1066 } else if (priv->hwmodel == 0 || priv->hwmodel != hwmodel ||
1067 priv->hwvers != (version & 0xff00)) {
1068 printk("Read invalid device hardware information - tuner "
1073 memcpy(&priv->cur_fw, &new_fw, sizeof(priv->cur_fw));
1076 * By setting BASE in cur_fw.type only after successfully loading all
1077 * firmwares, we can:
1078 * 1. Identify that BASE firmware with type=0 has been loaded;
1079 * 2. Tell whether BASE firmware was just changed the next time through.
1081 priv->cur_fw.type |= BASE;
1086 memset(&priv->cur_fw, 0, sizeof(priv->cur_fw));
1090 dprintk(1, "Retrying firmware load\n");
1099 static void xc_debug_dump(struct xc4000_priv *priv)
1102 u32 freq_error_hz = 0;
1104 u32 hsync_freq_hz = 0;
1107 u8 hw_majorversion = 0, hw_minorversion = 0;
1108 u8 fw_majorversion = 0, fw_minorversion = 0;
1110 /* Wait for stats to stabilize.
1111 * Frame Lines needs two frame times after initial lock
1112 * before it is valid.
1116 xc_get_ADC_Envelope(priv, &adc_envelope);
1117 dprintk(1, "*** ADC envelope (0-1023) = %d\n", adc_envelope);
1119 xc_get_frequency_error(priv, &freq_error_hz);
1120 dprintk(1, "*** Frequency error = %d Hz\n", freq_error_hz);
1122 xc_get_lock_status(priv, &lock_status);
1123 dprintk(1, "*** Lock status (0-Wait, 1-Locked, 2-No-signal) = %d\n",
1126 xc_get_version(priv, &hw_majorversion, &hw_minorversion,
1127 &fw_majorversion, &fw_minorversion);
1129 dprintk(1, "*** HW: V%02x.%02x, FW: V%02x.%02x\n",
1130 hw_majorversion, hw_minorversion,
1131 fw_majorversion, fw_minorversion);
1133 xc_get_hsync_freq(priv, &hsync_freq_hz);
1134 dprintk(1, "*** Horizontal sync frequency = %d Hz\n", hsync_freq_hz);
1136 xc_get_frame_lines(priv, &frame_lines);
1137 dprintk(1, "*** Frame lines = %d\n", frame_lines);
1139 xc_get_quality(priv, &quality);
1140 dprintk(1, "*** Quality (0:<8dB, 7:>56dB) = %d\n", quality);
1143 static int xc4000_set_params(struct dvb_frontend *fe,
1144 struct dvb_frontend_parameters *params)
1146 struct xc4000_priv *priv = fe->tuner_priv;
1150 dprintk(1, "%s() frequency=%d (Hz)\n", __func__, params->frequency);
1152 if (fe->ops.info.type == FE_ATSC) {
1153 dprintk(1, "%s() ATSC\n", __func__);
1154 switch (params->u.vsb.modulation) {
1157 dprintk(1, "%s() VSB modulation\n", __func__);
1158 priv->rf_mode = XC_RF_MODE_AIR;
1159 priv->freq_hz = params->frequency - 1750000;
1160 priv->bandwidth = BANDWIDTH_6_MHZ;
1161 priv->video_standard = XC4000_DTV6;
1167 dprintk(1, "%s() QAM modulation\n", __func__);
1168 priv->rf_mode = XC_RF_MODE_CABLE;
1169 priv->freq_hz = params->frequency - 1750000;
1170 priv->bandwidth = BANDWIDTH_6_MHZ;
1171 priv->video_standard = XC4000_DTV6;
1177 } else if (fe->ops.info.type == FE_OFDM) {
1178 dprintk(1, "%s() OFDM\n", __func__);
1179 switch (params->u.ofdm.bandwidth) {
1180 case BANDWIDTH_6_MHZ:
1181 priv->bandwidth = BANDWIDTH_6_MHZ;
1182 priv->video_standard = XC4000_DTV6;
1183 priv->freq_hz = params->frequency - 1750000;
1186 case BANDWIDTH_7_MHZ:
1187 printk(KERN_ERR "xc4000 bandwidth 7MHz not supported\n");
1190 case BANDWIDTH_8_MHZ:
1191 priv->bandwidth = BANDWIDTH_8_MHZ;
1192 priv->video_standard = XC4000_DTV8;
1193 priv->freq_hz = params->frequency - 2750000;
1197 printk(KERN_ERR "xc4000 bandwidth not set!\n");
1200 priv->rf_mode = XC_RF_MODE_AIR;
1202 printk(KERN_ERR "xc4000 modulation type not supported!\n");
1206 dprintk(1, "%s() frequency=%d (compensated)\n",
1207 __func__, priv->freq_hz);
1209 /* Make sure the correct firmware type is loaded */
1210 if (check_firmware(fe, type, 0, priv->if_khz) != XC_RESULT_SUCCESS) {
1214 ret = xc_SetSignalSource(priv, priv->rf_mode);
1215 if (ret != XC_RESULT_SUCCESS) {
1217 "xc4000: xc_SetSignalSource(%d) failed\n",
1222 ret = xc_SetTVStandard(priv,
1223 XC4000_Standard[priv->video_standard].VideoMode,
1224 XC4000_Standard[priv->video_standard].AudioMode);
1225 if (ret != XC_RESULT_SUCCESS) {
1226 printk(KERN_ERR "xc4000: xc_SetTVStandard failed\n");
1230 ret = xc_set_IF_frequency(priv, priv->if_khz);
1231 if (ret != XC_RESULT_SUCCESS) {
1232 printk(KERN_ERR "xc4000: xc_Set_IF_frequency(%d) failed\n",
1237 xc_tune_channel(priv, priv->freq_hz, XC_TUNE_DIGITAL);
1240 xc_debug_dump(priv);
1245 static int xc4000_set_analog_params(struct dvb_frontend *fe,
1246 struct analog_parameters *params)
1248 struct xc4000_priv *priv = fe->tuner_priv;
1251 dprintk(1, "%s() frequency=%d (in units of 62.5khz)\n",
1252 __func__, params->frequency);
1254 /* Fix me: it could be air. */
1255 priv->rf_mode = params->mode;
1256 if (params->mode > XC_RF_MODE_CABLE)
1257 priv->rf_mode = XC_RF_MODE_CABLE;
1259 /* params->frequency is in units of 62.5khz */
1260 priv->freq_hz = params->frequency * 62500;
1262 /* FIX ME: Some video standards may have several possible audio
1263 standards. We simply default to one of them here.
1265 if (params->std & V4L2_STD_MN) {
1266 /* default to BTSC audio standard */
1267 priv->video_standard = XC4000_MN_NTSC_PAL_BTSC;
1271 if (params->std & V4L2_STD_PAL_BG) {
1272 /* default to NICAM audio standard */
1273 priv->video_standard = XC4000_BG_PAL_NICAM;
1277 if (params->std & V4L2_STD_PAL_I) {
1278 /* default to NICAM audio standard */
1279 priv->video_standard = XC4000_I_PAL_NICAM;
1283 if (params->std & V4L2_STD_PAL_DK) {
1284 /* default to NICAM audio standard */
1285 priv->video_standard = XC4000_DK_PAL_NICAM;
1289 if (params->std & V4L2_STD_SECAM_DK) {
1290 /* default to A2 DK1 audio standard */
1291 priv->video_standard = XC4000_DK_SECAM_A2DK1;
1295 if (params->std & V4L2_STD_SECAM_L) {
1296 priv->video_standard = XC4000_L_SECAM_NICAM;
1300 if (params->std & V4L2_STD_SECAM_LC) {
1301 priv->video_standard = XC4000_LC_SECAM_NICAM;
1307 /* FIXME - firmware type not being set properly */
1308 if (check_firmware(fe, DTV8, 0, priv->if_khz) != XC_RESULT_SUCCESS) {
1312 ret = xc_SetSignalSource(priv, priv->rf_mode);
1313 if (ret != XC_RESULT_SUCCESS) {
1315 "xc4000: xc_SetSignalSource(%d) failed\n",
1320 ret = xc_SetTVStandard(priv,
1321 XC4000_Standard[priv->video_standard].VideoMode,
1322 XC4000_Standard[priv->video_standard].AudioMode);
1323 if (ret != XC_RESULT_SUCCESS) {
1324 printk(KERN_ERR "xc4000: xc_SetTVStandard failed\n");
1328 xc_tune_channel(priv, priv->freq_hz, XC_TUNE_ANALOG);
1331 xc_debug_dump(priv);
1336 static int xc4000_get_frequency(struct dvb_frontend *fe, u32 *freq)
1338 struct xc4000_priv *priv = fe->tuner_priv;
1339 dprintk(1, "%s()\n", __func__);
1340 *freq = priv->freq_hz;
1344 static int xc4000_get_bandwidth(struct dvb_frontend *fe, u32 *bw)
1346 struct xc4000_priv *priv = fe->tuner_priv;
1347 dprintk(1, "%s()\n", __func__);
1349 *bw = priv->bandwidth;
1353 static int xc4000_get_status(struct dvb_frontend *fe, u32 *status)
1355 struct xc4000_priv *priv = fe->tuner_priv;
1356 u16 lock_status = 0;
1358 xc_get_lock_status(priv, &lock_status);
1360 dprintk(1, "%s() lock_status = 0x%08x\n", __func__, lock_status);
1362 *status = lock_status;
1367 static int xc4000_sleep(struct dvb_frontend *fe)
1369 /* FIXME: djh disable this for now... */
1370 return XC_RESULT_SUCCESS;
1373 static int xc4000_init(struct dvb_frontend *fe)
1375 struct xc4000_priv *priv = fe->tuner_priv;
1376 dprintk(1, "%s()\n", __func__);
1378 if (check_firmware(fe, DTV8, 0, priv->if_khz) != XC_RESULT_SUCCESS) {
1379 printk(KERN_ERR "xc4000: Unable to initialise tuner\n");
1384 xc_debug_dump(priv);
1389 static int xc4000_release(struct dvb_frontend *fe)
1391 struct xc4000_priv *priv = fe->tuner_priv;
1393 dprintk(1, "%s()\n", __func__);
1395 mutex_lock(&xc4000_list_mutex);
1398 hybrid_tuner_release_state(priv);
1400 mutex_unlock(&xc4000_list_mutex);
1402 fe->tuner_priv = NULL;
1407 static const struct dvb_tuner_ops xc4000_tuner_ops = {
1409 .name = "Xceive XC4000",
1410 .frequency_min = 1000000,
1411 .frequency_max = 1023000000,
1412 .frequency_step = 50000,
1415 .release = xc4000_release,
1416 .init = xc4000_init,
1417 .sleep = xc4000_sleep,
1419 .set_params = xc4000_set_params,
1420 .set_analog_params = xc4000_set_analog_params,
1421 .get_frequency = xc4000_get_frequency,
1422 .get_bandwidth = xc4000_get_bandwidth,
1423 .get_status = xc4000_get_status
1426 struct dvb_frontend *xc4000_attach(struct dvb_frontend *fe,
1427 struct i2c_adapter *i2c,
1428 struct xc4000_config *cfg)
1430 struct xc4000_priv *priv = NULL;
1434 dprintk(1, "%s(%d-%04x)\n", __func__,
1435 i2c ? i2c_adapter_id(i2c) : -1,
1436 cfg ? cfg->i2c_address : -1);
1438 mutex_lock(&xc4000_list_mutex);
1440 instance = hybrid_tuner_request_state(struct xc4000_priv, priv,
1441 hybrid_tuner_instance_list,
1442 i2c, cfg->i2c_address, "xc4000");
1448 /* new tuner instance */
1449 priv->bandwidth = BANDWIDTH_6_MHZ;
1450 fe->tuner_priv = priv;
1453 /* existing tuner instance */
1454 fe->tuner_priv = priv;
1458 if (priv->if_khz == 0) {
1459 /* If the IF hasn't been set yet, use the value provided by
1460 the caller (occurs in hybrid devices where the analog
1461 call to xc4000_attach occurs before the digital side) */
1462 priv->if_khz = cfg->if_khz;
1465 /* Check if firmware has been loaded. It is possible that another
1466 instance of the driver has loaded the firmware.
1469 if (xc4000_readreg(priv, XREG_PRODUCT_ID, &id) != XC_RESULT_SUCCESS)
1473 case XC_PRODUCT_ID_FW_LOADED:
1475 "xc4000: Successfully identified at address 0x%02x\n",
1478 "xc4000: Firmware has been loaded previously\n");
1480 case XC_PRODUCT_ID_FW_NOT_LOADED:
1482 "xc4000: Successfully identified at address 0x%02x\n",
1485 "xc4000: Firmware has not been loaded previously\n");
1489 "xc4000: Device not found at addr 0x%02x (0x%x)\n",
1490 cfg->i2c_address, id);
1494 mutex_unlock(&xc4000_list_mutex);
1496 memcpy(&fe->ops.tuner_ops, &xc4000_tuner_ops,
1497 sizeof(struct dvb_tuner_ops));
1499 /* FIXME: For now, load the firmware at startup. We will remove this
1500 before the code goes to production... */
1501 check_firmware(fe, DTV8, 0, priv->if_khz);
1505 mutex_unlock(&xc4000_list_mutex);
1510 EXPORT_SYMBOL(xc4000_attach);
1512 MODULE_AUTHOR("Steven Toth, Davide Ferri");
1513 MODULE_DESCRIPTION("Xceive xc4000 silicon tuner driver");
1514 MODULE_LICENSE("GPL");