root/drivers/media/usb/stk1160/stk1160-core.c

DEFINITIONS

1. stk1160_read_reg
2. stk1160_write_reg
3. stk1160_select_input
4. stk1160_reg_reset
5. stk1160_release
6. stk1160_scan_usb
7. stk1160_probe
8. stk1160_disconnect

   1 // SPDX-License-Identifier: GPL-2.0-or-later
   2 /*
   3  * STK1160 driver
   4  *
   5  * Copyright (C) 2012 Ezequiel Garcia
   6  * <elezegarcia--a.t--gmail.com>
   7  *
   8  * Based on Easycap driver by R.M. Thomas
   9  *      Copyright (C) 2010 R.M. Thomas
  10  *      <rmthomas--a.t--sciolus.org>
  11  *
  12  * TODO:
  13  *
  14  * 1. Support stream at lower speed: lower frame rate or lower frame size.
  15  */
  16 
  17 #include <linux/module.h>
  18 #include <linux/init.h>
  19 #include <linux/kernel.h>
  20 #include <linux/errno.h>
  21 #include <linux/slab.h>
  22 
  23 #include <linux/usb.h>
  24 #include <linux/mm.h>
  25 #include <linux/vmalloc.h>
  26 #include <media/i2c/saa7115.h>
  27 
  28 #include "stk1160.h"
  29 #include "stk1160-reg.h"
  30 
  31 static unsigned int input;
  32 module_param(input, int, 0644);
  33 MODULE_PARM_DESC(input, "Set default input");
  34 
  35 MODULE_LICENSE("GPL");
  36 MODULE_AUTHOR("Ezequiel Garcia");
  37 MODULE_DESCRIPTION("STK1160 driver");
  38 
  39 /* Devices supported by this driver */
  40 static const struct usb_device_id stk1160_id_table[] = {
  41         { USB_DEVICE(0x05e1, 0x0408) },
  42         { }
  43 };
  44 MODULE_DEVICE_TABLE(usb, stk1160_id_table);
  45 
  46 /* saa7113 I2C address */
  47 static unsigned short saa7113_addrs[] = {
  48         0x4a >> 1,
  49         I2C_CLIENT_END
  50 };
  51 
  52 /*
  53  * Read/Write stk registers
  54  */
  55 int stk1160_read_reg(struct stk1160 *dev, u16 reg, u8 *value)
  56 {
  57         int ret;
  58         int pipe = usb_rcvctrlpipe(dev->udev, 0);
  59         u8 *buf;
  60 
  61         *value = 0;
  62 
  63         buf = kmalloc(sizeof(u8), GFP_KERNEL);
  64         if (!buf)
  65                 return -ENOMEM;
  66         ret = usb_control_msg(dev->udev, pipe, 0x00,
  67                         USB_DIR_IN | USB_TYPE_VENDOR | USB_RECIP_DEVICE,
  68                         0x00, reg, buf, sizeof(u8), HZ);
  69         if (ret < 0) {
  70                 stk1160_err("read failed on reg 0x%x (%d)\n",
  71                         reg, ret);
  72                 kfree(buf);
  73                 return ret;
  74         }
  75 
  76         *value = *buf;
  77         kfree(buf);
  78         return 0;
  79 }
  80 
  81 int stk1160_write_reg(struct stk1160 *dev, u16 reg, u16 value)
  82 {
  83         int ret;
  84         int pipe = usb_sndctrlpipe(dev->udev, 0);
  85 
  86         ret =  usb_control_msg(dev->udev, pipe, 0x01,
  87                         USB_DIR_OUT | USB_TYPE_VENDOR | USB_RECIP_DEVICE,
  88                         value, reg, NULL, 0, HZ);
  89         if (ret < 0) {
  90                 stk1160_err("write failed on reg 0x%x (%d)\n",
  91                         reg, ret);
  92                 return ret;
  93         }
  94 
  95         return 0;
  96 }
  97 
  98 void stk1160_select_input(struct stk1160 *dev)
  99 {
 100         int route;
 101         static const u8 gctrl[] = {
 102                 0x98, 0x90, 0x88, 0x80, 0x98
 103         };
 104 
 105         if (dev->ctl_input == STK1160_SVIDEO_INPUT)
 106                 route = SAA7115_SVIDEO3;
 107         else
 108                 route = SAA7115_COMPOSITE0;
 109 
 110         if (dev->ctl_input < ARRAY_SIZE(gctrl)) {
 111                 v4l2_device_call_all(&dev->v4l2_dev, 0, video, s_routing,
 112                                 route, 0, 0);
 113                 stk1160_write_reg(dev, STK1160_GCTRL, gctrl[dev->ctl_input]);
 114         }
 115 }
 116 
 117 /* TODO: We should break this into pieces */
 118 static void stk1160_reg_reset(struct stk1160 *dev)
 119 {
 120         int i;
 121 
 122         static const struct regval ctl[] = {
 123                 {STK1160_GCTRL+2, 0x0078},
 124 
 125                 {STK1160_RMCTL+1, 0x0000},
 126                 {STK1160_RMCTL+3, 0x0002},
 127 
 128                 {STK1160_PLLSO,   0x0010},
 129                 {STK1160_PLLSO+1, 0x0000},
 130                 {STK1160_PLLSO+2, 0x0014},
 131                 {STK1160_PLLSO+3, 0x000E},
 132 
 133                 {STK1160_PLLFD,   0x0046},
 134 
 135                 /* Timing generator setup */
 136                 {STK1160_TIGEN,   0x0012},
 137                 {STK1160_TICTL,   0x002D},
 138                 {STK1160_TICTL+1, 0x0001},
 139                 {STK1160_TICTL+2, 0x0000},
 140                 {STK1160_TICTL+3, 0x0000},
 141                 {STK1160_TIGEN,   0x0080},
 142 
 143                 {0xffff, 0xffff}
 144         };
 145 
 146         for (i = 0; ctl[i].reg != 0xffff; i++)
 147                 stk1160_write_reg(dev, ctl[i].reg, ctl[i].val);
 148 }
 149 
 150 static void stk1160_release(struct v4l2_device *v4l2_dev)
 151 {
 152         struct stk1160 *dev = container_of(v4l2_dev, struct stk1160, v4l2_dev);
 153 
 154         stk1160_dbg("releasing all resources\n");
 155 
 156         stk1160_i2c_unregister(dev);
 157 
 158         v4l2_ctrl_handler_free(&dev->ctrl_handler);
 159         v4l2_device_unregister(&dev->v4l2_dev);
 160         mutex_destroy(&dev->v4l_lock);
 161         mutex_destroy(&dev->vb_queue_lock);
 162         kfree(dev->alt_max_pkt_size);
 163         kfree(dev);
 164 }
 165 
 166 /* high bandwidth multiplier, as encoded in highspeed endpoint descriptors */
 167 #define hb_mult(wMaxPacketSize) (1 + (((wMaxPacketSize) >> 11) & 0x03))
 168 
 169 /*
 170  * Scan usb interface and populate max_pkt_size array
 171  * with information on each alternate setting.
 172  * The array should be allocated by the caller.
 173  */
 174 static int stk1160_scan_usb(struct usb_interface *intf, struct usb_device *udev,
 175                 unsigned int *max_pkt_size)
 176 {
 177         int i, e, sizedescr, size, ifnum;
 178         const struct usb_endpoint_descriptor *desc;
 179 
 180         bool has_video = false, has_audio = false;
 181         const char *speed;
 182 
 183         ifnum = intf->altsetting[0].desc.bInterfaceNumber;
 184 
 185         /* Get endpoints */
 186         for (i = 0; i < intf->num_altsetting; i++) {
 187 
 188                 for (e = 0; e < intf->altsetting[i].desc.bNumEndpoints; e++) {
 189 
 190                         /* This isn't clear enough, at least to me */
 191                         desc = &intf->altsetting[i].endpoint[e].desc;
 192                         sizedescr = le16_to_cpu(desc->wMaxPacketSize);
 193                         size = sizedescr & 0x7ff;
 194 
 195                         if (udev->speed == USB_SPEED_HIGH)
 196                                 size = size * hb_mult(sizedescr);
 197 
 198                         if (usb_endpoint_xfer_isoc(desc) &&
 199                             usb_endpoint_dir_in(desc)) {
 200                                 switch (desc->bEndpointAddress) {
 201                                 case STK1160_EP_AUDIO:
 202                                         has_audio = true;
 203                                         break;
 204                                 case STK1160_EP_VIDEO:
 205                                         has_video = true;
 206                                         max_pkt_size[i] = size;
 207                                         break;
 208                                 }
 209                         }
 210                 }
 211         }
 212 
 213         /* Is this even possible? */
 214         if (!(has_audio || has_video)) {
 215                 dev_err(&udev->dev, "no audio or video endpoints found\n");
 216                 return -ENODEV;
 217         }
 218 
 219         switch (udev->speed) {
 220         case USB_SPEED_LOW:
 221                 speed = "1.5";
 222                 break;
 223         case USB_SPEED_FULL:
 224                 speed = "12";
 225                 break;
 226         case USB_SPEED_HIGH:
 227                 speed = "480";
 228                 break;
 229         default:
 230                 speed = "unknown";
 231         }
 232 
 233         dev_info(&udev->dev, "New device %s %s @ %s Mbps (%04x:%04x, interface %d, class %d)\n",
 234                 udev->manufacturer ? udev->manufacturer : "",
 235                 udev->product ? udev->product : "",
 236                 speed,
 237                 le16_to_cpu(udev->descriptor.idVendor),
 238                 le16_to_cpu(udev->descriptor.idProduct),
 239                 ifnum,
 240                 intf->altsetting->desc.bInterfaceNumber);
 241 
 242         /* This should never happen, since we rejected audio interfaces */
 243         if (has_audio)
 244                 dev_warn(&udev->dev, "audio interface %d found.\n\
 245                                 This is not implemented by this driver,\
 246                                 you should use snd-usb-audio instead\n", ifnum);
 247 
 248         if (has_video)
 249                 dev_info(&udev->dev, "video interface %d found\n",
 250                                 ifnum);
 251 
 252         /*
 253          * Make sure we have 480 Mbps of bandwidth, otherwise things like
 254          * video stream wouldn't likely work, since 12 Mbps is generally
 255          * not enough even for most streams.
 256          */
 257         if (udev->speed != USB_SPEED_HIGH)
 258                 dev_warn(&udev->dev, "must be connected to a high-speed USB 2.0 port\n\
 259                                 You may not be able to stream video smoothly\n");
 260 
 261         return 0;
 262 }
 263 
 264 static int stk1160_probe(struct usb_interface *interface,
 265                 const struct usb_device_id *id)
 266 {
 267         int rc = 0;
 268 
 269         unsigned int *alt_max_pkt_size; /* array of wMaxPacketSize */
 270         struct usb_device *udev;
 271         struct stk1160 *dev;
 272 
 273         udev = interface_to_usbdev(interface);
 274 
 275         /*
 276          * Since usb audio class is supported by snd-usb-audio,
 277          * we reject audio interface.
 278          */
 279         if (interface->altsetting[0].desc.bInterfaceClass == USB_CLASS_AUDIO)
 280                 return -ENODEV;
 281 
 282         /* Alloc an array for all possible max_pkt_size */
 283         alt_max_pkt_size = kmalloc_array(interface->num_altsetting,
 284                                          sizeof(alt_max_pkt_size[0]),
 285                                          GFP_KERNEL);
 286         if (alt_max_pkt_size == NULL)
 287                 return -ENOMEM;
 288 
 289         /*
 290          * Scan usb possibilities and populate alt_max_pkt_size array.
 291          * Also, check if device speed is fast enough.
 292          */
 293         rc = stk1160_scan_usb(interface, udev, alt_max_pkt_size);
 294         if (rc < 0) {
 295                 kfree(alt_max_pkt_size);
 296                 return rc;
 297         }
 298 
 299         dev = kzalloc(sizeof(struct stk1160), GFP_KERNEL);
 300         if (dev == NULL) {
 301                 kfree(alt_max_pkt_size);
 302                 return -ENOMEM;
 303         }
 304 
 305         dev->alt_max_pkt_size = alt_max_pkt_size;
 306         dev->udev = udev;
 307         dev->num_alt = interface->num_altsetting;
 308         dev->ctl_input = input;
 309 
 310         /* We save struct device for debug purposes only */
 311         dev->dev = &interface->dev;
 312 
 313         usb_set_intfdata(interface, dev);
 314 
 315         /* initialize videobuf2 stuff */
 316         rc = stk1160_vb2_setup(dev);
 317         if (rc < 0)
 318                 goto free_err;
 319 
 320         /*
 321          * There is no need to take any locks here in probe
 322          * because we register the device node as the *last* thing.
 323          */
 324         spin_lock_init(&dev->buf_lock);
 325         mutex_init(&dev->v4l_lock);
 326         mutex_init(&dev->vb_queue_lock);
 327 
 328         rc = v4l2_ctrl_handler_init(&dev->ctrl_handler, 0);
 329         if (rc) {
 330                 stk1160_err("v4l2_ctrl_handler_init failed (%d)\n", rc);
 331                 goto free_err;
 332         }
 333 
 334         /*
 335          * We obtain a v4l2_dev but defer
 336          * registration of video device node as the last thing.
 337          * There is no need to set the name if we give a device struct
 338          */
 339         dev->v4l2_dev.release = stk1160_release;
 340         dev->v4l2_dev.ctrl_handler = &dev->ctrl_handler;
 341         rc = v4l2_device_register(dev->dev, &dev->v4l2_dev);
 342         if (rc) {
 343                 stk1160_err("v4l2_device_register failed (%d)\n", rc);
 344                 goto free_ctrl;
 345         }
 346 
 347         rc = stk1160_i2c_register(dev);
 348         if (rc < 0)
 349                 goto unreg_v4l2;
 350 
 351         /*
 352          * To the best of my knowledge stk1160 boards only have
 353          * saa7113, but it doesn't hurt to support them all.
 354          */
 355         dev->sd_saa7115 = v4l2_i2c_new_subdev(&dev->v4l2_dev, &dev->i2c_adap,
 356                 "saa7115_auto", 0, saa7113_addrs);
 357 
 358         /* i2c reset saa711x */
 359         v4l2_device_call_all(&dev->v4l2_dev, 0, core, reset, 0);
 360         v4l2_device_call_all(&dev->v4l2_dev, 0, video, s_stream, 0);
 361 
 362         /* reset stk1160 to default values */
 363         stk1160_reg_reset(dev);
 364 
 365         /* select default input */
 366         stk1160_select_input(dev);
 367 
 368         stk1160_ac97_setup(dev);
 369 
 370         rc = stk1160_video_register(dev);
 371         if (rc < 0)
 372                 goto unreg_i2c;
 373 
 374         return 0;
 375 
 376 unreg_i2c:
 377         stk1160_i2c_unregister(dev);
 378 unreg_v4l2:
 379         v4l2_device_unregister(&dev->v4l2_dev);
 380 free_ctrl:
 381         v4l2_ctrl_handler_free(&dev->ctrl_handler);
 382 free_err:
 383         kfree(alt_max_pkt_size);
 384         kfree(dev);
 385 
 386         return rc;
 387 }
 388 
 389 static void stk1160_disconnect(struct usb_interface *interface)
 390 {
 391         struct stk1160 *dev;
 392 
 393         dev = usb_get_intfdata(interface);
 394         usb_set_intfdata(interface, NULL);
 395 
 396         /*
 397          * Wait until all current v4l2 operation are finished
 398          * then deallocate resources
 399          */
 400         mutex_lock(&dev->vb_queue_lock);
 401         mutex_lock(&dev->v4l_lock);
 402 
 403         /* Here is the only place where isoc get released */
 404         stk1160_uninit_isoc(dev);
 405 
 406         stk1160_clear_queue(dev);
 407 
 408         video_unregister_device(&dev->vdev);
 409         v4l2_device_disconnect(&dev->v4l2_dev);
 410 
 411         /* This way current users can detect device is gone */
 412         dev->udev = NULL;
 413 
 414         mutex_unlock(&dev->v4l_lock);
 415         mutex_unlock(&dev->vb_queue_lock);
 416 
 417         /*
 418          * This calls stk1160_release if it's the last reference.
 419          * Otherwise, release is postponed until there are no users left.
 420          */
 421         v4l2_device_put(&dev->v4l2_dev);
 422 }
 423 
 424 static struct usb_driver stk1160_usb_driver = {
 425         .name = "stk1160",
 426         .id_table = stk1160_id_table,
 427         .probe = stk1160_probe,
 428         .disconnect = stk1160_disconnect,
 429 };
 430 
 431 module_usb_driver(stk1160_usb_driver);