• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 /*
2  * USB Video Class definitions.
3  *
4  * Copyright (C) 2009 Laurent Pinchart <laurent.pinchart@skynet.be>
5  *
6  * This file holds USB constants and structures defined by the USB Device
7  * Class Definition for Video Devices. Unless otherwise stated, comments
8  * below reference relevant sections of the USB Video Class 1.1 specification
9  * available at
10  *
11  * http://www.usb.org/developers/devclass_docs/USB_Video_Class_1_1.zip
12  */
13 
14 #ifndef __LINUX_USB_VIDEO_H
15 #define __LINUX_USB_VIDEO_H
16 
17 #include <linux/types.h>
18 
19 /* --------------------------------------------------------------------------
20  * UVC constants
21  */
22 
23 /* A.2. Video Interface Subclass Codes */
24 #define UVC_SC_UNDEFINED				0x00
25 #define UVC_SC_VIDEOCONTROL				0x01
26 #define UVC_SC_VIDEOSTREAMING				0x02
27 #define UVC_SC_VIDEO_INTERFACE_COLLECTION		0x03
28 
29 /* A.3. Video Interface Protocol Codes */
30 #define UVC_PC_PROTOCOL_UNDEFINED			0x00
31 #define UVC_PC_PROTOCOL_15				0x01
32 
33 /* A.5. Video Class-Specific VC Interface Descriptor Subtypes */
34 #define UVC_VC_DESCRIPTOR_UNDEFINED			0x00
35 #define UVC_VC_HEADER					0x01
36 #define UVC_VC_INPUT_TERMINAL				0x02
37 #define UVC_VC_OUTPUT_TERMINAL				0x03
38 #define UVC_VC_SELECTOR_UNIT				0x04
39 #define UVC_VC_PROCESSING_UNIT				0x05
40 #define UVC_VC_EXTENSION_UNIT				0x06
41 
42 /* A.6. Video Class-Specific VS Interface Descriptor Subtypes */
43 #define UVC_VS_UNDEFINED				0x00
44 #define UVC_VS_INPUT_HEADER				0x01
45 #define UVC_VS_OUTPUT_HEADER				0x02
46 #define UVC_VS_STILL_IMAGE_FRAME			0x03
47 #define UVC_VS_FORMAT_UNCOMPRESSED			0x04
48 #define UVC_VS_FRAME_UNCOMPRESSED			0x05
49 #define UVC_VS_FORMAT_MJPEG				0x06
50 #define UVC_VS_FRAME_MJPEG				0x07
51 #define UVC_VS_FORMAT_MPEG2TS				0x0a
52 #define UVC_VS_FORMAT_DV				0x0c
53 #define UVC_VS_COLORFORMAT				0x0d
54 #define UVC_VS_FORMAT_FRAME_BASED			0x10
55 #define UVC_VS_FRAME_FRAME_BASED			0x11
56 #define UVC_VS_FORMAT_STREAM_BASED			0x12
57 
58 /* A.7. Video Class-Specific Endpoint Descriptor Subtypes */
59 #define UVC_EP_UNDEFINED				0x00
60 #define UVC_EP_GENERAL					0x01
61 #define UVC_EP_ENDPOINT					0x02
62 #define UVC_EP_INTERRUPT				0x03
63 
64 /* A.8. Video Class-Specific Request Codes */
65 #define UVC_RC_UNDEFINED				0x00
66 #define UVC_SET_CUR					0x01
67 #define UVC_GET_CUR					0x81
68 #define UVC_GET_MIN					0x82
69 #define UVC_GET_MAX					0x83
70 #define UVC_GET_RES					0x84
71 #define UVC_GET_LEN					0x85
72 #define UVC_GET_INFO					0x86
73 #define UVC_GET_DEF					0x87
74 
75 /* A.9.1. VideoControl Interface Control Selectors */
76 #define UVC_VC_CONTROL_UNDEFINED			0x00
77 #define UVC_VC_VIDEO_POWER_MODE_CONTROL			0x01
78 #define UVC_VC_REQUEST_ERROR_CODE_CONTROL		0x02
79 
80 /* A.9.2. Terminal Control Selectors */
81 #define UVC_TE_CONTROL_UNDEFINED			0x00
82 
83 /* A.9.3. Selector Unit Control Selectors */
84 #define UVC_SU_CONTROL_UNDEFINED			0x00
85 #define UVC_SU_INPUT_SELECT_CONTROL			0x01
86 
87 /* A.9.4. Camera Terminal Control Selectors */
88 #define UVC_CT_CONTROL_UNDEFINED			0x00
89 #define UVC_CT_SCANNING_MODE_CONTROL			0x01
90 #define UVC_CT_AE_MODE_CONTROL				0x02
91 #define UVC_CT_AE_PRIORITY_CONTROL			0x03
92 #define UVC_CT_EXPOSURE_TIME_ABSOLUTE_CONTROL		0x04
93 #define UVC_CT_EXPOSURE_TIME_RELATIVE_CONTROL		0x05
94 #define UVC_CT_FOCUS_ABSOLUTE_CONTROL			0x06
95 #define UVC_CT_FOCUS_RELATIVE_CONTROL			0x07
96 #define UVC_CT_FOCUS_AUTO_CONTROL			0x08
97 #define UVC_CT_IRIS_ABSOLUTE_CONTROL			0x09
98 #define UVC_CT_IRIS_RELATIVE_CONTROL			0x0a
99 #define UVC_CT_ZOOM_ABSOLUTE_CONTROL			0x0b
100 #define UVC_CT_ZOOM_RELATIVE_CONTROL			0x0c
101 #define UVC_CT_PANTILT_ABSOLUTE_CONTROL			0x0d
102 #define UVC_CT_PANTILT_RELATIVE_CONTROL			0x0e
103 #define UVC_CT_ROLL_ABSOLUTE_CONTROL			0x0f
104 #define UVC_CT_ROLL_RELATIVE_CONTROL			0x10
105 #define UVC_CT_PRIVACY_CONTROL				0x11
106 
107 /* A.9.5. Processing Unit Control Selectors */
108 #define UVC_PU_CONTROL_UNDEFINED			0x00
109 #define UVC_PU_BACKLIGHT_COMPENSATION_CONTROL		0x01
110 #define UVC_PU_BRIGHTNESS_CONTROL			0x02
111 #define UVC_PU_CONTRAST_CONTROL				0x03
112 #define UVC_PU_GAIN_CONTROL				0x04
113 #define UVC_PU_POWER_LINE_FREQUENCY_CONTROL		0x05
114 #define UVC_PU_HUE_CONTROL				0x06
115 #define UVC_PU_SATURATION_CONTROL			0x07
116 #define UVC_PU_SHARPNESS_CONTROL			0x08
117 #define UVC_PU_GAMMA_CONTROL				0x09
118 #define UVC_PU_WHITE_BALANCE_TEMPERATURE_CONTROL	0x0a
119 #define UVC_PU_WHITE_BALANCE_TEMPERATURE_AUTO_CONTROL	0x0b
120 #define UVC_PU_WHITE_BALANCE_COMPONENT_CONTROL		0x0c
121 #define UVC_PU_WHITE_BALANCE_COMPONENT_AUTO_CONTROL	0x0d
122 #define UVC_PU_DIGITAL_MULTIPLIER_CONTROL		0x0e
123 #define UVC_PU_DIGITAL_MULTIPLIER_LIMIT_CONTROL		0x0f
124 #define UVC_PU_HUE_AUTO_CONTROL				0x10
125 #define UVC_PU_ANALOG_VIDEO_STANDARD_CONTROL		0x11
126 #define UVC_PU_ANALOG_LOCK_STATUS_CONTROL		0x12
127 
128 /* A.9.7. VideoStreaming Interface Control Selectors */
129 #define UVC_VS_CONTROL_UNDEFINED			0x00
130 #define UVC_VS_PROBE_CONTROL				0x01
131 #define UVC_VS_COMMIT_CONTROL				0x02
132 #define UVC_VS_STILL_PROBE_CONTROL			0x03
133 #define UVC_VS_STILL_COMMIT_CONTROL			0x04
134 #define UVC_VS_STILL_IMAGE_TRIGGER_CONTROL		0x05
135 #define UVC_VS_STREAM_ERROR_CODE_CONTROL		0x06
136 #define UVC_VS_GENERATE_KEY_FRAME_CONTROL		0x07
137 #define UVC_VS_UPDATE_FRAME_SEGMENT_CONTROL		0x08
138 #define UVC_VS_SYNC_DELAY_CONTROL			0x09
139 
140 /* B.1. USB Terminal Types */
141 #define UVC_TT_VENDOR_SPECIFIC				0x0100
142 #define UVC_TT_STREAMING				0x0101
143 
144 /* B.2. Input Terminal Types */
145 #define UVC_ITT_VENDOR_SPECIFIC				0x0200
146 #define UVC_ITT_CAMERA					0x0201
147 #define UVC_ITT_MEDIA_TRANSPORT_INPUT			0x0202
148 
149 /* B.3. Output Terminal Types */
150 #define UVC_OTT_VENDOR_SPECIFIC				0x0300
151 #define UVC_OTT_DISPLAY					0x0301
152 #define UVC_OTT_MEDIA_TRANSPORT_OUTPUT			0x0302
153 
154 /* B.4. External Terminal Types */
155 #define UVC_EXTERNAL_VENDOR_SPECIFIC			0x0400
156 #define UVC_COMPOSITE_CONNECTOR				0x0401
157 #define UVC_SVIDEO_CONNECTOR				0x0402
158 #define UVC_COMPONENT_CONNECTOR				0x0403
159 
160 /* 2.4.2.2. Status Packet Type */
161 #define UVC_STATUS_TYPE_CONTROL				1
162 #define UVC_STATUS_TYPE_STREAMING			2
163 
164 /* 2.4.3.3. Payload Header Information */
165 #define UVC_STREAM_EOH					(1 << 7)
166 #define UVC_STREAM_ERR					(1 << 6)
167 #define UVC_STREAM_STI					(1 << 5)
168 #define UVC_STREAM_RES					(1 << 4)
169 #define UVC_STREAM_SCR					(1 << 3)
170 #define UVC_STREAM_PTS					(1 << 2)
171 #define UVC_STREAM_EOF					(1 << 1)
172 #define UVC_STREAM_FID					(1 << 0)
173 
174 /* 4.1.2. Control Capabilities */
175 #define UVC_CONTROL_CAP_GET				(1 << 0)
176 #define UVC_CONTROL_CAP_SET				(1 << 1)
177 #define UVC_CONTROL_CAP_DISABLED			(1 << 2)
178 #define UVC_CONTROL_CAP_AUTOUPDATE			(1 << 3)
179 #define UVC_CONTROL_CAP_ASYNCHRONOUS			(1 << 4)
180 
181 /* ------------------------------------------------------------------------
182  * UVC structures
183  */
184 
185 /* All UVC descriptors have these 3 fields at the beginning */
186 struct uvc_descriptor_header {
187 	__u8  bLength;
188 	__u8  bDescriptorType;
189 	__u8  bDescriptorSubType;
190 } __attribute__((packed));
191 
192 /* 3.7.2. Video Control Interface Header Descriptor */
193 struct uvc_header_descriptor {
194 	__u8  bLength;
195 	__u8  bDescriptorType;
196 	__u8  bDescriptorSubType;
197 	__u16 bcdUVC;
198 	__u16 wTotalLength;
199 	__u32 dwClockFrequency;
200 	__u8  bInCollection;
201 	__u8  baInterfaceNr[];
202 } __attribute__((__packed__));
203 
204 #define UVC_DT_HEADER_SIZE(n)				(12+(n))
205 
206 #define UVC_HEADER_DESCRIPTOR(n) \
207 	uvc_header_descriptor_##n
208 
209 #define DECLARE_UVC_HEADER_DESCRIPTOR(n)		\
210 struct UVC_HEADER_DESCRIPTOR(n) {			\
211 	__u8  bLength;					\
212 	__u8  bDescriptorType;				\
213 	__u8  bDescriptorSubType;			\
214 	__u16 bcdUVC;					\
215 	__u16 wTotalLength;				\
216 	__u32 dwClockFrequency;				\
217 	__u8  bInCollection;				\
218 	__u8  baInterfaceNr[n];				\
219 } __attribute__ ((packed))
220 
221 /* 3.7.2.1. Input Terminal Descriptor */
222 struct uvc_input_terminal_descriptor {
223 	__u8  bLength;
224 	__u8  bDescriptorType;
225 	__u8  bDescriptorSubType;
226 	__u8  bTerminalID;
227 	__u16 wTerminalType;
228 	__u8  bAssocTerminal;
229 	__u8  iTerminal;
230 } __attribute__((__packed__));
231 
232 #define UVC_DT_INPUT_TERMINAL_SIZE			8
233 
234 /* 3.7.2.2. Output Terminal Descriptor */
235 struct uvc_output_terminal_descriptor {
236 	__u8  bLength;
237 	__u8  bDescriptorType;
238 	__u8  bDescriptorSubType;
239 	__u8  bTerminalID;
240 	__u16 wTerminalType;
241 	__u8  bAssocTerminal;
242 	__u8  bSourceID;
243 	__u8  iTerminal;
244 } __attribute__((__packed__));
245 
246 #define UVC_DT_OUTPUT_TERMINAL_SIZE			9
247 
248 /* 3.7.2.3. Camera Terminal Descriptor */
249 struct uvc_camera_terminal_descriptor {
250 	__u8  bLength;
251 	__u8  bDescriptorType;
252 	__u8  bDescriptorSubType;
253 	__u8  bTerminalID;
254 	__u16 wTerminalType;
255 	__u8  bAssocTerminal;
256 	__u8  iTerminal;
257 	__u16 wObjectiveFocalLengthMin;
258 	__u16 wObjectiveFocalLengthMax;
259 	__u16 wOcularFocalLength;
260 	__u8  bControlSize;
261 	__u8  bmControls[3];
262 } __attribute__((__packed__));
263 
264 #define UVC_DT_CAMERA_TERMINAL_SIZE(n)			(15+(n))
265 
266 /* 3.7.2.4. Selector Unit Descriptor */
267 struct uvc_selector_unit_descriptor {
268 	__u8  bLength;
269 	__u8  bDescriptorType;
270 	__u8  bDescriptorSubType;
271 	__u8  bUnitID;
272 	__u8  bNrInPins;
273 	__u8  baSourceID[0];
274 	__u8  iSelector;
275 } __attribute__((__packed__));
276 
277 #define UVC_DT_SELECTOR_UNIT_SIZE(n)			(6+(n))
278 
279 #define UVC_SELECTOR_UNIT_DESCRIPTOR(n)	\
280 	uvc_selector_unit_descriptor_##n
281 
282 #define DECLARE_UVC_SELECTOR_UNIT_DESCRIPTOR(n)	\
283 struct UVC_SELECTOR_UNIT_DESCRIPTOR(n) {		\
284 	__u8  bLength;					\
285 	__u8  bDescriptorType;				\
286 	__u8  bDescriptorSubType;			\
287 	__u8  bUnitID;					\
288 	__u8  bNrInPins;				\
289 	__u8  baSourceID[n];				\
290 	__u8  iSelector;				\
291 } __attribute__ ((packed))
292 
293 /* 3.7.2.5. Processing Unit Descriptor */
294 struct uvc_processing_unit_descriptor {
295 	__u8  bLength;
296 	__u8  bDescriptorType;
297 	__u8  bDescriptorSubType;
298 	__u8  bUnitID;
299 	__u8  bSourceID;
300 	__u16 wMaxMultiplier;
301 	__u8  bControlSize;
302 	__u8  bmControls[2];
303 	__u8  iProcessing;
304 } __attribute__((__packed__));
305 
306 #define UVC_DT_PROCESSING_UNIT_SIZE(n)			(9+(n))
307 
308 /* 3.7.2.6. Extension Unit Descriptor */
309 struct uvc_extension_unit_descriptor {
310 	__u8  bLength;
311 	__u8  bDescriptorType;
312 	__u8  bDescriptorSubType;
313 	__u8  bUnitID;
314 	__u8  guidExtensionCode[16];
315 	__u8  bNumControls;
316 	__u8  bNrInPins;
317 	__u8  baSourceID[0];
318 	__u8  bControlSize;
319 	__u8  bmControls[0];
320 	__u8  iExtension;
321 } __attribute__((__packed__));
322 
323 #define UVC_DT_EXTENSION_UNIT_SIZE(p, n)		(24+(p)+(n))
324 
325 #define UVC_EXTENSION_UNIT_DESCRIPTOR(p, n) \
326 	uvc_extension_unit_descriptor_##p_##n
327 
328 #define DECLARE_UVC_EXTENSION_UNIT_DESCRIPTOR(p, n)	\
329 struct UVC_EXTENSION_UNIT_DESCRIPTOR(p, n) {		\
330 	__u8  bLength;					\
331 	__u8  bDescriptorType;				\
332 	__u8  bDescriptorSubType;			\
333 	__u8  bUnitID;					\
334 	__u8  guidExtensionCode[16];			\
335 	__u8  bNumControls;				\
336 	__u8  bNrInPins;				\
337 	__u8  baSourceID[p];				\
338 	__u8  bControlSize;				\
339 	__u8  bmControls[n];				\
340 	__u8  iExtension;				\
341 } __attribute__ ((packed))
342 
343 /* 3.8.2.2. Video Control Interrupt Endpoint Descriptor */
344 struct uvc_control_endpoint_descriptor {
345 	__u8  bLength;
346 	__u8  bDescriptorType;
347 	__u8  bDescriptorSubType;
348 	__u16 wMaxTransferSize;
349 } __attribute__((__packed__));
350 
351 #define UVC_DT_CONTROL_ENDPOINT_SIZE			5
352 
353 /* 3.9.2.1. Input Header Descriptor */
354 struct uvc_input_header_descriptor {
355 	__u8  bLength;
356 	__u8  bDescriptorType;
357 	__u8  bDescriptorSubType;
358 	__u8  bNumFormats;
359 	__u16 wTotalLength;
360 	__u8  bEndpointAddress;
361 	__u8  bmInfo;
362 	__u8  bTerminalLink;
363 	__u8  bStillCaptureMethod;
364 	__u8  bTriggerSupport;
365 	__u8  bTriggerUsage;
366 	__u8  bControlSize;
367 	__u8  bmaControls[];
368 } __attribute__((__packed__));
369 
370 #define UVC_DT_INPUT_HEADER_SIZE(n, p)			(13+(n*p))
371 
372 #define UVC_INPUT_HEADER_DESCRIPTOR(n, p) \
373 	uvc_input_header_descriptor_##n_##p
374 
375 #define DECLARE_UVC_INPUT_HEADER_DESCRIPTOR(n, p)	\
376 struct UVC_INPUT_HEADER_DESCRIPTOR(n, p) {		\
377 	__u8  bLength;					\
378 	__u8  bDescriptorType;				\
379 	__u8  bDescriptorSubType;			\
380 	__u8  bNumFormats;				\
381 	__u16 wTotalLength;				\
382 	__u8  bEndpointAddress;				\
383 	__u8  bmInfo;					\
384 	__u8  bTerminalLink;				\
385 	__u8  bStillCaptureMethod;			\
386 	__u8  bTriggerSupport;				\
387 	__u8  bTriggerUsage;				\
388 	__u8  bControlSize;				\
389 	__u8  bmaControls[p][n];			\
390 } __attribute__ ((packed))
391 
392 /* 3.9.2.2. Output Header Descriptor */
393 struct uvc_output_header_descriptor {
394 	__u8  bLength;
395 	__u8  bDescriptorType;
396 	__u8  bDescriptorSubType;
397 	__u8  bNumFormats;
398 	__u16 wTotalLength;
399 	__u8  bEndpointAddress;
400 	__u8  bTerminalLink;
401 	__u8  bControlSize;
402 	__u8  bmaControls[];
403 } __attribute__((__packed__));
404 
405 #define UVC_DT_OUTPUT_HEADER_SIZE(n, p)			(9+(n*p))
406 
407 #define UVC_OUTPUT_HEADER_DESCRIPTOR(n, p) \
408 	uvc_output_header_descriptor_##n_##p
409 
410 #define DECLARE_UVC_OUTPUT_HEADER_DESCRIPTOR(n, p)	\
411 struct UVC_OUTPUT_HEADER_DESCRIPTOR(n, p) {		\
412 	__u8  bLength;					\
413 	__u8  bDescriptorType;				\
414 	__u8  bDescriptorSubType;			\
415 	__u8  bNumFormats;				\
416 	__u16 wTotalLength;				\
417 	__u8  bEndpointAddress;				\
418 	__u8  bTerminalLink;				\
419 	__u8  bControlSize;				\
420 	__u8  bmaControls[p][n];			\
421 } __attribute__ ((packed))
422 
423 /* 3.9.2.6. Color matching descriptor */
424 struct uvc_color_matching_descriptor {
425 	__u8  bLength;
426 	__u8  bDescriptorType;
427 	__u8  bDescriptorSubType;
428 	__u8  bColorPrimaries;
429 	__u8  bTransferCharacteristics;
430 	__u8  bMatrixCoefficients;
431 } __attribute__((__packed__));
432 
433 #define UVC_DT_COLOR_MATCHING_SIZE			6
434 
435 /* 4.3.1.1. Video Probe and Commit Controls */
436 struct uvc_streaming_control {
437 	__u16 bmHint;
438 	__u8  bFormatIndex;
439 	__u8  bFrameIndex;
440 	__u32 dwFrameInterval;
441 	__u16 wKeyFrameRate;
442 	__u16 wPFrameRate;
443 	__u16 wCompQuality;
444 	__u16 wCompWindowSize;
445 	__u16 wDelay;
446 	__u32 dwMaxVideoFrameSize;
447 	__u32 dwMaxPayloadTransferSize;
448 	__u32 dwClockFrequency;
449 	__u8  bmFramingInfo;
450 	__u8  bPreferedVersion;
451 	__u8  bMinVersion;
452 	__u8  bMaxVersion;
453 } __attribute__((__packed__));
454 
455 /* Uncompressed Payload - 3.1.1. Uncompressed Video Format Descriptor */
456 struct uvc_format_uncompressed {
457 	__u8  bLength;
458 	__u8  bDescriptorType;
459 	__u8  bDescriptorSubType;
460 	__u8  bFormatIndex;
461 	__u8  bNumFrameDescriptors;
462 	__u8  guidFormat[16];
463 	__u8  bBitsPerPixel;
464 	__u8  bDefaultFrameIndex;
465 	__u8  bAspectRatioX;
466 	__u8  bAspectRatioY;
467 	__u8  bmInterfaceFlags;
468 	__u8  bCopyProtect;
469 } __attribute__((__packed__));
470 
471 #define UVC_DT_FORMAT_UNCOMPRESSED_SIZE			27
472 
473 /* Uncompressed Payload - 3.1.2. Uncompressed Video Frame Descriptor */
474 struct uvc_frame_uncompressed {
475 	__u8  bLength;
476 	__u8  bDescriptorType;
477 	__u8  bDescriptorSubType;
478 	__u8  bFrameIndex;
479 	__u8  bmCapabilities;
480 	__u16 wWidth;
481 	__u16 wHeight;
482 	__u32 dwMinBitRate;
483 	__u32 dwMaxBitRate;
484 	__u32 dwMaxVideoFrameBufferSize;
485 	__u32 dwDefaultFrameInterval;
486 	__u8  bFrameIntervalType;
487 	__u32 dwFrameInterval[];
488 } __attribute__((__packed__));
489 
490 #define UVC_DT_FRAME_UNCOMPRESSED_SIZE(n)		(26+4*(n))
491 
492 #define UVC_FRAME_UNCOMPRESSED(n) \
493 	uvc_frame_uncompressed_##n
494 
495 #define DECLARE_UVC_FRAME_UNCOMPRESSED(n)		\
496 struct UVC_FRAME_UNCOMPRESSED(n) {			\
497 	__u8  bLength;					\
498 	__u8  bDescriptorType;				\
499 	__u8  bDescriptorSubType;			\
500 	__u8  bFrameIndex;				\
501 	__u8  bmCapabilities;				\
502 	__u16 wWidth;					\
503 	__u16 wHeight;					\
504 	__u32 dwMinBitRate;				\
505 	__u32 dwMaxBitRate;				\
506 	__u32 dwMaxVideoFrameBufferSize;		\
507 	__u32 dwDefaultFrameInterval;			\
508 	__u8  bFrameIntervalType;			\
509 	__u32 dwFrameInterval[n];			\
510 } __attribute__ ((packed))
511 
512 /* MJPEG Payload - 3.1.1. MJPEG Video Format Descriptor */
513 struct uvc_format_mjpeg {
514 	__u8  bLength;
515 	__u8  bDescriptorType;
516 	__u8  bDescriptorSubType;
517 	__u8  bFormatIndex;
518 	__u8  bNumFrameDescriptors;
519 	__u8  bmFlags;
520 	__u8  bDefaultFrameIndex;
521 	__u8  bAspectRatioX;
522 	__u8  bAspectRatioY;
523 	__u8  bmInterfaceFlags;
524 	__u8  bCopyProtect;
525 } __attribute__((__packed__));
526 
527 #define UVC_DT_FORMAT_MJPEG_SIZE			11
528 
529 /* MJPEG Payload - 3.1.2. MJPEG Video Frame Descriptor */
530 struct uvc_frame_mjpeg {
531 	__u8  bLength;
532 	__u8  bDescriptorType;
533 	__u8  bDescriptorSubType;
534 	__u8  bFrameIndex;
535 	__u8  bmCapabilities;
536 	__u16 wWidth;
537 	__u16 wHeight;
538 	__u32 dwMinBitRate;
539 	__u32 dwMaxBitRate;
540 	__u32 dwMaxVideoFrameBufferSize;
541 	__u32 dwDefaultFrameInterval;
542 	__u8  bFrameIntervalType;
543 	__u32 dwFrameInterval[];
544 } __attribute__((__packed__));
545 
546 #define UVC_DT_FRAME_MJPEG_SIZE(n)			(26+4*(n))
547 
548 #define UVC_FRAME_MJPEG(n) \
549 	uvc_frame_mjpeg_##n
550 
551 #define DECLARE_UVC_FRAME_MJPEG(n)			\
552 struct UVC_FRAME_MJPEG(n) {				\
553 	__u8  bLength;					\
554 	__u8  bDescriptorType;				\
555 	__u8  bDescriptorSubType;			\
556 	__u8  bFrameIndex;				\
557 	__u8  bmCapabilities;				\
558 	__u16 wWidth;					\
559 	__u16 wHeight;					\
560 	__u32 dwMinBitRate;				\
561 	__u32 dwMaxBitRate;				\
562 	__u32 dwMaxVideoFrameBufferSize;		\
563 	__u32 dwDefaultFrameInterval;			\
564 	__u8  bFrameIntervalType;			\
565 	__u32 dwFrameInterval[n];			\
566 } __attribute__ ((packed))
567 
568 #endif /* __LINUX_USB_VIDEO_H */
569 
570