drivers/media/dvb-frontends/m88ds3103.h

   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
  22 struct 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))
 124 extern struct dvb_frontend *m88ds3103_attach(
 125                 const struct m88ds3103_config *config,
 126                 struct i2c_adapter *i2c,
 127                 struct i2c_adapter **tuner_i2c);
 128 #else
 129 static 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