/* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */ /* * V4L2 subdev userspace API * * Copyright (C) 2010 Nokia Corporation * * Contacts: Laurent Pinchart <[email protected]> * Sakari Ailus <[email protected]> */ #ifndef __LINUX_V4L2_SUBDEV_H #define __LINUX_V4L2_SUBDEV_H #include <linux/const.h> #include <linux/ioctl.h> #include <linux/types.h> #include <linux/v4l2-common.h> #include <linux/v4l2-mediabus.h> /** * enum v4l2_subdev_format_whence - Media bus format type * @V4L2_SUBDEV_FORMAT_TRY: try format, for negotiation only * @V4L2_SUBDEV_FORMAT_ACTIVE: active format, applied to the device */ enum v4l2_subdev_format_whence { … }; /** * struct v4l2_subdev_format - Pad-level media bus format * @which: format type (from enum v4l2_subdev_format_whence) * @pad: pad number, as reported by the media API * @format: media bus format (format code and frame size) * @stream: stream number, defined in subdev routing * @reserved: drivers and applications must zero this array */ struct v4l2_subdev_format { … }; /** * struct v4l2_subdev_crop - Pad-level crop settings * @which: format type (from enum v4l2_subdev_format_whence) * @pad: pad number, as reported by the media API * @rect: pad crop rectangle boundaries * @stream: stream number, defined in subdev routing * @reserved: drivers and applications must zero this array * * The subdev crop API is an obsolete interface and may be removed in the * future. It is superseded by the selection API. No new extensions to this * structure will be accepted. */ struct v4l2_subdev_crop { … }; #define V4L2_SUBDEV_MBUS_CODE_CSC_COLORSPACE … #define V4L2_SUBDEV_MBUS_CODE_CSC_XFER_FUNC … #define V4L2_SUBDEV_MBUS_CODE_CSC_YCBCR_ENC … #define V4L2_SUBDEV_MBUS_CODE_CSC_HSV_ENC … #define V4L2_SUBDEV_MBUS_CODE_CSC_QUANTIZATION … /** * struct v4l2_subdev_mbus_code_enum - Media bus format enumeration * @pad: pad number, as reported by the media API * @index: format index during enumeration * @code: format code (MEDIA_BUS_FMT_ definitions) * @which: format type (from enum v4l2_subdev_format_whence) * @flags: flags set by the driver, (V4L2_SUBDEV_MBUS_CODE_*) * @stream: stream number, defined in subdev routing * @reserved: drivers and applications must zero this array */ struct v4l2_subdev_mbus_code_enum { … }; /** * struct v4l2_subdev_frame_size_enum - Media bus format enumeration * @index: format index during enumeration * @pad: pad number, as reported by the media API * @code: format code (MEDIA_BUS_FMT_ definitions) * @min_width: minimum frame width, in pixels * @max_width: maximum frame width, in pixels * @min_height: minimum frame height, in pixels * @max_height: maximum frame height, in pixels * @which: format type (from enum v4l2_subdev_format_whence) * @stream: stream number, defined in subdev routing * @reserved: drivers and applications must zero this array */ struct v4l2_subdev_frame_size_enum { … }; /** * struct v4l2_subdev_frame_interval - Pad-level frame rate * @pad: pad number, as reported by the media API * @interval: frame interval in seconds * @stream: stream number, defined in subdev routing * @which: interval type (from enum v4l2_subdev_format_whence) * @reserved: drivers and applications must zero this array */ struct v4l2_subdev_frame_interval { … }; /** * struct v4l2_subdev_frame_interval_enum - Frame interval enumeration * @pad: pad number, as reported by the media API * @index: frame interval index during enumeration * @code: format code (MEDIA_BUS_FMT_ definitions) * @width: frame width in pixels * @height: frame height in pixels * @interval: frame interval in seconds * @which: interval type (from enum v4l2_subdev_format_whence) * @stream: stream number, defined in subdev routing * @reserved: drivers and applications must zero this array */ struct v4l2_subdev_frame_interval_enum { … }; /** * struct v4l2_subdev_selection - selection info * * @which: either V4L2_SUBDEV_FORMAT_ACTIVE or V4L2_SUBDEV_FORMAT_TRY * @pad: pad number, as reported by the media API * @target: Selection target, used to choose one of possible rectangles, * defined in v4l2-common.h; V4L2_SEL_TGT_* . * @flags: constraint flags, defined in v4l2-common.h; V4L2_SEL_FLAG_*. * @r: coordinates of the selection window * @stream: stream number, defined in subdev routing * @reserved: for future use, set to zero for now * * Hardware may use multiple helper windows to process a video stream. * The structure is used to exchange this selection areas between * an application and a driver. */ struct v4l2_subdev_selection { … }; /** * struct v4l2_subdev_capability - subdev capabilities * @version: the driver versioning number * @capabilities: the subdev capabilities, see V4L2_SUBDEV_CAP_* * @reserved: for future use, set to zero for now */ struct v4l2_subdev_capability { … }; /* The v4l2 sub-device video device node is registered in read-only mode. */ #define V4L2_SUBDEV_CAP_RO_SUBDEV … /* The v4l2 sub-device supports routing and multiplexed streams. */ #define V4L2_SUBDEV_CAP_STREAMS … /* * Is the route active? An active route will start when streaming is enabled * on a video node. */ #define V4L2_SUBDEV_ROUTE_FL_ACTIVE … /** * struct v4l2_subdev_route - A route inside a subdev * * @sink_pad: the sink pad index * @sink_stream: the sink stream identifier * @source_pad: the source pad index * @source_stream: the source stream identifier * @flags: route flags V4L2_SUBDEV_ROUTE_FL_* * @reserved: drivers and applications must zero this array */ struct v4l2_subdev_route { … }; /** * struct v4l2_subdev_routing - Subdev routing information * * @which: configuration type (from enum v4l2_subdev_format_whence) * @len_routes: the length of the routes array, in routes; set by the user, not * modified by the kernel * @routes: pointer to the routes array * @num_routes: the total number of routes, possibly more than fits in the * routes array * @reserved: drivers and applications must zero this array */ struct v4l2_subdev_routing { … }; /* * The client is aware of streams. Setting this flag enables the use of 'stream' * fields (referring to the stream number) with various ioctls. If this is not * set (which is the default), the 'stream' fields will be forced to 0 by the * kernel. */ #define V4L2_SUBDEV_CLIENT_CAP_STREAMS … /* * The client is aware of the struct v4l2_subdev_frame_interval which field. If * this is not set (which is the default), the which field is forced to * V4L2_SUBDEV_FORMAT_ACTIVE by the kernel. */ #define V4L2_SUBDEV_CLIENT_CAP_INTERVAL_USES_WHICH … /** * struct v4l2_subdev_client_capability - Capabilities of the client accessing * the subdev * * @capabilities: A bitmask of V4L2_SUBDEV_CLIENT_CAP_* flags. */ struct v4l2_subdev_client_capability { … }; /* Backwards compatibility define --- to be removed */ #define v4l2_subdev_edid … #define VIDIOC_SUBDEV_QUERYCAP … #define VIDIOC_SUBDEV_G_FMT … #define VIDIOC_SUBDEV_S_FMT … #define VIDIOC_SUBDEV_G_FRAME_INTERVAL … #define VIDIOC_SUBDEV_S_FRAME_INTERVAL … #define VIDIOC_SUBDEV_ENUM_MBUS_CODE … #define VIDIOC_SUBDEV_ENUM_FRAME_SIZE … #define VIDIOC_SUBDEV_ENUM_FRAME_INTERVAL … #define VIDIOC_SUBDEV_G_CROP … #define VIDIOC_SUBDEV_S_CROP … #define VIDIOC_SUBDEV_G_SELECTION … #define VIDIOC_SUBDEV_S_SELECTION … #define VIDIOC_SUBDEV_G_ROUTING … #define VIDIOC_SUBDEV_S_ROUTING … #define VIDIOC_SUBDEV_G_CLIENT_CAP … #define VIDIOC_SUBDEV_S_CLIENT_CAP … /* The following ioctls are identical to the ioctls in videodev2.h */ #define VIDIOC_SUBDEV_G_STD … #define VIDIOC_SUBDEV_S_STD … #define VIDIOC_SUBDEV_ENUMSTD … #define VIDIOC_SUBDEV_G_EDID … #define VIDIOC_SUBDEV_S_EDID … #define VIDIOC_SUBDEV_QUERYSTD … #define VIDIOC_SUBDEV_S_DV_TIMINGS … #define VIDIOC_SUBDEV_G_DV_TIMINGS … #define VIDIOC_SUBDEV_ENUM_DV_TIMINGS … #define VIDIOC_SUBDEV_QUERY_DV_TIMINGS … #define VIDIOC_SUBDEV_DV_TIMINGS_CAP … #endif
Codebase Browser
linux