/* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */

[0] Fix | Delete

#ifndef __LINUX_UVCVIDEO_H_

[1] Fix | Delete

#define __LINUX_UVCVIDEO_H_

[2] Fix | Delete

[3] Fix | Delete

#include <linux/ioctl.h>

[4] Fix | Delete

#include <linux/types.h>

[5] Fix | Delete

[6] Fix | Delete

/*

[7] Fix | Delete

* Dynamic controls

[8] Fix | Delete

*/

[9] Fix | Delete

[10] Fix | Delete

/* Data types for UVC control data */

[11] Fix | Delete

#define UVC_CTRL_DATA_TYPE_RAW 0

[12] Fix | Delete

#define UVC_CTRL_DATA_TYPE_SIGNED 1

[13] Fix | Delete

#define UVC_CTRL_DATA_TYPE_UNSIGNED 2

[14] Fix | Delete

#define UVC_CTRL_DATA_TYPE_BOOLEAN 3

[15] Fix | Delete

#define UVC_CTRL_DATA_TYPE_ENUM 4

[16] Fix | Delete

#define UVC_CTRL_DATA_TYPE_BITMASK 5

[17] Fix | Delete

[18] Fix | Delete

/* Control flags */

[19] Fix | Delete

#define UVC_CTRL_FLAG_SET_CUR (1 << 0)

[20] Fix | Delete

#define UVC_CTRL_FLAG_GET_CUR (1 << 1)

[21] Fix | Delete

#define UVC_CTRL_FLAG_GET_MIN (1 << 2)

[22] Fix | Delete

#define UVC_CTRL_FLAG_GET_MAX (1 << 3)

[23] Fix | Delete

#define UVC_CTRL_FLAG_GET_RES (1 << 4)

[24] Fix | Delete

#define UVC_CTRL_FLAG_GET_DEF (1 << 5)

[25] Fix | Delete

/* Control should be saved at suspend and restored at resume. */

[26] Fix | Delete

#define UVC_CTRL_FLAG_RESTORE (1 << 6)

[27] Fix | Delete

/* Control can be updated by the camera. */

[28] Fix | Delete

#define UVC_CTRL_FLAG_AUTO_UPDATE (1 << 7)

[29] Fix | Delete

/* Control supports asynchronous reporting */

[30] Fix | Delete

#define UVC_CTRL_FLAG_ASYNCHRONOUS (1 << 8)

[31] Fix | Delete

[32] Fix | Delete

#define UVC_CTRL_FLAG_GET_RANGE \

[33] Fix | Delete

(UVC_CTRL_FLAG_GET_CUR | UVC_CTRL_FLAG_GET_MIN | \

[34] Fix | Delete

UVC_CTRL_FLAG_GET_MAX | UVC_CTRL_FLAG_GET_RES | \

[35] Fix | Delete

UVC_CTRL_FLAG_GET_DEF)

[36] Fix | Delete

[37] Fix | Delete

#define UVC_MENU_NAME_LEN 32

[38] Fix | Delete

[39] Fix | Delete

struct uvc_menu_info {

[40] Fix | Delete

__u32 value;

[41] Fix | Delete

__u8 name[UVC_MENU_NAME_LEN];

[42] Fix | Delete

};

[43] Fix | Delete

[44] Fix | Delete

struct uvc_xu_control_mapping {

[45] Fix | Delete

__u32 id;

[46] Fix | Delete

__u8 name[32];

[47] Fix | Delete

__u8 entity[16];

[48] Fix | Delete

__u8 selector;

[49] Fix | Delete

[50] Fix | Delete

__u8 size;

[51] Fix | Delete

__u8 offset;

[52] Fix | Delete

__u32 v4l2_type;

[53] Fix | Delete

__u32 data_type;

[54] Fix | Delete

[55] Fix | Delete

struct uvc_menu_info *menu_info;

[56] Fix | Delete

__u32 menu_count;

[57] Fix | Delete

[58] Fix | Delete

__u32 reserved[4];

[59] Fix | Delete

};

[60] Fix | Delete

[61] Fix | Delete

struct uvc_xu_control_query {

[62] Fix | Delete

__u8 unit;

[63] Fix | Delete

__u8 selector;

[64] Fix | Delete

__u8 query; /* Video Class-Specific Request Code, */

[65] Fix | Delete

/* defined in linux/usb/video.h A.8. */

[66] Fix | Delete

__u16 size;

[67] Fix | Delete

__u8 *data;

[68] Fix | Delete

};

[69] Fix | Delete

[70] Fix | Delete

#define UVCIOC_CTRL_MAP _IOWR('u', 0x20, struct uvc_xu_control_mapping)

[71] Fix | Delete

#define UVCIOC_CTRL_QUERY _IOWR('u', 0x21, struct uvc_xu_control_query)

[72] Fix | Delete

[73] Fix | Delete

/*

[74] Fix | Delete

* Metadata node

[75] Fix | Delete

*/

[76] Fix | Delete

[77] Fix | Delete

/**

[78] Fix | Delete

* struct uvc_meta_buf - metadata buffer building block

[79] Fix | Delete

* @ns - system timestamp of the payload in nanoseconds

[80] Fix | Delete

* @sof - USB Frame Number

[81] Fix | Delete

* @length - length of the payload header

[82] Fix | Delete

* @flags - payload header flags

[83] Fix | Delete

* @buf - optional device-specific header data

[84] Fix | Delete

*

[85] Fix | Delete

* UVC metadata nodes fill buffers with possibly multiple instances of this

[86] Fix | Delete

* struct. The first two fields are added by the driver, they can be used for

[87] Fix | Delete

* clock synchronisation. The rest is an exact copy of a UVC payload header.

[88] Fix | Delete

* Only complete objects with complete buffers are included. Therefore it's

[89] Fix | Delete

* always sizeof(meta->ns) + sizeof(meta->sof) + meta->length bytes large.

[90] Fix | Delete

*/

[91] Fix | Delete

struct uvc_meta_buf {

[92] Fix | Delete

__u64 ns;

[93] Fix | Delete

__u16 sof;

[94] Fix | Delete

__u8 length;

[95] Fix | Delete

__u8 flags;

[96] Fix | Delete

__u8 buf[];

[97] Fix | Delete

} __attribute__((packed));

[98] Fix | Delete

[99] Fix | Delete

#endif

[100] Fix | Delete

[101] Fix | Delete