m88ds3103.h revision 79d0933032d657e8f80e916b14b47b03731d6bea 
1/*
2 * Montage M88DS3103 demodulator driver
3 *
4 * Copyright (C) 2013 Antti Palosaari <crope@iki.fi>
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
17#ifndef M88DS3103_H
18#define M88DS3103_H
19
20#include <linux/dvb/frontend.h>
21
22struct m88ds3103_config {
23	/*
24	 * I2C address
25	 * Default: none, must set
26	 * 0x68, ...
27	 */
28	u8 i2c_addr;
29
30	/*
31	 * clock
32	 * Default: none, must set
33	 * 27000000
34	 */
35	u32 clock;
36
37	/*
38	 * max bytes I2C provider is asked to write at once
39	 * Default: none, must set
40	 * 33, 65, ...
41	 */
42	u16 i2c_wr_max;
43
44	/*
45	 * TS output mode
46	 * Default: M88DS3103_TS_SERIAL
47	 */
48#define M88DS3103_TS_SERIAL             0 /* TS output pin D0, normal */
49#define M88DS3103_TS_SERIAL_D7          1 /* TS output pin D7 */
50#define M88DS3103_TS_PARALLEL           2 /* TS Parallel mode */
51#define M88DS3103_TS_CI                 3 /* TS CI Mode */
52	u8 ts_mode;
53
54	/*
55	 * TS clk in KHz
56	 * Default: 0.
57	 */
58	u32 ts_clk;
59
60	/*
61	 * TS clk polarity.
62	 * Default: 0. 1-active at falling edge; 0-active at rising edge.
63	 */
64	u8 ts_clk_pol:1;
65
66	/*
67	 * spectrum inversion
68	 * Default: 0
69	 */
70	u8 spec_inv:1;
71
72	/*
73	 * AGC polarity
74	 * Default: 0
75	 */
76	u8 agc_inv:1;
77
78	/*
79	 * clock output
80	 * Default: M88DS3103_CLOCK_OUT_DISABLED
81	 */
82#define M88DS3103_CLOCK_OUT_DISABLED        0
83#define M88DS3103_CLOCK_OUT_ENABLED         1
84#define M88DS3103_CLOCK_OUT_ENABLED_DIV2    2
85	u8 clock_out;
86
87	/*
88	 * DiSEqC envelope mode
89	 * Default: 0
90	 */
91	u8 envelope_mode:1;
92
93	/*
94	 * AGC configuration
95	 * Default: none, must set
96	 */
97	u8 agc;
98
99	/*
100	 * LNB H/V pin polarity
101	 * Default: 0.
102	 * 1: pin high set to VOLTAGE_13, pin low to set VOLTAGE_18.
103	 * 0: pin high set to VOLTAGE_18, pin low to set VOLTAGE_13.
104	 */
105	u8 lnb_hv_pol:1;
106
107	/*
108	 * LNB enable pin polarity
109	 * Default: 0.
110	 * 1: pin high to enable, pin low to disable.
111	 * 0: pin high to disable, pin low to enable.
112	 */
113	u8 lnb_en_pol:1;
114};
115
116/*
117 * Driver implements own I2C-adapter for tuner I2C access. That's since chip
118 * has I2C-gate control which closes gate automatically after I2C transfer.
119 * Using own I2C adapter we can workaround that.
120 */
121
122#if defined(CONFIG_DVB_M88DS3103) || \
123		(defined(CONFIG_DVB_M88DS3103_MODULE) && defined(MODULE))
124extern struct dvb_frontend *m88ds3103_attach(
125		const struct m88ds3103_config *config,
126		struct i2c_adapter *i2c,
127		struct i2c_adapter **tuner_i2c);
128#else
129static inline struct dvb_frontend *m88ds3103_attach(
130		const struct m88ds3103_config *config,
131		struct i2c_adapter *i2c,
132		struct i2c_adapter **tuner_i2c)
133{
134	pr_warn("%s: driver disabled by Kconfig\n", __func__);
135	return NULL;
136}
137#endif
138
139#endif
140