本帖最后由 LOVEEVER 于 2026-11-18 23:39 编辑
需求
一台小型测试仪,要求插上电脑后同时具备两个功能:一个是自定义 HID,用来收发几字节的控制命令;一个是 CDC 虚拟串口,用来传测试数据和日志。原来的做法是两个独立设备来回切换,插拔麻烦,用户体验差。改成 USB 复合设备之后,一个插头就够。主控选 CH32V203 是因为它自带全速 USB 设备控制器,成本也合适。
一、复合设备的关键在描述符
复合设备不是把两个描述符简单拼起来。USB 规范里复合设备必须用一个接口关联描述符(IAD)把功能分组,否则主机(尤其是 Windows)不会把两套功能识别成同一个设备。
结构上大致是:设备描述符 1 个(bNumConfigurations=1)→ 配置描述符 1 个 → 配置描述符里 bNumInterfaces 写 2 → 然后依次是 IAD 描述符、HID 接口描述符、HID 描述符、端点描述符、CDC 的 IAD(可选)、CDC 通信接口、CDC 数据接口。
几个具体数值:bDeviceClass 必须写 0xEF、bDeviceSubClass 写 0x02、bDeviceProtocol 写 0x01,这三个是「多接口复合设备」的固定标识,写错主机会把它当成未知设备。
二、端点分配
CH32V203 的 USB 端点资源不多,要给两套功能都留出空间。
· HID:EP1 IN 中断端点 8 字节,EP1 OUT 可选,轮询间隔 1ms
· CDC 通信接口:EP2 IN 中断端点 16 字节(用于响应类请求)
· CDC 数据接口:EP3 IN 批量 64 字节、EP4 OUT 批量 64 字节
总共用了 5 个端点,端点缓冲区要按 2 的幂对齐,否则会出现某个方向的数据长度被截断,这种问题很难查出来,现象是偶尔丢几个字节。
三、实测
· HID 命令往返延迟:平均 1.3ms(受 1ms 轮询间隔限制)
· CDC 吞吐:约 720KB/s,接近全速理论值的 85%
· 两路同时工作:HID 每 1ms 一次命令,CDC 连续传 100MB 数据,无丢包、无设备掉线
· 主机兼容性:Windows 10/11、Ubuntu 20.04、macOS 都识别成一个设备带两个功能
四、踩到的坑
1、字符串描述符的索引必须连续,中间缺一个索引,某些主机会直接枚举失败,而且没有任何提示。
2、配置描述符的总长度 wTotalLength 要精确等于所有描述符字节数之和,多算少算都枚举失败。我的做法是用宏把长度算出来,而不是手写常量。
3、CDC 的通信接口必须有一个中断 IN 端点,用于响应 SET_LINE_CODING 之类请求。如果省掉它,Linux 下能用,Windows 下设备管理器会有感叹号。
4、EP0 的 SETUP 处理里如果有分支返回了 STALL,后面同一个 setup 包再进来会被主机判为设备无响应,一定要保证状态机干净退出。
5、插入已经枚举过的 USB 口后,Windows 可能用缓存的描述符,改描述符后测试要换口或卸载设备重新枚举,否则会误以为改错了。
6、如果调试时要看 USB 通信,务必用总线分析仪抓包,只靠软件日志看不清控制传输的往返关系。
五、小结
CH32V203 做复合设备资源够用,真正的工作量在描述符的正确性上。建议先把描述符表在纸上画清楚、算出每个长度字段,再写代码;调试阶段先用 USB 描述符查看工具确认主机看到的和你想的一致。
以上吞吐数据在 USB 2.0 全速口、直连主机(不经 Hub)条件下测得,供参考。 |