Linux&UVC驱动
+ -

LINUX&UVC驱动uvc_parse_control之Logitech自定义扩展单元

2024-03-18 110 0

LINUX系统中,UVC新设备的初始化使用uvc_probe函数初始化。uvc_probe调用uvc_parse_control函数用于解析UVC设备的配描述符中的UVC控制接口描述符集。这些UVC控制描述符实现了UVC的基本配置信息和UVC设备的拓扑结构。

  • uvc_probe
    • uvc_parse_control

uvc_parse_vendor_control

在uvc_parse_control中使用uvc_parse_vendor_control处理UVC设备厂商自己定义的一些描述符,LINUX&UVC驱动这里只是处理了Logitech在UVC标准的扩展单元的基础上二次扩展的“扩展单元”。
这里在处理上当作UVC标准的扩展单元来处理。通过分析代码来看,如果有,该找述符紧跟接口描述符。其大概内存布局如下:

  • 接口描述述符
  • Logitech自定义扩展单元描述符(可选)
  • Video Control Interface Header Descriptor

通过对其数据结构分析如下:

[0]uint8 bLength;//描述符的总长度,不定长。公式为: 24+p+n*2+1
[1]uint8 flag1;//Logitech标识为0x41
[2]uint8 flag2;//Logitech标识为0x01
[3]uint8 UnitId;
[4~19]uint8 guid[16];
[20]uint16 bNumControls;
[21]uint8 p;
[22]uint8 baSourceIDs[p];
[22+p] uint8 bControlSize;
[23+p] uint8 bmControls[n];
[23+p+n] uint8 bmControlsType[n];
[23+p+n*2] uint8 bReserved;
[24+p+n*2] uint8 iExtension;//字符串描述符索引,为0表示没有

关于上面字段的注释,可以参见:

     * ----------------------------------------------------------
     * 0        bLength        1     Number
     *    Size of this descriptor, in bytes: 24+p+n*2
     * ----------------------------------------------------------
     * 23+p+n    bmControlsType    N    Bitmap
     *    Individual bits in the set are defined:
     *    0: Absolute
     *    1: Relative
     *
     *    This bitset is mapped exactly the same as bmControls.
     * ----------------------------------------------------------
     * 23+p+n*2    bReserved    1    Boolean
     * ----------------------------------------------------------
     * 24+p+n*2    iExtension    1    Index
     *    Index of a string descriptor that describes this
     *    extension unit.
     * ----------------------------------------------------------
     */

当然,由于这个自定义的被当作扩展单元处理了,故也会加入单元链表。

    unit = uvc_alloc_entity(UVC_VC_EXTENSION_UNIT, buffer[3]/*UnitId*/,p + 1, 2*n);
    ...
    list_add_tail(&unit->list, &dev->entities);

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......
关注公众号
  • HID人机交互
  • Linux&USB
  • UAC音频
  • TYPE-C
  • USB规范
  • USB大容量存储
  • USB百科
  • USB周边
  • UVC摄像头
  • Windows系统USB
  • 音视频博客
  • 取消
    感谢您的支持,我会继续努力的!
    扫码支持
    扫码打赏,你说多少就多少

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

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