DewoTest 扫码串口支持变更记录

变更目标

在 WeightActivity 中补充德沃串口扫码器的打开、开始扫码、停止扫码、数据组帧与解析、实时展示和关闭能力，并验证称重与扫码两个串口可以同时工作。

硬件与协议依据

• 扫码串口：/dev/ttyS4
• 串口参数：115200 baud，8 数据位，无校验，1 停止位
• 字符编码：GB2312；数字和字母等 ASCII 条码与 UTF-8 字节兼容
• 帧边界：优先识别 CR/LF；无结束符时在 50 ms 接收空闲后提交当前帧
• 单帧上限：1024 字节，超长帧丢弃并计数
• 开始扫码命令：1A 54 0D
• 停止扫码命令：1A 55 0D
• 依据文件：DewoAndroid串口开发SDK&app2.2&gb2312.zip 中的 SDK、示例源码和说明文档

实现内容

1. 新增 ScannerProtocol，负责命令常量、CR/LF 分帧、50 ms 空闲分帧、GB2312 解码、控制字符清理、超长帧保护和原始十六进制输出。
2. 新增 ScannerSerialController，负责 /dev/ttyS4 的打开、后台读取、命令发送、异常回调和资源释放。
3. 新增 ScannerReading，向页面提供已完成组帧和清理的扫码内容、原始字节和接收时间。
4. 扩展 WeightActivity，同时管理称重和扫码两个独立串口；页面停止或销毁时释放两路串口。
5. 扩展页面展示扫码连接状态、端口参数、最近扫码、有效扫码数、超长帧数、原始报文、接收时间和错误信息。
6. 增加打开、开始扫码、停止扫码和关闭扫码串口按钮，并在重新打开时清空上一会话的扫码展示与计数。
7. 修复称重和扫码串口打开失败后按钮无法恢复的问题。

测试与真机验证

• ./gradlew testDebugUnitTest：通过，共 11 个单元测试，无失败。
• 扫码协议测试：5 个，覆盖命令字节、拆包/粘包、CR/LF、空闲超时、GB2312、控制字符清理、超长帧丢弃和后续恢复。
• ./gradlew assembleDebug：通过。
• ./gradlew lintDebug：通过。
• DWL201 安装调试 APK：成功。
• 扫码串口打开：成功。
• 开始扫码与停止扫码命令发送：成功。
• 扫码串口关闭：成功，页面按钮恢复未连接状态。
• 双串口并行：成功；扫码口保持打开时，称重口仍显示 1153 g、稳定、约 9.9 Hz，无校验错误。

验证边界

• 本次现场没有向扫描头提供可识别条码，因此没有取得真实扫码内容帧。
• 串口打开、命令发送、关闭及双串口并行已经真机验证；扫码分帧和内容解析由单元测试验证。
• 真机验证前已停止 com.dewod.demo，避免其占用相同串口。

结论

WeightActivity 已同时具备称重和扫码串口的管理与展示能力。扫码串口生命周期、控制命令及双串口并行已经在 DWL201 上验证，数据解析覆盖厂商 CR/LF 模式和无结束符的空闲超时模式。