uvideoreg.h revision 1.2.2.2
1 1.2.2.2 wrstuden /* $NetBSD: uvideoreg.h,v 1.2.2.2 2008/09/24 16:38:56 wrstuden Exp $ */ 2 1.2.2.2 wrstuden 3 1.2.2.2 wrstuden /* 4 1.2.2.2 wrstuden * Copyright (c) 2008 Patrick Mahoney 5 1.2.2.2 wrstuden * All rights reserved. 6 1.2.2.2 wrstuden * 7 1.2.2.2 wrstuden * This code was written by Patrick Mahoney (pat (at) polycrystal.org) as 8 1.2.2.2 wrstuden * part of Google Summer of Code 2008. 9 1.2.2.2 wrstuden * 10 1.2.2.2 wrstuden * Redistribution and use in source and binary forms, with or without 11 1.2.2.2 wrstuden * modification, are permitted provided that the following conditions 12 1.2.2.2 wrstuden * are met: 13 1.2.2.2 wrstuden * 1. Redistributions of source code must retain the above copyright 14 1.2.2.2 wrstuden * notice, this list of conditions and the following disclaimer. 15 1.2.2.2 wrstuden * 2. Redistributions in binary form must reproduce the above copyright 16 1.2.2.2 wrstuden * notice, this list of conditions and the following disclaimer in the 17 1.2.2.2 wrstuden * documentation and/or other materials provided with the distribution. 18 1.2.2.2 wrstuden * 3. All advertising materials mentioning features or use of this software 19 1.2.2.2 wrstuden * must display the following acknowledgement: 20 1.2.2.2 wrstuden * This product includes software developed by the NetBSD 21 1.2.2.2 wrstuden * Foundation, Inc. and its contributors. 22 1.2.2.2 wrstuden * 4. Neither the name of The NetBSD Foundation nor the names of its 23 1.2.2.2 wrstuden * contributors may be used to endorse or promote products derived 24 1.2.2.2 wrstuden * from this software without specific prior written permission. 25 1.2.2.2 wrstuden * 26 1.2.2.2 wrstuden * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS 27 1.2.2.2 wrstuden * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 28 1.2.2.2 wrstuden * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 29 1.2.2.2 wrstuden * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS 30 1.2.2.2 wrstuden * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 31 1.2.2.2 wrstuden * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 32 1.2.2.2 wrstuden * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 33 1.2.2.2 wrstuden * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 34 1.2.2.2 wrstuden * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 35 1.2.2.2 wrstuden * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 36 1.2.2.2 wrstuden * POSSIBILITY OF SUCH DAMAGE. 37 1.2.2.2 wrstuden */ 38 1.2.2.2 wrstuden 39 1.2.2.2 wrstuden #define UVIDEO_VERSION 0x001 40 1.2.2.2 wrstuden 41 1.2.2.2 wrstuden /* This is the standard GUID / UUID. In USB, it comes in the usual 42 1.2.2.2 wrstuden * little-endian packed format. */ 43 1.2.2.2 wrstuden 44 1.2.2.2 wrstuden typedef struct { 45 1.2.2.2 wrstuden uDWord data1; 46 1.2.2.2 wrstuden uWord data2; 47 1.2.2.2 wrstuden uWord data3; 48 1.2.2.2 wrstuden uByte data4[8]; 49 1.2.2.2 wrstuden } UPACKED usb_guid_t; 50 1.2.2.2 wrstuden 51 1.2.2.2 wrstuden typedef struct { 52 1.2.2.2 wrstuden uint32_t data1; 53 1.2.2.2 wrstuden uint16_t data2; 54 1.2.2.2 wrstuden uint16_t data3; 55 1.2.2.2 wrstuden uint8_t data4[8]; 56 1.2.2.2 wrstuden } guid_t; 57 1.2.2.2 wrstuden #define GUID_LEN 16 58 1.2.2.2 wrstuden 59 1.2.2.2 wrstuden /* 60 1.2.2.2 wrstuden * Video Control descriptors 61 1.2.2.2 wrstuden */ 62 1.2.2.2 wrstuden 63 1.2.2.2 wrstuden #define UDESC_VC_HEADER 0x01 64 1.2.2.2 wrstuden #define UDESC_INPUT_TERMINAL 0x02 65 1.2.2.2 wrstuden #define UDESC_OUTPUT_TERMINAL 0x03 66 1.2.2.2 wrstuden #define UDESC_SELECTOR_UNIT 0x04 67 1.2.2.2 wrstuden #define UDESC_PROCESSING_UNIT 0x05 68 1.2.2.2 wrstuden #define UDESC_EXTENSION_UNIT 0x06 69 1.2.2.2 wrstuden 70 1.2.2.2 wrstuden #define UDESC_VC_INTERRUPT_ENDPOINT 0x03 71 1.2.2.2 wrstuden 72 1.2.2.2 wrstuden /* Terminal Types */ 73 1.2.2.2 wrstuden #define UVDIEO_TT_VENDOR_SPECIFIC 0x0100 74 1.2.2.2 wrstuden #define UVIDEO_TT_STREAMING 0x0101 75 1.2.2.2 wrstuden 76 1.2.2.2 wrstuden /* Input Terminal Types */ 77 1.2.2.2 wrstuden #define UVIDEO_ITT_VENDOR_SPECIFIC 0x0200 78 1.2.2.2 wrstuden #define UVIDEO_ITT_CAMERA 0x0201 79 1.2.2.2 wrstuden #define UVIDEO_ITT_MEDIA_TRANSPORT_INPUT 0x0202 80 1.2.2.2 wrstuden 81 1.2.2.2 wrstuden /* Output Terminal Types */ 82 1.2.2.2 wrstuden #define UVIDEO_OTT_VENDOR_SPECIFIC 0x0300 83 1.2.2.2 wrstuden #define UVIDEO_OTT_DISPLAY 0x0301 84 1.2.2.2 wrstuden #define UVIDEO_OTT_MEDIA_TRANSPORT_OUTPUT 0x0302 85 1.2.2.2 wrstuden 86 1.2.2.2 wrstuden /* generic descriptor with Subtype */ 87 1.2.2.2 wrstuden typedef struct { 88 1.2.2.2 wrstuden uByte bLength; 89 1.2.2.2 wrstuden uByte bDescriptorType; 90 1.2.2.2 wrstuden uByte bDescriptorSubtype; 91 1.2.2.2 wrstuden } uvideo_descriptor_t; 92 1.2.2.2 wrstuden 93 1.2.2.2 wrstuden /* Class-specific Video Control Interface Header Descriptor */ 94 1.2.2.2 wrstuden typedef struct { 95 1.2.2.2 wrstuden uByte bLength; 96 1.2.2.2 wrstuden uByte bDescriptorType; 97 1.2.2.2 wrstuden uByte bDescriptorSubtype; 98 1.2.2.2 wrstuden uWord bcdUVC; 99 1.2.2.2 wrstuden uWord wTotalLength; 100 1.2.2.2 wrstuden uDWord dwClockFrequency; 101 1.2.2.2 wrstuden uByte bInCollection; 102 1.2.2.2 wrstuden /* followed by n bytes where n is equal to value of bInCollection */ 103 1.2.2.2 wrstuden uByte baInterfaceNr[]; 104 1.2.2.2 wrstuden } UPACKED uvideo_vc_header_descriptor_t; 105 1.2.2.2 wrstuden 106 1.2.2.2 wrstuden /* Input Terminal Descriptor */ 107 1.2.2.2 wrstuden typedef struct { 108 1.2.2.2 wrstuden uByte bLength; 109 1.2.2.2 wrstuden uByte bDescriptorType; 110 1.2.2.2 wrstuden uByte bDescriptorSubtype; 111 1.2.2.2 wrstuden uByte bTerminalID; 112 1.2.2.2 wrstuden uWord wTerminalType; 113 1.2.2.2 wrstuden uByte bAssocTerminal; 114 1.2.2.2 wrstuden uByte iTerminal; 115 1.2.2.2 wrstuden /* possibly more, depending on Terminal type */ 116 1.2.2.2 wrstuden } UPACKED uvideo_input_terminal_descriptor_t; 117 1.2.2.2 wrstuden 118 1.2.2.2 wrstuden /* Output Terminal Descriptor */ 119 1.2.2.2 wrstuden typedef struct { 120 1.2.2.2 wrstuden uByte bLength; 121 1.2.2.2 wrstuden uByte bDescriptorType; 122 1.2.2.2 wrstuden uByte bDescriptorSubtype; 123 1.2.2.2 wrstuden uByte bTerminalID; 124 1.2.2.2 wrstuden uWord wTerminalType; 125 1.2.2.2 wrstuden uByte bAssocTerminal; 126 1.2.2.2 wrstuden uByte bSourceID; 127 1.2.2.2 wrstuden uByte iTerminal; 128 1.2.2.2 wrstuden } UPACKED uvideo_output_terminal_descriptor_t; 129 1.2.2.2 wrstuden 130 1.2.2.2 wrstuden /* Camera Terminal Descriptor */ 131 1.2.2.2 wrstuden typedef struct { 132 1.2.2.2 wrstuden uByte bLength; 133 1.2.2.2 wrstuden uByte bDescriptorType; 134 1.2.2.2 wrstuden uByte bDescriptorSubtype; /* UDESC_VC_INPUT_TERMINAL */ 135 1.2.2.2 wrstuden uByte bTerminalID; 136 1.2.2.2 wrstuden uWord wTerminalType; /* UVIDEO_ITT_CAMERA */ 137 1.2.2.2 wrstuden uByte bAssocTerminal; 138 1.2.2.2 wrstuden uByte iTerminal; 139 1.2.2.2 wrstuden uWord wObjectiveFocalLengthMin; 140 1.2.2.2 wrstuden uWord wObjectiveFocalLengthMax; 141 1.2.2.2 wrstuden uWord wOcularFocalLength; 142 1.2.2.2 wrstuden uByte bControlSize; 143 1.2.2.2 wrstuden uByte bmControls[]; 144 1.2.2.2 wrstuden } UPACKED uvideo_camera_terminal_descriptor_t; 145 1.2.2.2 wrstuden 146 1.2.2.2 wrstuden /* bmControls fields of uvideo_camera_terminal_descriptor_t */ 147 1.2.2.2 wrstuden #define UVIDEO_CAMERA_CONTROL_SCANNING_MODE (1<<0) 148 1.2.2.2 wrstuden #define UVIDEO_CAMERA_CONTROL_AUTO_EXPOSURE_MODE (1<<1) 149 1.2.2.2 wrstuden #define UVIDEO_CAMERA_CONTROL_AUTO_EXPOSURE_PRIO (1<<2) 150 1.2.2.2 wrstuden #define UVIDEO_CAMERA_CONTROL_EXPOSURE_TIME_ABSOLUTE (1<<3) 151 1.2.2.2 wrstuden #define UVIDEO_CAMERA_CONTROL_EXPOSURE_TIME_RELATIVE (1<<4) 152 1.2.2.2 wrstuden #define UVIDEO_CAMERA_CONTROL_FOCUS_ABSOLUTE (1<<5) 153 1.2.2.2 wrstuden #define UVIDEO_CAMERA_CONTROL_FOCUS_RELATIVE (1<<6) 154 1.2.2.2 wrstuden #define UVIDEO_CAMERA_CONTROL_IRIS_ABSOLUTE (1<<7) 155 1.2.2.2 wrstuden #define UVIDEO_CAMERA_CONTROL_IRIS_RELATIVE (1<<8) 156 1.2.2.2 wrstuden #define UVIDEO_CAMERA_CONTROL_ZOOM_ABSOLUTE (1<<9) 157 1.2.2.2 wrstuden #define UVIDEO_CAMERA_CONTROL_ZOOM_RELATIVE (1<<10) 158 1.2.2.2 wrstuden #define UVIDEO_CAMERA_CONTROL_PANTILT_ABSOLUTE (1<<11) 159 1.2.2.2 wrstuden #define UVIDEO_CAMERA_CONTROL_PANTILT_RELATIVE (1<<12) 160 1.2.2.2 wrstuden #define UVIDEO_CAMERA_CONTROL_ROLL_ABSOLUTE (1<<13) 161 1.2.2.2 wrstuden #define UVIDEO_CAMERA_CONTROL_ROLL_RELATIVE (1<<14) 162 1.2.2.2 wrstuden /* 15,16 reserved */ 163 1.2.2.2 wrstuden #define UVIDEO_CAMERA_CONTROL_FOCUS_AUTO (1<<17) 164 1.2.2.2 wrstuden #define UVIDEO_CAMERA_CONTROL_PRIVACY (1<<18) 165 1.2.2.2 wrstuden 166 1.2.2.2 wrstuden typedef struct { 167 1.2.2.2 wrstuden uByte bLength; 168 1.2.2.2 wrstuden uByte bDescriptorType; 169 1.2.2.2 wrstuden uByte bDescriptorSubtype; 170 1.2.2.2 wrstuden uByte bUnitID; 171 1.2.2.2 wrstuden uByte bNrInPins; 172 1.2.2.2 wrstuden uByte baSourceID[]; 173 1.2.2.2 wrstuden /* The position of the next field is baSourceID[0] + bNrInPins 174 1.2.2.2 wrstuden * and should be accessed via a function. */ 175 1.2.2.2 wrstuden /* uByte iSelector */ 176 1.2.2.2 wrstuden } UPACKED uvideo_selector_unit_descriptor_t; 177 1.2.2.2 wrstuden 178 1.2.2.2 wrstuden typedef struct { 179 1.2.2.2 wrstuden uByte bLength; 180 1.2.2.2 wrstuden uByte bDescriptorType; 181 1.2.2.2 wrstuden uByte bDescriptorSubtype; 182 1.2.2.2 wrstuden uByte bUnitID; 183 1.2.2.2 wrstuden uByte bSourceID; 184 1.2.2.2 wrstuden uWord wMaxMultiplier; 185 1.2.2.2 wrstuden uByte bControlSize; 186 1.2.2.2 wrstuden uByte bmControls[]; 187 1.2.2.2 wrstuden /* uByte iProcessing */ 188 1.2.2.2 wrstuden /* uByte bmVideoStandards */ 189 1.2.2.2 wrstuden #define PU_GET_VIDEO_STANDARDS(desc) \ 190 1.2.2.2 wrstuden (*((desc)->bmControls + (desc)->bControlSize)) 191 1.2.2.2 wrstuden #define UVIDEO_STANDARD_NONE (1<<0) 192 1.2.2.2 wrstuden #define UVIDEO_STANDARD_NTSC_525_60 (1<<1) 193 1.2.2.2 wrstuden #define UVIDEO_STANDARD_PAL_625_50 (1<<2) 194 1.2.2.2 wrstuden #define UVIDEO_STANDARD_SECAM_625_50 (1<<3) 195 1.2.2.2 wrstuden #define UVIDEO_STANDARD_NTSC_625_50 (1<<4) 196 1.2.2.2 wrstuden #define UVIDEO_STANDARD_PAL_525_60 (1<<5) 197 1.2.2.2 wrstuden } UPACKED uvideo_processing_unit_descriptor_t; 198 1.2.2.2 wrstuden 199 1.2.2.2 wrstuden typedef struct { 200 1.2.2.2 wrstuden uByte bLength; 201 1.2.2.2 wrstuden uByte bDescriptorType; 202 1.2.2.2 wrstuden uByte bDescriptorSubtype; 203 1.2.2.2 wrstuden uByte bUnitID; 204 1.2.2.2 wrstuden usb_guid_t guidExtensionCode; 205 1.2.2.2 wrstuden uByte bNumControls; 206 1.2.2.2 wrstuden uByte bNrInPins; 207 1.2.2.2 wrstuden uByte baSourceID[]; 208 1.2.2.2 wrstuden /* uByte bControlSize */ 209 1.2.2.2 wrstuden /* uByte bmControls */ 210 1.2.2.2 wrstuden #define XU_GET_CONTROL_SIZE(desc) \ 211 1.2.2.2 wrstuden (*((desc)->baSourceID + (desc)->bNrInPins)) 212 1.2.2.2 wrstuden #define XU_GET_CONTROLS(desc) \ 213 1.2.2.2 wrstuden ((desc)->baSourceID + (desc)->bNrInPins + 1) 214 1.2.2.2 wrstuden /* uByte iExtension */ 215 1.2.2.2 wrstuden } UPACKED uvideo_extension_unit_descriptor_t; 216 1.2.2.2 wrstuden 217 1.2.2.2 wrstuden typedef struct { 218 1.2.2.2 wrstuden uByte bLength; 219 1.2.2.2 wrstuden uByte bDescriptorType; /* UDESC_ENDPOINT */ 220 1.2.2.2 wrstuden uByte bDescriptorSubtype; 221 1.2.2.2 wrstuden uWord wMaxTransferSize; 222 1.2.2.2 wrstuden } UPACKED uvideo_vc_interrupt_endpoint_descriptor_t; 223 1.2.2.2 wrstuden 224 1.2.2.2 wrstuden 225 1.2.2.2 wrstuden 226 1.2.2.2 wrstuden /* 227 1.2.2.2 wrstuden * Video Streaming descriptors 228 1.2.2.2 wrstuden */ 229 1.2.2.2 wrstuden 230 1.2.2.2 wrstuden #define UDESC_VS_INPUT_HEADER 0x01 231 1.2.2.2 wrstuden #define UDESC_VS_OUTPUT_HEADER 0x02 232 1.2.2.2 wrstuden #define UDESC_VS_STILL_IMAGE_FRAME 0x03 233 1.2.2.2 wrstuden #define UDESC_VS_FORMAT_UNCOMPRESSED 0x04 234 1.2.2.2 wrstuden #define UDESC_VS_FRAME_UNCOMPRESSED 0x05 235 1.2.2.2 wrstuden #define UDESC_VS_FORMAT_MJPEG 0x06 236 1.2.2.2 wrstuden #define UDESC_VS_FRAME_MJPEG 0x07 237 1.2.2.2 wrstuden /* reserved in spec v1.1 0x08 */ 238 1.2.2.2 wrstuden /* reserved in spec v1.1 0x09 */ 239 1.2.2.2 wrstuden #define UDESC_VS_FORMAT_MPEG2TS 0x0A 240 1.2.2.2 wrstuden /* reserved in spec v 1.1 0x0B */ 241 1.2.2.2 wrstuden #define UDESC_VS_FORMAT_DV 0x0C 242 1.2.2.2 wrstuden #define UDESC_VS_COLORFORMAT 0x0D 243 1.2.2.2 wrstuden /* reserved in spec v1.1 0x0E */ 244 1.2.2.2 wrstuden /* reserved in spec v1.1 0x0F */ 245 1.2.2.2 wrstuden #define UDESC_VS_FORMAT_FRAME_BASED 0x10 246 1.2.2.2 wrstuden #define UDESC_VS_FRAME_FRAME_BASED 0x11 247 1.2.2.2 wrstuden #define UDESC_VS_FORMAT_STREAM_BASED 0x12 248 1.2.2.2 wrstuden 249 1.2.2.2 wrstuden /* Copy protection state */ 250 1.2.2.2 wrstuden #define UVIDEO_NO_RESTRICTIONS 0 251 1.2.2.2 wrstuden #define UVIDEO_RESTRICT_DUP 1 252 1.2.2.2 wrstuden 253 1.2.2.2 wrstuden typedef struct { 254 1.2.2.2 wrstuden uByte bLength; 255 1.2.2.2 wrstuden uByte bDescriptorType; 256 1.2.2.2 wrstuden uByte bDescriptorSubtype; 257 1.2.2.2 wrstuden uByte bNumFormats; 258 1.2.2.2 wrstuden uWord wTotalLength; 259 1.2.2.2 wrstuden uByte bEndpointAddress; 260 1.2.2.2 wrstuden uByte bmInfo; 261 1.2.2.2 wrstuden uByte bTerminalLink; 262 1.2.2.2 wrstuden uByte bStillCaptureMethod; 263 1.2.2.2 wrstuden uByte bTriggerSupport; 264 1.2.2.2 wrstuden uByte bTriggerUsage; 265 1.2.2.2 wrstuden uByte bControlSize; 266 1.2.2.2 wrstuden uByte bmaControls[]; 267 1.2.2.2 wrstuden #define UVIDEO_VS_KEYFRAME_RATE (1<<0) 268 1.2.2.2 wrstuden #define UVIDEO_VS_PFRAME_RATE (1<<1) 269 1.2.2.2 wrstuden #define UVIDEO_VS_COMP_QUALITY (1<<2) 270 1.2.2.2 wrstuden #define UVIDEO_VS_COMP_WINDOW_SIZE (1<<3) 271 1.2.2.2 wrstuden #define UVIDEO_VS_GENERATE_KEYFRAME (1<<4) 272 1.2.2.2 wrstuden #define UVIDEO_VS_UPDATE_FRAME_SEGMENT (1<<5) 273 1.2.2.2 wrstuden } UPACKED uvideo_vs_input_header_descriptor_t; 274 1.2.2.2 wrstuden 275 1.2.2.2 wrstuden typedef struct { 276 1.2.2.2 wrstuden uByte bLength; 277 1.2.2.2 wrstuden uByte bDescriptorType; 278 1.2.2.2 wrstuden uByte bDescriptorSubtype; 279 1.2.2.2 wrstuden uByte bNumFormats; 280 1.2.2.2 wrstuden uWord wTotalLength; 281 1.2.2.2 wrstuden uByte bEndpointAddress; 282 1.2.2.2 wrstuden uByte bTerminalLink; 283 1.2.2.2 wrstuden uByte bControlSize; 284 1.2.2.2 wrstuden uByte bmaControls[]; 285 1.2.2.2 wrstuden } UPACKED uvideo_vs_output_header_descriptor_t; 286 1.2.2.2 wrstuden 287 1.2.2.2 wrstuden 288 1.2.2.2 wrstuden typedef struct { 289 1.2.2.2 wrstuden uWord wWidth; 290 1.2.2.2 wrstuden uWord wHeight; 291 1.2.2.2 wrstuden } UPACKED uvideo_still_image_frame_dimensions_t; 292 1.2.2.2 wrstuden 293 1.2.2.2 wrstuden typedef struct { 294 1.2.2.2 wrstuden uByte bLength; 295 1.2.2.2 wrstuden uByte bDescriptorType; 296 1.2.2.2 wrstuden uByte bDescriptorSubtype; 297 1.2.2.2 wrstuden uByte bEndpointAddress; 298 1.2.2.2 wrstuden uByte bNumImageSizePatterns; 299 1.2.2.2 wrstuden uvideo_still_image_frame_dimensions_t wwaDimensions[]; 300 1.2.2.2 wrstuden /* position dependent on size of previous item */ 301 1.2.2.2 wrstuden /* uByte bNumCompressionPattern */ 302 1.2.2.2 wrstuden /* uByte bCompression[] */ 303 1.2.2.2 wrstuden } UPACKED uvideo_still_image_frame_descriptor_t; 304 1.2.2.2 wrstuden 305 1.2.2.2 wrstuden 306 1.2.2.2 wrstuden /* Color matching information */ 307 1.2.2.2 wrstuden 308 1.2.2.2 wrstuden /* bColroPrimaries */ 309 1.2.2.2 wrstuden #define UVIDEO_COLOR_PRIMARIES_UNSPECIFIED 0 310 1.2.2.2 wrstuden #define UVIDEO_COLOR_PRIMARIES_sRGB 1 /* same as BT709 */ 311 1.2.2.2 wrstuden #define UVIDEO_COLOR_PRIMARIES_BT709 1 /* default */ 312 1.2.2.2 wrstuden #define UVIDEO_COLOR_PRIMARIES_BT470_2_M 2 313 1.2.2.2 wrstuden #define UVIDEO_COLOR_PRIMARIES_BT470_2_BG 3 314 1.2.2.2 wrstuden #define UVIDEO_COLOR_PRIMARIES_SMPTE_170M 4 315 1.2.2.2 wrstuden #define UVIDEO_COLOR_PRIMARIES_SMPTE_240M 5 316 1.2.2.2 wrstuden 317 1.2.2.2 wrstuden /* bTransferCharacteristics */ 318 1.2.2.2 wrstuden #define UVIDEO_GAMMA_FUNCTION_UNSPECIFIED 0 319 1.2.2.2 wrstuden #define UVIDEO_GAMMA_FUNCTION_BT709 1 /* default */ 320 1.2.2.2 wrstuden #define UVIDEO_GAMMA_FUNCTION_BT470_2_M 2 321 1.2.2.2 wrstuden #define UVIDEO_GAMMA_FUNCTION_BT470_2_BG 3 322 1.2.2.2 wrstuden #define UVIDEO_GAMMA_FUNCTION_SMPTE_170M 4 323 1.2.2.2 wrstuden #define UVIDEO_GAMMA_FUNCTION_SMPTE_240M 5 324 1.2.2.2 wrstuden #define UVIDEO_GAMMA_FUNCTION_LINEAR 6 325 1.2.2.2 wrstuden #define UVIDEO_GAMMA_FUNCTION_sRGB 7 /* similar to BT709 */ 326 1.2.2.2 wrstuden 327 1.2.2.2 wrstuden /* bMatrixCoefficients */ 328 1.2.2.2 wrstuden #define UVIDEO_LUMA_CHROMA_MATRIX_UNSPECIFIED 0 329 1.2.2.2 wrstuden #define UVIDEO_LUMA_CHROMA_MATRIX_BT709 1 330 1.2.2.2 wrstuden #define UVIDEO_LUMA_CHROMA_MATRIX_FCC 2 331 1.2.2.2 wrstuden #define UVIDEO_LUMA_CHROMA_MATRIX_BT470_2_BG 3 332 1.2.2.2 wrstuden #define UVIDEO_LUMA_CHROMA_MATRIX_SMPTE_170M 4 /* default */ 333 1.2.2.2 wrstuden #define UVIDEO_LUMA_CHROMA_MATRIX_SMPTE_240M 5 334 1.2.2.2 wrstuden 335 1.2.2.2 wrstuden typedef struct { 336 1.2.2.2 wrstuden uByte bLength; 337 1.2.2.2 wrstuden uByte bDescriptorType; 338 1.2.2.2 wrstuden uByte bDescriptorSubtype; 339 1.2.2.2 wrstuden uByte bColorPrimaries; 340 1.2.2.2 wrstuden uByte bTransferCharacteristics; 341 1.2.2.2 wrstuden uByte bMatrixCoefficients; 342 1.2.2.2 wrstuden } UPACKED uvideo_color_matching_descriptor_t; 343 1.2.2.2 wrstuden 344 1.2.2.2 wrstuden /* 345 1.2.2.2 wrstuden * Format and Frame descriptors 346 1.2.2.2 wrstuden */ 347 1.2.2.2 wrstuden 348 1.2.2.2 wrstuden #define UVIDEO_FRAME_CAP_STILL_IMAGE 1<<0 349 1.2.2.2 wrstuden #define UVIDEO_FRAME_CAP_FIXED_RATE 1<<1 350 1.2.2.2 wrstuden 351 1.2.2.2 wrstuden #define UVIDEO_FRAME_INTERVAL_CONTINUOUS 0 352 1.2.2.2 wrstuden 353 1.2.2.2 wrstuden /* TODO: interlace flags */ 354 1.2.2.2 wrstuden 355 1.2.2.2 wrstuden 356 1.2.2.2 wrstuden typedef struct { 357 1.2.2.2 wrstuden uDWord dwMinFrameInterval; 358 1.2.2.2 wrstuden uDWord dwMaxFrameInterval; 359 1.2.2.2 wrstuden uDWord dwFrameIntervalStep; 360 1.2.2.2 wrstuden } UPACKED uvideo_frame_interval_continuous_t; 361 1.2.2.2 wrstuden 362 1.2.2.2 wrstuden typedef struct { 363 1.2.2.2 wrstuden uDWord dwFrameInterval[1]; /* length depends on bFrameIntervalType */ 364 1.2.2.2 wrstuden } UPACKED uvideo_frame_interval_discrete_t; 365 1.2.2.2 wrstuden 366 1.2.2.2 wrstuden typedef union { 367 1.2.2.2 wrstuden uvideo_frame_interval_continuous_t continuous; 368 1.2.2.2 wrstuden uvideo_frame_interval_discrete_t discrete; 369 1.2.2.2 wrstuden } uvideo_frame_interval_t; 370 1.2.2.2 wrstuden 371 1.2.2.2 wrstuden /* generic format descriptor header */ 372 1.2.2.2 wrstuden typedef struct { 373 1.2.2.2 wrstuden uByte bLength; 374 1.2.2.2 wrstuden uByte bDescriptorType; 375 1.2.2.2 wrstuden uByte bDescriptorSubtype; 376 1.2.2.2 wrstuden uByte bFormatIndex; 377 1.2.2.2 wrstuden } UPACKED uvideo_vs_format_descriptor_t; 378 1.2.2.2 wrstuden 379 1.2.2.2 wrstuden /* generic frame descriptor header */ 380 1.2.2.2 wrstuden typedef struct { 381 1.2.2.2 wrstuden uByte bLength; 382 1.2.2.2 wrstuden uByte bDescriptorType; 383 1.2.2.2 wrstuden uByte bDescriptorSubtype; 384 1.2.2.2 wrstuden uByte bFrameIndex; 385 1.2.2.2 wrstuden } UPACKED uvideo_vs_frame_descriptor_t; 386 1.2.2.2 wrstuden 387 1.2.2.2 wrstuden 388 1.2.2.2 wrstuden /* uncompressed format and frame descriptors */ 389 1.2.2.2 wrstuden static const guid_t uvideo_guid_format_yuy2 = { 390 1.2.2.2 wrstuden 0x32595559, 391 1.2.2.2 wrstuden 0x0000, 392 1.2.2.2 wrstuden 0x0010, 393 1.2.2.2 wrstuden {0x80, 0x00, 0x00, 0xAA, 0x00, 0x38, 0x9B, 0x71} 394 1.2.2.2 wrstuden }; 395 1.2.2.2 wrstuden 396 1.2.2.2 wrstuden static const guid_t uvideo_guid_format_nv12 = { 397 1.2.2.2 wrstuden 0x3231564E, 398 1.2.2.2 wrstuden 0x0000, 399 1.2.2.2 wrstuden 0x0010, 400 1.2.2.2 wrstuden {0x80, 0x00, 0x00, 0xAA, 0x00, 0x38, 0x9B, 0x71} 401 1.2.2.2 wrstuden }; 402 1.2.2.2 wrstuden 403 1.2.2.2 wrstuden typedef struct { 404 1.2.2.2 wrstuden uByte bLength; 405 1.2.2.2 wrstuden uByte bDescriptorType; 406 1.2.2.2 wrstuden uByte bDescriptorSubtype; 407 1.2.2.2 wrstuden uByte bFormatIndex; 408 1.2.2.2 wrstuden uByte bNumFrameDescriptors; 409 1.2.2.2 wrstuden usb_guid_t guidFormat; 410 1.2.2.2 wrstuden uByte bBitsPerPixel; 411 1.2.2.2 wrstuden uByte bDefaultFrameIndex; 412 1.2.2.2 wrstuden uByte bAspectRatioX; 413 1.2.2.2 wrstuden uByte bAspectRatioY; 414 1.2.2.2 wrstuden uByte bmInterlaceFlags; 415 1.2.2.2 wrstuden uByte bCopyProtect; 416 1.2.2.2 wrstuden } UPACKED uvideo_vs_format_uncompressed_descriptor_t; 417 1.2.2.2 wrstuden 418 1.2.2.2 wrstuden typedef struct { 419 1.2.2.2 wrstuden uByte bLength; 420 1.2.2.2 wrstuden uByte bDescriptorType; 421 1.2.2.2 wrstuden uByte bDescriptorSubtype; 422 1.2.2.2 wrstuden uByte bFrameIndex; 423 1.2.2.2 wrstuden uByte bmCapabilities; 424 1.2.2.2 wrstuden uWord wWidth; 425 1.2.2.2 wrstuden uWord wHeight; 426 1.2.2.2 wrstuden uDWord dwMinBitRate; 427 1.2.2.2 wrstuden uDWord dwMaxBitRate; 428 1.2.2.2 wrstuden uDWord dwMaxVideoFrameBufferSize; 429 1.2.2.2 wrstuden uDWord dwDefaultFrameInterval; 430 1.2.2.2 wrstuden uByte bFrameIntervalType; 431 1.2.2.2 wrstuden uvideo_frame_interval_t uFrameInterval; 432 1.2.2.2 wrstuden } UPACKED uvideo_vs_frame_uncompressed_descriptor_t; 433 1.2.2.2 wrstuden 434 1.2.2.2 wrstuden 435 1.2.2.2 wrstuden /* Frame based Format and Frame descriptors. This is for generic 436 1.2.2.2 wrstuden * frame based payloads not covered by other types (e.g, uncompressed 437 1.2.2.2 wrstuden * or MJPEG). */ 438 1.2.2.2 wrstuden 439 1.2.2.2 wrstuden typedef struct { 440 1.2.2.2 wrstuden uByte bLength; 441 1.2.2.2 wrstuden uByte bDescriptorType; 442 1.2.2.2 wrstuden uByte bDescriptorSubtype; 443 1.2.2.2 wrstuden uByte bFormatIndex; 444 1.2.2.2 wrstuden uByte bNumFrameDescriptors; 445 1.2.2.2 wrstuden usb_guid_t guidFormat; 446 1.2.2.2 wrstuden uByte bBitsPerPixel; 447 1.2.2.2 wrstuden uByte bDefaultFrameIndex; 448 1.2.2.2 wrstuden uByte bAspectRatioX; 449 1.2.2.2 wrstuden uByte bAspectRatioY; 450 1.2.2.2 wrstuden uByte bmInterlaceFlags; 451 1.2.2.2 wrstuden uByte bCopyProtect; 452 1.2.2.2 wrstuden } UPACKED uvideo_format_frame_based_descriptor_t; 453 1.2.2.2 wrstuden 454 1.2.2.2 wrstuden typedef struct { 455 1.2.2.2 wrstuden uByte bLength; 456 1.2.2.2 wrstuden uByte bDescriptorType; 457 1.2.2.2 wrstuden uByte bDescriptorSubtype; 458 1.2.2.2 wrstuden uByte bFrameIndex; 459 1.2.2.2 wrstuden uByte bmCapabilities; 460 1.2.2.2 wrstuden uWord wWidth; 461 1.2.2.2 wrstuden uWord wHeight; 462 1.2.2.2 wrstuden uDWord dwMinBitRate; 463 1.2.2.2 wrstuden uDWord dwMaxBitRate; 464 1.2.2.2 wrstuden uDWord dwDefaultFrameInterval; 465 1.2.2.2 wrstuden uByte bFrameIntervalType; 466 1.2.2.2 wrstuden uDWord dwBytesPerLine; 467 1.2.2.2 wrstuden uvideo_frame_interval_t uFrameInterval; 468 1.2.2.2 wrstuden } UPACKED uvideo_frame_frame_based_descriptor_t; 469 1.2.2.2 wrstuden 470 1.2.2.2 wrstuden 471 1.2.2.2 wrstuden /* MJPEG format and frame descriptors */ 472 1.2.2.2 wrstuden 473 1.2.2.2 wrstuden typedef struct { 474 1.2.2.2 wrstuden uByte bLength; 475 1.2.2.2 wrstuden uByte bDescriptorType; 476 1.2.2.2 wrstuden uByte bDescriptorSubtype; 477 1.2.2.2 wrstuden uByte bFormatIndex; 478 1.2.2.2 wrstuden uByte bNumFrameDescriptors; 479 1.2.2.2 wrstuden uByte bmFlags; 480 1.2.2.2 wrstuden #define UVIDEO_NO_FIXED_SIZE_SAMPLES 0 481 1.2.2.2 wrstuden #define UVIDEO_FIXED_SIZE_SAMPLES 1 482 1.2.2.2 wrstuden uByte bDefaultFrameIndex; 483 1.2.2.2 wrstuden uByte bAspectRatioX; 484 1.2.2.2 wrstuden uByte bAspectRatioY; 485 1.2.2.2 wrstuden uByte bmInterlaceFlags; 486 1.2.2.2 wrstuden uByte bCopyProtect; 487 1.2.2.2 wrstuden } UPACKED uvideo_vs_format_mjpeg_descriptor_t; 488 1.2.2.2 wrstuden 489 1.2.2.2 wrstuden typedef struct { 490 1.2.2.2 wrstuden uByte bLength; 491 1.2.2.2 wrstuden uByte bDescriptorType; 492 1.2.2.2 wrstuden uByte bDescriptorSubtype; 493 1.2.2.2 wrstuden uByte bFrameIndex; 494 1.2.2.2 wrstuden uByte bmCapabilities; 495 1.2.2.2 wrstuden uWord wWidth; 496 1.2.2.2 wrstuden uWord wHeight; 497 1.2.2.2 wrstuden uDWord dwMinBitRate; 498 1.2.2.2 wrstuden uDWord dwMaxBitRate; 499 1.2.2.2 wrstuden uDWord dwMaxVideoFrameBufferSize; 500 1.2.2.2 wrstuden uDWord dwDefaultFrameInterval; 501 1.2.2.2 wrstuden uByte bFrameIntervalType; 502 1.2.2.2 wrstuden uvideo_frame_interval_t uFrameInterval; 503 1.2.2.2 wrstuden } UPACKED uvideo_vs_frame_mjpeg_descriptor_t; 504 1.2.2.2 wrstuden 505 1.2.2.2 wrstuden 506 1.2.2.2 wrstuden typedef struct { 507 1.2.2.2 wrstuden uByte bLength; 508 1.2.2.2 wrstuden uByte bDescriptorType; 509 1.2.2.2 wrstuden uByte bDescriptorSubtype; 510 1.2.2.2 wrstuden uByte bFormatIndex; 511 1.2.2.2 wrstuden uDWord dwMaxVideoFrameBufferSize; 512 1.2.2.2 wrstuden uByte bFormatType; 513 1.2.2.2 wrstuden #define UVIDEO_GET_DV_FREQ(ubyte) (((ubyte)>>7) & 1) 514 1.2.2.2 wrstuden #define UVIDEO_DV_FORMAT_FREQ_50HZ 0 515 1.2.2.2 wrstuden #define UVIDEO_DV_FORMAT_FREQ_60HZ 1 516 1.2.2.2 wrstuden #define UVIDEO_GET_DV_FORMAT(ubyte) ((ubyte) & 0x3f) 517 1.2.2.2 wrstuden #define UVIDEO_DV_FORMAT_SD_DV 0 518 1.2.2.2 wrstuden #define UVIDEO_DV_FORMAT_SDL_DV 1 519 1.2.2.2 wrstuden #define UVIDEO_DV_FORMAT_HD_DV 2 520 1.2.2.2 wrstuden } UPACKED uvideo_vs_format_dv_descriptor_t; 521 1.2.2.2 wrstuden 522 1.2.2.2 wrstuden 523 1.2.2.2 wrstuden 524 1.2.2.2 wrstuden /* 525 1.2.2.2 wrstuden * Video Control requests 526 1.2.2.2 wrstuden */ 527 1.2.2.2 wrstuden 528 1.2.2.2 wrstuden /* Pseudo bitmasks that only work when bitwise OR onto a zeroed value */ 529 1.2.2.2 wrstuden #define UVIDEO_REQUEST_TYPE_INTERFACE (0x0001) 530 1.2.2.2 wrstuden #define UVIDEO_REQUEST_TYPE_ENDPOINT (0x0010) 531 1.2.2.2 wrstuden #define UVIDEO_REQUEST_TYPE_CLASS_SPECIFIC (0x01 << 5) 532 1.2.2.2 wrstuden #define UVIDEO_REQUEST_TYPE_SET (0x0 << 7) 533 1.2.2.2 wrstuden #define UVIDEO_REQUEST_TYPE_GET (0x1 << 7) 534 1.2.2.2 wrstuden 535 1.2.2.2 wrstuden typedef enum { 536 1.2.2.2 wrstuden UVIDEO_REQUEST_DESC_INTERFACE, 537 1.2.2.2 wrstuden UVIDEO_REQUEST_DESC_ENDPOINT 538 1.2.2.2 wrstuden } uvideo_request_descriptor; 539 1.2.2.2 wrstuden 540 1.2.2.2 wrstuden typedef enum { 541 1.2.2.2 wrstuden UR_RC_UNDEFINED = 0x00, 542 1.2.2.2 wrstuden UR_SET_CUR = 0x01, 543 1.2.2.2 wrstuden UR_GET_CUR = 0x81, 544 1.2.2.2 wrstuden UR_GET_MIN = 0x82, 545 1.2.2.2 wrstuden UR_GET_MAX = 0x83, 546 1.2.2.2 wrstuden UR_GET_RES = 0x84, 547 1.2.2.2 wrstuden UR_GET_LEN = 0x85, 548 1.2.2.2 wrstuden UR_GET_INFO = 0x86, 549 1.2.2.2 wrstuden UR_GET_DEF = 0x87, 550 1.2.2.2 wrstuden } uvideo_request; 551 1.2.2.2 wrstuden 552 1.2.2.2 wrstuden /* camera terminal control selectors */ 553 1.2.2.2 wrstuden #define UVIDEO_CT_CONTROL_UNDEFINED 0x00 554 1.2.2.2 wrstuden #define UVIDEO_CT_SCANNING_MODE_CONTROL 0x01 555 1.2.2.2 wrstuden #define UVIDEO_CT_AE_MODE_CONTROL 0x02 556 1.2.2.2 wrstuden #define UVIDEO_CT_EXPOSURE_TIME_ABSOLUTE_CONTROL 0x04 557 1.2.2.2 wrstuden #define UVIDEO_CT_EXPOSURE_TIME_RELATIVE_CONTROL 0x05 558 1.2.2.2 wrstuden #define UVIDEO_CT_FOCUS_ABSOLUTE_CONTROL 0x06 559 1.2.2.2 wrstuden #define UVIDEO_CT_FOCUS_RELATIVE_CONTROL 0x07 560 1.2.2.2 wrstuden #define UVIDEO_CT_IRIS_ABSOLUTE_CONTROL 0x09 561 1.2.2.2 wrstuden #define UVIDEO_CT_IRIS_RELATIVE_CONTROL 0x0A 562 1.2.2.2 wrstuden #define UVIDEO_CT_ZOOM_ABSOLUTE_CONTROL 0x0B 563 1.2.2.2 wrstuden #define UVIDEO_CT_ZOOM_RELATIVE_CONTROL 0x0C 564 1.2.2.2 wrstuden #define UVIDEO_CT_PANTILT_ABSOLUTE_CONTROL 0x0D 565 1.2.2.2 wrstuden #define UVIDEO_CT_PANTILT_RELATIVE_CONTROL 0x0E 566 1.2.2.2 wrstuden #define UVIDEO_CT_ROLL_ABSOLUTE_CONTROL 0x0F 567 1.2.2.2 wrstuden #define UVIDEO_CT_ROLL_RELATIVE_CONTROL 0x10 568 1.2.2.2 wrstuden #define UVIDEO_CT_PRIVACY_CONTROL 0x11 569 1.2.2.2 wrstuden 570 1.2.2.2 wrstuden /* processing unit control selectors */ 571 1.2.2.2 wrstuden #define UVIDEO_PU_CONTROL_UNDEFINED 0x00 572 1.2.2.2 wrstuden #define UVIDEO_PU_BACKLIGHT_COMPENSATION_CONTROL 0x01 573 1.2.2.2 wrstuden #define UVIDEO_PU_BRIGHTNESS_CONTROL 0x02 574 1.2.2.2 wrstuden #define UVIDEO_PU_CONTRAST_CONTROL 0x03 575 1.2.2.2 wrstuden #define UVIDEO_PU_GAIN_CONTROL 0x04 576 1.2.2.2 wrstuden #define UVIDEO_PU_POWER_LINE_FREQUENCY_CONTROL 0x05 577 1.2.2.2 wrstuden #define UVIDEO_PU_HUE_CONTROL 0x06 578 1.2.2.2 wrstuden #define UVIDEO_PU_SATURATION_CONTROL 0x07 579 1.2.2.2 wrstuden #define UVIDEO_PU_SHARPNESS_CONTROL 0x08 580 1.2.2.2 wrstuden #define UVIDEO_PU_GAMMA_CONTROL 0x09 581 1.2.2.2 wrstuden #define UVIDEO_PU_WHITE_BALANCE_TEMPERATURE_CONTROL 0x0A 582 1.2.2.2 wrstuden #define UVIDEO_PU_WHITE_BALANCE_TEMPERATURE_AUTO_CONTROL 0x0B 583 1.2.2.2 wrstuden #define UVIDEO_PU_WHITE_BALANCE_COMPONENT_CONTROL 0x0C 584 1.2.2.2 wrstuden #define UVIDEO_PU_WHITE_BALANCE_COMPONENT_AUTO_CONTROL 0x0D 585 1.2.2.2 wrstuden #define UVIDEO_PU_DIGITAL_MULTIPLIER_CONTROL 0x0E 586 1.2.2.2 wrstuden #define UVIDEO_PU_DIGITAL_MULTIPLIER_LIMIT_CONTROL 0x0F 587 1.2.2.2 wrstuden #define UVIDEO_PU_HUE_AUTO_CONTROL 0x10 588 1.2.2.2 wrstuden #define UVIDEO_PU_ANALOG_VIDEO_STANDARD_CONTROL 0x11 589 1.2.2.2 wrstuden #define UVIDEO_PU_ANALOG_LOCK_STATUS_CONTROL 0x12 590 1.2.2.2 wrstuden 591 1.2.2.2 wrstuden /* extension unit control selectors */ 592 1.2.2.2 wrstuden #define UVIDEO_XU_CONTROL_UNDEFINED 0x00 593 1.2.2.2 wrstuden 594 1.2.2.2 wrstuden /* VideoStreaming Interface control selectors */ 595 1.2.2.2 wrstuden #define UVIDEO_VS_CONTROL_UNDEFINED 0x00 596 1.2.2.2 wrstuden #define UVIDEO_VS_PROBE_CONTROL 0x01 597 1.2.2.2 wrstuden #define UVIDEO_VS_COMMIT_CONTROL 0x02 598 1.2.2.2 wrstuden #define UVIDEO_VS_STILL_PROBE_CONTROL 0x03 599 1.2.2.2 wrstuden #define UVIDEO_VS_STILL_COMMIT_CONTROL 0x04 600 1.2.2.2 wrstuden #define UVIDEO_VS_STILL_IMAGE_TRIGGER_CONTROL 0x05 601 1.2.2.2 wrstuden #define UVIDEO_VS_STREAM_ERROR_CODE_CONTROL 0x06 602 1.2.2.2 wrstuden #define UVIDEO_VS_GENERATE_KEY_FRAME_CONTROL 0x07 603 1.2.2.2 wrstuden #define UVIDEO_VS_UPDATE_FRAME_SEGMENT_CONTROL 0x08 604 1.2.2.2 wrstuden #define UVIDEO_VS_SYNCH_DELAY_CONTROL 0x09 605 1.2.2.2 wrstuden 606 1.2.2.2 wrstuden /* bitmask result of GET_INFO on a control */ 607 1.2.2.2 wrstuden #define UVIDEO_CONTROL_INFO_SUPPORTS_GET (1<<0) 608 1.2.2.2 wrstuden #define UVIDEO_CONTROL_INFO_SUPPORTS_SET (1<<1) 609 1.2.2.2 wrstuden #define UVIDEO_CONTROL_INFO_DISABLED (1<<2) 610 1.2.2.2 wrstuden #define UVIDEO_CONTROL_INFO_AUTOUPDATE (1<<3) 611 1.2.2.2 wrstuden #define UVIDEO_CONTROL_INFO_ASYNC (1<<4) 612 1.2.2.2 wrstuden 613 1.2.2.2 wrstuden 614 1.2.2.2 wrstuden /* Video Probe and Commit Controls request data */ 615 1.2.2.2 wrstuden typedef struct { 616 1.2.2.2 wrstuden uWord bmHint; 617 1.2.2.2 wrstuden #define UVIDEO_HINT_FRAME_INTERVAL (1<<0) 618 1.2.2.2 wrstuden #define UVIDEO_HINT_KEYFRAME_RATE (1<<1) 619 1.2.2.2 wrstuden #define UVIDEO_HINT_PFRAME_RATE (1<<2) 620 1.2.2.2 wrstuden #define UVIDEO_HINT_COMP_QUALITY (1<<3) 621 1.2.2.2 wrstuden #define UVIDEO_HINT_COMP_WINDOW_SIZE (1<<4) 622 1.2.2.2 wrstuden uByte bFormatIndex; 623 1.2.2.2 wrstuden uByte bFrameIndex; 624 1.2.2.2 wrstuden uDWord dwFrameInterval; 625 1.2.2.2 wrstuden #define UVIDEO_100NS_PER_MS 10000 626 1.2.2.2 wrstuden #define UVIDEO_FRAME_INTERVAL_UNITS_PER_USB_FRAME UVIDEO_100NS_PER_MS 627 1.2.2.2 wrstuden uWord wKeyFrameRate; 628 1.2.2.2 wrstuden uWord wPFrameRate; 629 1.2.2.2 wrstuden uWord wCompQuality; 630 1.2.2.2 wrstuden uWord wCompWindowSize; 631 1.2.2.2 wrstuden uWord wDelay; 632 1.2.2.2 wrstuden uDWord dwMaxVideoFrameSize; 633 1.2.2.2 wrstuden uDWord dwMaxPayloadTransferSize; 634 1.2.2.2 wrstuden /* Following fields are not in v1.0 of UVC. Will have to do 635 1.2.2.2 wrstuden * UR_GET_LEN to discover the length of this descriptor. */ 636 1.2.2.2 wrstuden uDWord dwClockFrequency; 637 1.2.2.2 wrstuden uByte bmFramingInfo; 638 1.2.2.2 wrstuden #define UVIDEO_FRAMING_INFO_FID (1<<0) 639 1.2.2.2 wrstuden #define UVIDEO_FRAMING_INFO_EOF (1<<1) 640 1.2.2.2 wrstuden uByte bPreferedVersion; 641 1.2.2.2 wrstuden uByte bMinVersion; 642 1.2.2.2 wrstuden uByte bMaxVersion; 643 1.2.2.2 wrstuden } UPACKED uvideo_probe_and_commit_data_t; 644 1.2.2.2 wrstuden 645 1.2.2.2 wrstuden /* Video Still Probe and Still Commit Controls request data */ 646 1.2.2.2 wrstuden typedef struct { 647 1.2.2.2 wrstuden uByte bFormatIndex; 648 1.2.2.2 wrstuden uByte bFrameIndex; 649 1.2.2.2 wrstuden uByte bCompressionIndex; 650 1.2.2.2 wrstuden uDWord dwMaxVideoFrameSize; 651 1.2.2.2 wrstuden uDWord dwMaxPayloadTransferSize; 652 1.2.2.2 wrstuden } UPACKED uvideo_still_probe_and_still_commit_data_t; 653 1.2.2.2 wrstuden #define UVIDEO_STILL_PROBE_AND_STILL_COMMIT_DATA_SIZE 11; 654 1.2.2.2 wrstuden 655 1.2.2.2 wrstuden 656 1.2.2.2 wrstuden 657 1.2.2.2 wrstuden /* common header for Video Control and Video Stream status */ 658 1.2.2.2 wrstuden typedef struct { 659 1.2.2.2 wrstuden uByte bStatusType; 660 1.2.2.2 wrstuden #define UV_STATUS_TYPE_CONTROL 0x02 661 1.2.2.2 wrstuden #define UV_STATUS_TYPE_STREAM 0x04 662 1.2.2.2 wrstuden uByte bOriginator; 663 1.2.2.2 wrstuden } UPACKED uvideo_status_t; 664 1.2.2.2 wrstuden 665 1.2.2.2 wrstuden typedef struct { 666 1.2.2.2 wrstuden uByte bStatusType; 667 1.2.2.2 wrstuden uByte bOriginator; 668 1.2.2.2 wrstuden uByte bEvent; 669 1.2.2.2 wrstuden #define UV_CONTROL_CHANGE 0x00 /* any other value is Reserved */ 670 1.2.2.2 wrstuden uByte bSelector; 671 1.2.2.2 wrstuden uByte bAttribute; 672 1.2.2.2 wrstuden #define UV_CONTROL_VALUE_CHANGE 0x00 673 1.2.2.2 wrstuden #define UV_CONTROL_INFO_CHANGE 0x01 674 1.2.2.2 wrstuden #define UV_CONTROL_FAILURE_CHANGE 0x02 675 1.2.2.2 wrstuden uByte bValue; 676 1.2.2.2 wrstuden } UPACKED uvideo_control_status_t; 677 1.2.2.2 wrstuden 678 1.2.2.2 wrstuden typedef struct { 679 1.2.2.2 wrstuden uByte bStatusType; 680 1.2.2.2 wrstuden uByte bOriginator; 681 1.2.2.2 wrstuden uByte bEvent; 682 1.2.2.2 wrstuden #define UV_BUTTON_PRESS 0x00 /* any other value is Stream Error */ 683 1.2.2.2 wrstuden uByte bValue; 684 1.2.2.2 wrstuden #define UV_BUTTON_RELEASED 0x00 685 1.2.2.2 wrstuden #define UV_BUTTON_PRESSED 0x01 686 1.2.2.2 wrstuden } UPACKED uvideo_streaming_status_t; 687 1.2.2.2 wrstuden 688 1.2.2.2 wrstuden typedef struct { 689 1.2.2.2 wrstuden uByte bHeaderLength; 690 1.2.2.2 wrstuden uByte bmHeaderInfo; 691 1.2.2.2 wrstuden #define UV_FRAME_ID 1<<0 692 1.2.2.2 wrstuden #define UV_END_OF_FRAME 1<<1 693 1.2.2.2 wrstuden #define UV_PRES_TIME 1<<2 694 1.2.2.2 wrstuden #define UV_SRC_CLOCK 1<<3 695 1.2.2.2 wrstuden /* D4: Reserved */ 696 1.2.2.2 wrstuden #define UV_STILL_IMAGE 1<<5 697 1.2.2.2 wrstuden #define UV_ERROR 1<<6 698 1.2.2.2 wrstuden #define UV_END_OF_HDR 1<<7 699 1.2.2.2 wrstuden /* other fields depend on which bits are set above and have no fixed offset */ 700 1.2.2.2 wrstuden /* uDWord dwPresentationTime; */ 701 1.2.2.2 wrstuden #define UVIDEO_PTS_SIZE 4 702 1.2.2.2 wrstuden /* uByte scrSourceClock[UVIDEO_SOURCE_CLOCK_SIZE]; */ 703 1.2.2.2 wrstuden #define UVIDEO_SOURCE_CLOCK_SIZE 6 704 1.2.2.2 wrstuden #define UV_GET_SOURCE_TIME_CLOCK(sc) (UGETDW(sc)) 705 1.2.2.2 wrstuden /* bits 42..32 */ 706 1.2.2.2 wrstuden #define UV_GET_SOF_COUNTER(sc) (((sc)[4] | ((sc)[5] << 8)) &0x7ff) 707 1.2.2.2 wrstuden } UPACKED uvideo_payload_header_t; 708 1.2.2.2 wrstuden 709 1.2.2.2 wrstuden /* Note: this might be larger depending on presence of source clock, 710 1.2.2.2 wrstuden SOF counter, or other things... bHeaderLength is actual length. */ 711 1.2.2.2 wrstuden #define UVIDEO_PAYLOAD_HEADER_SIZE 12 712 1.2.2.2 wrstuden 713
Indexes created Wed Oct 22 13:09:56 GMT 2025