利用USB分析仪排查HID故障记录（2）——丢包问题

一、问题：丢包

依旧是上次在文章中提到的HID高速设备，在解决了设备描述符长度错误的问题后，我进行了收发测试，发现收到的数据丢失：根据通信协议，主机每发送一包特定指令，设备应回复连续8包数据。然而，上位机软件记录显示，实际接收到的数据包数量低于理论值（发送指令数×8），存在丢包现象。

二、系统化分层排查策略

由于HID设备的数据收发涉及硬件层、驱动层及软件层，很难直接定位到问题源头。

为此，我设计了一套系统化的排查方案，利用USB分析仪，从底层到高层逐步排查。

三、从硬件到软件的逐级定位

3.1 连接分析仪，捕捉收发数据

先将USB分析仪连接主机，打开分析仪的配套软件，选择“只显示新插入设备”，然后，将设备接入分析仪。

分析仪传输列表清晰显示，对于主机的每一次OUT指令事务，设备均严格遵循协议，在高速总线上以125㎲的稳定间隔连续回复8个IN数据包。且所有事务均成功完成，无NAK/STALL错误，无CRC校验失败，经过比对，数据也是完整的。

使用右键菜单中的“设置为时间戳原点”或者“添加标记”即可查看任意数据包之前的时间间隔，无需手动计算。

3.2 替换驱动后检查数据完整性

替换为CH372驱动后，再次使用分析仪捕捉数据，数据依旧完整，而应用层数据显示不完整。

此时，也可以使用USB端点调试工具(下载：USBEndpDebug）来调试该设备，USBEndpDebug使用CH37X应用接口库，适用于CH37X设备进行单端点调试、多端点调试，批量收发，文件比对。

由此可以排除驱动问题，问题只可能出现在软件的数据接收逻辑中。

3.3 应用软件排查

基于前两步的排除法，问题已经锁定在了应用软件的数据接收逻辑。由于软件层涉及到数据的显示，可能会影响结果，因此我创建了一个最小化测试Demo，仅保留核心的发送指令与计数接收包功能。测试再现了丢包。

经过代码审查，我发现软件中异步读取时存在逻辑缺陷：在调用WaitForMultipleObjects等待操作完成后，随即调用GetOverlappedResult函数时，其最后一个参数bWait被错误地设为FALSE。这会导致函数立即返回，当I/O操作仍在进行时（状态为ERROR_IO_INCOMPLETE），程序误判为失败并丢弃了该数据包，从而导致了丢包问题。

四、修正问题

针对此问题，我调整了GetOverlappedResult函数的参数设置，确保在I/O操作完全完成后再进行结果判断，有效解决了丢包难题。

另：安利一下文章中提到的HID调试的上位机软件（下载:HIDAssist），该软件支持复合设备调试，支持键鼠监听，支持中断/特征/控制传输，支持单条/批量发送、循环发送、文件发送，支持接收区自定义高亮关键字，搜索统计关键字。