1 /* SPDX-License-Identifier: GPL-2.0-or-later */ 2 /* 3 * Montage Technology M88DS3103/M88RS6000 demodulator driver 4 * 5 * Copyright (C) 2013 Antti Palosaari <crope@iki.fi> 6 */ 7 8 #ifndef M88DS3103_H 9 #define M88DS3103_H 10 11 #include <linux/dvb/frontend.h> 12 13 /* 14 * I2C address 15 * 0x68, 16 */ 17 18 /** 19 * enum m88ds3103_ts_mode - TS connection mode 20 * @M88DS3103_TS_SERIAL: TS output pin D0, normal 21 * @M88DS3103_TS_SERIAL_D7: TS output pin D7 22 * @M88DS3103_TS_PARALLEL: TS Parallel mode 23 * @M88DS3103_TS_CI: TS CI Mode 24 */ 25 enum m88ds3103_ts_mode { 26 M88DS3103_TS_SERIAL, 27 M88DS3103_TS_SERIAL_D7, 28 M88DS3103_TS_PARALLEL, 29 M88DS3103_TS_CI 30 }; 31 32 /** 33 * enum m88ds3103_clock_out 34 * @M88DS3103_CLOCK_OUT_DISABLED: Clock output is disabled 35 * @M88DS3103_CLOCK_OUT_ENABLED: Clock output is enabled with crystal 36 * clock. 37 * @M88DS3103_CLOCK_OUT_ENABLED_DIV2: Clock output is enabled with half 38 * crystal clock. 39 */ 40 enum m88ds3103_clock_out { 41 M88DS3103_CLOCK_OUT_DISABLED, 42 M88DS3103_CLOCK_OUT_ENABLED, 43 M88DS3103_CLOCK_OUT_ENABLED_DIV2 44 }; 45 46 /** 47 * struct m88ds3103_platform_data - Platform data for the m88ds3103 driver 48 * @clk: Clock frequency. 49 * @i2c_wr_max: Max bytes I2C adapter can write at once. 50 * @ts_mode: TS mode. 51 * @ts_clk: TS clock (KHz). 52 * @ts_clk_pol: TS clk polarity. 1-active at falling edge; 0-active at rising 53 * edge. 54 * @spec_inv: Input spectrum inversion. 55 * @agc: AGC configuration. 56 * @agc_inv: AGC polarity. 57 * @clk_out: Clock output. 58 * @envelope_mode: DiSEqC envelope mode. 59 * @lnb_hv_pol: LNB H/V pin polarity. 0: pin high set to VOLTAGE_18, pin low to 60 * set VOLTAGE_13. 1: pin high set to VOLTAGE_13, pin low to set VOLTAGE_18. 61 * @lnb_en_pol: LNB enable pin polarity. 0: pin high to disable, pin low to 62 * enable. 1: pin high to enable, pin low to disable. 63 * @get_dvb_frontend: Get DVB frontend. 64 * @get_i2c_adapter: Get I2C adapter. 65 */ 66 struct m88ds3103_platform_data { 67 u32 clk; 68 u16 i2c_wr_max; 69 enum m88ds3103_ts_mode ts_mode; 70 u32 ts_clk; 71 enum m88ds3103_clock_out clk_out; 72 u8 ts_clk_pol:1; 73 u8 spec_inv:1; 74 u8 agc; 75 u8 agc_inv:1; 76 u8 envelope_mode:1; 77 u8 lnb_hv_pol:1; 78 u8 lnb_en_pol:1; 79 80 struct dvb_frontend* (*get_dvb_frontend)(struct i2c_client *); 81 struct i2c_adapter* (*get_i2c_adapter)(struct i2c_client *); 82 83 /* private: For legacy media attach wrapper. Do not set value. */ 84 u8 attach_in_use:1; 85 }; 86 87 /** 88 * struct m88ds3103_config - m88ds3102 configuration 89 * 90 * @i2c_addr: I2C address. Default: none, must set. Example: 0x68, ... 91 * @clock: Device's clock. Default: none, must set. Example: 27000000 92 * @i2c_wr_max: Max bytes I2C provider is asked to write at once. 93 * Default: none, must set. Example: 33, 65, ... 94 * @ts_mode: TS output mode, as defined by &enum m88ds3103_ts_mode. 95 * Default: M88DS3103_TS_SERIAL. 96 * @ts_clk: TS clk in KHz. Default: 0. 97 * @ts_clk_pol: TS clk polarity.Default: 0. 98 * 1-active at falling edge; 0-active at rising edge. 99 * @spec_inv: Spectrum inversion. Default: 0. 100 * @agc_inv: AGC polarity. Default: 0. 101 * @clock_out: Clock output, as defined by &enum m88ds3103_clock_out. 102 * Default: M88DS3103_CLOCK_OUT_DISABLED. 103 * @envelope_mode: DiSEqC envelope mode. Default: 0. 104 * @agc: AGC configuration. Default: none, must set. 105 * @lnb_hv_pol: LNB H/V pin polarity. Default: 0. Values: 106 * 1: pin high set to VOLTAGE_13, pin low to set VOLTAGE_18; 107 * 0: pin high set to VOLTAGE_18, pin low to set VOLTAGE_13. 108 * @lnb_en_pol: LNB enable pin polarity. Default: 0. Values: 109 * 1: pin high to enable, pin low to disable; 110 * 0: pin high to disable, pin low to enable. 111 */ 112 struct m88ds3103_config { 113 u8 i2c_addr; 114 u32 clock; 115 u16 i2c_wr_max; 116 u8 ts_mode; 117 u32 ts_clk; 118 u8 ts_clk_pol:1; 119 u8 spec_inv:1; 120 u8 agc_inv:1; 121 u8 clock_out; 122 u8 envelope_mode:1; 123 u8 agc; 124 u8 lnb_hv_pol:1; 125 u8 lnb_en_pol:1; 126 }; 127 128 #if defined(CONFIG_DVB_M88DS3103) || \ 129 (defined(CONFIG_DVB_M88DS3103_MODULE) && defined(MODULE)) 130 /** 131 * Attach a m88ds3103 demod 132 * 133 * @config: pointer to &struct m88ds3103_config with demod configuration. 134 * @i2c: i2c adapter to use. 135 * @tuner_i2c: on success, returns the I2C adapter associated with 136 * m88ds3103 tuner. 137 * 138 * return: FE pointer on success, NULL on failure. 139 * Note: Do not add new m88ds3103_attach() users! Use I2C bindings instead. 140 */ 141 extern struct dvb_frontend *m88ds3103_attach( 142 const struct m88ds3103_config *config, 143 struct i2c_adapter *i2c, 144 struct i2c_adapter **tuner_i2c); 145 extern int m88ds3103_get_agc_pwm(struct dvb_frontend *fe, u8 *_agc_pwm); 146 #else 147 static inline struct dvb_frontend *m88ds3103_attach( 148 const struct m88ds3103_config *config, 149 struct i2c_adapter *i2c, 150 struct i2c_adapter **tuner_i2c) 151 { 152 pr_warn("%s: driver disabled by Kconfig\n", __func__); 153 return NULL; 154 } 155 #define m88ds3103_get_agc_pwm NULL 156 #endif 157 158 #endif 159