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