基于Qt的CAN通信调试工具：支持多种CAN接口卡、多线程接收、帧类型灵活配置与自动保存功能

Qt编写的CAN通信调试工具源代码支持吉阳光电CAN盒和致远周立功USB转CAN卡，带多线程接收 可完成标准和扩展CAN帧YID发送和接收，带配置参数自动保存，定时发送，帧类型选择，文本和十六进制等。 带有折叠相同的帧YID的功能，如果有相同的帧YID，则会自动折叠显示。 可组装发送字节，short,int,float等数据。 带有保存到文件功能，文件名根据时间自动生成，解决了保存成中文乱码的问题。 2.环境说明： 开发环境是Qt5，使用吉阳光电和ZLG周立功的USB-CAN卡的开发库ControlCAN.dll。 源代码中包含详细注释，使用说明，设计文档等。 请将源码放到纯英文路径下再编译。 3.使用介绍： 使用方便，直接运行样例里的exe可执行文件即可看到操作界面，操作并了解软件运行流程。 本代码产品特点： 1、尽量贴合实际应用，方便软件模块复用。 2、注释完善，讲解详细，还有相关扩展知识点介绍。 3、提供代码设计文档，使用文档，环境配置文档等。 4.子功能模块介绍： 封装了CAN通信通信类，可方便更换其他CAN卡； 具有控制台调试窗口，配置参数可自动保存； 带有数据保存功能，文件名可根据时间及日期自动生成； 相同帧YID的报文可自动折叠显示； 带有字节和整数组装发送功能，可以文本或十六进制输入； 设计了多线程接收数据，避免阻塞主线程。 。

CAN 通信调试工具功能说明书

（基于 Qt 的吉阳光电 & 周立功双栈实现）

一、产品定位

本工具是面向汽车电子、工业控制、嵌入式测试场景的桌面级 CAN 总线调试助手。通过同一套界面框架，同时支持“吉阳光电 USB-CAN200”与“致远周立功 USB-CAN-II”两种主流适配器；在 Windows 平台下即插即用，可实现 5 k ~ 1 Mbps 全波特率收发、报文折叠、定时发送、实时保存、十六进制/字符双模式解析等完整调试闭环。

二、总体架构

1. 分层模型

┌------------------- 应用层（UI） -------------------┐

│ MainDialog：参数面板、发送区、接收区、折叠逻辑 │

├------------------- 服务层（Service）----------------┤

│ Port 抽象接口：connect / start / send / recv / save │

│ ├─CanGTPort（吉阳栈，多线程接收） │

│ └─CanZPort（周立功栈，定时器接收） │

├------------------- 数据层（Model）-------------------┤

│ ConfigData：全局配置（波特率、滤波、AccCode…） │

Qt编写的CAN通信调试工具源代码支持吉阳光电CAN盒和致远周立功USB转CAN卡，带多线程接收 可完成标准和扩展CAN帧YID发送和接收，带配置参数自动保存，定时发送，帧类型选择，文本和十六进制等。 带有折叠相同的帧YID的功能，如果有相同的帧YID，则会自动折叠显示。 可组装发送字节，short,int,float等数据。 带有保存到文件功能，文件名根据时间自动生成，解决了保存成中文乱码的问题。 2.环境说明： 开发环境是Qt5，使用吉阳光电和ZLG周立功的USB-CAN卡的开发库ControlCAN.dll。 源代码中包含详细注释，使用说明，设计文档等。 请将源码放到纯英文路径下再编译。 3.使用介绍： 使用方便，直接运行样例里的exe可执行文件即可看到操作界面，操作并了解软件运行流程。 本代码产品特点： 1、尽量贴合实际应用，方便软件模块复用。 2、注释完善，讲解详细，还有相关扩展知识点介绍。 3、提供代码设计文档，使用文档，环境配置文档等。 4.子功能模块介绍： 封装了CAN通信通信类，可方便更换其他CAN卡； 具有控制台调试窗口，配置参数可自动保存； 带有数据保存功能，文件名可根据时间及日期自动生成； 相同帧YID的报文可自动折叠显示； 带有字节和整数组装发送功能，可以文本或十六进制输入； 设计了多线程接收数据，避免阻塞主线程。 。

│ CanMsg：8 字节数据联合体重解析（byte/short/long/float）│

└------------------- 驱动层（Driver）------------------┘

GY8508.dll / ControlCAN.dll（厂商提供，已做 32/64 位隔离）

1. 线程模型

• GUI 线程：负责界面刷新、参数下发、文件保存。
• 收发线程：

吉阳方案——QThread::run() 内死循环调用 VCI_Receive()，收到报文后 emit 信号到 GUI；

周立功方案——QTimer 每 60 ms 触发一次 VCI_Receive()，同样通过 Qt::QueuedConnection 把数据抛给主线程。

• 定时发送线程：可选 QTimer，周期 1 ms~10 s 可配，支持 ID 自增、远程帧、扩展帧。

三、核心功能与实现要点

1. 零侵入切换双栈

Port 虚基类把“打开-启动-发送-关闭”抽象为 4 个纯虚函数。新增第三方 CAN 卡时，仅须再实现一个 Port 子类，上层 UI 与业务逻辑零改动。

1. 波特率热切换

配置面板下拉框切换波特率时，自动填充 Timing0 / Timing1 寄存器值；吉阳栈额外支持 kCanBaud 索引模式，周立功栈通过 SetReference 动态写入 BTR 寄存器，无需重启硬件。

1. 报文折叠算法

接收列表使用 QListWidget，每项隐藏 UserRole 存放 。

折叠开关打开时，新报文先到哈希桶 O(1) 查重，命中则只刷新计数与数据，否则追加新行；关闭折叠则直接 append。

1. 多格式数据拼装

发送区提供 5 种输入视图：Hex/String、Byte、Word、Long、Float。

内部统一转换为 QByteArray，再通过 union CanMsg 按小端序填充到 DLC≤8 的帧缓冲区，保证跨平台字节序一致。

1. 文件落盘

点击“保存”后弹出 QFileDialog，默认文件名 yyyy-MM-dd.hh.mm.txt；使用 QTextStream 以 UTF-8 带 BOM 写出，中文零乱码。

1. 错误自恢复

底层驱动返回 ERRCANBUSOFF 或 ERR_DEVICEOPENED 时，自动弹窗提示并灰掉“启动”按钮，用户重新插拔后可一键重连；同时记录错误码到调试控制台，方便定位。

四、典型使用流程

① 插入 CAN 适配器 → ② 选择设备类型（GY8508 或 ZLG-USBCAN2） → ③ 设置波特率（500 k 默认） → ④ 点击“连接” → ⑤ 点击“启动 CAN” → ⑥ 在发送区填写 ID 与数据 → ⑦ 点击“发送”或勾选“周期发送” → ⑧ 观察接收区，可折叠/保存/清空。

五、性能指标

• 单帧最小周期：≤ 1 ms（Win10+USB3.0 实测）。
• 最大接收缓冲：驱动层 2000 帧，UI 层 10 000 行无卡顿。
• CPU 占用：周期发送 1 ms 时主线程 < 8 %。

六、扩展指南

1. 增加新 CAN 卡

a) 新建 Port 子类，实现 4 个虚函数；

b) 在 MainDialog::fillCandidate() 追加设备名与宏；

c) 把驱动 dll 放到 exe 同级目录即可。

1. 切换语言

所有界面字符串均使用 QStringLiteral 宏，lupdate 一键提取，已带中英双语 ts 文件。

1. 自动化测试

pro 文件内打开 CONFIG+=console 即可获得控制台，qDebug 输出帧 ID、时间戳、方向标志，可被 pytest-gui 或 Robot Framework 直接捕获断言。

七、注意事项

• 吉阳栈编译请用 MinGW32，周立功栈请用 MSVC2015-64，否则底层 dll 依赖不同。
• 路径中切勿出现中文或空格，避免 QLibrary 加载失败。
• 若出现“设备已打开”错误，请在设备管理器里手动卸载旧驱动再重新插拔。

八、结语

本工具通过“抽象接口 + 多线程/定时器双方案 + 折叠缓存 + 多格式解析”四板斧，把 CAN 调试场景中最常用的 80 % 需求固化成一键操作，剩余 20 % 边缘需求则以插件化虚函数形式开放，兼顾了易用性与可扩展性，可作为车载、工控、嵌入式团队的标准桌面调试装备。