【Qt 学习之路】QSerialPort处理串口通信

沙振宇

已于 2023-12-20 17:14:02 修改

阅读量6.6k

点赞数 4

分类专栏： Qt 学习之路网络编程文章标签： Qt 串口通信

于 2017-05-05 14:01:18 首次发布

本文链接：https://blog.csdn.net/u014597198/article/details/71195263

版权

Qt 学习之路同时被 2 个专栏收录

91 篇文章 10 订阅

订阅专栏

网络编程

31 篇文章 0 订阅

订阅专栏

1、简述

QtSerialPort模块是QT5中附加模块的一个模块，为硬件和虚拟的串口提供统一的接口。

串口由于其简单和可靠，目前在像嵌入式系统、机器人等工业中依旧用得很多。使用QtSerialPort模块，开发者可以大大缩短开发串口相关的应用程的周期。

Qt SerialPort提供了基本的功能，包括配置、I/O操作、获取和设置RS-232引脚的信号。

2、配置

串口通信需要添加Qt相关库：

QT += serialport

3、源代码

首先可以利用QSerialPortInfo读取设备相关信息，然后我们用容器把他们装起来，再利用QSerialPort与端口进行输入输出交互。

读取设备信息时，可以这样做：

foreach (const QSerialPortInfo &info, QSerialPortInfo::availablePorts()) {
        qDebug() << "Name : " << info.portName();
        qDebug() << "Description : " << info.description();
        qDebug() << "Manufacturer: " << info.manufacturer();
        qDebug() << "Serial Number: " << info.serialNumber();
        qDebug() << "System Location: " << info.systemLocation();
}

在设置端口时，可以这样做：

m_serialport= new QSerialPort();    

//设置COM口

m_serialport->setPortName(ui->comboBox->currentText());

//设置波特率和读写方向

m_serialport->setBaudRate(QSerialPort::Baud9600,QSerialPort::AllDirections);

//数据位为8位

m_serialport->setDataBits(QSerialPort::Data8);

//无流控制

m_serialport->setFlowControl(QSerialPort::NoFlowControl);

//无校验位

m_serialport->setParity(QSerialPort::NoParity);

//一位停止位

m_serialport->setStopBits(QSerialPort::OneStop);

//先关串口，再打开，可以保证串口不被其它函数占用。

m_serialport->close();

//以可读写的方式打开串口

if(m_serialport->open(QIODevice::ReadWrite))

{

//读取数据  串口读取出来的数据类型 是QByteArray 不是QString

 m_requestData = m_serialport->readAll();

}

4、QSerialPort介绍

QSerialPort提供了访问串口的接口函数。使用辅助类QSerialPortInfo可以获取可用的串口信息。将QSerialPortInfo辅助类对象做为参数，使用setPort()或setPortName()函数可以设置要访问的串口设备。

设置好端口后，可以使用open()函数以只读、只写或读写的模式打开使用。

注意，串口使用独占方式打开。使用close()函数关闭串口并且取消IO操作。

串口成功打开后，QSerialPort会尝试确定串口的当前配置并初始化。可以使用setBaudRate()、setDataBits()、setParity()、setStopBits()和setFlowControl()函数重新配置端口设置。

有一对名为QSerialPort::dataTerminalReady、QSerialPort::requestToSend的属性

QSerialPort提供了中止正在调用线程直到信号触发的一系列函数。这些函数用于阻塞串口。

waitForReadyRead()：阻塞调用，直到有新的数据可读

waitForBytesWritten()：阻塞调用，直到数据以及写入串口

阻塞串口编程与非阻塞串口编程完全不同。阻塞串口不会要求时间循环并且通常会简化代码。然而，在GUI程序中，为了避免冻结用户界面，阻塞串口编程只能用于非GUI线程。

QSerialPort也能使用QTextStream和QDataStream的流操作符。在试图使用流操作符>>读时，需要确保有足够可用的数据。

5、QSerialPort成员函数

//构造函数
QSerialPort::QSerialPort(QObject *parent = Q_NULLPTR)
QSerialPort::QSerialPort(const QString &name, QObject *parent = Q_NULLPTR)
QSerialPort::QSerialPort(const QSerialPortInfo &serialPortInfo, QObject *parent = Q_NULLPTR)
 
//如果当前没有数据可读，返回true
[virtual] bool QSerialPort::atEnd() const
 
//波特率改变后，信号触发
[signal] void QSerialPort::baudRateChanged(qint32 baudRate, QSerialPort::Directions directions)
 
//返回可读数据的字节数
[virtual] qint64 QSerialPort::bytesAvailable() const
 
//返回可写数据的字节数
[virtual] qint64 QSerialPort::bytesToWrite() const
 
//关闭串口
[virtual] void QSerialPort::close()
 
//设置串口端口信息为serialPortInfo
void QSerialPort::setPort(const QSerialPortInfo &serialPortInfo)
 
//设置串口名为name
void QSerialPort::setPortName(const QString &name)

6、参考示例（串口示例）

main.cpp代码

#include "mainwindow.h"
#include <QApplication>
 
int main(int argc, char *argv[])
{
    QApplication a(argc, argv);
    MainWindow w;
    w.show();
 
    return a.exec();
}

mainwindows.h代码参考如下：

#ifndef MAINWINDOW_H
#define MAINWINDOW_H
 
#include <QMainWindow>
#include <QtSerialPort/QSerialPort>
#include <QtSerialPort/QSerialPortInfo>
#include <QList>
#include <QDebug>
 
namespace Ui {
class MainWindow;
}
 
class MainWindow : public QMainWindow
{
    Q_OBJECT
 
public:
    explicit MainWindow(QWidget *parent = 0);
    ~MainWindow();
 
private slots:
    void on_btn_openConsole_clicked();
 
    void on_btn_send_clicked();
 
    void on_btn_clearRecv_clicked();
 
    void on_btn_clearSend_clicked();
 
    void readData();
 
private:
    Ui::MainWindow *ui;
    QSerialPort *serial;
};
 
#endif // MAINWINDOW_H

mainwindows.cpp代码

#include "mainwindow.h"
#include "ui_mainwindow.h"
 
 
static const char blankString[] = QT_TRANSLATE_NOOP("SettingsDialog", "N/A");
 
MainWindow::MainWindow(QWidget *parent) :
    QMainWindow(parent),
    ui(new Ui::MainWindow)
{
    ui->setupUi(this);
 
    serial = new QSerialPort;
 
    QString description;
    QString manufacturer;
    QString serialNumber;
 
    //获取可以用的串口
    QList<QSerialPortInfo> serialPortInfos = QSerialPortInfo::availablePorts();
 
    //输出当前系统可以使用的串口个数
    qDebug() << "Total numbers of ports: " << serialPortInfos.count();
 
    //将所有可以使用的串口设备添加到ComboBox中
    for (const QSerialPortInfo &serialPortInfo : serialPortInfos)
    {
        QStringList list;
        description = serialPortInfo.description();
        manufacturer = serialPortInfo.manufacturer();
        serialNumber = serialPortInfo.serialNumber();
 
        list << serialPortInfo.portName()
             << (!description.isEmpty() ? description : blankString)
             << (!manufacturer.isEmpty() ? manufacturer : blankString)
             << (!serialNumber.isEmpty() ? serialNumber : blankString)
             << serialPortInfo.systemLocation()
             << (serialPortInfo.vendorIdentifier() ? QString::number(serialPortInfo.vendorIdentifier(), 16) : blankString)
             << (serialPortInfo.productIdentifier() ? QString::number(serialPortInfo.productIdentifier(), 16) : blankString);
 
        ui->comboBox_serialPort->addItem(list.first(), list);
    }
 
    ui->comboBox_serialPort->addItem(tr("custom"));
 
    //设置波特率
    ui->comboBox_baudRate->addItem(QStringLiteral("9600"), QSerialPort::Baud9600);
    ui->comboBox_baudRate->addItem(QStringLiteral("19200"), QSerialPort::Baud19200);
    ui->comboBox_baudRate->addItem(QStringLiteral("38400"), QSerialPort::Baud38400);
    ui->comboBox_baudRate->addItem(QStringLiteral("115200"), QSerialPort::Baud115200);
    ui->comboBox_baudRate->addItem(tr("Custom"));
 
    //设置数据位
    ui->comboBox_dataBits->addItem(QStringLiteral("5"), QSerialPort::Data5);
    ui->comboBox_dataBits->addItem(QStringLiteral("6"), QSerialPort::Data6);
    ui->comboBox_dataBits->addItem(QStringLiteral("7"), QSerialPort::Data7);
    ui->comboBox_dataBits->addItem(QStringLiteral("8"), QSerialPort::Data8);
    ui->comboBox_dataBits->setCurrentIndex(3);
 
    //设置奇偶校验位
    ui->comboBox_parity->addItem(tr("None"), QSerialPort::NoParity);
    ui->comboBox_parity->addItem(tr("Even"), QSerialPort::EvenParity);
    ui->comboBox_parity->addItem(tr("Odd"), QSerialPort::OddParity);
    ui->comboBox_parity->addItem(tr("Mark"), QSerialPort::MarkParity);
    ui->comboBox_parity->addItem(tr("Space"), QSerialPort::SpaceParity);
 
    //设置停止位
    ui->comboBox_stopBit->addItem(QStringLiteral("1"), QSerialPort::OneStop);
    ui->comboBox_stopBit->addItem(QStringLiteral("2"), QSerialPort::TwoStop);
 
    //添加流控
    ui->comboBox_flowBit->addItem(tr("None"), QSerialPort::NoFlowControl);
    ui->comboBox_flowBit->addItem(tr("RTS/CTS"), QSerialPort::HardwareControl);
    ui->comboBox_flowBit->addItem(tr("XON/XOFF"), QSerialPort::SoftwareControl);
 
 
    //禁用发送按钮
    ui->btn_send->setEnabled(false);
}
 
MainWindow::~MainWindow()
{
    //delete serial;
    delete ui;
 
}
 
//打开串口按钮槽函数
void MainWindow::on_btn_openConsole_clicked()
{
    qDebug() << ui->btn_openConsole->text();
 
    if (ui->btn_openConsole->text() == tr("打开串口"))
    {
 
 
        //设置串口名字
        serial->setPortName(ui->comboBox_serialPort->currentText());
 
        //设置波特率
        serial->setBaudRate(ui->comboBox_baudRate->currentText().toInt());
 
        //设置数据位
        serial->setDataBits(QSerialPort::Data8);
 
        //设置奇偶校验位
        serial->setParity(QSerialPort::NoParity);
 
        //设置停止位
        serial->setStopBits(QSerialPort::OneStop);
 
        //设置流控
        serial->setFlowControl(QSerialPort::NoFlowControl);
 
        //打开串口
        if (serial->open(QIODevice::ReadWrite))
        {
            ui->comboBox_baudRate->setEnabled(false);
            ui->comboBox_dataBits->setEnabled(false);
            ui->comboBox_flowBit->setEnabled(false);
            ui->comboBox_parity->setEnabled(false);
            ui->comboBox_serialPort->setEnabled(false);
            ui->comboBox_stopBit->setEnabled(false);
 
            ui->btn_send->setEnabled(true);
 
            ui->btn_openConsole->setText(tr("关闭串口"));
 
            //信号与槽函数关联
            connect(serial, &QSerialPort::readyRead, this, &MainWindow::readData);
        }
    }
    else
    {
        //关闭串口
        //serial->clear();
        serial->close();
        //serial->deleteLater();
 
        //恢复设置功能
        ui->comboBox_baudRate->setEnabled(true);
        ui->comboBox_dataBits->setEnabled(true);
        ui->comboBox_flowBit->setEnabled(true);
        ui->comboBox_parity->setEnabled(true);
        ui->comboBox_serialPort->setEnabled(true);
        ui->comboBox_stopBit->setEnabled(true);
 
        ui->btn_openConsole->setText(tr("打开串口"));
        ui->btn_send->setEnabled(false);
    }
 
}
 
//发送数据槽函数
void MainWindow::on_btn_send_clicked()
{
    serial->write(ui->textEdit_send->toPlainText().toLatin1());
 
}
 
//清空接收数据槽函数
void MainWindow::on_btn_clearRecv_clicked()
{
    ui->textEdit_recv->clear();
}
 
//清空发送区槽函数
void MainWindow::on_btn_clearSend_clicked()
{
    ui->textEdit_send->clear();
}
 
void MainWindow::readData()
{
    QByteArray buf;
 
    qDebug() << "readData: " << endl;
 
    buf = serial->readAll();
    if (!buf.isEmpty())
    {
        QString str = ui->textEdit_recv->toPlainText();
 
        str += tr(buf);
        ui->textEdit_recv->clear();
        ui->textEdit_recv->append(str);
    }
}

7、效果

8、分享

示例代码已上传CSDN：http://download.csdn.net/detail/u014597198/9834104

沙振宇

关注

4
点赞
踩
11

收藏

觉得还不错? 一键收藏
打赏
1
评论
【Qt 学习之路】QSerialPort处理串口通信

QSerialPort提供了访问串口的接口函数。使用辅助类QSerialPortInfo可以获取可用的串口信息。将QSerialPortInfo辅助类对象做为参数，使用setPort()或setPortName()函数可以设置要访问的串口设备。设置好端口后，可以使用open()函数以只读、只写或读写的模式打开使用。注意，串口使用独占方式打开。使用close()函数关闭串口并且取消IO操作。串口成功打开后，QSerialPort会尝试确定串口的当前配置并初始化。
复制链接

扫一扫