drivers/media/dvb-frontends/drxk.h

   1 /* SPDX-License-Identifier: GPL-2.0 */
   2 #ifndef _DRXK_H_
   3 #define _DRXK_H_
   4
   5 #include <linux/types.h>
   6 #include <linux/i2c.h>
   7
   8 /**
   9  * struct drxk_config - Configure the initial parameters for DRX-K
  10  *
  11  * @adr:                I2C address of the DRX-K
  12  * @parallel_ts:        True means that the device uses parallel TS,
  13  *                      Serial otherwise.
  14  * @dynamic_clk:        True means that the clock will be dynamically
  15  *                      adjusted. Static clock otherwise.
  16  * @enable_merr_cfg:    Enable SIO_PDR_PERR_CFG/SIO_PDR_MVAL_CFG.
  17  * @single_master:      Device is on the single master mode
  18  * @no_i2c_bridge:      Don't switch the I2C bridge to talk with tuner
  19  * @antenna_gpio:       GPIO bit used to control the antenna
  20  * @antenna_dvbt:       GPIO bit for changing antenna to DVB-C. A value of 1
  21  *                      means that 1=DVBC, 0 = DVBT. Zero means the opposite.
  22  * @mpeg_out_clk_strength: DRXK Mpeg output clock drive strength.
  23  * @chunk_size:         maximum size for I2C messages
  24  * @microcode_name:     Name of the firmware file with the microcode
  25  * @qam_demod_parameter_count:  The number of parameters used for the command
  26  *                              to set the demodulator parameters. All
  27  *                              firmwares are using the 2-parameter commmand.
  28  *                              An exception is the ``drxk_a3.mc`` firmware,
  29  *                              which uses the 4-parameter command.
  30  *                              A value of 0 (default) or lower indicates that
  31  *                              the correct number of parameters will be
  32  *                              automatically detected.
  33  *
  34  * On the ``*_gpio`` vars, bit 0 is UIO-1, bit 1 is UIO-2 and bit 2 is
  35  * UIO-3.
  36  */
  37 struct drxk_config {
  38         u8      adr;
  39         bool    single_master;
  40         bool    no_i2c_bridge;
  41         bool    parallel_ts;
  42         bool    dynamic_clk;
  43         bool    enable_merr_cfg;
  44
  45         bool    antenna_dvbt;
  46         u16     antenna_gpio;
  47
  48         u8      mpeg_out_clk_strength;
  49         int     chunk_size;
  50
  51         const char      *microcode_name;
  52         int              qam_demod_parameter_count;
  53 };
  54
  55 #if IS_REACHABLE(CONFIG_DVB_DRXK)
  56 /**
  57  * Attach a drxk demod
  58  *
  59  * @config: pointer to &struct drxk_config with demod configuration.
  60  * @i2c: i2c adapter to use.
  61  *
  62  * return: FE pointer on success, NULL on failure.
  63  */
  64 extern struct dvb_frontend *drxk_attach(const struct drxk_config *config,
  65                                         struct i2c_adapter *i2c);
  66 #else
  67 static inline struct dvb_frontend *drxk_attach(const struct drxk_config *config,
  68                                         struct i2c_adapter *i2c)
  69 {
  70         printk(KERN_WARNING "%s: driver disabled by Kconfig\n", __func__);
  71         return NULL;
  72 }
  73 #endif
  74
  75 #endif