mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git
synced 2024-10-08 17:49:45 +00:00
088ead2552
Some UVC video cameras contain metadata in their payload headers. This patch extracts that data, adding more clock synchronisation information, on both bulk and isochronous endpoints and makes it available to the user space on a separate video node, using the V4L2_CAP_META_CAPTURE capability and the V4L2_BUF_TYPE_META_CAPTURE buffer queue type. By default, only the V4L2_META_FMT_UVC pixel format is available from those nodes. However, cameras can be added to the device ID table to additionally specify their own metadata format, in which case that format will also become available from the metadata node. [Use put_unaligned instead of __put_unaligned_cpu64] [Use put_unaligned for the sof field as well] Signed-off-by: Guennadi Liakhovetski <guennadi.liakhovetski@intel.com> Signed-off-by: Laurent Pinchart <laurent.pinchart@ideasonboard.com> Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
97 lines
2.4 KiB
C
97 lines
2.4 KiB
C
/* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */
|
|
#ifndef __LINUX_UVCVIDEO_H_
|
|
#define __LINUX_UVCVIDEO_H_
|
|
|
|
#include <linux/ioctl.h>
|
|
#include <linux/types.h>
|
|
|
|
/*
|
|
* Dynamic controls
|
|
*/
|
|
|
|
/* Data types for UVC control data */
|
|
#define UVC_CTRL_DATA_TYPE_RAW 0
|
|
#define UVC_CTRL_DATA_TYPE_SIGNED 1
|
|
#define UVC_CTRL_DATA_TYPE_UNSIGNED 2
|
|
#define UVC_CTRL_DATA_TYPE_BOOLEAN 3
|
|
#define UVC_CTRL_DATA_TYPE_ENUM 4
|
|
#define UVC_CTRL_DATA_TYPE_BITMASK 5
|
|
|
|
/* Control flags */
|
|
#define UVC_CTRL_FLAG_SET_CUR (1 << 0)
|
|
#define UVC_CTRL_FLAG_GET_CUR (1 << 1)
|
|
#define UVC_CTRL_FLAG_GET_MIN (1 << 2)
|
|
#define UVC_CTRL_FLAG_GET_MAX (1 << 3)
|
|
#define UVC_CTRL_FLAG_GET_RES (1 << 4)
|
|
#define UVC_CTRL_FLAG_GET_DEF (1 << 5)
|
|
/* Control should be saved at suspend and restored at resume. */
|
|
#define UVC_CTRL_FLAG_RESTORE (1 << 6)
|
|
/* Control can be updated by the camera. */
|
|
#define UVC_CTRL_FLAG_AUTO_UPDATE (1 << 7)
|
|
|
|
#define UVC_CTRL_FLAG_GET_RANGE \
|
|
(UVC_CTRL_FLAG_GET_CUR | UVC_CTRL_FLAG_GET_MIN | \
|
|
UVC_CTRL_FLAG_GET_MAX | UVC_CTRL_FLAG_GET_RES | \
|
|
UVC_CTRL_FLAG_GET_DEF)
|
|
|
|
struct uvc_menu_info {
|
|
__u32 value;
|
|
__u8 name[32];
|
|
};
|
|
|
|
struct uvc_xu_control_mapping {
|
|
__u32 id;
|
|
__u8 name[32];
|
|
__u8 entity[16];
|
|
__u8 selector;
|
|
|
|
__u8 size;
|
|
__u8 offset;
|
|
__u32 v4l2_type;
|
|
__u32 data_type;
|
|
|
|
struct uvc_menu_info __user *menu_info;
|
|
__u32 menu_count;
|
|
|
|
__u32 reserved[4];
|
|
};
|
|
|
|
struct uvc_xu_control_query {
|
|
__u8 unit;
|
|
__u8 selector;
|
|
__u8 query; /* Video Class-Specific Request Code, */
|
|
/* defined in linux/usb/video.h A.8. */
|
|
__u16 size;
|
|
__u8 __user *data;
|
|
};
|
|
|
|
#define UVCIOC_CTRL_MAP _IOWR('u', 0x20, struct uvc_xu_control_mapping)
|
|
#define UVCIOC_CTRL_QUERY _IOWR('u', 0x21, struct uvc_xu_control_query)
|
|
|
|
/*
|
|
* Metadata node
|
|
*/
|
|
|
|
/**
|
|
* struct uvc_meta_buf - metadata buffer building block
|
|
* @ns - system timestamp of the payload in nanoseconds
|
|
* @sof - USB Frame Number
|
|
* @length - length of the payload header
|
|
* @flags - payload header flags
|
|
* @buf - optional device-specific header data
|
|
*
|
|
* UVC metadata nodes fill buffers with possibly multiple instances of this
|
|
* struct. The first two fields are added by the driver, they can be used for
|
|
* clock synchronisation. The rest is an exact copy of a UVC payload header.
|
|
* Only complete objects with complete buffers are included. Therefore it's
|
|
* always sizeof(meta->ts) + sizeof(meta->sof) + meta->length bytes large.
|
|
*/
|
|
struct uvc_meta_buf {
|
|
__u64 ns;
|
|
__u16 sof;
|
|
__u8 length;
|
|
__u8 flags;
|
|
__u8 buf[];
|
|
} __packed;
|
|
|
|
#endif
|