Qt QSerialPort串口通信

已于 2024-10-18 10:05:16 修改
阅读量5.9k 收藏 49
点赞数 6
分类专栏： Qt 文章标签： qt serialport
于 2022-10-19 09:30:40 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/jay_xio/article/details/127394729
版权

文章目录

1. 示例

在这里插入图片描述

2. 轮询电脑串口设备

    // 查询所有串口设备
    QList<QSerialPortInfo> serialList = QSerialPortInfo::availablePorts();

    QStringList serialPortNameList;
    foreach(const QSerialPortInfo &info,QSerialPortInfo::availablePorts())
    {
        serialPortNameList << info.portName();
        qDebug()<<"serialPortName: "<<info.portName();
    }
    // 展示在下拉列表中
    ui->comboBox->addItems(serialPortNameList);

注意，要使用QSerialPort需要在pro中添加 QT += serialport

3. 串口类

	m_serialPort = new QSerialPort(this);
    connect(m_serialPort, &QSerialPort::readyRead, this, &MainWindow::handleReadyRead);
    connect(m_serialPort, &QSerialPort::errorOccurred, this, &MainWindow::handleError);

readRead 事件： 异步接收串口的数据
errorOccurred 事件： 异常

void MainWindow::handleReadyRead()
{
    m_recvData = m_serialPort->readAll();
    writeMsg("异步收到：" + QString::fromUtf8(m_recvData));

    emit serialDataReadFinished();  // 自定义的事件，为了配合通知异步等待完成
}

void MainWindow::handleError(QSerialPort::SerialPortError serialPortError)
{
    if (serialPortError == QSerialPort::ReadError)
    {
        QString error = QString("An I/O error occurred while reading "
                                        "the data from port %1, error: %2")
                            .arg(m_serialPort->portName())
                            .arg(m_serialPort->errorString());
        writeMsg(error);
    }
}

4. 发送串口数据

4.1 发送串口数据后，不等待， 由handleReadyRead异步接收来自串口的数据

void MainWindow::on_sendMsgButton_clicked()
{
    QString sendData = ui->textEdit->toPlainText();
    writeMsg("发送：" + sendData);

    m_serialPort->write(sendData.toUtf8(), sendData.toUtf8().size());
}

4.2 发送串口数据后，要同步等待串口返回数据

void MainWindow::on_sendMsgButton_clicked()
{
    QString sendData = ui->textEdit->toPlainText();
    writeMsg("发送：" + sendData);

    m_serialPort->write(sendData.toUtf8(), sendData.toUtf8().size());

	if(!m_serialPort->waitForReadyRead(5000))
	{
		writeMsg("等待回复超时");
		return;
	}
	
	QByteArray recvData = m_serialPort->readAll();
	writeMsg("同步收到：" + QString::fromUtf8(recvData));
}

但是，如果我们监听了QSerialPort的readRead 事件，这里waitForReadyRead是等不到串口返回的数据的，一直是超时。



有时我们给串口发送消息后需要及时收到串口返回数据，又要在没有发送消息时，采用异步监听的方式实时接收串口上报的数据。
所以：
a. 需要同步等待读取串口数据；
b. 需要监听readRead 事件，实时接收数据



解决方法 一【最初的解决思路，后来发现有问题】：

我们可以自己写一个异步等待的方法，使异步转同步

bool MainWindow::customerWaitForReadyRead(int msec)
{
    QEventLoop eventloop;
    QObject::connect(this, &MainWindow::serialDataReadFinished, &eventloop, &QEventLoop::quit);

    bool isTimeout = false;
    QTimer::singleShot(msec, &eventloop, [&](){
        eventloop.quit();
        isTimeout = true;
    });

    eventloop.exec(QEventLoop::AllEvents);
    return !isTimeout;
}
  • serialDataReadFinished事件是我们自定义的事件，在handleReadyRead槽函数中收到串口数据后，发出此事件通知异步等待结束；
  • QTimer::singleShot计时，超时后，异步等待也结束；
  • 返回值，如果是收到serialDataReadFinished事件结束的异步等待，则是正常结束，返回true；如果是超时结束，则是异常结束，返回false.

于是，发送串口数据后，需要等待结果的，可以写成这样：

void MainWindow::on_sendMsgButton_2_clicked()
{
    QString sendData = ui->textEdit->toPlainText();
    writeMsg("发送：" + sendData);

    m_serialPort->write(sendData.toUtf8(), sendData.toUtf8().size());
    if(!customerWaitForReadyRead(5000))	// 自定义的异步等待函数
    {
        writeMsg("等待回复超时");
    }
    else
    {
        writeMsg("同步收到: " + m_recvData);
    }
}

此方法有弊端，eventloop在等待所有的事件，也就是说，在等待serialDataReadFinished事件的同时，也会等待按钮点击事件，如果在另一个线程再次触发了Button_2的点击事件，这里就会重复进入，导致只会等到第二次Button_2的点击事件的回复，第一次点击的回复永远等不到了。
所以推荐使用解决方法二，因为串口类自带的waitForReadyRead是阻塞等待的， 即使多次触发Button_2的点击事件，也是排队执行的，不会出现方法一的问题



解决方法 二【推荐使用】：

在write之前 disconnect 断开 readRead 事件的连接， 使用串口类自带的 waitForReadyRead 等待串口数据，然后读取串口数据。读完后再次使用 connect 连接 readRead 事件。

因为串口类自带的waitForReadyRead是阻塞等待的， 即使多次触发Button_2的点击事件，也是排队执行的，不会出现方法一的问题

void MainWindow::on_sendMsgButton_2_clicked()
{
    QString sendData = ui->textEdit->toPlainText();
    writeMsg("发送：" + sendData);
	
	// 断开readyRead事件
	disconnect(m_serialPort, &QSerialPort::readyRead, this, &MainWindow::handleReadyRead);
	
    m_serialPort->write(sendData.toUtf8(), sendData.toUtf8().size());
    if(!m_serialPort->waitForReadyRead(5000))	// 串口类自带的等待函数
    {
        writeMsg("等待回复超时");
    }
    else
    {
    	m_recvData = m_serialPort->readAll();
        writeMsg("同步收到: " + m_recvData);
    }
    
    // 重新连接readyRead事件
	connect(m_serialPort, &QSerialPort::readyRead, this, &MainWindow::handleReadyRead);
}


5. 完整代码

#include "mainwindow.h"
#include "ui_mainwindow.h"

#include <QDateTime>
#include <QDebug>
#include <QSerialPortInfo>
#include <QThread>
#include <QTimer>


// 关于中文乱码的问题， 不必像下面这样设置，因为这样必须在所有cpp文件中都要添加这几行代码。
// 完美解决的方法是在pro中添加：msvc:QMAKE_CXXFLAGS += /utf-8
// #if defined(_MSC_VER) && (_MSC_VER >= 1600)
// #pragma execution_character_set("utf-8")
// #endif


MainWindow::MainWindow(QWidget *parent) : QMainWindow(parent),
                                          ui(new Ui::MainWindow)
{
    ui->setupUi(this);

    // 查询所有串口设备
    QList<QSerialPortInfo> serialList = QSerialPortInfo::availablePorts();

    QStringList serialPortNameList;
    foreach (const QSerialPortInfo &info, QSerialPortInfo::availablePorts()) {
        serialPortNameList << info.portName();
        qDebug() << "serialPortName: " << info.portName();
    }
    // 展示在下拉列表中
    ui->comboBox->addItems(serialPortNameList);
    ui->lineEdit->setText("115200");

    m_serialPort = new QSerialPort(this);
    connect(m_serialPort, &QSerialPort::readyRead, this, &MainWindow::handleReadyRead);
    connect(m_serialPort, &QSerialPort::errorOccurred, this, &MainWindow::handleError);
}

MainWindow::~MainWindow()
{
    delete ui;
}

void MainWindow::writeMsg(QString str)
{
    QString strLog = QString("%1 [%2]  %3").arg(QDateTime::currentDateTime().toString("hh:mm:ss zzz")).arg(quintptr(QThread::currentThreadId())).arg(str);

    QTextCursor tc = ui->textBrowser->textCursor();
    tc.movePosition(QTextCursor::End);
    tc.insertText(strLog + "\n");
    ui->textBrowser->moveCursor(QTextCursor::End);
}

void MainWindow::on_connectButton_clicked()
{
    if (ui->connectButton->text() == "连接") {
        QString portName = ui->comboBox->currentText();
        int baudRate = ui->lineEdit->text().toInt();

        m_serialPort->setPortName(portName);
        if (!m_serialPort->open(QIODevice::ReadWrite)) {
            writeMsg(QString("串口[%1]打开失败，%2").arg(portName).arg(m_serialPort->errorString()));
            return;
        }

        m_serialPort->setBaudRate(baudRate, QSerialPort::AllDirections);
        m_serialPort->setDataBits(QSerialPort::Data8);            // 数据位为8位
        m_serialPort->setFlowControl(QSerialPort::NoFlowControl); // 无流控制
        m_serialPort->setParity(QSerialPort::NoParity);           // 无校验位
        m_serialPort->setStopBits(QSerialPort::OneStop);          // 一位停止位

        writeMsg("打开串口成功");
        ui->connectButton->setText("断开连接");
    } else {
        m_serialPort->close();
        writeMsg("断开串口成功");
        ui->connectButton->setText("连接");
    }
}

void MainWindow::handleReadyRead()
{
    m_recvData = m_serialPort->readAll();
    writeMsg("异步收到：" + QString::fromUtf8(m_recvData));
}

void MainWindow::handleError(QSerialPort::SerialPortError serialPortError)
{
    if (serialPortError == QSerialPort::ReadError) {
        QString error = QString("An I/O error occurred while reading "
                                "the data from port %1, error: %2")
                            .arg(m_serialPort->portName())
                            .arg(m_serialPort->errorString());
        writeMsg(error);
    }
}


// 异步。 发送后不等待回复
void MainWindow::on_sendMsgButton_clicked()
{
    QString sendData = ui->textEdit->toPlainText();
    writeMsg("发送：" + sendData);

    m_serialPort->write(sendData.toUtf8(), sendData.toUtf8().size());
}

// 同步。发送后等待回复
void MainWindow::on_sendMsgButton_2_clicked()
{
    QString sendData = ui->textEdit->toPlainText();
    writeMsg("发送：" + sendData);

    // 断开readyRead事件
    disconnect(m_serialPort, &QSerialPort::readyRead, this, &MainWindow::handleReadyRead);

    m_serialPort->write(sendData.toUtf8(), sendData.toUtf8().size());
    if (!m_serialPort->waitForReadyRead(5000)) {
        writeMsg("等待回复超时");
    } else {
        writeMsg("同步收到: " + m_recvData);
    }

    // 重新连接readyRead事件
    connect(m_serialPort, &QSerialPort::readyRead, this, &MainWindow::handleReadyRead);
}


以上完整代码下载地址：QSerialPortTest



6. 测试

下载一个虚拟串口工具 Virtual Serial Port，创建一个虚拟串口对，例如我创建的串口对是 COM4 和 COM5：
在这里插入图片描述
创建串口对后， 在系统设备管理器中，能看到：

在这里插入图片描述
编译测试程序后， 打开两个进程，一个选COM4，一个选COM5：
在这里插入图片描述

J_Xio
关注
专栏目录
Qt串口通信开发之QSerialPort模块Qt串口通信接收数据不完整的解决方法
08-19
主要介绍了Qt串口通信开发之QSerialPort模块Qt串口通信接收数据不完整的解决方法,需要的朋友可以参考下
Qt串口通信
03-17
解决接收数据不完整
QT开发--串口通信
最新发布
荒野
10-13 1174
qt5
Qt串口通讯
02-27
用Qt做的一个串口调试助手，实现了基本功能，支持10进制 16进制
Qt5的QSerialPort类使用信号槽实现串口读写
07-05
Qt5 信号槽实现串口读写，大家可以参照，谢谢评论
Qt QSerialPort 通信 源码
10-19
使用Qt Creator4.7.2 编写 Qt版本5.11.3 源码参考学习 编译运行 就能用
qt 串口通信
weixin_43246170的博客
11-22 1万+
#ifndef WIDGET_H #define WIDGET_H #include <QWidget> #include <QtWidgets> #include <QSerialPort> #include <QSerialPortInfo> namespace Ui { class Widget; } class Widget : public QWidget { Q_OBJECT public: explicit Widget.
Qt扫盲-QSerialPort理论总结
洪源兄
01-05 6959
QSerialPort 类其实就是一个打开串口，进行串口通信传输数据的功能类。我们可以使用QSerialPortInfo帮助类获取有关可用串行端口的信息，这个类能直接列举出系统中的所有串行端口。QSerialPortInfo类主要是我们在使用QSerialPort要通信的时候为指定我们具体操作哪一个串口，我们可以将QSerialPortInfo类的对象作为参数传递给setPort()或setPortName()方法，以分配所需的串行设备。Qt中的这个串口指的是 RS232串口，也是全双工的。
【Qt 学习之路】QSerialPort处理串口通信
沙师弟专栏
05-05 9654
QSerialPort提供了访问串口的接口函数。使用辅助类QSerialPortInfo可以获取可用的串口信息。将QSerialPortInfo辅助类对象做为参数，使用setPort()或setPortName()函数可以设置要访问的串口设备。设置好端口后，可以使用open()函数以只读、只写或读写的模式打开使用。注意，串口使用独占方式打开。使用close()函数关闭串口并且取消IO操作。串口成功打开后，QSerialPort会尝试确定串口的当前配置并初始化。
Qt5.8中串口类QSerialPort
m0_73443478的博客
02-04 3725
Qt5.8中串口类QSerialPort
关于QSerialPort的使用说明（Qt实现串口工具）
嵌入式
07-31 1万+
Qt提供了对串口设备的简单操作功能接口，包括串口配置、收/发数据。将串口设备插入到电脑USB接口后，可在电脑的设备管理里查看端口，会多了个COM之类的端口。一般的USB串行设备驱动在window里都已经安装好了，不需要再单独安装驱动，若是设备管理器查看到端口出现了叹号，可以从网上查找对应的驱动，并下载安装。 1.在使用QSerialPort类的文件里，需要包含以下头文件 #include <QtSerialPort/QtSerialPort> #include <QtSerialPo
QT VS2019 QSerialPort串口类简单界面例子
05-15
总结，"QT VS2019 QSerialPort串口类简单界面例子"是一个很好的学习资源，它演示了如何在VS2019环境下利用QT的QSerialPort类进行串口通信，包括界面设计、串口参数配置和基本的串口操作。对于初学者来说，这是一个很...
Windows环境下QT串口485通讯QSerialPort的问题
02-02
Windows环境下QT串口485通讯QSerialPort的问题，如何实现windows环境下QT的串口通信，以及实际运行中注意的问题和源代码实现，write函数在线程中发送遇到的问题，如何解决！都进行了详细的说明，以及问题的原因！
QT QSerialPort 封装，阻塞方式发送数据后等待读取缓冲区数据结果，使用QT信号量阻塞，线程中初始化串口和读取数据。
05-23
在QT框架中，QSerialPort模块提供了一个强大的接口来与串行端口进行通信，它支持多种操作系统，包括Windows、Linux、macOS等。本文将深入探讨如何利用QSerialPort进行串口通信，并且着重讲解如何在阻塞模式下发送...
回顾Qt调用串口设备
神迹降临的博客
02-22 2860
    最近一直在学习如何使用 Qt5.10 编写一些小程序，学的很多很杂，难免有些容易遗忘的东西。今天就打算用写博客的形式做一下小小的回顾，把之前写过的一些东西整理分享一下，非常欢迎各路大佬们前来交流指正。    那么废话不多说了，今天要回顾的内容是关于Qt这个软件中调用系统串口设备进行通信的方法。一、串口基本操作1.环境配置    Qt5中有一个QSerialPort类，使用它我们就可以方便的...
QT 串口通信中确保数据接收完成的方法
千千道的博客
10-09 1075
在 Qt 串口通信中，确保数据接收完成是一个重要的问题。通过采用合适的方法，我们可以根据具体的应用场景来准确地判断数据是否已经全部接收。无论是基于数据长度、结束标志、定时器超时还是自定义协议头，都可以有效地解决数据接收完成的判断问题。在实际开发中，我们可以根据通信协议的特点和需求选择合适的方法，以提高串口通信的可靠性和稳定性。本文将介绍几种在 Qt 串口通信中确保接收完成的方法，以帮助开发者更好地处理串口数据。信号会被发射，从而触发槽函数执行，在槽函数中我们可以读取串口数据。信号到自定义的槽函数来实现的。
【Qt】详解QSerialPort串口通信实现发送和接收数据的功能
Fanjufei的博客
09-21 2879
之前，你需要在项目文件（.pro）中添加串口模块的依赖项。通过使用这些函数和方法，你可以方便地进行串口通信操作。请根据你的具体需求来使用和配置。是Qt框架中用于串口通信的类。它提供了对串口进行配置、发送和接收数据的功能。还提供了其他一些辅助函数和信号槽机制来处理串口通信中的事件和状态变化。然后，在代码中包含头文件。除了上述的基本功能外，类来实现串口通信功能。
QT实现串口通信
热门推荐
m0_49456900的博客
03-11 5万+
要实现串口通信，需要知道串口通信需要的信息 主要参数有：波特率、校验位、数据位、停止位、控制流 主要操作有：串口的打开和关闭、刷新设备串口、接发数据、开关显示灯等。 实现效果如图： 最后附赠完整源码。 第一步：在头文件中引入 QtSerialPort 类的两个头文件（必须引入） // 引入串口通信的两个头文件(第一步) #include <QtSerialPort/QSerialPort> // 提供访问串口的功能 #include <QtSerialPo
QT串口通信
QtCompany的博客
02-22 6457
如果用qt写程序作为上位机，然后通过和usb和下位机通信的时候，就需要用到qt中的串口通信了。
qt serialport类 cdc
07-02
### 回答1： Qt是一款跨平台的开发框架，其中的SerialPort类可以用来与串行设备进行通信。CDC（Communication Device Class）是一种通信设备类别，是一种通用的串行设备协议。 Qt的SerialPort类提供了一套方便易用的接口，可以用来访问串行端口进行读写操作。它提供了许多函数和信号槽，可以实现的功能包括打开和关闭端口、设置波特率、数据位、校验位等通信参数、读取和写入数据等。通过这些函数，我们可以轻松地进行串行通信。 对于CDC设备，我们可以使用Qt的SerialPort类实现与之通信。CDC设备一般都支持标准的串行通信协议，因此可以使用Qt的SerialPort类提供的功能进行数据的读写。我们只需要打开串行端口，设置好通信参数，然后通过SerialPort类的写入函数发送数据，通过读取函数读取设备返回的数据即可。 为了使用SerialPort类来与CDC设备进行通信，我们需要先包含相应的头文件，并链接SerialPort库。然后我们可以在代码中实例化一个SerialPort对象，并设置好通信参数。通过调用对象的打开函数，我们就可以将该串口打开。接下来我们就可以调用SerialPort对象的写入函数发送数据，或者通过读取函数读取设备返回的数据。 总之，Qt的SerialPort类提供了一套方便易用的接口，可以用来与串行设备进行通信。而CDC是一种通信设备类别，通过使用Qt的SerialPort类，我们可以很方便地实现与CDC设备的通信。 ### 回答2： SerialPort 类是 Qt 提供的用于处理串口通信的类，CDC (Communication Device Class) 是一种标准的 USB 设备类别之一，用于处理通信设备的驱动程序和通信协议。 Qt 的 SerialPort 类支持与 CDC 设备进行通信。它通过提供一组方法和信号来实现与串口的交互。Qt 的 SerialPort 类可以完成打开、关闭、读取、写入等串口操作。通过使用该类，我们可以通过串口与 CDC 设备进行数据的发送和接收。 在使用 SerialPort 类与 CDC 设备通信时，我们首先需要创建一个 SerialPort 实例，并指定串口的属性，如波特率、数据位、校验位和停止位。然后，我们可以打开串口并通过 write() 方法向 CDC 设备发送数据，或通过 readAll() 方法从 CDC 设备读取数据。 除了基本的串口操作外，SerialPort 类还提供了一些与 CDC 设备通信相关的特殊功能，如设置流控制协议、设置数据流控制模式等。这些功能可以根据具体的应用需求进行使用。 总之，Qt 的 SerialPort 类提供了一种方便和灵活的方式来与 CDC 设备进行通信。通过使用该类，我们可以很容易地实现串口与 CDC 设备之间的数据交换，满足各种通信需求。 ### 回答3： Qt SerialPort 类提供了一种简便的方式来与串口进行通信，并且支持 CDC（Communications Device Class）。 CDC 是一种用于串行通信设备的通用设备类。它定义了一组通信设备的标准模型和规范，旨在在各种操作系统上实现串口设备的兼容性。 在 Qt 中，我们可以使用 SerialPort 类来实现与 CDC 兼容的串口设备的通信。这个类提供了一组方法来设置和控制串口的属性，如波特率、数据位、停止位和校验位等。我们可以使用这些方法来配置和初始化串口设备。 我们可以使用 SerialPort 的 `open` 方法打开一个串口设备，并且可以通过 `read` 和 `write` 方法来读取和写入数据。read 方法用于从串口设备中读取数据，write 方法用于向串口设备中写入数据。 使用 Qt SerialPort 类与 CDC 兼容的串口设备进行通信的示例代码如下： ``` c++ #include <QtSerialPort/QSerialPort> #include <QtSerialPort/QSerialPortInfo> int main() { QSerialPort serial; serial.setPortName("COM1"); serial.setBaudRate(QSerialPort::Baud115200); serial.setDataBits(QSerialPort::Data8); serial.setStopBits(QSerialPort::OneStop); serial.setParity(QSerialPort::NoParity); if (serial.open(QIODevice::ReadWrite)) { // 读取数据 QByteArray data = serial.readAll(); // 处理数据 // 写入数据 QString message = "Hello, World!"; serial.write(message.toUtf8()); } serial.close(); return 0; } ``` 上述示例代码中，我们创建了一个 SerialPort 对象，并设置了串口设备的属性。然后，我们打开了串口设备，并使用 read 方法读取设备上的数据，并使用 write 方法向设备写入数据。最后，我们关闭了串口设备。 通过 Qt SerialPort 类以及与 CDC 兼容的串口设备，我们可以实现方便且灵活的串口通信功能。
评论 1
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值