QT5 串口调试助手

参考：
https://blog.csdn.net/qq_41068712/article/details/89320918
https://blog.csdn.net/rsd102/article/details/112760183

一、预览

二、实现目标

自己编写一个基于Qt的串口调试软件，可以实现本软件与串口助手之间的通讯。

软件发送的数据，经虚拟串口转发，能够在串口助手中正确接收；

串口助手发送的数据可以在本软件的接收文本框中显示，进而实现串口数据双向通信。

1.所需工具及环境

虚拟串口软件（用于创建一对虚拟串口）
Qt Creator 4.10.1
Qt 5.3
XCOM V2.0 串口助手
本人电脑 Windows 7 64bit

三、具体实现

1.导入串口通信模块

在.pro文件中添加


QT       += core gui
QT      += serialportgreaterThan(QT_MAJOR_VERSION, 4): QT += widgetsCONFIG += c++11TARGET = Qt_CommDemo
TEMPLATE = appSOURCES += main.cpp\mainwindow.cppHEADERS  += mainwindow.hFORMS    += mainwindow.uiRESOURCES += \qss.qrcRC_ICONS = Images/tb.ico

2.显示系统中所有串口号

遍历系统中所有串口名的实现代码如下

/*** @brief MainWindow::遍历系统中所有串口名* @return 返回系统中所有串口名*/
QStringList MainWindow::getPortNameList()
{QStringList m_serialPortName;foreach(const QSerialPortInfo &info,QSerialPortInfo::availablePorts()){m_serialPortName << info.portName();qDebug()<<"serialPortName:"<<info.portName();}return m_serialPortName;
}

3.打开串口


/*** @brief MainWindow::打开串口*/void MainWindow::on_btnOpenCom_clicked()
{if (ui->btnOpenCom->text()=="打开串口"){//判断串口是否已打开if(m_serialPort->isOpen()){m_serialPort->clear();  //清空缓冲区m_serialPort->close();  //串口关闭}//设置要打开的串口名m_serialPort->setPortName(m_portNameList[ui->comBoxPortName->currentIndex()]);if(!m_serialPort->open(QIODevice::ReadWrite)){qDebug()<<m_portNameList[ui->comBoxPortName->currentIndex()]<<"打开失败!";return;}//打开成功m_serialPort->setBaudRate(ui->comBoxBaudRate->currentText().toInt(),QSerialPort::AllDirections);//设置波特率和读写方向m_serialPort->setDataBits(QSerialPort::Data8);              //数据位为8位m_serialPort->setFlowControl(QSerialPort::NoFlowControl);   //无流控制m_serialPort->setParity(QSerialPort::NoParity);             //无校验位m_serialPort->setStopBits(QSerialPort::OneStop);            //一位停止位//连接槽函数connect(m_serialPort,SIGNAL(readyRead()),this,SLOT(receiveInfo()));ui->btnOpenCom->setText("关闭串口");} else{m_serialPort->close();ui->btnOpenCom->setText("打开串口");}
}

4.串口接收、处理数据

void MainWindow::receiveInfo()
{qDebug()<<"receiveInfo()";QByteArray info = m_serialPort->readAll();QString strReceiveData = "";if(ui->checkBoxHexReceive->isChecked()){QByteArray hexData = info.toHex();strReceiveData = hexData.toUpper();qDebug()<<"接收到串口数据: "<<strReceiveData;for(int i=0; i<strReceiveData.size(); i+=2+1)strReceiveData.insert(i, QLatin1String(" "));strReceiveData.remove(0, 1);qDebug()<<"处理后的串口数据: "<<strReceiveData;ui->txtReceiveData->append(strReceiveData);}else{strReceiveData = info;//避免中文乱码QTextCodec *tc = QTextCodec::codecForName("GBK");QString tmpQStr = tc->toUnicode(info);ui->txtReceiveData->append(tmpQStr);}//ui->txtReceiveData->append("\r\n");
}

四、实践

1.vspd创建虚拟串口

2.结果展示

五、打包发布

我们双击编译生成的exe，程序会弹出若干对话框，提示缺少 XXX.dll ，这是因为缺少程序运行依赖的必要的DLL文件。

缺少的文件比较多，而且还涉及到DLL的版本，如果选错了一个，那么程序也是不能正常运行的，那么有什么办法可以快速的找到缺少的依赖文件呢？

Qt 官方开发环境里自带了一个工具：windeployqt.exe 。

1.

先运行一遍，release，让其生成release版本，看能不能单独运行，若还是不行，则如下操作

2.

1. 先在1中，将上一步生成的exe，拷贝到一个单独的文件
2. 在开始软件菜单里找到Qt文件夹，运行文件夹的cmd程序Qt 5.3.0 for Desktop (MinGW 4.8 32 bit)
3. 转换目录至拷贝出来的文件夹，cd命令转换文件目录，进入此文件夹
4. 然后输入windeployqt name.exe，name是拷贝的可执行文件的名称，回车即可
5. 进行到这一步，项目所需要的Qt库文件都拷贝结束，接着把项目用到的外部文件拷贝至发布文件夹，如软件运行需要的数据库文件、图标文件和其他文件。如果项目很小而且只用Qt没用其他的外部库，到这一步就已经结束了，这时可以双击发布文件夹内的.exe文件测试运行

3.添加外部库文件（dll）

规模比较大的项目常常使用很多的外部库来支持运行，项目打包需要拷贝这些外部库的dll文件，然而有时候项目到底用了外部库的哪个模块开发人员可能也不清楚，再加上找这些库文件也不容易，这时候需要用外部软件dependencies查询.exe需要的外部库文件

dependencies下载路径：mirrors / lucasg / dependencies · CODE CHINA (csdn.net)
地址

下载方式：下载适合自己电脑的发行版本，由于我们发布的是release版本，所以下载该软件的release版本

无需安装，解压即可，运行文件夹里的DependenciesGUI.exe，在该软件内打开发布文件夹内的EXE文件，

打开后左侧边栏会显示EXE文件所需要的DLL文件，发布文件夹内没有的会标红，标红的文件需要自己去电脑上寻找，以图中的sqlite3.dll文件为例，该DLL文件是在我装MySQL的软件内，如果知道DLL是哪个外部库，就直接去该外部库路径下寻找吧

注意：处理完标红的问题文件，程序肯定能脱离Qt而在你的电脑上独立的运行，但是如果要把这个程序给其他人使用，还有一些工作要做，在上图中显示的程序使用到的DLL文件有的在发布文件夹能找到，有的则是在在系统C盘里，还有一些是在我安装Qt的文件夹里，系统C盘的DLL可能别人电脑里也有，但是为了防止别人没有，最好是也把这些DLL找到，复制到发布文件夹内。而在安装Qt的文件夹里找到的DLL，别人的电脑上是肯定没有的，必须要复制到发布文件夹内

4.程序无法正常启动解决办法

如果发布文件夹内缺少所需的外部文件和库文件（dll），.exe文件就无法运行，会报错：（0xc000007b）

原因主要如下：

外部资源文件未拷贝到位，缺乏必要的文件，如数据库文件、图片文件等
Qt打包软件运行错误，漏拷贝了部分Qt的dll文件，解决方法：重新使用Qt打包程序（步骤2）或者使用dependecies查找未拷贝的dll
外部库文件（dll）不足，解决办法：按步骤三操作