4.1 设备描述符

功能概述

设备描述符（Device Descriptor）是 USB设备 的根描述符，包含设备的基本信息，如厂商ID、产品ID、设备类、支持的配置数量等。每个USB设备必须有且仅有一个设备描述符。

数据结构定义

struct usb_device_descriptor {
    uint8_t  bLength;            // 描述符长度（18字节）
    uint8_t  bDescriptorType;    // 描述符类型（固定为0x01）
    uint16_t bcdUSB;             // USB规范版本号（BCD码）
    uint8_t  bDeviceClass;       // 设备类代码
    uint8_t  bDeviceSubClass;    // 设备子类代码
    uint8_t  bDeviceProtocol;    // 设备协议代码
    uint8_t  bMaxPacketSize0;    // 端点0的最大包大小
    uint16_t idVendor;           // 厂商ID（由USB-IF分配）
    uint16_t idProduct;          // 产品ID（厂商自定义）
    uint16_t bcdDevice;          // 设备版本号（BCD码）
    uint8_t  iManufacturer;      // 厂商字符串描述符索引
    uint8_t  iProduct;           // 产品字符串描述符索引
    uint8_t  iSerialNumber;      // 序列号字符串描述符索引
    uint8_t  bNumConfigurations; // 支持的配置数量
} __attribute__ ((packed));

字段详解

设备类代码（bDeviceClass）

示例（USB鼠标设备描述符）

关键说明

1. 端点0：所有USB设备必须支持端点0（控制端点），用于枚举和配置。
2. 字符串描述符：索引值为0表示无对应字符串。
3. 版本号：均以BCD码格式存储（如0x0200表示2.0）。
4. 配置数量：即使设备只有一种工作模式，bNumConfigurations也必须≥1。

获取方式

主机通过控制传输的GET_DESCRIPTOR请求获取设备描述符：

struct usb_ctrlrequest {
    uint8_t  bmRequestType = 0x80; // 主机到设备
    uint8_t  bRequest = 0x06;       // GET_DESCRIPTOR
    uint16_t wValue = 0x0100;       // 高字节=0x01（设备描述符）
    uint16_t wIndex = 0x0000;       // 语言ID（0表示默认）
    uint16_t wLength = 0x0012;      // 请求长度（18字节）
};