uvc_v4l2.c 27 KB

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