1*4882a593Smuzhiyun /* SPDX-License-Identifier: GPL-2.0-or-later */
2*4882a593Smuzhiyun /*
3*4882a593Smuzhiyun * Sony CXD2820R demodulator driver
4*4882a593Smuzhiyun *
5*4882a593Smuzhiyun * Copyright (C) 2010 Antti Palosaari <crope@iki.fi>
6*4882a593Smuzhiyun */
7*4882a593Smuzhiyun
8*4882a593Smuzhiyun
9*4882a593Smuzhiyun #ifndef CXD2820R_H
10*4882a593Smuzhiyun #define CXD2820R_H
11*4882a593Smuzhiyun
12*4882a593Smuzhiyun #include <linux/dvb/frontend.h>
13*4882a593Smuzhiyun
14*4882a593Smuzhiyun #define CXD2820R_GPIO_D (0 << 0) /* disable */
15*4882a593Smuzhiyun #define CXD2820R_GPIO_E (1 << 0) /* enable */
16*4882a593Smuzhiyun #define CXD2820R_GPIO_O (0 << 1) /* output */
17*4882a593Smuzhiyun #define CXD2820R_GPIO_I (1 << 1) /* input */
18*4882a593Smuzhiyun #define CXD2820R_GPIO_L (0 << 2) /* output low */
19*4882a593Smuzhiyun #define CXD2820R_GPIO_H (1 << 2) /* output high */
20*4882a593Smuzhiyun
21*4882a593Smuzhiyun #define CXD2820R_TS_SERIAL 0x08
22*4882a593Smuzhiyun #define CXD2820R_TS_SERIAL_MSB 0x28
23*4882a593Smuzhiyun #define CXD2820R_TS_PARALLEL 0x30
24*4882a593Smuzhiyun #define CXD2820R_TS_PARALLEL_MSB 0x70
25*4882a593Smuzhiyun
26*4882a593Smuzhiyun /*
27*4882a593Smuzhiyun * I2C address: 0x6c, 0x6d
28*4882a593Smuzhiyun */
29*4882a593Smuzhiyun
30*4882a593Smuzhiyun /**
31*4882a593Smuzhiyun * struct cxd2820r_platform_data - Platform data for the cxd2820r driver
32*4882a593Smuzhiyun * @ts_mode: TS mode.
33*4882a593Smuzhiyun * @ts_clk_inv: TS clock inverted.
34*4882a593Smuzhiyun * @if_agc_polarity: IF AGC polarity.
35*4882a593Smuzhiyun * @spec_inv: Input spectrum inverted.
36*4882a593Smuzhiyun * @gpio_chip_base: GPIO.
37*4882a593Smuzhiyun * @get_dvb_frontend: Get DVB frontend.
38*4882a593Smuzhiyun */
39*4882a593Smuzhiyun struct cxd2820r_platform_data {
40*4882a593Smuzhiyun u8 ts_mode;
41*4882a593Smuzhiyun bool ts_clk_inv;
42*4882a593Smuzhiyun bool if_agc_polarity;
43*4882a593Smuzhiyun bool spec_inv;
44*4882a593Smuzhiyun int **gpio_chip_base;
45*4882a593Smuzhiyun
46*4882a593Smuzhiyun struct dvb_frontend* (*get_dvb_frontend)(struct i2c_client *);
47*4882a593Smuzhiyun /* private: For legacy media attach wrapper. Do not set value. */
48*4882a593Smuzhiyun bool attach_in_use;
49*4882a593Smuzhiyun };
50*4882a593Smuzhiyun
51*4882a593Smuzhiyun /**
52*4882a593Smuzhiyun * struct cxd2820r_config - configuration for cxd2020r demod
53*4882a593Smuzhiyun *
54*4882a593Smuzhiyun * @i2c_address: Demodulator I2C address. Driver determines DVB-C slave I2C
55*4882a593Smuzhiyun * address automatically from master address.
56*4882a593Smuzhiyun * Default: none, must set. Values: 0x6c, 0x6d.
57*4882a593Smuzhiyun * @ts_mode: TS output mode. Default: none, must set. Values: FIXME?
58*4882a593Smuzhiyun * @ts_clock_inv: TS clock inverted. Default: 0. Values: 0, 1.
59*4882a593Smuzhiyun * @if_agc_polarity: Default: 0. Values: 0, 1
60*4882a593Smuzhiyun * @spec_inv: Spectrum inversion. Default: 0. Values: 0, 1.
61*4882a593Smuzhiyun */
62*4882a593Smuzhiyun struct cxd2820r_config {
63*4882a593Smuzhiyun /* Demodulator I2C address.
64*4882a593Smuzhiyun * Driver determines DVB-C slave I2C address automatically from master
65*4882a593Smuzhiyun * address.
66*4882a593Smuzhiyun * Default: none, must set
67*4882a593Smuzhiyun * Values: 0x6c, 0x6d
68*4882a593Smuzhiyun */
69*4882a593Smuzhiyun u8 i2c_address;
70*4882a593Smuzhiyun
71*4882a593Smuzhiyun /* TS output mode.
72*4882a593Smuzhiyun * Default: none, must set.
73*4882a593Smuzhiyun * Values:
74*4882a593Smuzhiyun */
75*4882a593Smuzhiyun u8 ts_mode;
76*4882a593Smuzhiyun
77*4882a593Smuzhiyun /* TS clock inverted.
78*4882a593Smuzhiyun * Default: 0
79*4882a593Smuzhiyun * Values: 0, 1
80*4882a593Smuzhiyun */
81*4882a593Smuzhiyun bool ts_clock_inv;
82*4882a593Smuzhiyun
83*4882a593Smuzhiyun /* IF AGC polarity.
84*4882a593Smuzhiyun * Default: 0
85*4882a593Smuzhiyun * Values: 0, 1
86*4882a593Smuzhiyun */
87*4882a593Smuzhiyun bool if_agc_polarity;
88*4882a593Smuzhiyun
89*4882a593Smuzhiyun /* Spectrum inversion.
90*4882a593Smuzhiyun * Default: 0
91*4882a593Smuzhiyun * Values: 0, 1
92*4882a593Smuzhiyun */
93*4882a593Smuzhiyun bool spec_inv;
94*4882a593Smuzhiyun };
95*4882a593Smuzhiyun
96*4882a593Smuzhiyun
97*4882a593Smuzhiyun #if IS_REACHABLE(CONFIG_DVB_CXD2820R)
98*4882a593Smuzhiyun /**
99*4882a593Smuzhiyun * Attach a cxd2820r demod
100*4882a593Smuzhiyun *
101*4882a593Smuzhiyun * @config: pointer to &struct cxd2820r_config with demod configuration.
102*4882a593Smuzhiyun * @i2c: i2c adapter to use.
103*4882a593Smuzhiyun * @gpio_chip_base: if zero, disables GPIO setting. Otherwise, if
104*4882a593Smuzhiyun * CONFIG_GPIOLIB is set dynamically allocate
105*4882a593Smuzhiyun * gpio base; if is not set, use its value to
106*4882a593Smuzhiyun * setup the GPIO pins.
107*4882a593Smuzhiyun *
108*4882a593Smuzhiyun * return: FE pointer on success, NULL on failure.
109*4882a593Smuzhiyun */
110*4882a593Smuzhiyun extern struct dvb_frontend *cxd2820r_attach(
111*4882a593Smuzhiyun const struct cxd2820r_config *config,
112*4882a593Smuzhiyun struct i2c_adapter *i2c,
113*4882a593Smuzhiyun int *gpio_chip_base
114*4882a593Smuzhiyun );
115*4882a593Smuzhiyun #else
cxd2820r_attach(const struct cxd2820r_config * config,struct i2c_adapter * i2c,int * gpio_chip_base)116*4882a593Smuzhiyun static inline struct dvb_frontend *cxd2820r_attach(
117*4882a593Smuzhiyun const struct cxd2820r_config *config,
118*4882a593Smuzhiyun struct i2c_adapter *i2c,
119*4882a593Smuzhiyun int *gpio_chip_base
120*4882a593Smuzhiyun )
121*4882a593Smuzhiyun {
122*4882a593Smuzhiyun printk(KERN_WARNING "%s: driver disabled by Kconfig\n", __func__);
123*4882a593Smuzhiyun return NULL;
124*4882a593Smuzhiyun }
125*4882a593Smuzhiyun
126*4882a593Smuzhiyun #endif
127*4882a593Smuzhiyun
128*4882a593Smuzhiyun #endif /* CXD2820R_H */
129