GNU Linux-libre 4.14.266-gnu1
[releases.git] / drivers / media / dvb-frontends / af9013.h
1 /*
2  * Afatech AF9013 demodulator driver
3  *
4  * Copyright (C) 2007 Antti Palosaari <crope@iki.fi>
5  * Copyright (C) 2011 Antti Palosaari <crope@iki.fi>
6  *
7  * Thanks to Afatech who kindly provided information.
8  *
9  *    This program is free software; you can redistribute it and/or modify
10  *    it under the terms of the GNU General Public License as published by
11  *    the Free Software Foundation; either version 2 of the License, or
12  *    (at your option) any later version.
13  *
14  *    This program is distributed in the hope that it will be useful,
15  *    but WITHOUT ANY WARRANTY; without even the implied warranty of
16  *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
17  *    GNU General Public License for more details.
18  *
19  */
20
21 #ifndef AF9013_H
22 #define AF9013_H
23
24 #include <linux/dvb/frontend.h>
25
26 /*
27  * I2C address: 0x1c, 0x1d
28  */
29
30 /**
31  * struct af9013_platform_data - Platform data for the af9013 driver
32  * @clk: Clock frequency.
33  * @tuner: Used tuner model.
34  * @if_frequency: IF frequency.
35  * @ts_mode: TS mode.
36  * @ts_output_pin: TS output pin.
37  * @spec_inv: Input spectrum inverted.
38  * @api_version: Firmware API version.
39  * @gpio: GPIOs.
40  * @get_dvb_frontend: Get DVB frontend callback.
41  */
42 struct af9013_platform_data {
43         /*
44          * 20480000, 25000000, 28000000, 28800000
45          */
46         u32 clk;
47 #define AF9013_TUNER_MXL5003D      3 /* MaxLinear */
48 #define AF9013_TUNER_MXL5005D     13 /* MaxLinear */
49 #define AF9013_TUNER_MXL5005R     30 /* MaxLinear */
50 #define AF9013_TUNER_ENV77H11D5  129 /* Panasonic */
51 #define AF9013_TUNER_MT2060      130 /* Microtune */
52 #define AF9013_TUNER_MC44S803    133 /* Freescale */
53 #define AF9013_TUNER_QT1010      134 /* Quantek */
54 #define AF9013_TUNER_UNKNOWN     140 /* for can tuners ? */
55 #define AF9013_TUNER_MT2060_2    147 /* Microtune */
56 #define AF9013_TUNER_TDA18271    156 /* NXP */
57 #define AF9013_TUNER_QT1010A     162 /* Quantek */
58 #define AF9013_TUNER_MXL5007T    177 /* MaxLinear */
59 #define AF9013_TUNER_TDA18218    179 /* NXP */
60         u8 tuner;
61         u32 if_frequency;
62 #define AF9013_TS_MODE_USB       0
63 #define AF9013_TS_MODE_PARALLEL  1
64 #define AF9013_TS_MODE_SERIAL    2
65         u8 ts_mode;
66         u8 ts_output_pin;
67         bool spec_inv;
68         u8 api_version[4];
69 #define AF9013_GPIO_ON (1 << 0)
70 #define AF9013_GPIO_EN (1 << 1)
71 #define AF9013_GPIO_O  (1 << 2)
72 #define AF9013_GPIO_I  (1 << 3)
73 #define AF9013_GPIO_LO (AF9013_GPIO_ON|AF9013_GPIO_EN)
74 #define AF9013_GPIO_HI (AF9013_GPIO_ON|AF9013_GPIO_EN|AF9013_GPIO_O)
75 #define AF9013_GPIO_TUNER_ON  (AF9013_GPIO_ON|AF9013_GPIO_EN)
76 #define AF9013_GPIO_TUNER_OFF (AF9013_GPIO_ON|AF9013_GPIO_EN|AF9013_GPIO_O)
77         u8 gpio[4];
78
79         struct dvb_frontend* (*get_dvb_frontend)(struct i2c_client *);
80
81 /* private: For legacy media attach wrapper. Do not set value. */
82         bool attach_in_use;
83         u8 i2c_addr;
84         u32 clock;
85 };
86
87 #define af9013_config       af9013_platform_data
88 #define AF9013_TS_USB       AF9013_TS_MODE_USB
89 #define AF9013_TS_PARALLEL  AF9013_TS_MODE_PARALLEL
90 #define AF9013_TS_SERIAL    AF9013_TS_MODE_SERIAL
91
92 /*
93  * AF9013/5 GPIOs (mostly guessed)
94  * demod#1-gpio#0 - set demod#2 i2c-addr for dual devices
95  * demod#1-gpio#1 - xtal setting (?)
96  * demod#1-gpio#3 - tuner#1
97  * demod#2-gpio#0 - tuner#2
98  * demod#2-gpio#1 - xtal setting (?)
99  */
100
101 #if IS_REACHABLE(CONFIG_DVB_AF9013)
102 extern struct dvb_frontend *af9013_attach(const struct af9013_config *config,
103         struct i2c_adapter *i2c);
104 #else
105 static inline struct dvb_frontend *af9013_attach(
106 const struct af9013_config *config, struct i2c_adapter *i2c)
107 {
108         pr_warn("%s: driver disabled by Kconfig\n", __func__);
109         return NULL;
110 }
111 #endif /* CONFIG_DVB_AF9013 */
112
113 #endif /* AF9013_H */