1/* SPDX-License-Identifier: GPL-2.0-or-later */
2/*
3 tda18271-priv.h - private header for the NXP TDA18271 silicon tuner
4
5 Copyright (C) 2007, 2008 Michael Krufky <mkrufky@linuxtv.org>
6
7*/
8
9#ifndef __TDA18271_PRIV_H__
10#define __TDA18271_PRIV_H__
11
12#define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
13
14#include <linux/kernel.h>
15#include <linux/types.h>
16#include <linux/mutex.h>
17#include "tuner-i2c.h"
18#include "tda18271.h"
19
20#define R_ID 0x00 /* ID byte */
21#define R_TM 0x01 /* Thermo byte */
22#define R_PL 0x02 /* Power level byte */
23#define R_EP1 0x03 /* Easy Prog byte 1 */
24#define R_EP2 0x04 /* Easy Prog byte 2 */
25#define R_EP3 0x05 /* Easy Prog byte 3 */
26#define R_EP4 0x06 /* Easy Prog byte 4 */
27#define R_EP5 0x07 /* Easy Prog byte 5 */
28#define R_CPD 0x08 /* Cal Post-Divider byte */
29#define R_CD1 0x09 /* Cal Divider byte 1 */
30#define R_CD2 0x0a /* Cal Divider byte 2 */
31#define R_CD3 0x0b /* Cal Divider byte 3 */
32#define R_MPD 0x0c /* Main Post-Divider byte */
33#define R_MD1 0x0d /* Main Divider byte 1 */
34#define R_MD2 0x0e /* Main Divider byte 2 */
35#define R_MD3 0x0f /* Main Divider byte 3 */
36#define R_EB1 0x10 /* Extended byte 1 */
37#define R_EB2 0x11 /* Extended byte 2 */
38#define R_EB3 0x12 /* Extended byte 3 */
39#define R_EB4 0x13 /* Extended byte 4 */
40#define R_EB5 0x14 /* Extended byte 5 */
41#define R_EB6 0x15 /* Extended byte 6 */
42#define R_EB7 0x16 /* Extended byte 7 */
43#define R_EB8 0x17 /* Extended byte 8 */
44#define R_EB9 0x18 /* Extended byte 9 */
45#define R_EB10 0x19 /* Extended byte 10 */
46#define R_EB11 0x1a /* Extended byte 11 */
47#define R_EB12 0x1b /* Extended byte 12 */
48#define R_EB13 0x1c /* Extended byte 13 */
49#define R_EB14 0x1d /* Extended byte 14 */
50#define R_EB15 0x1e /* Extended byte 15 */
51#define R_EB16 0x1f /* Extended byte 16 */
52#define R_EB17 0x20 /* Extended byte 17 */
53#define R_EB18 0x21 /* Extended byte 18 */
54#define R_EB19 0x22 /* Extended byte 19 */
55#define R_EB20 0x23 /* Extended byte 20 */
56#define R_EB21 0x24 /* Extended byte 21 */
57#define R_EB22 0x25 /* Extended byte 22 */
58#define R_EB23 0x26 /* Extended byte 23 */
59
60#define TDA18271_NUM_REGS 39
61
62/*---------------------------------------------------------------------*/
63
64struct tda18271_rf_tracking_filter_cal {
65 u32 rfmax;
66 u8 rfband;
67 u32 rf1_def;
68 u32 rf2_def;
69 u32 rf3_def;
70 u32 rf1;
71 u32 rf2;
72 u32 rf3;
73 s32 rf_a1;
74 s32 rf_b1;
75 s32 rf_a2;
76 s32 rf_b2;
77};
78
79enum tda18271_pll {
80 TDA18271_MAIN_PLL,
81 TDA18271_CAL_PLL,
82};
83
84struct tda18271_map_layout;
85
86enum tda18271_ver {
87 TDA18271HDC1,
88 TDA18271HDC2,
89};
90
91struct tda18271_priv {
92 unsigned char tda18271_regs[TDA18271_NUM_REGS];
93
94 struct list_head hybrid_tuner_instance_list;
95 struct tuner_i2c_props i2c_props;
96
97 enum tda18271_mode mode;
98 enum tda18271_role role;
99 enum tda18271_i2c_gate gate;
100 enum tda18271_ver id;
101 enum tda18271_output_options output_opt;
102 enum tda18271_small_i2c small_i2c;
103
104 unsigned int config; /* interface to saa713x / tda829x */
105 unsigned int cal_initialized:1;
106
107 u8 tm_rfcal;
108
109 struct tda18271_map_layout *maps;
110 struct tda18271_std_map std;
111 struct tda18271_rf_tracking_filter_cal rf_cal_state[8];
112
113 struct mutex lock;
114
115 u16 if_freq;
116
117 u32 frequency;
118 u32 bandwidth;
119};
120
121/*---------------------------------------------------------------------*/
122
123extern int tda18271_debug;
124
125#define DBG_INFO 1
126#define DBG_MAP 2
127#define DBG_REG 4
128#define DBG_ADV 8
129#define DBG_CAL 16
130
131__attribute__((format(printf, 4, 5)))
132void _tda_printk(struct tda18271_priv *state, const char *level,
133 const char *func, const char *fmt, ...);
134
135#define tda_printk(st, lvl, fmt, arg...) \
136 _tda_printk(st, lvl, __func__, fmt, ##arg)
137
138#define tda_dprintk(st, lvl, fmt, arg...) \
139do { \
140 if (tda18271_debug & lvl) \
141 tda_printk(st, KERN_DEBUG, fmt, ##arg); \
142} while (0)
143
144#define tda_info(fmt, arg...) pr_info(fmt, ##arg)
145#define tda_warn(fmt, arg...) tda_printk(priv, KERN_WARNING, fmt, ##arg)
146#define tda_err(fmt, arg...) tda_printk(priv, KERN_ERR, fmt, ##arg)
147#define tda_dbg(fmt, arg...) tda_dprintk(priv, DBG_INFO, fmt, ##arg)
148#define tda_map(fmt, arg...) tda_dprintk(priv, DBG_MAP, fmt, ##arg)
149#define tda_reg(fmt, arg...) tda_dprintk(priv, DBG_REG, fmt, ##arg)
150#define tda_cal(fmt, arg...) tda_dprintk(priv, DBG_CAL, fmt, ##arg)
151
152#define tda_fail(ret) \
153({ \
154 int __ret; \
155 __ret = (ret < 0); \
156 if (__ret) \
157 tda_printk(priv, KERN_ERR, \
158 "error %d on line %d\n", ret, __LINE__); \
159 __ret; \
160})
161
162/*---------------------------------------------------------------------*/
163
164enum tda18271_map_type {
165 /* tda18271_pll_map */
166 MAIN_PLL,
167 CAL_PLL,
168 /* tda18271_map */
169 RF_CAL,
170 RF_CAL_KMCO,
171 RF_CAL_DC_OVER_DT,
172 BP_FILTER,
173 RF_BAND,
174 GAIN_TAPER,
175 IR_MEASURE,
176};
177
178extern int tda18271_lookup_pll_map(struct dvb_frontend *fe,
179 enum tda18271_map_type map_type,
180 u32 *freq, u8 *post_div, u8 *div);
181extern int tda18271_lookup_map(struct dvb_frontend *fe,
182 enum tda18271_map_type map_type,
183 u32 *freq, u8 *val);
184
185extern int tda18271_lookup_thermometer(struct dvb_frontend *fe);
186
187extern int tda18271_lookup_rf_band(struct dvb_frontend *fe,
188 u32 *freq, u8 *rf_band);
189
190extern int tda18271_lookup_cid_target(struct dvb_frontend *fe,
191 u32 *freq, u8 *cid_target,
192 u16 *count_limit);
193
194extern int tda18271_assign_map_layout(struct dvb_frontend *fe);
195
196/*---------------------------------------------------------------------*/
197
198extern int tda18271_read_regs(struct dvb_frontend *fe);
199extern int tda18271_read_extended(struct dvb_frontend *fe);
200extern int tda18271_write_regs(struct dvb_frontend *fe, int idx, int len);
201extern int tda18271_init_regs(struct dvb_frontend *fe);
202
203extern int tda18271_charge_pump_source(struct dvb_frontend *fe,
204 enum tda18271_pll pll, int force);
205extern int tda18271_set_standby_mode(struct dvb_frontend *fe,
206 int sm, int sm_lt, int sm_xt);
207
208extern int tda18271_calc_main_pll(struct dvb_frontend *fe, u32 freq);
209extern int tda18271_calc_cal_pll(struct dvb_frontend *fe, u32 freq);
210
211extern int tda18271_calc_bp_filter(struct dvb_frontend *fe, u32 *freq);
212extern int tda18271_calc_km(struct dvb_frontend *fe, u32 *freq);
213extern int tda18271_calc_rf_band(struct dvb_frontend *fe, u32 *freq);
214extern int tda18271_calc_gain_taper(struct dvb_frontend *fe, u32 *freq);
215extern int tda18271_calc_ir_measure(struct dvb_frontend *fe, u32 *freq);
216extern int tda18271_calc_rf_cal(struct dvb_frontend *fe, u32 *freq);
217
218#endif /* __TDA18271_PRIV_H__ */
219

source code of linux/drivers/media/tuners/tda18271-priv.h