【USB笔记】接口描述符Interface Descriptor

最新推荐文章于 2024-05-29 14:51:49 发布
最新推荐文章于 2024-05-29 14:51:49 发布
阅读量1w 收藏 46
点赞数 6
分类专栏： USB笔记 文章标签： usb
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/u012028275/article/details/109567196
版权

USB笔记 接口描述符 (Interface Descriptor)

接口描述符(Interface Descriptor)描述了配置中一个特定的接口。配置提供了一个或多个接口，每个接口都含有类(Class)，子类(SubClass)和协议(Protocol)的信息，以及接口所使用的端点(Endpoint)数目。

接口描述符(Interface Descriptor)总是作为配置描述符的一部分返回，不能直接用Get Descriptor或者Set Descriptor请求访问。

一个配置可含有多个同时活跃的接口。这些接口可能联合于某个功能，也可能并不相关。

每个接口都有它自己的接口描述符(Interface Descriptor)和附属描述符(subordinate descriptor)。

所有这些接口也都可拥有一个或多个替代的接口设置(alternate interface settings)。这些设置是相互排他的，每次只能有一个被激活。每个设置含有一个接口描述符(Interface Descriptor)及所的附属描述符(subordinate descriptor)。使用等时传输(isochronous transfers)的设备必须有替代接口设置(alternate interface settings)，因为缺省的接口不能请求等时带宽(isochronous bandwidth)。

Interface Descriptor

OffsetFieldSizeValueDescription
0bLength1Number以字节为单位的描述符大小
1bDescriptorType1Constant接口描述符类型
2bInterfaceNumber1Number接口的编号
3bAlternateSetting1Number用来确认bInterfaceNumber的替代设置的编号
4bNumEndpoints1Number接口使用的端点数量
5bInterfaceClass1Class类码
6bInterfaceSubClass1SubClass子类码
7bInterfaceProtocol1Protocol协议码
8iInterface1Index接口字符串描述符的索引

bLength以字节为单位的描述符大小(0x09)。

bDescriptorType接口描述符类型，为INTERFACE(0x04)。

bInterfaceNumber接口的编号。表示该配置同时支持的接口序列索引。编号的值从0开始，缺省值为0x00。每个接口描述符中，该字段取值必须唯一。在组合设备(composite device )的配置中拥有多个同时活动的接口。

bAlternateSetting用来确认bInterfaceNumber的替代设置的编号。对于每个bInterfaceNumber ，设备将提供一个bAlternateSetting 字段为0x00的接口描述字，这是缺省的设置。替代设置的描述符bInterfaceNumber字段与缺省设备的值是相同的，但是bAlternateSetting的值不同，然后替代设置的描述符的最后5个字节的取值也会根据实际情况而不同。

对于每个bInterfaceNumber，每次只有一个bAlternateSetting 可被激活。替代设置可使主机能够请求带有不同带宽或其他要求和性能的接口。Get Interface请求会取得当前被激活的bAlternateSetting。Set Interface请求可选择特定bInterfaceNumber所应当使用的bAlternateSetting。

bNumEndpoints这个接口使用的端点数量（不包括端点0）。如果这个值为0，那么这个接口使用默认的控制管道(Control Pipe)，既只使用端点0。

bInterfaceClass类码(Class code)，这个类码(Class code)由USB-IF分配。除了用于由接口规定的设备外，其他与设备描述符(Device Descriptor)中bDeviceClass 字段相同。

值0x00为保留值，从0x01 – 0xFE的值保留给USB定义的类，0xFF作为厂商定义的类。

Class CodeDescription
0x00保留(Reserved)
0x01音频(Audio)
0x02通讯设备：通讯接口(Communications device: communication interface)
0x03人机接口设备(Human interface device)
0x05物理(Physical)
0x06图像(Image)
bInterfaceSubclass = 0x01
bInterfaceProtocol = 0x01: Imaging device
0x07打印机(Printer)
0x08大容量存储(Mass storage)
0x09集线器(Hub) (还必须在设备描述符(device descriptor)中声明 )
0x0A通讯设备：数据接口(Communications device: data interface)
0x0B智能卡(Smart Card)
0x0D内容安全(Content Security)
bInterfaceSubclass = 0x01
bInterfaceProtocol = 0x01: Content security device
0x0E视频(Video)
0x0F个人健康设备(Personal healthcare device) (can instead be declared at the device level)
0x10Audio/Video (AV):
bInterfaceSubclass = 0x01
bInterfaceProtocol = 0x00: AVControl Interface
bInterfaceSubclass = 0x02
bInterfaceProtocol = 0x00: AVData Video Streaming Interface
bInterfaceSubclass = 0x03
bInterfaceProtocol = 0x00: AVData Audio Streaming Interface
0xDC诊断设备Diagnostic device (can instead be declared at the device level)
bInterfaceSubclass= 0x01
bInterfaceProtocol = 0x01: USB2 compliance device
0xE0无线控制器Wireless controller
bInterfaceSubclass = 0x01
bInterfaceProtocol = 0x01: Bluetooth programming interface (should also be
declared at the device level)
bInterfaceProtocol = 0x02: UWB Radio control interface (Wireless USB)
bInterfaceProtocol = 0x03: RNDIS
bInterfaceProtocol = 0x04: Bluetooth AMP controller (should also be declared at the device level)
bInterfaceSubclass = 0x02: Host and device wire adapters (Wireless USB)
bInterfaceProtocol = 0x01: Host wire adapter control/data interface
bInterfaceProtocol = 0x02: Device wire adapter control/data interface
bInterfaceProtocol = 0x03: Device wire adapter isochronous interface
0xEF各种各样的Miscellaneous
bInterfaceSubclass = 0x01
bInterfaceProtocol = 0x01: active sync
bInterfaceProtocol = 0x02: Palm sync
bInterfaceSubclass = 0x02
bInterfaceProtocol = 0x01: Interface Association Descriptor
bInterfaceProtocol = 0x02: Wire Adapter Multifunction Peripheral programming
interface
bInterfaceSubclass = 0x03: Cable based association framework (Wireless USB)
bInterfaceProtocol = 0x01: Cable based association framework device
bInterfaceSubclass = 0x04
bInterfaceProtocol = 0x01: RNDIS over Ethernet
bInterfaceProtocol = 0x02: RNDIS over WiFi
bInterfaceProtocol = 0x03: RNDIS over Maxim
bInterfaceProtocol = 0x04: RNDIS over WWAN
bInterfaceProtocol = 0x05: RNDIS for Raw IPv4
bInterfaceProtocol = 0x06: RNDIS for Raw IPv6
bInterfaceProtocol = 0x07: RNDIS for GPRS
bInterfaceSubclass = 0x05: Machine vision device (USB3 Vision)
bInterfaceProtocol = 0x00: USB3 Vision Control Interface
bInterfaceProtocol = 0x01: USB0 Vision Event Interface
bInterfaceProtocol = 0x02: USB3 Vision Streaming Interface
0xFE应用程序专属Application specific
bInterfaceSubclass = 0x01: Device firmware upgrade
bInterfaceSubclass = 0x02: IrDA bridge
bInterfaceSubclass = 0x03: Test and measurement (USBTMC)
bInterfaceProtocol = 0x00: Complies with USBTMC spec
bInterfaceProtocol = 0x01: Complies with USBTMC USB488 subclass
0xFF厂商专属Vendor specific (can instead be declared at the device level)

bInterfaceSubClass子类码(SubClass code)，这个子类码(SubClass code)由USB-IF分配。这个值由bInterfaceClass字段所限定。除了带有由接口定义的类的设备之外，此字段与设备描述符(Device Descriptor)中的bDeviceSubClass字段相同。如果bInterfaceClass等于0x00，则bInterfaceSubClass也必须等于0x00。如果bIntefaceClass是0x01–0xFE范围的值，则bInterfaceSubClass等于0x00或等于一个为接口的类定义的码。0xFF表明为厂商定义的子类(SubClass)。

bInterfaceProtocol协议码(Protocol code)，这个协议码(Protocol code)由USB-IF分配。这个值由bInterfaceClass字段和bInterfaceSubClass字段所限定。如果接口支持专用的类型请求，这个协议码能识别出由协议类型规范定义、设备使用的协议。如果bInterfaceClass等于0x00，设备在这个接口不使用专门的类协议。如果为0xFF，设备在这个接口使用专用的厂商协议。除了带有由接口定义的类的设备之外，此字段与设备描述符(Device Descriptor)中的bDeviceProtocol字段相同。如果bIntefaceClass 是0x01–0xFE范围的值，则bInterfaceProtocol 等于0x00或等于一个为接口的类定义的码。

iInterface描述这个接口的字符串描述符的索引。如果没有字符串描述符的话则此值为0。

获取接口描述符

主机通过发送Get Descriptor请求，取得配置描述符，接口描述符，端点描述符及其附属描述符。

接口描述符(Interface Descriptor)总是作为配置描述符Configuration Descriptor的一部分返回，不能单独获取。

Get DescriptorValue
bmRequestType0x80
  bmRequestType.Recipient0b00000(Device)
  bmRequestType.Type0b00(Standard)
  bmRequestType.Direction0b1(Device-to-Host)
bRequest0x06(Get Descriptor)
wValue0x0200(Configuration #0)
wIndex0x0000
wLength0x???(wTotalLength)

下面举例说明一个获取接口描述符的过程。
获取一个键盘的接口描述符，该键盘的接口描述符如下所示：
0

使用USB分析仪抓包可以看到，获取配置描述符Configuration Descriptor，而接口描述符Interface Descriptor就包含在其中：
1

接口描述符Interface Descriptor的获取过程如下：
2

再展开看到详细的过程：
3

接下来详细看整个获取过程的各个字段含义：
4

一开始的setup包过程：
5

setup data：
6

IN包过程
7

OUT包过程：
8

完成整个接口描述符Interface Descriptor的获取。

描述符示例

这里举例一个带有该描述符的示例设备，这是一个键盘Keyboard的完整描述符信息。

Device Descriptor

OffsetFieldSizeValueDescription
0bLength10x12
1bDescriptorType10x01DEVICE
2bcdUSB20x01101.10
4bDeviceClass10x00
5bDeviceSubClass10x00
6bDeviceProtocol10x00
7bMaxPacketSize010x08
8idVendor20x046d
10idProduct20xc31c
12bcdDevice20x640064.00
14iManufacturer10x01
15iProduct10x02
16iSerialNumber10x00
17bNumConfigurations10x01

Configuration Descriptor

OffsetFieldSizeValueDescription
0bLength10x09
1bDescriptorType10x02CONFIGURATION
2wTotalLength20x003b
4bNumInterfaces10x02
5bConfigurationValue10x01
6iConfiguration10x03
7bmAttributes10xa0
8bMaxPower10x2d

Interface Descriptor

OffsetFieldSizeValueDescription
0bLength10x09
1bDescriptorType10x04INTERFACE
2bInterfaceNumber10x00
3bAlternateSetting10x00
4bNumEndpoints10x01
5bInterfaceClass10x03Human Interface Device
6bInterfaceSubClass10x01Boot Interface
7bInterfaceProtocol10x01Keyboard
8iInterface10x02

HID Descriptor

OffsetFieldSizeValueDescription
0bLength10x09
1bDescriptorType10x21HID
2bcdHID20x01101.10
4bCountryCode10x00
5bNumDescriptors10x01
6bDescriptorType10x22REPORT
7wDescriptorLength20x0041

Endpoint Descriptor

OffsetFieldSizeValueDescription
0bLength10x07
1bDescriptorType10x05ENDPOINT
2bEndpointAddress10x811 IN
3bmAttributes10x03Interrupt
4wMaxPacketSize20x0008
6bInterval10x0a

Interface Descriptor

OffsetFieldSizeValueDescription
0bLength10x09
1bDescriptorType10x04INTERFACE
2bInterfaceNumber10x01
3bAlternateSetting10x00
4bNumEndpoints10x01
5bInterfaceClass10x03Human Interface Device
6bInterfaceSubClass10x00
7bInterfaceProtocol10x00
8iInterface10x02

HID Descriptor

OffsetFieldSizeValueDescription
0bLength10x09
1bDescriptorType10x21HID
2bcdHID20x01101.10
4bCountryCode10x00
5bNumDescriptors10x01
6bDescriptorType10x22REPORT
7wDescriptorLength20x009f

Endpoint Descriptor

OffsetFieldSizeValueDescription
0bLength10x07
1bDescriptorType10x05ENDPOINT
2bEndpointAddress10x822 IN
3bmAttributes10x03Interrupt
4wMaxPacketSize20x0004
6bInterval10xff

附录

USB1.x/USB 2.0/USB 3.x Interface Descriptor

OffsetFieldSizeValueDescription
0bLength1NumberSize of this descriptor in bytes
1bDescriptorType1ConstantINTERFACE Descriptor Type
2bInterfaceNumber1NumberNumber of this interface. Zero-based value identifying the index in the array of concurrent interfaces supported by this configuration.
3bAlternateSetting1NumberValue used to select this alternate setting for the interface identified in the prior field.
4bNumEndpoints1NumberNumber of endpoints used by this interface (excluding endpoint zero). If this value is zero, this interface only uses the Default Control Pipe.
5bInterfaceClass1ClassClass code (assigned by the USB-IF).
A value of zero is reserved for future standardization.
If this field is set to FFH, the interface class is vendor-specific.
All other values are reserved for assignment by the USB-IF.
6bInterfaceSubClass1SubClassSubclass code (assigned by the USB-IF).
These codes are qualified by the value of the bInterfaceClass field.
If the bInterfaceClass field is reset to zero, this field must also be reset to zero.
If the bInterfaceClass field is not set to FFH, all values are reserved for assignment by the USB-IF.
7bInterfaceProtocol1ProtocolProtocol code (assigned by the USB).
These codes are qualified by the value of the bInterfaceClass and the bInterfaceSubClass fields. If an interface supports class-specific requests, this code identifies the protocols that the device uses as defined by the specification of the device class.
If this field is reset to zero, the device does not use a class-specific protocol on this interface.
If this field is set to FFH, the device uses a vendor-specific protocol for this interface.
8iInterface1IndexIndex of string descriptor describing this interface.

[参考资料]

Universal Serial Bus Specification Revision 1.0

Universal Serial Bus Specification Revision 1.1

Universal Serial Bus Specification Revision 2.0

Universal Serial Bus 3.0 Specification

Universal Serial Bus 3.1 Specification

Universal Serial Bus 3.2 Specification

USB Complete, 5th Edition

USB开发大全

USB2.0与OTG规范及开发指南

本文链接：https://blog.csdn.net/u012028275/article/details/109567196

dadalaohua
关注
  • 6
    点赞
  • 踩
  • 46
    收藏
    觉得还不错? 一键收藏
  • 6
    评论
专栏目录
USB学习(3)：USB描述符和USB类设备
主要分享硬件、嵌入式软件部分知识
10-28 1861
它描述了高速USB设备的信息，如果设备以另一速度运行，该描述符将发生更改，这在支持两种速度配置的设备中是必需的。同样，如果在设备以高速运行时请求此描述符，描述符读取将告诉主机有关全速配置的信息。在上一节的USB描述符部分，USB设备类的定义在：设备描述符的第四个字节和接口描述符的第六个字节。接口描述符描述了配置中的特定接口，此描述符中确定了接口的端点数量，声明了设备的USB类，供主机加载适合适驱动程序。设备描述符提供给主机一些信息，如设备符合的USB规范、设备支持的配置数量、支持的协议、制造商标识(
USB系列五：USB设备配置描述符（重要）
挨踢农民的博客
05-10 1395
在USB总线接口协议中，对于USB外部设备功能特征是通过端点（Endpoint）、配置（Configuration）和接口（Interface）来描述的，这些就是典型的USB描述符。 USB主机通过设备请求来读取外部设备的USB描述符，可以掌握该设备的接口信息和功能。USB设备请求提供了USB设备描述符的读取和写操作，包括标准设备请求和自定义请求两种。USB描述符和USB设备请求是USB外设的主要内容，是USB设备功能的体现。
嵌入式进阶——HID协议
最新发布
qiuyeyyy的博客
05-29 1120
在接口描述符中来定义bInterfaceClass参数对应的值，表示当前设备是何种类型。
USB配置符解释
zhang_ze1234的博客
08-16 1528
USB设备通过描述符反映自己的设备特性。USB描述符是由特定格式排列的一组数据结构组成。 各描述符层次图解 设备描述符 typedef struct USB_DEVICE_DESCRIPTOR { BYTE bLength, BYTE bDescriptorType, WORD bcdUSB, BYTE bDeviceClass, BTYE ...
USB协议学习
liu749929309的博客
02-26 559
除了HID的三个特定描述符组成对HID设备的解释外，5个标准描述符中与HID设备有关的部分有： 设备描述符中：bDeviceClass（USB 分配的设备类代码，第四位）, bDeviceSubClass（USB 分配的子类代码，第5位）, bDeviceProtocol（USB 分配的设备协议代码第六位）三个值必须为 0 接口描述符中： bInterfaceClass（接口类型，第6位） 的值必须是 0x03； bInterfaceSubClass（按口子类型，第7位） 的值为 0 或 1， 为
如何优雅的调用接口？
蓝天之枫
01-21 3001
客官稍等。。占个位置
【USB笔记】配置描述符Configuration Descriptor
11-08 9252
USB笔记 配置描述符(Configuration Descriptor) 配置描述符(Configuration Descriptor)说明了一个特定配置的相关信息。描述符有一个bConfiguration Value字段，当将它的值作为Set Configuration请求的一个参数时，设备使用所描述的配置。 取得设备描述符后，主机便可再取得设备的配置、接口和端点描述符。当主机请求配置描述符时,返回的是所有相关的接口和端点描述符。 配置描述符描述了配置所提供的接口数量。每个接口可以独立操作。 一个USB
gdt描述_全局描述符表(GDT)局部描述符表(LDT)
weixin_39717598的博客
12-20 938
这三个表是在内存中由操作系统或系统程序员所建，并不是固化在哪里，所以从理论上是可以被读写的。这三个表都是描述符表。描述符表是由若干个描述符组成，每个描述符占用8个字节的内存空间，每个描述符表内最多可以有8129个描述符。描述符是描述一个段的大小，地址及各种状态的。一，保护模式存储器管理功能386 CPU共有32位地址线,其物理存储器最大可达232字节,实模式下,远指针由segment:offset...
struct usb_interface_descriptor
技术学习
02-23 845
struct usb_interface_descriptor { __u8 bLength; __u8 bDescriptorType; __u8 bInterfaceNumber; __u8 bAlternateSetting; __u8 bNumEndpoints; __u8 bInterfaceClass; __u8 bInterfaceSubClass;
USB_descriptor.zip_USB_Descriptor_usb 描述符
09-14
USB描述符是设备向主机报告其属性的数据结构，包括设备描述符、配置描述符、接口描述符、端点描述符等。这些描述符在设备枚举过程中被主机请求并读取，以便主机能够识别和配置设备。 1. **设备描述符**：这是每个...
USB报告描述符自动生成工具 HID Descriptor tool
04-07
标题中的“USB报告描述符自动生成工具 HID Descriptor tool”是一个专为USB设备设计的辅助开发工具，主要用于生成符合HID（Human Interface Device）规范的设备描述符。HID是USB设备类规范的一部分，广泛应用于键盘...
完整的HID协议规则
05-19
HID组织定出的HID标准协议，详细介绍HID规范，HID标准；适合HID全面学习的开发人员。
hid descriptor tool USB 描述符生成工具
07-28
USB描述符包括设备描述符、配置描述符、接口描述符、端点描述符等，而HID描述符是其中的一种，专门针对HID类设备。 设备描述符包含了关于USB设备的基本信息，如设备类、子类、协议、设备版本、制造商、产品和序列号...
Python描述符descriptor使用原理解析
09-17
Python中的描述符（descriptor）是理解面向对象编程中属性访问机制的关键概念。描述符是实现了特定特殊方法（如`__get__`、`__set__`和`__del__`）的类，这些方法控制了对象属性的获取、设置和删除操作。描述符在...
Python 的描述符 descriptor详解
09-21
Python中包含了许多内建的语言特性，它们使得代码简洁且易于理解。这些特性包括列表/集合/字典推导式，属性（property）、以及装饰器（decorator）。对于大部分特性来说，这些...但是这里有个例外，那就是描述符。
USB_interface结构体分析
qingkongyeyue的博客
11-25 5452
转自http://liu1227787871.blog.163.com/blog/static/20536319720129149102907/ struct usb_interface { //本接口对应的所有的设置（与配置不是一个概念） struct usb_host_interface *altsetting; struct usb_host_interface *c
从零开始学USB（十、USB的描述符）
热门推荐
To_run_away的博客
12-23 2万+
USB设备使用描述符报告其属性。描述符是具有定义格式的数据结构。每个描述符都以字节宽度字段开头，该字段包含描述符中的总字节数，后跟一个标识描述符类型的字节宽度字段。 使用描述符允许简单地存储各个配置的属性，因为每个配置可以重用具有相同特征的其他配置的描述符或描述符的部分。以这种方式，描述符类似于关系数据库中的各个数据记录。 适当时，描述符包含对字符串描述符的引用，这些字符串描述符提供以可读形式...
关于接口描述符中bAlternateSetting的使用
weixin_33795093的博客
10-05 312
今天看CY7C68013开发手册时，突然想起，在USB接口描述符中有一个bAlternateSetting字段一直没用过，花了一上午时间也没找到相关资料！就在快中午时突然看到一句话：“bAlternateSetting用于在同一个接口中的多个描述符中进行切换".一下子感觉抓住要点了。经过百度及查阅USB specification2.0得出如下结论： 在USB协议...
linux获取usb设备描述符,USB设备的各种描述符（descriptors)
weixin_29322855的博客
05-06 2323
http://blog.csdn.net/sjin_1314/article/details/25366459说到USB设备，不得不提到各种描述符(descriptors), 一般来说，描述符有如下几种：1：设备描述符(Device Descriptors)2：配置描述符(Configuration Descriptors)2：接口描述符(Interface Descriptors)3：端点描述符...
struct usb_interface_descriptor详解
03-07
struct usb_interface_descriptor是USB接口描述符，它描述了一个USB接口的属性和功能。它包含了接口号、接口类、接口子类、接口协议、端点数等信息。这些信息可以帮助USB主机正确地识别和配置USB设备。

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论 6
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值