File Index
Files and directories
Sign in
FILE

uvc.h

File preview with syntax highlighting.

linux-6.19.14/include/linux/usb/uvc.h C
  1/* SPDX-License-Identifier: GPL-2.0-or-later */
  2/*
  3 *  v4l2 uvc internal API header
  4 *
  5 *  Some commonly needed functions for uvc drivers
  6 */
  7
  8#ifndef __LINUX_V4L2_UVC_H
  9#define __LINUX_V4L2_UVC_H
 10
 11/* ------------------------------------------------------------------------
 12 * GUIDs
 13 */
 14#define UVC_GUID_UVC_CAMERA \
 15	{0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, \
 16	 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x01}
 17#define UVC_GUID_UVC_OUTPUT \
 18	{0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, \
 19	 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x02}
 20#define UVC_GUID_UVC_MEDIA_TRANSPORT_INPUT \
 21	{0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, \
 22	 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x03}
 23#define UVC_GUID_UVC_PROCESSING \
 24	{0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, \
 25	 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x01, 0x01}
 26#define UVC_GUID_UVC_SELECTOR \
 27	{0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, \
 28	 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x01, 0x02}
 29#define UVC_GUID_EXT_GPIO_CONTROLLER \
 30	{0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, \
 31	 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x01, 0x03}
 32#define UVC_GUID_CHROMEOS_XU \
 33	{0x24, 0xe9, 0xd7, 0x74, 0xc9, 0x49, 0x45, 0x4a, \
 34	 0x98, 0xa3, 0xc8, 0x07, 0x7e, 0x05, 0x1c, 0xa3}
 35#define UVC_GUID_MSXU_1_5 \
 36	{0xdc, 0x95, 0x3f, 0x0f, 0x32, 0x26, 0x4e, 0x4c, \
 37	 0x92, 0xc9, 0xa0, 0x47, 0x82, 0xf4, 0x3b, 0xc8}
 38
 39/* https://learn.microsoft.com/en-us/windows-hardware/drivers/stream/uvc-extensions-1-5#222-extension-unit-controls */
 40#define UVC_MSXU_CONTROL_FOCUS			0x01
 41#define UVC_MSXU_CONTROL_EXPOSURE		0x02
 42#define UVC_MSXU_CONTROL_EVCOMPENSATION		0x03
 43#define UVC_MSXU_CONTROL_WHITEBALANCE		0x04
 44#define UVC_MSXU_CONTROL_FACE_AUTHENTICATION	0x06
 45#define UVC_MSXU_CONTROL_CAMERA_EXTRINSICS	0x07
 46#define UVC_MSXU_CONTROL_CAMERA_INTRINSICS	0x08
 47#define UVC_MSXU_CONTROL_METADATA		0x09
 48#define UVC_MSXU_CONTROL_IR_TORCH		0x0a
 49#define UVC_MSXU_CONTROL_DIGITALWINDOW		0x0b
 50#define UVC_MSXU_CONTROL_DIGITALWINDOW_CONFIG	0x0c
 51#define UVC_MSXU_CONTROL_VIDEO_HDR		0x0d
 52#define UVC_MSXU_CONTROL_FRAMERATE_THROTTLE	0x0e
 53#define UVC_MSXU_CONTROL_FIELDOFVIEW2_CONFIG	0x0f
 54#define UVC_MSXU_CONTROL_FIELDOFVIEW2		0x10
 55
 56#define UVC_CROSXU_CONTROL_IQ_PROFILE		0x04
 57
 58#define UVC_GUID_FORMAT_MJPEG \
 59	{ 'M',  'J',  'P',  'G', 0x00, 0x00, 0x10, 0x00, \
 60	 0x80, 0x00, 0x00, 0xaa, 0x00, 0x38, 0x9b, 0x71}
 61#define UVC_GUID_FORMAT_YUY2 \
 62	{ 'Y',  'U',  'Y',  '2', 0x00, 0x00, 0x10, 0x00, \
 63	 0x80, 0x00, 0x00, 0xaa, 0x00, 0x38, 0x9b, 0x71}
 64#define UVC_GUID_FORMAT_YUY2_ISIGHT \
 65	{ 'Y',  'U',  'Y',  '2', 0x00, 0x00, 0x10, 0x00, \
 66	 0x80, 0x00, 0x00, 0x00, 0x00, 0x38, 0x9b, 0x71}
 67#define UVC_GUID_FORMAT_NV12 \
 68	{ 'N',  'V',  '1',  '2', 0x00, 0x00, 0x10, 0x00, \
 69	 0x80, 0x00, 0x00, 0xaa, 0x00, 0x38, 0x9b, 0x71}
 70#define UVC_GUID_FORMAT_YV12 \
 71	{ 'Y',  'V',  '1',  '2', 0x00, 0x00, 0x10, 0x00, \
 72	 0x80, 0x00, 0x00, 0xaa, 0x00, 0x38, 0x9b, 0x71}
 73#define UVC_GUID_FORMAT_I420 \
 74	{ 'I',  '4',  '2',  '0', 0x00, 0x00, 0x10, 0x00, \
 75	 0x80, 0x00, 0x00, 0xaa, 0x00, 0x38, 0x9b, 0x71}
 76#define UVC_GUID_FORMAT_UYVY \
 77	{ 'U',  'Y',  'V',  'Y', 0x00, 0x00, 0x10, 0x00, \
 78	 0x80, 0x00, 0x00, 0xaa, 0x00, 0x38, 0x9b, 0x71}
 79#define UVC_GUID_FORMAT_Y800 \
 80	{ 'Y',  '8',  '0',  '0', 0x00, 0x00, 0x10, 0x00, \
 81	 0x80, 0x00, 0x00, 0xaa, 0x00, 0x38, 0x9b, 0x71}
 82#define UVC_GUID_FORMAT_Y8 \
 83	{ 'Y',  '8',  ' ',  ' ', 0x00, 0x00, 0x10, 0x00, \
 84	 0x80, 0x00, 0x00, 0xaa, 0x00, 0x38, 0x9b, 0x71}
 85#define UVC_GUID_FORMAT_Y10 \
 86	{ 'Y',  '1',  '0',  ' ', 0x00, 0x00, 0x10, 0x00, \
 87	 0x80, 0x00, 0x00, 0xaa, 0x00, 0x38, 0x9b, 0x71}
 88#define UVC_GUID_FORMAT_Y12 \
 89	{ 'Y',  '1',  '2',  ' ', 0x00, 0x00, 0x10, 0x00, \
 90	 0x80, 0x00, 0x00, 0xaa, 0x00, 0x38, 0x9b, 0x71}
 91#define UVC_GUID_FORMAT_Y16 \
 92	{ 'Y',  '1',  '6',  ' ', 0x00, 0x00, 0x10, 0x00, \
 93	 0x80, 0x00, 0x00, 0xaa, 0x00, 0x38, 0x9b, 0x71}
 94#define UVC_GUID_FORMAT_BY8 \
 95	{ 'B',  'Y',  '8',  ' ', 0x00, 0x00, 0x10, 0x00, \
 96	 0x80, 0x00, 0x00, 0xaa, 0x00, 0x38, 0x9b, 0x71}
 97#define UVC_GUID_FORMAT_BA81 \
 98	{ 'B',  'A',  '8',  '1', 0x00, 0x00, 0x10, 0x00, \
 99	 0x80, 0x00, 0x00, 0xaa, 0x00, 0x38, 0x9b, 0x71}
100#define UVC_GUID_FORMAT_GBRG \
101	{ 'G',  'B',  'R',  'G', 0x00, 0x00, 0x10, 0x00, \
102	 0x80, 0x00, 0x00, 0xaa, 0x00, 0x38, 0x9b, 0x71}
103#define UVC_GUID_FORMAT_GRBG \
104	{ 'G',  'R',  'B',  'G', 0x00, 0x00, 0x10, 0x00, \
105	 0x80, 0x00, 0x00, 0xaa, 0x00, 0x38, 0x9b, 0x71}
106#define UVC_GUID_FORMAT_RGGB \
107	{ 'R',  'G',  'G',  'B', 0x00, 0x00, 0x10, 0x00, \
108	 0x80, 0x00, 0x00, 0xaa, 0x00, 0x38, 0x9b, 0x71}
109#define UVC_GUID_FORMAT_BG16 \
110	{ 'B',  'G',  '1',  '6', 0x00, 0x00, 0x10, 0x00, \
111	 0x80, 0x00, 0x00, 0xaa, 0x00, 0x38, 0x9b, 0x71}
112#define UVC_GUID_FORMAT_GB16 \
113	{ 'G',  'B',  '1',  '6', 0x00, 0x00, 0x10, 0x00, \
114	 0x80, 0x00, 0x00, 0xaa, 0x00, 0x38, 0x9b, 0x71}
115#define UVC_GUID_FORMAT_RG16 \
116	{ 'R',  'G',  '1',  '6', 0x00, 0x00, 0x10, 0x00, \
117	 0x80, 0x00, 0x00, 0xaa, 0x00, 0x38, 0x9b, 0x71}
118#define UVC_GUID_FORMAT_GR16 \
119	{ 'G',  'R',  '1',  '6', 0x00, 0x00, 0x10, 0x00, \
120	 0x80, 0x00, 0x00, 0xaa, 0x00, 0x38, 0x9b, 0x71}
121#define UVC_GUID_FORMAT_RGBP \
122	{ 'R',  'G',  'B',  'P', 0x00, 0x00, 0x10, 0x00, \
123	 0x80, 0x00, 0x00, 0xaa, 0x00, 0x38, 0x9b, 0x71}
124#define UVC_GUID_FORMAT_BGR3 \
125	{ 0x7d, 0xeb, 0x36, 0xe4, 0x4f, 0x52, 0xce, 0x11, \
126	 0x9f, 0x53, 0x00, 0x20, 0xaf, 0x0b, 0xa7, 0x70}
127#define UVC_GUID_FORMAT_BGR4 \
128	{ 0x7e, 0xeb, 0x36, 0xe4, 0x4f, 0x52, 0xce, 0x11, \
129	 0x9f, 0x53, 0x00, 0x20, 0xaf, 0x0b, 0xa7, 0x70}
130#define UVC_GUID_FORMAT_M420 \
131	{ 'M',  '4',  '2',  '0', 0x00, 0x00, 0x10, 0x00, \
132	 0x80, 0x00, 0x00, 0xaa, 0x00, 0x38, 0x9b, 0x71}
133
134#define UVC_GUID_FORMAT_H264 \
135	{ 'H',  '2',  '6',  '4', 0x00, 0x00, 0x10, 0x00, \
136	 0x80, 0x00, 0x00, 0xaa, 0x00, 0x38, 0x9b, 0x71}
137#define UVC_GUID_FORMAT_H265 \
138	{ 'H',  '2',  '6',  '5', 0x00, 0x00, 0x10, 0x00, \
139	 0x80, 0x00, 0x00, 0xaa, 0x00, 0x38, 0x9b, 0x71}
140#define UVC_GUID_FORMAT_Y8I \
141	{ 'Y',  '8',  'I',  ' ', 0x00, 0x00, 0x10, 0x00, \
142	 0x80, 0x00, 0x00, 0xaa, 0x00, 0x38, 0x9b, 0x71}
143#define UVC_GUID_FORMAT_Y12I \
144	{ 'Y',  '1',  '2',  'I', 0x00, 0x00, 0x10, 0x00, \
145	 0x80, 0x00, 0x00, 0xaa, 0x00, 0x38, 0x9b, 0x71}
146#define UVC_GUID_FORMAT_Y16I \
147	{ 'Y',  '1',  '6',  'I', 0x00, 0x00, 0x10, 0x00, \
148	 0x80, 0x00, 0x00, 0xaa, 0x00, 0x38, 0x9b, 0x71}
149#define UVC_GUID_FORMAT_Z16 \
150	{ 'Z',  '1',  '6',  ' ', 0x00, 0x00, 0x10, 0x00, \
151	 0x80, 0x00, 0x00, 0xaa, 0x00, 0x38, 0x9b, 0x71}
152#define UVC_GUID_FORMAT_RW10 \
153	{ 'R',  'W',  '1',  '0', 0x00, 0x00, 0x10, 0x00, \
154	 0x80, 0x00, 0x00, 0xaa, 0x00, 0x38, 0x9b, 0x71}
155#define UVC_GUID_FORMAT_INVZ \
156	{ 'I',  'N',  'V',  'Z', 0x90, 0x2d, 0x58, 0x4a, \
157	 0x92, 0x0b, 0x77, 0x3f, 0x1f, 0x2c, 0x55, 0x6b}
158#define UVC_GUID_FORMAT_INZI \
159	{ 'I',  'N',  'Z',  'I', 0x66, 0x1a, 0x42, 0xa2, \
160	 0x90, 0x65, 0xd0, 0x18, 0x14, 0xa8, 0xef, 0x8a}
161#define UVC_GUID_FORMAT_INVI \
162	{ 'I',  'N',  'V',  'I', 0xdb, 0x57, 0x49, 0x5e, \
163	 0x8e, 0x3f, 0xf4, 0x79, 0x53, 0x2b, 0x94, 0x6f}
164#define UVC_GUID_FORMAT_CNF4 \
165	{ 'C',  ' ',  ' ',  ' ', 0x00, 0x00, 0x10, 0x00, \
166	 0x80, 0x00, 0x00, 0xaa, 0x00, 0x38, 0x9b, 0x71}
167
168#define UVC_GUID_FORMAT_D3DFMT_L8 \
169	{0x32, 0x00, 0x00, 0x00, 0x00, 0x00, 0x10, 0x00, \
170	 0x80, 0x00, 0x00, 0xaa, 0x00, 0x38, 0x9b, 0x71}
171#define UVC_GUID_FORMAT_D3DFMT_R5G6B5 \
172	{0x7b, 0xeb, 0x36, 0xe4, 0x4f, 0x52, 0xce, 0x11, \
173	 0x9f, 0x53, 0x00, 0x20, 0xaf, 0x0b, 0xa7, 0x70}
174#define UVC_GUID_FORMAT_KSMEDIA_L8_IR \
175	{0x32, 0x00, 0x00, 0x00, 0x02, 0x00, 0x10, 0x00, \
176	 0x80, 0x00, 0x00, 0xaa, 0x00, 0x38, 0x9b, 0x71}
177
178#define UVC_GUID_FORMAT_HEVC \
179	{ 'H',  'E',  'V',  'C', 0x00, 0x00, 0x10, 0x00, \
180	 0x80, 0x00, 0x00, 0xaa, 0x00, 0x38, 0x9b, 0x71}
181
182struct uvc_format_desc {
183	u8 guid[16];
184	u32 fcc;
185};
186
187const struct uvc_format_desc *uvc_format_by_guid(const u8 guid[16]);
188
189#endif /* __LINUX_V4L2_UVC_H */
~/ Read-only file preview.