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