Bus Scope (总线猎手) logo Bus Scope (总线猎手) USB 协议分析

2026-06-03

USB String Descriptor 与 LANGID 调试：序列号、产品名、驱动绑定问题

USB String Descriptor 调试、LANGID 请求失败、序列号描述符 bug、Manufacturer / Product 字符串、重复序列号、驱动绑定问题。

USB String Descriptor, LANGID, 序列号描述符, Manufacturer 字符串, Product 字符串, 重复序列号, USB 诊断

USB String Descriptor 看起来无害，但坏掉的字符串会破坏驱动绑定、设备身份、串口持久化、实验室自动化、固件升级工具和支持流程。设备能枚举但身份不稳定的时候，用户搜 "USB string descriptor 失败"、"LANGID descriptor"、"USB 序列号描述符丢失"、"重复 USB 序列号"、"USB Product 字符串不对"、"Windows 显示未知 USB 设备名"。

Bus Scope 在这个场景下有用，因为字符串描述符失败发生在枚举过程中的 Control Transfer 上。主机先要支持的 LANGID，再要 Manufacturer / Product / Serial Number 字符串。任何一步回了畸形数据，操作系统都还会继续走，但存下来的身份是错的。

LANGID Descriptor

主机在请求具体字符串之前可能先请求 String Descriptor 0，它返回支持的 LANGID。

典型证据：

GET_DESCRIPTOR String index 0
LANGID list returned
GET_DESCRIPTOR String index 1
GET_DESCRIPTOR String index 2
GET_DESCRIPTOR String index 3

String Descriptor 0 一旦失败，后面各主机上的字符串请求就会行为不一致。

Manufacturer / Product / Serial 字符串

常见的 String Index：

  • iManufacturer
  • iProduct
  • iSerialNumber

这三个字段由 Device Descriptor 引用。如果设备声明了一个非零的字符串索引但回不出来，主机的行为会变得不一致。

症状：

  • 设备显示成 "Unknown Device"
  • Product 名字乱码
  • Serial Number 是空的
  • 每次插拔 Windows 都重新分配 COM 端口
  • Linux udev 规则匹配不上
  • 固件升级工具认不出目标
  • 多台设备的身份被合并成同一个

重复的序列号

重复 USB Serial Number 是生产环节的严重问题。两台物理设备如果 VID、PID、Serial Number 都一样，可能被当成同一个设备实例。

后果：

  • 加载错设备的校准数据
  • 测试工位把日志写到错的设备上
  • COM 端口分配变得不可预测
  • 授权或 provisioning 绑错硬件
  • 现场支持分不清是哪一台

抓包可以证明：序列号描述符字节到底是不是真的重复，还是操作系统显示层把更深的问题藏起来了。

序列号缺失

有些设备故意不带 Serial Number。这对简单的外设可以接受，但只要"稳定身份"是必需的，就会出问题。

常见的搜索词：

  • "USB 设备每次都是新 COM 端口"
  • "USB Serial Number 缺失"
  • "Windows USB Device Instance Path 一直在变"
  • "Linux udev 匹配 USB Serial"

Serial Number 一旦缺失，操作系统就只能按端口拓扑来识别设备。

畸形 UTF-16LE 字符串

USB 字符串是 Unicode 编码。固件 bug 包括：

  • 描述符长度算错
  • 字节数为奇数
  • 漏掉 Descriptor Type
  • 非法的 UTF-16LE 字节
  • Null 终止假设不一致
  • 回的是 ASCII 而不是 USB 字符串格式
  • 长 Serial Number 被截断

有些主机容忍这些，有些会拒收描述符或者显示乱码。

字符串请求的时序和重试

主机可能用不同长度请求同一个字符串。设备应该既处理短的 probe 请求，也处理全长请求。

失败模式：

  • 设备正确回了前 2 字节，但全长请求失败
  • 固件假设 wLength 总是等于描述符长度
  • 同一字符串请求在 Control Endpoint 上 STALL
  • Reset 之后 Serial Number 变了
  • Bootloader 和应用固件上报的身份不一样

固件升级工作流里这种问题尤其常见。

对驱动绑定的影响

驱动选择通常看 VID/PID/Class，但 String Descriptor 影响用户看到的设备身份，有时候也影响厂商工具。组合设备、CDC 串口、HID 工具、DFU Bootloader 经常靠字符串来做支持和自动化。

支持工单里出现"USB 设备名不对"，不要当成外观问题放过——它可能是描述符损坏或固件状态混乱。

排查清单

按这个流程：

  1. 从插入开始抓枚举
  2. 检查 Device Descriptor 的字符串索引
  3. 检查 String Descriptor 0 的 LANGID
  4. 解码 Manufacturer 字符串
  5. 解码 Product 字符串
  6. 解码 Serial Number 字符串
  7. 对比两台物理设备
  8. 对比 Bootloader 和应用固件
  9. 检查 Reset 和重插之后的行为
  10. 保留原始描述符字节供固件修复

最终诊断

USB String Descriptor 和 LANGID 的问题会影响设备身份、串口持久化、生产测试、现场支持和驱动流程。关键证据不是操作系统显示的标签，而是真实的描述符 Control Transfer。

Bus Scope 在同一个诊断视图里展示 LANGID、Manufacturer、Product、Serial Number、畸形字符串、重复序列号、枚举重试。

相关工作流