Qt 实战：手把手教你打造高性能串口调试助手

串口通信在嵌入式开发、硬件调试中扮演着至关重要的角色。一个好用的串口助手，能够极大地提高我们的工作效率。市面上虽然有很多串口助手，但要么功能单一，要么界面简陋，要么收费高昂。因此，使用 Qt 开发一款功能强大、界面友好的串口助手，就成为了很多开发者的选择。本文将从底层原理到代码实现，一步步带你完成这个项目，并且分享一些实战避坑经验。

串口通信基础：从物理层到数据层

在着手编写 Qt 代码之前，我们需要先了解串口通信的基本原理。串口通信是一种异步串行通信方式，数据一位一位地在传输线上发送和接收。涉及到物理层、协议层和数据层。

• 物理层： 规定了通信的物理接口标准，例如 RS-232、RS-485 等。常见的参数包括波特率（Baud Rate）、数据位（Data Bits）、停止位（Stop Bits）和校验位（Parity）。波特率决定了每秒传输的比特数，常见的波特率有 9600、115200 等。数据位通常是 8 位，停止位可以是 1 位或 2 位，校验位用于检测数据传输的错误。
• 协议层： 协议层规定了数据传输的格式和控制方式。常见的协议有 Modbus、自定义协议等。协议层需要定义起始位、结束位、地址位、功能码、数据位和校验位等。
• 数据层： 数据层是实际传输的数据内容。根据不同的应用场景，数据层可以包含各种类型的数据，例如传感器数据、控制指令等。

理解这些底层原理，有助于我们在开发过程中更好地处理各种异常情况，例如数据接收错误、通信超时等。

Qt 串口通信核心类：QSerialPort 和 QSerialPortInfo

Qt 提供了 QSerialPort 和 QSerialPortInfo 类来简化串口通信的开发。QSerialPort 类用于控制串口的打开、关闭、读写等操作。QSerialPortInfo 类用于获取系统中可用的串口信息。

1. 获取可用串口列表

#include <QSerialPortInfo>
#include <QDebug>

void getAvailablePorts() {
    QList<QSerialPortInfo> portList = QSerialPortInfo::availablePorts();
    for (const QSerialPortInfo &portInfo : portList) {
        qDebug() << "Port Name: " << portInfo.portName();
        qDebug() << "Description: " << portInfo.description();
        qDebug() << "Manufacturer: " << portInfo.manufacturer();
        qDebug() << "Serial Number: " << portInfo.serialNumber();
        qDebug() << "System Location: " << portInfo.systemLocation();
    }
}

2. 打开和配置串口

#include <QSerialPort>
#include <QDebug>

QSerialPort serialPort;

bool openSerialPort(const QString &portName, int baudRate) {
    serialPort.setPortName(portName); // 设置串口名
    serialPort.setBaudRate(baudRate);   // 设置波特率
    serialPort.setDataBits(QSerialPort::Data8); // 设置数据位
    serialPort.setParity(QSerialPort::NoParity); // 设置校验位
    serialPort.setStopBits(QSerialPort::OneStop); // 设置停止位
    serialPort.setFlowControl(QSerialPort::NoFlowControl); // 设置流控制

    if (serialPort.open(QIODevice::ReadWrite)) { // 以读写方式打开串口
        qDebug() << "Serial port opened successfully!";
        return true;
    } else {
        qDebug() << "Failed to open serial port: " << serialPort.errorString();
        return false;
    }
}

3. 串口数据读写

#include <QSerialPort>
#include <QDebug>

void readData() {
    if (serialPort.isOpen()) {
        QByteArray data = serialPort.readAll(); // 读取所有可用数据
        if (!data.isEmpty()) {
            qDebug() << "Received data: " << data;
            // 在这里处理接收到的数据
        }
    }
}

void writeData(const QByteArray &data) {
    if (serialPort.isOpen()) {
        qint64 bytesWritten = serialPort.write(data); // 写入数据
        if (bytesWritten == data.size()) {
            qDebug() << "Data written successfully!";
        } else {
            qDebug() << "Failed to write data: " << serialPort.errorString();
        }
    }
}

4. 信号与槽机制：处理串口事件

Qt 的信号与槽机制非常适合处理串口事件，例如数据接收、错误发生等。

#include <QSerialPort>
#include <QDebug>
#include <QObject>

class MySerialPortHandler : public QObject {
    Q_OBJECT
public:
    MySerialPortHandler(QObject *parent = nullptr) : QObject(parent) {
        connect(&serialPort, &QSerialPort::readyRead, this, &MySerialPortHandler::handleReadyRead); // 连接 readyRead 信号
        connect(&serialPort, &QSerialPort::errorOccurred, this, &MySerialPortHandler::handleError); // 连接 errorOccurred 信号
    }

public slots:
    void handleReadyRead() {
        QByteArray data = serialPort.readAll();
        qDebug() << "Received data: " << data;
        // 处理接收到的数据
    }

    void handleError(QSerialPort::SerialPortError error) {
        if (error != QSerialPort::NoError) {
            qDebug() << "Serial port error: " << serialPort.errorString();
        }
    }

private:
    QSerialPort serialPort;
};

界面设计：使用 Qt Designer 快速构建 UI

使用 Qt Designer 可以快速构建串口助手的用户界面。可以拖拽控件，例如 QComboBox（用于选择串口）、QPushButton（用于打开/关闭串口、发送数据）、QTextEdit（用于显示接收到的数据）、QLineEdit（用于输入要发送的数据）等。然后，使用 Qt 的信号与槽机制将 UI 控件的事件与后台代码连接起来。

实战避坑经验

1. 线程问题： 串口读写操作应该放在单独的线程中进行，避免阻塞主线程，导致界面卡顿。可以使用 QThread 类创建新的线程，并将 QSerialPort 对象移动到该线程中。
2. 数据接收处理： 串口数据接收可能是不完整的，需要进行缓存和拼接。可以使用 QByteArray 类缓存接收到的数据，并根据协议的起始位和结束位判断数据是否完整。可以使用类似滑动窗口的思路，提高解析效率。
3. 错误处理： 在串口通信过程中，可能会出现各种错误，例如串口不存在、权限不足、数据格式错误等。需要对这些错误进行处理，并向用户显示友好的提示信息。
4. 波特率设置： 不同的设备可能使用不同的波特率。需要在界面上提供波特率选择的功能，并确保选择的波特率与设备一致。很多新手会忽略这个细节，导致无法正常通信。
5. 中文乱码： 串口通信默认使用 ASCII 编码。如果需要传输中文数据，需要使用 UTF-8 或 GBK 等编码方式，并在发送和接收端进行相应的编码转换。注意 QTextEdit 控件的编码设置。

拓展功能：打造更强大的串口助手

• 数据记录： 将接收到的数据记录到文件中，方便后续分析。
• 自动发送： 定时自动发送数据，用于模拟设备的工作状态。
• Modbus 协议支持： 支持 Modbus 协议，方便与 Modbus 设备进行通信。
• 波形显示： 将接收到的数据以波形图的形式显示出来，方便观察数据的变化。
• Lua 脚本支持： 允许用户编写 Lua 脚本来扩展串口助手的功能。

使用 Qt 开发串口助手是一个非常有意义的项目，不仅可以提高我们的开发效率，还可以学习到很多关于串口通信和 Qt 编程的知识。希望本文能够帮助你成功开发出自己的串口助手。