| 
									
										
										
										
											2009-06-26 12:15:38 -03:00
										 |  |  | /*
 | 
					
						
							|  |  |  |  * USB Video Class definitions. | 
					
						
							|  |  |  |  * | 
					
						
							|  |  |  |  * Copyright (C) 2009 Laurent Pinchart <laurent.pinchart@skynet.be> | 
					
						
							|  |  |  |  * | 
					
						
							|  |  |  |  * This file holds USB constants and structures defined by the USB Device | 
					
						
							|  |  |  |  * Class Definition for Video Devices. Unless otherwise stated, comments | 
					
						
							|  |  |  |  * below reference relevant sections of the USB Video Class 1.1 specification | 
					
						
							|  |  |  |  * available at | 
					
						
							|  |  |  |  * | 
					
						
							|  |  |  |  * http://www.usb.org/developers/devclass_docs/USB_Video_Class_1_1.zip
 | 
					
						
							|  |  |  |  */ | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | #ifndef __LINUX_USB_VIDEO_H
 | 
					
						
							|  |  |  | #define __LINUX_USB_VIDEO_H
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | #include <linux/types.h>
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | /* --------------------------------------------------------------------------
 | 
					
						
							|  |  |  |  * UVC constants | 
					
						
							|  |  |  |  */ | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | /* A.2. Video Interface Subclass Codes */ | 
					
						
							|  |  |  | #define UVC_SC_UNDEFINED				0x00
 | 
					
						
							|  |  |  | #define UVC_SC_VIDEOCONTROL				0x01
 | 
					
						
							|  |  |  | #define UVC_SC_VIDEOSTREAMING				0x02
 | 
					
						
							|  |  |  | #define UVC_SC_VIDEO_INTERFACE_COLLECTION		0x03
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | /* A.3. Video Interface Protocol Codes */ | 
					
						
							|  |  |  | #define UVC_PC_PROTOCOL_UNDEFINED			0x00
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | /* A.5. Video Class-Specific VC Interface Descriptor Subtypes */ | 
					
						
							|  |  |  | #define UVC_VC_DESCRIPTOR_UNDEFINED			0x00
 | 
					
						
							|  |  |  | #define UVC_VC_HEADER					0x01
 | 
					
						
							|  |  |  | #define UVC_VC_INPUT_TERMINAL				0x02
 | 
					
						
							|  |  |  | #define UVC_VC_OUTPUT_TERMINAL				0x03
 | 
					
						
							|  |  |  | #define UVC_VC_SELECTOR_UNIT				0x04
 | 
					
						
							|  |  |  | #define UVC_VC_PROCESSING_UNIT				0x05
 | 
					
						
							|  |  |  | #define UVC_VC_EXTENSION_UNIT				0x06
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | /* A.6. Video Class-Specific VS Interface Descriptor Subtypes */ | 
					
						
							|  |  |  | #define UVC_VS_UNDEFINED				0x00
 | 
					
						
							|  |  |  | #define UVC_VS_INPUT_HEADER				0x01
 | 
					
						
							|  |  |  | #define UVC_VS_OUTPUT_HEADER				0x02
 | 
					
						
							|  |  |  | #define UVC_VS_STILL_IMAGE_FRAME			0x03
 | 
					
						
							|  |  |  | #define UVC_VS_FORMAT_UNCOMPRESSED			0x04
 | 
					
						
							|  |  |  | #define UVC_VS_FRAME_UNCOMPRESSED			0x05
 | 
					
						
							|  |  |  | #define UVC_VS_FORMAT_MJPEG				0x06
 | 
					
						
							|  |  |  | #define UVC_VS_FRAME_MJPEG				0x07
 | 
					
						
							|  |  |  | #define UVC_VS_FORMAT_MPEG2TS				0x0a
 | 
					
						
							|  |  |  | #define UVC_VS_FORMAT_DV				0x0c
 | 
					
						
							|  |  |  | #define UVC_VS_COLORFORMAT				0x0d
 | 
					
						
							|  |  |  | #define UVC_VS_FORMAT_FRAME_BASED			0x10
 | 
					
						
							|  |  |  | #define UVC_VS_FRAME_FRAME_BASED			0x11
 | 
					
						
							|  |  |  | #define UVC_VS_FORMAT_STREAM_BASED			0x12
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | /* A.7. Video Class-Specific Endpoint Descriptor Subtypes */ | 
					
						
							|  |  |  | #define UVC_EP_UNDEFINED				0x00
 | 
					
						
							|  |  |  | #define UVC_EP_GENERAL					0x01
 | 
					
						
							|  |  |  | #define UVC_EP_ENDPOINT					0x02
 | 
					
						
							|  |  |  | #define UVC_EP_INTERRUPT				0x03
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | /* A.8. Video Class-Specific Request Codes */ | 
					
						
							|  |  |  | #define UVC_RC_UNDEFINED				0x00
 | 
					
						
							|  |  |  | #define UVC_SET_CUR					0x01
 | 
					
						
							|  |  |  | #define UVC_GET_CUR					0x81
 | 
					
						
							|  |  |  | #define UVC_GET_MIN					0x82
 | 
					
						
							|  |  |  | #define UVC_GET_MAX					0x83
 | 
					
						
							|  |  |  | #define UVC_GET_RES					0x84
 | 
					
						
							|  |  |  | #define UVC_GET_LEN					0x85
 | 
					
						
							|  |  |  | #define UVC_GET_INFO					0x86
 | 
					
						
							|  |  |  | #define UVC_GET_DEF					0x87
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | /* A.9.1. VideoControl Interface Control Selectors */ | 
					
						
							|  |  |  | #define UVC_VC_CONTROL_UNDEFINED			0x00
 | 
					
						
							|  |  |  | #define UVC_VC_VIDEO_POWER_MODE_CONTROL			0x01
 | 
					
						
							|  |  |  | #define UVC_VC_REQUEST_ERROR_CODE_CONTROL		0x02
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | /* A.9.2. Terminal Control Selectors */ | 
					
						
							|  |  |  | #define UVC_TE_CONTROL_UNDEFINED			0x00
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | /* A.9.3. Selector Unit Control Selectors */ | 
					
						
							|  |  |  | #define UVC_SU_CONTROL_UNDEFINED			0x00
 | 
					
						
							|  |  |  | #define UVC_SU_INPUT_SELECT_CONTROL			0x01
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | /* A.9.4. Camera Terminal Control Selectors */ | 
					
						
							|  |  |  | #define UVC_CT_CONTROL_UNDEFINED			0x00
 | 
					
						
							|  |  |  | #define UVC_CT_SCANNING_MODE_CONTROL			0x01
 | 
					
						
							|  |  |  | #define UVC_CT_AE_MODE_CONTROL				0x02
 | 
					
						
							|  |  |  | #define UVC_CT_AE_PRIORITY_CONTROL			0x03
 | 
					
						
							|  |  |  | #define UVC_CT_EXPOSURE_TIME_ABSOLUTE_CONTROL		0x04
 | 
					
						
							|  |  |  | #define UVC_CT_EXPOSURE_TIME_RELATIVE_CONTROL		0x05
 | 
					
						
							|  |  |  | #define UVC_CT_FOCUS_ABSOLUTE_CONTROL			0x06
 | 
					
						
							|  |  |  | #define UVC_CT_FOCUS_RELATIVE_CONTROL			0x07
 | 
					
						
							|  |  |  | #define UVC_CT_FOCUS_AUTO_CONTROL			0x08
 | 
					
						
							|  |  |  | #define UVC_CT_IRIS_ABSOLUTE_CONTROL			0x09
 | 
					
						
							|  |  |  | #define UVC_CT_IRIS_RELATIVE_CONTROL			0x0a
 | 
					
						
							|  |  |  | #define UVC_CT_ZOOM_ABSOLUTE_CONTROL			0x0b
 | 
					
						
							|  |  |  | #define UVC_CT_ZOOM_RELATIVE_CONTROL			0x0c
 | 
					
						
							|  |  |  | #define UVC_CT_PANTILT_ABSOLUTE_CONTROL			0x0d
 | 
					
						
							|  |  |  | #define UVC_CT_PANTILT_RELATIVE_CONTROL			0x0e
 | 
					
						
							|  |  |  | #define UVC_CT_ROLL_ABSOLUTE_CONTROL			0x0f
 | 
					
						
							|  |  |  | #define UVC_CT_ROLL_RELATIVE_CONTROL			0x10
 | 
					
						
							|  |  |  | #define UVC_CT_PRIVACY_CONTROL				0x11
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | /* A.9.5. Processing Unit Control Selectors */ | 
					
						
							|  |  |  | #define UVC_PU_CONTROL_UNDEFINED			0x00
 | 
					
						
							|  |  |  | #define UVC_PU_BACKLIGHT_COMPENSATION_CONTROL		0x01
 | 
					
						
							|  |  |  | #define UVC_PU_BRIGHTNESS_CONTROL			0x02
 | 
					
						
							|  |  |  | #define UVC_PU_CONTRAST_CONTROL				0x03
 | 
					
						
							|  |  |  | #define UVC_PU_GAIN_CONTROL				0x04
 | 
					
						
							|  |  |  | #define UVC_PU_POWER_LINE_FREQUENCY_CONTROL		0x05
 | 
					
						
							|  |  |  | #define UVC_PU_HUE_CONTROL				0x06
 | 
					
						
							|  |  |  | #define UVC_PU_SATURATION_CONTROL			0x07
 | 
					
						
							|  |  |  | #define UVC_PU_SHARPNESS_CONTROL			0x08
 | 
					
						
							|  |  |  | #define UVC_PU_GAMMA_CONTROL				0x09
 | 
					
						
							|  |  |  | #define UVC_PU_WHITE_BALANCE_TEMPERATURE_CONTROL	0x0a
 | 
					
						
							|  |  |  | #define UVC_PU_WHITE_BALANCE_TEMPERATURE_AUTO_CONTROL	0x0b
 | 
					
						
							|  |  |  | #define UVC_PU_WHITE_BALANCE_COMPONENT_CONTROL		0x0c
 | 
					
						
							|  |  |  | #define UVC_PU_WHITE_BALANCE_COMPONENT_AUTO_CONTROL	0x0d
 | 
					
						
							|  |  |  | #define UVC_PU_DIGITAL_MULTIPLIER_CONTROL		0x0e
 | 
					
						
							|  |  |  | #define UVC_PU_DIGITAL_MULTIPLIER_LIMIT_CONTROL		0x0f
 | 
					
						
							|  |  |  | #define UVC_PU_HUE_AUTO_CONTROL				0x10
 | 
					
						
							|  |  |  | #define UVC_PU_ANALOG_VIDEO_STANDARD_CONTROL		0x11
 | 
					
						
							|  |  |  | #define UVC_PU_ANALOG_LOCK_STATUS_CONTROL		0x12
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | /* A.9.7. VideoStreaming Interface Control Selectors */ | 
					
						
							|  |  |  | #define UVC_VS_CONTROL_UNDEFINED			0x00
 | 
					
						
							|  |  |  | #define UVC_VS_PROBE_CONTROL				0x01
 | 
					
						
							|  |  |  | #define UVC_VS_COMMIT_CONTROL				0x02
 | 
					
						
							|  |  |  | #define UVC_VS_STILL_PROBE_CONTROL			0x03
 | 
					
						
							|  |  |  | #define UVC_VS_STILL_COMMIT_CONTROL			0x04
 | 
					
						
							|  |  |  | #define UVC_VS_STILL_IMAGE_TRIGGER_CONTROL		0x05
 | 
					
						
							|  |  |  | #define UVC_VS_STREAM_ERROR_CODE_CONTROL		0x06
 | 
					
						
							|  |  |  | #define UVC_VS_GENERATE_KEY_FRAME_CONTROL		0x07
 | 
					
						
							|  |  |  | #define UVC_VS_UPDATE_FRAME_SEGMENT_CONTROL		0x08
 | 
					
						
							|  |  |  | #define UVC_VS_SYNC_DELAY_CONTROL			0x09
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | /* B.1. USB Terminal Types */ | 
					
						
							|  |  |  | #define UVC_TT_VENDOR_SPECIFIC				0x0100
 | 
					
						
							|  |  |  | #define UVC_TT_STREAMING				0x0101
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | /* B.2. Input Terminal Types */ | 
					
						
							|  |  |  | #define UVC_ITT_VENDOR_SPECIFIC				0x0200
 | 
					
						
							|  |  |  | #define UVC_ITT_CAMERA					0x0201
 | 
					
						
							|  |  |  | #define UVC_ITT_MEDIA_TRANSPORT_INPUT			0x0202
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | /* B.3. Output Terminal Types */ | 
					
						
							|  |  |  | #define UVC_OTT_VENDOR_SPECIFIC				0x0300
 | 
					
						
							|  |  |  | #define UVC_OTT_DISPLAY					0x0301
 | 
					
						
							|  |  |  | #define UVC_OTT_MEDIA_TRANSPORT_OUTPUT			0x0302
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | /* B.4. External Terminal Types */ | 
					
						
							|  |  |  | #define UVC_EXTERNAL_VENDOR_SPECIFIC			0x0400
 | 
					
						
							|  |  |  | #define UVC_COMPOSITE_CONNECTOR				0x0401
 | 
					
						
							|  |  |  | #define UVC_SVIDEO_CONNECTOR				0x0402
 | 
					
						
							|  |  |  | #define UVC_COMPONENT_CONNECTOR				0x0403
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | /* 2.4.2.2. Status Packet Type */ | 
					
						
							|  |  |  | #define UVC_STATUS_TYPE_CONTROL				1
 | 
					
						
							|  |  |  | #define UVC_STATUS_TYPE_STREAMING			2
 | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2010-07-10 15:03:20 -03:00
										 |  |  | /* 2.4.3.3. Payload Header Information */ | 
					
						
							|  |  |  | #define UVC_STREAM_EOH					(1 << 7)
 | 
					
						
							|  |  |  | #define UVC_STREAM_ERR					(1 << 6)
 | 
					
						
							|  |  |  | #define UVC_STREAM_STI					(1 << 5)
 | 
					
						
							|  |  |  | #define UVC_STREAM_RES					(1 << 4)
 | 
					
						
							|  |  |  | #define UVC_STREAM_SCR					(1 << 3)
 | 
					
						
							|  |  |  | #define UVC_STREAM_PTS					(1 << 2)
 | 
					
						
							|  |  |  | #define UVC_STREAM_EOF					(1 << 1)
 | 
					
						
							|  |  |  | #define UVC_STREAM_FID					(1 << 0)
 | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2010-06-17 11:11:51 -03:00
										 |  |  | /* 4.1.2. Control Capabilities */ | 
					
						
							|  |  |  | #define UVC_CONTROL_CAP_GET				(1 << 0)
 | 
					
						
							|  |  |  | #define UVC_CONTROL_CAP_SET				(1 << 1)
 | 
					
						
							|  |  |  | #define UVC_CONTROL_CAP_DISABLED			(1 << 2)
 | 
					
						
							|  |  |  | #define UVC_CONTROL_CAP_AUTOUPDATE			(1 << 3)
 | 
					
						
							|  |  |  | #define UVC_CONTROL_CAP_ASYNCHRONOUS			(1 << 4)
 | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2010-07-10 15:03:20 -03:00
										 |  |  | /* ------------------------------------------------------------------------
 | 
					
						
							|  |  |  |  * UVC structures | 
					
						
							|  |  |  |  */ | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | /* All UVC descriptors have these 3 fields at the beginning */ | 
					
						
							|  |  |  | struct uvc_descriptor_header { | 
					
						
							|  |  |  | 	__u8  bLength; | 
					
						
							|  |  |  | 	__u8  bDescriptorType; | 
					
						
							|  |  |  | 	__u8  bDescriptorSubType; | 
					
						
							|  |  |  | } __attribute__((packed)); | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | /* 3.7.2. Video Control Interface Header Descriptor */ | 
					
						
							|  |  |  | struct uvc_header_descriptor { | 
					
						
							|  |  |  | 	__u8  bLength; | 
					
						
							|  |  |  | 	__u8  bDescriptorType; | 
					
						
							|  |  |  | 	__u8  bDescriptorSubType; | 
					
						
							|  |  |  | 	__u16 bcdUVC; | 
					
						
							|  |  |  | 	__u16 wTotalLength; | 
					
						
							|  |  |  | 	__u32 dwClockFrequency; | 
					
						
							|  |  |  | 	__u8  bInCollection; | 
					
						
							|  |  |  | 	__u8  baInterfaceNr[]; | 
					
						
							|  |  |  | } __attribute__((__packed__)); | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | #define UVC_DT_HEADER_SIZE(n)				(12+(n))
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | #define UVC_HEADER_DESCRIPTOR(n) \
 | 
					
						
							|  |  |  | 	uvc_header_descriptor_##n | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | #define DECLARE_UVC_HEADER_DESCRIPTOR(n)		\
 | 
					
						
							|  |  |  | struct UVC_HEADER_DESCRIPTOR(n) {			\ | 
					
						
							|  |  |  | 	__u8  bLength;					\ | 
					
						
							|  |  |  | 	__u8  bDescriptorType;				\ | 
					
						
							|  |  |  | 	__u8  bDescriptorSubType;			\ | 
					
						
							|  |  |  | 	__u16 bcdUVC;					\ | 
					
						
							|  |  |  | 	__u16 wTotalLength;				\ | 
					
						
							|  |  |  | 	__u32 dwClockFrequency;				\ | 
					
						
							|  |  |  | 	__u8  bInCollection;				\ | 
					
						
							|  |  |  | 	__u8  baInterfaceNr[n];				\ | 
					
						
							|  |  |  | } __attribute__ ((packed)) | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | /* 3.7.2.1. Input Terminal Descriptor */ | 
					
						
							|  |  |  | struct uvc_input_terminal_descriptor { | 
					
						
							|  |  |  | 	__u8  bLength; | 
					
						
							|  |  |  | 	__u8  bDescriptorType; | 
					
						
							|  |  |  | 	__u8  bDescriptorSubType; | 
					
						
							|  |  |  | 	__u8  bTerminalID; | 
					
						
							|  |  |  | 	__u16 wTerminalType; | 
					
						
							|  |  |  | 	__u8  bAssocTerminal; | 
					
						
							|  |  |  | 	__u8  iTerminal; | 
					
						
							|  |  |  | } __attribute__((__packed__)); | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | #define UVC_DT_INPUT_TERMINAL_SIZE			8
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | /* 3.7.2.2. Output Terminal Descriptor */ | 
					
						
							|  |  |  | struct uvc_output_terminal_descriptor { | 
					
						
							|  |  |  | 	__u8  bLength; | 
					
						
							|  |  |  | 	__u8  bDescriptorType; | 
					
						
							|  |  |  | 	__u8  bDescriptorSubType; | 
					
						
							|  |  |  | 	__u8  bTerminalID; | 
					
						
							|  |  |  | 	__u16 wTerminalType; | 
					
						
							|  |  |  | 	__u8  bAssocTerminal; | 
					
						
							|  |  |  | 	__u8  bSourceID; | 
					
						
							|  |  |  | 	__u8  iTerminal; | 
					
						
							|  |  |  | } __attribute__((__packed__)); | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | #define UVC_DT_OUTPUT_TERMINAL_SIZE			9
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | /* 3.7.2.3. Camera Terminal Descriptor */ | 
					
						
							|  |  |  | struct uvc_camera_terminal_descriptor { | 
					
						
							|  |  |  | 	__u8  bLength; | 
					
						
							|  |  |  | 	__u8  bDescriptorType; | 
					
						
							|  |  |  | 	__u8  bDescriptorSubType; | 
					
						
							|  |  |  | 	__u8  bTerminalID; | 
					
						
							|  |  |  | 	__u16 wTerminalType; | 
					
						
							|  |  |  | 	__u8  bAssocTerminal; | 
					
						
							|  |  |  | 	__u8  iTerminal; | 
					
						
							|  |  |  | 	__u16 wObjectiveFocalLengthMin; | 
					
						
							|  |  |  | 	__u16 wObjectiveFocalLengthMax; | 
					
						
							|  |  |  | 	__u16 wOcularFocalLength; | 
					
						
							|  |  |  | 	__u8  bControlSize; | 
					
						
							|  |  |  | 	__u8  bmControls[3]; | 
					
						
							|  |  |  | } __attribute__((__packed__)); | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | #define UVC_DT_CAMERA_TERMINAL_SIZE(n)			(15+(n))
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | /* 3.7.2.4. Selector Unit Descriptor */ | 
					
						
							|  |  |  | struct uvc_selector_unit_descriptor { | 
					
						
							|  |  |  | 	__u8  bLength; | 
					
						
							|  |  |  | 	__u8  bDescriptorType; | 
					
						
							|  |  |  | 	__u8  bDescriptorSubType; | 
					
						
							|  |  |  | 	__u8  bUnitID; | 
					
						
							|  |  |  | 	__u8  bNrInPins; | 
					
						
							|  |  |  | 	__u8  baSourceID[0]; | 
					
						
							|  |  |  | 	__u8  iSelector; | 
					
						
							|  |  |  | } __attribute__((__packed__)); | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | #define UVC_DT_SELECTOR_UNIT_SIZE(n)			(6+(n))
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | #define UVC_SELECTOR_UNIT_DESCRIPTOR(n)	\
 | 
					
						
							|  |  |  | 	uvc_selector_unit_descriptor_##n | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | #define DECLARE_UVC_SELECTOR_UNIT_DESCRIPTOR(n)	\
 | 
					
						
							|  |  |  | struct UVC_SELECTOR_UNIT_DESCRIPTOR(n) {		\ | 
					
						
							|  |  |  | 	__u8  bLength;					\ | 
					
						
							|  |  |  | 	__u8  bDescriptorType;				\ | 
					
						
							|  |  |  | 	__u8  bDescriptorSubType;			\ | 
					
						
							|  |  |  | 	__u8  bUnitID;					\ | 
					
						
							|  |  |  | 	__u8  bNrInPins;				\ | 
					
						
							|  |  |  | 	__u8  baSourceID[n];				\ | 
					
						
							|  |  |  | 	__u8  iSelector;				\ | 
					
						
							|  |  |  | } __attribute__ ((packed)) | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | /* 3.7.2.5. Processing Unit Descriptor */ | 
					
						
							|  |  |  | struct uvc_processing_unit_descriptor { | 
					
						
							|  |  |  | 	__u8  bLength; | 
					
						
							|  |  |  | 	__u8  bDescriptorType; | 
					
						
							|  |  |  | 	__u8  bDescriptorSubType; | 
					
						
							|  |  |  | 	__u8  bUnitID; | 
					
						
							|  |  |  | 	__u8  bSourceID; | 
					
						
							|  |  |  | 	__u16 wMaxMultiplier; | 
					
						
							|  |  |  | 	__u8  bControlSize; | 
					
						
							|  |  |  | 	__u8  bmControls[2]; | 
					
						
							|  |  |  | 	__u8  iProcessing; | 
					
						
							|  |  |  | } __attribute__((__packed__)); | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | #define UVC_DT_PROCESSING_UNIT_SIZE(n)			(9+(n))
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | /* 3.7.2.6. Extension Unit Descriptor */ | 
					
						
							|  |  |  | struct uvc_extension_unit_descriptor { | 
					
						
							|  |  |  | 	__u8  bLength; | 
					
						
							|  |  |  | 	__u8  bDescriptorType; | 
					
						
							|  |  |  | 	__u8  bDescriptorSubType; | 
					
						
							|  |  |  | 	__u8  bUnitID; | 
					
						
							|  |  |  | 	__u8  guidExtensionCode[16]; | 
					
						
							|  |  |  | 	__u8  bNumControls; | 
					
						
							|  |  |  | 	__u8  bNrInPins; | 
					
						
							|  |  |  | 	__u8  baSourceID[0]; | 
					
						
							|  |  |  | 	__u8  bControlSize; | 
					
						
							|  |  |  | 	__u8  bmControls[0]; | 
					
						
							|  |  |  | 	__u8  iExtension; | 
					
						
							|  |  |  | } __attribute__((__packed__)); | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | #define UVC_DT_EXTENSION_UNIT_SIZE(p, n)		(24+(p)+(n))
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | #define UVC_EXTENSION_UNIT_DESCRIPTOR(p, n) \
 | 
					
						
							|  |  |  | 	uvc_extension_unit_descriptor_##p_##n | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | #define DECLARE_UVC_EXTENSION_UNIT_DESCRIPTOR(p, n)	\
 | 
					
						
							|  |  |  | struct UVC_EXTENSION_UNIT_DESCRIPTOR(p, n) {		\ | 
					
						
							|  |  |  | 	__u8  bLength;					\ | 
					
						
							|  |  |  | 	__u8  bDescriptorType;				\ | 
					
						
							|  |  |  | 	__u8  bDescriptorSubType;			\ | 
					
						
							|  |  |  | 	__u8  bUnitID;					\ | 
					
						
							|  |  |  | 	__u8  guidExtensionCode[16];			\ | 
					
						
							|  |  |  | 	__u8  bNumControls;				\ | 
					
						
							|  |  |  | 	__u8  bNrInPins;				\ | 
					
						
							|  |  |  | 	__u8  baSourceID[p];				\ | 
					
						
							|  |  |  | 	__u8  bControlSize;				\ | 
					
						
							|  |  |  | 	__u8  bmControls[n];				\ | 
					
						
							|  |  |  | 	__u8  iExtension;				\ | 
					
						
							|  |  |  | } __attribute__ ((packed)) | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | /* 3.8.2.2. Video Control Interrupt Endpoint Descriptor */ | 
					
						
							|  |  |  | struct uvc_control_endpoint_descriptor { | 
					
						
							|  |  |  | 	__u8  bLength; | 
					
						
							|  |  |  | 	__u8  bDescriptorType; | 
					
						
							|  |  |  | 	__u8  bDescriptorSubType; | 
					
						
							|  |  |  | 	__u16 wMaxTransferSize; | 
					
						
							|  |  |  | } __attribute__((__packed__)); | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | #define UVC_DT_CONTROL_ENDPOINT_SIZE			5
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | /* 3.9.2.1. Input Header Descriptor */ | 
					
						
							|  |  |  | struct uvc_input_header_descriptor { | 
					
						
							|  |  |  | 	__u8  bLength; | 
					
						
							|  |  |  | 	__u8  bDescriptorType; | 
					
						
							|  |  |  | 	__u8  bDescriptorSubType; | 
					
						
							|  |  |  | 	__u8  bNumFormats; | 
					
						
							|  |  |  | 	__u16 wTotalLength; | 
					
						
							|  |  |  | 	__u8  bEndpointAddress; | 
					
						
							|  |  |  | 	__u8  bmInfo; | 
					
						
							|  |  |  | 	__u8  bTerminalLink; | 
					
						
							|  |  |  | 	__u8  bStillCaptureMethod; | 
					
						
							|  |  |  | 	__u8  bTriggerSupport; | 
					
						
							|  |  |  | 	__u8  bTriggerUsage; | 
					
						
							|  |  |  | 	__u8  bControlSize; | 
					
						
							|  |  |  | 	__u8  bmaControls[]; | 
					
						
							|  |  |  | } __attribute__((__packed__)); | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | #define UVC_DT_INPUT_HEADER_SIZE(n, p)			(13+(n*p))
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | #define UVC_INPUT_HEADER_DESCRIPTOR(n, p) \
 | 
					
						
							|  |  |  | 	uvc_input_header_descriptor_##n_##p | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | #define DECLARE_UVC_INPUT_HEADER_DESCRIPTOR(n, p)	\
 | 
					
						
							|  |  |  | struct UVC_INPUT_HEADER_DESCRIPTOR(n, p) {		\ | 
					
						
							|  |  |  | 	__u8  bLength;					\ | 
					
						
							|  |  |  | 	__u8  bDescriptorType;				\ | 
					
						
							|  |  |  | 	__u8  bDescriptorSubType;			\ | 
					
						
							|  |  |  | 	__u8  bNumFormats;				\ | 
					
						
							|  |  |  | 	__u16 wTotalLength;				\ | 
					
						
							|  |  |  | 	__u8  bEndpointAddress;				\ | 
					
						
							|  |  |  | 	__u8  bmInfo;					\ | 
					
						
							|  |  |  | 	__u8  bTerminalLink;				\ | 
					
						
							|  |  |  | 	__u8  bStillCaptureMethod;			\ | 
					
						
							|  |  |  | 	__u8  bTriggerSupport;				\ | 
					
						
							|  |  |  | 	__u8  bTriggerUsage;				\ | 
					
						
							|  |  |  | 	__u8  bControlSize;				\ | 
					
						
							|  |  |  | 	__u8  bmaControls[p][n];			\ | 
					
						
							|  |  |  | } __attribute__ ((packed)) | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | /* 3.9.2.2. Output Header Descriptor */ | 
					
						
							|  |  |  | struct uvc_output_header_descriptor { | 
					
						
							|  |  |  | 	__u8  bLength; | 
					
						
							|  |  |  | 	__u8  bDescriptorType; | 
					
						
							|  |  |  | 	__u8  bDescriptorSubType; | 
					
						
							|  |  |  | 	__u8  bNumFormats; | 
					
						
							|  |  |  | 	__u16 wTotalLength; | 
					
						
							|  |  |  | 	__u8  bEndpointAddress; | 
					
						
							|  |  |  | 	__u8  bTerminalLink; | 
					
						
							|  |  |  | 	__u8  bControlSize; | 
					
						
							|  |  |  | 	__u8  bmaControls[]; | 
					
						
							|  |  |  | } __attribute__((__packed__)); | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | #define UVC_DT_OUTPUT_HEADER_SIZE(n, p)			(9+(n*p))
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | #define UVC_OUTPUT_HEADER_DESCRIPTOR(n, p) \
 | 
					
						
							|  |  |  | 	uvc_output_header_descriptor_##n_##p | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | #define DECLARE_UVC_OUTPUT_HEADER_DESCRIPTOR(n, p)	\
 | 
					
						
							|  |  |  | struct UVC_OUTPUT_HEADER_DESCRIPTOR(n, p) {		\ | 
					
						
							|  |  |  | 	__u8  bLength;					\ | 
					
						
							|  |  |  | 	__u8  bDescriptorType;				\ | 
					
						
							|  |  |  | 	__u8  bDescriptorSubType;			\ | 
					
						
							|  |  |  | 	__u8  bNumFormats;				\ | 
					
						
							|  |  |  | 	__u16 wTotalLength;				\ | 
					
						
							|  |  |  | 	__u8  bEndpointAddress;				\ | 
					
						
							|  |  |  | 	__u8  bTerminalLink;				\ | 
					
						
							|  |  |  | 	__u8  bControlSize;				\ | 
					
						
							|  |  |  | 	__u8  bmaControls[p][n];			\ | 
					
						
							|  |  |  | } __attribute__ ((packed)) | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | /* 3.9.2.6. Color matching descriptor */ | 
					
						
							|  |  |  | struct uvc_color_matching_descriptor { | 
					
						
							|  |  |  | 	__u8  bLength; | 
					
						
							|  |  |  | 	__u8  bDescriptorType; | 
					
						
							|  |  |  | 	__u8  bDescriptorSubType; | 
					
						
							|  |  |  | 	__u8  bColorPrimaries; | 
					
						
							|  |  |  | 	__u8  bTransferCharacteristics; | 
					
						
							|  |  |  | 	__u8  bMatrixCoefficients; | 
					
						
							|  |  |  | } __attribute__((__packed__)); | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | #define UVC_DT_COLOR_MATCHING_SIZE			6
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | /* 4.3.1.1. Video Probe and Commit Controls */ | 
					
						
							|  |  |  | struct uvc_streaming_control { | 
					
						
							|  |  |  | 	__u16 bmHint; | 
					
						
							|  |  |  | 	__u8  bFormatIndex; | 
					
						
							|  |  |  | 	__u8  bFrameIndex; | 
					
						
							|  |  |  | 	__u32 dwFrameInterval; | 
					
						
							|  |  |  | 	__u16 wKeyFrameRate; | 
					
						
							|  |  |  | 	__u16 wPFrameRate; | 
					
						
							|  |  |  | 	__u16 wCompQuality; | 
					
						
							|  |  |  | 	__u16 wCompWindowSize; | 
					
						
							|  |  |  | 	__u16 wDelay; | 
					
						
							|  |  |  | 	__u32 dwMaxVideoFrameSize; | 
					
						
							|  |  |  | 	__u32 dwMaxPayloadTransferSize; | 
					
						
							|  |  |  | 	__u32 dwClockFrequency; | 
					
						
							|  |  |  | 	__u8  bmFramingInfo; | 
					
						
							|  |  |  | 	__u8  bPreferedVersion; | 
					
						
							|  |  |  | 	__u8  bMinVersion; | 
					
						
							|  |  |  | 	__u8  bMaxVersion; | 
					
						
							|  |  |  | } __attribute__((__packed__)); | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | /* Uncompressed Payload - 3.1.1. Uncompressed Video Format Descriptor */ | 
					
						
							|  |  |  | struct uvc_format_uncompressed { | 
					
						
							|  |  |  | 	__u8  bLength; | 
					
						
							|  |  |  | 	__u8  bDescriptorType; | 
					
						
							|  |  |  | 	__u8  bDescriptorSubType; | 
					
						
							|  |  |  | 	__u8  bFormatIndex; | 
					
						
							|  |  |  | 	__u8  bNumFrameDescriptors; | 
					
						
							|  |  |  | 	__u8  guidFormat[16]; | 
					
						
							|  |  |  | 	__u8  bBitsPerPixel; | 
					
						
							|  |  |  | 	__u8  bDefaultFrameIndex; | 
					
						
							|  |  |  | 	__u8  bAspectRatioX; | 
					
						
							|  |  |  | 	__u8  bAspectRatioY; | 
					
						
							|  |  |  | 	__u8  bmInterfaceFlags; | 
					
						
							|  |  |  | 	__u8  bCopyProtect; | 
					
						
							|  |  |  | } __attribute__((__packed__)); | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | #define UVC_DT_FORMAT_UNCOMPRESSED_SIZE			27
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | /* Uncompressed Payload - 3.1.2. Uncompressed Video Frame Descriptor */ | 
					
						
							|  |  |  | struct uvc_frame_uncompressed { | 
					
						
							|  |  |  | 	__u8  bLength; | 
					
						
							|  |  |  | 	__u8  bDescriptorType; | 
					
						
							|  |  |  | 	__u8  bDescriptorSubType; | 
					
						
							|  |  |  | 	__u8  bFrameIndex; | 
					
						
							|  |  |  | 	__u8  bmCapabilities; | 
					
						
							|  |  |  | 	__u16 wWidth; | 
					
						
							|  |  |  | 	__u16 wHeight; | 
					
						
							|  |  |  | 	__u32 dwMinBitRate; | 
					
						
							|  |  |  | 	__u32 dwMaxBitRate; | 
					
						
							|  |  |  | 	__u32 dwMaxVideoFrameBufferSize; | 
					
						
							|  |  |  | 	__u32 dwDefaultFrameInterval; | 
					
						
							|  |  |  | 	__u8  bFrameIntervalType; | 
					
						
							|  |  |  | 	__u32 dwFrameInterval[]; | 
					
						
							|  |  |  | } __attribute__((__packed__)); | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | #define UVC_DT_FRAME_UNCOMPRESSED_SIZE(n)		(26+4*(n))
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | #define UVC_FRAME_UNCOMPRESSED(n) \
 | 
					
						
							|  |  |  | 	uvc_frame_uncompressed_##n | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | #define DECLARE_UVC_FRAME_UNCOMPRESSED(n)		\
 | 
					
						
							|  |  |  | struct UVC_FRAME_UNCOMPRESSED(n) {			\ | 
					
						
							|  |  |  | 	__u8  bLength;					\ | 
					
						
							|  |  |  | 	__u8  bDescriptorType;				\ | 
					
						
							|  |  |  | 	__u8  bDescriptorSubType;			\ | 
					
						
							|  |  |  | 	__u8  bFrameIndex;				\ | 
					
						
							|  |  |  | 	__u8  bmCapabilities;				\ | 
					
						
							|  |  |  | 	__u16 wWidth;					\ | 
					
						
							|  |  |  | 	__u16 wHeight;					\ | 
					
						
							|  |  |  | 	__u32 dwMinBitRate;				\ | 
					
						
							|  |  |  | 	__u32 dwMaxBitRate;				\ | 
					
						
							|  |  |  | 	__u32 dwMaxVideoFrameBufferSize;		\ | 
					
						
							|  |  |  | 	__u32 dwDefaultFrameInterval;			\ | 
					
						
							|  |  |  | 	__u8  bFrameIntervalType;			\ | 
					
						
							|  |  |  | 	__u32 dwFrameInterval[n];			\ | 
					
						
							|  |  |  | } __attribute__ ((packed)) | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | /* MJPEG Payload - 3.1.1. MJPEG Video Format Descriptor */ | 
					
						
							|  |  |  | struct uvc_format_mjpeg { | 
					
						
							|  |  |  | 	__u8  bLength; | 
					
						
							|  |  |  | 	__u8  bDescriptorType; | 
					
						
							|  |  |  | 	__u8  bDescriptorSubType; | 
					
						
							|  |  |  | 	__u8  bFormatIndex; | 
					
						
							|  |  |  | 	__u8  bNumFrameDescriptors; | 
					
						
							|  |  |  | 	__u8  bmFlags; | 
					
						
							|  |  |  | 	__u8  bDefaultFrameIndex; | 
					
						
							|  |  |  | 	__u8  bAspectRatioX; | 
					
						
							|  |  |  | 	__u8  bAspectRatioY; | 
					
						
							|  |  |  | 	__u8  bmInterfaceFlags; | 
					
						
							|  |  |  | 	__u8  bCopyProtect; | 
					
						
							|  |  |  | } __attribute__((__packed__)); | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | #define UVC_DT_FORMAT_MJPEG_SIZE			11
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | /* MJPEG Payload - 3.1.2. MJPEG Video Frame Descriptor */ | 
					
						
							|  |  |  | struct uvc_frame_mjpeg { | 
					
						
							|  |  |  | 	__u8  bLength; | 
					
						
							|  |  |  | 	__u8  bDescriptorType; | 
					
						
							|  |  |  | 	__u8  bDescriptorSubType; | 
					
						
							|  |  |  | 	__u8  bFrameIndex; | 
					
						
							|  |  |  | 	__u8  bmCapabilities; | 
					
						
							|  |  |  | 	__u16 wWidth; | 
					
						
							|  |  |  | 	__u16 wHeight; | 
					
						
							|  |  |  | 	__u32 dwMinBitRate; | 
					
						
							|  |  |  | 	__u32 dwMaxBitRate; | 
					
						
							|  |  |  | 	__u32 dwMaxVideoFrameBufferSize; | 
					
						
							|  |  |  | 	__u32 dwDefaultFrameInterval; | 
					
						
							|  |  |  | 	__u8  bFrameIntervalType; | 
					
						
							|  |  |  | 	__u32 dwFrameInterval[]; | 
					
						
							|  |  |  | } __attribute__((__packed__)); | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | #define UVC_DT_FRAME_MJPEG_SIZE(n)			(26+4*(n))
 | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | #define UVC_FRAME_MJPEG(n) \
 | 
					
						
							|  |  |  | 	uvc_frame_mjpeg_##n | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | #define DECLARE_UVC_FRAME_MJPEG(n)			\
 | 
					
						
							|  |  |  | struct UVC_FRAME_MJPEG(n) {				\ | 
					
						
							|  |  |  | 	__u8  bLength;					\ | 
					
						
							|  |  |  | 	__u8  bDescriptorType;				\ | 
					
						
							|  |  |  | 	__u8  bDescriptorSubType;			\ | 
					
						
							|  |  |  | 	__u8  bFrameIndex;				\ | 
					
						
							|  |  |  | 	__u8  bmCapabilities;				\ | 
					
						
							|  |  |  | 	__u16 wWidth;					\ | 
					
						
							|  |  |  | 	__u16 wHeight;					\ | 
					
						
							|  |  |  | 	__u32 dwMinBitRate;				\ | 
					
						
							|  |  |  | 	__u32 dwMaxBitRate;				\ | 
					
						
							|  |  |  | 	__u32 dwMaxVideoFrameBufferSize;		\ | 
					
						
							|  |  |  | 	__u32 dwDefaultFrameInterval;			\ | 
					
						
							|  |  |  | 	__u8  bFrameIntervalType;			\ | 
					
						
							|  |  |  | 	__u32 dwFrameInterval[n];			\ | 
					
						
							|  |  |  | } __attribute__ ((packed)) | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2009-06-26 12:15:38 -03:00
										 |  |  | #endif /* __LINUX_USB_VIDEO_H */
 | 
					
						
							|  |  |  | 
 |