Qt实现串口通信的完整步骤

　　要实现串口通信，需要知道串口通信需要的信息
　　主要参数有：波特率、校验位、数据位、停止位、控制流
　　主要操作有：串口的打开和关闭、刷新设备串口、接发数据、开关显示灯等。实现效果如图：
　　界面设计如下：
　　每个控件类名如下：
　　LED灯是QLable控件，设置它的长宽都是24px，然后鼠标右击，选择＂样式表＂，在样式表中添加代码。
　　文章最后附赠完整源码
　　第一步：在头文件中引入 QtSerialPort 类的两个头文件（必须引入）// 引入串口通信的两个头文件(第一步) #include          // 提供访问串口的功能 #include      // 提供系统中存在的串口信息
　　第二步：在工程文件中添加以下代码# 引入串口工程类型（第二步） QT       += serialport
　　第三步：在头文件中定义全局的串口对象QSerialPort     *serial;                            // 定义全局的串口对象（第三步）
　　第四步：参数设置，在头文件中定义初始化参数的函数和参数变量名，在.cpp文件中实现函数public: void        SerialPortInit();                      // 串口初始化（参数配置）   private: // 参数配置     QStringList     baudList;                           //波特率     QStringList     parityList;                         //校验位     QStringList     dataBitsList;                       //数据位     QStringList     stopBitsList;                       //停止位     QStringList     flowControlList;                    //控制流// 串口初始化（参数配置） void MainWindow::SerialPortInit() {     serial = new QSerialPort;                       //申请内存,并设置父对象       // 获取计算机中有效的端口号，然后将端口号的名称给端口选择控件     foreach(const QSerialPortInfo &info,QSerialPortInfo::availablePorts())     {         serial->setPort(info);                      // 在对象中设置串口         if(serial->open(QIODevice::ReadWrite))      // 以读写方式打开串口         {             ui->PortBox->addItem(info.portName());  // 添加计算机中的端口             serial->close();                        // 关闭         } else         {             qDebug() << ＂串口打开失败，请重试＂;         }     }       // 参数配置     // 波特率，波特率默认选择57600 ，禁止用户点击     ui->BaudBox->addItem(＂57600＂);     serial->setBaudRate(QSerialPort::Baud57600);     ui->BaudBox->setDisabled(true);       // 校验，校验默认选择无     ui->ParityBox->addItem(＂无＂);     serial->setParity(QSerialPort::NoParity);       // 数据位，数据位默认选择8位     ui->BitBox->addItem(＂8＂);     serial->setDataBits(QSerialPort::Data8);       // 停止位，停止位默认选择1位     ui->StopBox->addItem(＂1＂);     serial->setStopBits(QSerialPort::OneStop);       // 控制流，默认选择无     ui->ControlBox->addItem(＂无＂);     serial->setFlowControl(QSerialPort::NoFlowControl);       // 刷新串口     RefreshSerialPort(0);       // 信号 connect(serial,&QSerialPort::readyRead,this,&MainWindow::DataReceived);      // 接收数据 connect(ui->SendWordOrder,&QPushButton::clicked,this,&MainWindow::DataSend); // 发送数据 connect(ui->SendButton,&QPushButton::clicked,this,&MainWindow::DataSend);    // 发送数据 connect(ui->SendEditBtn1,&QPushButton::clicked,this,&MainWindow::DataSend);  // 发送数据 connect(ui->SendEditBtn2,&QPushButton::clicked,this,&MainWindow::DataSend);  // 发送数据 connect(ui->SendEditBtn3,&QPushButton::clicked,this,&MainWindow::DataSend);  // 发送数据 }
　　第五步：刷新串口，及时更新可用的串口
　　QT开发交流+赀料君羊：714620761// 刷新串口 void MainWindow::RefreshSerialPort(int index) {     QStringList portNameList;                                        // 存储所有串口名     if(index != 0)     {         serial->setPortName(ui->PortBox->currentText());             //设置串口号     }     else     {         ui->PortBox->clear();                                        //关闭串口号         ui->PortBox->addItem(＂刷新＂);                                //添加刷新         foreach(const QSerialPortInfo &info,QSerialPortInfo::availablePorts()) //添加新串口         {             portNameList.append(info.portName());         }         ui->PortBox->addItems(portNameList);         ui->PortBox->setCurrentIndex(1);                             // 当前串口号为COM1         serial->setPortName(ui->PortBox->currentText());             //设置串口号    } }
　　第六步：发送数据和接收数据// 接收数据,使用read () / readLine () / readAll () void MainWindow::DataReceived() {     char BUF[512] = {0};                                       // 存储转换类型后的数据     QByteArray data = serial->readAll();                      // 读取数据       if(!data.isEmpty())                                 // 接收到数据     {         QString str = ui->DataReceived->toPlainText();  // 返回纯文本         str += tr(data);                         // 数据是一行一行传送的，要保存所有数据         ui->DataReceived->clear();                      // 清空之前的数据         ui->DataReceived->append(str);                  // 将数据放入控件中         qDebug() << ＂str info: ＂ << ui->DataReceived->toPlainText();            // 清除之前的数据，防止追加，因为每次获取的数据不一样         int index = str.indexOf(＂r ＂);                // 找到，返回索引值，找不到，返回-1         if(index != -1)         {             snprintf(BUF,500,＂%s＂, str.left(index + 2).toUtf8().data()); // QString转为char * 类型             qDebug() << ＂BUF info: ＂ << BUF;        // 数据类型转换成功             str.remove(0,index + 2);                // 处理获取到的数据，将其放入对应的控件中             // .....                                       }     } }   // 发送数据，write () void MainWindow::DataSend() {     serial->write(ui->DataSend->toPlainText().toLatin1());      // 串口发送数据 }
　　第七步：打开串口和关闭串口，当打开串口后，显示绿灯；关闭串口后，显示红灯// 串口开关 void color:rgb(98 189 255)＂>MainWindow::on_OpenSerialButton_clicked() {     if(serial->isOpen())                                  // 如果串口打开了，先给他关闭     {         serial->clear();         serial->close();         // 关闭状态，按钮显示＂打开串口＂         ui->OpenSerialButton->setText(＂打开串口＂);         // 关闭状态，允许用户操作         ui->BaudBox->setDisabled(false);         ui->ParityBox->setDisabled(false);         ui->BitBox->setDisabled(false);         ui->StopBox->setDisabled(false);         ui->ControlBox->setDisabled(false);         // 禁止操作＂发送字符操作＂         ui->SendWordOrder->setDisabled(true);         ui->SendButton->setDisabled(true);         // 关闭状态，颜色为绿色         ui->OpenSerialButton->setStyleSheet(＂color: green;＂);         // 关闭，显示灯为红色         LED(true);         // 清空数据         ui->DataReceived->clear();         ui->DataSend->clear();     }     else                                             // 如果串口关闭了，先给他打开     {         //当前选择的串口名字         serial->setPortName(ui->PortBox->currentText());         //用ReadWrite 的模式尝试打开串口，无法收发数据时，发出警告         if(!serial->open(QIODevice::ReadWrite))         {             QMessageBox::warning(this,tr(＂提示＂),tr(＂串口打开失败!＂),QMessageBox::Ok);             return;          }         // 打开状态，按钮显示＂关闭串口＂         ui->OpenSerialButton->setText(＂关闭串口＂);         // 打开状态，禁止用户操作         ui->BaudBox->setDisabled(true);         ui->ParityBox->setDisabled(true);         ui->BitBox->setDisabled(true);         ui->StopBox->setDisabled(true);         ui->ControlBox->setDisabled(true);         // 允许操作＂发送字符操作＂         ui->SendWordOrder->setDisabled(false);         ui->SendButton->setDisabled(false);         // 打开状态，颜色为红色         ui->OpenSerialButton->setStyleSheet(＂color: red;＂);         // 打开，显示灯为绿色         LED(false);     } }   // 开关显示灯 void  color:rgb(98 189 255)＂>MainWindow::LED(bool changeColor) {     if(changeColor == false)     {         // 显示绿色         ui->LED->setStyleSheet(＂background-color: qradialgradient(spread:pad, cx:0.5, cy:0.5, radius:0.5, fx:0.5, fy:0.5, stop:0 rgba(0, 229, 0, 255), stop:1 rgba(255, 255, 255, 255));border-radius:12px;＂);     }     else     {         // 显示红色         ui->LED->setStyleSheet(＂background-color: qradialgradient(spread:pad, cx:0.5, cy:0.5, radius:0.5, fx:0.5, fy:0.5, stop:0 rgba(255, 0, 0, 255), stop:1 rgba(255, 255, 255, 255));border-radius:12px;＂);     } }
　　第八步：相关槽函数// 控件中添加 指令＂###＂ void MainWindow::on_SendButton_clicked() {     on_ClearButton_clicked();     ui->DataSend->append(＂###＂); } // 清空控件 void MainWindow::on_ClearButton_clicked() {     ui->DataSend->setText(＂＂); } // 清空接收到的数据 void MainWindow::on_ClearShowButton_clicked() {     ui->DataReceived->setText(＂＂); } // 点击发送后，获取串口信息并展示在接受控件中 void MainWindow::on_SendEditBtn1_clicked() {     on_ClearButton_clicked();     QString EditText = ui->Edit1->text();               //获取发送框内容     ui->DataSend->setText(EditText);                     //将文本内容放在发送栏中 }   void MainWindow::on_SendEditBtn2_clicked() {     on_ClearButton_clicked();     QString EditText = ui->Edit2->text();               //获取发送框内容       // qDebug() << ＂Edit1 text: ＂ << EditText;       ui->DataSend->append(EditText);                     //将文本内容放在发送栏中 }   void MainWindow::on_SendEditBtn3_clicked() {     on_ClearButton_clicked();     QString EditText = ui->Edit3->text();               //获取发送框内容       // qDebug() << ＂Edit1 text: ＂ << EditText;       ui->DataSend->append(EditText);                     //将文本内容放在发送栏中 }       void MainWindow::on_SendWordOrder_clicked() {     on_SendButton_clicked(); }源码：
　　工程文件.pro文件源码：QT       += core gui # 引入串口工程类型（第二步） QT       += serialport   greaterThan(QT_MAJOR_VERSION, 4): QT += widgets   CONFIG += c++11   # The following define makes your compiler emit warnings if you use # any Qt feature that has been marked deprecated (the exact warnings # depend on your compiler). Please consult the documentation of the # deprecated API in order to know how to port your code away from it. DEFINES += QT_DEPRECATED_WARNINGS   # You can also make your code fail to compile if it uses deprecated APIs. # In order to do so, uncomment the following line. # You can also select to disable deprecated APIs only up to a certain version of Qt. #DEFINES += QT_DISABLE_DEPRECATED_BEFORE=0x060000    # disables all the APIs deprecated before Qt 6.0.0   SOURCES +=      main.cpp      mainwindow.cpp   HEADERS +=      mainwindow.h   FORMS +=      mainwindow.ui   # Default rules for deployment. qnx: target.path = /tmp/${TARGET}/bin else: unix:!android: target.path = /opt/${TARGET}/bin !isEmpty(target.path): INSTALLS += target
　　头文件源码：#ifndef MAINWINDOW_H #define MAINWINDOW_H   #include  // 引入串口通信的两个头文件(第一步) #include          // 提供访问串口的功能 #include      // 提供系统中存在的串口信息   QT_BEGIN_NAMESPACE namespace Ui { class MainWindow; } QT_END_NAMESPACE   class MainWindow : public QMainWindow {     Q_OBJECT   public:     MainWindow(QWidget *parent = nullptr);     ~MainWindow();       // 串口功能     void        SerialPortInit();                      // 串口初始化（参数配置）     void        RefreshSerialPort(int index);          // 刷新串口   public slots:     // 串口槽函数     void        DataReceived();                        // 接收数据 private slots:     // 串口槽函数     void        DataSend();                            // 发送数据       void        on_OpenSerialButton_clicked();         // 串口开关       void        on_SendButton_clicked();               // 控件中添加 #       void        on_ClearButton_clicked();              // 清空控件中的所有 #       void        on_ClearShowButton_clicked();          // 清空接收到的数据       void        LED(bool changeColor);                 // 开关显示灯       // 点击发送，接收数据     void        on_SendEditBtn1_clicked();       void        on_SendEditBtn2_clicked();       void        on_SendEditBtn3_clicked();         void on_SendWordOrder_clicked();   private:     Ui::MainWindow *ui;       // 串口变量     QSerialPort     *serial;                            // 定义全局的串口对象（第三步）     // 参数配置     QStringList     baudList;                           //波特率     QStringList     parityList;                         //校验位     QStringList     dataBitsList;                       //数据位     QStringList     stopBitsList;                       //停止位     QStringList     flowControlList;                    //控制流 }; #endif // MAINWINDOW_H
　　.cpp文件源码：#include ＂color:rgb(98 189 255)＂>mainwindow.h＂ #include ＂ui_color:rgb(98 189 255)＂>mainwindow.h＂ #include  #include    color:rgb(98 189 255)＂>MainWindow::color:rgb(98 189 255)＂>MainWindow(QWidget *parent)     : Qcolor:rgb(98 189 255)＂>MainWindow(parent)     , ui(new color:rgb(144 255 173)＂>Ui::color:rgb(98 189 255)＂>MainWindow) {     ui->setupcolor:rgb(144 255 173)＂>Ui(this);       SerialPortInit(); }   // 串口初始化（参数配置） void color:rgb(98 189 255)＂>MainWindow::SerialPortInit() {     serial = new color:rgb(98 189 255)＂>QSerialPort;                       //申请内存,并设置父对象       // 获取计算机中有效的端口号，然后将端口号的名称给端口选择控件     foreach(const color:rgb(98 189 255)＂>color:rgb(98 189 255)＂>QSerialPortInfo &color:rgb(73 238 255)＂>info,color:rgb(98 189 255)＂>color:rgb(98 189 255)＂>QSerialPortInfo::availablePorts())     {         serial->setPort(color:rgb(73 238 255)＂>info);                      // 在对象中设置串口         if(serial->open(color:rgb(98 189 255)＂>QIODevice::ReadWrite))      // 以读写方式打开串口         {             ui->PortBox->addItem(color:rgb(73 238 255)＂>info.portName());  // 添加计算机中的端口             serial->close();                        // 关闭         } else         {             qDebug() << ＂串口打开失败，请重试＂;         }     }       // 参数配置     // 波特率，波特率默认选择color:rgb(255 95 0)＂>57600 ，禁止用户点击     ui->BaudBox->addItem(＂color:rgb(255 95 0)＂>57600＂);     serial->setBaudRate(color:rgb(98 189 255)＂>QSerialPort::Baudcolor:rgb(255 95 0)＂>57600);     ui->BaudBox->setDisabled(true);       // 校验，校验默认选择无     ui->ParityBox->addItem(＂无＂);     serial->setParity(color:rgb(98 189 255)＂>QSerialPort::NoParity);       // 数据位，数据位默认选择8位     ui->BitBox->addItem(＂8＂);     serial->setDataBits(color:rgb(98 189 255)＂>QSerialPort::Data8);       // 停止位，停止位默认选择1位     ui->StopBox->addItem(＂1＂);     serial->setStopBits(color:rgb(98 189 255)＂>QSerialPort::OneStop);       // 控制流，默认选择无     ui->ControlBox->addItem(＂无＂);     serial->setFlowControl(color:rgb(98 189 255)＂>QSerialPort::NoFlowControl);       // 刷新串口     RefreshSerialPort(0);       // 信号     connect(serial,&color:rgb(98 189 255)＂>QSerialPort::readyRead,this,&color:rgb(98 189 255)＂>MainWindow::DataReceived);         // 接收数据     connect(ui->SendWordOrder,&color:rgb(98 189 255)＂>QPushButton::clicked,this,&color:rgb(98 189 255)＂>MainWindow::DataSend);    // 发送数据     connect(ui->SendButton,&color:rgb(98 189 255)＂>QPushButton::clicked,this,&color:rgb(98 189 255)＂>MainWindow::DataSend);       // 发送数据     connect(ui->SendEditBtn1,&color:rgb(98 189 255)＂>QPushButton::clicked,this,&color:rgb(98 189 255)＂>MainWindow::DataSend);    // 发送数据     connect(ui->SendEditBtn2,&color:rgb(98 189 255)＂>QPushButton::clicked,this,&color:rgb(98 189 255)＂>MainWindow::DataSend);    // 发送数据     connect(ui->SendEditBtn3,&color:rgb(98 189 255)＂>QPushButton::clicked,this,&color:rgb(98 189 255)＂>MainWindow::DataSend);    // 发送数据   } // 刷新串口 void color:rgb(98 189 255)＂>MainWindow::RefreshSerialPort(int index) {     QStringList color:rgb(98 189 255)＂>portNameList;                                        // 存储所有串口名     if(index != 0)     {         serial->setPortName(ui->PortBox->currentText());             //设置串口号     }     else     {         ui->PortBox->clear();                                        //关闭串口号         ui->PortBox->addItem(＂刷新＂);                                //添加刷新         foreach(const color:rgb(98 189 255)＂>color:rgb(98 189 255)＂>QSerialPortInfo &color:rgb(73 238 255)＂>info,color:rgb(98 189 255)＂>color:rgb(98 189 255)＂>QSerialPortInfo::availablePorts()) //添加新串口         {             color:rgb(98 189 255)＂>portNameList.append(color:rgb(73 238 255)＂>info.portName());         }                 ui->PortBox->addItems(color:rgb(98 189 255)＂>portNameList);         ui->PortBox->setCurrentIndex(1);                             // 当前串口号为COM1         serial->setPortName(ui->PortBox->currentText());             //设置串口号    } }   // 接收数据,使用read () / readLine () / readAll () void color:rgb(98 189 255)＂>MainWindow::DataReceived() {     char BUF[512] = {0};                                       // 存储转换类型后的数据     QByteArray color:rgb(73 238 255)＂>data = serial->readAll();                      // 读取数据       if(!color:rgb(73 238 255)＂>data.isEmpty())                                 // 接收到数据     {         QString color:rgb(255 111 119)＂>str = ui->DataReceived->toPlainText();  // 返回纯文本         color:rgb(255 111 119)＂>str += tr(color:rgb(73 238 255)＂>data);                                // 数据是一行一行传送的，要保存所有数据         ui->DataReceived->clear();                      // 清空之前的数据         ui->DataReceived->append(color:rgb(255 111 119)＂>str);                  // 将数据放入控件中         qDebug() << ＂color:rgb(255 111 119)＂>str color:rgb(73 238 255)＂>info: ＂ << ui->DataReceived->toPlainText();            // 清除之前的数据，防止追加，因为每次获取的数据不一样         int index = color:rgb(255 111 119)＂>str.indexOf(＂r ＂);                // 找到，返回索引值，找不到，返回-1         if(index != -1)         {             snprintf(BUF,500,＂%s＂, color:rgb(255 111 119)＂>str.left(index + 2).toUtf8().color:rgb(73 238 255)＂>data()); // QString转为char * 类型             qDebug() << ＂BUF color:rgb(73 238 255)＂>info: ＂ << BUF;             color:rgb(255 111 119)＂>str.remove(0,index + 2);               // 处理获取到的数据，将其放入对应的控件中             // ....         }     } } // 发送数据，write () void color:rgb(98 189 255)＂>MainWindow::DataSend() {     serial->write(ui->DataSend->toPlainText().toLatin1());      // 串口发送数据 }   // 开关显示灯 void  color:rgb(98 189 255)＂>MainWindow::LED(bool changeColor) {     if(changeColor == false)     {         // 显示绿色         ui->LED->setStyleSheet(＂color:rgb(98 189 255)＂>background-color: qradialgradient(color:rgb(255 211 0)＂>spread:pad, color:rgb(144 255 173)＂>cx:0.5, color:rgb(144 255 173)＂>cy:0.5, color:rgb(255 211 0)＂>radius:0.5, color:rgb(144 255 173)＂>fx:0.5, color:rgb(144 255 173)＂>fy:0.5, color:rgb(73 238 255)＂>stop:0 rgba(0, 229, 0, 255), color:rgb(73 238 255)＂>stop:1 rgba(255, 255, 255, 255));border-color:rgb(255 211 0)＂>radius:12px;＂);     }     else     {         // 显示红色         ui->LED->setStyleSheet(＂color:rgb(98 189 255)＂>background-color: qradialgradient(color:rgb(255 211 0)＂>spread:pad, color:rgb(144 255 173)＂>cx:0.5, color:rgb(144 255 173)＂>cy:0.5, color:rgb(255 211 0)＂>radius:0.5, color:rgb(144 255 173)＂>fx:0.5, color:rgb(144 255 173)＂>fy:0.5, color:rgb(73 238 255)＂>stop:0 rgba(255, 0, 0, 255), color:rgb(73 238 255)＂>stop:1 rgba(255, 255, 255, 255));border-color:rgb(255 211 0)＂>radius:12px;＂);     } }   color:rgb(98 189 255)＂>MainWindow::~color:rgb(98 189 255)＂>MainWindow() {     delete ui; }   // 串口开关 void color:rgb(98 189 255)＂>MainWindow::on_OpenSerialButton_clicked() {     if(serial->isOpen())                                        // 如果串口打开了，先给他关闭     {         serial->clear();         serial->close();         // 关闭状态，按钮显示＂打开串口＂         ui->OpenSerialButton->setText(＂打开串口＂);         // 关闭状态，允许用户操作         ui->BaudBox->setDisabled(false);         ui->ParityBox->setDisabled(false);         ui->BitBox->setDisabled(false);         ui->StopBox->setDisabled(false);         ui->ControlBox->setDisabled(false);         // 禁止操作＂发送字符操作＂         ui->SendWordOrder->setDisabled(true);         ui->SendButton->setDisabled(true);         // 关闭状态，颜色为绿色         ui->OpenSerialButton->setStyleSheet(＂color: green;＂);         // 关闭，显示灯为红色         LED(true);         // 清空数据         ui->DataReceived->clear();         ui->DataSend->clear();     }     else                                                        // 如果串口关闭了，先给他打开     {         //当前选择的串口名字         serial->setPortName(ui->PortBox->currentText());         //用ReadWrite 的模式尝试打开串口，无法收发数据时，发出警告         if(!serial->open(color:rgb(98 189 255)＂>QIODevice::ReadWrite))         {             QMessageBox::warning(this,tr(＂提示＂),tr(＂串口打开失败!＂),QMessageBox::Ok);             return;          }         // 打开状态，按钮显示＂关闭串口＂         ui->OpenSerialButton->setText(＂关闭串口＂);         // 打开状态，禁止用户操作         ui->BaudBox->setDisabled(true);         ui->ParityBox->setDisabled(true);         ui->BitBox->setDisabled(true);         ui->StopBox->setDisabled(true);         ui->ControlBox->setDisabled(true);         // 允许操作＂发送字符操作＂         ui->SendWordOrder->setDisabled(false);         ui->SendButton->setDisabled(false);         // 打开状态，颜色为红色         ui->OpenSerialButton->setStyleSheet(＂color: red;＂);         // 打开，显示灯为绿色         LED(false);     } } // 控件中添加 # void color:rgb(98 189 255)＂>MainWindow::on_SendButton_clicked() {     on_ClearButton_clicked();     ui->DataSend->append(＂###＂); } // 清空控件 void color:rgb(98 189 255)＂>MainWindow::on_ClearButton_clicked() {     ui->DataSend->setText(＂＂); } // 清空接收到的数据 void color:rgb(98 189 255)＂>MainWindow::on_ClearShowButton_clicked() {     ui->DataReceived->setText(＂＂); } // 点击发送后，获取串口信息并展示在接受控件中 void color:rgb(98 189 255)＂>MainWindow::on_SendEditBtn1_clicked() {     on_ClearButton_clicked();     QString EditText = ui->Edit1->text();               //获取发送框内容     ui->DataSend->setText(EditText);                     //将文本内容放在发送栏中 }   void color:rgb(98 189 255)＂>MainWindow::on_SendEditBtn2_clicked() {     on_ClearButton_clicked();     QString EditText = ui->Edit2->text();               //获取发送框内容       // qDebug() << ＂Edit1 text: ＂ << EditText;       ui->DataSend->append(EditText);                     //将文本内容放在发送栏中 }   void color:rgb(98 189 255)＂>MainWindow::on_SendEditBtn3_clicked() {     on_ClearButton_clicked();     QString EditText = ui->Edit3->text();               //获取发送框内容       // qDebug() << ＂Edit1 text: ＂ << EditText;       ui->DataSend->append(EditText);                     //将文本内容放在发送栏中 }     void color:rgb(98 189 255)＂>MainWindow::on_SendWordOrder_clicked() {     on_SendButton_clicked(); }
　　运行后效果：