首页 / 资讯中心 / 文章详情

用Qt打造四合一串口/TCP/UDP/CAN调试上位机,小白也能轻松上手

用Qt打造四合一串口/TCP/UDP/CAN调试上位机,小白也能轻松上手 ★ FEATURED ARTICLE
简介这款QT5.12集合串口调试助手面向Linux平台上的上位机与嵌入式开发者将串口、TCP、UDP、CAN分析仪四种常见通信调试功能集成在一个工程中可用于设备调试、协议验证和网络通信测试。压缩包共36个文件包含11个C源文件和11个头文件7个Qt Designer的ui界面文件以及pro工程配置和qrc资源文件整体仅57KB结构清晰便于直接编译和二次定制。代码覆盖了串口波特率/数据位参数设置、TCP客户端与服务端通信、UDP数据收发、CAN帧监控等典型实现适合有一定C/Qt基础、希望快速构建调试工具的开发者学习参考。目前已有1380人学习下载项目体量小但功能模块完整可从中理解多协议上位机的基本架构与界面事件处理方式。 搞嵌入式调试的人谁桌上不是一堆线、几个不同厂家的上位机软件我反正被这个事折磨了很久。调试串口要开一个助手测网络协议又要切到另一个工具偶尔还要接CAN分析仪看总线报文三个软件来回切界面风格还不统一遇到问题想同时核对串口日志和CAN报文简直像在做多线程人肉切换。后来趁着项目间隙花了两个晚上用Qt 5.12自己写了一个“四合一”的简易上位机把串口、TCP、UDP、CAN四种调试手段全塞进同一个窗口里一边是串口打印另一边是CAN收发同一个时间轴下比对数据效率一下就上来了。这篇文章就把这个项目的完整思路、核心代码和踩坑记录整理出来。不敢说多专业但胜在够实用、够直接代码结构也简单适合谁看嵌入式软硬件工程师、学生党、还有那些和我一样经常和设备打交道的调试党都值得参考一下。1. 项目概述与整体思路为什么做一个“四合一”调试工具1.1 痛点来源工位上最不缺的就是调试线我自己的实际场景是这样的调试一块主控板时MCU通过串口打印运行日志同时以太网口跑着UDP协议跟PC端联调CAN口又接着BMS电池包实时上传电压、温度数据。以前需要串口助手看日志、网络调试助手发UDP报文、CAN分析仪抓总线帧三个软件各管各的界面风格完全不同时间戳各自独立要把同一时刻三路数据对应起来眼睛都看花。你可能也有类似感觉通用工具虽然免费好用但多协议联动分析时只能人工去对时间点。所以我就想能不能做一个自己的工具把串口、TCP、UDP、CAN四种通讯方式集成到一个界面里统一时间戳、统一日志格式收发数据还能自动保存。哪怕功能简易一点只要解决“多协议同时看”这个痛点就比一堆单功能软件加起来有用。1.2 功能范围与设计原则不做大而全只做顺手用这个项目的名字就叫“集合串口调试助手”定位很清楚简易、够用、可扩展。功能上我做了四个页签模块核心功能使用场景串口打开/关闭串口配置波特率、数据位、校验位、停止位支持十六进制收发调试MCU日志、RS485传感器、GPS模块等UDP绑定本地端口填写远端地址和端口发送/接收支持广播网络协议联调、局域网设备通信测试TCP同时支持客户端模式和服务端模式多客户端管理调试TCP服务器/客户端验证协议交互CAN加载厂商动态库打开USBCAN设备标准帧/扩展帧收发周期发送汽车电子调试、BMS通信、CAN总线报文分析设计上我坚持几个原则界面模块化四个功能页完全独立代码互不干扰参数能保存用QSettings记录串口、IP、CAN通道等配置下次打开不用重填日志可保存收发数据统一写入文件便于事后分析收发计数实时显示哪路数据在跑一眼就能看出来。功能虽然“简易”但覆盖了日常70%以上的调试场景。真遇到更复杂的帧分析、曲线绘制再把数据导出到专业工具去处理分工明确。技术选型上用Qt 5.12.12 LTS QWidget qmake编译器是MSVC2017 64bit。有人可能问为什么不用QML调试上位机是典型的桌面密集型工具QWidget更成熟控件多文档全写出来的界面虽然不炫但胜在稳定、开发快对于我这种“功能优先”的用法是最合适的。2. 开发环境准备与核心模块划分2.1 Qt 5.12环境配置装对组件能省下半天时间我用的是Qt 5.12.12安装时提个醒组件别一股脑全选装MSVC2017 64bit或者MinGW 64bit其中一个就行两个都装只是白白占磁盘空间。如果你主要做Windows开发建议选MSVC版本配合Visual Studio调试起来更方便不过如果只依赖Qt CreatorMinGW其实更省心编译链自带齐全不用额外配。创建项目的时候记得在.pro文件里加上这几行QT core gui widgets serialport serialbus network CONFIG c11serialport是串口模块serialbus是CAN相关后面会细说network是TCP/UDP的基础。少了任何一项编译器直接报模块找不到。另外建议在pro文件里加一行程序版本号VERSION 1.0.0这样exe右键属性里能看到版本信息发布的时候方便确认装的是哪一版。2.2 界面架构用QTabWidget一次放四个页面主窗体非常简单就是一个QTabWidget四个页签各对应一个独立的QWidget子类MainWindow::MainWindow(QWidget *parent) : QMainWindow(parent) { QTabWidget *tabWidget new QTabWidget(this); setCentralWidget(tabWidget); tabWidget-addTab(new SerialPage(this), 串口); tabWidget-addTab(new UdpPage(this), UDP); tabWidget-addTab(new TcpPage(this), TCP); tabWidget-addTab(new CanPage(this), CAN); }每个页面内部继续拆成三块区域。左侧是参数配置区用QGroupBox包起来专门放端口、波特率、IP地址这些设置右侧上方是数据接收区用一个只读的QTextEdit显示收到的所有数据右侧下方是发送区QLineEdit输入内容QPushButton发送。左右分栏用QSplitter用户能拖动调整宽度。参数区固定240px宽就够用接收区尽量大一点数据看起来才舒服。试过直接用QHBoxLayout写死宽度窗口一拉伸就变形还是QSplitter最省心。2.3 模块文件划分每个协议一个类互不干扰项目结构上我尽量按协议拆开方便后续单独维护project/ ├── main.cpp ├── MainWindow.h / MainWindow.cpp ├── page/ │ ├── serialpage.h / serialpage.cpp │ ├── udppage.h / udppage.cpp │ ├── tcppage.h / tcppage.cpp │ └── canpage.h / canpage.cpp └── common/ ├── datalogger.h / datalogger.cpp └── protocolhelper.h / protocolhelper.cppcommon/Datalogger是公共数据记录类所有页面在收到数据时把带时间戳的原始字节流交给它统一写日志文件。这样即使四个页面同时工作日志也是按时间顺序落盘的分析时方便很多。protocolhelper则放一些工具函数比如把QByteArray转成十六进制显示字符串、计算校验和等避免每个页面重复写一遍。3. 串口模块实现细节3.1 QSerialPort配置与打开流程参数先设对再open串口模块在Qt里直接用QSerialPort使用非常简单但有几个顺序上的讲究刚开始写容易踩坑。serial new QSerialPort(this); // 关键点必须在open之前把参数全部设置好。 // 如果你先open再改波特率、校验位某些驱动会把修改应用到已打开的端口 // 而另一些驱动会静默忽略表现就非常诡异。 serial-setPortName(ui-cmbPortName-currentText()); serial-setBaudRate(ui-cmbBaudRate-currentText().toInt()); serial-setDataBits(QSerialPort::Data8); serial-setParity(QSerialPort::NoParity); serial-setStopBits(QSerialPort::OneStop); serial-setFlowControl(QSerialPort::NoFlowControl); if (serial-open(QIODevice::ReadWrite)) { statusBar()-showMessage(QString(串口 %1 已打开).arg(serial-portName())); } else { QMessageBox::warning(this, 错误, 串口打开失败可能被占用或驱动异常); }参数范围需要严谨一点不能随便填。QSerialPort本身也做了校验比如波特率必须是非零正整数。我还把参数框改成了QComboBox把常用值直接列进去用户省得手输个人也减少了出错概率。数据位、校验位、停止位这三个组合起来实际配置时要和另一端完全一致。比如Modbus RTU标准是8数据位、偶校验、1停止位8E1很多工业传感器默认是8N1。界面设置里建议把“无校验”、“偶校验”、“奇校验”都放出来虽然90%的情况都是8N1但总有特例。3.2 不定长数据帧接收细数那个经典的50ms半包问题串口数据是字节流没有帧边界怎么判断一帧数据收完了这是串口调试助手最核心的难点。发一帧完整报文底层可能被拆成两次、三次中断传到应用层如果每次readyRead就处理会把一条完整帧拆碎如果干等指定长度又不适用于不定长数据。我的方案很经典用QByteArray做累积缓冲区配合一个QTimer做超时判断。每次收到数据就追加到缓冲区同时重置计时器如果超过50ms没有新的数据进来就认为当前缓冲区里是一整帧发送给UI显示。void SerialPage::onReadyRead() { buffer.append(serial-readAll()); timeoutTimer-start(50); // 每次有数据就重置定时器 } void SerialPage::onTimeout() { if (!buffer.isEmpty()) { // 这里拿到完整的一帧做十六进制处理、显示、记录 QString display formatData(buffer); appendToReceiveArea(display); buffer.clear(); } }50ms这个值是经验值。波特率9600时一个字节大约1ms一帧20字节的数据要20ms50ms足够等完。如果波特率很低比如2400或者对端发帧间隔很长可以把超时时间适当加大到100ms。设置里留一个“帧超时时间”输入框是更好的做法用起来更灵活。3.3 十六进制与ASCII处理的几个坑串口调试最常用的两种数据格式是ASCII文本和十六进制看起来简单但处理不仔细会出各种奇怪问题。首先是十六进制显示每个字节显示时前导零不能丢比如0x0A必须显示成“0A”而不是“A”。我自己写过一个格式化函数QString toHexString(const QByteArray data) { QString hex ; for (char c : data) { hex QString(%1 ).arg((quint8)c 0xFF, 2, 16, QLatin1Char(0)).toUpper(); } return hex.trimmed(); }其次是十六进制发送时用户在输入框写的可能是“01 03 00 00 00 02 C4 0B”也可能没有空格直接“010300000002C40B”。解析时要先移除字符串中的所有空格再每两个字符切一个字节遇到非法字符直接跳过或提示。这里最忌讳的就是直接把QString按字符转成int那样会把ASCII值当作十六进制值发出去一帧数据就全错了。再一个是中文乱码。有的MCU用GBK编码打印中文日志而QTextEdit默认按UTF-8解析看起来就是一片“鍣櫒”。要么自己在接收区支持GBK/UTF-8切换要么干脆让用户选。我加了下拉框选了“GBK”用QTextCodec::codecForName(GBK)转码日志马上正常了。接收区的显示性能也要注意如果设备每秒产生大量日志直接往QTextEdit里append内存消耗会爆炸。我做了两处优化一是设置setMaximumBlockCount(5000)超过5000行自动丢弃最早的行二是每100ms才刷新一次界面不在每次收到数据时都立刻重绘这样即使长时间跑着也不卡。用计数器累加数据量刷新时一次性显示效果很好。4. 网络调试模块实现细节4.1 UDP调试模块bind和writeDatagram是全部核心UDP比TCP简单很多核心就两个函数bind本地端口writeDatagram发数据报。接收端通过readyRead信号拿socke读取报文。udpSocket new QUdpSocket(this); // 绑定本地端口。注意要允许地址复用否则在多网卡或者快速重启程序时 // 可能会报 Address already in use。 if (!udpSocket-bind(QHostAddress::AnyIPv4, ui-spinLocalPort-value(), QUdpSocket::ShareAddress)) { QMessageBox::warning(this, 错误, UDP端口绑定失败); return; } connect(udpSocket, QUdpSocket::readyRead, this, UdpPage::onReceive);发送报文时要指定远端IP和端口注意目标IP支持单播、广播和组播。如果要对255.255.255.255广播必须先设置Socket选项udpSocket-setSocketOption(QAbstractSocket::BroadcastSocketOption, 1); udpSocket-writeDatagram(data, QHostAddress::Broadcast, remotePort);组播情况则用joinMulticastGroup加组发送时目标地址写组播地址。我界面里专门放了一个“广播”复选框勾上后自动设置对应选项用户不用记这些底层细节。绑定IP地址要小心绑定到0.0.0.0AnyIPv4这样所有网卡都能收到数据。如果你绑定到192.168.1.100另一张网卡上收到的UDP报文就直接被系统丢弃表现就是“明明有人发数据可我收不到”。4.2 TCP调试模块客户端和服务端都要支持TCP模块我做了两个模式用QRadioButton切换客户端模式和服务端模式。客户端模式下核心是connectToHost连接状态变化通过stateChanged信号反馈到界面用户能实时看到Unconnected、HostLookup、Connecting、Connected四个状态的切换。连接失败时errorOccurred信号会触发显示具体错误原因。tcpSocket new QTcpSocket(this); connect(tcpSocket, QTcpSocket::connected, this, TcpPage::onConnected); connect(tcpSocket, QTcpSocket::readyRead, this, TcpPage::onReadyRead); connect(tcpSocket, QTcpSocket::errorOccurred, this, TcpPage::onError);服务端模式下用QTcpServer监听本机端口有客户端接入时触发newConnection信号tcpServer new QTcpServer(this); tcpServer-listen(QHostAddress::AnyIPv4, ui-spinLocalPort-value()); connect(tcpServer, QTcpServer::newConnection, this, TcpPage::onNewConnection); void TcpPage::onNewConnection() { while (tcpServer-hasPendingConnections()) { QTcpSocket *client tcpServer-nextPendingConnection(); // 把所有客户端socket存入QList后续收发时逐个遍历 clientList.append(client); connect(client, QTcpSocket::readyRead, this, TcpPage::onClientReadyRead); connect(client, QTcpSocket::disconnected, this, TcpPage::onClientDisconnected); } }发送数据时如果是客户端模式就直接tcpSocket-write服务端模式遍历clientList逐个write。注意发送大量数据时不能用超大数据包一次写入最好分块并在写入后调用flush确保落到底层socket。4.3 网络调试容易踩的坑粘包、重连和防火墙网络调试模块测试时我踩了几个非常经典的坑。第一个是防火墙程序第一次启动监听端口时Windows会弹出防火墙拦截提示如果不点“允许访问”外部设备根本连不进来界面还看不出任何异常只在连接时卡住到最后超时。所以运行程序前先手动检查防火墙规则。第二个是端口占用。调试同一个设备时程序反复重启有时候上一次的端口没有释放干净再启动时bind失败。这时候从CMD里查一下netstat -ano | findstr 8080找到PID后在任务管理器结束对应进程或者直接把端口换掉。这个错误信息也很有辨识度bind: only one usage of each socket address。确认端口占用问题就能定位。第三个是TCP粘包问题。TCP是流式协议没有消息边界多次write的数据可能在接收端合并成一次readAll。如果你调制的设备用的是带格式的二进制命令比如AA 55开头、校验和结尾接收端必须做粘包拆包处理。我参考Modbus协议的做法用一个环形缓冲区累积数据按帧格式解析解析出一条完整命令就抛出一条性能很高。第四个是断线重连机制。TCP连接断开后对端不会立即通知你。如果设备端突然掉电重启你的socket还处于Connected状态写数据时才会发现发送失败或者接收不到任何回复。调试工具要有重连按钮更高级一点可以定时检查连接状态发现断开自动尝试连接。这类问题在排查时需要理解TCP的三次握手、四次挥手过程能帮你快速定位不少网络连接故障。5. CAN分析仪模块的实现5.1 硬件选型与通信原理Qt怎么和CAN适配器通信CAN模块是整个项目里稍微复杂的部分因为Qt本身没有任何直接操作CAN的接口只能借助硬件厂商提供的动态库或者系统API。我手头用的是USBCAN适配器在Windows下做开发核心思路是加载厂商的DLL调用里面的导出函数收发CAN报文。先简单说下CAN总线协议方便不熟悉的朋友理解。CAN报文由ID11位标准帧或29位扩展帧、DLC数据长度0-8字节、Data数据域最多8字节和帧格式数据帧还是远程帧RTR组成。CAN是总线型的一个节点发数据总线上所有节点都能收到所以每个报文都有明确的ID用于区分优先级和含义。做调试工具时最重要的是能自由指定ID、DLC和数据内容把准备好的报文发到总线上同时要能按ID过滤接收。5.2 用QLibrary动态加载厂商CAN库Qt加载DLL的类叫QLibrary用法很简单关键是导出函数的类型定义要和厂商头文件一致特别是Windows的调用约定厂商DLL一般是cdecl或stdcall搞错了函数就会崩。#include QLibrary #include Windows.h // 以常见的VCI系列USBCAN为例函数定义类似这样 typedef DWORD (__stdcall *VCI_OpenDevice)(DWORD DevType, DWORD DevIndex, DWORD Reserved); QLibrary canLib(ControlCAN.dll); if (!canLib.load()) { QMessageBox::critical(this, 错误, 加载CAN库失败请确认DLL在程序目录下); return; } VCI_OpenDevice openDevice (VCI_OpenDevice)canLib.resolve(VCI_OpenDevice); if (openDevice) { // 打开设备设备类型为USBCAN2索引0保留参数0 DWORD ret openDevice(4, 0, 0); if (ret 1) { // 打开成功继续配置波特率、滤波等 } }上面代码里的设备类型值4是VCI_USBCAN2的枚举值不同厂商的库值可能不一样务必以你手里设备厂商头文件为准。DLL要放在exe同级目录下或者直接放到系统PATH里否则load失败找不到。初始化设备后还要做几个关键配置设置波特率比如500Kbps设置接收过滤模式可以选择接收所有报文或者只接收某个ID范围的报文。这个功能很实用总线上报文很杂的时候按需求过滤以后界面就清爽多了。5.3 CAN报文收发与界面功能ID、DLC和数据要分开显示收发CAN报文的逻辑也不复杂关键是报文的解析和界面的展示要符合调试习惯。接收时我会解析出帧ID、帧格式、DLC和数据显示格式类似[10:23:45.123] RX 标准帧 ID:0x18FF50E5 DLC:8 58 01 02 03 04 05 06 07ID用十六进制显示数据每字节两位十六进制方便肉眼快速对比。发送界面则做成三个输入框ID输入框默认十六进制数据输入框按字节填十六进制比如“01 02 03 04”周期发送输入框填毫秒值。DLC不需要用户输入程序根据数据字节数自动计算。点“发送”就立即发一次勾选“周期发送”后用QTimer按设定的毫秒数循环发送测试总线负载或者周期状态上报时非常方便。发送的核心代码VCI_CAN_OBJ sendFrame; memset(sendFrame, 0, sizeof(sendFrame)); sendFrame.ID idValue; // 从界面输入解析支持标准帧/扩展帧 sendFrame.SendType 0; // 0 表示发送的是数据帧 sendFrame.RemoteFlag 0; // 0 数据帧1 远程帧 sendFrame.ExternFlag isExt; // 0 标准帧1 扩展帧 sendFrame.DataLen byteList.size(); memcpy(sendFrame.Data, byteList, byteList.size()); // 调用库函数发送DevType对应打开的设备类型DevIndex是通道索引 VCI_Transmit(devType, 0, 0, sendFrame, 1);按钮的可用性也要做好状态管理设备没打开时发送、周期发送都必须禁用打开成功后才允许操作。否则用户点发送没反应还以为程序卡死了实际是设备没初始化。5.4 CAN调试的硬件经验终端电阻、波特率和电源CAN调试有几个硬件层面的坑软件写得再好也不能绕过。一是终端电阻问题CAN总线两端各需要120欧姆终端电阻否则信号在总线末端反射通信可能会出现间歇性错误帧。很多USB-CAN适配器内置了可切换的终端电阻比如拨码开关控制。如果总线上已经接了其他节点的终端电阻适配器这边的开关就要关掉不然两个节点都接等效电阻变60欧姆负载过重波形变形通信反而更不稳。二是波特率匹配。CAN总线上所有节点的波特率必须完全一致比如都是500Kbps。如果设备端设的500K你这边设的250K适配器会持续报总线错误甚至干扰其他节点的正常通信。可以通过查看接收错误计数是否持续增长来快速判断。三是电源问题。USBCAN适配器的供电一般来自USB口如果主板USB口供电不稳或者集线器供电不足枚举出来的设备可能间歇性掉线。换一个主板直连USB口或者用带独立供电的HUB问题通常能解决。我一开始总调试不通最后发现就是USB供电不够折腾了大半天血泪教训。6. 常见问题排查与功能扩展建议6.1 调试工具实测中的问题速查表这段时间我把这个工具用在开发板上做自动化测试从UDP改到TCP再切CAN踩了不少坑很多问题用一句话就能点破就解决了整理成表格放下面方便各位按图索骥。现象可能原因解决办法串口打不开端口被占用、驱动异常关闭占用串口的软件重新安装CH340/FT232驱动检查设备管理器串口号串口接收乱码波特率不匹配、字符编码GBK/UTF-8不统一核对波特率确认两端一致界面切换编码串口收不到数据但打开正常接线TX/RX接反交叉对接TX接RX、RX接TXUDP收不到数据防火墙拦截、绑定地址设成了固定IP放行程序或防火墙绑定地址选0.0.0.0UDP能收到但发不出去目标IP和端口配置错误、未开广播选项检查对端IP/端口开启广播写权TCP连接成功但没数据对端没发数据、粘包未拆包抓包对比程序里做完整帧解析TCP频繁断开对端启用了保活检测、心跳超时程序里支持心跳包和重连机制CAN设备打开失败驱动未安装、DLL不在exe目录安装厂商驱动把DLL拷贝到程序目录CAN通信不稳定终端电阻缺失、电源不稳定总线两端加120Ω电阻换USB直连口排查问题时最管用的两根救命稻草是抓包工具Wireshark、Bus Hound和命令行工具netstat、ipconfig它们能区分“是我的软件问题还是对端设备问题”缩小排查范围。6.2 现在这个工具还能往哪个方向扩展做完基础版之后我陆续给工具加了一些顺手的小功能比如定时保存日志到CSV、接收区右键清空、状态栏显示收发合计字节数。后续计划加的还有Modbus RTU/TCP主机功能直接把调试助手扩展成协议测试工具调试PLC和仪表时很实用。数据波形显示集成QCustomPlot把串口或者CAN上报的数据直接画成曲线调试PID参数时就靠它了。我甚至研究过在Qt 5.12里集成OpenCV环境跨界写图像处理上位机不过那属于另一个坑了。脚本自动化用QScriptEngine或者PythonQt实现串口/网络数据的自动应答、定时发送。比如设备上电后自动发一串初始化命令收回应答后判断结果自动生成测试报告。报文回放把之前保存的CAN日志或串口日志重新发送到总线上做回归测试之前实测这个功能非常方便。代码本身我已经开源放出来了结构不算复杂四个页面四个类想加新协议就照着抄一份非常容易。整体来说这套“简易版”四合一调试工具帮我解决了最大的麻烦——多协议联调时数据时间轴不统一的问题。每次跟人聊这个工具我都要说一句话通用调试工具永远只能解决80%的通用场景剩下20%的个性化的、需要联动分析的需求自己动手做个顺手的小工具才是效率最高的解法。最后分享一个我在实际开发中的个人体会写这类调试工具别一上来就追求功能和界面的完美先把一个串口收发跑通再慢慢加UDP、TCP、CAN每加一个模块都是独立的锻炼。真到把“自己做的工具”用在自己的日常调试中那种舒爽感是买任何商业软件都替代不了的。本文还有配套的精品资源点击获取
阅读完成 · 觉得有帮助?
咨询建站