xref: /OK3568_Linux_fs/kernel/drivers/media/dvb-frontends/stb0899_drv.h (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1*4882a593Smuzhiyun /* SPDX-License-Identifier: GPL-2.0-or-later */
2*4882a593Smuzhiyun /*
3*4882a593Smuzhiyun 	STB0899 Multistandard Frontend driver
4*4882a593Smuzhiyun 	Copyright (C) Manu Abraham (abraham.manu@gmail.com)
5*4882a593Smuzhiyun 
6*4882a593Smuzhiyun 	Copyright (C) ST Microelectronics
7*4882a593Smuzhiyun 
8*4882a593Smuzhiyun */
9*4882a593Smuzhiyun 
10*4882a593Smuzhiyun #ifndef __STB0899_DRV_H
11*4882a593Smuzhiyun #define __STB0899_DRV_H
12*4882a593Smuzhiyun 
13*4882a593Smuzhiyun #include <linux/kernel.h>
14*4882a593Smuzhiyun #include <linux/module.h>
15*4882a593Smuzhiyun 
16*4882a593Smuzhiyun #include <media/dvb_frontend.h>
17*4882a593Smuzhiyun 
18*4882a593Smuzhiyun #define STB0899_TSMODE_SERIAL		1
19*4882a593Smuzhiyun #define STB0899_CLKPOL_FALLING		2
20*4882a593Smuzhiyun #define STB0899_CLKNULL_PARITY		3
21*4882a593Smuzhiyun #define STB0899_SYNC_FORCED		4
22*4882a593Smuzhiyun #define STB0899_FECMODE_DSS		5
23*4882a593Smuzhiyun 
24*4882a593Smuzhiyun struct stb0899_s1_reg {
25*4882a593Smuzhiyun 	u16	address;
26*4882a593Smuzhiyun 	u8	data;
27*4882a593Smuzhiyun };
28*4882a593Smuzhiyun 
29*4882a593Smuzhiyun struct stb0899_s2_reg {
30*4882a593Smuzhiyun 	u16	offset;
31*4882a593Smuzhiyun 	u32	base_address;
32*4882a593Smuzhiyun 	u32	data;
33*4882a593Smuzhiyun };
34*4882a593Smuzhiyun 
35*4882a593Smuzhiyun enum stb0899_inversion {
36*4882a593Smuzhiyun 	IQ_SWAP_OFF	= +1, /* inversion affects the sign of e. g. */
37*4882a593Smuzhiyun 	IQ_SWAP_ON	= -1, /* the derotator frequency register    */
38*4882a593Smuzhiyun };
39*4882a593Smuzhiyun 
40*4882a593Smuzhiyun #define STB0899_GPIO00				0xf140
41*4882a593Smuzhiyun #define STB0899_GPIO01				0xf141
42*4882a593Smuzhiyun #define STB0899_GPIO02				0xf142
43*4882a593Smuzhiyun #define STB0899_GPIO03				0xf143
44*4882a593Smuzhiyun #define STB0899_GPIO04				0xf144
45*4882a593Smuzhiyun #define STB0899_GPIO05				0xf145
46*4882a593Smuzhiyun #define STB0899_GPIO06				0xf146
47*4882a593Smuzhiyun #define STB0899_GPIO07				0xf147
48*4882a593Smuzhiyun #define STB0899_GPIO08				0xf148
49*4882a593Smuzhiyun #define STB0899_GPIO09				0xf149
50*4882a593Smuzhiyun #define STB0899_GPIO10				0xf14a
51*4882a593Smuzhiyun #define STB0899_GPIO11				0xf14b
52*4882a593Smuzhiyun #define STB0899_GPIO12				0xf14c
53*4882a593Smuzhiyun #define STB0899_GPIO13				0xf14d
54*4882a593Smuzhiyun #define STB0899_GPIO14				0xf14e
55*4882a593Smuzhiyun #define STB0899_GPIO15				0xf14f
56*4882a593Smuzhiyun #define STB0899_GPIO16				0xf150
57*4882a593Smuzhiyun #define STB0899_GPIO17				0xf151
58*4882a593Smuzhiyun #define STB0899_GPIO18				0xf152
59*4882a593Smuzhiyun #define STB0899_GPIO19				0xf153
60*4882a593Smuzhiyun #define STB0899_GPIO20				0xf154
61*4882a593Smuzhiyun 
62*4882a593Smuzhiyun #define STB0899_GPIOPULLUP			0x01 /* Output device is connected to Vdd */
63*4882a593Smuzhiyun #define STB0899_GPIOPULLDN			0x00 /* Output device is connected to Vss */
64*4882a593Smuzhiyun 
65*4882a593Smuzhiyun #define STB0899_POSTPROC_GPIO_POWER		0x00
66*4882a593Smuzhiyun #define STB0899_POSTPROC_GPIO_LOCK		0x01
67*4882a593Smuzhiyun 
68*4882a593Smuzhiyun /*
69*4882a593Smuzhiyun  * Post process output configuration control
70*4882a593Smuzhiyun  * 1. POWER ON/OFF		(index 0)
71*4882a593Smuzhiyun  * 2. FE_HAS_LOCK/LOCK_LOSS	(index 1)
72*4882a593Smuzhiyun  *
73*4882a593Smuzhiyun  * @gpio	= one of the above listed GPIO's
74*4882a593Smuzhiyun  * @level	= output state: pulled up or low
75*4882a593Smuzhiyun  */
76*4882a593Smuzhiyun struct stb0899_postproc {
77*4882a593Smuzhiyun 	u16	gpio;
78*4882a593Smuzhiyun 	u8	level;
79*4882a593Smuzhiyun };
80*4882a593Smuzhiyun 
81*4882a593Smuzhiyun struct stb0899_config {
82*4882a593Smuzhiyun 	const struct stb0899_s1_reg	*init_dev;
83*4882a593Smuzhiyun 	const struct stb0899_s2_reg	*init_s2_demod;
84*4882a593Smuzhiyun 	const struct stb0899_s1_reg	*init_s1_demod;
85*4882a593Smuzhiyun 	const struct stb0899_s2_reg	*init_s2_fec;
86*4882a593Smuzhiyun 	const struct stb0899_s1_reg	*init_tst;
87*4882a593Smuzhiyun 
88*4882a593Smuzhiyun 	const struct stb0899_postproc	*postproc;
89*4882a593Smuzhiyun 
90*4882a593Smuzhiyun 	enum stb0899_inversion		inversion;
91*4882a593Smuzhiyun 
92*4882a593Smuzhiyun 	u32	xtal_freq;
93*4882a593Smuzhiyun 
94*4882a593Smuzhiyun 	u8	demod_address;
95*4882a593Smuzhiyun 	u8	ts_output_mode;
96*4882a593Smuzhiyun 	u8	block_sync_mode;
97*4882a593Smuzhiyun 	u8	ts_pfbit_toggle;
98*4882a593Smuzhiyun 
99*4882a593Smuzhiyun 	u8	clock_polarity;
100*4882a593Smuzhiyun 	u8	data_clk_parity;
101*4882a593Smuzhiyun 	u8	fec_mode;
102*4882a593Smuzhiyun 	u8	data_output_ctl;
103*4882a593Smuzhiyun 	u8	data_fifo_mode;
104*4882a593Smuzhiyun 	u8	out_rate_comp;
105*4882a593Smuzhiyun 	u8	i2c_repeater;
106*4882a593Smuzhiyun //	int	inversion;
107*4882a593Smuzhiyun 	int	lo_clk;
108*4882a593Smuzhiyun 	int	hi_clk;
109*4882a593Smuzhiyun 
110*4882a593Smuzhiyun 	u32	esno_ave;
111*4882a593Smuzhiyun 	u32	esno_quant;
112*4882a593Smuzhiyun 	u32	avframes_coarse;
113*4882a593Smuzhiyun 	u32	avframes_fine;
114*4882a593Smuzhiyun 	u32	miss_threshold;
115*4882a593Smuzhiyun 	u32	uwp_threshold_acq;
116*4882a593Smuzhiyun 	u32	uwp_threshold_track;
117*4882a593Smuzhiyun 	u32	uwp_threshold_sof;
118*4882a593Smuzhiyun 	u32	sof_search_timeout;
119*4882a593Smuzhiyun 
120*4882a593Smuzhiyun 	u32	btr_nco_bits;
121*4882a593Smuzhiyun 	u32	btr_gain_shift_offset;
122*4882a593Smuzhiyun 	u32	crl_nco_bits;
123*4882a593Smuzhiyun 	u32	ldpc_max_iter;
124*4882a593Smuzhiyun 
125*4882a593Smuzhiyun 	int (*tuner_set_frequency)(struct dvb_frontend *fe, u32 frequency);
126*4882a593Smuzhiyun 	int (*tuner_get_frequency)(struct dvb_frontend *fe, u32 *frequency);
127*4882a593Smuzhiyun 	int (*tuner_set_bandwidth)(struct dvb_frontend *fe, u32 bandwidth);
128*4882a593Smuzhiyun 	int (*tuner_get_bandwidth)(struct dvb_frontend *fe, u32 *bandwidth);
129*4882a593Smuzhiyun 	int (*tuner_set_rfsiggain)(struct dvb_frontend *fe, u32 rf_gain);
130*4882a593Smuzhiyun };
131*4882a593Smuzhiyun 
132*4882a593Smuzhiyun #if IS_REACHABLE(CONFIG_DVB_STB0899)
133*4882a593Smuzhiyun 
134*4882a593Smuzhiyun extern struct dvb_frontend *stb0899_attach(struct stb0899_config *config,
135*4882a593Smuzhiyun 					   struct i2c_adapter *i2c);
136*4882a593Smuzhiyun 
137*4882a593Smuzhiyun #else
138*4882a593Smuzhiyun 
stb0899_attach(struct stb0899_config * config,struct i2c_adapter * i2c)139*4882a593Smuzhiyun static inline struct dvb_frontend *stb0899_attach(struct stb0899_config *config,
140*4882a593Smuzhiyun 						  struct i2c_adapter *i2c)
141*4882a593Smuzhiyun {
142*4882a593Smuzhiyun 	printk(KERN_WARNING "%s: Driver disabled by Kconfig\n", __func__);
143*4882a593Smuzhiyun 	return NULL;
144*4882a593Smuzhiyun }
145*4882a593Smuzhiyun 
146*4882a593Smuzhiyun #endif //CONFIG_DVB_STB0899
147*4882a593Smuzhiyun 
148*4882a593Smuzhiyun 
149*4882a593Smuzhiyun #endif
150