这篇文章让你懂-＞Qt串口通信（嵌入式上位机开发）

Frank_refuel

5688人浏览 · 2026-05-27 21:17:07

Frank_refuel · 2026-05-27 21:17:07 发布

在开发上位机的过程中，我深入学习了Qt的串口通信，遇到了不少坑，也积累了一些经验。希望这篇文章能帮助正在学习Qt串口通信的你少走弯路，也方便自己以后快速回顾。

本文章从0基础讲述Qt如何连接端口号互发送和互接受信息，在讲述数据帧

环境Qt5、虚拟串口驱动、串口调试助手（文章结尾会给出链接）

一、串口通讯

主要参数：波特率、校验位、数据位、停止位、控制流

主要操作：串口的打开和关闭，刷新串口设备、接收数据

二、实现串口通信

1、在头文件中引入串口通信的QtSerialPort类的两个头文件

// 引入串口通信的头文件
#include <QtSerialPort/QSerialPort>  //提供访问串口的功能
#include <QtSerialPort/QSerialPortInfo> //提供系统中的存在的串口信息

2、在工程文件中.pro添加以下代码

QT += serialport

3、在头文件中定义全局的串口对象

QSerialPort *serialPort;

做完前两个步骤，我们即将开始实现一个串口通信

4、创建串口对象和连接信号槽

 // 创建串口对象
    serialPort = new QSerialPort(this);

    // 连接信号槽：当串口有数据达到时，自动调用serialPortReadyRead_stol()
    connect(serialPort, SIGNAL(readyRead()),
            this, SLOT(serialPortReadyRead_Slot()));

5、通过一个按键实现串口的开和关

1、关联打开串口的点击事件

2、在打开按键中实现

void Widget::on_openBt_clicked()
{
    if(open_flag == false)  // 串口未打开，执行打开操作
    {
        // 检查是否选择了串口
        if(ui->serialBox->currentText() == "无可用串口" || ui->serialBox->count() == 0)
        {
            QMessageBox::warning(this, "提示", "没有可用的串口！");
            return;
        }

        QSerialPort::BaudRate baudBite = QSerialPort::Baud115200;//波特率115200
        QSerialPort::DataBits dataBite = QSerialPort::Data8;     //数据位8位
        QSerialPort::StopBits stopBite = QSerialPort::OneStop;   //停止位1位
        QSerialPort::Parity checkBite = QSerialPort::NoParity;   //无校验

        serialPort->setPortName(ui->serialBox->currentText());  //设置串口号
        serialPort->setBaudRate(baudBite);                      //设置波特率
        serialPort->setDataBits(dataBite);                      //设置数据位
        serialPort->setStopBits(stopBite);                      //设置停止位
        serialPort->setParity(checkBite);                       //设置校验位

        qDebug() << "尝试打开串口:" << ui->serialBox->currentText();
        //尝试打开窗口
        if(serialPort->open(QIODevice::ReadWrite)){//以读写方式打开
            open_flag = true;                       // 标记已打开
            ui->openBt->setText("关闭串口");            //改变按钮文字
            QMessageBox::information(this, "提示", "串口打开成功");
            qDebug() << "串口打开成功";

            // 串口打开后再发送数据
            on_Send_clicked();

        }
        else {
            QMessageBox::critical(this, "提示", "串口打开失败");
            qDebug() << "串口打开失败，错误:" << serialPort->errorString();
        }
    }
    else  // 串口已打开，执行关闭操作
    {
        serialPort->clear(); //清空缓冲区
        serialPort->close();//关闭串口
        open_flag = false;//标记已关闭
        ui->openBt->setText("打开串口");//改变按钮文字
        QMessageBox::information(this, "提示", "串口关闭成功");
        qDebug() << "串口已关闭";
    }
}

3、刷新串口

如果在打开软件后才插上串口设备的话，下拉列表不会显示，需要重新搜索串口

点击刷新串口按钮，刷新串口号，并显示出来

void Widget::on_refreshBt_clicked()
{
    qDebug() << "刷新串口";
    ui->serialBox->clear(); //清空下拉框

    // 获取当前电脑上所有可用的串口
    this->avaiPortsList = QSerialPortInfo::availablePorts();

    if(avaiPortsList.isEmpty())// 如果没有串口
    {
        ui->serialBox->addItem("无可用串口");
        qDebug() << "没有发现串口";
        return;
    }

    // 遍历所有串口，添加到下拉框中
    for(int i = 0; i < avaiPortsList.length(); i++)
    {
        ui->serialBox->addItem(avaiPortsList[i].portName());
        qDebug() << "发现串口:" << avaiPortsList[i].portName();
    }
}

6.串口发送数据

将输入框内容发送：

void Widget::on_Send_clicked()
{
    // 从界面输入框获取卡号
    QString data = QString("W:%1").arg(ui->t5cardEdit->text());
    //将字符串转换出UTF8
    QByteArray dataArray = data.toUtf8(); // 将字符串转换成字节数组
    //通过串口发送出去
    serialPort->write(dataArray); // 发送数据到串口
    qDebug() << "发送命令成功！";
}

7.串口接收数据

串口接收槽函数

void Widget::serialPortReadyRead_Slot()
{
    QByteArray data = serialPort->readAll();

    // 尝试UTF-8解码
    QString utf8Text = QString::fromUtf8(data);
    qDebug() << "UTF-8解码:" << utf8Text;

    // 如果UTF-8乱码，尝试GBK
    if(utf8Text.contains("�")) {
        QTextCodec *codec = QTextCodec::codecForName("GBK");
        QString gbkText = codec->toUnicode(data);
        qDebug() << "GBK解码:" << gbkText;
    }
}