USB开发基础－－USB命令（请求）和USB描述符(转)
原文地址：http://www.baiheee.com/Documents/090518/090518112619.htm一、USB命令
在USB规范里，对命令一词提供的单词为“Request”，但这里为了更好的理解主机与设备之间的主从关系，将它定义成“命令”。
所有的USB设备都要求对主机发给自己的控制命令作出响应，USB规范定义了11个标准命令，它们分别是：Clear_Feature、Get_Configuration、Get_Descriptor、Get_Interface、Get_Status、Set_Address、Set_Configuration、Set_Descriptor、Set_Interface、Set_Feature、Synch_Frame。所有USB设备都必须支持这些命令（个别命令除外，如Set_Descriptor、Synch_Frame）。
不同的命令虽然有不同的数据和使用目的，但所有的USB命令结构是一样的。下表所示为USB命令的结构：
命令的结构偏移量域 长度（字节）值描述0bmRequestType1位图请求特征：
D7：传输方向
0=主机至设备
1=设备至主机
D6..5：种类
0=标准
1=类
2=厂商
3=保留
D4..0：接受者
0=设备
1=接口
2=端点
3=其他
4..31 保留1bRequest1值命令类型编码值（见表3）2wValue2值根据不同的命令，含义也不同4wIndex2索引或偏移根据不同的命令，含义也不同，主要用于传送索引或偏 移6wLength2 如有数据传送阶段，此为数据字节数。
下表列出了USB的11种标准命令
表2、USB的11种标准命令命令
bmRequestType
bRequest
wValue
wIndex
wLength
DataClear_Feature
00000000B
00000001B
00000010B
CLEAR_FEATURE
特性选择符
零
接口号
端点号
零
无Get_Configuration
10000000B
GET_CONFIGURATION
零
零
一
配置值Get_Descriptor
10000000B
GET_DESCRIPTOR
描述表种类(高字节，见表5）和索引（低字节）
零或语言标志
描述表长
描述表Get_Interface
10000001B
GET_INTERFACE
零
接口号
一
可选设置Get_Status
10000000B
10000001B
10000010B
GET_STATUS
零
零（返回设备状态）
接口号（对像时接口时）
端点号（对象是端点时）
二
设备,
接口 ,或
端点状态Set_Address
00000000B
SET_ADDRESS
设备地址
零
零
无Set_Configuration
00000000B
SET_CONFIGURATION
配置值（高字节为0，低字节表示要设置的配置值）
零
零
无Set_Descriptor
00000000B
SET_DESCRIPTOR
描述表种类（高字节，见表5）和索引（低字节）
零或语言标志
描述表长
描述表Set_Feature
00000000B
00000001B
00000010B
SET_FEATURE
特性选择符(1表示设备，0表示端点）
零
接口号
端点号
零
无Set_Interface
00000001B
SET_INTERFACE
可选设置
接口号
零
无Synch_Frame
100000010B
SYNCH_FRAME
零
端点号
二
帧号
其中bRequest为命令编码值，含意见表3：表3、USB标准命令的编码值bRequestValueGET_STATUS0CLEAR_FEATURE1为将来保留2SET_FEATURE3为将来保留4SET_ADDRESS5GET_DESCRIPTOR6SET_DESCRIPTOR7GET_CONFIGURATION8SET_CONFIGURATION9GET_INTERFACE10SET_INTERFACE11SYNCH_FRAME12
二、USB描述符 USB协议为USB设备定义了一套描述设备功能和属性的有固定结构的描述符，包括标准的描述符即设备描述符、配置描述符、接口描述符、端点描述符和字符串描述符，还有百标准描述符，如类描述符。USB设备通过这些描述符向USB主机汇报设备的各种各样属性，主机通过对这些描述符的访问对设备进行类型识别、配置并为其提供相应的客户端驱动程序。
USB设备通过描述符反映自己的设备特性。USB描述符是由特定格式排列的一组数据结构组成。 在USB设备枚举过程中，主机端的协义软件需要解析从USB设备读取的所有描述符信息。在USB主向设备发送读取描述符的请求后，USB设备将所有的描述符以连续的数据流方式传输给USB主机。主机从第一个读到的字符开始，根据双方规定好的数据格式，顺序地解析读到的数据流。
USB描述符包含标准描述符、类描述符和厂商特定描述３种形式。任何一种设备必须USB标准描述符（队字符串描述符可选外）。 在USB1.X中，规定了5种标准描述符：设备描述符（Device Descriptor)、配置描述符（Configuration Descriptor）、接口描述符（Interface Descriptor）、端点描述符（Endpoint Descriptor）和字符串描述符（String Descriptor）。
每个USB设备只有一个设备描述符，而一个设备中可包含一个或多个配置描述符，即USB设备可以有多种配置。设备的每一个配置中又可以包含一个或多个接口描述符，即USB设备可以支持多种功能（接口），接口的特性通过描述符提供。 在USB主机访问USB设备的描述符时，USB设备依照设备描述符、配置描述符、接口描述符、端点描述符、字符串描述符顺序将所有描述符传给主机。一设备至少要包含设备描述符、配置描述符和接口描述符，如果USB设备没有端点描述符，则它仅仅用默认管道与主机进行数据传输。
１、设备描述符 设备描述符给出了USB设备的一般信息，包括对设备及在设备配置中起全程作用的信息，包括制造商标识号ID、产品序列号、所属设备类号、默认端点的最大包长度和配置描述符的个数等。一个USB设备必须有且仅有一个设备描述符。设备描述符是设备连接到总线上时USB主机所读取的第一个描述符，它包含了14个字段，结构如下：
表4、USB设备描述符的结构偏移量域大小值描述0bLength1数字
此描述表的字节数1bDecriptorType1常量
描述符的类型（此处应为0x01，即设备描述符）2bcdUSB2BCD码
此设备与描述表兼容的USB设备说明版本号（BCD 码）4bDeviceClass1类
设备类码：
如果此域的值为0则一个设置下每个接口指出它自己的类，各个接口各自独立工作。
如果此域的值处于1~FEH之间，则设备在不同的接口上支持不同的类。并这些接口可能不能独立工作。此值指出了这些接口集体的类定义。
如果此域设为FFH，则此设备的类由厂商定义。5bDeviceSubClass1子类
子类挖码
这些码值的具体含义根据bDeviceClass 域来看。
如bDeviceClass 域为零，此域也须为零
如bDeviceClass 域为FFH，此域的所有值保留。6bDevicePortocol1协议
协议码
这些码的值视bDeviceClass 和 bDeviceSubClass 的值而定。
如果设备支持设备类相关的协议，此码标志了设备类的值。如果此域的值为零，则此设备不支持设备类相关的协议，然而，可能它的接口支持设备类相关的协议。如果此域的值为FFH，此设备使用厂商定义的协议。7bMaxPacketSize01数字
端点0的最大包大小（仅8,16,32,64
为合法值）8idVendor2ID
厂商标志（由USB-IF组织赋值）10idProduct2ID
产品标志（由厂商赋值）12bcdDevice2BCD 码
设备发行号（BCD 码）14iManufacturer1索引描述厂商信息的字符串描述符的索引值。15iProduct1索引描述产品信息的字串描述符的索引值。16iSerialNumber1索引描述设备序列号信息的字串描述符的索引值。17bNumConfigurations1数字可能的配置描述符数目
其中bDescriptorType为描述符的类型，其含义可查下表（此表也适用于标准命令Get_Descriptor中wValue域高字节的取值含义）：表5、USB描述符的类型值类型描述符描述符值标准描述符设备描述符（Device Descriptor)0x01配置描述符（Configuration Descriptor）0x02字符串描述符（String Descriptor）0x03接口描述符（Interface Descriptor）0x04端点描述符（EndPont Descriptor）0x05类描述符集线器类描述符（Hub Descriptor）0x29人机接口类描述符（HID）0x21厂商定义的描述符 0xFF
设备类代码bDeviceClass可查下表：
表6、设备的类别（bDeviceClass）值（十进制）值（十六进制）说明00x00接口描述符中提供类的值20x02通信类90x09集线器类2200xDC用于诊断用途的设备类2240xE0无线通信设备类2550xFF厂商定义的设备类
下表列出了一个USB鼠标的设备描述符的例子，供大家分析一下：表7、一种鼠标的设备描述符示例字段描述符值（十六制）bLength0x12bDecriptorType0x01bcdUSBx0110bDeviceClass0x00bDeviceSubClass0x00bDevicePortocol0x00bMaxPacketSize00x08idVendor0x045E(Microsoft Corporation）idProduct0x0047bcdDevice0x300iManufacturer0x01iProduct0x03iSerialNumber0x00bNumConfigurations0x01
2、配置描述符
配置描述符中包括了描述符的长度（属于此描述符的所有接口描述符和端点描述符的长度的和）、供电方式（自供电/总线供电）、最大耗电量等。主果主机发出USB标准命令Get_Descriptor要求得到设备的某个配置描述符，那么除了此配置描述符以外，此配置包含的所有接口描述符与端点描述符都将提供给USB主机。表8、USB配置描述符的结构 偏移量 域 大小 值 描述 0bLength1 数字此描述表的字节数长度。 1bDescriptorType1 常量配置描述表类型（此处为0x02） 2wTotalLength2 数字此配置信息的总长（包括配置，接口，端点和设备类及厂商定义的描述符） 4bNumInterfaces1 数字此配置所支持的接口个数 5bCongfigurationValue1 数字在SetConfiguration（）请求中用作参数来选定此配置。 6iConfiguration1 索引描述此配置的字串描述表索引 7bmAttributes1 位图配置特性：
D7： 保留（设为一）
D6： 自给电源
D5： 远程唤醒
D4..0：保留（设为一）
一个既用总线电源又有自给电源的设备会在MaxPower域指出需要从总线取的电量。并设置D6为一。运行时期的实际电源模式可由GetStatus(DEVICE) 请求得到。 8MaxPower1 mA在此配置下的总线电源耗费量。以 2mA 为一个单位。
下面是一种硬盘的配置描述符示例：
表9、一种硬盘的配置描述符示例字段描述符值（十六进制）bLength0x09bDescriptorType0x02wTotalLength0x01FbNumInterfaces0x01bCongfigurationValue0x01iConfiguration0x00bmAttributes0x0CMaxPower0x32
3、接口描述符 配置描述符中包含了一个或多个接口描述符，这里的“接口”并不是指物理存在的接口，在这里把它称之为“功能”更易理解些，例如一个设备既有录音的功能又有扬声器的功能，则这个设备至少就有两个“接口”。
如果一个配置描述符不止支持一个接口描述符，并且每个接口描述符都有一个或多个端点描述符，那么在响应USB主机的配置描述符命令时，USB设备的端点描述符总是紧跟着相关的接口描述符后面，作为配置描述符的一部分被返回。接口描述符不可直接用Set_Descriptor和Get_Descriptor来存取。 如果一个接口仅使用端点0，则接口描述符以后就不再返回端点描述符，并且此接口表现的是一个控制接口的特性，它使用与端点0相关联的默认管道进行数据传输。在这种情况下bNumberEndpoints域应被设置成0。接口描述符在说明端点个数并不把端点0计算在内。
表10、USB接口描述符的结构偏移量域大小值说明 0bLength1数字此表的字节数 1bDescriptorType1常量接口描述表类（此处应为0x04） 2bInterfaceNumber1数字接口号，当前配置支持的接口数组索引（从零开始）。 3bAlternateSetting1数字可选设置的索引值。 4bNumEndpoints1数字此接口用的端点数量，如果是零则说明此接口只用缺省控制管道。 5bInterfaceClass 1类接口所属的类值：
零值为将来的标准保留。
如果此域的值设为FFH，则此接口类由厂商说明。
所有其它的值由USB 说明保留。 6bInterfaceSubClass 1子类子类码
这些值的定义视bInterfaceClass域而定。
如果bInterfaceClass域的值为零则此域的值必须为零。
bInterfaceClass域不为FFH则所有值由USB 所保留。 7bInterfaceProtocol 1协议协议码：bInterfaceClass 和bInterfaceSubClass 域的值而定.如果一个接口支持设备类相关的请求此域的值指出了设备类说明中所定义的协议. 8iInterface 1索引描述此接口的字串描述表的索引值。
对于bInterfaceClass字段，表示接口所属的类别，USB协议根据功能将不同的接口划分成不的类，其具体含义如下表所示：表11、USB协议定义的接口类别（bInterfaceClass）值（十六进制）类别0x01音频类0x02CDC控制类0x03人机接口类（HID）0x05物理类0x06图像类0x07打印机类0x08大数据存储类0x09集线器类0x0ACDC数据类0x0B智能卡类0x0D安全类0xDC诊断设备类0xE0无线控制器类0xFE特定应用类（包括红外的桥接器等）0xFF厂商定义的设备
4、端点描述符
端点是设备与主机之间进行数据传输的逻辑接口，除配置使用的端点0（控制端点，一般一个设备只有一个控制端点）为双向端口外，其它均为单向。端点描述符描述了数据的传输类型、传输方向、数据包大小和端点号（也可称为端点地址）等。 除了描述符中描述的端点外，每个设备必须要有一个默认的控制型端点，地址为0，它的数据传输为双向，而且没有专门的描述符，只是在设备描述符中定义了它的最大包长度。主机通过此端点向设备发送命令，获得设备的各种描述符的信息，并通过它来配置设备。
表12、USB端点描述符的结构偏移量域大小值说明0bLength1数字此描述表的字节数长度1bDescriptorType1常量端点描述表类（此处应为0x05）2bEndpointAddress1端点
此描述表所描述的端点的地址、方向：
Bit 3..0 : 端点号.
Bit 6..4 : 保留,为零
Bit 7: 方向,如果控制端点则略。
0：输出端点（主机到设备）
1：输入端点（设备到主机）3bmAttributes1位图此域的值描述的是在bConfigurationValue域所指的配置下端点的特性。
Bit 1..0 :传送类型
00=控制传送
01=同步传送
10=批传送
11=中断传送
所有其它的位都保留。4wMaxPacketSize2数字当前配置下此端点能够接收或发送的最大数据包的大小。
对于实进传输，此值用于为每帧的数据净负荷预留时间。在实际运行时，管道可能不完全需要预留的带宽，实际带宽可由设备通过一种非USB定义的机制汇报给主机。对于中断传输，批量传输和控制传输，端点可能发送比之短的数据包
6bInterval1数字周期数据传输端点的时间间隙。
此域的值对于批传送的端点及控制传送的端点无意义。对于同步传送的端点此域必需为1，表示周期为1ms。对于中断传送的端点此域值的范围为1ms到255ms。
下表是一种鼠标的端点描述符的示例，该端点是一个中断端点：表13、一种鼠标的端点描述符示例域值（十六进制）bLength0x07bDescriptorType0x05bEndpointAddress0x81bmAttributes0x03wMaxPacketSize0x04bInterval0x0A
5、字符串描述符
字符串描述符是一种可选的USB标准描述符，描述了如制商、设备名称或序列号等信息。如果一个设备无字符串描述符，则其它描述符中与字符串有关的索引值都必须为0。字符串使用的是Unicode编码。 主机请示得到某个字符串描述符时一般分成两步：首先主机向设备发出USB标准命令Get_Descriptor，其中所使用的字符串的索引值为0，设备返回一个字符串描述符，此描述符的结构如下：
表14、USB字符串描述符（响应主机请求时返回的表示语言ID的字符串描述符）偏移量域大小值 描述0bLength1N+2此描述表的字节数1bDescriptorType1常量字串描述表类型（此处应为0x03）2wLANGID2数字语言标识（LANGID）
码0
……………NwLANGID2数字语言标识（LANGID）
码X
该字符串描述符双字节的语言ID的数组，wLANGID~wLANGID指明了设备支持的语言，具体含义可查看USB_LANGIDs.pdf。 主机根据自己需要的语言，再次向设备发出USB标准命令Get_Descriptor，指明所要求得到的字符串的索引值和语言。这次设备所返回的是Unicode编号的字符串描述符，其结构如下：
表15、Unicode字符串描述符（响应主机请求时真正表示字符串编码的字符串描述符）偏移量域大小值描述0bLength1数字此描述表的字节数（bString域的数值N＋2）1bDescriptorType1常量字串描述表类型（此处应为0x03）2bStringN数字UNICODE 编码的字串
bString域为设备实际返回的以UNICODE编码的字符串流，我们在编写设备端硬件驱动的时候需要将字符串转换为UNICODE编码，您可以通过一些UNICODE转换工具进行转换。这里推荐由百合电子工作室开发的一款USB描述符生成工具“USB Unicode 字符串描述符生成器”，它专门为编写设备端驱动程序的需要而定制，可以非常方便将您需要的字符串转换成UNICODE格式，进而导入您的C或汇编程序代码中，以下是它的界面：http://www.baiheee.com/Documents/090518/090518112619/USB%20Unicode%20StringDescriptor%20Generator1.jpgUSB Unicode 字符串描述符生成器－生成C语言格式http://www.baiheee.com/Documents/090518/090518112619/USB%20Unicode%20StringDescriptor%20Generator2.jpgUSB Unicode 字符串描述符生成器－生成汇编格式
学习下！！
页:
[1]
