UVC 相机终端控制请求
相机终端控制有20种,分别如下:
ControlSelector | Value |
---|---|
CT_CONTROL_UNDEFINED | 0x00 |
CT_SCANNING_MODE_CONTROL | 0x01 |
CT_AE_MODE_CONTROL | 0x02 |
CT_AE_PRIORITY_CONTROL | 0x03 |
CT_EXPOSURE_TIME_ABSOLUTE_CONTROL | 0x04 |
CT_EXPOSURE_TIME_RELATIVE_CONTROL | 0x05 |
CT_FOCUS_ABSOLUTE_CONTROL | 0x06 |
CT_FOCUS_RELATIVE_CONTROL | 0x07 |
CT_FOCUS_AUTO_CONTROL | 0x08 |
CT_IRIS_ABSOLUTE_CONTROL | 0x09 |
CT_IRIS_RELATIVE_CONTROL | 0x0A |
CT_ZOOM_ABSOLUTE_CONTROL | 0x0B |
CT_ZOOM_RELATIVE_CONTROL | 0x0C |
CT_PANTILT_ABSOLUTE_CONTROL | 0x0D |
CT_PANTILT_RELATIVE_CONTROL | 0x0E |
CT_ROLL_ABSOLUTE_CONTROL | 0x0F |
CT_ROLL_RELATIVE_CONTROL | 0x10 |
CT_PRIVACY_CONTROL | 0x11 |
CT_FOCUS_SIMPLE_CONTROL | 0x12 |
CT_WINDOW_CONTROL | 0x13 |
CT_REGION_OF_INTEREST_CONTROL | 0x14 |
1.扫描模式控制
使用CT_SCANNING_MODE_CONTROL进行控制相机传感器的扫描模式。值为0表示启用了隔行扫描模式,值为1表示启用了逐行扫描或非隔行扫描模式。
bmRequestType | bRequest | wValue | wIndex | wLength | Data |
---|---|---|---|---|---|
00100001 | SET_CUR | 控制选择子 | 相机ID | 1 | bScanningMode |
10100001 | GET_CUR GET_INFO |
控制选择子 | 相机ID | 1 | bScanningMode |
bScanningMode寻址扫描模式控制的属性设置:
- 0:交错(Interlaced)
- 1: 进步的(Progressive)
2.自动曝光模式控制
使用CT_AE_MODE_CONTROL进行自动曝光模式控制
bmRequestType | bRequest | wValue | wIndex | wLength | Data |
---|---|---|---|---|---|
00100001 | SET_CUR | 控制选择子 | 相机ID | 1 | bAutoExposureMode |
10100001 | GET_CUR, GET_RES, GET_INFO, GET_DEF | 控制选择子 | 相机ID | 1 | bAutoExposureMode |
bAutoExposureMode寻址自动曝光模式控制的属性设置:
- D0:手动模式-手动曝光时间,手动光圈
- D1:自动模式-自动曝光时间,自动光圈
- D2:快门优先模式-手动曝光时间,自动光圈
- D3:光圈优先模式-自动曝光时间,手动光圈
- D4..D7:保留,设置为零。
支持该功能的前提是支持自动曝光时间和虹膜的支持。原文是:The Auto-Exposure Mode Control determines whether the device will provide automatic adjustment of the Exposure Time and Iris controls. Attempts to programmatically set the autoadjusted controls shall result in a protocol STALL and an error code of bRequestErrorCode =“Wrong state”.
3.自动曝光优先级控制
使用CT_AE_PRIORITY_CONTROL进行自动曝光优先控制。
bmRequestType | bRequest | wValue | wIndex | wLength | Data |
---|---|---|---|---|---|
00100001 | SET_CUR | 控制选择子 | 相机ID | 5 | wProfile |
10100001 | GET_CUR, GET_DEF, GET_INFO, GET_LEN | 控制选择子 | 相机ID | 5 | 数据块 |
数据块包括wProfile,wConstrainedToolset和bmSettings.
wProfile: 1字节,指示当前格式的配置文件和适用的约束。此字段用于支持多个配置文件的视频格式。例如,对于H.264:
- 0x4240:约束基线配置文件
- 0x4200:基线配置文件
- 0x4D00:主配置文件
- 0x640C:受约束的高配置文件
- 0x6400:高调
- 0x5304:可伸缩的受限基线概要文件
- 0x5300:可伸缩基线配置文件
- 0x5604:可扩展的受限高配置文件
- 0x5600:可扩展的高配置文件
- 0x7600:多视图高调
- 0x8000:立体声高调
wConstrainedToolset:2字节,值为0.
bmSettings:1字节,此位图启用视频格式描述符的bmCapabilities字段报告的功能。
4.曝光时间(绝对)控制
控制选择子 | CT_EXPOSURE_TIME_ABSOLUTE_CONTROL |
---|---|
强制性请求 | GET_CUR, GET_MIN, GET_MAX, GET_RES, GET_INFO, GET_DEF |
可选的请求 | SET_CUR |
长度 | 4 |
偏移 | 数据 | 长度 | 值 | 描述 |
---|---|---|---|---|
0 | dwExposureTimeAbsolute | 4 | 数字 | 寻址曝光时间(绝对)控制的属性设置: 0:保留 1: 0.0001秒 … 100000:10秒 … |
5.曝光时间(相对)控制
控制选择子 | CT_EXPOSURE_TIME_RELATIVE_CONTROL |
---|---|
强制性请求 | SET_CUR, GET_CUR, GET_INFO |
长度 | 1 |
偏移 | 数据 | 长度 | 值 | 描述 |
---|---|---|---|---|
0 | bExposureTimeRelative | 1 | 无符号数字 | 寻址曝光时间(相对)控制的属性设置: 0:默认值 1: 递增1步 0xFF:递减1步 |
6.焦点(绝对)控制
控制选择子 | CT_FOCUS_ABSOLUTE_CONTROL |
---|---|
强制性请求 | GET_CUR, GET_MIN, GET_MAX, GET_RES, GET_INFO, GET_DEF |
可选的请求 | SET_CUR |
长度 | 2 |
偏移 | 数据 | 长度 | 值 | 描述 |
---|---|---|---|---|
0 | wFocusAbsolute | 2 | 数字 | 寻址焦点(绝对)控制的属性设置。 |
7.焦点(相对)控制
控制选择子 | CT_FOCUS_RELATIVE_CONTRO |
---|---|
强制性请求 | SET_CUR, GET_CUR, GET_INFO, GET_DEF, GET_MIN, GET_MAX, GET_RES |
长度 | 2 |
偏移 | 数据 | 长度 | 值 | 描述 |
---|---|---|---|---|
0 | bFocusRelative | 1 | 有符号数字 | 0:停止 1:近方向聚焦 0xff:远方向聚焦 |
1 | bFocusRelative | 1 | 数字 | 控制改变速度 |
感谢老吕,对原错误内容的指出,现已修改。
8.聚焦,自动控制
控制选择子 | CT_FOCUS_AUTO_CONTROL |
---|---|
强制性请求 | SET_CUR, GET_CUR, GET_INFO, GET_DEF |
长度 | 1 |
偏移 | 数据 | 长度 | 值 | 描述 |
---|---|---|---|---|
0 | bFocusAuto | 1 | 布尔 | 寻址焦点自动控制的属性设置。 |
9.虹膜(绝对)控制
控制选择子 | CT_IRIS_ABSOLUTE_CONTROL |
---|---|
强制性请求 | GET_CUR, GET_MIN, GET_MAX, GET_RES, GET_INFO, GET_DEF |
可选的请求 | SET_CUR |
长度 | 2 |
偏移 | 数据 | 长度 | 值 | 描述 |
---|---|---|---|---|
0 | wIrisAbsolute | 2 | 数字 | 寻址虹膜(绝对)控制的属性设置。 |
10.虹膜(相对)控制
控制选择子 | CT_IRIS_RELATIVE_CONTROL |
---|---|
强制性请求 | SET_CUR, GET_CUR, GET_INFO |
长度 | 1 |
偏移 | 数据 | 长度 | 值 | 描述 |
---|---|---|---|---|
0 | bIrisRelative | 1 | 数字 | 相对虹膜控制属性的设置: 0:默认值 1: 虹膜1步打开。 0xFF:虹膜1步关闭。 |
11.缩放(绝对)控制
控制选择子 | CT_ZOOM_ABSOLUTE_CONTROL |
---|---|
强制性请求 | GET_CUR, GET_MIN, GET_MAX, GET_RES, GET_INFO, GET_DEF |
先择性请求 | SET_CUR |
长度 | 2 |
偏移 | 数据 | 长度 | 值 | 描述 |
---|---|---|---|---|
0 | wObjectiveFocalLength | 2 | 数字 | Zcur值 |
12.缩放(相对)控制
控制选择子 | CT_ZOOM_RELATIVE_CONTROL |
---|---|
强制性请求 | SET_CUR, GET_CUR, GET_INFO, GET_DEF, GET_MIN, GET_MAX, GET_RES |
长度 | 3 |
偏移 | 数据 | 长度 | 值 | 描述 |
---|---|---|---|---|
0 | bZoom | 1 | 无符号数字 | 寻址缩放控制的属性设置: 0:停止 1: 移动到远摄方向 0xFF:向广角方向移动 |
1 | bZoom | 1 | 无符号数字 | 寻址缩放控制的属性设置: 0:数码变焦关闭 1:0:数码变焦打开 |
2 | bSpeed | 1 | 数字 | 控制改变的速度 |
13.PanTilt(绝对)控制
控制选择子 | CT_PANTILT_ABSOLUTE_CONTROL |
---|---|
强制性请求 | GET_CUR, GET_MIN, GET_MAX, GET_RES, GET_INFO, GET_DEF |
先择性请求 | SET_CUR |
长度 | 8 |
偏移 | 数据 | 长度 | 值 | 描述 |
---|---|---|---|---|
0 | dwPanAbsolute | 4 | 有符号数字 | 寻址Pan(绝对)控制的属性设置 |
4 | dwTiltAbsolute | 4 | 有符号数字 | 寻址倾斜(绝对)控制的属性设置 |
14.PanTilt(相对)控制
控制选择子 | CT_PANTILT_RELATIVE_CONTROL |
---|---|
强制性请求 | SET_CUR, GET_CUR, GET_INFO, GET_DEF, GET_MIN, GET_MAX, GET_RES |
长度 | 4 |
偏移 | 数据 | 长度 | 值 | 描述 |
---|---|---|---|---|
0 | bPanRelative | 1 | 无符号数字 | 寻址Pan(相对)控制的属性设置: 停止 1: 顺时针方向移动 0xFF:逆时针方向移动 |
1 | bPanSpeed | 1 | 数字 | 盘运动速度 |
2 | bTiltRelative | 1 | 无符号数字 | 寻址倾斜(相对)控制的属性设置: 0:停止 1: 把成像平面指向上 0xFF:向下指向成像平面 |
3 | bTiltSpeed | 1 | 数字 | 倾斜运动速度 |
15.滚动(绝对)控制
控制选择子 | CT_ROLL_ABSOLUTE_CONTROL |
---|---|
强制性请求 | GET_CUR, GET_MIN, GET_MAX, GET_RES, GET_INFO, GET_DEF |
可选请求 | SET_CUR |
长度 | 2 |
偏移 | 数据 | 长度 | 值 | 描述 |
---|---|---|---|---|
0 | wRollAbsolute | 2 | 无符号数字 | 寻址滚动(绝对)控制的属性设置 |
16.滚动(相对)控制
控制选择子 | CT_ROLL_RELATIVE_CONTROL |
---|---|
强制性请求 | SET_CUR, GET_CUR, GET_INFO, GET_DEF, GET_MIN,GET_MAX, GET_RES |
长度 | 2 |
偏移 | 数据 | 长度 | 值 | 描述 |
---|---|---|---|---|
0 | bRollRelative | 1 | 寻址滚动(相对)控制的属性设置: 0:停止 1: 顺时针旋转 0xFF:逆时针旋转移动 |
|
0 | bSpeed | 1 | 数字 | 滚动运动速度 |
17.隐私控制
控制选择子 | CT_PRIVACY_CONTROL |
---|---|
强制性请求 | GET_CUR, GET_INFO |
可选的请求 | SET_CUR |
长度 | 1 |
偏移 | 数据 | 长度 | 值 | 描述 |
---|---|---|---|---|
0 | bPrivacy | 1 | 布尔 | 寻址隐私控制的属性设置: 0:打开 1: 关闭 |
19.数字窗口控制
控制选择子 | CT_DIGITAL_WINDOW_CONTROL |
---|---|
强制性请求 | SET_CUR, GET_CUR, GET_MIN, GET_MAX, GET_DEF |
长度 | 12 |
偏移 | 数据 | 长度 | 值 | 描述 |
---|---|---|---|---|
0 | wWindow_Top | 2 | 数字 | 全局传感器坐标中的顶部坐标(像素) |
2 | wWindow_Left | 2 | 数字 | 全局传感器坐标中的左坐标(像素) |
4 | wWindow_Bottom | 2 | 数字 | 全局传感器坐标中的底坐标(像素) |
6 | wWindow_Right | 2 | 数字 | 全局传感器坐标中的右坐标(像素) |
8 | wNumSteps | 2 | 数字 | 从当前窗口移动到上面矩形指定的窗口的步数。 |
10 | bmNumStepsUnits | 2 | 数字 | 上面指定的步数单位。 D0:视频帧 D1:毫秒 预留:D15-D2 |
20.数字感兴趣区域(ROI)控制
控制选择子 | CT_REGION_OF_INTEREST_CONTROL |
---|---|
强制性请求 | SET_CUR, GET_CUR, GET_MIN, GET_MAX, GET_DEF |
长度 | 10 |
偏移 | 数据 | 长度 | 值 | 描述 |
---|---|---|---|---|
0 | wROI_Top | 2 | 数字 | 全局传感器坐标中的顶部坐标(像素) |
2 | wROI_Left | 2 | 数字 | 全局传感器坐标中的左部坐标(像素) |
4 | wROI_Bottom | 2 | 数字 | 全局传感器坐标中的底部坐标(像素) |
6 | wROI_Right | 2 | 数字 | 全局传感器坐标中的右部坐标(像素) |
8 | bmAutoControls | 2 | 位图 | D0:自动曝光 D1:自动光圈 D2:自动白平衡 D3:自动对焦 D4:自动面部检测 D5:自动检测和跟踪 D6:图像稳定 D7:更高质量 D8–D15:保留,设为零。 |