UVC 输入终端描述符
2020-09-30
2494
0
输入终端描述符用于向主机报告视频数据输入终端的相关信息。
输入终端描述符使用bTerminalID描述输入终端的ID,且这个ID是惟一的。
输入终端描述符位于视频控制接口中。
输入终端描述符结构体定义如下:
// Input Terminal Descriptor
typedef struct _USB_IT_DESCRIPTOR
{
UINT8 bLength;
UINT8 bDescriptorType;
UINT8 bDescriptorSubtype;
UINT8 bTerminalID;
UINT16 wTerminalType;
UINT8 bAssocTerminal;
UINT8 iTerminal;
UINT8 reserved[0];
} USB_IT_DESCRIPTOR;
- bLength :输入终端描述符结构体的大小。8 (+ x)
- bDescriptorType:输入终端描述符类型。CS_INTERFACE,值为0X24;
- bDescriptorSubtype:输入终端描述符子类型。VC_INPUT_TERMINAL ,值为0x02。
- bTerminalID:输入终端描述符的ID,非零值。所有请求使用此值来寻址输入端点。
- wTerminalType:终端类型。见UVC端点类型。
- bAssocTerminal:此输入终端关联的输出终端,如没有则为0.
- iTerminal:描述此输入终端的字符串描述符索引。
- reserved:根据终端类型,某些输入终端描述符具有附加字段。
输入终端类型
类型 | 值 | IO | 描述 |
---|---|---|---|
ITT_VENDOR_SPECIFIC | 0x200 | I | 厂商指定输入端点 |
ITT_CAMERA | 0x201 | I | 摄像头,仅用于摄像头端点描述符 |
ITT_MEDIA_TRANSPORT_INPUT | 0x202 | I | 序列媒体,仅用于媒体端点描述符 |
TT_VENDOR_SPECIFIC | 0x100 | I/O | 厂商特定的接口端点 |
TT_STREAMING | 0x101 | I/O | 视频流接口端点 |
相机输入终端描述符示例
-------- Video Control Input Terminal Descriptor ------
bLength : 0x12 (18 bytes)
bDescriptorType : 0x24 (Video Control Interface)
bDescriptorSubtype : 0x02 (Input Terminal)
bTerminalID : 0x01 (1)
wTerminalType : 0x0201 (ITT_CAMERA)
bAssocTerminal : 0x00 (Not associated with an Output Terminal)
iTerminal : 0x00 (No String Descriptor)
Camera Input Terminal Data:
wObjectiveFocalLengthMin : 0x0000
wObjectiveFocalLengthMax : 0x0000
wOcularFocalLength : 0x0000
bControlSize : 0x03 (3 bytes)
bmControls : 0x0E, 0x00, 0x20
D0 : 0 no - Scanning Mode
D1 : 1 yes - Auto-Exposure Mode
D2 : 1 yes - Auto-Exposure Priority
D3 : 1 yes - Exposure Time (Absolute)
D4 : 0 no - Exposure Time (Relative)
D5 : 0 no - Focus (Absolute)
D6 : 0 no - Focus (Relative)
D7 : 0 no - Iris (Absolute)
D8 : 0 no - Iris (Relative)
D9 : 0 no - Zoom (Absolute)
D10 : 0 no - Zoom (Relative)
D11 : 0 no - Pan (Absolute)
D12 : 0 no - Pan (Relative)
D13 : 0 no - Roll (Absolute)
D14 : 0 no - Roll (Relative)
D15 : 0 no - Tilt (Absolute)
D16 : 0 no - Tilt (Relative)
D17 : 0 no - Focus Auto
D18 : 0 no - Reserved
D19 : 0 no - Reserved
D20 : 0 no - Reserved
D21 : 1 yes - Reserved
D22 : 0 no - Reserved
D23 : 0 no - Reserved
Data (HexDump) : 12 24 02 01 01 02 00 00 00 00 00 00 00 00 03 0E .$..............
00 20 .
HID人机交互QQ群:564808376
UAC音频QQ群:218581009
UVC相机QQ群:331552032
BOT&UASP大容量存储QQ群:258159197
STC-USB单片机QQ群:315457461
USB技术交流QQ群2:580684376
USB技术交流QQ群:952873936