【免费开源】Qt毫米波雷达通讯上位机:协议配置与数据保存快速上手
【免费开源】Qt毫米波雷达通讯上位机:协议配置与数据保存快速上手
这是一款用 Qt/C++ 编写的毫米波雷达通讯上位机,支持通过串口(Uart)和 CAN 连接雷达,提供 3D/2D 实时可视化、数据文件保存、DBC 解析与摄像录像。适合需要对接雷达、调试数据的你。核心源码与 Windows 可执行文件都在仓库的 DataShow.7z 内,采用 MIT 许可。
🎯 一、它解决什么问题
调试毫米波雷达时,你通常会遇到几件事:雷达通过串口或 CAN 与上位机通讯,不同雷达配的是不同的 CAN 收发器(中科创达、周立功、PEAK 各有一套驱动),对接一遍再换一家就得重做;数据高速刷出,想把目标的距离、速度、角度"看"在屏幕上,得自己解析协议再做显示;测试结束想回放,现场没录下来的数据就再也拿不回来了。
这个项目就是为此写的完整上位机。从仓库内的更新日志 dailycode.txt 可以看到,它按加特兰(Gatan)上位机的数据表名称顺序做了对齐,说明它是面向 Gatan 毫米波雷达场景开发的,把协议接入、显示、记录、指令下发都做进了同一个窗口。
📦 二、项目速览
| 项目 | 说明 |
|---|---|
| 语言 / 框架 | C++11,Qt(.pro 中启用 serialport、serialbus、charts、datavisualization、multimedia 模块) |
| 参考构建环境 | Windows,Qt 5.15.2(mingw 8.1,见压缩包内 build.bat) |
| 仓库构成 | README.md、LICENSE(MIT)、DataShow.7z(源码 + kerneldlls 驱动 + 编译好的 DataShow.exe) |
| 定位 | 雷达数据接入、显示、记录的上位机,中文界面(DataShow_zh.ts/.qm) |
🧩 三、核心能力拆解
多协议接入:串口加三种 CAN 协议栈连雷达
- 解决什么问题:一台工具同时覆盖串口和 CAN 两类链路,CAN 内部再区分 ZLGCAN、CONTROLCAN、PEAKCAN 三套协议栈(对应 zlg_can.cpp、control_can.cpp、mypeakcan.cpp),换换收发器不用换软件。
- 怎么用:
- 打开设置窗口(settingsdialog.cpp),选择链路方式:Serial Port 或 CAN。
- 串口填 PortName、BaudRate、StopBit、Parity、DataBit;默认 Settings.ini 里是 COM10、3000000 bps、8N1。
- CAN 选 Protocol(ZLGCAN/CONTROLCAN/PEAKCAN)、设备类型(如 ZCAN_USBCANFD_MINI)、波特率(默认 500kbps)和通道;所有参数写入 Settings.ini,下次启动自动读入。
- 适合谁:手上同时有串口板和多款 CAN 收发器的雷达对接与测试人员。
实时可视化:3D 点云、2D 图表与数据表
- 解决什么问题:雷达目标数据刷出来只是字节流,直接看没有意义。主界面(mainwindow.cpp)用 Q3DScatter 画 3D 点云,用 QtCharts 画 2D 图——AK、BK 两个坐标系各有 XY 位置和 R/V(距离-速度)两组图,另配 QTableWidget 数据表逐行显示目标。
- 怎么用:启动通讯后自动刷新;坐标轴范围在设置窗口的 2D/3D 参数页调整(对应 ini 的 2DParam、3DParam 段),保存后立即生效。
- 适合谁:需要肉眼确认目标轨迹、速度和角度的算法与集成工程师。
数据记录与文件解析:实时落盘加 DBC 解码
- 解决什么问题:现场数据不可复现。FileThread 把串口数据追加写入 SerialData.txt(约 60ms 一轮),FileCanThread 负责 CAN 数据;debug 信息由 logworker/logmanager 写入 Logs 目录,按次会话生成一个日志文件,仓库样例日志就有数 MB 到 1GB 的体量。
- 怎么用:勾选实时保存开关后数据自动落盘;CmdDialog 窗口可导入 .dbc 文件(zdbc 库、异步回调解析),支持立即发送、按周期发送和按 DBC 信号发送,默认指令 ID 1784、数据 "03 00 00 00 00 00 ff 03" 已配置在 Settings.ini 的 MsgParam 段。
- 适合谁:要做测试记录、事后回放和故障定位的现场工程师。
摄像录像:同步录制现场视频
- 解决什么问题:数据之外还需要现场影像做佐证。CameraDialog(cameradialog.cpp)调用 QCamera 枚举摄像头、QMediaRecorder 以 video/mp4 录制到程序当前目录,与雷达数据同步保存。
- 适合谁:需要"画面 + 数据"对照分析的测试与验收人员。
🚀 四、快速上手
-
克隆仓库:
-
解压主资源包(源码与可执行文件都在里面):
7z x DataShow.7z
-
二选一运行:
- 直接跑:双击解压后的 DataShow/release/DataShow.exe(Win32 编译,同目录带 PCANBasic.dll、zlgcan.dll 等依赖)。
- 重新编译:用 Qt Creator 5.15(mingw 8.1)打开 DataShow/DataShow.pro,编译运行。
-
在设置窗口选择串口或 CAN 并填好参数,点 Start;需要下发指令时打开 Cmd 窗口配置周期发送。
关键模块(解压后路径):主窗口 DataShow/mainwindow.cpp、串口 DataShow/serialwork.cpp、CAN 三栈 DataShow/zlg_can.cpp、DataShow/control_can.cpp、DataShow/mypeakcan.cpp、DBC 与指令 DataShow/cmddialog.cpp、设置 DataShow/settingsdialog.cpp。
👥 五、适用人群与场景
- 做 ADAS/自动驾驶感知的研发:用 CAN 接 Gatan 雷达,实时看目标表与 3D 点云,验证算法输入。
- 现场测试工程师:周期发送指令 + 实时数据落盘 + Logs 会话记录,测试结束即可回放比对。
- Qt 初学者:项目里 serialport 收发、QThread 多线程分工(serialthread/canthread/filethread/logworker)、DBC 异步解析、DataVisualization 绑定的写法可以直接对照阅读。
- 工业与安防场景的部署人员:用 Logs 记录与摄像录像对照排查雷达离线或数据异常问题。
结尾
三个实操建议:录像和日志都往本地磁盘写(仓库 Logs 样例最大单文件超 1GB),开录前先确认磁盘空间;CAN 设备与所选 Protocol 协议栈要匹配,驱动在 kerneldlls 目录按协议栈区分;多线程涉及数据竞争,自己扩展模块时注意加锁。项目说明见 README.md,使用与再分发请遵守 LICENSE(MIT)。