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 command.
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   * drxk_attach - 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
drxk_attach(const struct drxk_config * config,struct i2c_adapter * i2c)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
76