UVC摄像头技术笔记
+ -

UVC规范USB摄像头扩展单元XU的初始化分析

2021-08-31 1892 0

USB摄像头的UVC的扩展单元用于UVC摄像头的自定义功能扩展,支持UVC扩展单元的摄像头在其UVC控制接口中都会有一个扩展单元描述符。该扩展单元描述符的字段描述符了其支持的选择子,GUID,扩展单元等相关信息。

我们知道,UVC摄像头在接入PC机后,和其它USB设备一样,第一步是肯定是USB设备信息的获取。如设备描述符配置描述符字符串描述符的获取、设备配置选择等。但UVC摄像头协议又是基于USB协议的一种特殊协议,所以关于UVC摄像头的枚举在完成基本的USB请求之后,又有一些特定的其它初始化请求。

UVC摄像头初始化过程

UVC扩展单元的抓包

这里本人手中的一个UVC摄像头,其UVC控制接口中含有一个扩展单元,其bUnitID为0x0b,支持3个选择子,分别为1至3。这里我们通过BUSHOUND抓包对其进行UVC扩展单元的初始化分析。

//选择子1
     CTL    a1 85 00 01  01 0b 02 00    GET LEN  
  2  IN     01 00                       ..       
     CTL    a1 86 00 01  01 0b 01 00    GET INFO 
  1  IN     02                          .        
     CTL    a1 82 00 01  01 0b 01 00    GET MIN  
  1  IN     00                          .        
     CTL    a1 83 00 01  01 0b 01 00    GET MAX  
  1  IN     ff                          .        
     CTL    a1 84 00 01  01 0b 01 00    GET RES  
  1  IN     01                          .        
     CTL    a1 87 00 01  01 0b 01 00    GET DEF  
  1  IN     00                          .        

//选择子2
     CTL    a1 85 00 02  01 0b 02 00    GET LEN  
  2  IN     01 00                       ..       
     CTL    a1 86 00 02  01 0b 01 00    GET INFO 
  1  IN     02                          .        
     CTL    a1 82 00 02  01 0b 01 00    GET MIN  
  1  IN     00                          .        
     CTL    a1 83 00 02  01 0b 01 00    GET MAX  
  1  IN     ff                          .        
     CTL    a1 84 00 02  01 0b 01 00    GET RES  
  1  IN     01                          .        
     CTL    a1 87 00 02  01 0b 01 00    GET DEF  
  1  IN     00

//选择子3        
     CTL    a1 85 00 03  01 0b 02 00    GET LEN  
  2  IN     01 00                       ..       
     CTL    a1 86 00 03  01 0b 01 00    GET INFO 
  1  IN     02                          .        
     CTL    a1 82 00 03  01 0b 01 00    GET MIN  
  1  IN     00                          .        
     CTL    a1 83 00 03  01 0b 01 00    GET MAX  
  1  IN     ff                          .        
     CTL    a1 84 00 03  01 0b 01 00    GET RES  
  1  IN     01                          .        
     CTL    a1 87 00 03  01 0b 01 00    GET DEF  
  1  IN     00

UVC扩展单元的数据分析

我可可以看到,针对每个选择子,分别执行了GET_LEN,GEN_INFO,GETN_MIN,GET_MAX,GET_RES和GET_DEF的请求。

  • GET_LEN:获取该选择子的数据长度
  • GET_INFO:获取该选择子支持的特定类请求,我们可以看到有的只支持GET_CUR,有的同时支持GET_CUR和SET_CUR.而一些其它的特殊请求是不支持的。
  • GET_MIN/GET_MAX:获取最小最大值,这个数据长度需要和GET_LEN指定的数据长度一致。
  • GET_RES:获取数据的分辨率。
  • GET_DEF:获取默认数据。

这里可以看到,并没有GET_CUR和SET_CUR请求,这些请求只是用于扩展单元的实际控制工作中。

     CTL    a1 85 00 01  01 0b 02 00    GET LEN  
  2  IN     01 00
  • 0xa1:表示发向接口或实例
  • 0x85:表示GET_LEN
  • 00 01:即0x0100 表示选择子1。控制选择器CS(高字节),低字节为零
  • 01:表示发向的接口ID为0X01,本设备的控制接口位于接口描述符ID为1的按口描述符中,控制接口位于其中。
  • 0b:扩展单元ID
  • 02 00:数据长度为2字节。

参考资料:

HID人机交互QQ群:564808376    UAC音频QQ群:218581009    UVC相机QQ群:331552032    BOT&UASP大容量存储QQ群:258159197    STC-USB单片机QQ群:315457461    USB技术交流QQ群2:580684376    USB技术交流QQ群:952873936   

0 篇笔记 写笔记

UVC 扩展单元描述符
扩展单元描述符允许硬件设计者定义任意一组控制接口,使类驱动程序可以在设备与供应商提供的主机软件之间进行通讯控制。扩展单元描述符ID由bUnitID字段中的值唯一标识描述符。同一视频功能内的任何其他单元或终端不得具有相同的功能ID。guidExtensionCode字段包含特定于供应商的代码,该代......
UVC摄像头扩展单元功能的开发步骤是什么?
写在扩展单元的题外话本人在开发支持UVC扩展单元的directShow应用时,必现并不需要注册接口,只需要在其源过滤器参照后续的代码枚举相关的接口如IKsControl,IKsTopologyInfo定位到指定的扩展单元接口后,直接使用其对应的IKsControl::KsProperty即可实现扩展......
UVC 扩展单元控制请求
扩展单元控制请求设置或读取扩展单元内的视频控件.bmRequestTypebRequestwValue(2)wIndexwLengthData00100001SET_CUR选择子扩展单元ID参数长度参数块bmRequestTypebRequestwValue(2)wIndexwLengthData1......
V4L2访问摄像头扩展单元命令
我们可以通过IOCTL访问扩展单元,调用方法如下:ioctl(fd, UVCIOC_CTRL_QUERY, struct uvc_xu_control_query *);访问不同的扩展命令只需要修改uvc_xu_control_query 结构体里面内容即可。uvc_xu_control_qu......
用XU打造UVC命令行调试工具
在给客户交付UVC固件之后,有时客户会反馈问题,需要客户查看固件的打印信息或者执行一些命令辅助定位问题。如果有一个工具可以通过USB线连接到设备,直接在电脑上查看打印信息,执行命令就好了。有想法就要行动起来,行动才能解决问题。目前该功能已经实现了,说一下实现的方法吧。上位机OS Windows设......
UVC摄像头扩展单元调试工具-临江仙版
UVC摄像头的开发者为了实现一些私有定制协议的通讯,通常使用UVC自带的扩展单元来实现。通常是自定义一个扩展单元,再定义一些相应的选择子,然后再通过特定类请求实现与固件的通讯。 本站现提供一个Windows环境下,使用DirectShow开发的UVC扩展单元调试工具.UVC摄像头扩展单元工具来自......
UVC PTZ和扩展单元XU的过滤与分发调试笔记
在写这篇文章之前,我得首先感谢微软,感谢你的不严格,让我可以有空子可钻,不至于太过狼狈…记得看过一句话,开局一张图,内容全告编。我多么希望自己在UVC摄像头的调试过程中也可以瞎编乱造,这样不至于身心疲惫。至少保持着愉快的心情,吹吹牛,也是一件很开心的事。今日有一个需求,对UVC摄像头的请求进行......
UVC摄像头驱动装调试总结
前几天发表了一篇文章 UVC PTZ和扩展单元的过滤与分发调试笔记,原文见: http://www.usbzh.com/article/detail-517.html ,本来想着应该没啥问题了,可没想到上周五在实际测试过程中,还是出现了问题:经过长时间的UVC摄像头工作,突然驱动显示了大量数据包错误......
windows上面通过dshow接口访问uvc摄像头扩展单元,只能访问0x01-0x1F命令问题
最近在给客户做一个修改摄像头数据的工具,在通过dshow接口发送扩展命令的时候发现0x01-0x1F命令都可以发送成功,0x20及以上定义的命令都发送失败,并且返回错误码0x80070490。谷歌百度查了很久终于在windows官网文档中找到了答案,原来是USB 视频类驱动程序对UVC扩展单元实现......
UVC规范USB摄像头扩展单元XU的初始化分析
USB摄像头的UVC的扩展单元用于UVC摄像头的自定义功能扩展,支持UVC扩展单元的摄像头在其UVC控制接口中都会有一个扩展单元描述符。该扩展单元描述符的字段描述符了其支持的选择子,GUID,扩展单元等相关信息。我们知道,UVC摄像头在接入PC机后,和其它USB设备一样,第一步是肯定是USB设备信......
USBXU摄像头UVC扩展单元调试工具使用图解
USB中文网技术交流群临江仙大佬推出的USB摄像头UVC扩展单元调试工具,大大提高高了大家进行USB摄像头扩展单元的调试的工作效率,不过对于UVCB扩展单元不太熟悉的同学来说,有时在使用上也有一定的困难。今天本人将做一个详细的介绍它的使用方法。USB摄像头UVC扩展单元调试工具的准备该软件的版权归......
记一次USB摄像头UVC扩展单元功能的BUG追踪笔记
毫不自负的说,本人觉地自己对USB摄像头的UVC扩展单元这一块的技术点应该来说还是很熟悉的,至少截止到现在,本人对于此处的技术知识点都是成竹在胸了。无论项目中提出的各处功能,本人都比较好地完成了工作并完满地交付了。但有时,有些事,架不过时间的考验和相关配套程序条件限制。今天,本人就翻车了。从中午1......
UVCXU摄像头扩展单元调试工具UVCXU-USB中文网官方版
使用说明最新版本:为了便于调试,自己只好手动编写一个UVC扩展单元调试工具。第一版,只是实现了基本的功能,界面比较粗糙,界面如下:这里介绍一下界面的功能:UVC设备:打开软件,自动枚举系统中所有的UVC。XU_GUID:需要手动填写扩展单元的GUID,格式如界面所示。如果执行GET_CUR或......
UVCXU扩展单元调试工具SET_CUR时获取数据长度错误0x800700ea
在开发UVC扩展单元调试工具遇到的一个问题就是获取SET_CUR时的有效数据长度。进行数据的SET_CUR和GET_CUR,是通过KsProperty函数实现的。函数声明如下:NTSTATUS KsProperty( [in] PKSPROPERTY Property, [in......
UVC扩展单元描述符和设置不当会引起的设备启动失败(code:10)
UVC扩展单元用于UVC设备的自定义通讯,通过UVC扩展单元可以实现一些厂商自定义的通讯和设备特性。在一般的UVC摄像头的描述符布局中,其拓扑结构一般如下:可以看到,这上面的拓扑结构中支持2个扩展单元,所以在USB配置描述符的视频控制接口中就有两个独立的扩展单元描述符。这两件扩展单元的bSource......
关注公众号
取消
感谢您的支持,我会继续努力的!
扫码支持
扫码打赏,你说多少就多少

打开支付宝扫一扫,即可进行扫码打赏哦

您的支持,是我们前进的动力!