drivers/media/video/uvc/uvc_v4l2.c

   1 /*
   2  *      uvc_v4l2.c  --  USB Video Class driver - V4L2 API
   3  *
   4  *      Copyright (C) 2005-2008
   5  *          Laurent Pinchart (laurent.pinchart@skynet.be)
   6  *
   7  *      This program is free software; you can redistribute it and/or modify
   8  *      it under the terms of the GNU General Public License as published by
   9  *      the Free Software Foundation; either version 2 of the License, or
  10  *      (at your option) any later version.
  11  *
  12  */
  13
  14 #include <linux/kernel.h>
  15 #include <linux/version.h>
  16 #include <linux/list.h>
  17 #include <linux/module.h>
  18 #include <linux/usb.h>
  19 #include <linux/videodev2.h>
  20 #include <linux/vmalloc.h>
  21 #include <linux/mm.h>
  22 #include <linux/wait.h>
  23 #include <asm/atomic.h>
  24
  25 #include <media/v4l2-common.h>
  26
  27 #include "uvcvideo.h"
  28
  29 /* ------------------------------------------------------------------------
  30  * V4L2 interface
  31  */
  32
  33 /*
  34  * Mapping V4L2 controls to UVC controls can be straighforward if done well.
  35  * Most of the UVC controls exist in V4L2, and can be mapped directly. Some
  36  * must be grouped (for instance the Red Balance, Blue Balance and Do White
  37  * Balance V4L2 controls use the White Balance Component UVC control) or
  38  * otherwise translated. The approach we take here is to use a translation
  39  * table for the controls which can be mapped directly, and handle the others
  40  * manually.
  41  */
  42 static int uvc_v4l2_query_menu(struct uvc_video_device *video,
  43         struct v4l2_querymenu *query_menu)
  44 {
  45         struct uvc_menu_info *menu_info;
  46         struct uvc_control_mapping *mapping;
  47         struct uvc_control *ctrl;
  48
  49         ctrl = uvc_find_control(video, query_menu->id, &mapping);
  50         if (ctrl == NULL || mapping->v4l2_type != V4L2_CTRL_TYPE_MENU)
  51                 return -EINVAL;
  52
  53         if (query_menu->index >= mapping->menu_count)
  54                 return -EINVAL;
  55
  56         menu_info = &mapping->menu_info[query_menu->index];
  57         strncpy(query_menu->name, menu_info->name, 32);
  58         return 0;
  59 }
  60
  61 /*
  62  * Find the frame interval closest to the requested frame interval for the
  63  * given frame format and size. This should be done by the device as part of
  64  * the Video Probe and Commit negotiation, but some hardware don't implement
  65  * that feature.
  66  */
  67 static __u32 uvc_try_frame_interval(struct uvc_frame *frame, __u32 interval)
  68 {
  69         unsigned int i;
  70
  71         if (frame->bFrameIntervalType) {
  72                 __u32 best = -1, dist;
  73
  74                 for (i = 0; i < frame->bFrameIntervalType; ++i) {
  75                         dist = interval > frame->dwFrameInterval[i]
  76                              ? interval - frame->dwFrameInterval[i]
  77                              : frame->dwFrameInterval[i] - interval;
  78
  79                         if (dist > best)
  80                                 break;
  81
  82                         best = dist;
  83                 }
  84
  85                 interval = frame->dwFrameInterval[i-1];
  86         } else {
  87                 const __u32 min = frame->dwFrameInterval[0];
  88                 const __u32 max = frame->dwFrameInterval[1];
  89                 const __u32 step = frame->dwFrameInterval[2];
  90
  91                 interval = min + (interval - min + step/2) / step * step;
  92                 if (interval > max)
  93                         interval = max;
  94         }
  95
  96         return interval;
  97 }
  98
  99 static int uvc_v4l2_try_format(struct uvc_video_device *video,
 100         struct v4l2_format *fmt, struct uvc_streaming_control *probe,
 101         struct uvc_format **uvc_format, struct uvc_frame **uvc_frame)
 102 {
 103         struct uvc_format *format = NULL;
 104         struct uvc_frame *frame = NULL;
 105         __u16 rw, rh;
 106         unsigned int d, maxd;
 107         unsigned int i;
 108         __u32 interval;
 109         int ret = 0;
 110         __u8 *fcc;
 111
 112         if (fmt->type != V4L2_BUF_TYPE_VIDEO_CAPTURE)
 113                 return -EINVAL;
 114
 115         fcc = (__u8 *)&fmt->fmt.pix.pixelformat;
 116         uvc_trace(UVC_TRACE_FORMAT, "Trying format 0x%08x (%c%c%c%c): %ux%u.\n",
 117                         fmt->fmt.pix.pixelformat,
 118                         fcc[0], fcc[1], fcc[2], fcc[3],
 119                         fmt->fmt.pix.width, fmt->fmt.pix.height);
 120
 121         /* Check if the hardware supports the requested format. */
 122         for (i = 0; i < video->streaming->nformats; ++i) {
 123                 format = &video->streaming->format[i];
 124                 if (format->fcc == fmt->fmt.pix.pixelformat)
 125                         break;
 126         }
 127
 128         if (format == NULL || format->fcc != fmt->fmt.pix.pixelformat) {
 129                 uvc_trace(UVC_TRACE_FORMAT, "Unsupported format 0x%08x.\n",
 130                                 fmt->fmt.pix.pixelformat);
 131                 return -EINVAL;
 132         }
 133
 134         /* Find the closest image size. The distance between image sizes is
 135          * the size in pixels of the non-overlapping regions between the
 136          * requested size and the frame-specified size.
 137          */
 138         rw = fmt->fmt.pix.width;
 139         rh = fmt->fmt.pix.height;
 140         maxd = (unsigned int)-1;
 141
 142         for (i = 0; i < format->nframes; ++i) {
 143                 __u16 w = format->frame[i].wWidth;
 144                 __u16 h = format->frame[i].wHeight;
 145
 146                 d = min(w, rw) * min(h, rh);
 147                 d = w*h + rw*rh - 2*d;
 148                 if (d < maxd) {
 149                         maxd = d;
 150                         frame = &format->frame[i];
 151                 }
 152
 153                 if (maxd == 0)
 154                         break;
 155         }
 156
 157         if (frame == NULL) {
 158                 uvc_trace(UVC_TRACE_FORMAT, "Unsupported size %ux%u.\n",
 159                                 fmt->fmt.pix.width, fmt->fmt.pix.height);
 160                 return -EINVAL;
 161         }
 162
 163         /* Use the default frame interval. */
 164         interval = frame->dwDefaultFrameInterval;
 165         uvc_trace(UVC_TRACE_FORMAT, "Using default frame interval %u.%u us "
 166                 "(%u.%u fps).\n", interval/10, interval%10, 10000000/interval,
 167                 (100000000/interval)%10);
 168
 169         /* Set the format index, frame index and frame interval. */
 170         memset(probe, 0, sizeof *probe);
 171         probe->bmHint = 1;      /* dwFrameInterval */
 172         probe->bFormatIndex = format->index;
 173         probe->bFrameIndex = frame->bFrameIndex;
 174         probe->dwFrameInterval = uvc_try_frame_interval(frame, interval);
 175         /* Some webcams stall the probe control set request when the
 176          * dwMaxVideoFrameSize field is set to zero. The UVC specification
 177          * clearly states that the field is read-only from the host, so this
 178          * is a webcam bug. Set dwMaxVideoFrameSize to the value reported by
 179          * the webcam to work around the problem.
 180          *
 181          * The workaround could probably be enabled for all webcams, so the
 182          * quirk can be removed if needed. It's currently useful to detect
 183          * webcam bugs and fix them before they hit the market (providing
 184          * developers test their webcams with the Linux driver as well as with
 185          * the Windows driver).
 186          */
 187         if (video->dev->quirks & UVC_QUIRK_PROBE_EXTRAFIELDS)
 188                 probe->dwMaxVideoFrameSize =
 189                         video->streaming->ctrl.dwMaxVideoFrameSize;
 190
 191         /* Probe the device */
 192         if ((ret = uvc_probe_video(video, probe)) < 0)
 193                 goto done;
 194
 195         fmt->fmt.pix.width = frame->wWidth;
 196         fmt->fmt.pix.height = frame->wHeight;
 197         fmt->fmt.pix.field = V4L2_FIELD_NONE;
 198         fmt->fmt.pix.bytesperline = format->bpp * frame->wWidth / 8;
 199         fmt->fmt.pix.sizeimage = probe->dwMaxVideoFrameSize;
 200         fmt->fmt.pix.colorspace = format->colorspace;
 201         fmt->fmt.pix.priv = 0;
 202
 203         if (uvc_format != NULL)
 204                 *uvc_format = format;
 205         if (uvc_frame != NULL)
 206                 *uvc_frame = frame;
 207
 208 done:
 209         return ret;
 210 }
 211
 212 static int uvc_v4l2_get_format(struct uvc_video_device *video,
 213         struct v4l2_format *fmt)
 214 {
 215         struct uvc_format *format = video->streaming->cur_format;
 216         struct uvc_frame *frame = video->streaming->cur_frame;
 217
 218         if (fmt->type != V4L2_BUF_TYPE_VIDEO_CAPTURE)
 219                 return -EINVAL;
 220
 221         if (format == NULL || frame == NULL)
 222                 return -EINVAL;
 223
 224         fmt->fmt.pix.pixelformat = format->fcc;
 225         fmt->fmt.pix.width = frame->wWidth;
 226         fmt->fmt.pix.height = frame->wHeight;
 227         fmt->fmt.pix.field = V4L2_FIELD_NONE;
 228         fmt->fmt.pix.bytesperline = format->bpp * frame->wWidth / 8;
 229         fmt->fmt.pix.sizeimage = video->streaming->ctrl.dwMaxVideoFrameSize;
 230         fmt->fmt.pix.colorspace = format->colorspace;
 231         fmt->fmt.pix.priv = 0;
 232
 233         return 0;
 234 }
 235
 236 static int uvc_v4l2_set_format(struct uvc_video_device *video,
 237         struct v4l2_format *fmt)
 238 {
 239         struct uvc_streaming_control probe;
 240         struct uvc_format *format;
 241         struct uvc_frame *frame;
 242         int ret;
 243
 244         if (fmt->type != V4L2_BUF_TYPE_VIDEO_CAPTURE)
 245                 return -EINVAL;
 246
 247         if (uvc_queue_streaming(&video->queue))
 248                 return -EBUSY;
 249
 250         ret = uvc_v4l2_try_format(video, fmt, &probe, &format, &frame);
 251         if (ret < 0)
 252                 return ret;
 253
 254         if ((ret = uvc_set_video_ctrl(video, &probe, 0)) < 0)
 255                 return ret;
 256
 257         memcpy(&video->streaming->ctrl, &probe, sizeof probe);
 258         video->streaming->cur_format = format;
 259         video->streaming->cur_frame = frame;
 260
 261         return 0;
 262 }
 263
 264 static int uvc_v4l2_get_streamparm(struct uvc_video_device *video,
 265                 struct v4l2_streamparm *parm)
 266 {
 267         uint32_t numerator, denominator;
 268
 269         if (parm->type != V4L2_BUF_TYPE_VIDEO_CAPTURE)
 270                 return -EINVAL;
 271
 272         numerator = video->streaming->ctrl.dwFrameInterval;
 273         denominator = 10000000;
 274         uvc_simplify_fraction(&numerator, &denominator, 8, 333);
 275
 276         memset(parm, 0, sizeof *parm);
 277         parm->type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
 278         parm->parm.capture.capability = V4L2_CAP_TIMEPERFRAME;
 279         parm->parm.capture.capturemode = 0;
 280         parm->parm.capture.timeperframe.numerator = numerator;
 281         parm->parm.capture.timeperframe.denominator = denominator;
 282         parm->parm.capture.extendedmode = 0;
 283         parm->parm.capture.readbuffers = 0;
 284
 285         return 0;
 286 }
 287
 288 static int uvc_v4l2_set_streamparm(struct uvc_video_device *video,
 289                 struct v4l2_streamparm *parm)
 290 {
 291         struct uvc_frame *frame = video->streaming->cur_frame;
 292         struct uvc_streaming_control probe;
 293         uint32_t interval;
 294         int ret;
 295
 296         if (parm->type != V4L2_BUF_TYPE_VIDEO_CAPTURE)
 297                 return -EINVAL;
 298
 299         if (uvc_queue_streaming(&video->queue))
 300                 return -EBUSY;
 301
 302         memcpy(&probe, &video->streaming->ctrl, sizeof probe);
 303         interval = uvc_fraction_to_interval(
 304                         parm->parm.capture.timeperframe.numerator,
 305                         parm->parm.capture.timeperframe.denominator);
 306
 307         uvc_trace(UVC_TRACE_FORMAT, "Setting frame interval to %u/%u (%u).\n",
 308                         parm->parm.capture.timeperframe.numerator,
 309                         parm->parm.capture.timeperframe.denominator,
 310                         interval);
 311         probe.dwFrameInterval = uvc_try_frame_interval(frame, interval);
 312
 313         /* Probe the device with the new settings. */
 314         if ((ret = uvc_probe_video(video, &probe)) < 0)
 315                 return ret;
 316
 317         /* Commit the new settings. */
 318         if ((ret = uvc_set_video_ctrl(video, &probe, 0)) < 0)
 319                 return ret;
 320
 321         memcpy(&video->streaming->ctrl, &probe, sizeof probe);
 322
 323         /* Return the actual frame period. */
 324         parm->parm.capture.timeperframe.numerator = probe.dwFrameInterval;
 325         parm->parm.capture.timeperframe.denominator = 10000000;
 326         uvc_simplify_fraction(&parm->parm.capture.timeperframe.numerator,
 327                                 &parm->parm.capture.timeperframe.denominator,
 328                                 8, 333);
 329
 330         return 0;
 331 }
 332
 333 /* ------------------------------------------------------------------------
 334  * Privilege management
 335  */
 336
 337 /*
 338  * Privilege management is the multiple-open implementation basis. The current
 339  * implementation is completely transparent for the end-user and doesn't
 340  * require explicit use of the VIDIOC_G_PRIORITY and VIDIOC_S_PRIORITY ioctls.
 341  * Those ioctls enable finer control on the device (by making possible for a
 342  * user to request exclusive access to a device), but are not mature yet.
 343  * Switching to the V4L2 priority mechanism might be considered in the future
 344  * if this situation changes.
 345  *
 346  * Each open instance of a UVC device can either be in a privileged or
 347  * unprivileged state. Only a single instance can be in a privileged state at
 348  * a given time. Trying to perform an operation which requires privileges will
 349  * automatically acquire the required privileges if possible, or return -EBUSY
 350  * otherwise. Privileges are dismissed when closing the instance.
 351  *
 352  * Operations which require privileges are:
 353  *
 354  * - VIDIOC_S_INPUT
 355  * - VIDIOC_S_PARM
 356  * - VIDIOC_S_FMT
 357  * - VIDIOC_TRY_FMT
 358  * - VIDIOC_REQBUFS
 359  */
 360 static int uvc_acquire_privileges(struct uvc_fh *handle)
 361 {
 362         int ret = 0;
 363
 364         /* Always succeed if the handle is already privileged. */
 365         if (handle->state == UVC_HANDLE_ACTIVE)
 366                 return 0;
 367
 368         /* Check if the device already has a privileged handle. */
 369         mutex_lock(&uvc_driver.open_mutex);
 370         if (atomic_inc_return(&handle->device->active) != 1) {
 371                 atomic_dec(&handle->device->active);
 372                 ret = -EBUSY;
 373                 goto done;
 374         }
 375
 376         handle->state = UVC_HANDLE_ACTIVE;
 377
 378 done:
 379         mutex_unlock(&uvc_driver.open_mutex);
 380         return ret;
 381 }
 382
 383 static void uvc_dismiss_privileges(struct uvc_fh *handle)
 384 {
 385         if (handle->state == UVC_HANDLE_ACTIVE)
 386                 atomic_dec(&handle->device->active);
 387
 388         handle->state = UVC_HANDLE_PASSIVE;
 389 }
 390
 391 static int uvc_has_privileges(struct uvc_fh *handle)
 392 {
 393         return handle->state == UVC_HANDLE_ACTIVE;
 394 }
 395
 396 /* ------------------------------------------------------------------------
 397  * V4L2 file operations
 398  */
 399
 400 static int uvc_v4l2_open(struct inode *inode, struct file *file)
 401 {
 402         struct video_device *vdev;
 403         struct uvc_video_device *video;
 404         struct uvc_fh *handle;
 405         int ret = 0;
 406
 407         uvc_trace(UVC_TRACE_CALLS, "uvc_v4l2_open\n");
 408         mutex_lock(&uvc_driver.open_mutex);
 409         vdev = video_devdata(file);
 410         video = video_get_drvdata(vdev);
 411
 412         if (video->dev->state & UVC_DEV_DISCONNECTED) {
 413                 ret = -ENODEV;
 414                 goto done;
 415         }
 416
 417         ret = usb_autopm_get_interface(video->dev->intf);
 418         if (ret < 0)
 419                 goto done;
 420
 421         /* Create the device handle. */
 422         handle = kzalloc(sizeof *handle, GFP_KERNEL);
 423         if (handle == NULL) {
 424                 usb_autopm_put_interface(video->dev->intf);
 425                 ret = -ENOMEM;
 426                 goto done;
 427         }
 428
 429         handle->device = video;
 430         handle->state = UVC_HANDLE_PASSIVE;
 431         file->private_data = handle;
 432
 433         kref_get(&video->dev->kref);
 434
 435 done:
 436         mutex_unlock(&uvc_driver.open_mutex);
 437         return ret;
 438 }
 439
 440 static int uvc_v4l2_release(struct inode *inode, struct file *file)
 441 {
 442         struct video_device *vdev = video_devdata(file);
 443         struct uvc_video_device *video = video_get_drvdata(vdev);
 444         struct uvc_fh *handle = (struct uvc_fh *)file->private_data;
 445
 446         uvc_trace(UVC_TRACE_CALLS, "uvc_v4l2_release\n");
 447
 448         /* Only free resources if this is a privileged handle. */
 449         if (uvc_has_privileges(handle)) {
 450                 uvc_video_enable(video, 0);
 451
 452                 mutex_lock(&video->queue.mutex);
 453                 if (uvc_free_buffers(&video->queue) < 0)
 454                         uvc_printk(KERN_ERR, "uvc_v4l2_release: Unable to "
 455                                         "free buffers.\n");
 456                 mutex_unlock(&video->queue.mutex);
 457         }
 458
 459         /* Release the file handle. */
 460         uvc_dismiss_privileges(handle);
 461         kfree(handle);
 462         file->private_data = NULL;
 463
 464         usb_autopm_put_interface(video->dev->intf);
 465         kref_put(&video->dev->kref, uvc_delete);
 466         return 0;
 467 }
 468
 469 static int uvc_v4l2_do_ioctl(struct inode *inode, struct file *file,
 470                      unsigned int cmd, void *arg)
 471 {
 472         struct video_device *vdev = video_devdata(file);
 473         struct uvc_video_device *video = video_get_drvdata(vdev);
 474         struct uvc_fh *handle = (struct uvc_fh *)file->private_data;
 475         int ret = 0;
 476
 477         if (uvc_trace_param & UVC_TRACE_IOCTL)
 478                 v4l_printk_ioctl(cmd);
 479
 480         switch (cmd) {
 481         /* Query capabilities */
 482         case VIDIOC_QUERYCAP:
 483         {
 484                 struct v4l2_capability *cap = arg;
 485
 486                 memset(cap, 0, sizeof *cap);
 487                 strncpy(cap->driver, "uvcvideo", sizeof cap->driver);
 488                 strncpy(cap->card, vdev->name, 32);
 489                 strncpy(cap->bus_info, video->dev->udev->bus->bus_name,
 490                         sizeof cap->bus_info);
 491                 cap->version = DRIVER_VERSION_NUMBER;
 492                 cap->capabilities = V4L2_CAP_VIDEO_CAPTURE
 493                                   | V4L2_CAP_STREAMING;
 494                 break;
 495         }
 496
 497         /* Get, Set & Query control */
 498         case VIDIOC_QUERYCTRL:
 499                 return uvc_query_v4l2_ctrl(video, arg);
 500
 501         case VIDIOC_G_CTRL:
 502         {
 503                 struct v4l2_control *ctrl = arg;
 504                 struct v4l2_ext_control xctrl;
 505
 506                 memset(&xctrl, 0, sizeof xctrl);
 507                 xctrl.id = ctrl->id;
 508
 509                 uvc_ctrl_begin(video);
 510                 ret = uvc_ctrl_get(video, &xctrl);
 511                 uvc_ctrl_rollback(video);
 512                 if (ret >= 0)
 513                         ctrl->value = xctrl.value;
 514                 break;
 515         }
 516
 517         case VIDIOC_S_CTRL:
 518         {
 519                 struct v4l2_control *ctrl = arg;
 520                 struct v4l2_ext_control xctrl;
 521
 522                 memset(&xctrl, 0, sizeof xctrl);
 523                 xctrl.id = ctrl->id;
 524                 xctrl.value = ctrl->value;
 525
 526                 uvc_ctrl_begin(video);
 527                 ret = uvc_ctrl_set(video, &xctrl);
 528                 if (ret < 0) {
 529                         uvc_ctrl_rollback(video);
 530                         return ret;
 531                 }
 532                 ret = uvc_ctrl_commit(video);
 533                 break;
 534         }
 535
 536         case VIDIOC_QUERYMENU:
 537                 return uvc_v4l2_query_menu(video, arg);
 538
 539         case VIDIOC_G_EXT_CTRLS:
 540         {
 541                 struct v4l2_ext_controls *ctrls = arg;
 542                 struct v4l2_ext_control *ctrl = ctrls->controls;
 543                 unsigned int i;
 544
 545                 uvc_ctrl_begin(video);
 546                 for (i = 0; i < ctrls->count; ++ctrl, ++i) {
 547                         ret = uvc_ctrl_get(video, ctrl);
 548                         if (ret < 0) {
 549                                 uvc_ctrl_rollback(video);
 550                                 ctrls->error_idx = i;
 551                                 return ret;
 552                         }
 553                 }
 554                 ctrls->error_idx = 0;
 555                 ret = uvc_ctrl_rollback(video);
 556                 break;
 557         }
 558
 559         case VIDIOC_S_EXT_CTRLS:
 560         case VIDIOC_TRY_EXT_CTRLS:
 561         {
 562                 struct v4l2_ext_controls *ctrls = arg;
 563                 struct v4l2_ext_control *ctrl = ctrls->controls;
 564                 unsigned int i;
 565
 566                 ret = uvc_ctrl_begin(video);
 567                 if (ret < 0)
 568                         return ret;
 569
 570                 for (i = 0; i < ctrls->count; ++ctrl, ++i) {
 571                         ret = uvc_ctrl_set(video, ctrl);
 572                         if (ret < 0) {
 573                                 uvc_ctrl_rollback(video);
 574                                 ctrls->error_idx = i;
 575                                 return ret;
 576                         }
 577                 }
 578
 579                 ctrls->error_idx = 0;
 580
 581                 if (cmd == VIDIOC_S_EXT_CTRLS)
 582                         ret = uvc_ctrl_commit(video);
 583                 else
 584                         ret = uvc_ctrl_rollback(video);
 585                 break;
 586         }
 587
 588         /* Get, Set & Enum input */
 589         case VIDIOC_ENUMINPUT:
 590         {
 591                 const struct uvc_entity *selector = video->selector;
 592                 struct v4l2_input *input = arg;
 593                 struct uvc_entity *iterm = NULL;
 594                 u32 index = input->index;
 595                 int pin = 0;
 596
 597                 if (selector == NULL ||
 598                     (video->dev->quirks & UVC_QUIRK_IGNORE_SELECTOR_UNIT)) {
 599                         if (index != 0)
 600                                 return -EINVAL;
 601                         iterm = list_first_entry(&video->iterms,
 602                                         struct uvc_entity, chain);
 603                         pin = iterm->id;
 604                 } else if (pin < selector->selector.bNrInPins) {
 605                         pin = selector->selector.baSourceID[index];
 606                         list_for_each_entry(iterm, video->iterms.next, chain) {
 607                                 if (iterm->id == pin)
 608                                         break;
 609                         }
 610                 }
 611
 612                 if (iterm == NULL || iterm->id != pin)
 613                         return -EINVAL;
 614
 615                 memset(input, 0, sizeof *input);
 616                 input->index = index;
 617                 strncpy(input->name, iterm->name, sizeof input->name);
 618                 if (UVC_ENTITY_TYPE(iterm) == ITT_CAMERA)
 619                         input->type = V4L2_INPUT_TYPE_CAMERA;
 620                 break;
 621         }
 622
 623         case VIDIOC_G_INPUT:
 624         {
 625                 u8 input;
 626
 627                 if (video->selector == NULL ||
 628                     (video->dev->quirks & UVC_QUIRK_IGNORE_SELECTOR_UNIT)) {
 629                         *(int *)arg = 0;
 630                         break;
 631                 }
 632
 633                 ret = uvc_query_ctrl(video->dev, GET_CUR, video->selector->id,
 634                         video->dev->intfnum, SU_INPUT_SELECT_CONTROL,
 635                         &input, 1);
 636                 if (ret < 0)
 637                         return ret;
 638
 639                 *(int *)arg = input - 1;
 640                 break;
 641         }
 642
 643         case VIDIOC_S_INPUT:
 644         {
 645                 u8 input = *(u32 *)arg + 1;
 646
 647                 if ((ret = uvc_acquire_privileges(handle)) < 0)
 648                         return ret;
 649
 650                 if (video->selector == NULL ||
 651                     (video->dev->quirks & UVC_QUIRK_IGNORE_SELECTOR_UNIT)) {
 652                         if (input != 1)
 653                                 return -EINVAL;
 654                         break;
 655                 }
 656
 657                 if (input > video->selector->selector.bNrInPins)
 658                         return -EINVAL;
 659
 660                 return uvc_query_ctrl(video->dev, SET_CUR, video->selector->id,
 661                         video->dev->intfnum, SU_INPUT_SELECT_CONTROL,
 662                         &input, 1);
 663         }
 664
 665         /* Try, Get, Set & Enum format */
 666         case VIDIOC_ENUM_FMT:
 667         {
 668                 struct v4l2_fmtdesc *fmt = arg;
 669                 struct uvc_format *format;
 670
 671                 if (fmt->type != V4L2_BUF_TYPE_VIDEO_CAPTURE ||
 672                     fmt->index >= video->streaming->nformats)
 673                         return -EINVAL;
 674
 675                 format = &video->streaming->format[fmt->index];
 676                 fmt->flags = 0;
 677                 if (format->flags & UVC_FMT_FLAG_COMPRESSED)
 678                         fmt->flags |= V4L2_FMT_FLAG_COMPRESSED;
 679                 strncpy(fmt->description, format->name,
 680                         sizeof fmt->description);
 681                 fmt->description[sizeof fmt->description - 1] = 0;
 682                 fmt->pixelformat = format->fcc;
 683                 break;
 684         }
 685
 686         case VIDIOC_TRY_FMT:
 687         {
 688                 struct uvc_streaming_control probe;
 689
 690                 if ((ret = uvc_acquire_privileges(handle)) < 0)
 691                         return ret;
 692
 693                 return uvc_v4l2_try_format(video, arg, &probe, NULL, NULL);
 694         }
 695
 696         case VIDIOC_S_FMT:
 697                 if ((ret = uvc_acquire_privileges(handle)) < 0)
 698                         return ret;
 699
 700                 return uvc_v4l2_set_format(video, arg);
 701
 702         case VIDIOC_G_FMT:
 703                 return uvc_v4l2_get_format(video, arg);
 704
 705         /* Frame size enumeration */
 706         case VIDIOC_ENUM_FRAMESIZES:
 707         {
 708                 struct v4l2_frmsizeenum *fsize = arg;
 709                 struct uvc_format *format = NULL;
 710                 struct uvc_frame *frame;
 711                 int i;
 712
 713                 /* Look for the given pixel format */
 714                 for (i = 0; i < video->streaming->nformats; i++) {
 715                         if (video->streaming->format[i].fcc ==
 716                                         fsize->pixel_format) {
 717                                 format = &video->streaming->format[i];
 718                                 break;
 719                         }
 720                 }
 721                 if (format == NULL)
 722                         return -EINVAL;
 723
 724                 if (fsize->index >= format->nframes)
 725                         return -EINVAL;
 726
 727                 frame = &format->frame[fsize->index];
 728                 fsize->type = V4L2_FRMSIZE_TYPE_DISCRETE;
 729                 fsize->discrete.width = frame->wWidth;
 730                 fsize->discrete.height = frame->wHeight;
 731                 break;
 732         }
 733
 734         /* Frame interval enumeration */
 735         case VIDIOC_ENUM_FRAMEINTERVALS:
 736         {
 737                 struct v4l2_frmivalenum *fival = arg;
 738                 struct uvc_format *format = NULL;
 739                 struct uvc_frame *frame = NULL;
 740                 int i;
 741
 742                 /* Look for the given pixel format and frame size */
 743                 for (i = 0; i < video->streaming->nformats; i++) {
 744                         if (video->streaming->format[i].fcc ==
 745                                         fival->pixel_format) {
 746                                 format = &video->streaming->format[i];
 747                                 break;
 748                         }
 749                 }
 750                 if (format == NULL)
 751                         return -EINVAL;
 752
 753                 for (i = 0; i < format->nframes; i++) {
 754                         if (format->frame[i].wWidth == fival->width &&
 755                             format->frame[i].wHeight == fival->height) {
 756                                 frame = &format->frame[i];
 757                                 break;
 758                         }
 759                 }
 760                 if (frame == NULL)
 761                         return -EINVAL;
 762
 763                 if (frame->bFrameIntervalType) {
 764                         if (fival->index >= frame->bFrameIntervalType)
 765                                 return -EINVAL;
 766
 767                         fival->type = V4L2_FRMIVAL_TYPE_DISCRETE;
 768                         fival->discrete.numerator =
 769                                 frame->dwFrameInterval[fival->index];
 770                         fival->discrete.denominator = 10000000;
 771                         uvc_simplify_fraction(&fival->discrete.numerator,
 772                                 &fival->discrete.denominator, 8, 333);
 773                 } else {
 774                         fival->type = V4L2_FRMIVAL_TYPE_STEPWISE;
 775                         fival->stepwise.min.numerator =
 776                                 frame->dwFrameInterval[0];
 777                         fival->stepwise.min.denominator = 10000000;
 778                         fival->stepwise.max.numerator =
 779                                 frame->dwFrameInterval[1];
 780                         fival->stepwise.max.denominator = 10000000;
 781                         fival->stepwise.step.numerator =
 782                                 frame->dwFrameInterval[2];
 783                         fival->stepwise.step.denominator = 10000000;
 784                         uvc_simplify_fraction(&fival->stepwise.min.numerator,
 785                                 &fival->stepwise.min.denominator, 8, 333);
 786                         uvc_simplify_fraction(&fival->stepwise.max.numerator,
 787                                 &fival->stepwise.max.denominator, 8, 333);
 788                         uvc_simplify_fraction(&fival->stepwise.step.numerator,
 789                                 &fival->stepwise.step.denominator, 8, 333);
 790                 }
 791                 break;
 792         }
 793
 794         /* Get & Set streaming parameters */
 795         case VIDIOC_G_PARM:
 796                 return uvc_v4l2_get_streamparm(video, arg);
 797
 798         case VIDIOC_S_PARM:
 799                 if ((ret = uvc_acquire_privileges(handle)) < 0)
 800                         return ret;
 801
 802                 return uvc_v4l2_set_streamparm(video, arg);
 803
 804         /* Cropping and scaling */
 805         case VIDIOC_CROPCAP:
 806         {
 807                 struct v4l2_cropcap *ccap = arg;
 808                 struct uvc_frame *frame = video->streaming->cur_frame;
 809
 810                 if (ccap->type != V4L2_BUF_TYPE_VIDEO_CAPTURE)
 811                         return -EINVAL;
 812
 813                 ccap->bounds.left = 0;
 814                 ccap->bounds.top = 0;
 815                 ccap->bounds.width = frame->wWidth;
 816                 ccap->bounds.height = frame->wHeight;
 817
 818                 ccap->defrect = ccap->bounds;
 819
 820                 ccap->pixelaspect.numerator = 1;
 821                 ccap->pixelaspect.denominator = 1;
 822                 break;
 823         }
 824
 825         case VIDIOC_G_CROP:
 826         case VIDIOC_S_CROP:
 827                 return -EINVAL;
 828
 829         /* Buffers & streaming */
 830         case VIDIOC_REQBUFS:
 831         {
 832                 struct v4l2_requestbuffers *rb = arg;
 833                 unsigned int bufsize =
 834                         video->streaming->ctrl.dwMaxVideoFrameSize;
 835
 836                 if (rb->type != V4L2_BUF_TYPE_VIDEO_CAPTURE ||
 837                     rb->memory != V4L2_MEMORY_MMAP)
 838                         return -EINVAL;
 839
 840                 if ((ret = uvc_acquire_privileges(handle)) < 0)
 841                         return ret;
 842
 843                 ret = uvc_alloc_buffers(&video->queue, rb->count, bufsize);
 844                 if (ret < 0)
 845                         return ret;
 846
 847                 if (!(video->streaming->cur_format->flags &
 848                     UVC_FMT_FLAG_COMPRESSED))
 849                         video->queue.flags |= UVC_QUEUE_DROP_INCOMPLETE;
 850
 851                 rb->count = ret;
 852                 ret = 0;
 853                 break;
 854         }
 855
 856         case VIDIOC_QUERYBUF:
 857         {
 858                 struct v4l2_buffer *buf = arg;
 859
 860                 if (buf->type != V4L2_BUF_TYPE_VIDEO_CAPTURE)
 861                         return -EINVAL;
 862
 863                 if (!uvc_has_privileges(handle))
 864                         return -EBUSY;
 865
 866                 return uvc_query_buffer(&video->queue, buf);
 867         }
 868
 869         case VIDIOC_QBUF:
 870                 if (!uvc_has_privileges(handle))
 871                         return -EBUSY;
 872
 873                 return uvc_queue_buffer(&video->queue, arg);
 874
 875         case VIDIOC_DQBUF:
 876                 if (!uvc_has_privileges(handle))
 877                         return -EBUSY;
 878
 879                 return uvc_dequeue_buffer(&video->queue, arg,
 880                         file->f_flags & O_NONBLOCK);
 881
 882         case VIDIOC_STREAMON:
 883         {
 884                 int *type = arg;
 885
 886                 if (*type != V4L2_BUF_TYPE_VIDEO_CAPTURE)
 887                         return -EINVAL;
 888
 889                 if (!uvc_has_privileges(handle))
 890                         return -EBUSY;
 891
 892                 if ((ret = uvc_video_enable(video, 1)) < 0)
 893                         return ret;
 894                 break;
 895         }
 896
 897         case VIDIOC_STREAMOFF:
 898         {
 899                 int *type = arg;
 900
 901                 if (*type != V4L2_BUF_TYPE_VIDEO_CAPTURE)
 902                         return -EINVAL;
 903
 904                 if (!uvc_has_privileges(handle))
 905                         return -EBUSY;
 906
 907                 return uvc_video_enable(video, 0);
 908         }
 909
 910         /* Analog video standards make no sense for digital cameras. */
 911         case VIDIOC_ENUMSTD:
 912         case VIDIOC_QUERYSTD:
 913         case VIDIOC_G_STD:
 914         case VIDIOC_S_STD:
 915
 916         case VIDIOC_OVERLAY:
 917
 918         case VIDIOC_ENUMAUDIO:
 919         case VIDIOC_ENUMAUDOUT:
 920
 921         case VIDIOC_ENUMOUTPUT:
 922                 uvc_trace(UVC_TRACE_IOCTL, "Unsupported ioctl 0x%08x\n", cmd);
 923                 return -EINVAL;
 924
 925         /* Dynamic controls. */
 926         case UVCIOC_CTRL_ADD:
 927         {
 928                 struct uvc_xu_control_info *xinfo = arg;
 929                 struct uvc_control_info *info;
 930
 931                 if (!capable(CAP_SYS_ADMIN))
 932                         return -EPERM;
 933
 934                 info = kmalloc(sizeof *info, GFP_KERNEL);
 935                 if (info == NULL)
 936                         return -ENOMEM;
 937
 938                 memcpy(info->entity, xinfo->entity, sizeof info->entity);
 939                 info->index = xinfo->index;
 940                 info->selector = xinfo->selector;
 941                 info->size = xinfo->size;
 942                 info->flags = xinfo->flags;
 943
 944                 info->flags |= UVC_CONTROL_GET_MIN | UVC_CONTROL_GET_MAX |
 945                                 UVC_CONTROL_GET_RES | UVC_CONTROL_GET_DEF;
 946
 947                 ret = uvc_ctrl_add_info(info);
 948                 if (ret < 0)
 949                         kfree(info);
 950                 break;
 951         }
 952
 953         case UVCIOC_CTRL_MAP:
 954         {
 955                 struct uvc_xu_control_mapping *xmap = arg;
 956                 struct uvc_control_mapping *map;
 957
 958                 if (!capable(CAP_SYS_ADMIN))
 959                         return -EPERM;
 960
 961                 map = kmalloc(sizeof *map, GFP_KERNEL);
 962                 if (map == NULL)
 963                         return -ENOMEM;
 964
 965                 map->id = xmap->id;
 966                 memcpy(map->name, xmap->name, sizeof map->name);
 967                 memcpy(map->entity, xmap->entity, sizeof map->entity);
 968                 map->selector = xmap->selector;
 969                 map->size = xmap->size;
 970                 map->offset = xmap->offset;
 971                 map->v4l2_type = xmap->v4l2_type;
 972                 map->data_type = xmap->data_type;
 973
 974                 ret = uvc_ctrl_add_mapping(map);
 975                 if (ret < 0)
 976                         kfree(map);
 977                 break;
 978         }
 979
 980         case UVCIOC_CTRL_GET:
 981                 return uvc_xu_ctrl_query(video, arg, 0);
 982
 983         case UVCIOC_CTRL_SET:
 984                 return uvc_xu_ctrl_query(video, arg, 1);
 985
 986         default:
 987                 if ((ret = v4l_compat_translate_ioctl(inode, file, cmd, arg,
 988                         uvc_v4l2_do_ioctl)) == -ENOIOCTLCMD)
 989                         uvc_trace(UVC_TRACE_IOCTL, "Unknown ioctl 0x%08x\n",
 990                                   cmd);
 991                 return ret;
 992         }
 993
 994         return ret;
 995 }
 996
 997 static int uvc_v4l2_ioctl(struct inode *inode, struct file *file,
 998                      unsigned int cmd, unsigned long arg)
 999 {
1000         uvc_trace(UVC_TRACE_CALLS, "uvc_v4l2_ioctl\n");
1001         return video_usercopy(inode, file, cmd, arg, uvc_v4l2_do_ioctl);
1002 }
1003
1004 static ssize_t uvc_v4l2_read(struct file *file, char __user *data,
1005                     size_t count, loff_t *ppos)
1006 {
1007         uvc_trace(UVC_TRACE_CALLS, "uvc_v4l2_read: not implemented.\n");
1008         return -ENODEV;
1009 }
1010
1011 /*
1012  * VMA operations.
1013  */
1014 static void uvc_vm_open(struct vm_area_struct *vma)
1015 {
1016         struct uvc_buffer *buffer = vma->vm_private_data;
1017         buffer->vma_use_count++;
1018 }
1019
1020 static void uvc_vm_close(struct vm_area_struct *vma)
1021 {
1022         struct uvc_buffer *buffer = vma->vm_private_data;
1023         buffer->vma_use_count--;
1024 }
1025
1026 static struct vm_operations_struct uvc_vm_ops = {
1027         .open           = uvc_vm_open,
1028         .close          = uvc_vm_close,
1029 };
1030
1031 static int uvc_v4l2_mmap(struct file *file, struct vm_area_struct *vma)
1032 {
1033         struct video_device *vdev = video_devdata(file);
1034         struct uvc_video_device *video = video_get_drvdata(vdev);
1035         struct uvc_buffer *buffer;
1036         struct page *page;
1037         unsigned long addr, start, size;
1038         unsigned int i;
1039         int ret = 0;
1040
1041         uvc_trace(UVC_TRACE_CALLS, "uvc_v4l2_mmap\n");
1042
1043         start = vma->vm_start;
1044         size = vma->vm_end - vma->vm_start;
1045
1046         mutex_lock(&video->queue.mutex);
1047
1048         for (i = 0; i < video->queue.count; ++i) {
1049                 buffer = &video->queue.buffer[i];
1050                 if ((buffer->buf.m.offset >> PAGE_SHIFT) == vma->vm_pgoff)
1051                         break;
1052         }
1053
1054         if (i == video->queue.count || size != video->queue.buf_size) {
1055                 ret = -EINVAL;
1056                 goto done;
1057         }
1058
1059         /*
1060          * VM_IO marks the area as being an mmaped region for I/O to a
1061          * device. It also prevents the region from being core dumped.
1062          */
1063         vma->vm_flags |= VM_IO;
1064
1065         addr = (unsigned long)video->queue.mem + buffer->buf.m.offset;
1066         while (size > 0) {
1067                 page = vmalloc_to_page((void *)addr);
1068                 if ((ret = vm_insert_page(vma, start, page)) < 0)
1069                         goto done;
1070
1071                 start += PAGE_SIZE;
1072                 addr += PAGE_SIZE;
1073                 size -= PAGE_SIZE;
1074         }
1075
1076         vma->vm_ops = &uvc_vm_ops;
1077         vma->vm_private_data = buffer;
1078         uvc_vm_open(vma);
1079
1080 done:
1081         mutex_unlock(&video->queue.mutex);
1082         return ret;
1083 }
1084
1085 static unsigned int uvc_v4l2_poll(struct file *file, poll_table *wait)
1086 {
1087         struct video_device *vdev = video_devdata(file);
1088         struct uvc_video_device *video = video_get_drvdata(vdev);
1089
1090         uvc_trace(UVC_TRACE_CALLS, "uvc_v4l2_poll\n");
1091
1092         return uvc_queue_poll(&video->queue, file, wait);
1093 }
1094
1095 struct file_operations uvc_fops = {
1096         .owner          = THIS_MODULE,
1097         .open           = uvc_v4l2_open,
1098         .release        = uvc_v4l2_release,
1099         .ioctl          = uvc_v4l2_ioctl,
1100         .compat_ioctl   = v4l_compat_ioctl32,
1101         .llseek         = no_llseek,
1102         .read           = uvc_v4l2_read,
1103         .mmap           = uvc_v4l2_mmap,
1104         .poll           = uvc_v4l2_poll,
1105 };