Lines Matching +full:application +full:- +full:specific
1 .. SPDX-License-Identifier: GPL-2.0
6 This file documents some driver-specific aspects of the UVC driver, such as
7 driver-specific ioctls and implementation notes.
10 linux-media@vger.kernel.org.
14 ---------------------------
19 The UVC specification allows for vendor-specific extensions through extension
23 - through mappings of XU controls to V4L2 controls
24 - through a driver-specific ioctl interface
30 The second mechanism requires uvcvideo-specific knowledge for the application to
40 The UVC driver provides an API for user space applications to define so-called
57 3. Driver specific XU control interface
61 access XU controls is provided in the form of a driver-specific ioctl, namely
65 directly map to the low-level UVC control requests.
69 hardcoded in the application or queried using other ways such as by parsing the
83 application developers are encouraged to use UVCIOC_CTRL_QUERY instead.
92 The API doesn't currently provide a fine-grained access control facility. The
109 UVCIOC_CTRL_MAP - Map a UVC control to a V4L2 control
118 applications can access vendor-defined UVC control through the V4L2
136 On success 0 is returned. On error -1 is returned and errno is set
152 .. code-block:: none
187 UVCIOC_CTRL_QUERY - Query a UVC XU control
197 correspond to the low-level control requests described in the UVC
225 Data is copied directly from the device without any driver-side
227 including little-endian/big-endian conversion. This is particularly
229 returned as a little-endian 16-bit integer by the device.
233 On success 0 is returned. On error -1 is returned and errno is set
250 .. code-block:: none
261 Driver-specific V4L2 controls
262 -----------------------------
264 The uvcvideo driver implements the following UVC-specific controls:
282 <https://chromium.googlesource.com/chromiumos/platform2/+/refs/heads/release-R121-15699.B/camera/hal/usb/>`
286 This determines which, if any, on-board features should track to the
292 .. flat-table::
293 :header-rows: 0
294 :stub-columns: 0
296 * - ``V4L2_UVC_REGION_OF_INTEREST_AUTO_EXPOSURE``
297 - Setting this bit causes automatic exposure to track the region of
299 * - ``V4L2_UVC_REGION_OF_INTEREST_AUTO_IRIS``
300 - Setting this bit causes automatic iris to track the region of interest
302 * - ``V4L2_UVC_REGION_OF_INTEREST_AUTO_WHITE_BALANCE``
303 - Setting this bit causes automatic white balance to track the region
305 * - ``V4L2_UVC_REGION_OF_INTEREST_AUTO_FOCUS``
306 - Setting this bit causes automatic focus adjustment to track the region
308 * - ``V4L2_UVC_REGION_OF_INTEREST_AUTO_FACE_DETECT``
309 - Setting this bit causes automatic face detection to track the region of
311 * - ``V4L2_UVC_REGION_OF_INTEREST_AUTO_DETECT_AND_TRACK``
312 - Setting this bit enables automatic face detection and tracking. The
315 * - ``V4L2_UVC_REGION_OF_INTEREST_AUTO_IMAGE_STABILIZATION``
316 - Setting this bit enables automatic image stabilization. The
319 * - ``V4L2_UVC_REGION_OF_INTEREST_AUTO_HIGHER_QUALITY``
320 - Setting this bit enables automatically capture the specified region