xref: /OK3568_Linux_fs/kernel/drivers/media/dvb-frontends/stv0299.h (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1*4882a593Smuzhiyun /* SPDX-License-Identifier: GPL-2.0-or-later */
2*4882a593Smuzhiyun /*
3*4882a593Smuzhiyun     Driver for ST STV0299 demodulator
4*4882a593Smuzhiyun 
5*4882a593Smuzhiyun     Copyright (C) 2001-2002 Convergence Integrated Media GmbH
6*4882a593Smuzhiyun 	<ralph@convergence.de>,
7*4882a593Smuzhiyun 	<holger@convergence.de>,
8*4882a593Smuzhiyun 	<js@convergence.de>
9*4882a593Smuzhiyun 
10*4882a593Smuzhiyun 
11*4882a593Smuzhiyun     Philips SU1278/SH
12*4882a593Smuzhiyun 
13*4882a593Smuzhiyun     Copyright (C) 2002 by Peter Schildmann <peter.schildmann@web.de>
14*4882a593Smuzhiyun 
15*4882a593Smuzhiyun 
16*4882a593Smuzhiyun     LG TDQF-S001F
17*4882a593Smuzhiyun 
18*4882a593Smuzhiyun     Copyright (C) 2002 Felix Domke <tmbinc@elitedvb.net>
19*4882a593Smuzhiyun 		     & Andreas Oberritter <obi@linuxtv.org>
20*4882a593Smuzhiyun 
21*4882a593Smuzhiyun 
22*4882a593Smuzhiyun     Support for Samsung TBMU24112IMB used on Technisat SkyStar2 rev. 2.6B
23*4882a593Smuzhiyun 
24*4882a593Smuzhiyun     Copyright (C) 2003 Vadim Catana <skystar@moldova.cc>:
25*4882a593Smuzhiyun 
26*4882a593Smuzhiyun     Support for Philips SU1278 on Technotrend hardware
27*4882a593Smuzhiyun 
28*4882a593Smuzhiyun     Copyright (C) 2004 Andrew de Quincey <adq_dvb@lidskialf.net>
29*4882a593Smuzhiyun 
30*4882a593Smuzhiyun 
31*4882a593Smuzhiyun */
32*4882a593Smuzhiyun 
33*4882a593Smuzhiyun #ifndef STV0299_H
34*4882a593Smuzhiyun #define STV0299_H
35*4882a593Smuzhiyun 
36*4882a593Smuzhiyun #include <linux/dvb/frontend.h>
37*4882a593Smuzhiyun #include <media/dvb_frontend.h>
38*4882a593Smuzhiyun 
39*4882a593Smuzhiyun #define STV0299_LOCKOUTPUT_0  0
40*4882a593Smuzhiyun #define STV0299_LOCKOUTPUT_1  1
41*4882a593Smuzhiyun #define STV0299_LOCKOUTPUT_CF 2
42*4882a593Smuzhiyun #define STV0299_LOCKOUTPUT_LK 3
43*4882a593Smuzhiyun 
44*4882a593Smuzhiyun #define STV0299_VOLT13_OP0 0
45*4882a593Smuzhiyun #define STV0299_VOLT13_OP1 1
46*4882a593Smuzhiyun 
47*4882a593Smuzhiyun struct stv0299_config
48*4882a593Smuzhiyun {
49*4882a593Smuzhiyun 	/* the demodulator's i2c address */
50*4882a593Smuzhiyun 	u8 demod_address;
51*4882a593Smuzhiyun 
52*4882a593Smuzhiyun 	/* inittab - array of pairs of values.
53*4882a593Smuzhiyun 	 * First of each pair is the register, second is the value.
54*4882a593Smuzhiyun 	 * List should be terminated with an 0xff, 0xff pair.
55*4882a593Smuzhiyun 	 */
56*4882a593Smuzhiyun 	const u8* inittab;
57*4882a593Smuzhiyun 
58*4882a593Smuzhiyun 	/* master clock to use */
59*4882a593Smuzhiyun 	u32 mclk;
60*4882a593Smuzhiyun 
61*4882a593Smuzhiyun 	/* does the inversion require inversion? */
62*4882a593Smuzhiyun 	u8 invert:1;
63*4882a593Smuzhiyun 
64*4882a593Smuzhiyun 	/* Skip reinitialisation? */
65*4882a593Smuzhiyun 	u8 skip_reinit:1;
66*4882a593Smuzhiyun 
67*4882a593Smuzhiyun 	/* LOCK OUTPUT setting */
68*4882a593Smuzhiyun 	u8 lock_output:2;
69*4882a593Smuzhiyun 
70*4882a593Smuzhiyun 	/* Is 13v controlled by OP0 or OP1? */
71*4882a593Smuzhiyun 	u8 volt13_op0_op1:1;
72*4882a593Smuzhiyun 
73*4882a593Smuzhiyun 	/* Turn-off OP0? */
74*4882a593Smuzhiyun 	u8 op0_off:1;
75*4882a593Smuzhiyun 
76*4882a593Smuzhiyun 	/* minimum delay before retuning */
77*4882a593Smuzhiyun 	int min_delay_ms;
78*4882a593Smuzhiyun 
79*4882a593Smuzhiyun 	/* Set the symbol rate */
80*4882a593Smuzhiyun 	int (*set_symbol_rate)(struct dvb_frontend *fe, u32 srate, u32 ratio);
81*4882a593Smuzhiyun 
82*4882a593Smuzhiyun 	/* Set device param to start dma */
83*4882a593Smuzhiyun 	int (*set_ts_params)(struct dvb_frontend *fe, int is_punctured);
84*4882a593Smuzhiyun };
85*4882a593Smuzhiyun 
86*4882a593Smuzhiyun #if IS_REACHABLE(CONFIG_DVB_STV0299)
87*4882a593Smuzhiyun extern struct dvb_frontend *stv0299_attach(const struct stv0299_config *config,
88*4882a593Smuzhiyun 					   struct i2c_adapter *i2c);
89*4882a593Smuzhiyun #else
stv0299_attach(const struct stv0299_config * config,struct i2c_adapter * i2c)90*4882a593Smuzhiyun static inline struct dvb_frontend *stv0299_attach(const struct stv0299_config *config,
91*4882a593Smuzhiyun 					   struct i2c_adapter *i2c)
92*4882a593Smuzhiyun {
93*4882a593Smuzhiyun 	printk(KERN_WARNING "%s: driver disabled by Kconfig\n", __func__);
94*4882a593Smuzhiyun 	return NULL;
95*4882a593Smuzhiyun }
96*4882a593Smuzhiyun #endif // CONFIG_DVB_STV0299
97*4882a593Smuzhiyun 
stv0299_writereg(struct dvb_frontend * fe,u8 reg,u8 val)98*4882a593Smuzhiyun static inline int stv0299_writereg(struct dvb_frontend *fe, u8 reg, u8 val) {
99*4882a593Smuzhiyun 	int r = 0;
100*4882a593Smuzhiyun 	u8 buf[] = {reg, val};
101*4882a593Smuzhiyun 	if (fe->ops.write)
102*4882a593Smuzhiyun 		r = fe->ops.write(fe, buf, 2);
103*4882a593Smuzhiyun 	return r;
104*4882a593Smuzhiyun }
105*4882a593Smuzhiyun 
106*4882a593Smuzhiyun #endif // STV0299_H
107