V4L/DVB (6978): tda18271: store frequency and bandwidth after successful tune
[linux-2.6] / drivers / media / dvb / frontends / tda18271-priv.h
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 "tda18271.h"
27
28 #define R_ID     0x00   /* ID byte                */
29 #define R_TM     0x01   /* Thermo byte            */
30 #define R_PL     0x02   /* Power level byte       */
31 #define R_EP1    0x03   /* Easy Prog byte 1       */
32 #define R_EP2    0x04   /* Easy Prog byte 2       */
33 #define R_EP3    0x05   /* Easy Prog byte 3       */
34 #define R_EP4    0x06   /* Easy Prog byte 4       */
35 #define R_EP5    0x07   /* Easy Prog byte 5       */
36 #define R_CPD    0x08   /* Cal Post-Divider byte  */
37 #define R_CD1    0x09   /* Cal Divider byte 1     */
38 #define R_CD2    0x0a   /* Cal Divider byte 2     */
39 #define R_CD3    0x0b   /* Cal Divider byte 3     */
40 #define R_MPD    0x0c   /* Main Post-Divider byte */
41 #define R_MD1    0x0d   /* Main Divider byte 1    */
42 #define R_MD2    0x0e   /* Main Divider byte 2    */
43 #define R_MD3    0x0f   /* Main Divider byte 3    */
44 #define R_EB1    0x10   /* Extended byte 1        */
45 #define R_EB2    0x11   /* Extended byte 2        */
46 #define R_EB3    0x12   /* Extended byte 3        */
47 #define R_EB4    0x13   /* Extended byte 4        */
48 #define R_EB5    0x14   /* Extended byte 5        */
49 #define R_EB6    0x15   /* Extended byte 6        */
50 #define R_EB7    0x16   /* Extended byte 7        */
51 #define R_EB8    0x17   /* Extended byte 8        */
52 #define R_EB9    0x18   /* Extended byte 9        */
53 #define R_EB10   0x19   /* Extended byte 10       */
54 #define R_EB11   0x1a   /* Extended byte 11       */
55 #define R_EB12   0x1b   /* Extended byte 12       */
56 #define R_EB13   0x1c   /* Extended byte 13       */
57 #define R_EB14   0x1d   /* Extended byte 14       */
58 #define R_EB15   0x1e   /* Extended byte 15       */
59 #define R_EB16   0x1f   /* Extended byte 16       */
60 #define R_EB17   0x20   /* Extended byte 17       */
61 #define R_EB18   0x21   /* Extended byte 18       */
62 #define R_EB19   0x22   /* Extended byte 19       */
63 #define R_EB20   0x23   /* Extended byte 20       */
64 #define R_EB21   0x24   /* Extended byte 21       */
65 #define R_EB22   0x25   /* Extended byte 22       */
66 #define R_EB23   0x26   /* Extended byte 23       */
67
68 #define TDA18271_NUM_REGS 39
69
70 /*---------------------------------------------------------------------*/
71
72 struct tda18271_rf_tracking_filter_cal {
73         u32 rfmax;
74         u8  rfband;
75         u32 rf1_def;
76         u32 rf2_def;
77         u32 rf3_def;
78         u32 rf1;
79         u32 rf2;
80         u32 rf3;
81         int rf_a1;
82         int rf_b1;
83         int rf_a2;
84         int rf_b2;
85 };
86
87 enum tda18271_mode {
88         TDA18271_ANALOG,
89         TDA18271_DIGITAL,
90 };
91
92 struct tda18271_map_layout;
93
94 enum tda18271_ver {
95         TDA18271HDC1,
96         TDA18271HDC2,
97 };
98
99 struct tda18271_priv {
100         u8 i2c_addr;
101         struct i2c_adapter *i2c_adap;
102         unsigned char tda18271_regs[TDA18271_NUM_REGS];
103
104         enum tda18271_mode mode;
105         enum tda18271_i2c_gate gate;
106         enum tda18271_ver id;
107
108         unsigned int tm_rfcal;
109         unsigned int cal_initialized:1;
110
111         struct tda18271_map_layout *maps;
112         struct tda18271_std_map std;
113         struct tda18271_rf_tracking_filter_cal rf_cal_state[8];
114
115         u32 frequency;
116         u32 bandwidth;
117 };
118
119 /*---------------------------------------------------------------------*/
120
121 extern int tda18271_debug;
122
123 #define DBG_INFO 1
124 #define DBG_MAP  2
125 #define DBG_REG  4
126 #define DBG_ADV  8
127
128 #define tda_printk(kern, fmt, arg...) \
129         printk(kern "%s: " fmt, __FUNCTION__, ##arg)
130
131 #define dprintk(kern, lvl, fmt, arg...) do {\
132         if (tda18271_debug & lvl) \
133                 tda_printk(kern, fmt, ##arg); } while (0)
134
135 #define tda_info(fmt, arg...) printk(KERN_INFO              fmt, ##arg)
136 #define tda_warn(fmt, arg...) tda_printk(KERN_WARNING,      fmt, ##arg)
137 #define tda_err(fmt, arg...)  tda_printk(KERN_ERR,          fmt, ##arg)
138 #define tda_dbg(fmt, arg...)  dprintk(KERN_DEBUG, DBG_INFO, fmt, ##arg)
139 #define tda_map(fmt, arg...)  dprintk(KERN_DEBUG, DBG_MAP,  fmt, ##arg)
140 #define tda_reg(fmt, arg...)  dprintk(KERN_DEBUG, DBG_REG,  fmt, ##arg)
141
142 /*---------------------------------------------------------------------*/
143
144 enum tda18271_map_type {
145         /* tda18271_pll_map */
146         MAIN_PLL,
147         CAL_PLL,
148         /* tda18271_map */
149         RF_CAL,
150         RF_CAL_KMCO,
151         RF_CAL_DC_OVER_DT,
152         BP_FILTER,
153         RF_BAND,
154         GAIN_TAPER,
155         IR_MEASURE,
156 };
157
158 extern int tda18271_lookup_pll_map(struct dvb_frontend *fe,
159                                    enum tda18271_map_type map_type,
160                                    u32 *freq, u8 *post_div, u8 *div);
161 extern int tda18271_lookup_map(struct dvb_frontend *fe,
162                                enum tda18271_map_type map_type,
163                                u32 *freq, u8 *val);
164
165 extern int tda18271_lookup_thermometer(struct dvb_frontend *fe);
166
167 extern int tda18271_lookup_rf_band(struct dvb_frontend *fe,
168                                    u32 *freq, u8 *rf_band);
169
170 extern int tda18271_lookup_cid_target(struct dvb_frontend *fe,
171                                       u32 *freq, u8 *cid_target,
172                                       u16 *count_limit);
173
174 extern int tda18271_assign_map_layout(struct dvb_frontend *fe);
175
176 /*---------------------------------------------------------------------*/
177
178 extern int tda18271_read_regs(struct dvb_frontend *fe);
179 extern int tda18271_read_extended(struct dvb_frontend *fe);
180 extern int tda18271_write_regs(struct dvb_frontend *fe, int idx, int len);
181 extern int tda18271_init_regs(struct dvb_frontend *fe);
182
183 extern int tda18271_calc_main_pll(struct dvb_frontend *fe, u32 freq);
184 extern int tda18271_calc_cal_pll(struct dvb_frontend *fe, u32 freq);
185
186 extern int tda18271_calc_bp_filter(struct dvb_frontend *fe, u32 *freq);
187 extern int tda18271_calc_km(struct dvb_frontend *fe, u32 *freq);
188 extern int tda18271_calc_rf_band(struct dvb_frontend *fe, u32 *freq);
189 extern int tda18271_calc_gain_taper(struct dvb_frontend *fe, u32 *freq);
190 extern int tda18271_calc_ir_measure(struct dvb_frontend *fe, u32 *freq);
191 extern int tda18271_calc_rf_cal(struct dvb_frontend *fe, u32 *freq);
192
193 #endif /* __TDA18271_PRIV_H__ */
194
195 /*
196  * Overrides for Emacs so that we follow Linus's tabbing style.
197  * ---------------------------------------------------------------------------
198  * Local variables:
199  * c-basic-offset: 8
200  * End:
201  */