USB鼠标实现——设备限定描述符（五）

设备限定描述符

仓库地址

仓库地址

USB 鼠标阅读顺序

• 枚举过程
• USB鼠标实现——设备描述符（一）
• USB鼠标实现——设置地址（二）
• USB鼠标实现——配置描述符集合（三）
• USB鼠标实现——字符串描述符（四）
• USB鼠标实现——设备限定描述符（五）
• USB鼠标实现——设置配置和获取配置（六）
• USB鼠标实现——报告描述符（七）
• USB鼠标实现——HID 报告的返回（八）

设备限定描述符介绍

设备限定描述符(Device Qualifier Descriptor)说明了能进行高速操作的设备在其他速度时产生的变化信息。例如，如果设备当前在全速下操作，设备限定描述符返回它如何在高速运行的信息。

如果设备既支持全速状态又支持高速状态，那么就必须含有设备限定描述符(Device Qualifier Descriptor)。设备限定描述符(Device Qualifier Descriptor)中含有当前没有使用的速度下这些字段的取值。

设备限定描述符(Device Qualifier Descriptor)不包含标准设备描述符中的厂商、产品、设备、制造厂商、产品和序列号场，因为在所有支持的速度下设备的这些信息都是常数。这个描述符的版本号至少是2.0(0200H)。

如果只能进行全速(full-speed)操作的设备(设备描述符的版本号等于0200H)接收到请求设备限定符的Get Descriptor请求，它必须用请求错误响应，回复STALL来响应。

主机端只能在成功取得设备限定描述符(Device Qualifier Descriptor)之后，才能请求其他速度配置(other_speed_configuration)描述符。

• bLength：0x0a
  • 设备限定描述符的长度。
• bDescriptorType：0x06
  • 设备限定描述符类型，为DEVICE_QUALIFIER (0x06)。
• bcdUSB：版本号
  • 是设备所符合的USB规范的版本号，该值采用BCD(用二进制编码的十进制数)格式。USB 2.0是0x0200；USB 2.1是0x0210。
• bDeviceClass类码
  • 这个字段为那些在设备层次定义功能的设备规定了它们所属的类。
• bDeviceSubClass子类码
  • 这个字段规定一个类的子类
• bDeviceProtocol协议码
  • 这个字段为所选的类和子类规定一个协议。
• bMaxPacketSize0
  • 为其他速度(Other-speed)的端点0最大包大小。
• bNumConfigurations
  • 为其他速度(Other-speed)配置的数量。

设备限定描述符结构体定义

typedef struct __attribute__ ((packed))
{
    uint8_t  bLength            ; ///< Size of descriptor
    uint8_t  bDescriptorType    ; ///< Device Qualifier Type
    uint16_t bcdUSB             ; ///< USB specification version number (e.g., 0200H for V2.00)

    uint8_t  bDeviceClass       ; ///< Class Code
    uint8_t  bDeviceSubClass    ; ///< SubClass Code
    uint8_t  bDeviceProtocol    ; ///< Protocol Code

    uint8_t  bMaxPacketSize0    ; ///< Maximum packet size for other speed
    uint8_t  bNumConfigurations ; ///< Number of Other-speed Configurations
    uint8_t  bReserved          ; ///< Reserved for future use, must be zero
}usb_desc_device_qualifier_t;

获取设备限定描述符的请求

标准设备请求

typedef struct __attribute__ ((packed)){
    union {
        struct __attribute__ ((packed)) {
          uint8_t recipient :  5; ///< Recipient type usb_request_recipient_t.
          uint8_t type      :  2; ///< Request type usb_request_type_t.
          uint8_t direction :  1; ///< Direction type. usb_dir_t
        } bmRequestType_bit;

        uint8_t bmRequestType;
    };

    uint8_t  bRequest;
    uint16_t wValue;
    uint16_t wIndex;
    uint16_t wLength;
} usb_control_request_t;

USB 控制端点收到的数据

0x80 0x6 0x0 0x6 0x0 0x0 0xa 0x0

• bmRequestType：0x80
  • 数据传输方向为 1，device-to-host
  • 标准请求
  • 请求的接收者为设备
• bRequest：0x06
  • GET_DESCRIPTOR 获取描述符请求
• wValue：0x0006（LSB）
  • 低位：0x06 设备限定描述符
  • 高位：0x00 索引号
• wIndex：0x0000（LSB）
  • 低位：0x00
  • 高位：0x00
• wLength：0x0a
  • 低位：0x0a 请求返回的字节数为 0x0a，设备限定描述符的长度为 0x0a
  • 高位：0x00

设备限定描述符返回

由于当前只能进行全速(full-speed)操作(设备描述符的版本号等于0200H)，设备接收到请求设备限定符的 Get Descriptor 请求，它必须用请求错误响应，回复 STALL 来响应。

USB 传输日志片段如下：

output ep int 
h->d: 0x80 0x6 0x0 0x6 0x0 0x0 0xa 0x0 
send xfer complete event
get device qualifier
stall ep0

如果需要返回设备限定描述符，设备限定描述符的实现如下(当前未使用)

usb_desc_device_qualifier_t const desc_device_qualifier =
{
  .bLength            = sizeof(usb_desc_device_qualifier_t),
  .bDescriptorType    = USB_DESC_DEVICE_QUALIFIER,
  .bcdUSB             = USB_BCD,

  .bDeviceClass       = 0x00,
  .bDeviceSubClass    = 0x00,
  .bDeviceProtocol    = 0x00,

  .bMaxPacketSize0    = USBD_ENDPOINT0_SIZE,
  .bNumConfigurations = 0x01,
  .bReserved          = 0x00
};

附 STM32 枚举日志

HID 鼠标枚举过程分析

suspend int
bus reset int
enum done int
rxflvl int
setup packed recvd
setup packed done
output ep int 
h->d: 0x80 0x6 0x0 0x1 0x0 0x0 0x40 0x0 
dcd xfer
input ep int 
d->h :0x12 0x1 0x0 0x2 0x0 0x0 0x0 0x40 0xfe 0xca 0x8 0x40 0x0 0x1 0x1 0x2 0x3 0x1 
turn off txfe
input ep int 
edpt int send xfer complete event
dcd xfer
rxflvl int
bus reset int
output ep int 
send xfer complete event
enum done int
rxflvl int
setup packed recvd
setup packed done
output ep int 
h->d: 0x0 0x5 0x5 0x0 0x0 0x0 0x0 0x0 
dcd xfer
input ep int 
edpt int send xfer complete event
rxflvl int
setup packed recvd
setup packed done
output ep int 
h->d: 0x80 0x6 0x0 0x1 0x0 0x0 0x12 0x0 
dcd xfer
input ep int 
d->h :0x12 0x1 0x0 0x2 0x0 0x0 0x0 0x40 0xfe 0xca 0x8 0x40 0x0 0x1 0x1 0x2 0x3 0x1 
turn off txfe
input ep int 
edpt int send xfer complete event
dcd xfer
rxflvl int
output ep int 
send xfer complete event
rxflvl int
setup packed recvd
setup packed done
output ep int 
h->d: 0x80 0x6 0x0 0x2 0x0 0x0 0xff 0x0 
dcd xfer
input ep int 
d->h :0x9 0x2 0x22 0x0 0x1 0x1 0x0 0xa0 0x32 0x9 0x4 0x0 0x0 0x1 0x3 0x1 0x2 0x0 0x9 0x21 0x11 0x1 0x0 0x1 0x22 0x4d 0x0 0x7 0x5 0x81 0x3 0x8 0x0 0xa 
turn off txfe
input ep int 
edpt int send xfer complete event
dcd xfer
rxflvl int
setup packed recvd
setup packed done
output ep int 
h->d: 0x80 0x6 0x3 0x3 0x9 0x4 0xff 0x0 
send xfer complete event
dcd xfer
input ep int 
d->h :0xe 0x3 0x31 0x0 0x32 0x0 0x33 0x0 0x34 0x0 0x35 0x0 0x36 0x0 
turn off txfe
input ep int 
edpt int send xfer complete event
dcd xfer
rxflvl int
setup packed recvd
setup packed done
output ep int 
h->d: 0x80 0x6 0x0 0x3 0x0 0x0 0xff 0x0 
send xfer complete event
dcd xfer
input ep int 
d->h :0x4 0x3 0x9 0x4 
turn off txfe
input ep int 
edpt int send xfer complete event
dcd xfer
rxflvl int
setup packed recvd
setup packed done
output ep int 
h->d: 0x80 0x6 0x2 0x3 0x9 0x4 0xff 0x0 
send xfer complete event
dcd xfer
input ep int 
d->h :0x1e 0x3 0x74 0x0 0x79 0x0 0x75 0x0 0x73 0x0 0x74 0x0 0x6c 0x0 0x69 0x0 0x20 0x0 0x44 0x0 0x65 0x0 0x76 0x0 0x69 0x0 0x63 0x0 0x65 0x0 
turn off txfe
input ep int 
edpt int send xfer complete event
dcd xfer
rxflvl int
setup packed recvd
setup packed done
output ep int 
h->d: 0x80 0x6 0x0 0x6 0x0 0x0 0xa 0x0 
send xfer complete event
get device qualifier
stall ep0
rxflvl int
setup packed recvd
setup packed done
output ep int 
h->d: 0x80 0x6 0x0 0x1 0x0 0x0 0x12 0x0 
dcd xfer
input ep int 
d->h :0x12 0x1 0x0 0x2 0x0 0x0 0x0 0x40 0xfe 0xca 0x8 0x40 0x0 0x1 0x1 0x2 0x3 0x1 
turn off txfe
input ep int 
edpt int send xfer complete event
dcd xfer
rxflvl int
setup packed recvd
setup packed done
output ep int 
h->d: 0x80 0x6 0x0 0x2 0x0 0x0 0x9 0x0 
send xfer complete event
dcd xfer
input ep int 
d->h :0x9 0x2 0x22 0x0 0x1 0x1 0x0 0xa0 0x32 
turn off txfe
input ep int 
edpt int send xfer complete event
dcd xfer
rxflvl int
setup packed recvd
setup packed done
output ep int 
h->d: 0x80 0x6 0x0 0x2 0x0 0x0 0x22 0x0 
send xfer complete event
dcd xfer
input ep int 
d->h :0x9 0x2 0x22 0x0 0x1 0x1 0x0 0xa0 0x32 0x9 0x4 0x0 0x0 0x1 0x3 0x1 0x2 0x0 0x9 0x21 0x11 0x1 0x0 0x1 0x22 0x4d 0x0 0x7 0x5 0x81 0x3 0x8 0x0 0xa 
turn off txfe
input ep int 
edpt int send xfer complete event
dcd xfer
rxflvl int
setup packed recvd
setup packed done
output ep int 
h->d: 0x0 0x9 0x1 0x0 0x0 0x0 0x0 0x0 
send xfer complete event
edpt open
dcd xfer
input ep int 
edpt int send xfer complete event
rxflvl int
setup packed recvd
setup packed done
output ep int 
h->d: 0x21 0xa 0x0 0x0 0x0 0x0 0x0 0x0 
dcd xfer
input ep int 
edpt int send xfer complete event
rxflvl int
setup packed recvd
setup packed done
output ep int 
h->d: 0x81 0x6 0x0 0x22 0x0 0x0 0x8d 0x0 
dcd xfer
input ep int 
d->h :0x5 0x1 0x9 0x2 0xa1 0x1 0x9 0x1 0xa1 0x0 0x5 0x9 0x19 0x1 0x29 0x5 0x15 0x0 0x25 0x1 0x95 0x5 0x75 0x1 0x81 0x2 0x95 0x1 0x75 0x3 0x81 0x1 0x5 0x1 0x9 0x30 0x9 0x31 0x15 0x81 0x25 0x7f 0x95 0x2 0x75 0x8 0x81 0x6 0x9 0x38 0x15 0x81 0x25 0x7f 0x95 0x1 0x75 0x8 0x81 0x6 0x5 0xc 0xa 0x38 
turn off txfe
input ep int 
edpt int send xfer complete event
dcd xfer
input ep int 
d->h :0x2 0x15 0x81 0x25 0x7f 0x95 0x1 0x75 0x8 0x81 0x6 0xc0 0xc0 
turn off txfe
input ep int 
edpt int send xfer complete event
dcd xfer
rxflvl int
output ep int 
send xfer complete event
rxflvl int
setup packed recvd
setup packed done
output ep int 
h->d: 0x80 0x6 0x0 0x3 0x0 0x0 0xff 0x0 
dcd xfer
input ep int 
d->h :0x4 0x3 0x9 0x4 
turn off txfe
input ep int 
edpt int send xfer complete event
dcd xfer
rxflvl int
setup packed recvd
setup packed done
output ep int 
h->d: 0x80 0x6 0x0 0x3 0x0 0x0 0xff 0x0 
send xfer complete event
dcd xfer
input ep int 
d->h :0x4 0x3 0x9 0x4 
turn off txfe
input ep int 
edpt int send xfer complete event
dcd xfer
rxflvl int
setup packed recvd
setup packed done
output ep int 
h->d: 0x80 0x6 0x1 0x3 0x9 0x4 0xff 0x0 
send xfer complete event
dcd xfer
input ep int 
d->h :0x10 0x3 0x74 0x0 0x79 0x0 0x75 0x0 0x73 0x0 0x74 0x0 0x6c 0x0 0x69 0x0 
turn off txfe
input ep int 
edpt int send xfer complete event
dcd xfer
rxflvl int
setup packed recvd
setup packed done
output ep int 
h->d: 0x80 0x6 0x1 0x3 0x9 0x4 0xff 0x0 
send xfer complete event
dcd xfer
input ep int 
d->h :0x10 0x3 0x74 0x0 0x79 0x0 0x75 0x0 0x73 0x0 0x74 0x0 0x6c 0x0 0x69 0x0 
turn off txfe
input ep int 
edpt int send xfer complete event
dcd xfer
rxflvl int
setup packed recvd
setup packed done
output ep int 
h->d: 0x80 0x6 0x2 0x3 0x9 0x4 0xff 0x0 
send xfer complete event
dcd xfer
input ep int 
d->h :0x1e 0x3 0x74 0x0 0x79 0x0 0x75 0x0 0x73 0x0 0x74 0x0 0x6c 0x0 0x69 0x0 0x20 0x0 0x44 0x0 0x65 0x0 0x76 0x0 0x69 0x0 0x63 0x0 0x65 0x0 
turn off txfe
input ep int 
edpt int send xfer complete event
dcd xfer
rxflvl int
setup packed recvd
setup packed done
output ep int 
h->d: 0x80 0x6 0x2 0x3 0x9 0x4 0xff 0x0 
send xfer complete event
dcd xfer
input ep int 
d->h :0x1e 0x3 0x74 0x0 0x79 0x0 0x75 0x0 0x73 0x0 0x74 0x0 0x6c 0x0 0x69 0x0 0x20 0x0 0x44 0x0 0x65 0x0 0x76 0x0 0x69 0x0 0x63 0x0 0x65 0x0 
turn off txfe
input ep int 
edpt int send xfer complete event
dcd xfer
rxflvl int
output ep int 
send xfer complete event
dcd xfer
0x0 0x5 0x5 0x0 0x0 
input ep int 
d->h :0x0 0x5 0x5 0x0 0x0 
turn off txfe
input ep int 
edpt int send xfer complete event
dcd xfer
0x0 0x5 0x5 0x0 0x0 
input ep int 
d->h :0x0 0x5 0x5 0x0 0x0 
turn off txfe
input ep int 
edpt int send xfer complete event
dcd xfer
0x0 0x5 0x5 0x0 0x0 
input ep int 
d->h :0x0 0x5 0x5 0x0 0x0 
turn off txfe
input ep int 
edpt int send xfer complete event
dcd xfer
0x0 0x5 0x5 0x0 0x0 
input ep int 
d->h :0x0 0x5 0x5 0x0 0x0 
turn off txfe
input ep int 
edpt int send xfer complete event
dcd xfer
0x0 0x5 0x5 0x0 0x0 
input ep int 
d->h :0x0 0x5 0x5 0x0 0x0 
turn off txfe
input ep int 
edpt int send xfer complete event
dcd xfer
0x0 0x5 0x5 0x0 0x0 
input ep int 
d->h :0x0 0x5 0x5 0x0 0x0 
turn off txfe
input ep int 
edpt int send xfer complete event
dcd xfer
0x0 0x5 0x5 0x0 0x0 
input ep int 
d->h :0x0 0x5 0x5 0x0 0x0 
turn off txfe
input ep int 
edpt int send xfer complete event
dcd xfer
0x0 0x5 0x5 0x0 0x0 
input ep int 
d->h :0x0 0x5 0x5 0x0 0x0 
turn off txfe
input ep int 
edpt int send xfer complete event
dcd xfer
0x0 0x5 0x5 0x0 0x0 
input ep int 
d->h :0x0 0x5 0x5 0x0 0x0 
turn off txfe
input ep int 
edpt int send xfer complete event
dcd xfer
0x0 0x5 0x5 0x0 0x0 
input ep int 
d->h :0x0 0x5 0x5 0x0 0x0 
turn off txfe
input ep int 
edpt int send xfer complete event