1 /*
2     tda18271-priv.h - private header for the NXP TDA18271 silicon tuner
3 
4     Copyright (C) 2007, 2008 Michael Krufky <mkrufky@linuxtv.org>
5 
6     This program is free software; you can redistribute it and/or modify
7     it under the terms of the GNU General Public License as published by
8     the Free Software Foundation; either version 2 of the License, or
9     (at your option) any later version.
10 
11     This program is distributed in the hope that it will be useful,
12     but WITHOUT ANY WARRANTY; without even the implied warranty of
13     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14     GNU General Public License for more details.
15 
16     You should have received a copy of the GNU General Public License
17     along with this program; if not, write to the Free Software
18     Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
19 */
20 
21 #ifndef __TDA18271_PRIV_H__
22 #define __TDA18271_PRIV_H__
23 
24 #include <linux/kernel.h>
25 #include <linux/types.h>
26 #include <linux/mutex.h>
27 #include "tuner-i2c.h"
28 #include "tda18271.h"
29 
30 #define R_ID     0x00	/* ID byte                */
31 #define R_TM     0x01	/* Thermo byte            */
32 #define R_PL     0x02	/* Power level byte       */
33 #define R_EP1    0x03	/* Easy Prog byte 1       */
34 #define R_EP2    0x04	/* Easy Prog byte 2       */
35 #define R_EP3    0x05	/* Easy Prog byte 3       */
36 #define R_EP4    0x06	/* Easy Prog byte 4       */
37 #define R_EP5    0x07	/* Easy Prog byte 5       */
38 #define R_CPD    0x08	/* Cal Post-Divider byte  */
39 #define R_CD1    0x09	/* Cal Divider byte 1     */
40 #define R_CD2    0x0a	/* Cal Divider byte 2     */
41 #define R_CD3    0x0b	/* Cal Divider byte 3     */
42 #define R_MPD    0x0c	/* Main Post-Divider byte */
43 #define R_MD1    0x0d	/* Main Divider byte 1    */
44 #define R_MD2    0x0e	/* Main Divider byte 2    */
45 #define R_MD3    0x0f	/* Main Divider byte 3    */
46 #define R_EB1    0x10	/* Extended byte 1        */
47 #define R_EB2    0x11	/* Extended byte 2        */
48 #define R_EB3    0x12	/* Extended byte 3        */
49 #define R_EB4    0x13	/* Extended byte 4        */
50 #define R_EB5    0x14	/* Extended byte 5        */
51 #define R_EB6    0x15	/* Extended byte 6        */
52 #define R_EB7    0x16	/* Extended byte 7        */
53 #define R_EB8    0x17	/* Extended byte 8        */
54 #define R_EB9    0x18	/* Extended byte 9        */
55 #define R_EB10   0x19	/* Extended byte 10       */
56 #define R_EB11   0x1a	/* Extended byte 11       */
57 #define R_EB12   0x1b	/* Extended byte 12       */
58 #define R_EB13   0x1c	/* Extended byte 13       */
59 #define R_EB14   0x1d	/* Extended byte 14       */
60 #define R_EB15   0x1e	/* Extended byte 15       */
61 #define R_EB16   0x1f	/* Extended byte 16       */
62 #define R_EB17   0x20	/* Extended byte 17       */
63 #define R_EB18   0x21	/* Extended byte 18       */
64 #define R_EB19   0x22	/* Extended byte 19       */
65 #define R_EB20   0x23	/* Extended byte 20       */
66 #define R_EB21   0x24	/* Extended byte 21       */
67 #define R_EB22   0x25	/* Extended byte 22       */
68 #define R_EB23   0x26	/* Extended byte 23       */
69 
70 #define TDA18271_NUM_REGS 39
71 
72 /*---------------------------------------------------------------------*/
73 
74 struct tda18271_rf_tracking_filter_cal {
75 	u32 rfmax;
76 	u8  rfband;
77 	u32 rf1_def;
78 	u32 rf2_def;
79 	u32 rf3_def;
80 	u32 rf1;
81 	u32 rf2;
82 	u32 rf3;
83 	s32 rf_a1;
84 	s32 rf_b1;
85 	s32 rf_a2;
86 	s32 rf_b2;
87 };
88 
89 enum tda18271_pll {
90 	TDA18271_MAIN_PLL,
91 	TDA18271_CAL_PLL,
92 };
93 
94 struct tda18271_map_layout;
95 
96 enum tda18271_ver {
97 	TDA18271HDC1,
98 	TDA18271HDC2,
99 };
100 
101 struct tda18271_priv {
102 	unsigned char tda18271_regs[TDA18271_NUM_REGS];
103 
104 	struct list_head	hybrid_tuner_instance_list;
105 	struct tuner_i2c_props	i2c_props;
106 
107 	enum tda18271_mode mode;
108 	enum tda18271_role role;
109 	enum tda18271_i2c_gate gate;
110 	enum tda18271_ver id;
111 	enum tda18271_output_options output_opt;
112 	enum tda18271_small_i2c small_i2c;
113 
114 	unsigned int config; /* interface to saa713x / tda829x */
115 	unsigned int cal_initialized:1;
116 
117 	u8 tm_rfcal;
118 
119 	struct tda18271_map_layout *maps;
120 	struct tda18271_std_map std;
121 	struct tda18271_rf_tracking_filter_cal rf_cal_state[8];
122 
123 	struct mutex lock;
124 
125 	u32 frequency;
126 	u32 bandwidth;
127 };
128 
129 /*---------------------------------------------------------------------*/
130 
131 extern int tda18271_debug;
132 
133 #define DBG_INFO 1
134 #define DBG_MAP  2
135 #define DBG_REG  4
136 #define DBG_ADV  8
137 #define DBG_CAL  16
138 
139 #define tda_printk(st, kern, fmt, arg...) do {\
140 	if (st) { \
141 		struct tda18271_priv *state = st; \
142 		printk(kern "%s: [%d-%04x|%s] " fmt, __func__, \
143 			i2c_adapter_id(state->i2c_props.adap), \
144 			state->i2c_props.addr, \
145 			(state->role == TDA18271_MASTER) \
146 			? "M" : "S", ##arg); \
147 	} else \
148 		printk(kern "%s: " fmt, __func__, ##arg); \
149 } while (0)
150 
151 #define tda_dprintk(st, lvl, fmt, arg...) do {\
152 	if (tda18271_debug & lvl) \
153 		tda_printk(st, KERN_DEBUG, fmt, ##arg); } while (0)
154 
155 #define tda_info(fmt, arg...)     printk(KERN_INFO     fmt, ##arg)
156 #define tda_warn(fmt, arg...) tda_printk(priv, KERN_WARNING, fmt, ##arg)
157 #define tda_err(fmt, arg...)  tda_printk(priv, KERN_ERR,     fmt, ##arg)
158 #define tda_dbg(fmt, arg...)  tda_dprintk(priv, DBG_INFO,    fmt, ##arg)
159 #define tda_map(fmt, arg...)  tda_dprintk(priv, DBG_MAP,     fmt, ##arg)
160 #define tda_reg(fmt, arg...)  tda_dprintk(priv, DBG_REG,     fmt, ##arg)
161 #define tda_cal(fmt, arg...)  tda_dprintk(priv, DBG_CAL,     fmt, ##arg)
162 
163 #define tda_fail(ret)							     \
164 ({									     \
165 	int __ret;							     \
166 	__ret = (ret < 0);						     \
167 	if (__ret)							     \
168 		tda_printk(priv, KERN_ERR,				     \
169 			   "error %d on line %d\n", ret, __LINE__);	     \
170 	__ret;								     \
171 })
172 
173 /*---------------------------------------------------------------------*/
174 
175 enum tda18271_map_type {
176 	/* tda18271_pll_map */
177 	MAIN_PLL,
178 	CAL_PLL,
179 	/* tda18271_map */
180 	RF_CAL,
181 	RF_CAL_KMCO,
182 	RF_CAL_DC_OVER_DT,
183 	BP_FILTER,
184 	RF_BAND,
185 	GAIN_TAPER,
186 	IR_MEASURE,
187 };
188 
189 extern int tda18271_lookup_pll_map(struct dvb_frontend *fe,
190 				   enum tda18271_map_type map_type,
191 				   u32 *freq, u8 *post_div, u8 *div);
192 extern int tda18271_lookup_map(struct dvb_frontend *fe,
193 			       enum tda18271_map_type map_type,
194 			       u32 *freq, u8 *val);
195 
196 extern int tda18271_lookup_thermometer(struct dvb_frontend *fe);
197 
198 extern int tda18271_lookup_rf_band(struct dvb_frontend *fe,
199 				   u32 *freq, u8 *rf_band);
200 
201 extern int tda18271_lookup_cid_target(struct dvb_frontend *fe,
202 				      u32 *freq, u8 *cid_target,
203 				      u16 *count_limit);
204 
205 extern int tda18271_assign_map_layout(struct dvb_frontend *fe);
206 
207 /*---------------------------------------------------------------------*/
208 
209 extern int tda18271_read_regs(struct dvb_frontend *fe);
210 extern int tda18271_read_extended(struct dvb_frontend *fe);
211 extern int tda18271_write_regs(struct dvb_frontend *fe, int idx, int len);
212 extern int tda18271_init_regs(struct dvb_frontend *fe);
213 
214 extern int tda18271_charge_pump_source(struct dvb_frontend *fe,
215 				       enum tda18271_pll pll, int force);
216 extern int tda18271_set_standby_mode(struct dvb_frontend *fe,
217 				     int sm, int sm_lt, int sm_xt);
218 
219 extern int tda18271_calc_main_pll(struct dvb_frontend *fe, u32 freq);
220 extern int tda18271_calc_cal_pll(struct dvb_frontend *fe, u32 freq);
221 
222 extern int tda18271_calc_bp_filter(struct dvb_frontend *fe, u32 *freq);
223 extern int tda18271_calc_km(struct dvb_frontend *fe, u32 *freq);
224 extern int tda18271_calc_rf_band(struct dvb_frontend *fe, u32 *freq);
225 extern int tda18271_calc_gain_taper(struct dvb_frontend *fe, u32 *freq);
226 extern int tda18271_calc_ir_measure(struct dvb_frontend *fe, u32 *freq);
227 extern int tda18271_calc_rf_cal(struct dvb_frontend *fe, u32 *freq);
228 
229 #endif /* __TDA18271_PRIV_H__ */
230 
231 /*
232  * Overrides for Emacs so that we follow Linus's tabbing style.
233  * ---------------------------------------------------------------------------
234  * Local variables:
235  * c-basic-offset: 8
236  * End:
237  */
238