drivers/media/usb/usbtv/usbtv-core.c

   1 /*
   2  * Fushicai USBTV007 Audio-Video Grabber Driver
   3  *
   4  * Product web site:
   5  * http://www.fushicai.com/products_detail/&productId=d05449ee-b690-42f9-a661-aa7353894bed.html
   6  *
   7  * Following LWN articles were very useful in construction of this driver:
   8  * Video4Linux2 API series: http://lwn.net/Articles/203924/
   9  * videobuf2 API explanation: http://lwn.net/Articles/447435/
  10  * Thanks go to Jonathan Corbet for providing this quality documentation.
  11  * He is awesome.
  12  *
  13  * Copyright (c) 2013 Lubomir Rintel
  14  * All rights reserved.
  15  * No physical hardware was harmed running Windows during the
  16  * reverse-engineering activity
  17  *
  18  * Redistribution and use in source and binary forms, with or without
  19  * modification, are permitted provided that the following conditions
  20  * are met:
  21  * 1. Redistributions of source code must retain the above copyright
  22  *    notice, this list of conditions, and the following disclaimer,
  23  *    without modification.
  24  * 2. The name of the author may not be used to endorse or promote products
  25  *    derived from this software without specific prior written permission.
  26  *
  27  * Alternatively, this software may be distributed under the terms of the
  28  * GNU General Public License ("GPL").
  29  */
  30
  31 #include "usbtv.h"
  32
  33 int usbtv_set_regs(struct usbtv *usbtv, const u16 regs[][2], int size)
  34 {
  35         int ret;
  36         int pipe = usb_rcvctrlpipe(usbtv->udev, 0);
  37         int i;
  38
  39         for (i = 0; i < size; i++) {
  40                 u16 index = regs[i][0];
  41                 u16 value = regs[i][1];
  42
  43                 ret = usb_control_msg(usbtv->udev, pipe, USBTV_REQUEST_REG,
  44                         USB_DIR_OUT | USB_TYPE_VENDOR | USB_RECIP_DEVICE,
  45                         value, index, NULL, 0, USB_CTRL_GET_TIMEOUT);
  46                 if (ret < 0)
  47                         return ret;
  48         }
  49
  50         return 0;
  51 }
  52
  53 static int usbtv_probe(struct usb_interface *intf,
  54         const struct usb_device_id *id)
  55 {
  56         int ret;
  57         int size;
  58         struct device *dev = &intf->dev;
  59         struct usbtv *usbtv;
  60
  61         /* Checks that the device is what we think it is. */
  62         if (intf->num_altsetting != 2)
  63                 return -ENODEV;
  64         if (intf->altsetting[1].desc.bNumEndpoints != 4)
  65                 return -ENODEV;
  66
  67         /* Packet size is split into 11 bits of base size and count of
  68          * extra multiplies of it.*/
  69         size = usb_endpoint_maxp(&intf->altsetting[1].endpoint[0].desc);
  70         size = (size & 0x07ff) * (((size & 0x1800) >> 11) + 1);
  71
  72         /* Device structure */
  73         usbtv = kzalloc(sizeof(struct usbtv), GFP_KERNEL);
  74         if (usbtv == NULL)
  75                 return -ENOMEM;
  76         usbtv->dev = dev;
  77         usbtv->udev = usb_get_dev(interface_to_usbdev(intf));
  78
  79         usbtv->iso_size = size;
  80
  81         usb_set_intfdata(intf, usbtv);
  82
  83         ret = usbtv_video_init(usbtv);
  84         if (ret < 0)
  85                 goto usbtv_video_fail;
  86
  87         ret = usbtv_audio_init(usbtv);
  88         if (ret < 0)
  89                 goto usbtv_audio_fail;
  90
  91         /* for simplicity we exploit the v4l2_device reference counting */
  92         v4l2_device_get(&usbtv->v4l2_dev);
  93
  94         dev_info(dev, "Fushicai USBTV007 Audio-Video Grabber\n");
  95         return 0;
  96
  97 usbtv_audio_fail:
  98         /* we must not free at this point */
  99         v4l2_device_get(&usbtv->v4l2_dev);
 100         /* this will undo the v4l2_device_get() */
 101         usbtv_video_free(usbtv);
 102
 103 usbtv_video_fail:
 104         usb_set_intfdata(intf, NULL);
 105         usb_put_dev(usbtv->udev);
 106         kfree(usbtv);
 107
 108         return ret;
 109 }
 110
 111 static void usbtv_disconnect(struct usb_interface *intf)
 112 {
 113         struct usbtv *usbtv = usb_get_intfdata(intf);
 114
 115         usb_set_intfdata(intf, NULL);
 116
 117         if (!usbtv)
 118                 return;
 119
 120         usbtv_audio_free(usbtv);
 121         usbtv_video_free(usbtv);
 122
 123         usb_put_dev(usbtv->udev);
 124         usbtv->udev = NULL;
 125
 126         /* the usbtv structure will be deallocated when v4l2 will be
 127            done using it */
 128         v4l2_device_put(&usbtv->v4l2_dev);
 129 }
 130
 131 static struct usb_device_id usbtv_id_table[] = {
 132         { USB_DEVICE(0x1b71, 0x3002) },
 133         { USB_DEVICE(0x1f71, 0x3301) },
 134         {}
 135 };
 136 MODULE_DEVICE_TABLE(usb, usbtv_id_table);
 137
 138 MODULE_AUTHOR("Lubomir Rintel, Federico Simoncelli");
 139 MODULE_DESCRIPTION("Fushicai USBTV007 Audio-Video Grabber Driver");
 140 MODULE_LICENSE("Dual BSD/GPL");
 141
 142 static struct usb_driver usbtv_usb_driver = {
 143         .name = "usbtv",
 144         .id_table = usbtv_id_table,
 145         .probe = usbtv_probe,
 146         .disconnect = usbtv_disconnect,
 147 };
 148
 149 module_usb_driver(usbtv_usb_driver);