[media] Realtek RTL28xxU serie DVB USB interface driver
authorAntti Palosaari <crope@iki.fi>
Sat, 9 Jul 2011 02:36:07 +0000 (23:36 -0300)
committerMauro Carvalho Chehab <mchehab@redhat.com>
Tue, 28 Feb 2012 21:40:11 +0000 (18:40 -0300)
For now it supports only Realtek RTL2831U chip.
RTL2831U is integrated DVB USB interface and DVB-T demod.
DVB-T demod integrated to RTL2831U is Realtek RTL2830.
Supported tuners are QT1010, MT2060 and MXL5005S.

Signed-off-by: Antti Palosaari <crope@iki.fi>
[mchehab@redhat.com: fix a small typo]
Signed-off-by: Mauro Carvalho Chehab <mchehab@redhat.com>
drivers/media/dvb/dvb-usb/Kconfig
drivers/media/dvb/dvb-usb/Makefile
drivers/media/dvb/dvb-usb/rtl28xxu.c [new file with mode: 0644]
drivers/media/dvb/dvb-usb/rtl28xxu.h [new file with mode: 0644]

index e894bad..6154292 100644 (file)
@@ -411,3 +411,13 @@ config DVB_USB_MXL111SF
        select VIDEO_TVEEPROM
        help
          Say Y here to support the MxL111SF USB2.0 DTV receiver.
+
+config DVB_USB_RTL28XXU
+       tristate "Realtek RTL28xxU DVB USB support"
+       depends on DVB_USB && EXPERIMENTAL
+       select DVB_RTL2830
+       select MEDIA_TUNER_QT1010 if !MEDIA_TUNER_CUSTOMISE
+       select MEDIA_TUNER_MT2060 if !MEDIA_TUNER_CUSTOMISE
+       select MEDIA_TUNER_MXL5005S if !MEDIA_TUNER_CUSTOMISE
+       help
+         Say Y here to support the Realtek RTL28xxU DVB USB receiver.
index d9549cb..7e476cb 100644 (file)
@@ -107,6 +107,9 @@ obj-$(CONFIG_DVB_USB_MXL111SF) += dvb-usb-mxl111sf.o
 obj-$(CONFIG_DVB_USB_MXL111SF) += mxl111sf-demod.o
 obj-$(CONFIG_DVB_USB_MXL111SF) += mxl111sf-tuner.o
 
+dvb-usb-rtl28xxu-objs = rtl28xxu.o
+obj-$(CONFIG_DVB_USB_RTL28XXU) += dvb-usb-rtl28xxu.o
+
 ccflags-y += -Idrivers/media/dvb/dvb-core/ -Idrivers/media/dvb/frontends/
 # due to tuner-xc3028
 ccflags-y += -Idrivers/media/common/tuners
diff --git a/drivers/media/dvb/dvb-usb/rtl28xxu.c b/drivers/media/dvb/dvb-usb/rtl28xxu.c
new file mode 100644 (file)
index 0000000..e7b1811
--- /dev/null
@@ -0,0 +1,709 @@
+/*
+ * Realtek RTL28xxU DVB USB driver
+ *
+ * Copyright (C) 2009 Antti Palosaari <crope@iki.fi>
+ * Copyright (C) 2011 Antti Palosaari <crope@iki.fi>
+ *
+ *    This program is free software; you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation; either version 2 of the License, or
+ *    (at your option) any later version.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License along
+ *    with this program; if not, write to the Free Software Foundation, Inc.,
+ *    51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
+ */
+
+#include "rtl28xxu.h"
+
+#include "rtl2830.h"
+
+#include "qt1010.h"
+#include "mt2060.h"
+#include "mxl5005s.h"
+
+/* debug */
+static int dvb_usb_rtl28xxu_debug;
+module_param_named(debug, dvb_usb_rtl28xxu_debug, int, 0644);
+MODULE_PARM_DESC(debug, "set debugging level" DVB_USB_DEBUG_STATUS);
+DVB_DEFINE_MOD_OPT_ADAPTER_NR(adapter_nr);
+
+static int rtl28xxu_ctrl_msg(struct dvb_usb_device *d, struct rtl28xxu_req *req)
+{
+       int ret;
+       unsigned int pipe;
+       u8 requesttype;
+       u8 *buf;
+
+       buf = kmalloc(req->size, GFP_KERNEL);
+       if (!buf) {
+               ret = -ENOMEM;
+               goto err;
+       }
+
+       if (req->index & CMD_WR_FLAG) {
+               /* write */
+               memcpy(buf, req->data, req->size);
+               requesttype = (USB_TYPE_VENDOR | USB_DIR_OUT);
+               pipe = usb_sndctrlpipe(d->udev, 0);
+       } else {
+               /* read */
+               requesttype = (USB_TYPE_VENDOR | USB_DIR_IN);
+               pipe = usb_rcvctrlpipe(d->udev, 0);
+       }
+
+       ret = usb_control_msg(d->udev, pipe, 0, requesttype, req->value,
+               req->index, buf, req->size, 1000);
+
+       deb_dump(0, requesttype, req->value, req->index, buf, req->size,
+               deb_xfer);
+
+       if (ret < 0)
+               goto err_dealloc;
+       else
+               ret = 0;
+
+       /* read request, copy returned data to return buf */
+       if (!ret && requesttype == (USB_TYPE_VENDOR | USB_DIR_IN))
+               memcpy(req->data, buf, req->size);
+
+       kfree(buf);
+       return ret;
+
+err_dealloc:
+       kfree(buf);
+err:
+       deb_info("%s: failed=%d\n", __func__, ret);
+       return ret;
+}
+
+static int rtl2831_wr_regs(struct dvb_usb_device *d, u16 reg, u8 *val, int len)
+{
+       struct rtl28xxu_req req;
+
+       if (reg < 0x3000)
+               req.index = CMD_USB_WR;
+       else
+               req.index = CMD_SYS_WR;
+
+       req.value = reg;
+       req.size = len;
+       req.data = val;
+
+       return rtl28xxu_ctrl_msg(d, &req);
+}
+
+static int rtl2831_rd_regs(struct dvb_usb_device *d, u16 reg, u8 *val, int len)
+{
+       struct rtl28xxu_req req;
+
+       if (reg < 0x3000)
+               req.index = CMD_USB_RD;
+       else
+               req.index = CMD_SYS_RD;
+
+       req.value = reg;
+       req.size = len;
+       req.data = val;
+
+       return rtl28xxu_ctrl_msg(d, &req);
+}
+
+static int rtl2831_wr_reg(struct dvb_usb_device *d, u16 reg, u8 val)
+{
+       return rtl2831_wr_regs(d, reg, &val, 1);
+}
+
+static int rtl2831_rd_reg(struct dvb_usb_device *d, u16 reg, u8 *val)
+{
+       return rtl2831_rd_regs(d, reg, val, 1);
+}
+
+/* I2C */
+static int rtl28xxu_i2c_xfer(struct i2c_adapter *adap, struct i2c_msg msg[],
+       int num)
+{
+       int ret;
+       struct dvb_usb_device *d = i2c_get_adapdata(adap);
+       struct rtl28xxu_req req;
+
+       /*
+        * It is not known which are real I2C bus xfer limits, but testing
+        * with RTL2831U + MT2060 gives max RD 24 and max WR 22 bytes.
+        */
+
+       if (mutex_lock_interruptible(&d->i2c_mutex) < 0)
+               return -EAGAIN;
+
+       if (num == 2 && !(msg[0].flags & I2C_M_RD) &&
+               (msg[1].flags & I2C_M_RD)) {
+               if (msg[0].len > 2 || msg[1].len > 24) {
+                       ret = -EOPNOTSUPP;
+                       goto err_unlock;
+               }
+               if (msg[0].addr == 0x10) {
+                       /* integrated demod */
+                       req.value = (msg[0].buf[1] << 8) | (msg[0].addr << 1);
+                       req.index = CMD_DEMOD_RD | msg[0].buf[0];
+                       req.size = msg[1].len;
+                       req.data = &msg[1].buf[0];
+                       ret = rtl28xxu_ctrl_msg(d, &req);
+               } else {
+                       /* real I2C */
+                       req.value = (msg[0].buf[0] << 8) | (msg[0].addr << 1);
+                       req.index = CMD_I2C_RD;
+                       req.size = msg[1].len;
+                       req.data = &msg[1].buf[0];
+                       ret = rtl28xxu_ctrl_msg(d, &req);
+               }
+       } else if (num == 1 && !(msg[0].flags & I2C_M_RD)) {
+               if (msg[0].len > 22) {
+                       ret = -EOPNOTSUPP;
+                       goto err_unlock;
+               }
+               if (msg[0].addr == 0x10) {
+                       /* integrated demod */
+                       req.value = (msg[0].buf[1] << 8) | (msg[0].addr << 1);
+                       req.index = CMD_DEMOD_WR | msg[0].buf[0];
+                       req.size = msg[0].len-2;
+                       req.data = &msg[0].buf[2];
+                       ret = rtl28xxu_ctrl_msg(d, &req);
+               } else {
+                       /* real I2C */
+                       req.value = (msg[0].buf[0] << 8) | (msg[0].addr << 1);
+                       req.index = CMD_I2C_WR;
+                       req.size = msg[0].len-1;
+                       req.data = &msg[0].buf[1];
+                       ret = rtl28xxu_ctrl_msg(d, &req);
+               }
+       } else {
+               ret = -EINVAL;
+       }
+
+err_unlock:
+       mutex_unlock(&d->i2c_mutex);
+
+       return ret ? ret : num;
+}
+
+static u32 rtl28xxu_i2c_func(struct i2c_adapter *adapter)
+{
+       return I2C_FUNC_I2C;
+}
+
+static struct i2c_algorithm rtl28xxu_i2c_algo = {
+       .master_xfer   = rtl28xxu_i2c_xfer,
+       .functionality = rtl28xxu_i2c_func,
+};
+
+static struct rtl2830_config rtl28xxu_rtl2830_mt2060_config = {
+       .i2c_addr = 0x10, /* 0x20 */
+       .xtal = 28800000,
+       .ts_mode = 0,
+       .spec_inv = 1,
+       .if_dvbt = 36150000,
+       .vtop = 0x20,
+       .krf = 0x04,
+       .agc_targ_val = 0x2d,
+
+};
+
+static struct rtl2830_config rtl28xxu_rtl2830_qt1010_config = {
+       .i2c_addr = 0x10, /* 0x20 */
+       .xtal = 28800000,
+       .ts_mode = 0,
+       .spec_inv = 1,
+       .if_dvbt = 36125000,
+       .vtop = 0x20,
+       .krf = 0x04,
+       .agc_targ_val = 0x2d,
+};
+
+static struct rtl2830_config rtl28xxu_rtl2830_mxl5005s_config = {
+       .i2c_addr = 0x10, /* 0x20 */
+       .xtal = 28800000,
+       .ts_mode = 0,
+       .spec_inv = 0,
+       .if_dvbt = 4570000,
+       .vtop = 0x3f,
+       .krf = 0x04,
+       .agc_targ_val = 0x3e,
+};
+
+static int rtl28xxu_frontend_attach(struct dvb_usb_adapter *adap)
+{
+       int ret;
+       struct rtl28xxu_priv *priv = adap->dev->priv;
+       u8 buf[1];
+       struct rtl2830_config *rtl2830_config;
+       /* for MT2060 tuner probe */
+       struct rtl28xxu_req req_mt2060 = {0x00c0, CMD_I2C_RD, 1, buf};
+       /* for QT1010 tuner probe */
+       struct rtl28xxu_req req_qt1010 = {0x0fc4, CMD_I2C_RD, 1, buf};
+       /* open RTL2831U/RTL2830 I2C gate */
+       struct rtl28xxu_req req_gate = {0x0120, 0x0011, 0x0001, "\x08"};
+
+       deb_info("%s:\n", __func__);
+
+       /*
+        * RTL2831U GPIOs
+        * =========================================================
+        * GPIO0 | tuner#0 | 0 off | 1 on  | MXL5005S (?)
+        * GPIO2 | LED     | 0 off | 1 on  |
+        * GPIO4 | tuner#1 | 0 on  | 1 off | MT2060
+        */
+
+       /* GPIO direction */
+       ret = rtl2831_wr_reg(adap->dev, SYS_GPIO_DIR, 0x0a);
+       if (ret)
+               goto err;
+
+       /* enable as output GPIO0, GPIO2, GPIO4 */
+       ret = rtl2831_wr_reg(adap->dev, SYS_GPIO_OUT_EN, 0x15);
+       if (ret)
+               goto err;
+
+       /*
+        * Probe used tuner. We need to know used tuner before demod attach
+        * since there is some demod params needed to set according to tuner.
+        */
+
+       /* open demod I2C gate */
+       ret = rtl28xxu_ctrl_msg(adap->dev, &req_gate);
+       if (ret)
+               goto err;
+
+       /* check QT1010 ID(?) register; reg=0f val=2c */
+       ret = rtl28xxu_ctrl_msg(adap->dev, &req_qt1010);
+       if (ret == 0 && buf[0] == 0x2c) {
+               priv->tuner = TUNER_RTL2830_QT1010;
+               rtl2830_config = &rtl28xxu_rtl2830_qt1010_config;
+               deb_info("%s: QT1010\n", __func__);
+               goto found;
+       } else {
+               deb_info("%s: QT1010 probe failed=%d - %02x\n",
+                       __func__, ret, buf[0]);
+       }
+
+       /* open demod I2C gate */
+       ret = rtl28xxu_ctrl_msg(adap->dev, &req_gate);
+       if (ret)
+               goto err;
+
+       /* check MT2060 ID register; reg=00 val=63 */
+       ret = rtl28xxu_ctrl_msg(adap->dev, &req_mt2060);
+       if (ret == 0 && buf[0] == 0x63) {
+               priv->tuner = TUNER_RTL2830_MT2060;
+               rtl2830_config = &rtl28xxu_rtl2830_mt2060_config;
+               deb_info("%s: MT2060\n", __func__);
+               goto found;
+       } else {
+               deb_info("%s: MT2060 probe failed=%d - %02x\n",
+                       __func__, ret, buf[0]);
+       }
+
+       /* assume MXL5005S */
+       priv->tuner = TUNER_RTL2830_MXL5005S;
+       rtl2830_config = &rtl28xxu_rtl2830_mxl5005s_config;
+       deb_info("%s: MXL5005S\n", __func__);
+       goto found;
+
+found:
+       /* attach demodulator */
+       adap->fe[0] = dvb_attach(rtl2830_attach, rtl2830_config,
+               &adap->dev->i2c_adap);
+       if (adap->fe[0] == NULL) {
+               ret = -ENODEV;
+               goto err;
+       }
+
+       return ret;
+err:
+       deb_info("%s: failed=%d\n", __func__, ret);
+       return ret;
+}
+
+static struct qt1010_config rtl28xxu_qt1010_config = {
+       .i2c_address = 0x62, /* 0xc4 */
+};
+
+static struct mt2060_config rtl28xxu_mt2060_config = {
+       .i2c_address = 0x60, /* 0xc0 */
+       .clock_out = 0,
+};
+
+static struct mxl5005s_config rtl28xxu_mxl5005s_config = {
+       .i2c_address     = 0x63, /* 0xc6 */
+       .if_freq         = IF_FREQ_4570000HZ,
+       .xtal_freq       = CRYSTAL_FREQ_16000000HZ,
+       .agc_mode        = MXL_SINGLE_AGC,
+       .tracking_filter = MXL_TF_C_H,
+       .rssi_enable     = MXL_RSSI_ENABLE,
+       .cap_select      = MXL_CAP_SEL_ENABLE,
+       .div_out         = MXL_DIV_OUT_4,
+       .clock_out       = MXL_CLOCK_OUT_DISABLE,
+       .output_load     = MXL5005S_IF_OUTPUT_LOAD_200_OHM,
+       .top             = MXL5005S_TOP_25P2,
+       .mod_mode        = MXL_DIGITAL_MODE,
+       .if_mode         = MXL_ZERO_IF,
+       .AgcMasterByte   = 0x00,
+};
+
+static int rtl28xxu_tuner_attach(struct dvb_usb_adapter *adap)
+{
+       int ret;
+       struct rtl28xxu_priv *priv = adap->dev->priv;
+       struct i2c_adapter *rtl2830_tuner_i2c;
+       struct dvb_frontend *fe = NULL;
+
+       deb_info("%s:\n", __func__);
+
+       /* use rtl2830 driver I2C adapter, for more info see rtl2830 driver */
+       rtl2830_tuner_i2c = rtl2830_get_tuner_i2c_adapter(adap->fe[0]);
+
+       switch (priv->tuner) {
+       case TUNER_RTL2830_QT1010:
+               fe = dvb_attach(qt1010_attach, adap->fe[0], rtl2830_tuner_i2c,
+                       &rtl28xxu_qt1010_config);
+               break;
+       case TUNER_RTL2830_MT2060:
+               fe = dvb_attach(mt2060_attach, adap->fe[0], rtl2830_tuner_i2c,
+                       &rtl28xxu_mt2060_config, 1220);
+               break;
+       case TUNER_RTL2830_MXL5005S:
+               fe = dvb_attach(mxl5005s_attach, adap->fe[0], rtl2830_tuner_i2c,
+                       &rtl28xxu_mxl5005s_config);
+               break;
+       default:
+               err("unknown tuner=%d", priv->tuner);
+       }
+
+       if (fe == NULL) {
+               ret = -ENODEV;
+               goto err;
+       }
+
+       return 0;
+err:
+       deb_info("%s: failed=%d\n", __func__, ret);
+       return ret;
+}
+
+static int rtl28xxu_streaming_ctrl(struct dvb_usb_adapter *adap , int onoff)
+{
+       int ret;
+       u8 buf[2], gpio;
+
+       deb_info("%s: onoff=%d\n", __func__, onoff);
+
+       ret = rtl2831_rd_reg(adap->dev, SYS_GPIO_OUT_VAL, &gpio);
+       if (ret)
+               goto err;
+
+       if (onoff) {
+               buf[0] = 0x00;
+               buf[1] = 0x00;
+               gpio |= 0x04; /* LED on */
+       } else {
+               buf[0] = 0x10; /* stall EPA */
+               buf[1] = 0x02; /* reset EPA */
+               gpio &= (~0x04); /* LED off */
+       }
+
+       ret = rtl2831_wr_reg(adap->dev, SYS_GPIO_OUT_VAL, gpio);
+       if (ret)
+               goto err;
+
+       ret = rtl2831_wr_regs(adap->dev, USB_EPA_CTL, buf, 2);
+       if (ret)
+               goto err;
+
+       return ret;
+err:
+       deb_info("%s: failed=%d\n", __func__, ret);
+       return ret;
+}
+
+static int rtl28xxu_power_ctrl(struct dvb_usb_device *d, int onoff)
+{
+       int ret;
+       u8 gpio, sys0;
+
+       deb_info("%s: onoff=%d\n", __func__, onoff);
+
+       /* demod adc */
+       ret = rtl2831_rd_reg(d, SYS_SYS0, &sys0);
+       if (ret)
+               goto err;
+
+       /* tuner power, read GPIOs */
+       ret = rtl2831_rd_reg(d, SYS_GPIO_OUT_VAL, &gpio);
+       if (ret)
+               goto err;
+
+       deb_info("%s: RD SYS0=%02x GPIO_OUT_VAL=%02x\n", __func__, sys0, gpio);
+
+       if (onoff) {
+               gpio |= 0x01; /* GPIO0 = 1 */
+               gpio &= (~0x10); /* GPIO4 = 0 */
+               sys0 = sys0 & 0x0f;
+               sys0 |= 0xe0;
+       } else {
+
+#if 0 /* keep */
+               /*
+                * FIXME: Use .fe_ioctl_override() to prevent demod
+                * IOCTLs in case of device is powered off.
+                *
+                * For now we cannot power off device because most FE IOCTLs
+                * can be performed only when device is powered.
+                * Using IOCTLs when device is powered off will result errors
+                * because register access to demod fails.
+                */
+               gpio &= (~0x01); /* GPIO0 = 0 */
+               gpio |= 0x10; /* GPIO4 = 1 */
+               sys0 = sys0 & (~0xc0);
+#endif
+       }
+
+       deb_info("%s: WR SYS0=%02x GPIO_OUT_VAL=%02x\n", __func__, sys0, gpio);
+
+       /* demod adc */
+       ret = rtl2831_wr_reg(d, SYS_SYS0, sys0);
+       if (ret)
+               goto err;
+
+       /* tuner power, write GPIOs */
+       ret = rtl2831_wr_reg(d, SYS_GPIO_OUT_VAL, gpio);
+       if (ret)
+               goto err;
+
+       return ret;
+err:
+       deb_info("%s: failed=%d\n", __func__, ret);
+       return ret;
+}
+
+static int rtl28xxu_rc_query(struct dvb_usb_device *d)
+{
+       int ret;
+       u8 buf[5];
+       u32 rc_code;
+
+       ret = rtl2831_rd_regs(d, SYS_IRRC_RP, buf, 5);
+       if (ret)
+               goto err;
+
+       if (buf[4] & 0x01) {
+               if (buf[2] == (u8) ~buf[3]) {
+                       if (buf[0] == (u8) ~buf[1]) {
+                               /* NEC standard (16 bit) */
+                               rc_code = buf[0] << 8 | buf[2];
+                       } else {
+                               /* NEC extended (24 bit) */
+                               rc_code = buf[0] << 16 |
+                                       buf[1] << 8 | buf[2];
+                       }
+               } else {
+                       /* NEC full (32 bit) */
+                       rc_code = buf[0] << 24 | buf[1] << 16 |
+                                       buf[2] << 8 | buf[3];
+               }
+
+               rc_keydown(d->rc_dev, rc_code, 0);
+
+               ret = rtl2831_wr_reg(d, SYS_IRRC_SR, 1);
+               if (ret)
+                       goto err;
+
+               /* repeated intentionally to avoid extra keypress */
+               ret = rtl2831_wr_reg(d, SYS_IRRC_SR, 1);
+               if (ret)
+                       goto err;
+       }
+
+       return ret;
+err:
+       deb_info("%s: failed=%d\n", __func__, ret);
+       return ret;
+}
+
+/* DVB USB Driver stuff */
+#define        USB_VID_REALTEK                                 0x0bda
+#define        USB_PID_RTL2831U                                0x2831
+#define        USB_PID_FREECOM                                 0x0160
+
+#define RTL2831U_0BDA_2831                          0
+#define RTL2831U_14AA_0160                          1
+
+static struct usb_device_id rtl28xxu_table[] = {
+       [RTL2831U_0BDA_2831] = {
+               USB_DEVICE(USB_VID_REALTEK, USB_PID_RTL2831U)},
+       [RTL2831U_14AA_0160] = {
+               USB_DEVICE(USB_VID_WIDEVIEW, USB_PID_FREECOM)},
+       {} /* terminating entry */
+};
+
+MODULE_DEVICE_TABLE(usb, rtl28xxu_table);
+
+static struct dvb_usb_device_properties rtl28xxu_properties[] = {
+       {
+               .caps = DVB_USB_IS_AN_I2C_ADAPTER,
+
+               .usb_ctrl = DEVICE_SPECIFIC,
+               .no_reconnect = 1,
+
+               .size_of_priv = sizeof(struct rtl28xxu_priv),
+
+               .num_adapters = 1,
+               .adapter = {
+                       {
+                               .frontend_attach = rtl28xxu_frontend_attach,
+                               .tuner_attach    = rtl28xxu_tuner_attach,
+                               .streaming_ctrl  = rtl28xxu_streaming_ctrl,
+                               .stream = {
+                                       .type = USB_BULK,
+                                       .count = 6,
+                                       .endpoint = 0x81,
+                                       .u = {
+                                               .bulk = {
+                                                       .buffersize = 4096,
+                                               }
+                                       }
+                               },
+                       }
+               },
+
+               .power_ctrl = rtl28xxu_power_ctrl,
+
+               .rc.core = {
+                       .protocol       = RC_TYPE_NEC,
+                       .module_name    = "rtl28xxu",
+                       .rc_query       = rtl28xxu_rc_query,
+                       .rc_interval    = 400,
+                       .allowed_protos = RC_TYPE_NEC,
+                       .rc_codes       = RC_MAP_EMPTY,
+               },
+
+               .i2c_algo = &rtl28xxu_i2c_algo,
+
+               .num_device_descs = 2,
+               .devices = {
+                       {
+                               .name = "Realtek RTL2831U reference design",
+                               .cold_ids = {NULL},
+                               .warm_ids = {
+                               &rtl28xxu_table[RTL2831U_0BDA_2831], NULL},
+                       },
+                       {
+                               .name = "Freecom USB2.0 DVB-T",
+                               .cold_ids = {NULL},
+                               .warm_ids = {
+                               &rtl28xxu_table[RTL2831U_14AA_0160], NULL},
+                       },
+               }
+       },
+};
+
+static int rtl28xxu_probe(struct usb_interface *intf,
+                       const struct usb_device_id *id)
+{
+       int ret, i;
+       int properties_count = ARRAY_SIZE(rtl28xxu_properties);
+       struct dvb_usb_device *d = NULL;
+       struct rtl28xxu_reg_val rc_nec_tab[] = {
+               { 0x3033, 0x80 },
+               { 0x3020, 0x43 },
+               { 0x3021, 0x16 },
+               { 0x3022, 0x16 },
+               { 0x3023, 0x5a },
+               { 0x3024, 0x2d },
+               { 0x3025, 0x16 },
+               { 0x3026, 0x01 },
+               { 0x3028, 0xb0 },
+               { 0x3029, 0x04 },
+               { 0x302c, 0x88 },
+               { 0x302e, 0x13 },
+               { 0x3030, 0xdf },
+               { 0x3031, 0x05 },
+       };
+
+       deb_info("%s: interface=%d\n", __func__,
+               intf->cur_altsetting->desc.bInterfaceNumber);
+
+       if (intf->cur_altsetting->desc.bInterfaceNumber != 0)
+               return 0;
+
+       for (i = 0; i < properties_count; i++) {
+               ret = dvb_usb_device_init(intf, &rtl28xxu_properties[i],
+                       THIS_MODULE, &d, adapter_nr);
+               if (ret == 0 || ret != -ENODEV)
+                       break;
+       }
+
+       if (ret)
+               goto err;
+
+       /* init USB endpoints */
+       ret = rtl2831_wr_reg(d, USB_SYSCTL_0, 0x09);
+       if (ret)
+               goto err;
+
+       ret = rtl2831_wr_regs(d, USB_EPA_MAXPKT, "\x00\x02\x00\x00", 4);
+       if (ret)
+               goto err;
+
+       ret = rtl2831_wr_regs(d, USB_EPA_FIFO_CFG, "\x14\x00\x00\x00", 4);
+       if (ret)
+               goto err;
+
+       /* init remote controller */
+       for (i = 0; i < ARRAY_SIZE(rc_nec_tab); i++) {
+               ret = rtl2831_wr_reg(d, rc_nec_tab[i].reg, rc_nec_tab[i].val);
+               if (ret)
+                       goto err;
+       }
+
+       return ret;
+err:
+       deb_info("%s: failed=%d\n", __func__, ret);
+       return ret;
+}
+
+static struct usb_driver rtl28xxu_driver = {
+       .name       = "dvb_usb_rtl28xxu",
+       .probe      = rtl28xxu_probe,
+       .disconnect = dvb_usb_device_exit,
+       .id_table   = rtl28xxu_table,
+};
+
+/* module stuff */
+static int __init rtl28xxu_module_init(void)
+{
+       int ret;
+       deb_info("%s:\n", __func__);
+       ret = usb_register(&rtl28xxu_driver);
+       if (ret)
+               err("usb_register failed=%d", ret);
+
+       return ret;
+}
+
+static void __exit rtl28xxu_module_exit(void)
+{
+       deb_info("%s:\n", __func__);
+       /* deregister this driver from the USB subsystem */
+       usb_deregister(&rtl28xxu_driver);
+}
+
+module_init(rtl28xxu_module_init);
+module_exit(rtl28xxu_module_exit);
+
+MODULE_DESCRIPTION("Realtek RTL28xxU DVB USB driver");
+MODULE_AUTHOR("Antti Palosaari <crope@iki.fi>");
+MODULE_LICENSE("GPL");
diff --git a/drivers/media/dvb/dvb-usb/rtl28xxu.h b/drivers/media/dvb/dvb-usb/rtl28xxu.h
new file mode 100644 (file)
index 0000000..902cb8b
--- /dev/null
@@ -0,0 +1,210 @@
+/*
+ * Realtek RTL28xxU DVB USB driver
+ *
+ * Copyright (C) 2009 Antti Palosaari <crope@iki.fi>
+ * Copyright (C) 2011 Antti Palosaari <crope@iki.fi>
+ *
+ *    This program is free software; you can redistribute it and/or modify
+ *    it under the terms of the GNU General Public License as published by
+ *    the Free Software Foundation; either version 2 of the License, or
+ *    (at your option) any later version.
+ *
+ *    This program is distributed in the hope that it will be useful,
+ *    but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *    GNU General Public License for more details.
+ *
+ *    You should have received a copy of the GNU General Public License along
+ *    with this program; if not, write to the Free Software Foundation, Inc.,
+ *    51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
+ */
+
+#ifndef RTL28XXU_H
+#define RTL28XXU_H
+
+#define DVB_USB_LOG_PREFIX "rtl28xxu"
+#include "dvb-usb.h"
+
+#define deb_info(args...) dprintk(dvb_usb_rtl28xxu_debug, 0x01, args)
+#define deb_rc(args...)   dprintk(dvb_usb_rtl28xxu_debug, 0x02, args)
+#define deb_xfer(args...) dprintk(dvb_usb_rtl28xxu_debug, 0x04, args)
+#define deb_reg(args...)  dprintk(dvb_usb_rtl28xxu_debug, 0x08, args)
+#define deb_i2c(args...)  dprintk(dvb_usb_rtl28xxu_debug, 0x10, args)
+#define deb_fw(args...)   dprintk(dvb_usb_rtl28xxu_debug, 0x20, args)
+
+#define deb_dump(r, t, v, i, b, l, func) { \
+       int loop_; \
+       func("%02x %02x %02x %02x %02x %02x %02x %02x", \
+               t, r, v & 0xff, v >> 8, i & 0xff, i >> 8, l & 0xff, l >> 8); \
+       if (t == (USB_TYPE_VENDOR | USB_DIR_OUT)) \
+               func(" >>> "); \
+       else \
+               func(" <<< "); \
+       for (loop_ = 0; loop_ < l; loop_++) \
+               func("%02x ", b[loop_]); \
+       func("\n");\
+}
+
+/*
+ * USB commands
+ * (usb_control_msg() index parameter)
+ */
+#define DEMOD (0x00 << 8)
+#define USB   (0x01 << 8)
+#define SYS   (0x02 << 8)
+#define I2C   (0x03 << 8)
+#define CMD_WR_FLAG   0x10
+#define CMD_DEMOD_RD  (DEMOD)
+#define CMD_DEMOD_WR  (DEMOD | CMD_WR_FLAG)
+#define CMD_USB_RD    (USB)
+#define CMD_USB_WR    (USB | CMD_WR_FLAG)
+#define CMD_SYS_RD    (SYS)
+#define CMD_SYS_WR    (SYS | CMD_WR_FLAG)
+#define CMD_I2C_RD    (I2C)
+#define CMD_I2C_WR    (I2C | CMD_WR_FLAG)
+
+struct rtl28xxu_priv {
+       u8 chip_id;
+       u8 tuner;
+};
+
+enum rtl28xxu_chip_id {
+       CHIP_ID_NONE = 0,
+       CHIP_ID_RTL2831U,
+       CHIP_ID_RTL2832U,
+};
+
+enum rtl28xxu_tuner {
+       TUNER_NONE = 0,
+       TUNER_RTL2830_QT1010,
+       TUNER_RTL2830_MT2060,
+       TUNER_RTL2830_MXL5005S,
+};
+
+struct rtl28xxu_req {
+       u16 value;
+       u16 index;
+       u16 size;
+       u8 *data;
+};
+
+struct rtl28xxu_reg_val {
+       u16 reg;
+       u8 val;
+};
+
+/*
+ * memory map
+ *
+ * 0x0000 DEMOD : demodulator
+ * 0x2000 USB   : SIE, USB endpoint, debug, DMA
+ * 0x3000 SYS   : system
+ * 0xfc00 RC    : remote controller (not RTL2831U)
+ */
+
+/*
+ * USB registers
+ */
+/* SIE Control Registers */
+#define USB_SYSCTL         0x2000 /* USB system control */
+#define USB_SYSCTL_0       0x2000 /* USB system control */
+#define USB_SYSCTL_1       0x2001 /* USB system control */
+#define USB_SYSCTL_2       0x2002 /* USB system control */
+#define USB_SYSCTL_3       0x2003 /* USB system control */
+#define USB_IRQSTAT        0x2008 /* SIE interrupt status */
+#define USB_IRQEN          0x200C /* SIE interrupt enable */
+#define USB_CTRL           0x2010 /* USB control */
+#define USB_STAT           0x2014 /* USB status */
+#define USB_DEVADDR        0x2018 /* USB device address */
+#define USB_TEST           0x201C /* USB test mode */
+#define USB_FRAME_NUMBER   0x2020 /* frame number */
+#define USB_FIFO_ADDR      0x2028 /* address of SIE FIFO RAM */
+#define USB_FIFO_CMD       0x202A /* SIE FIFO RAM access command */
+#define USB_FIFO_DATA      0x2030 /* SIE FIFO RAM data */
+/* Endpoint Registers */
+#define EP0_SETUPA         0x20F8 /* EP 0 setup packet lower byte */
+#define EP0_SETUPB         0x20FC /* EP 0 setup packet higher byte */
+#define USB_EP0_CFG        0x2104 /* EP 0 configure */
+#define USB_EP0_CTL        0x2108 /* EP 0 control */
+#define USB_EP0_STAT       0x210C /* EP 0 status */
+#define USB_EP0_IRQSTAT    0x2110 /* EP 0 interrupt status */
+#define USB_EP0_IRQEN      0x2114 /* EP 0 interrupt enable */
+#define USB_EP0_MAXPKT     0x2118 /* EP 0 max packet size */
+#define USB_EP0_BC         0x2120 /* EP 0 FIFO byte counter */
+#define USB_EPA_CFG        0x2144 /* EP A configure */
+#define USB_EPA_CFG_0      0x2144 /* EP A configure */
+#define USB_EPA_CFG_1      0x2145 /* EP A configure */
+#define USB_EPA_CFG_2      0x2146 /* EP A configure */
+#define USB_EPA_CFG_3      0x2147 /* EP A configure */
+#define USB_EPA_CTL        0x2148 /* EP A control */
+#define USB_EPA_CTL_0      0x2148 /* EP A control */
+#define USB_EPA_CTL_1      0x2149 /* EP A control */
+#define USB_EPA_CTL_2      0x214A /* EP A control */
+#define USB_EPA_CTL_3      0x214B /* EP A control */
+#define USB_EPA_STAT       0x214C /* EP A status */
+#define USB_EPA_IRQSTAT    0x2150 /* EP A interrupt status */
+#define USB_EPA_IRQEN      0x2154 /* EP A interrupt enable */
+#define USB_EPA_MAXPKT     0x2158 /* EP A max packet size */
+#define USB_EPA_MAXPKT_0   0x2158 /* EP A max packet size */
+#define USB_EPA_MAXPKT_1   0x2159 /* EP A max packet size */
+#define USB_EPA_MAXPKT_2   0x215A /* EP A max packet size */
+#define USB_EPA_MAXPKT_3   0x215B /* EP A max packet size */
+#define USB_EPA_FIFO_CFG   0x2160 /* EP A FIFO configure */
+#define USB_EPA_FIFO_CFG_0 0x2160 /* EP A FIFO configure */
+#define USB_EPA_FIFO_CFG_1 0x2161 /* EP A FIFO configure */
+#define USB_EPA_FIFO_CFG_2 0x2162 /* EP A FIFO configure */
+#define USB_EPA_FIFO_CFG_3 0x2163 /* EP A FIFO configure */
+/* Debug Registers */
+#define USB_PHYTSTDIS      0x2F04 /* PHY test disable */
+#define USB_TOUT_VAL       0x2F08 /* USB time-out time */
+#define USB_VDRCTRL        0x2F10 /* UTMI vendor signal control */
+#define USB_VSTAIN         0x2F14 /* UTMI vendor signal status in */
+#define USB_VLOADM         0x2F18 /* UTMI load vendor signal status in */
+#define USB_VSTAOUT        0x2F1C /* UTMI vendor signal status out */
+#define USB_UTMI_TST       0x2F80 /* UTMI test */
+#define USB_UTMI_STATUS    0x2F84 /* UTMI status */
+#define USB_TSTCTL         0x2F88 /* test control */
+#define USB_TSTCTL2        0x2F8C /* test control 2 */
+#define USB_PID_FORCE      0x2F90 /* force PID */
+#define USB_PKTERR_CNT     0x2F94 /* packet error counter */
+#define USB_RXERR_CNT      0x2F98 /* RX error counter */
+#define USB_MEM_BIST       0x2F9C /* MEM BIST test */
+#define USB_SLBBIST        0x2FA0 /* self-loop-back BIST */
+#define USB_CNTTEST        0x2FA4 /* counter test */
+#define USB_PHYTST         0x2FC0 /* USB PHY test */
+#define USB_DBGIDX         0x2FF0 /* select individual block debug signal */
+#define USB_DBGMUX         0x2FF4 /* debug signal module mux */
+
+/*
+ * SYS registers
+ */
+/* demod control registers */
+#define SYS_SYS0           0x3000 /* include DEMOD_CTL, GPO, GPI, GPOE */
+#define SYS_DEMOD_CTL      0x3000 /* control register for DVB-T demodulator */
+/* GPIO registers */
+#define SYS_GPIO_OUT_VAL   0x3001 /* output value of GPIO */
+#define SYS_GPIO_IN_VAL    0x3002 /* input value of GPIO */
+#define SYS_GPIO_OUT_EN    0x3003 /* output enable of GPIO */
+#define SYS_SYS1           0x3004 /* include GPD, SYSINTE, SYSINTS, GP_CFG0 */
+#define SYS_GPIO_DIR       0x3004 /* direction control for GPIO */
+#define SYS_SYSINTE        0x3005 /* system interrupt enable */
+#define SYS_SYSINTS        0x3006 /* system interrupt status */
+#define SYS_GPIO_CFG0      0x3007 /* PAD configuration for GPIO0-GPIO3 */
+#define SYS_SYS2           0x3008 /* include GP_CFG1 and 3 reserved bytes */
+#define SYS_GPIO_CFG1      0x3008 /* PAD configuration for GPIO4 */
+/* IrDA registers */
+#define SYS_IRRC_PSR       0x3020 /* IR protocol selection */
+#define SYS_IRRC_PER       0x3024 /* IR protocol extension */
+#define SYS_IRRC_SF        0x3028 /* IR sampling frequency */
+#define SYS_IRRC_DPIR      0x302C /* IR data package interval */
+#define SYS_IRRC_CR        0x3030 /* IR control */
+#define SYS_IRRC_RP        0x3034 /* IR read port */
+#define SYS_IRRC_SR        0x3038 /* IR status */
+/* I2C master registers */
+#define SYS_I2CCR          0x3040 /* I2C clock */
+#define SYS_I2CMCR         0x3044 /* I2C master control */
+#define SYS_I2CMSTR        0x3048 /* I2C master SCL timing */
+#define SYS_I2CMSR         0x304C /* I2C master status */
+#define SYS_I2CMFR         0x3050 /* I2C master FIFO */
+
+#endif