2017-11-01 17:09:13 +03:00
|
|
|
/* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */
|
2010-03-16 02:26:04 +03:00
|
|
|
/*
|
|
|
|
* V4L2 subdev userspace API
|
|
|
|
*
|
|
|
|
* Copyright (C) 2010 Nokia Corporation
|
|
|
|
*
|
|
|
|
* Contacts: Laurent Pinchart <laurent.pinchart@ideasonboard.com>
|
|
|
|
* Sakari Ailus <sakari.ailus@iki.fi>
|
|
|
|
*
|
|
|
|
* This program is free software; you can redistribute it and/or modify
|
|
|
|
* it under the terms of the GNU General Public License version 2 as
|
|
|
|
* published by the Free Software Foundation.
|
|
|
|
*
|
|
|
|
* This program is distributed in the hope that it will be useful,
|
|
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
|
|
* GNU General Public License for more details.
|
|
|
|
*
|
|
|
|
* You should have received a copy of the GNU General Public License
|
|
|
|
* along with this program; if not, write to the Free Software
|
|
|
|
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
|
|
|
|
*/
|
|
|
|
|
|
|
|
#ifndef __LINUX_V4L2_SUBDEV_H
|
|
|
|
#define __LINUX_V4L2_SUBDEV_H
|
|
|
|
|
|
|
|
#include <linux/ioctl.h>
|
|
|
|
#include <linux/types.h>
|
2012-05-18 16:31:18 +04:00
|
|
|
#include <linux/v4l2-common.h>
|
2010-03-16 02:26:04 +03:00
|
|
|
#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 {
|
|
|
|
V4L2_SUBDEV_FORMAT_TRY = 0,
|
|
|
|
V4L2_SUBDEV_FORMAT_ACTIVE = 1,
|
|
|
|
};
|
|
|
|
|
|
|
|
/**
|
|
|
|
* 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)
|
|
|
|
*/
|
|
|
|
struct v4l2_subdev_format {
|
|
|
|
__u32 which;
|
|
|
|
__u32 pad;
|
|
|
|
struct v4l2_mbus_framefmt format;
|
|
|
|
__u32 reserved[8];
|
|
|
|
};
|
|
|
|
|
2010-06-23 12:03:42 +04:00
|
|
|
/**
|
|
|
|
* 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
|
|
|
|
*/
|
|
|
|
struct v4l2_subdev_crop {
|
|
|
|
__u32 which;
|
|
|
|
__u32 pad;
|
|
|
|
struct v4l2_rect rect;
|
|
|
|
__u32 reserved[8];
|
|
|
|
};
|
|
|
|
|
2020-08-27 22:46:10 +03:00
|
|
|
#define V4L2_SUBDEV_MBUS_CODE_CSC_COLORSPACE 0x00000001
|
|
|
|
#define V4L2_SUBDEV_MBUS_CODE_CSC_XFER_FUNC 0x00000002
|
|
|
|
#define V4L2_SUBDEV_MBUS_CODE_CSC_YCBCR_ENC 0x00000004
|
|
|
|
#define V4L2_SUBDEV_MBUS_CODE_CSC_HSV_ENC V4L2_SUBDEV_MBUS_CODE_CSC_YCBCR_ENC
|
|
|
|
#define V4L2_SUBDEV_MBUS_CODE_CSC_QUANTIZATION 0x00000008
|
|
|
|
|
2010-03-16 02:26:04 +03:00
|
|
|
/**
|
|
|
|
* struct v4l2_subdev_mbus_code_enum - Media bus format enumeration
|
|
|
|
* @pad: pad number, as reported by the media API
|
|
|
|
* @index: format index during enumeration
|
2014-11-10 20:28:28 +03:00
|
|
|
* @code: format code (MEDIA_BUS_FMT_ definitions)
|
2015-03-04 12:47:55 +03:00
|
|
|
* @which: format type (from enum v4l2_subdev_format_whence)
|
2020-08-27 22:46:10 +03:00
|
|
|
* @flags: flags set by the driver, (V4L2_SUBDEV_MBUS_CODE_*)
|
2010-03-16 02:26:04 +03:00
|
|
|
*/
|
|
|
|
struct v4l2_subdev_mbus_code_enum {
|
|
|
|
__u32 pad;
|
|
|
|
__u32 index;
|
|
|
|
__u32 code;
|
2015-03-04 12:47:55 +03:00
|
|
|
__u32 which;
|
2020-08-27 22:46:10 +03:00
|
|
|
__u32 flags;
|
|
|
|
__u32 reserved[7];
|
2010-03-16 02:26:04 +03:00
|
|
|
};
|
|
|
|
|
|
|
|
/**
|
|
|
|
* struct v4l2_subdev_frame_size_enum - Media bus format enumeration
|
|
|
|
* @pad: pad number, as reported by the media API
|
|
|
|
* @index: format index during enumeration
|
2014-11-10 20:28:28 +03:00
|
|
|
* @code: format code (MEDIA_BUS_FMT_ definitions)
|
2015-03-04 12:47:55 +03:00
|
|
|
* @which: format type (from enum v4l2_subdev_format_whence)
|
2010-03-16 02:26:04 +03:00
|
|
|
*/
|
|
|
|
struct v4l2_subdev_frame_size_enum {
|
|
|
|
__u32 index;
|
|
|
|
__u32 pad;
|
|
|
|
__u32 code;
|
|
|
|
__u32 min_width;
|
|
|
|
__u32 max_width;
|
|
|
|
__u32 min_height;
|
|
|
|
__u32 max_height;
|
2015-03-04 12:47:55 +03:00
|
|
|
__u32 which;
|
|
|
|
__u32 reserved[8];
|
2010-03-16 02:26:04 +03:00
|
|
|
};
|
|
|
|
|
2010-05-05 18:38:35 +04:00
|
|
|
/**
|
|
|
|
* struct v4l2_subdev_frame_interval - Pad-level frame rate
|
|
|
|
* @pad: pad number, as reported by the media API
|
|
|
|
* @interval: frame interval in seconds
|
|
|
|
*/
|
|
|
|
struct v4l2_subdev_frame_interval {
|
|
|
|
__u32 pad;
|
|
|
|
struct v4l2_fract interval;
|
|
|
|
__u32 reserved[9];
|
|
|
|
};
|
|
|
|
|
|
|
|
/**
|
|
|
|
* struct v4l2_subdev_frame_interval_enum - Frame interval enumeration
|
|
|
|
* @pad: pad number, as reported by the media API
|
|
|
|
* @index: frame interval index during enumeration
|
2014-11-10 20:28:28 +03:00
|
|
|
* @code: format code (MEDIA_BUS_FMT_ definitions)
|
2010-05-05 18:38:35 +04:00
|
|
|
* @width: frame width in pixels
|
|
|
|
* @height: frame height in pixels
|
|
|
|
* @interval: frame interval in seconds
|
2015-03-04 12:47:55 +03:00
|
|
|
* @which: format type (from enum v4l2_subdev_format_whence)
|
2010-05-05 18:38:35 +04:00
|
|
|
*/
|
|
|
|
struct v4l2_subdev_frame_interval_enum {
|
|
|
|
__u32 index;
|
|
|
|
__u32 pad;
|
|
|
|
__u32 code;
|
|
|
|
__u32 width;
|
|
|
|
__u32 height;
|
|
|
|
struct v4l2_fract interval;
|
2015-03-04 12:47:55 +03:00
|
|
|
__u32 which;
|
|
|
|
__u32 reserved[8];
|
2010-05-05 18:38:35 +04:00
|
|
|
};
|
|
|
|
|
2011-10-14 21:14:26 +04:00
|
|
|
/**
|
|
|
|
* 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
|
2012-05-18 16:31:18 +04:00
|
|
|
* @target: Selection target, used to choose one of possible rectangles,
|
|
|
|
* defined in v4l2-common.h; V4L2_SEL_TGT_* .
|
2012-06-13 23:01:10 +04:00
|
|
|
* @flags: constraint flags, defined in v4l2-common.h; V4L2_SEL_FLAG_*.
|
2011-10-14 21:14:26 +04:00
|
|
|
* @r: coordinates of the selection window
|
|
|
|
* @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 {
|
|
|
|
__u32 which;
|
|
|
|
__u32 pad;
|
|
|
|
__u32 target;
|
|
|
|
__u32 flags;
|
|
|
|
struct v4l2_rect r;
|
|
|
|
__u32 reserved[8];
|
|
|
|
};
|
|
|
|
|
2020-05-07 18:12:52 +03:00
|
|
|
/**
|
|
|
|
* 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 {
|
|
|
|
__u32 version;
|
|
|
|
__u32 capabilities;
|
|
|
|
__u32 reserved[14];
|
|
|
|
};
|
|
|
|
|
|
|
|
/* The v4l2 sub-device video device node is registered in read-only mode. */
|
2021-01-18 18:37:00 +03:00
|
|
|
#define V4L2_SUBDEV_CAP_RO_SUBDEV 0x00000001
|
2020-05-07 18:12:52 +03:00
|
|
|
|
2014-03-04 14:46:47 +04:00
|
|
|
/* Backwards compatibility define --- to be removed */
|
|
|
|
#define v4l2_subdev_edid v4l2_edid
|
2012-07-05 17:58:06 +04:00
|
|
|
|
2020-05-07 18:12:52 +03:00
|
|
|
#define VIDIOC_SUBDEV_QUERYCAP _IOR('V', 0, struct v4l2_subdev_capability)
|
2014-01-29 17:06:13 +04:00
|
|
|
#define VIDIOC_SUBDEV_G_FMT _IOWR('V', 4, struct v4l2_subdev_format)
|
|
|
|
#define VIDIOC_SUBDEV_S_FMT _IOWR('V', 5, struct v4l2_subdev_format)
|
|
|
|
#define VIDIOC_SUBDEV_G_FRAME_INTERVAL _IOWR('V', 21, struct v4l2_subdev_frame_interval)
|
|
|
|
#define VIDIOC_SUBDEV_S_FRAME_INTERVAL _IOWR('V', 22, struct v4l2_subdev_frame_interval)
|
|
|
|
#define VIDIOC_SUBDEV_ENUM_MBUS_CODE _IOWR('V', 2, struct v4l2_subdev_mbus_code_enum)
|
|
|
|
#define VIDIOC_SUBDEV_ENUM_FRAME_SIZE _IOWR('V', 74, struct v4l2_subdev_frame_size_enum)
|
|
|
|
#define VIDIOC_SUBDEV_ENUM_FRAME_INTERVAL _IOWR('V', 75, struct v4l2_subdev_frame_interval_enum)
|
|
|
|
#define VIDIOC_SUBDEV_G_CROP _IOWR('V', 59, struct v4l2_subdev_crop)
|
|
|
|
#define VIDIOC_SUBDEV_S_CROP _IOWR('V', 60, struct v4l2_subdev_crop)
|
|
|
|
#define VIDIOC_SUBDEV_G_SELECTION _IOWR('V', 61, struct v4l2_subdev_selection)
|
|
|
|
#define VIDIOC_SUBDEV_S_SELECTION _IOWR('V', 62, struct v4l2_subdev_selection)
|
2014-01-29 17:07:13 +04:00
|
|
|
/* The following ioctls are identical to the ioctls in videodev2.h */
|
2018-05-17 17:30:16 +03:00
|
|
|
#define VIDIOC_SUBDEV_G_STD _IOR('V', 23, v4l2_std_id)
|
|
|
|
#define VIDIOC_SUBDEV_S_STD _IOW('V', 24, v4l2_std_id)
|
|
|
|
#define VIDIOC_SUBDEV_ENUMSTD _IOWR('V', 25, struct v4l2_standard)
|
2014-01-29 17:06:13 +04:00
|
|
|
#define VIDIOC_SUBDEV_G_EDID _IOWR('V', 40, struct v4l2_edid)
|
|
|
|
#define VIDIOC_SUBDEV_S_EDID _IOWR('V', 41, struct v4l2_edid)
|
2018-05-17 17:30:16 +03:00
|
|
|
#define VIDIOC_SUBDEV_QUERYSTD _IOR('V', 63, v4l2_std_id)
|
2014-01-29 17:07:13 +04:00
|
|
|
#define VIDIOC_SUBDEV_S_DV_TIMINGS _IOWR('V', 87, struct v4l2_dv_timings)
|
|
|
|
#define VIDIOC_SUBDEV_G_DV_TIMINGS _IOWR('V', 88, struct v4l2_dv_timings)
|
|
|
|
#define VIDIOC_SUBDEV_ENUM_DV_TIMINGS _IOWR('V', 98, struct v4l2_enum_dv_timings)
|
|
|
|
#define VIDIOC_SUBDEV_QUERY_DV_TIMINGS _IOR('V', 99, struct v4l2_dv_timings)
|
|
|
|
#define VIDIOC_SUBDEV_DV_TIMINGS_CAP _IOWR('V', 100, struct v4l2_dv_timings_cap)
|
2010-03-16 02:26:04 +03:00
|
|
|
|
|
|
|
#endif
|