LXR linux/drivers/media/dvb-frontends/stv090x.h

   1/* SPDX-License-Identifier: GPL-2.0-or-later */
   2/*
   3        STV0900/0903 Multistandard Broadcast Frontend driver
   4        Copyright (C) Manu Abraham <abraham.manu@gmail.com>
   5
   6        Copyright (C) ST Microelectronics
   7
   8*/
   9
  10#ifndef __STV090x_H
  11#define __STV090x_H
  12
  13enum stv090x_demodulator {
  14        STV090x_DEMODULATOR_0 = 1,
  15        STV090x_DEMODULATOR_1
  16};
  17
  18enum stv090x_device {
  19        STV0903 =  0,
  20        STV0900,
  21};
  22
  23enum stv090x_mode {
  24        STV090x_DUAL = 0,
  25        STV090x_SINGLE
  26};
  27
  28enum stv090x_tsmode {
  29        STV090x_TSMODE_SERIAL_PUNCTURED = 1,
  30        STV090x_TSMODE_SERIAL_CONTINUOUS,
  31        STV090x_TSMODE_PARALLEL_PUNCTURED,
  32        STV090x_TSMODE_DVBCI
  33};
  34
  35enum stv090x_clkmode {
  36        STV090x_CLK_INT = 0, /* Clk i/p = CLKI */
  37        STV090x_CLK_EXT = 2 /* Clk i/p = XTALI */
  38};
  39
  40enum stv090x_i2crpt {
  41        STV090x_RPTLEVEL_256    = 0,
  42        STV090x_RPTLEVEL_128    = 1,
  43        STV090x_RPTLEVEL_64     = 2,
  44        STV090x_RPTLEVEL_32     = 3,
  45        STV090x_RPTLEVEL_16     = 4,
  46        STV090x_RPTLEVEL_8      = 5,
  47        STV090x_RPTLEVEL_4      = 6,
  48        STV090x_RPTLEVEL_2      = 7,
  49};
  50
  51enum stv090x_adc_range {
  52        STV090x_ADC_2Vpp        = 0,
  53        STV090x_ADC_1Vpp        = 1
  54};
  55
  56struct stv090x_config {
  57        enum stv090x_device     device;
  58        enum stv090x_mode       demod_mode;
  59        enum stv090x_clkmode    clk_mode;
  60        enum stv090x_demodulator demod;
  61
  62        u32 xtal; /* default: 8000000 */
  63        u8 address; /* default: 0x68 */
  64
  65        u8 ts1_mode;
  66        u8 ts2_mode;
  67        u32 ts1_clk;
  68        u32 ts2_clk;
  69
  70        u8 ts1_tei : 1;
  71        u8 ts2_tei : 1;
  72
  73        enum stv090x_i2crpt     repeater_level;
  74
  75        u8                      tuner_bbgain; /* default: 10db */
  76        enum stv090x_adc_range  adc1_range; /* default: 2Vpp */
  77        enum stv090x_adc_range  adc2_range; /* default: 2Vpp */
  78
  79        bool diseqc_envelope_mode;
  80
  81        int (*tuner_init)(struct dvb_frontend *fe);
  82        int (*tuner_sleep)(struct dvb_frontend *fe);
  83        int (*tuner_set_mode)(struct dvb_frontend *fe, enum tuner_mode mode);
  84        int (*tuner_set_frequency)(struct dvb_frontend *fe, u32 frequency);
  85        int (*tuner_get_frequency)(struct dvb_frontend *fe, u32 *frequency);
  86        int (*tuner_set_bandwidth)(struct dvb_frontend *fe, u32 bandwidth);
  87        int (*tuner_get_bandwidth)(struct dvb_frontend *fe, u32 *bandwidth);
  88        int (*tuner_set_bbgain)(struct dvb_frontend *fe, u32 gain);
  89        int (*tuner_get_bbgain)(struct dvb_frontend *fe, u32 *gain);
  90        int (*tuner_set_refclk)(struct dvb_frontend *fe, u32 refclk);
  91        int (*tuner_get_status)(struct dvb_frontend *fe, u32 *status);
  92        void (*tuner_i2c_lock)(struct dvb_frontend *fe, int lock);
  93
  94        /* dir = 0 -> output, dir = 1 -> input/open-drain */
  95        int (*set_gpio)(struct dvb_frontend *fe, u8 gpio, u8 dir, u8 value,
  96                        u8 xor_value);
  97
  98        struct dvb_frontend* (*get_dvb_frontend)(struct i2c_client *i2c);
  99};
 100
 101#if IS_REACHABLE(CONFIG_DVB_STV090x)
 102
 103struct dvb_frontend *stv090x_attach(struct stv090x_config *config,
 104                                    struct i2c_adapter *i2c,
 105                                    enum stv090x_demodulator demod);
 106
 107#else
 108
 109static inline struct dvb_frontend *stv090x_attach(const struct stv090x_config *config,
 110                                                  struct i2c_adapter *i2c,
 111                                                  enum stv090x_demodulator demod)
 112{
 113        printk(KERN_WARNING "%s: driver disabled by Kconfig\n", __func__);
 114        return NULL;
 115}
 116
 117#endif /* CONFIG_DVB_STV090x */
 118
 119#endif /* __STV090x_H */
 120