USB 枚举

USB 枚举（USB Enumeration）是 USB 主机在设备接入后，通过复位端口、分配地址、读取描述符、选择配置和绑定驱动，把一个未知外设纳入系统管理的流程。

它解释了为什么插上设备后系统能显示 VID:PID、创建 /dev 节点、绑定设备驱动，也解释了为什么描述符或链路问题会表现为“设备反复出现又消失”。

核心问题

USB 是主机控制总线：设备不能随意主动发送完整数据流，必须先被主机发现和配置。主机需要回答几个问题：

这个端口是否有设备接入，速度是什么。
设备的默认控制端点能否通信。
设备的身份、配置、接口和端点是什么。
应该选择哪个 configuration。
内核该给哪些 interface 绑定驱动，用户态该获得哪些设备节点。

USB 枚举就是这些问题的标准化启动流程。

核心对象

对象	含义	工程关注点
USB host	发起枚举和所有事务的一方	PC、SoC host controller、手机 OTG host 等
USB device	被枚举的外设	固件必须正确响应标准请求
Root hub / hub	端口变化上报者	供电、线缆、hub 质量会影响稳定性
Endpoint 0	默认控制端点	所有设备都必须支持，用于标准请求
USB 设备描述符	第一层身份描述符	包含 VID/PID、class、packet size 等
Configuration	主机选择的设备配置	决定可用 interface 和端点集合
Interface	一个功能单元	复合设备常有多个 interface
Endpoint	数据传输通道	bulk、interrupt、isochronous、control

核心机制

一个简化但工程上常用的枚举流程是：

1. port connect detected
2. host resets the port
3. device responds at default address 0
4. host reads the first bytes of device descriptor
5. host assigns a unique USB address
6. host reads full device descriptor
7. host reads configuration and string descriptors
8. host selects one configuration with SET_CONFIGURATION
9. kernel matches drivers for interfaces
10. user-space hotplug rules run, for example udev

这里的“地址”是 USB 总线地址，不是 IP 地址，也不是设备序列号。它通常随插拔变化，只在当前总线会话中有效。

描述符如何驱动后续行为

主机不是一次读完所有信息，而是顺着描述符树向下读：

device descriptor
  -> configuration descriptor
      -> interface descriptor
          -> endpoint descriptor
          -> class-specific descriptors

device descriptor 告诉主机基础身份；configuration descriptor 告诉主机某个配置下有多少接口；interface descriptor 告诉主机每个功能单元属于哪类设备；endpoint descriptor 告诉主机运行时数据走哪些端点。

驱动绑定通常按接口发生

复合设备中，一个物理设备可以同时有多个 interface。例如一个调试板可能同时暴露串口、HID 控制口和存储接口。内核可能为每个 interface 绑定不同驱动，而不是给整个物理设备只绑定一个驱动。

这也是为什么只看 lsusb 的一行 VID:PID 不够：它告诉你物理设备基础身份，但具体功能还要看接口和端点描述符。

工程用途

dmesg -w 或 journalctl -k -w 观察插拔、reset、descriptor read failure、driver binding。
lsusb 看设备是否完成基础枚举，lsusb -v 看描述符细节。
udevadm monitor --environment --udev 看用户态热插拔事件和属性。
嵌入式 USB device bring-up 时，先确认 endpoint 0 标准请求稳定，再看类协议。
多设备测试时，结合 USB by-path、serial、interface number 和 udev 规则固定定位。

边界与常见坑

枚举成功不等于功能可用：设备能显示在 lsusb 中，只说明基础控制传输可用；视频流、HID report、bulk 数据仍可能失败。
总线地址不稳定：Bus 003 Device 012 这类编号会随插拔变化，不适合写持久规则。
同一 VID:PID 可能有多个 interface：复合设备调试时要看 interface 级别，不要只按整机判断。
反复枚举常指向链路或供电问题：线缆、hub、供电、电磁干扰或固件崩溃都可能导致 disconnect/reset loop。
速度协商影响带宽：High-Speed、SuperSpeed 等枚举结果会影响 UVC、存储等高带宽设备的可用性。
用户态权限不是枚举本身：枚举由内核和 USB 栈完成；udev 只是之后处理设备节点和规则。

Sean's Blog

探索