2026-08-26 一卡通读卡器 HID 报告长度修复

变更结论

已修复 F700-HW 上新开普 0610:2010 HID RF Picc Reader 显示 IO_TIMEOUT 读卡器异常的问题。根因是驱动按 64 字节发送并等待 HID 报告，而设备报告描述符声明输入、输出报告均为 32 字节。

项目文件变更

• HidFrameCodec.REPORT_SIZE 从 64 调整为 32。
• 常量旁补充设备协议依据注释；32 字节属于 HID 报告描述符定义的协议值，不是可配置业务参数。
• 新增 HidFrameCodecTest，覆盖 32 字节请求报告以及 25 字节最大响应载荷解析。
• 未修改 USB VID/PID、权限流程、寻卡间隔、状态机或一卡通业务协议字段。

证据与验证

• 设备 /sys/bus/hid/devices/0003:0610:2010.0005/report_descriptor 显示 Input/Output 的 Report Count 均为 0x20，即 32 字节。
• 修复前：USB 枚举、授权、打开和接口独占成功，写入 64 字节后等待 3 秒报 IO_TIMEOUT；同机 OnecardDemo 表现一致。
• 回归测试先以 64 字节实现运行并产生 2 个失败，调整后 :app:testDebugUnitTest --tests com.zhct.traybinding.onecard.reader.HidFrameCodecTest 通过。
• :app:assembleDebug 构建成功，Debug APK 已覆盖安装到当前 F700-HW。
• 真机日志出现 written=32、inputBytes=32、PROTOCOL_INITIALIZE_SUCCESS 和 CONNECT_SUCCESS。
• 真机持续寻卡成功，并识别到卡片 UID 92071FC9。

范围与边界

• 本次只修复一卡通 USB HID 报告长度及其回归测试。
• 人员同步仍因当前设备无法连接 10.128.1.19:80 独立超时，不影响已修复的读卡器连接与寻卡。
• 未执行 Git 暂存、提交、推送、分支切换或其他 Git 写操作。