2 * Driver for Xceive XC5000 "QAM/8VSB single chip tuner"
4 * Copyright (c) 2007 Xceive Corporation
5 * Copyright (c) 2007 Steven Toth <stoth@hauppauge.com>
7 * This program is free software; you can redistribute it and/or modify
8 * it under the terms of the GNU General Public License as published by
9 * the Free Software Foundation; either version 2 of the License, or
10 * (at your option) any later version.
12 * This program is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 * GNU General Public License for more details.
18 * You should have received a copy of the GNU General Public License
19 * along with this program; if not, write to the Free Software
20 * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
23 #include <linux/module.h>
24 #include <linux/moduleparam.h>
25 #include <linux/videodev2.h>
26 #include <linux/delay.h>
27 #include <linux/dvb/frontend.h>
28 #include <linux/i2c.h>
30 #include "dvb_frontend.h"
33 #include "xc5000_priv.h"
36 module_param(debug
, int, 0644);
37 MODULE_PARM_DESC(debug
, "Turn on/off debugging (default:off).");
39 #define dprintk(level,fmt, arg...) if (debug >= level) \
40 printk(KERN_INFO "%s: " fmt, "xc5000", ## arg)
42 #define XC5000_DEFAULT_FIRMWARE "dvb-fe-xc5000-1.1.fw"
43 #define XC5000_DEFAULT_FIRMWARE_SIZE 12332
46 #define MAX_TV_STANDARD 23
47 #define XC_MAX_I2C_WRITE_LENGTH 64
50 #define XC_RF_MODE_AIR 0
51 #define XC_RF_MODE_CABLE 1
54 #define XC_RESULT_SUCCESS 0
55 #define XC_RESULT_RESET_FAILURE 1
56 #define XC_RESULT_I2C_WRITE_FAILURE 2
57 #define XC_RESULT_I2C_READ_FAILURE 3
58 #define XC_RESULT_OUT_OF_RANGE 5
61 #define XC_PRODUCT_ID_FW_NOT_LOADED 0x2000
62 #define XC_PRODUCT_ID_FW_LOADED 0x1388
65 #define XREG_INIT 0x00
66 #define XREG_VIDEO_MODE 0x01
67 #define XREG_AUDIO_MODE 0x02
68 #define XREG_RF_FREQ 0x03
69 #define XREG_D_CODE 0x04
70 #define XREG_IF_OUT 0x05
71 #define XREG_SEEK_MODE 0x07
72 #define XREG_POWER_DOWN 0x0A
73 #define XREG_SIGNALSOURCE 0x0D /* 0=Air, 1=Cable */
74 #define XREG_SMOOTHEDCVBS 0x0E
75 #define XREG_XTALFREQ 0x0F
76 #define XREG_FINERFFREQ 0x10
77 #define XREG_DDIMODE 0x11
79 #define XREG_ADC_ENV 0x00
80 #define XREG_QUALITY 0x01
81 #define XREG_FRAME_LINES 0x02
82 #define XREG_HSYNC_FREQ 0x03
83 #define XREG_LOCK 0x04
84 #define XREG_FREQ_ERROR 0x05
86 #define XREG_VERSION 0x07
87 #define XREG_PRODUCT_ID 0x08
88 #define XREG_BUSY 0x09
91 Basic firmware description. This will remain with
92 the driver for documentation purposes.
94 This represents an I2C firmware file encoded as a
95 string of unsigned char. Format is as follows:
97 char[0 ]=len0_MSB -> len = len_MSB * 256 + len_LSB
98 char[1 ]=len0_LSB -> length of first write transaction
99 char[2 ]=data0 -> first byte to be sent
103 char[M ]=dataN -> last byte to be sent
104 char[M+1]=len1_MSB -> len = len_MSB * 256 + len_LSB
105 char[M+2]=len1_LSB -> length of second write transaction
111 The [len] value should be interpreted as follows:
113 len= len_MSB _ len_LSB
114 len=1111_1111_1111_1111 : End of I2C_SEQUENCE
115 len=0000_0000_0000_0000 : Reset command: Do hardware reset
116 len=0NNN_NNNN_NNNN_NNNN : Normal transaction: number of bytes = {1:32767)
117 len=1WWW_WWWW_WWWW_WWWW : Wait command: wait for {1:32767} ms
119 For the RESET and WAIT commands, the two following bytes will contain
120 immediately the length of the following transaction.
129 /* Tuner standards */
130 #define MN_NTSC_PAL_BTSC 0
131 #define MN_NTSC_PAL_A2 1
132 #define MN_NTSC_PAL_EIAJ 2
133 #define MN_NTSC_PAL_Mono 3
135 #define BG_PAL_NICAM 5
136 #define BG_PAL_MONO 6
137 #define I_PAL_NICAM 7
138 #define I_PAL_NICAM_MONO 8
140 #define DK_PAL_NICAM 10
141 #define DK_PAL_MONO 11
142 #define DK_SECAM_A2DK1 12
143 #define DK_SECAM_A2LDK3 13
144 #define DK_SECAM_A2MONO 14
145 #define L_SECAM_NICAM 15
146 #define LC_SECAM_NICAM 16
151 #define FM_Radio_INPUT2 21
152 #define FM_Radio_INPUT1 22
154 static XC_TV_STANDARD XC5000_Standard
[MAX_TV_STANDARD
] = {
155 {"M/N-NTSC/PAL-BTSC", 0x0400, 0x8020},
156 {"M/N-NTSC/PAL-A2", 0x0600, 0x8020},
157 {"M/N-NTSC/PAL-EIAJ", 0x0440, 0x8020},
158 {"M/N-NTSC/PAL-Mono", 0x0478, 0x8020},
159 {"B/G-PAL-A2", 0x0A00, 0x8049},
160 {"B/G-PAL-NICAM", 0x0C04, 0x8049},
161 {"B/G-PAL-MONO", 0x0878, 0x8059},
162 {"I-PAL-NICAM", 0x1080, 0x8009},
163 {"I-PAL-NICAM-MONO", 0x0E78, 0x8009},
164 {"D/K-PAL-A2", 0x1600, 0x8009},
165 {"D/K-PAL-NICAM", 0x0E80, 0x8009},
166 {"D/K-PAL-MONO", 0x1478, 0x8009},
167 {"D/K-SECAM-A2 DK1", 0x1200, 0x8009},
168 {"D/K-SECAM-A2 L/DK3",0x0E00, 0x8009},
169 {"D/K-SECAM-A2 MONO", 0x1478, 0x8009},
170 {"L-SECAM-NICAM", 0x8E82, 0x0009},
171 {"L'-SECAM-NICAM", 0x8E82, 0x4009},
172 {"DTV6", 0x00C0, 0x8002},
173 {"DTV8", 0x00C0, 0x800B},
174 {"DTV7/8", 0x00C0, 0x801B},
175 {"DTV7", 0x00C0, 0x8007},
176 {"FM Radio-INPUT2", 0x9802, 0x9002},
177 {"FM Radio-INPUT1", 0x0208, 0x9002}
180 static int xc5000_is_firmware_loaded(struct dvb_frontend
*fe
);
181 static int xc5000_writeregs(struct xc5000_priv
*priv
, u8
*buf
, u8 len
);
182 static int xc5000_readregs(struct xc5000_priv
*priv
, u8
*buf
, u8 len
);
183 static void xc5000_TunerReset(struct dvb_frontend
*fe
);
185 static int xc_send_i2c_data(struct xc5000_priv
*priv
, u8
*buf
, int len
)
187 return xc5000_writeregs(priv
, buf
, len
)
188 ? XC_RESULT_I2C_WRITE_FAILURE
: XC_RESULT_SUCCESS
;
191 static int xc_read_i2c_data(struct xc5000_priv
*priv
, u8
*buf
, int len
)
193 return xc5000_readregs(priv
, buf
, len
)
194 ? XC_RESULT_I2C_READ_FAILURE
: XC_RESULT_SUCCESS
;
197 static int xc_reset(struct dvb_frontend
*fe
)
199 xc5000_TunerReset(fe
);
200 return XC_RESULT_SUCCESS
;
203 static void xc_wait(int wait_ms
)
208 static void xc5000_TunerReset(struct dvb_frontend
*fe
)
210 struct xc5000_priv
*priv
= fe
->tuner_priv
;
213 dprintk(1, "%s()\n", __func__
);
215 if (priv
->cfg
->tuner_callback
) {
216 ret
= priv
->cfg
->tuner_callback(priv
->devptr
,
217 XC5000_TUNER_RESET
, 0);
219 printk(KERN_ERR
"xc5000: reset failed\n");
221 printk(KERN_ERR
"xc5000: no tuner reset callback function, fatal\n");
224 static int xc_write_reg(struct xc5000_priv
*priv
, u16 regAddr
, u16 i2cData
)
227 int WatchDogTimer
= 5;
230 buf
[0] = (regAddr
>> 8) & 0xFF;
231 buf
[1] = regAddr
& 0xFF;
232 buf
[2] = (i2cData
>> 8) & 0xFF;
233 buf
[3] = i2cData
& 0xFF;
234 result
= xc_send_i2c_data(priv
, buf
, 4);
235 if (result
== XC_RESULT_SUCCESS
) {
236 /* wait for busy flag to clear */
237 while ((WatchDogTimer
> 0) && (result
== XC_RESULT_SUCCESS
)) {
241 result
= xc_send_i2c_data(priv
, buf
, 2);
242 if (result
== XC_RESULT_SUCCESS
) {
243 result
= xc_read_i2c_data(priv
, buf
, 2);
244 if (result
== XC_RESULT_SUCCESS
) {
245 if ((buf
[0] == 0) && (buf
[1] == 0)) {
246 /* busy flag cleared */
249 xc_wait(100); /* wait 5 ms */
256 if (WatchDogTimer
< 0)
257 result
= XC_RESULT_I2C_WRITE_FAILURE
;
262 static int xc_read_reg(struct xc5000_priv
*priv
, u16 regAddr
, u16
*i2cData
)
267 buf
[0] = (regAddr
>> 8) & 0xFF;
268 buf
[1] = regAddr
& 0xFF;
269 result
= xc_send_i2c_data(priv
, buf
, 2);
270 if (result
!= XC_RESULT_SUCCESS
)
273 result
= xc_read_i2c_data(priv
, buf
, 2);
274 if (result
!= XC_RESULT_SUCCESS
)
277 *i2cData
= buf
[0] * 256 + buf
[1];
281 static int xc_load_i2c_sequence(struct dvb_frontend
*fe
, u8 i2c_sequence
[])
283 struct xc5000_priv
*priv
= fe
->tuner_priv
;
285 int i
, nbytes_to_send
, result
;
286 unsigned int len
, pos
, index
;
287 u8 buf
[XC_MAX_I2C_WRITE_LENGTH
];
290 while ((i2c_sequence
[index
]!=0xFF) || (i2c_sequence
[index
+1]!=0xFF)) {
291 len
= i2c_sequence
[index
]* 256 + i2c_sequence
[index
+1];
294 result
= xc_reset(fe
);
296 if (result
!= XC_RESULT_SUCCESS
)
298 } else if (len
& 0x8000) {
300 xc_wait(len
& 0x7FFF);
303 /* Send i2c data whilst ensuring individual transactions
304 * do not exceed XC_MAX_I2C_WRITE_LENGTH bytes.
307 buf
[0] = i2c_sequence
[index
];
308 buf
[1] = i2c_sequence
[index
+ 1];
311 if ((len
- pos
) > XC_MAX_I2C_WRITE_LENGTH
- 2) {
312 nbytes_to_send
= XC_MAX_I2C_WRITE_LENGTH
;
314 nbytes_to_send
= (len
- pos
+ 2);
316 for (i
=2; i
<nbytes_to_send
; i
++) {
317 buf
[i
] = i2c_sequence
[index
+ pos
+ i
- 2];
319 result
= xc_send_i2c_data(priv
, buf
, nbytes_to_send
);
321 if (result
!= XC_RESULT_SUCCESS
)
324 pos
+= nbytes_to_send
- 2;
329 return XC_RESULT_SUCCESS
;
332 static int xc_initialize(struct xc5000_priv
*priv
)
334 dprintk(1, "%s()\n", __func__
);
335 return xc_write_reg(priv
, XREG_INIT
, 0);
338 static int xc_SetTVStandard(struct xc5000_priv
*priv
,
339 u16 VideoMode
, u16 AudioMode
)
342 dprintk(1, "%s(0x%04x,0x%04x)\n", __func__
, VideoMode
, AudioMode
);
343 dprintk(1, "%s() Standard = %s\n",
345 XC5000_Standard
[priv
->video_standard
].Name
);
347 ret
= xc_write_reg(priv
, XREG_VIDEO_MODE
, VideoMode
);
348 if (ret
== XC_RESULT_SUCCESS
)
349 ret
= xc_write_reg(priv
, XREG_AUDIO_MODE
, AudioMode
);
354 static int xc_shutdown(struct xc5000_priv
*priv
)
356 return XC_RESULT_SUCCESS
;
357 /* Fixme: cannot bring tuner back alive once shutdown
358 * without reloading the driver modules.
359 * return xc_write_reg(priv, XREG_POWER_DOWN, 0);
363 static int xc_SetSignalSource(struct xc5000_priv
*priv
, u16 rf_mode
)
365 dprintk(1, "%s(%d) Source = %s\n", __func__
, rf_mode
,
366 rf_mode
== XC_RF_MODE_AIR
? "ANTENNA" : "CABLE");
368 if ((rf_mode
!= XC_RF_MODE_AIR
) && (rf_mode
!= XC_RF_MODE_CABLE
))
370 rf_mode
= XC_RF_MODE_CABLE
;
372 "%s(), Invalid mode, defaulting to CABLE",
375 return xc_write_reg(priv
, XREG_SIGNALSOURCE
, rf_mode
);
378 static const struct dvb_tuner_ops xc5000_tuner_ops
;
380 static int xc_set_RF_frequency(struct xc5000_priv
*priv
, u32 freq_hz
)
384 dprintk(1, "%s(%u)\n", __func__
, freq_hz
);
386 if ((freq_hz
> xc5000_tuner_ops
.info
.frequency_max
) ||
387 (freq_hz
< xc5000_tuner_ops
.info
.frequency_min
))
388 return XC_RESULT_OUT_OF_RANGE
;
390 freq_code
= (u16
)(freq_hz
/ 15625);
392 return xc_write_reg(priv
, XREG_RF_FREQ
, freq_code
);
396 static int xc_set_IF_frequency(struct xc5000_priv
*priv
, u32 freq_khz
)
398 u32 freq_code
= (freq_khz
* 1024)/1000;
399 dprintk(1, "%s(freq_khz = %d) freq_code = 0x%x\n",
400 __func__
, freq_khz
, freq_code
);
402 return xc_write_reg(priv
, XREG_IF_OUT
, freq_code
);
406 static int xc_get_ADC_Envelope(struct xc5000_priv
*priv
, u16
*adc_envelope
)
408 return xc_read_reg(priv
, XREG_ADC_ENV
, adc_envelope
);
411 static int xc_get_frequency_error(struct xc5000_priv
*priv
, u32
*freq_error_hz
)
417 result
= xc_read_reg(priv
, XREG_FREQ_ERROR
, ®Data
);
422 (*freq_error_hz
) = (tmp
* 15625) / 1000;
426 static int xc_get_lock_status(struct xc5000_priv
*priv
, u16
*lock_status
)
428 return xc_read_reg(priv
, XREG_LOCK
, lock_status
);
431 static int xc_get_version(struct xc5000_priv
*priv
,
432 u8
*hw_majorversion
, u8
*hw_minorversion
,
433 u8
*fw_majorversion
, u8
*fw_minorversion
)
438 result
= xc_read_reg(priv
, XREG_VERSION
, &data
);
442 (*hw_majorversion
) = (data
>> 12) & 0x0F;
443 (*hw_minorversion
) = (data
>> 8) & 0x0F;
444 (*fw_majorversion
) = (data
>> 4) & 0x0F;
445 (*fw_minorversion
) = data
& 0x0F;
450 static int xc_get_hsync_freq(struct xc5000_priv
*priv
, u32
*hsync_freq_hz
)
455 result
= xc_read_reg(priv
, XREG_HSYNC_FREQ
, ®Data
);
459 (*hsync_freq_hz
) = ((regData
& 0x0fff) * 763)/100;
463 static int xc_get_frame_lines(struct xc5000_priv
*priv
, u16
*frame_lines
)
465 return xc_read_reg(priv
, XREG_FRAME_LINES
, frame_lines
);
468 static int xc_get_quality(struct xc5000_priv
*priv
, u16
*quality
)
470 return xc_read_reg(priv
, XREG_QUALITY
, quality
);
473 static u16
WaitForLock(struct xc5000_priv
*priv
)
476 int watchDogCount
= 40;
478 while ((lockState
== 0) && (watchDogCount
> 0)) {
479 xc_get_lock_status(priv
, &lockState
);
480 if (lockState
!= 1) {
488 static int xc_tune_channel(struct xc5000_priv
*priv
, u32 freq_hz
)
492 dprintk(1, "%s(%u)\n", __func__
, freq_hz
);
494 if (xc_set_RF_frequency(priv
, freq_hz
) != XC_RESULT_SUCCESS
)
497 if (WaitForLock(priv
) == 1)
503 static int xc5000_readreg(struct xc5000_priv
*priv
, u16 reg
, u16
*val
)
505 u8 buf
[2] = { reg
>> 8, reg
& 0xff };
506 u8 bval
[2] = { 0, 0 };
507 struct i2c_msg msg
[2] = {
508 { .addr
= priv
->cfg
->i2c_address
,
509 .flags
= 0, .buf
= &buf
[0], .len
= 2 },
510 { .addr
= priv
->cfg
->i2c_address
,
511 .flags
= I2C_M_RD
, .buf
= &bval
[0], .len
= 2 },
514 if (i2c_transfer(priv
->i2c
, msg
, 2) != 2) {
515 printk(KERN_WARNING
"xc5000: I2C read failed\n");
519 *val
= (bval
[0] << 8) | bval
[1];
523 static int xc5000_writeregs(struct xc5000_priv
*priv
, u8
*buf
, u8 len
)
525 struct i2c_msg msg
= { .addr
= priv
->cfg
->i2c_address
,
526 .flags
= 0, .buf
= buf
, .len
= len
};
528 if (i2c_transfer(priv
->i2c
, &msg
, 1) != 1) {
529 printk(KERN_ERR
"xc5000: I2C write failed (len=%i)\n",
536 static int xc5000_readregs(struct xc5000_priv
*priv
, u8
*buf
, u8 len
)
538 struct i2c_msg msg
= { .addr
= priv
->cfg
->i2c_address
,
539 .flags
= I2C_M_RD
, .buf
= buf
, .len
= len
};
541 if (i2c_transfer(priv
->i2c
, &msg
, 1) != 1) {
542 printk(KERN_ERR
"xc5000 I2C read failed (len=%i)\n",(int)len
);
548 static int xc5000_fwupload(struct dvb_frontend
* fe
)
550 struct xc5000_priv
*priv
= fe
->tuner_priv
;
551 const struct firmware
*fw
;
554 /* request the firmware, this will block and timeout */
555 printk(KERN_INFO
"xc5000: waiting for firmware upload (%s)...\n",
556 XC5000_DEFAULT_FIRMWARE
);
558 ret
= request_firmware(&fw
, XC5000_DEFAULT_FIRMWARE
, &priv
->i2c
->dev
);
560 printk(KERN_ERR
"xc5000: Upload failed. (file not found?)\n");
561 ret
= XC_RESULT_RESET_FAILURE
;
564 printk(KERN_INFO
"xc5000: firmware read %Zu bytes.\n",
566 ret
= XC_RESULT_SUCCESS
;
569 if (fw
->size
!= XC5000_DEFAULT_FIRMWARE_SIZE
) {
570 printk(KERN_ERR
"xc5000: firmware incorrect size\n");
571 ret
= XC_RESULT_RESET_FAILURE
;
573 printk(KERN_INFO
"xc5000: firmware upload\n");
574 ret
= xc_load_i2c_sequence(fe
, fw
->data
);
578 release_firmware(fw
);
582 static void xc_debug_dump(struct xc5000_priv
*priv
)
585 u32 freq_error_hz
= 0;
587 u32 hsync_freq_hz
= 0;
590 u8 hw_majorversion
= 0, hw_minorversion
= 0;
591 u8 fw_majorversion
= 0, fw_minorversion
= 0;
593 /* Wait for stats to stabilize.
594 * Frame Lines needs two frame times after initial lock
595 * before it is valid.
599 xc_get_ADC_Envelope(priv
, &adc_envelope
);
600 dprintk(1, "*** ADC envelope (0-1023) = %d\n", adc_envelope
);
602 xc_get_frequency_error(priv
, &freq_error_hz
);
603 dprintk(1, "*** Frequency error = %d Hz\n", freq_error_hz
);
605 xc_get_lock_status(priv
, &lock_status
);
606 dprintk(1, "*** Lock status (0-Wait, 1-Locked, 2-No-signal) = %d\n",
609 xc_get_version(priv
, &hw_majorversion
, &hw_minorversion
,
610 &fw_majorversion
, &fw_minorversion
);
611 dprintk(1, "*** HW: V%02x.%02x, FW: V%02x.%02x\n",
612 hw_majorversion
, hw_minorversion
,
613 fw_majorversion
, fw_minorversion
);
615 xc_get_hsync_freq(priv
, &hsync_freq_hz
);
616 dprintk(1, "*** Horizontal sync frequency = %d Hz\n", hsync_freq_hz
);
618 xc_get_frame_lines(priv
, &frame_lines
);
619 dprintk(1, "*** Frame lines = %d\n", frame_lines
);
621 xc_get_quality(priv
, &quality
);
622 dprintk(1, "*** Quality (0:<8dB, 7:>56dB) = %d\n", quality
);
625 static int xc5000_set_params(struct dvb_frontend
*fe
,
626 struct dvb_frontend_parameters
*params
)
628 struct xc5000_priv
*priv
= fe
->tuner_priv
;
631 dprintk(1, "%s() frequency=%d (Hz)\n", __func__
, params
->frequency
);
633 switch(params
->u
.vsb
.modulation
) {
636 dprintk(1, "%s() VSB modulation\n", __func__
);
637 priv
->rf_mode
= XC_RF_MODE_AIR
;
638 priv
->freq_hz
= params
->frequency
- 1750000;
639 priv
->bandwidth
= BANDWIDTH_6_MHZ
;
640 priv
->video_standard
= DTV6
;
645 dprintk(1, "%s() QAM modulation\n", __func__
);
646 priv
->rf_mode
= XC_RF_MODE_CABLE
;
647 priv
->freq_hz
= params
->frequency
- 1750000;
648 priv
->bandwidth
= BANDWIDTH_6_MHZ
;
649 priv
->video_standard
= DTV6
;
655 dprintk(1, "%s() frequency=%d (compensated)\n",
656 __func__
, priv
->freq_hz
);
658 ret
= xc_SetSignalSource(priv
, priv
->rf_mode
);
659 if (ret
!= XC_RESULT_SUCCESS
) {
661 "xc5000: xc_SetSignalSource(%d) failed\n",
666 ret
= xc_SetTVStandard(priv
,
667 XC5000_Standard
[priv
->video_standard
].VideoMode
,
668 XC5000_Standard
[priv
->video_standard
].AudioMode
);
669 if (ret
!= XC_RESULT_SUCCESS
) {
670 printk(KERN_ERR
"xc5000: xc_SetTVStandard failed\n");
674 ret
= xc_set_IF_frequency(priv
, priv
->cfg
->if_khz
);
675 if (ret
!= XC_RESULT_SUCCESS
) {
676 printk(KERN_ERR
"xc5000: xc_Set_IF_frequency(%d) failed\n",
681 xc_tune_channel(priv
, priv
->freq_hz
);
689 static int xc5000_is_firmware_loaded(struct dvb_frontend
*fe
)
691 struct xc5000_priv
*priv
= fe
->tuner_priv
;
695 ret
= xc5000_readreg(priv
, XREG_PRODUCT_ID
, &id
);
696 if (ret
== XC_RESULT_SUCCESS
) {
697 if (id
== XC_PRODUCT_ID_FW_NOT_LOADED
)
698 ret
= XC_RESULT_RESET_FAILURE
;
700 ret
= XC_RESULT_SUCCESS
;
703 dprintk(1, "%s() returns %s id = 0x%x\n", __func__
,
704 ret
== XC_RESULT_SUCCESS
? "True" : "False", id
);
708 static int xc_load_fw_and_init_tuner(struct dvb_frontend
*fe
);
710 static int xc5000_set_analog_params(struct dvb_frontend
*fe
,
711 struct analog_parameters
*params
)
713 struct xc5000_priv
*priv
= fe
->tuner_priv
;
716 if (xc5000_is_firmware_loaded(fe
) != XC_RESULT_SUCCESS
)
717 xc_load_fw_and_init_tuner(fe
);
719 dprintk(1, "%s() frequency=%d (in units of 62.5khz)\n",
720 __func__
, params
->frequency
);
722 priv
->rf_mode
= XC_RF_MODE_CABLE
; /* Fix me: it could be air. */
724 /* params->frequency is in units of 62.5khz */
725 priv
->freq_hz
= params
->frequency
* 62500;
727 /* FIX ME: Some video standards may have several possible audio
728 standards. We simply default to one of them here.
730 if(params
->std
& V4L2_STD_MN
) {
731 /* default to BTSC audio standard */
732 priv
->video_standard
= MN_NTSC_PAL_BTSC
;
736 if(params
->std
& V4L2_STD_PAL_BG
) {
737 /* default to NICAM audio standard */
738 priv
->video_standard
= BG_PAL_NICAM
;
742 if(params
->std
& V4L2_STD_PAL_I
) {
743 /* default to NICAM audio standard */
744 priv
->video_standard
= I_PAL_NICAM
;
748 if(params
->std
& V4L2_STD_PAL_DK
) {
749 /* default to NICAM audio standard */
750 priv
->video_standard
= DK_PAL_NICAM
;
754 if(params
->std
& V4L2_STD_SECAM_DK
) {
755 /* default to A2 DK1 audio standard */
756 priv
->video_standard
= DK_SECAM_A2DK1
;
760 if(params
->std
& V4L2_STD_SECAM_L
) {
761 priv
->video_standard
= L_SECAM_NICAM
;
765 if(params
->std
& V4L2_STD_SECAM_LC
) {
766 priv
->video_standard
= LC_SECAM_NICAM
;
771 ret
= xc_SetSignalSource(priv
, priv
->rf_mode
);
772 if (ret
!= XC_RESULT_SUCCESS
) {
774 "xc5000: xc_SetSignalSource(%d) failed\n",
779 ret
= xc_SetTVStandard(priv
,
780 XC5000_Standard
[priv
->video_standard
].VideoMode
,
781 XC5000_Standard
[priv
->video_standard
].AudioMode
);
782 if (ret
!= XC_RESULT_SUCCESS
) {
783 printk(KERN_ERR
"xc5000: xc_SetTVStandard failed\n");
787 xc_tune_channel(priv
, priv
->freq_hz
);
795 static int xc5000_get_frequency(struct dvb_frontend
*fe
, u32
*freq
)
797 struct xc5000_priv
*priv
= fe
->tuner_priv
;
798 dprintk(1, "%s()\n", __func__
);
799 *freq
= priv
->freq_hz
;
803 static int xc5000_get_bandwidth(struct dvb_frontend
*fe
, u32
*bw
)
805 struct xc5000_priv
*priv
= fe
->tuner_priv
;
806 dprintk(1, "%s()\n", __func__
);
808 *bw
= priv
->bandwidth
;
812 static int xc5000_get_status(struct dvb_frontend
*fe
, u32
*status
)
814 struct xc5000_priv
*priv
= fe
->tuner_priv
;
817 xc_get_lock_status(priv
, &lock_status
);
819 dprintk(1, "%s() lock_status = 0x%08x\n", __func__
, lock_status
);
821 *status
= lock_status
;
826 static int xc_load_fw_and_init_tuner(struct dvb_frontend
*fe
)
828 struct xc5000_priv
*priv
= fe
->tuner_priv
;
831 if (xc5000_is_firmware_loaded(fe
) != XC_RESULT_SUCCESS
) {
832 ret
= xc5000_fwupload(fe
);
833 if (ret
!= XC_RESULT_SUCCESS
)
837 /* Start the tuner self-calibration process */
838 ret
|= xc_initialize(priv
);
840 /* Wait for calibration to complete.
841 * We could continue but XC5000 will clock stretch subsequent
842 * I2C transactions until calibration is complete. This way we
843 * don't have to rely on clock stretching working.
847 /* Default to "CABLE" mode */
848 ret
|= xc_write_reg(priv
, XREG_SIGNALSOURCE
, XC_RF_MODE_CABLE
);
853 static int xc5000_sleep(struct dvb_frontend
*fe
)
855 struct xc5000_priv
*priv
= fe
->tuner_priv
;
858 dprintk(1, "%s()\n", __func__
);
860 /* On Pinnacle PCTV HD 800i, the tuner cannot be reinitialized
861 * once shutdown without reloading the driver. Maybe I am not
862 * doing something right.
866 ret
= xc_shutdown(priv
);
867 if(ret
!= XC_RESULT_SUCCESS
) {
869 "xc5000: %s() unable to shutdown tuner\n",
874 return XC_RESULT_SUCCESS
;
878 static int xc5000_init(struct dvb_frontend
*fe
)
880 struct xc5000_priv
*priv
= fe
->tuner_priv
;
881 dprintk(1, "%s()\n", __func__
);
883 if (xc_load_fw_and_init_tuner(fe
) != XC_RESULT_SUCCESS
) {
884 printk(KERN_ERR
"xc5000: Unable to initialise tuner\n");
894 static int xc5000_release(struct dvb_frontend
*fe
)
896 dprintk(1, "%s()\n", __func__
);
897 kfree(fe
->tuner_priv
);
898 fe
->tuner_priv
= NULL
;
902 static const struct dvb_tuner_ops xc5000_tuner_ops
= {
904 .name
= "Xceive XC5000",
905 .frequency_min
= 1000000,
906 .frequency_max
= 1023000000,
907 .frequency_step
= 50000,
910 .release
= xc5000_release
,
912 .sleep
= xc5000_sleep
,
914 .set_params
= xc5000_set_params
,
915 .set_analog_params
= xc5000_set_analog_params
,
916 .get_frequency
= xc5000_get_frequency
,
917 .get_bandwidth
= xc5000_get_bandwidth
,
918 .get_status
= xc5000_get_status
921 struct dvb_frontend
*xc5000_attach(struct dvb_frontend
*fe
,
922 struct i2c_adapter
*i2c
,
923 struct xc5000_config
*cfg
, void *devptr
)
925 struct xc5000_priv
*priv
= NULL
;
928 dprintk(1, "%s()\n", __func__
);
930 priv
= kzalloc(sizeof(struct xc5000_priv
), GFP_KERNEL
);
935 priv
->bandwidth
= BANDWIDTH_6_MHZ
;
937 priv
->devptr
= devptr
;
939 /* Check if firmware has been loaded. It is possible that another
940 instance of the driver has loaded the firmware.
942 if (xc5000_readreg(priv
, XREG_PRODUCT_ID
, &id
) != 0) {
948 case XC_PRODUCT_ID_FW_LOADED
:
950 "xc5000: Successfully identified at address 0x%02x\n",
953 "xc5000: Firmware has been loaded previously\n");
955 case XC_PRODUCT_ID_FW_NOT_LOADED
:
957 "xc5000: Successfully identified at address 0x%02x\n",
960 "xc5000: Firmware has not been loaded previously\n");
964 "xc5000: Device not found at addr 0x%02x (0x%x)\n",
965 cfg
->i2c_address
, id
);
970 memcpy(&fe
->ops
.tuner_ops
, &xc5000_tuner_ops
,
971 sizeof(struct dvb_tuner_ops
));
973 fe
->tuner_priv
= priv
;
977 EXPORT_SYMBOL(xc5000_attach
);
979 MODULE_AUTHOR("Steven Toth");
980 MODULE_DESCRIPTION("Xceive xc5000 silicon tuner driver");
981 MODULE_LICENSE("GPL");