Jay

一、立项背景和目标 随着工业自动化、智能制造及物流分拣等场景对高性能读码器需求的不断提升，传统单一通信方式、功能割裂的调试工具已难以满足多协议、多数据类型及复杂应用环境下的设备调试与运维需求。本项目旨在开发一款集设备发现、连接管理、数据交互、图像调试、性能分析及日志追溯于一体的专业读码器上位机调试软件。 通过统一的上位机平台，实现对读码器在 UDP、TCP、WebSocket、串口等多种通信方式下的高效调试与数据分析，提升研发调试效率、降低现场部署与维护成本，并为后续设备量产、远程诊断及系统集成提供可靠的软件支撑。 二、软件功能与核心功能模块介绍 1. 设备探测与连接管理模块 基于 UDP 广播 /串口机制 实现读码器自动搜索与识别 显示设备 IP、端口、SN 等关键信息 支持 TCP/串口 连接 进行稳定数据交互 2. 多协议数据通信模块 TCP / WebSocket 通信：用于扫码结果、图像数据等高频数据传输 串口通信：适配现场调试与生产测试场景 XModem 协议：用于串口图像数据传输，保证数据完整性与可靠性 Protobuf 协议：实现结构化、高效、可扩展的数据交互 3. 图像与扫码数据处理模块 实时接收并显示读码器采集的原始图像 展示扫码内容、解码状态及附加信息 支持图像数据与扫码数据的同步解析 4. 性能分析与可视化模块 基于 QCustomPlot 实现解码耗时与解码分数的散点分布图 支持实时刷新与历史数据统计 直观反映读码器在不同工况下的解码性能与稳定性 5. 网络调试与扩展模块 集成 QCefView（Chromium 内核） 支持直接打开设备 Web 页面进行网络调试与参数配置 提供与设备 Web 端一致的调试体验 6. 实时日志与追溯模块 全流程日志记录（设备搜索、连接、通信、解码、异常） 支持按时间、类型过滤查看 为问题定位、现场分析及质量追溯提供依据 三、业务流程与功能路径描述 设备搜索阶段 软件启动后，通过 UDP 探测机制自动搜索局域网内的读码器设备，并将搜索结果以列表形式展示。 设备连接阶段 用户选中目标设备后，可建立 TCP 连接，用于后续稳定的数据与图像交互；在特殊调试场景下可切换至串口连接。 数据交互阶段 设备通过 TCP / WebSocket 持续发送扫码数据和图像数据，串口模式下则采用 XModem 协议完成图像传输；所有业务数据基于 Protobuf 协议进行解析。 调试与分析阶段 上位机实时展示扫码结果、图像画面，并通过散点图形式对解码耗时和解码分数进行统计分析，辅助工程人员评估算法性能。 网络与高级调试阶段 通过内置的 QCefView 模块，直接访问设备 Web 管理界面，实现网络参数与高级功能调试。 日志记录与问题追溯阶段 软件在整个生命周期内持续记录操作与通信日志，为、问题定位及后期维护提供数据支撑。