USB2.0规范
+ -

USB 标准请求

2021-06-01 18214 39

USB定义了8个字节的标准请求,通过这些请求,可以对设备的状态进行更改或对设备进行枚举。
USB的标准请求的数据传输方式都是控制传输方式,所以使用的端点是设备的默认端点0。

USB这8个字节的的控制请求不包括传输过程中的数据,但包括了控制请求的数据长度。当数据长度为不为0时,设备或主机向对方传输相应长的数据。这些数据有可能是设备返回给主机的回应数据,也可能是主机发给设备的控制参数。

为什么USB的标准请求命令(不包括数据)的长度是8呢?
这是因为USB协议规定,端点0的最大包长度至少为8字节,所以任何设USB备都可能通过端点0接收字节的标准请求。

括号中的数字表示字节数,首字母bm,b,w分别表示位图、字节,双字节

USB标准请求的超时

  • 主机发给设备的请求,如果设备需要返回数据,响应时间必须在500ms内完成,如不返回数据,必须在50ms内完成。
  • 主机发送数据给设备,响应时间为5秒内。

    出自USB2.0规范9.2.6.4

USB标准请求的数据结构

USB标准请求的个字节分为5个部分,其变量分别定义为: 1字节的bmRequestType,1 字节的bReqest,2字节的wValue,2字节的wIndex和2字节的wLength.

1字节 1字节 2字节 2字节 2字节
bmRequestType(1) bRequest(1) wValue(2) wIndex(2) wLength(2)
typedef union _BM_REQUEST_TYPE {
    struct _BM {
        UCHAR   Recipient:2;
        UCHAR   Reserved:3;
        UCHAR   Type:2;
        UCHAR   Dir:1;
#ifdef __cplusplus
        } s;
#else
        };
#endif
    UCHAR B;
} BM_REQUEST_TYPE, *PBM_REQUEST_TYPE;

typedef struct _USB_DEFAULT_PIPE_SETUP_PACKET {
    BM_REQUEST_TYPE bmRequestType;
    UCHAR bRequest;

    union _wValue {
        struct {
            UCHAR LowByte;
            UCHAR HiByte;
        };
        USHORT W;
    } wValue;

    union _wIndex {
        struct {
            UCHAR LowByte;
            UCHAR HiByte;
        };
        USHORT W;
    } wIndex;
    USHORT wLength;
} USB_DEFAULT_PIPE_SETUP_PACKET, *PUSB_DEFAULT_PIPE_SETUP_PACKET;

bmRequestType字段(1字节)

D7,下一步数据的传输方向
0 = 主机到设备(SET请求)
1 = 设备到主机(GET请求)

//
// bmRequestType.Dir
//
#define BMREQUEST_HOST_TO_DEVICE        0
#define BMREQUEST_DEVICE_TO_HOST        1

D6-D5,命令的类型
00 = 标准请求命令
01 = 类请求命令(UVC规范中的请求属于类请求命令)
10 = 用户定义的请求命令
11 = 保留

//
// bmRequestType.Type
#define BMREQUEST_STANDARD              0
#define BMREQUEST_CLASS                 1
#define BMREQUEST_VENDOR                2

D4-D0,命令接受者的类型
00000 = 接受者为设备
00001 = 接收者为接口
00010 = 接受者为端点
00011 = 其它
4…31 = 保留
其他值保留。

//
// bmRequestType.Recipient
//
#define BMREQUEST_TO_DEVICE             0
#define BMREQUEST_TO_INTERFACE          1
#define BMREQUEST_TO_ENDPOINT           2
#define BMREQUEST_TO_OTHER              3

bRequest字段(1)

标准请求的及代码

bRequest Value
GET_STATUS 0
CLEAR_FEATURE 1
SET_FEATURE 3
SET_ADDRESS 5
GET_DESCRIPTOR 6
SET_DESCRIPTOR 7
GET_CONFIGURATION 8
SET_CONFIGURATION 9
GET_INTERFACE 10
SET_INTERFACE 11
SYNCH_FRAME 12
SET_ENCRYPTION 13 (USB2.0以后)
GET_ENCRYPTION 14
SET_HANDSHAKE 15
GET_HANDSHAKE 16
SET_CONNECTION 17
SET_SECURITY_DATA 18
GET_SECURITY_DATA 19
SET_WUSB_DATA 20
LOOPBACK_DATA_WRITE 21
LOOPBACK_DATA_READ 22
SET_INTERFACE_DS 23
SET_SEL 48
SET_ISOCH_DELAY 49

USB设备请求

bmRequestType bRequest 描述
1000 0000b GET_STATUS (0) 返回设备的状态。主要用于确定设备是否能够远程唤醒,以及设备是自供电还是总线供电。
0000 0000b CLEAR_FEATURE (01) 禁用 DEVICE_REMOTE_WAKEUP 或 TEST_MODE 功能。
0000 0000b SET_FEATURE (03) 启用 DEVICE_REMOTE_WAKEUP 或 TEST_MODE 功能。
0000 0000b 设置地址(05) 在枚举期间,该指令用于为设备分配地址 (1 -127)。
1000 0000b GET_DESCRIPTOR (06) 返回由 wValue 参数选择的描述符表。
0000 0000b SET_DESCRIPTOR (07) 设置指定的描述符值。
1000 0000b GET_CONFIGURATION (08) 返回活动设备配置的索引值。
0000 0000b 设置配置(09) 使指定的设备配置变为活动状态。

USB接口请求

bmRequestType bRequest 描述
1000 0001b GET_STATUS (0) 返回接口的状态。目前,两个返回的字节都“保留以备将来使用”。
0000 0001b CLEAR_FEATURE (01) 禁用界面功能。
0000 0001b SET_FEATURE (03) 启用指定的接口功能。
1000 0001b GET_INTERFACE (0A) 检索当前活动接口的索引。
0000 0001b SET_INTERFACE (11) 用界面指示激活。

USB端点请求

bmRequestType bRequest 描述
1000 0010b GET_STATUS (0) 返回端点的状态。
0000 0010b CLEAR_FEATURE (01) 禁用端点功能。
0000 0010b SET_FEATURE (03) 启用端点功能。
1000 0010b SYNCH_FRAME (12) 用于上报端点同步帧。

USB集线器请求/USB HUB请求

  • Get Hub Status (GET_STATUS)
  • Get Port Status (GET_STATUS)
  • Clear Hub Feature (CLEAR_FEATURE)
  • Clear Port Feature (CLEAR_FEATURE)
  • Get Bus State (GET_STATE) obsolete since USB 2.0
  • Set Hub Feature (SET_FEATURE)
  • Set Port Feature (SET_FEATURE)
  • Get Hub Descriptor (GET_DESCRIPTOR)
  • Set Hub Descriptor (SET_DESCRIPTOR)
  • Clear TT Buffer (CLEAR_TT_BUFFER)
  • Reset TT (RESET_TT)
  • Get TT State (GET_TT_STATE)
  • Stop TT (STOP_TT)

USB标准请求

不同的请求类型对于其接收者,wValue和wIndex的字段表示的含义有所差别。下面我们进行列表显示:

bmRequestType(1) bRequest(1) wValue(2) wIndex(2) wLength(2) 数据过程
0x00 CLEAR_FEATURE(1) 特性选择 0 0 没有数据
0x01 CLEAR_FEATURE(1) 特性选择 接口号 0 没有数据
0x02 CLEAR_FEATURE(1) 特性选择 端点号 0 没有数据
0x80 GET_CONFIGURATION(8) 0 0 1 配置制
0x80 GET_DESCRIPTOR(6) 描述符类型(高字节)和描述符索引(低字节) 0或语言ID(字符串描述符) 描述符的长度 描述符
0x81 GET_INTERFACE(0x0a) 0 接口号 1 备用(转换)接口
0x80 GET_STATUS(0) 0 0 2 设备状态
0x81 GET_STATUS(0) 0 接口号 2 接口状态
0x82 GET_STATUS(0) 0 端点号 2 端点状态
0x00 SET_ADDRESS(5) 设备地址 0 0 没有数据
0x00 SET_CONFIGURATION(9) 配置值 0 0 没有数据
0x00 SET_DESCRIPTOR(7) 描述符类型(高字节)和描述符索引(低字节) 0或语言ID(字符串描述符) 描述符的长度 描述符
0x00 SET_FEATURE(3) 特性选择 0 0 没有数据
0x01 SET_FEATURE(3) 特性选择 接口号 0 没有数据
0x02 SET_FEATURE(3) 特性选择 端点号 0 没有数据
0x01 SET_INTERFACE(0x0b) 备用接口号(转换接口号) 接口号 0 没有数据
0x82 SYNCH_FRAME(0x0c) 0 端点号 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摄像头(特定类请求)数据分析
通过上节可以知道,设备支持4种的视频格式,且每种格式如下:MPJPG数据格式bFormatIndexbFrameIndex分辩率及及帧率11640x480x(30,15,10)121280x720x(30,15,10)131920x1080x(30,15......
UVC特定类请求get cur返回长度是26或者是34的是什么?
从返回的长度来看,你应该是在应用打开摄像头,进行视频格式及图形分辨率协商返回的数据长度.UVC视频流接口这两个特别重要的选择子,分别用于协商过程和提交数据格式,让固件开始发送数据。ControlSelector ValueVS_PROBE_CONTROL0x01VS_COMMIT_CONTROL0x......
UVC摄像头批量传输的StreamOn和StreamOff
在UVC规范中,UVC摄像头视频数据的传输方式支持两种,分别为批量传输和同步传输。UVC摄像头数据传输的格式按负载数据头的方式按帧进行打包传输。根据USB规范可知,同步传输方式是只要带中带有同步端点的接口,系统会定时从设备中读取数据,无论设备中是否有数据。而如要要停止数据的传输,只需要选中不带有同步......
USB标准请求、类特定请求总结
做USB开发,最常见的就是USB的控制请求的那8个字节的分析,如果抓包工具有协议分析那还好说,但是如果不带速协议分析,那其实还是挺郁闷的。所以说,如何快速的通过USB请求的那几个字段定位出是何请求,是可以大大的提高我们的协议分析效率的。USB的请求这里包括USB的标准请求特定类请求,其包括以下几......
UAC 特定类请求
特定类请求一般用于设置或获取音频控制。这些控制又分为两大部分:音频控制请求:对音频控制单元或终端进行控制。音频流请求: 如对音频流控制的请求,如音频采相率等。音频设备类也支持其他特定于类的请求:内存请求(Memory Request),每个可寻址的实体或终端,可导出一个内存映射接口。提供对该实体内存......
USB3.2超高速的标准请求
USB3.2超高速请求相对于USB2.0的标准请求,多了一些新的标准请求。当然USB2.0的标准请求也适用于USB3.2的标准请求。USB3.2超高速规范增加的新的标准请求:bRequestValueSET_ENCRYPTION13GET_ENCRYPTION14SET_HANDSHAKE15GET......
UVC 再议特定类请求
通过特定请求的支持 GET_INFO可以获取设备支持的特定类请求。当然在UVC规范中,有些特定类请求是可选择的,有些是必须的,这种情况因特定类请求的使用环境不同而定。我们知道,特定类请求一般包括:名称值 说明RC_UNDEFINED0x00未定义SET_CUR0x01设置属性GET_CUR0x81获......
USB 标准请求
USB定义了8个字节的标准请求,通过这些请求,可以对设备的状态进行更改或对设备进行枚举。USB的标准请求的数据传输方式都是控制传输方式,所以使用的端点是设备的默认端点0。USB这8个字节的的控制请求不包括传输过程中的数据,但包括了控制请求的数据长度。当数据长度为不为0时,设备或主机向对方传输相应长......
UVC 特定类请求概述
本节我们来讲述UVC的特定类请求。UVC特定类请求的功能UVC特定类请求的主要功能用于控制UVC摄像头,实现对UVC摄像头的打开,关闭及摄像头参数的控制。通过对UVC规范的学习,使用我们可详细的了解UVC是怎样通过这些特定类请求实现对UVC摄像头的控制。UVC特定类请求的分类大多数特定于类的请求用于......
UVC 处理单元特定类请求示例
笔者手中有一UVC摄像头,其处理单元描述符bUnitID为2,其处理单元描述符内容如下: -------- Video Control Processing Unit Descriptor -----------------------bLength ......
HID报表描述符与设备描述符、配置描述符、字符串描述符的通讯格式对比
报表描述符是USB HID规范中一个很重要的概念。USB HID设备报表描述符内容表述了该HID设备的功能及数据传输的格式。USB HID报表描述符在概念上和设备描述符,配置描述符,接口描述符,端点描述符和其它USB设备描述符类似,但是还是有一些细微的区别。我里我们做一个简要的区别:设备描述符、......
U盘枚举失败-该设备无法启动(GET_MAX_LUN请求)
群里有人用STM32搞了一个U盘,但是U盘在插入电脑后在设备管理器是枚举失败。我让他看一下设备状态:又是熟悉的错误码10,表示设备启动失败。设备的启动失败,一般在设备获取描述符获取之后,初始会失败,我之前在弄USB虚拟鼠标的时候也遇到此类情况。不过由于这个设备是U盘,本人还没有研究USB存储协议,只......
BUSHOUND抓包stall pid的USTS c0000004错误
对USB设备进行数据分析,使用最多的也就是BUSHOUND了,不过经常遇到一个问题就是 USTS c0000004 stall pid 错误。USTS c0000004 stall pid在本站中搜......
BOT MASS_STORAGE_RESET
Bulk-Only Mass Storage Reset类特定请求是USB大容量存储设备独有的。 该特定类请求的功能用于复位大容量存储设备和与之关联的接口。通知设备接下来的批量端点输出数据为命令块包(CBW)。由于该请求是控制请求,所以是通过端点0发送的。在设备完成该请求即复位之前,设备应......
UVC摄像头视频特定类请求
UVC摄像头特定类请求包括视频控制接口请求和视频流请求。/* Video Class-specific Request codes */#define SET_CUR 0x01#define GET_CUR 0x81#define GET_MIN 0x82#define GET_MAX 0......
关注公众号
取消
感谢您的支持,我会继续努力的!
扫码支持
扫码打赏,你说多少就多少

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

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