QT开发--串口通信

第十六章 串口通信

16.1 串口通信基础

串口通信主要通过DB9接口，适用于短距离（<10米）。关键参数包括：

• 波特率：每秒传输bit数，如9600。
• 数据位：信息包中的有效数据位数。
• 停止位：单个包的最后一位，通常为1或2位。
• 奇偶校验位：检错方式，分偶、奇校验。

16.1.1 QtSerialPort模块简介

        QtSerialPort是QT5的附加模块，为硬件和虚拟串口提供接口。它简化串口应用开发，提供配置、I/O操作等功能。

        使用QtSerialPort，需包含以下头文件：

#include <QSerialPortInfo>  
#include <QSerialPort>

        并在.pro文件中添加：

QT += serialport

        QSerialPort类用于访问串口，

        QSerialPortInfo用于获取串口信息。

        可通过setPort()或setPortName()设置要访问的串口。

        使用open()和close()打开和关闭串口。

        串口打开后，可使用setBaudRate()等函数重新配置。

        waitForReadyRead()和waitForBytesWritten()用于阻塞操作。

16.1.2 QSerialPort 成员函数

构造函数：

// 构造一个未初始化的QSerialPort对象，可选指定父对象  
QSerialPort::QSerialPort(QObject *parent = nullptr)  // 构造并初始化QSerialPort对象，指定端口名和可选的父对象  
QSerialPort::QSerialPort(const QString &name, QObject *parent = nullptr)  // 构造并初始化QSerialPort对象，根据QSerialPortInfo指定端口信息和可选的父对象  
QSerialPort::QSerialPort(const QSerialPortInfo &serialPortInfo, QObject *parent = nullptr)

关键方法：

        bool atEnd() const：检查是否有数据可读。

        qint64 bytesAvailable() const：返回可读数据字节数。

        qint64 bytesToWrite() const：返回可写数据字节数。

        void close()：关闭串口。

        void setPort(const QSerialPortInfo &serialPortInfo)：设置串口信息。

        void setPortName(const QString &name)：设置串口名。

        //波特率改变时触发信号

        [signal] void baudRateChanged(qint32 baudRate, //新的波特率
                        QSerialPort::Directions directions)          //波特率用于哪方

/*检查是否有数据可读,无数据可读返回true*/
[virtual] bool QSerialPort::atEnd() const;/*波特率改变后，信号触发*/
[signal] void QSerialPort::baudRateChanged(qint32 baudRate, //新的波特率QSerialPort::Directions directions) //波特率用于哪方
/*
QSerialPort::AllDirections //默认,表示读写方向都应用此波特率
QSerialPort::Input         //仅用于输入方向
QSerialPort::Output        //仅用于输出方向
*//*返回可读数据的字节数*/
[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);

16.2 QSerialPortInfo

16.2.1 QSerialPortInfo 简介

        QSerialPortInfo 类用于提供系统中已有串口设备的信息。可通过其静态成员函数获取代表各串口的 QSerialPortInfo 对象链表。每个对象包含端口的详细信息，如端口名、系统位置、描述、制造商等，并可用于配置 QSerialPort 对象。

16.2.2 QSerialPortInfo 成员函数

构造函数

QSerialPortInfo(const QSerialPort &port);  
QSerialPortInfo(const QString &name);  
QSerialPortInfo(const QSerialPortInfo &other);

静态成员函数

static QList<QSerialPortInfo> availablePorts(); // 返回可用串口链表  
static QList<qint32> standardBaudRates();      // 返回标准波特率链表

成员函数

QString description() const;         // 返回串口描述  
bool hasProductIdentifier() const; // 是否有生产编码  
bool hasVendorIdentifier() const; // 是否有制造商编码  
bool isBusy() const;               // 串口是否正忙  
QString manufacturer() const;     // 返回制造商名称  
QString portName() const;         // 返回串口名称  
quint16 productIdentifier() const; // 返回生产编码  
QString serialNumber() const;    // 返回序列号  
QString systemLocation() const; // 返回系统位置  
quint16 vendorIdentifier() const; // 返回制造商编码  
void swap(QSerialPortInfo &other); // 交换两个对象

16.3 实现简易串口

打开/关闭串口：

        当点击“打开串口”按钮时，配置串口参数并尝试打开串口。如果成功，禁用串口配置ComboBox，启用发送按钮，并更改按钮文本为“关闭串口”。

        同时连接串口的 readyRead信号到 readData槽函数。

        当点击“关闭串口”按钮时（即串口已打开状态），关闭串口，重新启用串口配置ComboBox，更改按钮文本为“打开串口”，并禁用发送按钮。

数据发送与接收：

        点击发送按钮时，将发送文本框中的内容以Latin1编码写入串口。

        点击清空接收/发送数据按钮时，清空相应的文本框内容。

        当串口有数据可读时，readData槽函数被调用，读取所有可用数据，并将其追加到接收文本框中。

#ifndef MAINWINDOW_H // 防止头文件重复包含，如果已定义MAINWINDOW_H则不再次包含  
#define MAINWINDOW_H  // 包含必要的Qt库头文件  
#include <QMainWindow> // 主窗口类  
#include <QSerialPort> // 串口通信类  
#include <QSerialPortInfo> // 串口信息类，用于获取系统中可用的串口信息  
#include <QList> // 用于存储串口信息列表  
#include <QDebug> // 用于调试输出  // Ui命名空间，包含UI类的声明（通常由Qt Designer生成）  
namespace Ui {  
class MainWindow;  
}  // MainWindow类，继承自QMainWindow  
class MainWindow : public QMainWindow {  Q_OBJECT // 使用Qt的宏，允许该类使用信号和槽机制  public:  // 构造函数，explicit关键字防止隐式转换  explicit MainWindow(QWidget *parent = 0);   // 析构函数  ~MainWindow();  private slots:  // 私有槽函数，用于处理UI按钮点击事件  void on_btn_openConsole_clicked(); // 打开控制台按钮点击事件处理  void on_btn_send_clicked(); // 发送按钮点击事件处理  void on_btn_clearRecv_clicked(); // 清空接收区按钮点击事件处理  void on_btn_clearSend_clicked(); // 清空发送区按钮点击事件处理  void readData(); // 读取串口数据  private:  // Ui类的指针，用于访问UI元素  Ui::MainWindow *ui;   // QSerialPort类的指针，用于串口通信  QSerialPort *serial;  
};  #endif // MAINWINDOW_H // 结束头文件保护

#include "mainwindow.h"  
#include "ui_mainwindow.h"  // 定义一个静态常量字符串，用于表示“不可用”或“无数据”的情况  
static const char blankString[] = QT_TRANSLATE_NOOP("SettingsDialog", "N/A");  // MainWindow类的构造函数实现  
MainWindow::MainWindow(QWidget *parent) :  QMainWindow(parent), // 调用基类的构造函数  ui(new Ui::MainWindow) { // 初始化UI类的指针  ui->setupUi(this); // 设置UI界面  // 初始化串口类的指针  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(); // 获取序列号  // 将串口的相关信息添加到列表中，如果信息为空则使用blankString代替  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);  // 将串口名称作为第一项，其余信息作为关联数据添加到ComboBox中  ui->comboBox_serialPort->addItem(list.first(), list);  }  // 添加一个自定义选项到串口ComboBox中  ui->comboBox_serialPort->addItem(tr("custom"));  // 设置波特率的ComboBox选项  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"));  // 设置数据位的ComboBox选项  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); // 默认选择8数据位  // 设置奇偶校验位的ComboBox选项  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);  // 设置停止位的ComboBox选项  ui->comboBox_stopBit->addItem(QStringLiteral("1"), QSerialPort::OneStop);  ui->comboBox_stopBit->addItem(QStringLiteral("2"), QSerialPort::TwoStop);  // 设置流控的ComboBox选项  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::~MainWindow() {  delete ui; // 释放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)) {  // 禁用串口配置相关的ComboBox  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("关闭串口"));  // 连接串口的readyRead信号到readData槽函数  connect(serial, &QSerialPort::readyRead, this, &MainWindow::readData);  }  } else {  // 关闭串口  serial->close(); // 关闭串口连接  // 重新启用串口配置相关的ComboBox  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() {  // 将发送文本框中的内容以Latin1编码写入串口  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); // 将读取到的数据追加到字符串中（注意：这里tr的使用可能是不必要的，除非需要翻译字节数组的内容）  ui->textEdit_recv->clear(); // 清空接收文本框的内容  ui->textEdit_recv->append(str); // 将更新后的字符串添加到接收文本框中  }  
}