571 lines
16 KiB
C
571 lines
16 KiB
C
|
/* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */
|
||
|
|
/*
|
||
|
|
* 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
|
||
|
|
#define UVC_PC_PROTOCOL_15 0x01
|
||
|
|
|
||
|
|
/* 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
|
||
|
|
|
||
|
|
/* 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)
|
||
|
|
|
||
|
|
/* 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)
|
||
|
|
|
||
|
|
/* ------------------------------------------------------------------------
|
||
|
|
* 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;
|
||
|
|
__le16 bcdUVC;
|
||
|
|
__le16 wTotalLength;
|
||
|
|
__le32 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; \
|
||
|
|
__le16 bcdUVC; \
|
||
|
|
__le16 wTotalLength; \
|
||
|
|
__le32 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;
|
||
|
|
__le16 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;
|
||
|
|
__le16 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;
|
||
|
|
__le16 wTerminalType;
|
||
|
|
__u8 bAssocTerminal;
|
||
|
|
__u8 iTerminal;
|
||
|
|
__le16 wObjectiveFocalLengthMin;
|
||
|
|
__le16 wObjectiveFocalLengthMax;
|
||
|
|
__le16 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;
|
||
|
|
__le16 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;
|
||
|
|
__le16 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;
|
||
|
|
__le16 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; \
|
||
|
|
__le16 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;
|
||
|
|
__le16 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; \
|
||
|
|
__le16 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;
|
||
|
|
__le16 wWidth;
|
||
|
|
__le16 wHeight;
|
||
|
|
__le32 dwMinBitRate;
|
||
|
|
__le32 dwMaxBitRate;
|
||
|
|
__le32 dwMaxVideoFrameBufferSize;
|
||
|
|
__le32 dwDefaultFrameInterval;
|
||
|
|
__u8 bFrameIntervalType;
|
||
|
|
__le32 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; \
|
||
|
|
__le16 wWidth; \
|
||
|
|
__le16 wHeight; \
|
||
|
|
__le32 dwMinBitRate; \
|
||
|
|
__le32 dwMaxBitRate; \
|
||
|
|
__le32 dwMaxVideoFrameBufferSize; \
|
||
|
|
__le32 dwDefaultFrameInterval; \
|
||
|
|
__u8 bFrameIntervalType; \
|
||
|
|
__le32 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;
|
||
|
|
__le16 wWidth;
|
||
|
|
__le16 wHeight;
|
||
|
|
__le32 dwMinBitRate;
|
||
|
|
__le32 dwMaxBitRate;
|
||
|
|
__le32 dwMaxVideoFrameBufferSize;
|
||
|
|
__le32 dwDefaultFrameInterval;
|
||
|
|
__u8 bFrameIntervalType;
|
||
|
|
__le32 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; \
|
||
|
|
__le16 wWidth; \
|
||
|
|
__le16 wHeight; \
|
||
|
|
__le32 dwMinBitRate; \
|
||
|
|
__le32 dwMaxBitRate; \
|
||
|
|
__le32 dwMaxVideoFrameBufferSize; \
|
||
|
|
__le32 dwDefaultFrameInterval; \
|
||
|
|
__u8 bFrameIntervalType; \
|
||
|
|
__le32 dwFrameInterval[n]; \
|
||
|
|
} __attribute__ ((packed))
|
||
|
|
|
||
|
|
#endif /* __LINUX_USB_VIDEO_H */
|
||
|
|
|