xref: /linux/drivers/media/usb/dvb-usb-v2/rtl28xxu.h (revision 83b2f84957373683164e3780d040b3c007e06b05)
1786baecfSMauro Carvalho Chehab /*
2786baecfSMauro Carvalho Chehab  * Realtek RTL28xxU DVB USB driver
3786baecfSMauro Carvalho Chehab  *
4786baecfSMauro Carvalho Chehab  * Copyright (C) 2009 Antti Palosaari <crope@iki.fi>
5786baecfSMauro Carvalho Chehab  * Copyright (C) 2011 Antti Palosaari <crope@iki.fi>
6786baecfSMauro Carvalho Chehab  *
7786baecfSMauro Carvalho Chehab  *    This program is free software; you can redistribute it and/or modify
8786baecfSMauro Carvalho Chehab  *    it under the terms of the GNU General Public License as published by
9786baecfSMauro Carvalho Chehab  *    the Free Software Foundation; either version 2 of the License, or
10786baecfSMauro Carvalho Chehab  *    (at your option) any later version.
11786baecfSMauro Carvalho Chehab  *
12786baecfSMauro Carvalho Chehab  *    This program is distributed in the hope that it will be useful,
13786baecfSMauro Carvalho Chehab  *    but WITHOUT ANY WARRANTY; without even the implied warranty of
14786baecfSMauro Carvalho Chehab  *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
15786baecfSMauro Carvalho Chehab  *    GNU General Public License for more details.
16786baecfSMauro Carvalho Chehab  *
17786baecfSMauro Carvalho Chehab  *    You should have received a copy of the GNU General Public License along
18786baecfSMauro Carvalho Chehab  *    with this program; if not, write to the Free Software Foundation, Inc.,
19786baecfSMauro Carvalho Chehab  *    51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
20786baecfSMauro Carvalho Chehab  */
21786baecfSMauro Carvalho Chehab 
22786baecfSMauro Carvalho Chehab #ifndef RTL28XXU_H
23786baecfSMauro Carvalho Chehab #define RTL28XXU_H
24786baecfSMauro Carvalho Chehab 
25786baecfSMauro Carvalho Chehab #include "dvb_usb.h"
26786baecfSMauro Carvalho Chehab 
27786baecfSMauro Carvalho Chehab /*
28786baecfSMauro Carvalho Chehab  * USB commands
29786baecfSMauro Carvalho Chehab  * (usb_control_msg() index parameter)
30786baecfSMauro Carvalho Chehab  */
31786baecfSMauro Carvalho Chehab 
32786baecfSMauro Carvalho Chehab #define DEMOD            0x0000
33786baecfSMauro Carvalho Chehab #define USB              0x0100
34786baecfSMauro Carvalho Chehab #define SYS              0x0200
35786baecfSMauro Carvalho Chehab #define I2C              0x0300
36786baecfSMauro Carvalho Chehab #define I2C_DA           0x0600
37786baecfSMauro Carvalho Chehab 
38786baecfSMauro Carvalho Chehab #define CMD_WR_FLAG      0x0010
39786baecfSMauro Carvalho Chehab #define CMD_DEMOD_RD     0x0000
40786baecfSMauro Carvalho Chehab #define CMD_DEMOD_WR     0x0010
41786baecfSMauro Carvalho Chehab #define CMD_USB_RD       0x0100
42786baecfSMauro Carvalho Chehab #define CMD_USB_WR       0x0110
43786baecfSMauro Carvalho Chehab #define CMD_SYS_RD       0x0200
44786baecfSMauro Carvalho Chehab #define CMD_IR_RD        0x0201
45786baecfSMauro Carvalho Chehab #define CMD_IR_WR        0x0211
46786baecfSMauro Carvalho Chehab #define CMD_SYS_WR       0x0210
47786baecfSMauro Carvalho Chehab #define CMD_I2C_RD       0x0300
48786baecfSMauro Carvalho Chehab #define CMD_I2C_WR       0x0310
49786baecfSMauro Carvalho Chehab #define CMD_I2C_DA_RD    0x0600
50786baecfSMauro Carvalho Chehab #define CMD_I2C_DA_WR    0x0610
51786baecfSMauro Carvalho Chehab 
52786baecfSMauro Carvalho Chehab 
53786baecfSMauro Carvalho Chehab struct rtl28xxu_priv {
54786baecfSMauro Carvalho Chehab 	u8 chip_id;
55786baecfSMauro Carvalho Chehab 	u8 tuner;
56ef37be1bSAntti Palosaari 	char *tuner_name;
57786baecfSMauro Carvalho Chehab 	u8 page; /* integrated demod active register page */
58ae1f8453SAntti Palosaari 	struct i2c_adapter *demod_i2c_adapter;
59786baecfSMauro Carvalho Chehab 	bool rc_active;
60*83b2f849SAntti Palosaari 	struct i2c_client *i2c_client_demod;
61473eadf3SAntti Palosaari 	struct i2c_client *i2c_client_tuner;
6280f189a1SAntti Palosaari 	struct i2c_client *i2c_client_slave_demod;
6380f189a1SAntti Palosaari 	#define SLAVE_DEMOD_NONE           0
6480f189a1SAntti Palosaari 	#define SLAVE_DEMOD_MN88472        1
65fc694e44SAntti Palosaari 	#define SLAVE_DEMOD_MN88473        2
66fc694e44SAntti Palosaari 	unsigned int slave_demod:2;
67786baecfSMauro Carvalho Chehab };
68786baecfSMauro Carvalho Chehab 
69786baecfSMauro Carvalho Chehab enum rtl28xxu_chip_id {
70786baecfSMauro Carvalho Chehab 	CHIP_ID_NONE,
71786baecfSMauro Carvalho Chehab 	CHIP_ID_RTL2831U,
72786baecfSMauro Carvalho Chehab 	CHIP_ID_RTL2832U,
73786baecfSMauro Carvalho Chehab };
74786baecfSMauro Carvalho Chehab 
75832cc7cdSAntti Palosaari /* XXX: Hack. This must be keep sync with rtl2832 demod driver. */
76786baecfSMauro Carvalho Chehab enum rtl28xxu_tuner {
77786baecfSMauro Carvalho Chehab 	TUNER_NONE,
78786baecfSMauro Carvalho Chehab 
79832cc7cdSAntti Palosaari 	TUNER_RTL2830_QT1010          = 0x10,
80786baecfSMauro Carvalho Chehab 	TUNER_RTL2830_MT2060,
81786baecfSMauro Carvalho Chehab 	TUNER_RTL2830_MXL5005S,
82786baecfSMauro Carvalho Chehab 
83832cc7cdSAntti Palosaari 	TUNER_RTL2832_MT2266          = 0x20,
84786baecfSMauro Carvalho Chehab 	TUNER_RTL2832_FC2580,
85786baecfSMauro Carvalho Chehab 	TUNER_RTL2832_MT2063,
86786baecfSMauro Carvalho Chehab 	TUNER_RTL2832_MAX3543,
87786baecfSMauro Carvalho Chehab 	TUNER_RTL2832_TUA9001,
88786baecfSMauro Carvalho Chehab 	TUNER_RTL2832_MXL5007T,
89786baecfSMauro Carvalho Chehab 	TUNER_RTL2832_FC0012,
90786baecfSMauro Carvalho Chehab 	TUNER_RTL2832_E4000,
91786baecfSMauro Carvalho Chehab 	TUNER_RTL2832_TDA18272,
92786baecfSMauro Carvalho Chehab 	TUNER_RTL2832_FC0013,
936889ab2aSMauro Carvalho Chehab 	TUNER_RTL2832_R820T,
948b4cac1aSAntti Palosaari 	TUNER_RTL2832_R828D,
95786baecfSMauro Carvalho Chehab };
96786baecfSMauro Carvalho Chehab 
97786baecfSMauro Carvalho Chehab struct rtl28xxu_req {
98786baecfSMauro Carvalho Chehab 	u16 value;
99786baecfSMauro Carvalho Chehab 	u16 index;
100786baecfSMauro Carvalho Chehab 	u16 size;
101786baecfSMauro Carvalho Chehab 	u8 *data;
102786baecfSMauro Carvalho Chehab };
103786baecfSMauro Carvalho Chehab 
104786baecfSMauro Carvalho Chehab struct rtl28xxu_reg_val {
105786baecfSMauro Carvalho Chehab 	u16 reg;
106786baecfSMauro Carvalho Chehab 	u8 val;
107786baecfSMauro Carvalho Chehab };
108786baecfSMauro Carvalho Chehab 
109f39fac3eSAntti Palosaari struct rtl28xxu_reg_val_mask {
1101e41413fSRodrigo Tartajo 	u16 reg;
111f39fac3eSAntti Palosaari 	u8 val;
1121e41413fSRodrigo Tartajo 	u8 mask;
1131e41413fSRodrigo Tartajo };
1141e41413fSRodrigo Tartajo 
115786baecfSMauro Carvalho Chehab /*
116786baecfSMauro Carvalho Chehab  * memory map
117786baecfSMauro Carvalho Chehab  *
118786baecfSMauro Carvalho Chehab  * 0x0000 DEMOD : demodulator
119786baecfSMauro Carvalho Chehab  * 0x2000 USB   : SIE, USB endpoint, debug, DMA
120786baecfSMauro Carvalho Chehab  * 0x3000 SYS   : system
121786baecfSMauro Carvalho Chehab  * 0xfc00 RC    : remote controller (not RTL2831U)
122786baecfSMauro Carvalho Chehab  */
123786baecfSMauro Carvalho Chehab 
124786baecfSMauro Carvalho Chehab /*
125786baecfSMauro Carvalho Chehab  * USB registers
126786baecfSMauro Carvalho Chehab  */
127786baecfSMauro Carvalho Chehab /* SIE Control Registers */
128786baecfSMauro Carvalho Chehab #define USB_SYSCTL         0x2000 /* USB system control */
129786baecfSMauro Carvalho Chehab #define USB_SYSCTL_0       0x2000 /* USB system control */
130786baecfSMauro Carvalho Chehab #define USB_SYSCTL_1       0x2001 /* USB system control */
131786baecfSMauro Carvalho Chehab #define USB_SYSCTL_2       0x2002 /* USB system control */
132786baecfSMauro Carvalho Chehab #define USB_SYSCTL_3       0x2003 /* USB system control */
133786baecfSMauro Carvalho Chehab #define USB_IRQSTAT        0x2008 /* SIE interrupt status */
134786baecfSMauro Carvalho Chehab #define USB_IRQEN          0x200C /* SIE interrupt enable */
135786baecfSMauro Carvalho Chehab #define USB_CTRL           0x2010 /* USB control */
136786baecfSMauro Carvalho Chehab #define USB_STAT           0x2014 /* USB status */
137786baecfSMauro Carvalho Chehab #define USB_DEVADDR        0x2018 /* USB device address */
138786baecfSMauro Carvalho Chehab #define USB_TEST           0x201C /* USB test mode */
139786baecfSMauro Carvalho Chehab #define USB_FRAME_NUMBER   0x2020 /* frame number */
140786baecfSMauro Carvalho Chehab #define USB_FIFO_ADDR      0x2028 /* address of SIE FIFO RAM */
141786baecfSMauro Carvalho Chehab #define USB_FIFO_CMD       0x202A /* SIE FIFO RAM access command */
142786baecfSMauro Carvalho Chehab #define USB_FIFO_DATA      0x2030 /* SIE FIFO RAM data */
143786baecfSMauro Carvalho Chehab /* Endpoint Registers */
144786baecfSMauro Carvalho Chehab #define EP0_SETUPA         0x20F8 /* EP 0 setup packet lower byte */
145786baecfSMauro Carvalho Chehab #define EP0_SETUPB         0x20FC /* EP 0 setup packet higher byte */
146786baecfSMauro Carvalho Chehab #define USB_EP0_CFG        0x2104 /* EP 0 configure */
147786baecfSMauro Carvalho Chehab #define USB_EP0_CTL        0x2108 /* EP 0 control */
148786baecfSMauro Carvalho Chehab #define USB_EP0_STAT       0x210C /* EP 0 status */
149786baecfSMauro Carvalho Chehab #define USB_EP0_IRQSTAT    0x2110 /* EP 0 interrupt status */
150786baecfSMauro Carvalho Chehab #define USB_EP0_IRQEN      0x2114 /* EP 0 interrupt enable */
151786baecfSMauro Carvalho Chehab #define USB_EP0_MAXPKT     0x2118 /* EP 0 max packet size */
152786baecfSMauro Carvalho Chehab #define USB_EP0_BC         0x2120 /* EP 0 FIFO byte counter */
153786baecfSMauro Carvalho Chehab #define USB_EPA_CFG        0x2144 /* EP A configure */
154786baecfSMauro Carvalho Chehab #define USB_EPA_CFG_0      0x2144 /* EP A configure */
155786baecfSMauro Carvalho Chehab #define USB_EPA_CFG_1      0x2145 /* EP A configure */
156786baecfSMauro Carvalho Chehab #define USB_EPA_CFG_2      0x2146 /* EP A configure */
157786baecfSMauro Carvalho Chehab #define USB_EPA_CFG_3      0x2147 /* EP A configure */
158786baecfSMauro Carvalho Chehab #define USB_EPA_CTL        0x2148 /* EP A control */
159786baecfSMauro Carvalho Chehab #define USB_EPA_CTL_0      0x2148 /* EP A control */
160786baecfSMauro Carvalho Chehab #define USB_EPA_CTL_1      0x2149 /* EP A control */
161786baecfSMauro Carvalho Chehab #define USB_EPA_CTL_2      0x214A /* EP A control */
162786baecfSMauro Carvalho Chehab #define USB_EPA_CTL_3      0x214B /* EP A control */
163786baecfSMauro Carvalho Chehab #define USB_EPA_STAT       0x214C /* EP A status */
164786baecfSMauro Carvalho Chehab #define USB_EPA_IRQSTAT    0x2150 /* EP A interrupt status */
165786baecfSMauro Carvalho Chehab #define USB_EPA_IRQEN      0x2154 /* EP A interrupt enable */
166786baecfSMauro Carvalho Chehab #define USB_EPA_MAXPKT     0x2158 /* EP A max packet size */
167786baecfSMauro Carvalho Chehab #define USB_EPA_MAXPKT_0   0x2158 /* EP A max packet size */
168786baecfSMauro Carvalho Chehab #define USB_EPA_MAXPKT_1   0x2159 /* EP A max packet size */
169786baecfSMauro Carvalho Chehab #define USB_EPA_MAXPKT_2   0x215A /* EP A max packet size */
170786baecfSMauro Carvalho Chehab #define USB_EPA_MAXPKT_3   0x215B /* EP A max packet size */
171786baecfSMauro Carvalho Chehab #define USB_EPA_FIFO_CFG   0x2160 /* EP A FIFO configure */
172786baecfSMauro Carvalho Chehab #define USB_EPA_FIFO_CFG_0 0x2160 /* EP A FIFO configure */
173786baecfSMauro Carvalho Chehab #define USB_EPA_FIFO_CFG_1 0x2161 /* EP A FIFO configure */
174786baecfSMauro Carvalho Chehab #define USB_EPA_FIFO_CFG_2 0x2162 /* EP A FIFO configure */
175786baecfSMauro Carvalho Chehab #define USB_EPA_FIFO_CFG_3 0x2163 /* EP A FIFO configure */
176786baecfSMauro Carvalho Chehab /* Debug Registers */
177786baecfSMauro Carvalho Chehab #define USB_PHYTSTDIS      0x2F04 /* PHY test disable */
178786baecfSMauro Carvalho Chehab #define USB_TOUT_VAL       0x2F08 /* USB time-out time */
179786baecfSMauro Carvalho Chehab #define USB_VDRCTRL        0x2F10 /* UTMI vendor signal control */
180786baecfSMauro Carvalho Chehab #define USB_VSTAIN         0x2F14 /* UTMI vendor signal status in */
181786baecfSMauro Carvalho Chehab #define USB_VLOADM         0x2F18 /* UTMI load vendor signal status in */
182786baecfSMauro Carvalho Chehab #define USB_VSTAOUT        0x2F1C /* UTMI vendor signal status out */
183786baecfSMauro Carvalho Chehab #define USB_UTMI_TST       0x2F80 /* UTMI test */
184786baecfSMauro Carvalho Chehab #define USB_UTMI_STATUS    0x2F84 /* UTMI status */
185786baecfSMauro Carvalho Chehab #define USB_TSTCTL         0x2F88 /* test control */
186786baecfSMauro Carvalho Chehab #define USB_TSTCTL2        0x2F8C /* test control 2 */
187786baecfSMauro Carvalho Chehab #define USB_PID_FORCE      0x2F90 /* force PID */
188786baecfSMauro Carvalho Chehab #define USB_PKTERR_CNT     0x2F94 /* packet error counter */
189786baecfSMauro Carvalho Chehab #define USB_RXERR_CNT      0x2F98 /* RX error counter */
190786baecfSMauro Carvalho Chehab #define USB_MEM_BIST       0x2F9C /* MEM BIST test */
191786baecfSMauro Carvalho Chehab #define USB_SLBBIST        0x2FA0 /* self-loop-back BIST */
192786baecfSMauro Carvalho Chehab #define USB_CNTTEST        0x2FA4 /* counter test */
193786baecfSMauro Carvalho Chehab #define USB_PHYTST         0x2FC0 /* USB PHY test */
194786baecfSMauro Carvalho Chehab #define USB_DBGIDX         0x2FF0 /* select individual block debug signal */
195786baecfSMauro Carvalho Chehab #define USB_DBGMUX         0x2FF4 /* debug signal module mux */
196786baecfSMauro Carvalho Chehab 
197786baecfSMauro Carvalho Chehab /*
198786baecfSMauro Carvalho Chehab  * SYS registers
199786baecfSMauro Carvalho Chehab  */
200786baecfSMauro Carvalho Chehab /* demod control registers */
201786baecfSMauro Carvalho Chehab #define SYS_SYS0           0x3000 /* include DEMOD_CTL, GPO, GPI, GPOE */
202786baecfSMauro Carvalho Chehab #define SYS_DEMOD_CTL      0x3000 /* control register for DVB-T demodulator */
203786baecfSMauro Carvalho Chehab /* GPIO registers */
204786baecfSMauro Carvalho Chehab #define SYS_GPIO_OUT_VAL   0x3001 /* output value of GPIO */
205786baecfSMauro Carvalho Chehab #define SYS_GPIO_IN_VAL    0x3002 /* input value of GPIO */
206786baecfSMauro Carvalho Chehab #define SYS_GPIO_OUT_EN    0x3003 /* output enable of GPIO */
207786baecfSMauro Carvalho Chehab #define SYS_SYS1           0x3004 /* include GPD, SYSINTE, SYSINTS, GP_CFG0 */
208786baecfSMauro Carvalho Chehab #define SYS_GPIO_DIR       0x3004 /* direction control for GPIO */
209786baecfSMauro Carvalho Chehab #define SYS_SYSINTE        0x3005 /* system interrupt enable */
210786baecfSMauro Carvalho Chehab #define SYS_SYSINTS        0x3006 /* system interrupt status */
211786baecfSMauro Carvalho Chehab #define SYS_GPIO_CFG0      0x3007 /* PAD configuration for GPIO0-GPIO3 */
212786baecfSMauro Carvalho Chehab #define SYS_SYS2           0x3008 /* include GP_CFG1 and 3 reserved bytes */
213786baecfSMauro Carvalho Chehab #define SYS_GPIO_CFG1      0x3008 /* PAD configuration for GPIO4 */
214786baecfSMauro Carvalho Chehab #define SYS_DEMOD_CTL1     0x300B
215786baecfSMauro Carvalho Chehab 
216786baecfSMauro Carvalho Chehab /* IrDA registers */
217786baecfSMauro Carvalho Chehab #define SYS_IRRC_PSR       0x3020 /* IR protocol selection */
218786baecfSMauro Carvalho Chehab #define SYS_IRRC_PER       0x3024 /* IR protocol extension */
219786baecfSMauro Carvalho Chehab #define SYS_IRRC_SF        0x3028 /* IR sampling frequency */
220786baecfSMauro Carvalho Chehab #define SYS_IRRC_DPIR      0x302C /* IR data package interval */
221786baecfSMauro Carvalho Chehab #define SYS_IRRC_CR        0x3030 /* IR control */
222786baecfSMauro Carvalho Chehab #define SYS_IRRC_RP        0x3034 /* IR read port */
223786baecfSMauro Carvalho Chehab #define SYS_IRRC_SR        0x3038 /* IR status */
224786baecfSMauro Carvalho Chehab /* I2C master registers */
225786baecfSMauro Carvalho Chehab #define SYS_I2CCR          0x3040 /* I2C clock */
226786baecfSMauro Carvalho Chehab #define SYS_I2CMCR         0x3044 /* I2C master control */
227786baecfSMauro Carvalho Chehab #define SYS_I2CMSTR        0x3048 /* I2C master SCL timing */
228786baecfSMauro Carvalho Chehab #define SYS_I2CMSR         0x304C /* I2C master status */
229786baecfSMauro Carvalho Chehab #define SYS_I2CMFR         0x3050 /* I2C master FIFO */
230786baecfSMauro Carvalho Chehab 
231786baecfSMauro Carvalho Chehab /*
232786baecfSMauro Carvalho Chehab  * IR registers
233786baecfSMauro Carvalho Chehab  */
234786baecfSMauro Carvalho Chehab #define IR_RX_BUF          0xFC00
235786baecfSMauro Carvalho Chehab #define IR_RX_IE           0xFD00
236786baecfSMauro Carvalho Chehab #define IR_RX_IF           0xFD01
237786baecfSMauro Carvalho Chehab #define IR_RX_CTRL         0xFD02
238786baecfSMauro Carvalho Chehab #define IR_RX_CFG          0xFD03
239786baecfSMauro Carvalho Chehab #define IR_MAX_DURATION0   0xFD04
240786baecfSMauro Carvalho Chehab #define IR_MAX_DURATION1   0xFD05
241786baecfSMauro Carvalho Chehab #define IR_IDLE_LEN0       0xFD06
242786baecfSMauro Carvalho Chehab #define IR_IDLE_LEN1       0xFD07
243786baecfSMauro Carvalho Chehab #define IR_GLITCH_LEN      0xFD08
244786baecfSMauro Carvalho Chehab #define IR_RX_BUF_CTRL     0xFD09
245786baecfSMauro Carvalho Chehab #define IR_RX_BUF_DATA     0xFD0A
246786baecfSMauro Carvalho Chehab #define IR_RX_BC           0xFD0B
247786baecfSMauro Carvalho Chehab #define IR_RX_CLK          0xFD0C
248786baecfSMauro Carvalho Chehab #define IR_RX_C_COUNT_L    0xFD0D
249786baecfSMauro Carvalho Chehab #define IR_RX_C_COUNT_H    0xFD0E
250786baecfSMauro Carvalho Chehab #define IR_SUSPEND_CTRL    0xFD10
251786baecfSMauro Carvalho Chehab #define IR_ERR_TOL_CTRL    0xFD11
252786baecfSMauro Carvalho Chehab #define IR_UNIT_LEN        0xFD12
253786baecfSMauro Carvalho Chehab #define IR_ERR_TOL_LEN     0xFD13
254786baecfSMauro Carvalho Chehab #define IR_MAX_H_TOL_LEN   0xFD14
255786baecfSMauro Carvalho Chehab #define IR_MAX_L_TOL_LEN   0xFD15
256786baecfSMauro Carvalho Chehab #define IR_MASK_CTRL       0xFD16
257786baecfSMauro Carvalho Chehab #define IR_MASK_DATA       0xFD17
258786baecfSMauro Carvalho Chehab #define IR_RES_MASK_ADDR   0xFD18
259786baecfSMauro Carvalho Chehab #define IR_RES_MASK_T_LEN  0xFD19
260786baecfSMauro Carvalho Chehab 
261786baecfSMauro Carvalho Chehab #endif
262