blob: 4c418d63f540d539f049781be691d9388b7dcdea [file] [log] [blame]
Michael Krufky5bea1cd2007-10-22 09:56:38 -03001/*
2 tda18271.h - header for the Philips / NXP TDA18271 silicon tuner
3
Michael Krufky59067f72008-01-02 01:58:26 -03004 Copyright (C) 2007, 2008 Michael Krufky <mkrufky@linuxtv.org>
Michael Krufky5bea1cd2007-10-22 09:56:38 -03005
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_H__
22#define __TDA18271_H__
23
24#include <linux/i2c.h>
25#include "dvb_frontend.h"
26
Michael Krufkyf21e0d72008-01-02 03:01:54 -030027struct tda18271_std_map_item {
Michael Krufky2ba65d52008-01-03 01:17:45 -030028 u16 if_freq;
Michael Krufky7f7203d2008-04-22 14:46:06 -030029
30 /* EP3[4:3] */
31 unsigned int agc_mode:2;
32 /* EP3[2:0] */
33 unsigned int std:3;
34 /* EP4[7] */
Michael Krufkyc293d0a2008-04-22 14:46:06 -030035 unsigned int fm_rfn:1;
Michael Krufky14c74b22008-04-22 14:46:21 -030036 /* EP4[4:2] */
37 unsigned int if_lvl:3;
Michael Krufkyc0dc0c12008-04-22 14:46:22 -030038 /* EB22[6:0] */
39 unsigned int rfagc_top:7;
Michael Krufkyf21e0d72008-01-02 03:01:54 -030040};
41
42struct tda18271_std_map {
Michael Krufkyc353f422008-01-08 10:38:10 -030043 struct tda18271_std_map_item fm_radio;
Michael Krufkyf21e0d72008-01-02 03:01:54 -030044 struct tda18271_std_map_item atv_b;
45 struct tda18271_std_map_item atv_dk;
46 struct tda18271_std_map_item atv_gh;
47 struct tda18271_std_map_item atv_i;
48 struct tda18271_std_map_item atv_l;
49 struct tda18271_std_map_item atv_lc;
50 struct tda18271_std_map_item atv_mn;
51 struct tda18271_std_map_item atsc_6;
52 struct tda18271_std_map_item dvbt_6;
53 struct tda18271_std_map_item dvbt_7;
54 struct tda18271_std_map_item dvbt_8;
55 struct tda18271_std_map_item qam_6;
Mauro Carvalho Chehabce0e93a2011-12-21 08:07:52 -030056 struct tda18271_std_map_item qam_7;
Michael Krufkyf21e0d72008-01-02 03:01:54 -030057 struct tda18271_std_map_item qam_8;
58};
59
Michael Krufky868f5cc2008-04-22 14:46:23 -030060enum tda18271_role {
61 TDA18271_MASTER = 0,
62 TDA18271_SLAVE,
63};
64
Michael Krufkye435f952007-12-09 22:23:30 -030065enum tda18271_i2c_gate {
66 TDA18271_GATE_AUTO = 0,
67 TDA18271_GATE_ANALOG,
68 TDA18271_GATE_DIGITAL,
69};
70
Michael Krufky4240b462009-08-29 16:25:37 -030071enum tda18271_output_options {
72 /* slave tuner output & loop thru & xtal oscillator always on */
73 TDA18271_OUTPUT_LT_XT_ON = 0,
Michael Krufky81259f22008-05-11 12:46:52 -030074
Michael Krufky4240b462009-08-29 16:25:37 -030075 /* slave tuner output loop thru off */
76 TDA18271_OUTPUT_LT_OFF = 1,
Michael Krufky81259f22008-05-11 12:46:52 -030077
Michael Krufky4240b462009-08-29 16:25:37 -030078 /* xtal oscillator off */
79 TDA18271_OUTPUT_XT_OFF = 2,
Michael Krufky81259f22008-05-11 12:46:52 -030080};
81
Michael Krufky1724c8f2009-10-23 02:47:49 -030082enum tda18271_small_i2c {
83 TDA18271_39_BYTE_CHUNK_INIT = 0,
Mauro Carvalho Chehabe350d442010-09-26 22:58:28 -030084 TDA18271_16_BYTE_CHUNK_INIT = 16,
85 TDA18271_08_BYTE_CHUNK_INIT = 8,
86 TDA18271_03_BYTE_CHUNK_INIT = 3,
Michael Krufky1724c8f2009-10-23 02:47:49 -030087};
88
Michael Krufkyf21e0d72008-01-02 03:01:54 -030089struct tda18271_config {
Michael Krufky0e1fab92008-01-03 01:40:47 -030090 /* override default if freq / std settings (optional) */
Michael Krufkyf21e0d72008-01-02 03:01:54 -030091 struct tda18271_std_map *std_map;
Michael Krufky0e1fab92008-01-03 01:40:47 -030092
Michael Krufky868f5cc2008-04-22 14:46:23 -030093 /* master / slave tuner: master uses main pll, slave uses cal pll */
94 enum tda18271_role role;
95
Michael Krufky0e1fab92008-01-03 01:40:47 -030096 /* use i2c gate provided by analog or digital demod */
Michael Krufkyf21e0d72008-01-02 03:01:54 -030097 enum tda18271_i2c_gate gate;
Michael Krufky55553092008-04-22 14:46:06 -030098
Michael Krufky4240b462009-08-29 16:25:37 -030099 /* output options that can be disabled */
100 enum tda18271_output_options output_opt;
Michael Krufky81259f22008-05-11 12:46:52 -0300101
Lucas De Marchi25985ed2011-03-30 22:57:33 -0300102 /* some i2c providers can't write all 39 registers at once */
Michael Krufky1724c8f2009-10-23 02:47:49 -0300103 enum tda18271_small_i2c small_i2c;
104
Michael Krufky81016b42009-08-27 16:58:06 -0300105 /* force rf tracking filter calibration on startup */
106 unsigned int rf_cal_on_startup:1;
107
Michael Krufky6b82e0c2012-10-01 23:50:37 -0300108 /* prevent any register access during attach(),
109 * delaying both IR & RF calibration until init()
110 * module option 'cal' overrides this delay */
111 unsigned int delay_cal:1;
112
Michael Krufkyadcc4b32009-03-04 19:42:06 -0300113 /* interface to saa713x / tda829x */
114 unsigned int config;
115};
116
117#define TDA18271_CALLBACK_CMD_AGC_ENABLE 0
118
119enum tda18271_mode {
120 TDA18271_ANALOG = 0,
121 TDA18271_DIGITAL,
Michael Krufkyf21e0d72008-01-02 03:01:54 -0300122};
123
Peter Senna Tschudin7b34be72013-01-20 01:32:56 -0300124#if IS_ENABLED(CONFIG_MEDIA_TUNER_TDA18271)
Michael Krufky5bea1cd2007-10-22 09:56:38 -0300125extern struct dvb_frontend *tda18271_attach(struct dvb_frontend *fe, u8 addr,
Michael Krufkye435f952007-12-09 22:23:30 -0300126 struct i2c_adapter *i2c,
Michael Krufkyf21e0d72008-01-02 03:01:54 -0300127 struct tda18271_config *cfg);
Michael Krufky5bea1cd2007-10-22 09:56:38 -0300128#else
129static inline struct dvb_frontend *tda18271_attach(struct dvb_frontend *fe,
130 u8 addr,
Michael Krufkye435f952007-12-09 22:23:30 -0300131 struct i2c_adapter *i2c,
Michael Krufkyf21e0d72008-01-02 03:01:54 -0300132 struct tda18271_config *cfg)
Michael Krufky5bea1cd2007-10-22 09:56:38 -0300133{
Harvey Harrison271ddbf2008-04-08 23:20:00 -0300134 printk(KERN_WARNING "%s: driver disabled by Kconfig\n", __func__);
Michael Krufky5bea1cd2007-10-22 09:56:38 -0300135 return NULL;
136}
137#endif
138
139#endif /* __TDA18271_H__ */