4.1 设备描述符

功能概述

设备描述符（Device Descriptor）是 USB设备 的根描述符，包含设备的基本信息(如厂商ID、产品ID、设备类、支持的配置数量等)。

每个USB设备必须有且仅有一个设备描述符。

数据结构定义

设备描述符是设备连接到总线上时，USB主机所读取的第一个描述符，它包含了14个字段，结构如下：

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));

字段详解

描述符类型 (bDescriptorType)

其含义可查下表（此表也适用于标准命令 Get_Descriptor 中 wValue域高字节 的取值含义）。

USB描述符的类型，分为3大类： 标准描述符、类描述符 和 厂家自定义描述符

1、标准描述符（Standard Descriptors）

2、类描述符（Class Descriptors）

3、厂商定义的描述符（Vendor-Defined Descriptors）

设备类别（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字节）
};