blob: e29fca2ba1250d98780ad097574e484205bedd95 [file] [log] [blame]
Antti Palosaari831e0b72011-07-08 23:36:07 -03001/*
2 * Realtek RTL28xxU DVB USB driver
3 *
4 * Copyright (C) 2009 Antti Palosaari <crope@iki.fi>
5 * Copyright (C) 2011 Antti Palosaari <crope@iki.fi>
Thomas Mair5cf66312012-05-18 14:47:41 -03006 * Copyright (C) 2012 Thomas Mair <thomas.mair86@googlemail.com>
Antti Palosaari831e0b72011-07-08 23:36:07 -03007 *
8 * This program is free software; you can redistribute it and/or modify
9 * it under the terms of the GNU General Public License as published by
10 * the Free Software Foundation; either version 2 of the License, or
11 * (at your option) any later version.
12 *
13 * This program is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 * GNU General Public License for more details.
17 *
18 * You should have received a copy of the GNU General Public License along
19 * with this program; if not, write to the Free Software Foundation, Inc.,
20 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
21 */
22
23#include "rtl28xxu.h"
24
25#include "rtl2830.h"
Thomas Mair5cf66312012-05-18 14:47:41 -030026#include "rtl2832.h"
Antti Palosaari831e0b72011-07-08 23:36:07 -030027
28#include "qt1010.h"
29#include "mt2060.h"
30#include "mxl5005s.h"
Thomas Mair5cf66312012-05-18 14:47:41 -030031#include "fc0012.h"
32#include "fc0013.h"
Antti Palosaari831e0b72011-07-08 23:36:07 -030033
Antti Palosaari831e0b72011-07-08 23:36:07 -030034DVB_DEFINE_MOD_OPT_ADAPTER_NR(adapter_nr);
35
36static int rtl28xxu_ctrl_msg(struct dvb_usb_device *d, struct rtl28xxu_req *req)
37{
38 int ret;
39 unsigned int pipe;
40 u8 requesttype;
41 u8 *buf;
42
43 buf = kmalloc(req->size, GFP_KERNEL);
44 if (!buf) {
45 ret = -ENOMEM;
46 goto err;
47 }
48
49 if (req->index & CMD_WR_FLAG) {
50 /* write */
51 memcpy(buf, req->data, req->size);
52 requesttype = (USB_TYPE_VENDOR | USB_DIR_OUT);
53 pipe = usb_sndctrlpipe(d->udev, 0);
54 } else {
55 /* read */
56 requesttype = (USB_TYPE_VENDOR | USB_DIR_IN);
57 pipe = usb_rcvctrlpipe(d->udev, 0);
58 }
59
60 ret = usb_control_msg(d->udev, pipe, 0, requesttype, req->value,
Antti Palosaari9935eea2012-01-21 22:26:52 -030061 req->index, buf, req->size, 1000);
Antti Palosaarid89b9362012-08-22 19:42:00 -030062
63 dvb_usb_dbg_usb_control_msg(d->udev, 0, requesttype, req->value,
64 req->index, buf, req->size);
65
Antti Palosaari9935eea2012-01-21 22:26:52 -030066 if (ret > 0)
67 ret = 0;
Antti Palosaari831e0b72011-07-08 23:36:07 -030068
Antti Palosaari831e0b72011-07-08 23:36:07 -030069 /* read request, copy returned data to return buf */
70 if (!ret && requesttype == (USB_TYPE_VENDOR | USB_DIR_IN))
71 memcpy(req->data, buf, req->size);
72
73 kfree(buf);
Antti Palosaari831e0b72011-07-08 23:36:07 -030074
Antti Palosaari9935eea2012-01-21 22:26:52 -030075 if (ret)
76 goto err;
77
78 return ret;
Antti Palosaari831e0b72011-07-08 23:36:07 -030079err:
Antti Palosaaric01a3592012-08-12 22:27:07 -030080 dev_dbg(&d->udev->dev, "%s: failed=%d\n", __func__, ret);
Antti Palosaari831e0b72011-07-08 23:36:07 -030081 return ret;
82}
83
Thomas Mair40a2d3c2012-05-18 14:47:42 -030084static int rtl28xx_wr_regs(struct dvb_usb_device *d, u16 reg, u8 *val, int len)
Antti Palosaari831e0b72011-07-08 23:36:07 -030085{
86 struct rtl28xxu_req req;
87
88 if (reg < 0x3000)
89 req.index = CMD_USB_WR;
Antti Palosaarib5cbaa42011-08-04 13:26:10 -030090 else if (reg < 0x4000)
Antti Palosaari831e0b72011-07-08 23:36:07 -030091 req.index = CMD_SYS_WR;
Antti Palosaarib5cbaa42011-08-04 13:26:10 -030092 else
93 req.index = CMD_IR_WR;
Antti Palosaari831e0b72011-07-08 23:36:07 -030094
95 req.value = reg;
96 req.size = len;
97 req.data = val;
98
99 return rtl28xxu_ctrl_msg(d, &req);
100}
101
102static int rtl2831_rd_regs(struct dvb_usb_device *d, u16 reg, u8 *val, int len)
103{
104 struct rtl28xxu_req req;
105
106 if (reg < 0x3000)
107 req.index = CMD_USB_RD;
Antti Palosaarib5cbaa42011-08-04 13:26:10 -0300108 else if (reg < 0x4000)
Antti Palosaari831e0b72011-07-08 23:36:07 -0300109 req.index = CMD_SYS_RD;
Antti Palosaarib5cbaa42011-08-04 13:26:10 -0300110 else
111 req.index = CMD_IR_RD;
Antti Palosaari831e0b72011-07-08 23:36:07 -0300112
113 req.value = reg;
114 req.size = len;
115 req.data = val;
116
117 return rtl28xxu_ctrl_msg(d, &req);
118}
119
Thomas Mair40a2d3c2012-05-18 14:47:42 -0300120static int rtl28xx_wr_reg(struct dvb_usb_device *d, u16 reg, u8 val)
Antti Palosaari831e0b72011-07-08 23:36:07 -0300121{
Thomas Mair40a2d3c2012-05-18 14:47:42 -0300122 return rtl28xx_wr_regs(d, reg, &val, 1);
Antti Palosaari831e0b72011-07-08 23:36:07 -0300123}
124
Thomas Mair40a2d3c2012-05-18 14:47:42 -0300125static int rtl28xx_rd_reg(struct dvb_usb_device *d, u16 reg, u8 *val)
Antti Palosaari831e0b72011-07-08 23:36:07 -0300126{
127 return rtl2831_rd_regs(d, reg, val, 1);
128}
129
130/* I2C */
131static int rtl28xxu_i2c_xfer(struct i2c_adapter *adap, struct i2c_msg msg[],
132 int num)
133{
134 int ret;
135 struct dvb_usb_device *d = i2c_get_adapdata(adap);
Antti Palosaari34ec2932011-08-04 20:21:16 -0300136 struct rtl28xxu_priv *priv = d->priv;
Antti Palosaari831e0b72011-07-08 23:36:07 -0300137 struct rtl28xxu_req req;
138
139 /*
140 * It is not known which are real I2C bus xfer limits, but testing
141 * with RTL2831U + MT2060 gives max RD 24 and max WR 22 bytes.
Antti Palosaari34ec2932011-08-04 20:21:16 -0300142 * TODO: find out RTL2832U lens
143 */
144
145 /*
146 * I2C adapter logic looks rather complicated due to fact it handles
147 * three different access methods. Those methods are;
148 * 1) integrated demod access
149 * 2) old I2C access
150 * 3) new I2C access
151 *
152 * Used method is selected in order 1, 2, 3. Method 3 can handle all
153 * requests but there is two reasons why not use it always;
154 * 1) It is most expensive, usually two USB messages are needed
155 * 2) At least RTL2831U does not support it
156 *
157 * Method 3 is needed in case of I2C write+read (typical register read)
158 * where write is more than one byte.
Antti Palosaari831e0b72011-07-08 23:36:07 -0300159 */
160
161 if (mutex_lock_interruptible(&d->i2c_mutex) < 0)
162 return -EAGAIN;
163
164 if (num == 2 && !(msg[0].flags & I2C_M_RD) &&
165 (msg[1].flags & I2C_M_RD)) {
Antti Palosaari34ec2932011-08-04 20:21:16 -0300166 if (msg[0].len > 24 || msg[1].len > 24) {
167 /* TODO: check msg[0].len max */
Antti Palosaari831e0b72011-07-08 23:36:07 -0300168 ret = -EOPNOTSUPP;
Antti Palosaari9935eea2012-01-21 22:26:52 -0300169 goto err_mutex_unlock;
Antti Palosaari34ec2932011-08-04 20:21:16 -0300170 } else if (msg[0].addr == 0x10) {
171 /* method 1 - integrated demod */
172 req.value = (msg[0].buf[0] << 8) | (msg[0].addr << 1);
173 req.index = CMD_DEMOD_RD | priv->page;
Antti Palosaari831e0b72011-07-08 23:36:07 -0300174 req.size = msg[1].len;
175 req.data = &msg[1].buf[0];
176 ret = rtl28xxu_ctrl_msg(d, &req);
Antti Palosaari34ec2932011-08-04 20:21:16 -0300177 } else if (msg[0].len < 2) {
178 /* method 2 - old I2C */
Antti Palosaari831e0b72011-07-08 23:36:07 -0300179 req.value = (msg[0].buf[0] << 8) | (msg[0].addr << 1);
180 req.index = CMD_I2C_RD;
181 req.size = msg[1].len;
182 req.data = &msg[1].buf[0];
183 ret = rtl28xxu_ctrl_msg(d, &req);
Antti Palosaari34ec2932011-08-04 20:21:16 -0300184 } else {
185 /* method 3 - new I2C */
186 req.value = (msg[0].addr << 1);
187 req.index = CMD_I2C_DA_WR;
188 req.size = msg[0].len;
189 req.data = msg[0].buf;
190 ret = rtl28xxu_ctrl_msg(d, &req);
191 if (ret)
Antti Palosaari9935eea2012-01-21 22:26:52 -0300192 goto err_mutex_unlock;
Antti Palosaari34ec2932011-08-04 20:21:16 -0300193
194 req.value = (msg[0].addr << 1);
195 req.index = CMD_I2C_DA_RD;
196 req.size = msg[1].len;
197 req.data = msg[1].buf;
198 ret = rtl28xxu_ctrl_msg(d, &req);
Antti Palosaari831e0b72011-07-08 23:36:07 -0300199 }
200 } else if (num == 1 && !(msg[0].flags & I2C_M_RD)) {
201 if (msg[0].len > 22) {
Antti Palosaari34ec2932011-08-04 20:21:16 -0300202 /* TODO: check msg[0].len max */
Antti Palosaari831e0b72011-07-08 23:36:07 -0300203 ret = -EOPNOTSUPP;
Antti Palosaari9935eea2012-01-21 22:26:52 -0300204 goto err_mutex_unlock;
Antti Palosaari34ec2932011-08-04 20:21:16 -0300205 } else if (msg[0].addr == 0x10) {
206 /* method 1 - integrated demod */
207 if (msg[0].buf[0] == 0x00) {
208 /* save demod page for later demod access */
209 priv->page = msg[0].buf[1];
210 ret = 0;
211 } else {
212 req.value = (msg[0].buf[0] << 8) |
213 (msg[0].addr << 1);
214 req.index = CMD_DEMOD_WR | priv->page;
215 req.size = msg[0].len-1;
216 req.data = &msg[0].buf[1];
217 ret = rtl28xxu_ctrl_msg(d, &req);
218 }
219 } else if (msg[0].len < 23) {
220 /* method 2 - old I2C */
Antti Palosaari831e0b72011-07-08 23:36:07 -0300221 req.value = (msg[0].buf[0] << 8) | (msg[0].addr << 1);
222 req.index = CMD_I2C_WR;
223 req.size = msg[0].len-1;
224 req.data = &msg[0].buf[1];
225 ret = rtl28xxu_ctrl_msg(d, &req);
Antti Palosaari34ec2932011-08-04 20:21:16 -0300226 } else {
227 /* method 3 - new I2C */
228 req.value = (msg[0].addr << 1);
229 req.index = CMD_I2C_DA_WR;
230 req.size = msg[0].len;
231 req.data = msg[0].buf;
232 ret = rtl28xxu_ctrl_msg(d, &req);
Antti Palosaari831e0b72011-07-08 23:36:07 -0300233 }
234 } else {
235 ret = -EINVAL;
236 }
237
Antti Palosaari9935eea2012-01-21 22:26:52 -0300238err_mutex_unlock:
Antti Palosaari831e0b72011-07-08 23:36:07 -0300239 mutex_unlock(&d->i2c_mutex);
240
241 return ret ? ret : num;
242}
243
244static u32 rtl28xxu_i2c_func(struct i2c_adapter *adapter)
245{
246 return I2C_FUNC_I2C;
247}
248
249static struct i2c_algorithm rtl28xxu_i2c_algo = {
250 .master_xfer = rtl28xxu_i2c_xfer,
251 .functionality = rtl28xxu_i2c_func,
252};
253
254static struct rtl2830_config rtl28xxu_rtl2830_mt2060_config = {
255 .i2c_addr = 0x10, /* 0x20 */
256 .xtal = 28800000,
257 .ts_mode = 0,
258 .spec_inv = 1,
259 .if_dvbt = 36150000,
260 .vtop = 0x20,
261 .krf = 0x04,
262 .agc_targ_val = 0x2d,
263
264};
265
266static struct rtl2830_config rtl28xxu_rtl2830_qt1010_config = {
267 .i2c_addr = 0x10, /* 0x20 */
268 .xtal = 28800000,
269 .ts_mode = 0,
270 .spec_inv = 1,
271 .if_dvbt = 36125000,
272 .vtop = 0x20,
273 .krf = 0x04,
274 .agc_targ_val = 0x2d,
275};
276
277static struct rtl2830_config rtl28xxu_rtl2830_mxl5005s_config = {
278 .i2c_addr = 0x10, /* 0x20 */
279 .xtal = 28800000,
280 .ts_mode = 0,
281 .spec_inv = 0,
282 .if_dvbt = 4570000,
283 .vtop = 0x3f,
284 .krf = 0x04,
285 .agc_targ_val = 0x3e,
286};
287
Antti Palosaarib5cbaa42011-08-04 13:26:10 -0300288static int rtl2831u_frontend_attach(struct dvb_usb_adapter *adap)
Antti Palosaari831e0b72011-07-08 23:36:07 -0300289{
290 int ret;
Antti Palosaaric01a3592012-08-12 22:27:07 -0300291 struct dvb_usb_device *d = adap_to_d(adap);
292 struct rtl28xxu_priv *priv = d_to_priv(d);
Antti Palosaari831e0b72011-07-08 23:36:07 -0300293 u8 buf[1];
294 struct rtl2830_config *rtl2830_config;
Antti Palosaarib5cbaa42011-08-04 13:26:10 -0300295 /* open RTL2831U/RTL2830 I2C gate */
Antti Palosaari9935eea2012-01-21 22:26:52 -0300296 struct rtl28xxu_req req_gate = { 0x0120, 0x0011, 0x0001, "\x08" };
Antti Palosaari831e0b72011-07-08 23:36:07 -0300297 /* for MT2060 tuner probe */
Antti Palosaari9935eea2012-01-21 22:26:52 -0300298 struct rtl28xxu_req req_mt2060 = { 0x00c0, CMD_I2C_RD, 1, buf };
Antti Palosaari831e0b72011-07-08 23:36:07 -0300299 /* for QT1010 tuner probe */
Antti Palosaari9935eea2012-01-21 22:26:52 -0300300 struct rtl28xxu_req req_qt1010 = { 0x0fc4, CMD_I2C_RD, 1, buf };
Antti Palosaari831e0b72011-07-08 23:36:07 -0300301
Antti Palosaaric01a3592012-08-12 22:27:07 -0300302 dev_dbg(&d->udev->dev, "%s:\n", __func__);
Antti Palosaari831e0b72011-07-08 23:36:07 -0300303
304 /*
305 * RTL2831U GPIOs
306 * =========================================================
307 * GPIO0 | tuner#0 | 0 off | 1 on | MXL5005S (?)
308 * GPIO2 | LED | 0 off | 1 on |
309 * GPIO4 | tuner#1 | 0 on | 1 off | MT2060
310 */
311
312 /* GPIO direction */
Antti Palosaaric01a3592012-08-12 22:27:07 -0300313 ret = rtl28xx_wr_reg(d, SYS_GPIO_DIR, 0x0a);
Antti Palosaari831e0b72011-07-08 23:36:07 -0300314 if (ret)
315 goto err;
316
317 /* enable as output GPIO0, GPIO2, GPIO4 */
Antti Palosaaric01a3592012-08-12 22:27:07 -0300318 ret = rtl28xx_wr_reg(d, SYS_GPIO_OUT_EN, 0x15);
Antti Palosaari831e0b72011-07-08 23:36:07 -0300319 if (ret)
320 goto err;
321
322 /*
323 * Probe used tuner. We need to know used tuner before demod attach
324 * since there is some demod params needed to set according to tuner.
325 */
326
Antti Palosaariccb5cf92012-05-18 16:07:46 -0300327 /* demod needs some time to wake up */
328 msleep(20);
329
Antti Palosaari831e0b72011-07-08 23:36:07 -0300330 /* open demod I2C gate */
Antti Palosaaric01a3592012-08-12 22:27:07 -0300331 ret = rtl28xxu_ctrl_msg(d, &req_gate);
Antti Palosaari831e0b72011-07-08 23:36:07 -0300332 if (ret)
333 goto err;
334
335 /* check QT1010 ID(?) register; reg=0f val=2c */
Antti Palosaaric01a3592012-08-12 22:27:07 -0300336 ret = rtl28xxu_ctrl_msg(d, &req_qt1010);
Antti Palosaari831e0b72011-07-08 23:36:07 -0300337 if (ret == 0 && buf[0] == 0x2c) {
338 priv->tuner = TUNER_RTL2830_QT1010;
339 rtl2830_config = &rtl28xxu_rtl2830_qt1010_config;
Antti Palosaaric01a3592012-08-12 22:27:07 -0300340 dev_dbg(&d->udev->dev, "%s: QT1010\n", __func__);
Antti Palosaari831e0b72011-07-08 23:36:07 -0300341 goto found;
342 } else {
Antti Palosaaric01a3592012-08-12 22:27:07 -0300343 dev_dbg(&d->udev->dev, "%s: QT1010 probe failed=%d - %02x\n",
344 __func__, ret, buf[0]);
Antti Palosaari831e0b72011-07-08 23:36:07 -0300345 }
346
347 /* open demod I2C gate */
Antti Palosaaric01a3592012-08-12 22:27:07 -0300348 ret = rtl28xxu_ctrl_msg(d, &req_gate);
Antti Palosaari831e0b72011-07-08 23:36:07 -0300349 if (ret)
350 goto err;
351
352 /* check MT2060 ID register; reg=00 val=63 */
Antti Palosaaric01a3592012-08-12 22:27:07 -0300353 ret = rtl28xxu_ctrl_msg(d, &req_mt2060);
Antti Palosaari831e0b72011-07-08 23:36:07 -0300354 if (ret == 0 && buf[0] == 0x63) {
355 priv->tuner = TUNER_RTL2830_MT2060;
356 rtl2830_config = &rtl28xxu_rtl2830_mt2060_config;
Antti Palosaaric01a3592012-08-12 22:27:07 -0300357 dev_dbg(&d->udev->dev, "%s: MT2060\n", __func__);
Antti Palosaari831e0b72011-07-08 23:36:07 -0300358 goto found;
359 } else {
Antti Palosaaric01a3592012-08-12 22:27:07 -0300360 dev_dbg(&d->udev->dev, "%s: MT2060 probe failed=%d - %02x\n",
361 __func__, ret, buf[0]);
Antti Palosaari831e0b72011-07-08 23:36:07 -0300362 }
363
364 /* assume MXL5005S */
Antti Palosaarie9320ec2011-08-03 04:35:30 -0300365 ret = 0;
Antti Palosaari831e0b72011-07-08 23:36:07 -0300366 priv->tuner = TUNER_RTL2830_MXL5005S;
367 rtl2830_config = &rtl28xxu_rtl2830_mxl5005s_config;
Antti Palosaaric01a3592012-08-12 22:27:07 -0300368 dev_dbg(&d->udev->dev, "%s: MXL5005S\n", __func__);
Antti Palosaari831e0b72011-07-08 23:36:07 -0300369 goto found;
370
371found:
372 /* attach demodulator */
Antti Palosaaric01a3592012-08-12 22:27:07 -0300373 adap->fe[0] = dvb_attach(rtl2830_attach, rtl2830_config,
374 &d->i2c_adap);
375 if (adap->fe[0] == NULL) {
Antti Palosaari831e0b72011-07-08 23:36:07 -0300376 ret = -ENODEV;
377 goto err;
378 }
379
380 return ret;
381err:
Antti Palosaaric01a3592012-08-12 22:27:07 -0300382 dev_dbg(&d->udev->dev, "%s: failed=%d\n", __func__, ret);
Antti Palosaari831e0b72011-07-08 23:36:07 -0300383 return ret;
384}
385
Thomas Mair5cf66312012-05-18 14:47:41 -0300386static struct rtl2832_config rtl28xxu_rtl2832_fc0012_config = {
387 .i2c_addr = 0x10, /* 0x20 */
388 .xtal = 28800000,
389 .if_dvbt = 0,
390 .tuner = TUNER_RTL2832_FC0012
391};
392
393static struct rtl2832_config rtl28xxu_rtl2832_fc0013_config = {
394 .i2c_addr = 0x10, /* 0x20 */
395 .xtal = 28800000,
396 .if_dvbt = 0,
397 .tuner = TUNER_RTL2832_FC0013
398};
399
400static int rtl2832u_fc0012_tuner_callback(struct dvb_usb_device *d,
401 int cmd, int arg)
402{
403 int ret;
404 u8 val;
405
Antti Palosaaric01a3592012-08-12 22:27:07 -0300406 dev_dbg(&d->udev->dev, "%s: cmd=%d arg=%d\n", __func__, cmd, arg);
407
Thomas Mair5cf66312012-05-18 14:47:41 -0300408 switch (cmd) {
409 case FC_FE_CALLBACK_VHF_ENABLE:
410 /* set output values */
Thomas Mair40a2d3c2012-05-18 14:47:42 -0300411 ret = rtl28xx_rd_reg(d, SYS_GPIO_OUT_VAL, &val);
Thomas Mair5cf66312012-05-18 14:47:41 -0300412 if (ret)
413 goto err;
414
415 if (arg)
416 val &= 0xbf; /* set GPIO6 low */
417 else
418 val |= 0x40; /* set GPIO6 high */
419
420
Thomas Mair40a2d3c2012-05-18 14:47:42 -0300421 ret = rtl28xx_wr_reg(d, SYS_GPIO_OUT_VAL, val);
Thomas Mair5cf66312012-05-18 14:47:41 -0300422 if (ret)
423 goto err;
424 break;
425 default:
426 ret = -EINVAL;
427 goto err;
428 }
429 return 0;
430
431err:
Antti Palosaaric01a3592012-08-12 22:27:07 -0300432 dev_dbg(&d->udev->dev, "%s: failed=%d\n", __func__, ret);
Thomas Mair5cf66312012-05-18 14:47:41 -0300433 return ret;
434}
435
436
437static int rtl2832u_fc0013_tuner_callback(struct dvb_usb_device *d,
438 int cmd, int arg)
439{
440 /* TODO implement*/
441 return 0;
442}
443
444static int rtl2832u_tuner_callback(struct dvb_usb_device *d, int cmd, int arg)
445{
446 struct rtl28xxu_priv *priv = d->priv;
447
448 switch (priv->tuner) {
449 case TUNER_RTL2832_FC0012:
450 return rtl2832u_fc0012_tuner_callback(d, cmd, arg);
451
452 case TUNER_RTL2832_FC0013:
453 return rtl2832u_fc0013_tuner_callback(d, cmd, arg);
454 default:
455 break;
456 }
457
458 return -ENODEV;
459}
460
461static int rtl2832u_frontend_callback(void *adapter_priv, int component,
462 int cmd, int arg)
463{
464 struct i2c_adapter *adap = adapter_priv;
465 struct dvb_usb_device *d = i2c_get_adapdata(adap);
466
467 switch (component) {
468 case DVB_FRONTEND_COMPONENT_TUNER:
469 return rtl2832u_tuner_callback(d, cmd, arg);
470 default:
471 break;
472 }
473
474 return -EINVAL;
475}
476
Antti Palosaarib5cbaa42011-08-04 13:26:10 -0300477static int rtl2832u_frontend_attach(struct dvb_usb_adapter *adap)
478{
479 int ret;
Antti Palosaaric01a3592012-08-12 22:27:07 -0300480 struct dvb_usb_device *d = adap_to_d(adap);
481 struct rtl28xxu_priv *priv = d_to_priv(d);
Thomas Mair5cf66312012-05-18 14:47:41 -0300482 struct rtl2832_config *rtl2832_config;
Thomas Mair5cf66312012-05-18 14:47:41 -0300483 u8 buf[2], val;
Antti Palosaarib5cbaa42011-08-04 13:26:10 -0300484 /* open RTL2832U/RTL2832 I2C gate */
485 struct rtl28xxu_req req_gate_open = {0x0120, 0x0011, 0x0001, "\x18"};
486 /* close RTL2832U/RTL2832 I2C gate */
487 struct rtl28xxu_req req_gate_close = {0x0120, 0x0011, 0x0001, "\x10"};
Thomas Mair5cf66312012-05-18 14:47:41 -0300488 /* for FC0012 tuner probe */
489 struct rtl28xxu_req req_fc0012 = {0x00c6, CMD_I2C_RD, 1, buf};
490 /* for FC0013 tuner probe */
491 struct rtl28xxu_req req_fc0013 = {0x00c6, CMD_I2C_RD, 1, buf};
492 /* for MT2266 tuner probe */
493 struct rtl28xxu_req req_mt2266 = {0x00c0, CMD_I2C_RD, 1, buf};
Antti Palosaarib5cbaa42011-08-04 13:26:10 -0300494 /* for FC2580 tuner probe */
495 struct rtl28xxu_req req_fc2580 = {0x01ac, CMD_I2C_RD, 1, buf};
Thomas Mair5cf66312012-05-18 14:47:41 -0300496 /* for MT2063 tuner probe */
497 struct rtl28xxu_req req_mt2063 = {0x00c0, CMD_I2C_RD, 1, buf};
498 /* for MAX3543 tuner probe */
499 struct rtl28xxu_req req_max3543 = {0x00c0, CMD_I2C_RD, 1, buf};
500 /* for TUA9001 tuner probe */
501 struct rtl28xxu_req req_tua9001 = {0x7ec0, CMD_I2C_RD, 2, buf};
502 /* for MXL5007T tuner probe */
503 struct rtl28xxu_req req_mxl5007t = {0xd9c0, CMD_I2C_RD, 1, buf};
504 /* for E4000 tuner probe */
505 struct rtl28xxu_req req_e4000 = {0x02c8, CMD_I2C_RD, 1, buf};
506 /* for TDA18272 tuner probe */
507 struct rtl28xxu_req req_tda18272 = {0x00c0, CMD_I2C_RD, 2, buf};
Antti Palosaarib5cbaa42011-08-04 13:26:10 -0300508
Antti Palosaaric01a3592012-08-12 22:27:07 -0300509 dev_dbg(&d->udev->dev, "%s:\n", __func__);
Antti Palosaarib5cbaa42011-08-04 13:26:10 -0300510
Antti Palosaaric01a3592012-08-12 22:27:07 -0300511 ret = rtl28xx_rd_reg(d, SYS_GPIO_DIR, &val);
Antti Palosaarib5cbaa42011-08-04 13:26:10 -0300512 if (ret)
513 goto err;
514
Thomas Mair5cf66312012-05-18 14:47:41 -0300515 val &= 0xbf;
516
Antti Palosaaric01a3592012-08-12 22:27:07 -0300517 ret = rtl28xx_wr_reg(d, SYS_GPIO_DIR, val);
Antti Palosaarib5cbaa42011-08-04 13:26:10 -0300518 if (ret)
519 goto err;
520
Thomas Mair5cf66312012-05-18 14:47:41 -0300521 /* enable as output GPIO3 and GPIO6*/
Antti Palosaaric01a3592012-08-12 22:27:07 -0300522 ret = rtl28xx_rd_reg(d, SYS_GPIO_OUT_EN, &val);
Antti Palosaarib5cbaa42011-08-04 13:26:10 -0300523 if (ret)
524 goto err;
525
Thomas Mair5cf66312012-05-18 14:47:41 -0300526 val |= 0x48;
527
Antti Palosaaric01a3592012-08-12 22:27:07 -0300528 ret = rtl28xx_wr_reg(d, SYS_GPIO_OUT_EN, val);
Thomas Mair5cf66312012-05-18 14:47:41 -0300529 if (ret)
530 goto err;
531
Antti Palosaarib5cbaa42011-08-04 13:26:10 -0300532 /*
533 * Probe used tuner. We need to know used tuner before demod attach
534 * since there is some demod params needed to set according to tuner.
535 */
536
537 /* open demod I2C gate */
Antti Palosaaric01a3592012-08-12 22:27:07 -0300538 ret = rtl28xxu_ctrl_msg(d, &req_gate_open);
Antti Palosaarib5cbaa42011-08-04 13:26:10 -0300539 if (ret)
540 goto err;
541
Thomas Mair5cf66312012-05-18 14:47:41 -0300542 priv->tuner = TUNER_NONE;
543
544 /* check FC0012 ID register; reg=00 val=a1 */
Antti Palosaaric01a3592012-08-12 22:27:07 -0300545 ret = rtl28xxu_ctrl_msg(d, &req_fc0012);
Thomas Mair5cf66312012-05-18 14:47:41 -0300546 if (ret == 0 && buf[0] == 0xa1) {
547 priv->tuner = TUNER_RTL2832_FC0012;
548 rtl2832_config = &rtl28xxu_rtl2832_fc0012_config;
Antti Palosaaric01a3592012-08-12 22:27:07 -0300549 dev_info(&d->udev->dev, "%s: FC0012 tuner found",
550 KBUILD_MODNAME);
Thomas Mair5cf66312012-05-18 14:47:41 -0300551 goto found;
552 }
553
554 /* check FC0013 ID register; reg=00 val=a3 */
Antti Palosaaric01a3592012-08-12 22:27:07 -0300555 ret = rtl28xxu_ctrl_msg(d, &req_fc0013);
Thomas Mair5cf66312012-05-18 14:47:41 -0300556 if (ret == 0 && buf[0] == 0xa3) {
557 priv->tuner = TUNER_RTL2832_FC0013;
558 rtl2832_config = &rtl28xxu_rtl2832_fc0013_config;
Antti Palosaaric01a3592012-08-12 22:27:07 -0300559 dev_info(&d->udev->dev, "%s: FC0013 tuner found",
560 KBUILD_MODNAME);
Thomas Mair5cf66312012-05-18 14:47:41 -0300561 goto found;
562 }
563
564 /* check MT2266 ID register; reg=00 val=85 */
Antti Palosaaric01a3592012-08-12 22:27:07 -0300565 ret = rtl28xxu_ctrl_msg(d, &req_mt2266);
Thomas Mair5cf66312012-05-18 14:47:41 -0300566 if (ret == 0 && buf[0] == 0x85) {
567 priv->tuner = TUNER_RTL2832_MT2266;
568 /* TODO implement tuner */
Antti Palosaaric01a3592012-08-12 22:27:07 -0300569 dev_info(&d->udev->dev, "%s: MT2266 tuner found",
570 KBUILD_MODNAME);
Thomas Mair5cf66312012-05-18 14:47:41 -0300571 goto unsupported;
572 }
573
Antti Palosaarib5cbaa42011-08-04 13:26:10 -0300574 /* check FC2580 ID register; reg=01 val=56 */
Antti Palosaaric01a3592012-08-12 22:27:07 -0300575 ret = rtl28xxu_ctrl_msg(d, &req_fc2580);
Antti Palosaarib5cbaa42011-08-04 13:26:10 -0300576 if (ret == 0 && buf[0] == 0x56) {
577 priv->tuner = TUNER_RTL2832_FC2580;
Thomas Mair5cf66312012-05-18 14:47:41 -0300578 /* TODO implement tuner */
Antti Palosaaric01a3592012-08-12 22:27:07 -0300579 dev_info(&d->udev->dev, "%s: FC2580 tuner found",
580 KBUILD_MODNAME);
Thomas Mair5cf66312012-05-18 14:47:41 -0300581 goto unsupported;
Antti Palosaarib5cbaa42011-08-04 13:26:10 -0300582 }
583
Thomas Mair5cf66312012-05-18 14:47:41 -0300584 /* check MT2063 ID register; reg=00 val=9e || 9c */
Antti Palosaaric01a3592012-08-12 22:27:07 -0300585 ret = rtl28xxu_ctrl_msg(d, &req_mt2063);
Thomas Mair5cf66312012-05-18 14:47:41 -0300586 if (ret == 0 && (buf[0] == 0x9e || buf[0] == 0x9c)) {
587 priv->tuner = TUNER_RTL2832_MT2063;
588 /* TODO implement tuner */
Antti Palosaaric01a3592012-08-12 22:27:07 -0300589 dev_info(&d->udev->dev, "%s: MT2063 tuner found",
590 KBUILD_MODNAME);
Thomas Mair5cf66312012-05-18 14:47:41 -0300591 goto unsupported;
592 }
593
594 /* check MAX3543 ID register; reg=00 val=38 */
Antti Palosaaric01a3592012-08-12 22:27:07 -0300595 ret = rtl28xxu_ctrl_msg(d, &req_max3543);
Thomas Mair5cf66312012-05-18 14:47:41 -0300596 if (ret == 0 && buf[0] == 0x38) {
597 priv->tuner = TUNER_RTL2832_MAX3543;
598 /* TODO implement tuner */
Antti Palosaaric01a3592012-08-12 22:27:07 -0300599 dev_info(&d->udev->dev, "%s: MAX3534 tuner found",
600 KBUILD_MODNAME);
Thomas Mair5cf66312012-05-18 14:47:41 -0300601 goto unsupported;
602 }
603
604 /* check TUA9001 ID register; reg=7e val=2328 */
Antti Palosaaric01a3592012-08-12 22:27:07 -0300605 ret = rtl28xxu_ctrl_msg(d, &req_tua9001);
Thomas Mair5cf66312012-05-18 14:47:41 -0300606 if (ret == 0 && buf[0] == 0x23 && buf[1] == 0x28) {
607 priv->tuner = TUNER_RTL2832_TUA9001;
608 /* TODO implement tuner */
Antti Palosaaric01a3592012-08-12 22:27:07 -0300609 dev_info(&d->udev->dev, "%s: TUA9001 tuner found",
610 KBUILD_MODNAME);
Thomas Mair5cf66312012-05-18 14:47:41 -0300611 goto unsupported;
612 }
613
614 /* check MXL5007R ID register; reg=d9 val=14 */
Antti Palosaaric01a3592012-08-12 22:27:07 -0300615 ret = rtl28xxu_ctrl_msg(d, &req_mxl5007t);
Thomas Mair5cf66312012-05-18 14:47:41 -0300616 if (ret == 0 && buf[0] == 0x14) {
617 priv->tuner = TUNER_RTL2832_MXL5007T;
618 /* TODO implement tuner */
Antti Palosaaric01a3592012-08-12 22:27:07 -0300619 dev_info(&d->udev->dev, "%s: MXL5007T tuner found",
620 KBUILD_MODNAME);
Thomas Mair5cf66312012-05-18 14:47:41 -0300621 goto unsupported;
622 }
623
624 /* check E4000 ID register; reg=02 val=40 */
Antti Palosaaric01a3592012-08-12 22:27:07 -0300625 ret = rtl28xxu_ctrl_msg(d, &req_e4000);
Thomas Mair5cf66312012-05-18 14:47:41 -0300626 if (ret == 0 && buf[0] == 0x40) {
627 priv->tuner = TUNER_RTL2832_E4000;
628 /* TODO implement tuner */
Antti Palosaaric01a3592012-08-12 22:27:07 -0300629 dev_info(&d->udev->dev, "%s: E4000 tuner found",
630 KBUILD_MODNAME);
Thomas Mair5cf66312012-05-18 14:47:41 -0300631 goto unsupported;
632 }
633
634 /* check TDA18272 ID register; reg=00 val=c760 */
Antti Palosaaric01a3592012-08-12 22:27:07 -0300635 ret = rtl28xxu_ctrl_msg(d, &req_tda18272);
Thomas Mair5cf66312012-05-18 14:47:41 -0300636 if (ret == 0 && (buf[0] == 0xc7 || buf[1] == 0x60)) {
637 priv->tuner = TUNER_RTL2832_TDA18272;
638 /* TODO implement tuner */
Antti Palosaaric01a3592012-08-12 22:27:07 -0300639 dev_info(&d->udev->dev, "%s: TDA18272 tuner found",
640 KBUILD_MODNAME);
Thomas Mair5cf66312012-05-18 14:47:41 -0300641 goto unsupported;
642 }
643
644unsupported:
Antti Palosaarib5cbaa42011-08-04 13:26:10 -0300645 /* close demod I2C gate */
Antti Palosaaric01a3592012-08-12 22:27:07 -0300646 ret = rtl28xxu_ctrl_msg(d, &req_gate_close);
Antti Palosaarib5cbaa42011-08-04 13:26:10 -0300647 if (ret)
648 goto err;
649
650 /* tuner not found */
Antti Palosaaric01a3592012-08-12 22:27:07 -0300651 dev_dbg(&d->udev->dev, "%s: No compatible tuner found\n", __func__);
Antti Palosaarib5cbaa42011-08-04 13:26:10 -0300652 ret = -ENODEV;
Thomas Mair5cf66312012-05-18 14:47:41 -0300653 return ret;
Antti Palosaarib5cbaa42011-08-04 13:26:10 -0300654
655found:
656 /* close demod I2C gate */
Antti Palosaaric01a3592012-08-12 22:27:07 -0300657 ret = rtl28xxu_ctrl_msg(d, &req_gate_close);
Antti Palosaarib5cbaa42011-08-04 13:26:10 -0300658 if (ret)
659 goto err;
660
661 /* attach demodulator */
Antti Palosaaric01a3592012-08-12 22:27:07 -0300662 adap->fe[0] = dvb_attach(rtl2832_attach, rtl2832_config,
663 &d->i2c_adap);
664 if (adap->fe[0] == NULL) {
Thomas Mair5cf66312012-05-18 14:47:41 -0300665 ret = -ENODEV;
666 goto err;
667 }
668
669 /* set fe callbacks */
Antti Palosaaric01a3592012-08-12 22:27:07 -0300670 adap->fe[0]->callback = rtl2832u_frontend_callback;
Antti Palosaarib5cbaa42011-08-04 13:26:10 -0300671
672 return ret;
Thomas Mair5cf66312012-05-18 14:47:41 -0300673
Antti Palosaarib5cbaa42011-08-04 13:26:10 -0300674err:
Antti Palosaaric01a3592012-08-12 22:27:07 -0300675 dev_dbg(&d->udev->dev, "%s: failed=%d\n", __func__, ret);
Antti Palosaarib5cbaa42011-08-04 13:26:10 -0300676 return ret;
677}
678
Antti Palosaari831e0b72011-07-08 23:36:07 -0300679static struct qt1010_config rtl28xxu_qt1010_config = {
680 .i2c_address = 0x62, /* 0xc4 */
681};
682
683static struct mt2060_config rtl28xxu_mt2060_config = {
684 .i2c_address = 0x60, /* 0xc0 */
685 .clock_out = 0,
686};
687
688static struct mxl5005s_config rtl28xxu_mxl5005s_config = {
689 .i2c_address = 0x63, /* 0xc6 */
690 .if_freq = IF_FREQ_4570000HZ,
691 .xtal_freq = CRYSTAL_FREQ_16000000HZ,
692 .agc_mode = MXL_SINGLE_AGC,
693 .tracking_filter = MXL_TF_C_H,
694 .rssi_enable = MXL_RSSI_ENABLE,
695 .cap_select = MXL_CAP_SEL_ENABLE,
696 .div_out = MXL_DIV_OUT_4,
697 .clock_out = MXL_CLOCK_OUT_DISABLE,
698 .output_load = MXL5005S_IF_OUTPUT_LOAD_200_OHM,
699 .top = MXL5005S_TOP_25P2,
700 .mod_mode = MXL_DIGITAL_MODE,
701 .if_mode = MXL_ZERO_IF,
702 .AgcMasterByte = 0x00,
703};
704
Antti Palosaarib5cbaa42011-08-04 13:26:10 -0300705static int rtl2831u_tuner_attach(struct dvb_usb_adapter *adap)
Antti Palosaari831e0b72011-07-08 23:36:07 -0300706{
707 int ret;
Antti Palosaaric01a3592012-08-12 22:27:07 -0300708 struct dvb_usb_device *d = adap_to_d(adap);
709 struct rtl28xxu_priv *priv = d_to_priv(d);
Antti Palosaari831e0b72011-07-08 23:36:07 -0300710 struct i2c_adapter *rtl2830_tuner_i2c;
Antti Palosaari9935eea2012-01-21 22:26:52 -0300711 struct dvb_frontend *fe;
Antti Palosaari831e0b72011-07-08 23:36:07 -0300712
Antti Palosaaric01a3592012-08-12 22:27:07 -0300713 dev_dbg(&d->udev->dev, "%s:\n", __func__);
Antti Palosaari831e0b72011-07-08 23:36:07 -0300714
715 /* use rtl2830 driver I2C adapter, for more info see rtl2830 driver */
Antti Palosaaric01a3592012-08-12 22:27:07 -0300716 rtl2830_tuner_i2c = rtl2830_get_tuner_i2c_adapter(adap->fe[0]);
Antti Palosaari831e0b72011-07-08 23:36:07 -0300717
718 switch (priv->tuner) {
719 case TUNER_RTL2830_QT1010:
Antti Palosaaric01a3592012-08-12 22:27:07 -0300720 fe = dvb_attach(qt1010_attach, adap->fe[0],
Antti Palosaarifba16b12012-01-21 20:28:38 -0300721 rtl2830_tuner_i2c, &rtl28xxu_qt1010_config);
Antti Palosaari831e0b72011-07-08 23:36:07 -0300722 break;
723 case TUNER_RTL2830_MT2060:
Antti Palosaaric01a3592012-08-12 22:27:07 -0300724 fe = dvb_attach(mt2060_attach, adap->fe[0],
Antti Palosaarifba16b12012-01-21 20:28:38 -0300725 rtl2830_tuner_i2c, &rtl28xxu_mt2060_config,
726 1220);
Antti Palosaari831e0b72011-07-08 23:36:07 -0300727 break;
728 case TUNER_RTL2830_MXL5005S:
Antti Palosaaric01a3592012-08-12 22:27:07 -0300729 fe = dvb_attach(mxl5005s_attach, adap->fe[0],
Antti Palosaari9935eea2012-01-21 22:26:52 -0300730 rtl2830_tuner_i2c, &rtl28xxu_mxl5005s_config);
Antti Palosaari831e0b72011-07-08 23:36:07 -0300731 break;
732 default:
Antti Palosaari9935eea2012-01-21 22:26:52 -0300733 fe = NULL;
Antti Palosaaric01a3592012-08-12 22:27:07 -0300734 dev_err(&d->udev->dev, "%s: unknown tuner=%d\n", KBUILD_MODNAME,
735 priv->tuner);
Antti Palosaari831e0b72011-07-08 23:36:07 -0300736 }
737
738 if (fe == NULL) {
739 ret = -ENODEV;
740 goto err;
741 }
742
743 return 0;
744err:
Antti Palosaaric01a3592012-08-12 22:27:07 -0300745 dev_dbg(&d->udev->dev, "%s: failed=%d\n", __func__, ret);
Antti Palosaari831e0b72011-07-08 23:36:07 -0300746 return ret;
747}
748
Antti Palosaarib5cbaa42011-08-04 13:26:10 -0300749static int rtl2832u_tuner_attach(struct dvb_usb_adapter *adap)
750{
751 int ret;
Antti Palosaaric01a3592012-08-12 22:27:07 -0300752 struct dvb_usb_device *d = adap_to_d(adap);
753 struct rtl28xxu_priv *priv = d_to_priv(d);
Antti Palosaari9935eea2012-01-21 22:26:52 -0300754 struct dvb_frontend *fe;
Antti Palosaarib5cbaa42011-08-04 13:26:10 -0300755
Antti Palosaaric01a3592012-08-12 22:27:07 -0300756 dev_dbg(&d->udev->dev, "%s:\n", __func__);
Antti Palosaarib5cbaa42011-08-04 13:26:10 -0300757
758 switch (priv->tuner) {
Thomas Mair5cf66312012-05-18 14:47:41 -0300759 case TUNER_RTL2832_FC0012:
Antti Palosaaric01a3592012-08-12 22:27:07 -0300760 fe = dvb_attach(fc0012_attach, adap->fe[0],
761 &d->i2c_adap, 0xc6>>1, 0, FC_XTAL_28_8_MHZ);
Thomas Mair5cf66312012-05-18 14:47:41 -0300762
763 /* since fc0012 includs reading the signal strength delegate
764 * that to the tuner driver */
Antti Palosaaric01a3592012-08-12 22:27:07 -0300765 adap->fe[0]->ops.read_signal_strength =
766 adap->fe[0]->ops.tuner_ops.get_rf_strength;
Thomas Mair5cf66312012-05-18 14:47:41 -0300767 return 0;
Antti Palosaarib5cbaa42011-08-04 13:26:10 -0300768 break;
Thomas Mair5cf66312012-05-18 14:47:41 -0300769 case TUNER_RTL2832_FC0013:
Antti Palosaaric01a3592012-08-12 22:27:07 -0300770 fe = dvb_attach(fc0013_attach, adap->fe[0],
771 &d->i2c_adap, 0xc6>>1, 0, FC_XTAL_28_8_MHZ);
Thomas Mair5cf66312012-05-18 14:47:41 -0300772
773 /* fc0013 also supports signal strength reading */
Antti Palosaaric01a3592012-08-12 22:27:07 -0300774 adap->fe[0]->ops.read_signal_strength =
775 adap->fe[0]->ops.tuner_ops.get_rf_strength;
Thomas Mair5cf66312012-05-18 14:47:41 -0300776 return 0;
Antti Palosaarib5cbaa42011-08-04 13:26:10 -0300777 default:
Antti Palosaari9935eea2012-01-21 22:26:52 -0300778 fe = NULL;
Antti Palosaaric01a3592012-08-12 22:27:07 -0300779 dev_err(&d->udev->dev, "%s: unknown tuner=%d\n", KBUILD_MODNAME,
780 priv->tuner);
Antti Palosaarib5cbaa42011-08-04 13:26:10 -0300781 }
782
783 if (fe == NULL) {
784 ret = -ENODEV;
785 goto err;
786 }
787
788 return 0;
789err:
Antti Palosaaric01a3592012-08-12 22:27:07 -0300790 dev_dbg(&d->udev->dev, "%s: failed=%d\n", __func__, ret);
Antti Palosaarib5cbaa42011-08-04 13:26:10 -0300791 return ret;
792}
793
Antti Palosaaric01a3592012-08-12 22:27:07 -0300794static int rtl28xxu_init(struct dvb_usb_device *d)
795{
796 int ret;
797 u8 val;
798
799 dev_dbg(&d->udev->dev, "%s:\n", __func__);
800
801 /* init USB endpoints */
802 ret = rtl28xx_rd_reg(d, USB_SYSCTL_0, &val);
803 if (ret)
804 goto err;
805
806 /* enable DMA and Full Packet Mode*/
807 val |= 0x09;
808 ret = rtl28xx_wr_reg(d, USB_SYSCTL_0, val);
809 if (ret)
810 goto err;
811
812 /* set EPA maximum packet size to 0x0200 */
813 ret = rtl28xx_wr_regs(d, USB_EPA_MAXPKT, "\x00\x02\x00\x00", 4);
814 if (ret)
815 goto err;
816
817 /* change EPA FIFO length */
818 ret = rtl28xx_wr_regs(d, USB_EPA_FIFO_CFG, "\x14\x00\x00\x00", 4);
819 if (ret)
820 goto err;
821
822 return ret;
823err:
824 dev_dbg(&d->udev->dev, "%s: failed=%d\n", __func__, ret);
825 return ret;
826}
827
Antti Palosaari991452a2012-08-12 22:27:08 -0300828static int rtl28xxu_streaming_ctrl(struct dvb_frontend *fe , int onoff)
Thomas Mair5cf66312012-05-18 14:47:41 -0300829{
830 int ret;
831 u8 buf[2];
Antti Palosaaric01a3592012-08-12 22:27:07 -0300832 struct dvb_usb_device *d = fe_to_d(fe);
Thomas Mair5cf66312012-05-18 14:47:41 -0300833
Antti Palosaaric01a3592012-08-12 22:27:07 -0300834 dev_dbg(&d->udev->dev, "%s: onoff=%d\n", __func__, onoff);
Thomas Mair5cf66312012-05-18 14:47:41 -0300835
836 if (onoff) {
837 buf[0] = 0x00;
838 buf[1] = 0x00;
Antti Palosaari62751a82012-08-21 19:56:18 -0300839 usb_clear_halt(d->udev, usb_rcvbulkpipe(d->udev, 0x81));
Thomas Mair5cf66312012-05-18 14:47:41 -0300840 } else {
841 buf[0] = 0x10; /* stall EPA */
842 buf[1] = 0x02; /* reset EPA */
843 }
844
Antti Palosaaric01a3592012-08-12 22:27:07 -0300845 ret = rtl28xx_wr_regs(d, USB_EPA_CTL, buf, 2);
Thomas Mair5cf66312012-05-18 14:47:41 -0300846 if (ret)
847 goto err;
848
849 return ret;
850err:
Antti Palosaaric01a3592012-08-12 22:27:07 -0300851 dev_dbg(&d->udev->dev, "%s: failed=%d\n", __func__, ret);
Thomas Mair5cf66312012-05-18 14:47:41 -0300852 return ret;
853}
854
855static int rtl2831u_power_ctrl(struct dvb_usb_device *d, int onoff)
Antti Palosaari831e0b72011-07-08 23:36:07 -0300856{
857 int ret;
858 u8 gpio, sys0;
859
Antti Palosaaric01a3592012-08-12 22:27:07 -0300860 dev_dbg(&d->udev->dev, "%s: onoff=%d\n", __func__, onoff);
Antti Palosaari831e0b72011-07-08 23:36:07 -0300861
862 /* demod adc */
Thomas Mair40a2d3c2012-05-18 14:47:42 -0300863 ret = rtl28xx_rd_reg(d, SYS_SYS0, &sys0);
Antti Palosaari831e0b72011-07-08 23:36:07 -0300864 if (ret)
865 goto err;
866
867 /* tuner power, read GPIOs */
Thomas Mair40a2d3c2012-05-18 14:47:42 -0300868 ret = rtl28xx_rd_reg(d, SYS_GPIO_OUT_VAL, &gpio);
Antti Palosaari831e0b72011-07-08 23:36:07 -0300869 if (ret)
870 goto err;
871
Antti Palosaaric01a3592012-08-12 22:27:07 -0300872 dev_dbg(&d->udev->dev, "%s: RD SYS0=%02x GPIO_OUT_VAL=%02x\n", __func__,
873 sys0, gpio);
Antti Palosaari831e0b72011-07-08 23:36:07 -0300874
875 if (onoff) {
876 gpio |= 0x01; /* GPIO0 = 1 */
877 gpio &= (~0x10); /* GPIO4 = 0 */
Antti Palosaari991452a2012-08-12 22:27:08 -0300878 gpio |= 0x04; /* GPIO2 = 1, LED on */
Antti Palosaari831e0b72011-07-08 23:36:07 -0300879 sys0 = sys0 & 0x0f;
880 sys0 |= 0xe0;
881 } else {
Antti Palosaari831e0b72011-07-08 23:36:07 -0300882 gpio &= (~0x01); /* GPIO0 = 0 */
883 gpio |= 0x10; /* GPIO4 = 1 */
Antti Palosaari991452a2012-08-12 22:27:08 -0300884 gpio &= (~0x04); /* GPIO2 = 1, LED off */
Antti Palosaari831e0b72011-07-08 23:36:07 -0300885 sys0 = sys0 & (~0xc0);
Antti Palosaari831e0b72011-07-08 23:36:07 -0300886 }
887
Antti Palosaaric01a3592012-08-12 22:27:07 -0300888 dev_dbg(&d->udev->dev, "%s: WR SYS0=%02x GPIO_OUT_VAL=%02x\n", __func__,
889 sys0, gpio);
Antti Palosaari831e0b72011-07-08 23:36:07 -0300890
891 /* demod adc */
Thomas Mair40a2d3c2012-05-18 14:47:42 -0300892 ret = rtl28xx_wr_reg(d, SYS_SYS0, sys0);
Antti Palosaari831e0b72011-07-08 23:36:07 -0300893 if (ret)
894 goto err;
895
896 /* tuner power, write GPIOs */
Thomas Mair40a2d3c2012-05-18 14:47:42 -0300897 ret = rtl28xx_wr_reg(d, SYS_GPIO_OUT_VAL, gpio);
Antti Palosaari831e0b72011-07-08 23:36:07 -0300898 if (ret)
899 goto err;
900
901 return ret;
902err:
Antti Palosaaric01a3592012-08-12 22:27:07 -0300903 dev_dbg(&d->udev->dev, "%s: failed=%d\n", __func__, ret);
Antti Palosaari831e0b72011-07-08 23:36:07 -0300904 return ret;
905}
906
Thomas Mair5cf66312012-05-18 14:47:41 -0300907static int rtl2832u_power_ctrl(struct dvb_usb_device *d, int onoff)
908{
909 int ret;
910 u8 val;
911
Antti Palosaaric01a3592012-08-12 22:27:07 -0300912 dev_dbg(&d->udev->dev, "%s: onoff=%d\n", __func__, onoff);
Thomas Mair5cf66312012-05-18 14:47:41 -0300913
914 if (onoff) {
915 /* set output values */
Thomas Mair40a2d3c2012-05-18 14:47:42 -0300916 ret = rtl28xx_rd_reg(d, SYS_GPIO_OUT_VAL, &val);
Thomas Mair5cf66312012-05-18 14:47:41 -0300917 if (ret)
918 goto err;
919
920 val |= 0x08;
921 val &= 0xef;
922
Thomas Mair40a2d3c2012-05-18 14:47:42 -0300923 ret = rtl28xx_wr_reg(d, SYS_GPIO_OUT_VAL, val);
Thomas Mair5cf66312012-05-18 14:47:41 -0300924 if (ret)
925 goto err;
926
927 /* demod_ctl_1 */
Thomas Mair40a2d3c2012-05-18 14:47:42 -0300928 ret = rtl28xx_rd_reg(d, SYS_DEMOD_CTL1, &val);
Thomas Mair5cf66312012-05-18 14:47:41 -0300929 if (ret)
930 goto err;
931
932 val &= 0xef;
933
Thomas Mair40a2d3c2012-05-18 14:47:42 -0300934 ret = rtl28xx_wr_reg(d, SYS_DEMOD_CTL1, val);
Thomas Mair5cf66312012-05-18 14:47:41 -0300935 if (ret)
936 goto err;
937
938 /* demod control */
939 /* PLL enable */
Thomas Mair40a2d3c2012-05-18 14:47:42 -0300940 ret = rtl28xx_rd_reg(d, SYS_DEMOD_CTL, &val);
Thomas Mair5cf66312012-05-18 14:47:41 -0300941 if (ret)
942 goto err;
943
944 /* bit 7 to 1 */
945 val |= 0x80;
946
Thomas Mair40a2d3c2012-05-18 14:47:42 -0300947 ret = rtl28xx_wr_reg(d, SYS_DEMOD_CTL, val);
Thomas Mair5cf66312012-05-18 14:47:41 -0300948 if (ret)
949 goto err;
950
Thomas Mair40a2d3c2012-05-18 14:47:42 -0300951 ret = rtl28xx_rd_reg(d, SYS_DEMOD_CTL, &val);
Thomas Mair5cf66312012-05-18 14:47:41 -0300952 if (ret)
953 goto err;
954
955 val |= 0x20;
956
Thomas Mair40a2d3c2012-05-18 14:47:42 -0300957 ret = rtl28xx_wr_reg(d, SYS_DEMOD_CTL, val);
Thomas Mair5cf66312012-05-18 14:47:41 -0300958 if (ret)
959 goto err;
960
961 mdelay(5);
962
963 /*enable ADC_Q and ADC_I */
Thomas Mair40a2d3c2012-05-18 14:47:42 -0300964 ret = rtl28xx_rd_reg(d, SYS_DEMOD_CTL, &val);
Thomas Mair5cf66312012-05-18 14:47:41 -0300965 if (ret)
966 goto err;
967
968 val |= 0x48;
969
Thomas Mair40a2d3c2012-05-18 14:47:42 -0300970 ret = rtl28xx_wr_reg(d, SYS_DEMOD_CTL, val);
Thomas Mair5cf66312012-05-18 14:47:41 -0300971 if (ret)
972 goto err;
973
974
975 } else {
976 /* demod_ctl_1 */
Thomas Mair40a2d3c2012-05-18 14:47:42 -0300977 ret = rtl28xx_rd_reg(d, SYS_DEMOD_CTL1, &val);
Thomas Mair5cf66312012-05-18 14:47:41 -0300978 if (ret)
979 goto err;
980
981 val |= 0x0c;
982
Thomas Mair40a2d3c2012-05-18 14:47:42 -0300983 ret = rtl28xx_wr_reg(d, SYS_DEMOD_CTL1, val);
Thomas Mair5cf66312012-05-18 14:47:41 -0300984 if (ret)
985 goto err;
986
987 /* set output values */
Thomas Mair40a2d3c2012-05-18 14:47:42 -0300988 ret = rtl28xx_rd_reg(d, SYS_GPIO_OUT_VAL, &val);
Thomas Mair5cf66312012-05-18 14:47:41 -0300989 if (ret)
990 goto err;
991
992 val |= 0x10;
993
Thomas Mair40a2d3c2012-05-18 14:47:42 -0300994 ret = rtl28xx_wr_reg(d, SYS_GPIO_OUT_VAL, val);
Thomas Mair5cf66312012-05-18 14:47:41 -0300995 if (ret)
996 goto err;
997
998 /* demod control */
Thomas Mair40a2d3c2012-05-18 14:47:42 -0300999 ret = rtl28xx_rd_reg(d, SYS_DEMOD_CTL, &val);
Thomas Mair5cf66312012-05-18 14:47:41 -03001000 if (ret)
1001 goto err;
1002
1003 val &= 0x37;
1004
Thomas Mair40a2d3c2012-05-18 14:47:42 -03001005 ret = rtl28xx_wr_reg(d, SYS_DEMOD_CTL, val);
Thomas Mair5cf66312012-05-18 14:47:41 -03001006 if (ret)
1007 goto err;
1008
1009 }
1010
1011 return ret;
1012err:
Antti Palosaaric01a3592012-08-12 22:27:07 -03001013 dev_dbg(&d->udev->dev, "%s: failed=%d\n", __func__, ret);
Thomas Mair5cf66312012-05-18 14:47:41 -03001014 return ret;
1015}
1016
1017
Antti Palosaarib5cbaa42011-08-04 13:26:10 -03001018static int rtl2831u_rc_query(struct dvb_usb_device *d)
Antti Palosaari831e0b72011-07-08 23:36:07 -03001019{
Antti Palosaarib5cbaa42011-08-04 13:26:10 -03001020 int ret, i;
1021 struct rtl28xxu_priv *priv = d->priv;
Antti Palosaari831e0b72011-07-08 23:36:07 -03001022 u8 buf[5];
1023 u32 rc_code;
Antti Palosaarib5cbaa42011-08-04 13:26:10 -03001024 struct rtl28xxu_reg_val rc_nec_tab[] = {
1025 { 0x3033, 0x80 },
1026 { 0x3020, 0x43 },
1027 { 0x3021, 0x16 },
1028 { 0x3022, 0x16 },
1029 { 0x3023, 0x5a },
1030 { 0x3024, 0x2d },
1031 { 0x3025, 0x16 },
1032 { 0x3026, 0x01 },
1033 { 0x3028, 0xb0 },
1034 { 0x3029, 0x04 },
1035 { 0x302c, 0x88 },
1036 { 0x302e, 0x13 },
1037 { 0x3030, 0xdf },
1038 { 0x3031, 0x05 },
1039 };
1040
1041 /* init remote controller */
1042 if (!priv->rc_active) {
1043 for (i = 0; i < ARRAY_SIZE(rc_nec_tab); i++) {
Thomas Mair40a2d3c2012-05-18 14:47:42 -03001044 ret = rtl28xx_wr_reg(d, rc_nec_tab[i].reg,
Antti Palosaari9935eea2012-01-21 22:26:52 -03001045 rc_nec_tab[i].val);
Antti Palosaarib5cbaa42011-08-04 13:26:10 -03001046 if (ret)
1047 goto err;
1048 }
1049 priv->rc_active = true;
1050 }
Antti Palosaari831e0b72011-07-08 23:36:07 -03001051
1052 ret = rtl2831_rd_regs(d, SYS_IRRC_RP, buf, 5);
1053 if (ret)
1054 goto err;
1055
1056 if (buf[4] & 0x01) {
1057 if (buf[2] == (u8) ~buf[3]) {
1058 if (buf[0] == (u8) ~buf[1]) {
1059 /* NEC standard (16 bit) */
1060 rc_code = buf[0] << 8 | buf[2];
1061 } else {
1062 /* NEC extended (24 bit) */
1063 rc_code = buf[0] << 16 |
Antti Palosaari9935eea2012-01-21 22:26:52 -03001064 buf[1] << 8 | buf[2];
Antti Palosaari831e0b72011-07-08 23:36:07 -03001065 }
1066 } else {
1067 /* NEC full (32 bit) */
1068 rc_code = buf[0] << 24 | buf[1] << 16 |
1069 buf[2] << 8 | buf[3];
1070 }
1071
1072 rc_keydown(d->rc_dev, rc_code, 0);
1073
Thomas Mair40a2d3c2012-05-18 14:47:42 -03001074 ret = rtl28xx_wr_reg(d, SYS_IRRC_SR, 1);
Antti Palosaari831e0b72011-07-08 23:36:07 -03001075 if (ret)
1076 goto err;
1077
1078 /* repeated intentionally to avoid extra keypress */
Thomas Mair40a2d3c2012-05-18 14:47:42 -03001079 ret = rtl28xx_wr_reg(d, SYS_IRRC_SR, 1);
Antti Palosaari831e0b72011-07-08 23:36:07 -03001080 if (ret)
1081 goto err;
1082 }
1083
1084 return ret;
1085err:
Antti Palosaaric01a3592012-08-12 22:27:07 -03001086 dev_dbg(&d->udev->dev, "%s: failed=%d\n", __func__, ret);
Antti Palosaari831e0b72011-07-08 23:36:07 -03001087 return ret;
1088}
1089
Antti Palosaaric01a3592012-08-12 22:27:07 -03001090static int rtl2831u_get_rc_config(struct dvb_usb_device *d,
1091 struct dvb_usb_rc *rc)
1092{
1093 rc->map_name = RC_MAP_EMPTY;
1094 rc->allowed_protos = RC_TYPE_NEC;
1095 rc->query = rtl2831u_rc_query;
1096 rc->interval = 400;
1097
1098 return 0;
1099}
1100
Antti Palosaarib5cbaa42011-08-04 13:26:10 -03001101static int rtl2832u_rc_query(struct dvb_usb_device *d)
1102{
1103 int ret, i;
1104 struct rtl28xxu_priv *priv = d->priv;
1105 u8 buf[128];
1106 int len;
1107 struct rtl28xxu_reg_val rc_nec_tab[] = {
Antti Palosaari9935eea2012-01-21 22:26:52 -03001108 { IR_RX_CTRL, 0x20 },
1109 { IR_RX_BUF_CTRL, 0x80 },
1110 { IR_RX_IF, 0xff },
1111 { IR_RX_IE, 0xff },
1112 { IR_MAX_DURATION0, 0xd0 },
1113 { IR_MAX_DURATION1, 0x07 },
1114 { IR_IDLE_LEN0, 0xc0 },
1115 { IR_IDLE_LEN1, 0x00 },
1116 { IR_GLITCH_LEN, 0x03 },
1117 { IR_RX_CLK, 0x09 },
1118 { IR_RX_CFG, 0x1c },
1119 { IR_MAX_H_TOL_LEN, 0x1e },
1120 { IR_MAX_L_TOL_LEN, 0x1e },
1121 { IR_RX_CTRL, 0x80 },
Antti Palosaarib5cbaa42011-08-04 13:26:10 -03001122 };
1123
1124 /* init remote controller */
1125 if (!priv->rc_active) {
1126 for (i = 0; i < ARRAY_SIZE(rc_nec_tab); i++) {
Thomas Mair40a2d3c2012-05-18 14:47:42 -03001127 ret = rtl28xx_wr_reg(d, rc_nec_tab[i].reg,
Antti Palosaari9935eea2012-01-21 22:26:52 -03001128 rc_nec_tab[i].val);
Antti Palosaarib5cbaa42011-08-04 13:26:10 -03001129 if (ret)
1130 goto err;
1131 }
1132 priv->rc_active = true;
1133 }
1134
Thomas Mair40a2d3c2012-05-18 14:47:42 -03001135 ret = rtl28xx_rd_reg(d, IR_RX_IF, &buf[0]);
Antti Palosaarib5cbaa42011-08-04 13:26:10 -03001136 if (ret)
1137 goto err;
1138
1139 if (buf[0] != 0x83)
1140 goto exit;
1141
Thomas Mair40a2d3c2012-05-18 14:47:42 -03001142 ret = rtl28xx_rd_reg(d, IR_RX_BC, &buf[0]);
Antti Palosaarib5cbaa42011-08-04 13:26:10 -03001143 if (ret)
1144 goto err;
1145
1146 len = buf[0];
1147 ret = rtl2831_rd_regs(d, IR_RX_BUF, buf, len);
1148
1149 /* TODO: pass raw IR to Kernel IR decoder */
1150
Thomas Mair40a2d3c2012-05-18 14:47:42 -03001151 ret = rtl28xx_wr_reg(d, IR_RX_IF, 0x03);
1152 ret = rtl28xx_wr_reg(d, IR_RX_BUF_CTRL, 0x80);
1153 ret = rtl28xx_wr_reg(d, IR_RX_CTRL, 0x80);
Antti Palosaarib5cbaa42011-08-04 13:26:10 -03001154
1155exit:
1156 return ret;
1157err:
Antti Palosaaric01a3592012-08-12 22:27:07 -03001158 dev_dbg(&d->udev->dev, "%s: failed=%d\n", __func__, ret);
Antti Palosaarib5cbaa42011-08-04 13:26:10 -03001159 return ret;
1160}
1161
Antti Palosaaric01a3592012-08-12 22:27:07 -03001162static int rtl2832u_get_rc_config(struct dvb_usb_device *d,
1163 struct dvb_usb_rc *rc)
1164{
1165 rc->map_name = RC_MAP_EMPTY;
1166 rc->allowed_protos = RC_TYPE_NEC;
1167 rc->query = rtl2832u_rc_query;
1168 rc->interval = 400;
Antti Palosaarib5cbaa42011-08-04 13:26:10 -03001169
Antti Palosaaric01a3592012-08-12 22:27:07 -03001170 return 0;
1171}
Antti Palosaarib5cbaa42011-08-04 13:26:10 -03001172
Antti Palosaaric01a3592012-08-12 22:27:07 -03001173static const struct dvb_usb_device_properties rtl2831u_props = {
1174 .driver_name = KBUILD_MODNAME,
1175 .owner = THIS_MODULE,
1176 .adapter_nr = adapter_nr,
1177 .size_of_priv = sizeof(struct rtl28xxu_priv),
Antti Palosaari831e0b72011-07-08 23:36:07 -03001178
Antti Palosaaric01a3592012-08-12 22:27:07 -03001179 .power_ctrl = rtl2831u_power_ctrl,
1180 .i2c_algo = &rtl28xxu_i2c_algo,
1181 .frontend_attach = rtl2831u_frontend_attach,
1182 .tuner_attach = rtl2831u_tuner_attach,
1183 .init = rtl28xxu_init,
1184 .get_rc_config = rtl2831u_get_rc_config,
Antti Palosaari991452a2012-08-12 22:27:08 -03001185 .streaming_ctrl = rtl28xxu_streaming_ctrl,
Antti Palosaari831e0b72011-07-08 23:36:07 -03001186
Antti Palosaaric01a3592012-08-12 22:27:07 -03001187 .num_adapters = 1,
1188 .adapter = {
1189 {
1190 .stream = DVB_USB_STREAM_BULK(0x81, 6, 8 * 512),
Antti Palosaari831e0b72011-07-08 23:36:07 -03001191 },
Antti Palosaari831e0b72011-07-08 23:36:07 -03001192 },
Antti Palosaaric01a3592012-08-12 22:27:07 -03001193};
Antti Palosaarib5cbaa42011-08-04 13:26:10 -03001194
Antti Palosaaric01a3592012-08-12 22:27:07 -03001195static const struct dvb_usb_device_properties rtl2832u_props = {
1196 .driver_name = KBUILD_MODNAME,
1197 .owner = THIS_MODULE,
1198 .adapter_nr = adapter_nr,
1199 .size_of_priv = sizeof(struct rtl28xxu_priv),
Antti Palosaarib5cbaa42011-08-04 13:26:10 -03001200
Antti Palosaaric01a3592012-08-12 22:27:07 -03001201 .power_ctrl = rtl2832u_power_ctrl,
1202 .i2c_algo = &rtl28xxu_i2c_algo,
1203 .frontend_attach = rtl2832u_frontend_attach,
1204 .tuner_attach = rtl2832u_tuner_attach,
1205 .init = rtl28xxu_init,
1206 .get_rc_config = rtl2832u_get_rc_config,
Antti Palosaari991452a2012-08-12 22:27:08 -03001207 .streaming_ctrl = rtl28xxu_streaming_ctrl,
Antti Palosaarib5cbaa42011-08-04 13:26:10 -03001208
Antti Palosaaric01a3592012-08-12 22:27:07 -03001209 .num_adapters = 1,
1210 .adapter = {
1211 {
1212 .stream = DVB_USB_STREAM_BULK(0x81, 6, 8 * 512),
Antti Palosaarib5cbaa42011-08-04 13:26:10 -03001213 },
Antti Palosaarib5cbaa42011-08-04 13:26:10 -03001214 },
Antti Palosaari831e0b72011-07-08 23:36:07 -03001215};
1216
Antti Palosaaric01a3592012-08-12 22:27:07 -03001217static const struct usb_device_id rtl28xxu_id_table[] = {
1218 { DVB_USB_DEVICE(USB_VID_REALTEK, USB_PID_REALTEK_RTL2831U,
1219 &rtl2831u_props, "Realtek RTL2831U reference design", NULL) },
1220 { DVB_USB_DEVICE(USB_VID_WIDEVIEW, USB_PID_FREECOM_DVBT,
1221 &rtl2831u_props, "Freecom USB2.0 DVB-T", NULL) },
1222 { DVB_USB_DEVICE(USB_VID_WIDEVIEW, USB_PID_FREECOM_DVBT_2,
1223 &rtl2831u_props, "Freecom USB2.0 DVB-T", NULL) },
Antti Palosaari831e0b72011-07-08 23:36:07 -03001224
Antti Palosaaric01a3592012-08-12 22:27:07 -03001225 { DVB_USB_DEVICE(USB_VID_TERRATEC, USB_PID_TERRATEC_CINERGY_T_STICK_BLACK_REV1,
1226 &rtl2832u_props, "Terratec Cinergy T Stick Black", NULL) },
1227 { DVB_USB_DEVICE(USB_VID_GTEK, USB_PID_DELOCK_USB2_DVBT,
1228 &rtl2832u_props, "G-Tek Electronics Group Lifeview LV5TDLX DVB-T", NULL) },
1229 { DVB_USB_DEVICE(USB_VID_TERRATEC, USB_PID_NOXON_DAB_STICK,
1230 &rtl2832u_props, "NOXON DAB/DAB+ USB dongle", NULL) },
1231 { }
1232};
1233MODULE_DEVICE_TABLE(usb, rtl28xxu_id_table);
Antti Palosaari831e0b72011-07-08 23:36:07 -03001234
Antti Palosaaric01a3592012-08-12 22:27:07 -03001235static struct usb_driver rtl28xxu_usb_driver = {
1236 .name = KBUILD_MODNAME,
1237 .id_table = rtl28xxu_id_table,
1238 .probe = dvb_usbv2_probe,
1239 .disconnect = dvb_usbv2_disconnect,
1240 .suspend = dvb_usbv2_suspend,
1241 .resume = dvb_usbv2_resume,
Antti Palosaari78fa5902012-08-14 22:21:09 -03001242 .reset_resume = dvb_usbv2_reset_resume,
Antti Palosaaric01a3592012-08-12 22:27:07 -03001243 .no_dynamic_id = 1,
1244 .soft_unbind = 1,
Antti Palosaari831e0b72011-07-08 23:36:07 -03001245};
1246
Antti Palosaaric01a3592012-08-12 22:27:07 -03001247module_usb_driver(rtl28xxu_usb_driver);
Antti Palosaari831e0b72011-07-08 23:36:07 -03001248
1249MODULE_DESCRIPTION("Realtek RTL28xxU DVB USB driver");
1250MODULE_AUTHOR("Antti Palosaari <crope@iki.fi>");
Thomas Mair5cf66312012-05-18 14:47:41 -03001251MODULE_AUTHOR("Thomas Mair <thomas.mair86@googlemail.com>");
Antti Palosaari831e0b72011-07-08 23:36:07 -03001252MODULE_LICENSE("GPL");