1 /* SPDX-License-Identifier: GPL-2.0-or-later */
2 /*
3 STV0900/0903 Multistandard Broadcast Frontend driver
4 Copyright (C) Manu Abraham <abraham.manu@gmail.com>
5
6 Copyright (C) ST Microelectronics
7
8 */
9
10 #ifndef __STV090x_H
11 #define __STV090x_H
12
13 enum stv090x_demodulator {
14 STV090x_DEMODULATOR_0 = 1,
15 STV090x_DEMODULATOR_1
16 };
17
18 enum stv090x_device {
19 STV0903 = 0,
20 STV0900,
21 };
22
23 enum stv090x_mode {
24 STV090x_DUAL = 0,
25 STV090x_SINGLE
26 };
27
28 enum stv090x_tsmode {
29 STV090x_TSMODE_SERIAL_PUNCTURED = 1,
30 STV090x_TSMODE_SERIAL_CONTINUOUS,
31 STV090x_TSMODE_PARALLEL_PUNCTURED,
32 STV090x_TSMODE_DVBCI
33 };
34
35 enum stv090x_clkmode {
36 STV090x_CLK_INT = 0, /* Clk i/p = CLKI */
37 STV090x_CLK_EXT = 2 /* Clk i/p = XTALI */
38 };
39
40 enum stv090x_i2crpt {
41 STV090x_RPTLEVEL_256 = 0,
42 STV090x_RPTLEVEL_128 = 1,
43 STV090x_RPTLEVEL_64 = 2,
44 STV090x_RPTLEVEL_32 = 3,
45 STV090x_RPTLEVEL_16 = 4,
46 STV090x_RPTLEVEL_8 = 5,
47 STV090x_RPTLEVEL_4 = 6,
48 STV090x_RPTLEVEL_2 = 7,
49 };
50
51 enum stv090x_adc_range {
52 STV090x_ADC_2Vpp = 0,
53 STV090x_ADC_1Vpp = 1
54 };
55
56 struct stv090x_config {
57 enum stv090x_device device;
58 enum stv090x_mode demod_mode;
59 enum stv090x_clkmode clk_mode;
60 enum stv090x_demodulator demod;
61
62 u32 xtal; /* default: 8000000 */
63 u8 address; /* default: 0x68 */
64
65 u8 ts1_mode;
66 u8 ts2_mode;
67 u32 ts1_clk;
68 u32 ts2_clk;
69
70 u8 ts1_tei : 1;
71 u8 ts2_tei : 1;
72
73 enum stv090x_i2crpt repeater_level;
74
75 u8 tuner_bbgain; /* default: 10db */
76 enum stv090x_adc_range adc1_range; /* default: 2Vpp */
77 enum stv090x_adc_range adc2_range; /* default: 2Vpp */
78
79 bool diseqc_envelope_mode;
80
81 int (*tuner_init)(struct dvb_frontend *fe);
82 int (*tuner_sleep)(struct dvb_frontend *fe);
83 int (*tuner_set_mode)(struct dvb_frontend *fe, enum tuner_mode mode);
84 int (*tuner_set_frequency)(struct dvb_frontend *fe, u32 frequency);
85 int (*tuner_get_frequency)(struct dvb_frontend *fe, u32 *frequency);
86 int (*tuner_set_bandwidth)(struct dvb_frontend *fe, u32 bandwidth);
87 int (*tuner_get_bandwidth)(struct dvb_frontend *fe, u32 *bandwidth);
88 int (*tuner_set_bbgain)(struct dvb_frontend *fe, u32 gain);
89 int (*tuner_get_bbgain)(struct dvb_frontend *fe, u32 *gain);
90 int (*tuner_set_refclk)(struct dvb_frontend *fe, u32 refclk);
91 int (*tuner_get_status)(struct dvb_frontend *fe, u32 *status);
92 void (*tuner_i2c_lock)(struct dvb_frontend *fe, int lock);
93
94 /* dir = 0 -> output, dir = 1 -> input/open-drain */
95 int (*set_gpio)(struct dvb_frontend *fe, u8 gpio, u8 dir, u8 value,
96 u8 xor_value);
97
98 struct dvb_frontend* (*get_dvb_frontend)(struct i2c_client *i2c);
99 };
100
101 #if IS_REACHABLE(CONFIG_DVB_STV090x)
102
103 struct dvb_frontend *stv090x_attach(struct stv090x_config *config,
104 struct i2c_adapter *i2c,
105 enum stv090x_demodulator demod);
106
107 #else
108
stv090x_attach(const struct stv090x_config * config,struct i2c_adapter * i2c,enum stv090x_demodulator demod)109 static inline struct dvb_frontend *stv090x_attach(const struct stv090x_config *config,
110 struct i2c_adapter *i2c,
111 enum stv090x_demodulator demod)
112 {
113 printk(KERN_WARNING "%s: driver disabled by Kconfig\n", __func__);
114 return NULL;
115 }
116
117 #endif /* CONFIG_DVB_STV090x */
118
119 #endif /* __STV090x_H */
120