1.项目地址
https://github.com/zhangjiechina001/SerialPortTool
2.使用注意
- 串口的所有参数波特率、数据位、校验位、停止位、控制流都需要设置正确,设置错了有时会连接上但是传输的数据会很奇怪,有时直接连接不上了
3.串口通讯参数解释
串口通讯(Serial Communication)是一种逐位传输数据的通信方式,常见于计算机与外部设备(如传感器、微控制器等)之间的通信。串口通讯的参数包括以下几个常见项:
-
波特率(Baud Rate):
波特率表示每秒传输的符号数(位元数),即每秒钟可以传输多少个比特。常见的波特率有9600、19200、115200等。发送端和接收端必须使用相同的波特率。 -
数据位(Data Bits):
数据位表示每次传输的实际数据位数,通常是5到8位。最常见的是8位数据位(即一个字节),用于传输一个完整的字符。 -
停止位(Stop Bits):
停止位用于标志一帧数据的结束,常见的停止位为1位或2位。停止位的作用是给接收端一些时间来处理接收到的数据,并为下一帧做准备。 -
校验位(Parity Bit):
校验位用于检测传输过程中是否出现错误。常见的校验方式有:
无校验(None):不使用校验位。
偶校验(Even Parity):如果传输的数据位中“1”的个数是偶数,校验位为0;否则为1。
奇校验(Odd Parity):如果传输的数据位中“1”的个数是奇数,校验位为0;否则为1。 -
流控制(Flow Control):
流控制用于控制数据的传输速率,确保接收方有足够的时间处理数据。常见的流控制方式包括:
无流控制(None):不进行流控制。
软件流控制(XON/XOFF):通过特殊的控制字符(XON 和 XOFF)来控制数据的传输。
硬件流控制(RTS/CTS):使用额外的控制线(RTS 和 CTS)来协调数据的发送和接收。
起始位(Start Bit): -
起始位用于标志数据帧的开始,通常为1位。在传输数据之前,发送端会发送起始位,接收端以此为标志开始接收数据。
这些参数通常需要在通信的双方(如计算机和串口设备)之间进行配置,以确保数据能够正确传输。如果参数不一致,可能会导致数据丢失或接收错误。
4.核心类
头文件
#ifndef SERIALPORTWRAP_H
#define SERIALPORTWRAP_H
#pragma execution_character_set("utf-8")
#include <QObject>
#include <QSerialPort>
class SerialPortWrap : public QObject
{
Q_OBJECT
public:
static QMap<QString,QSerialPort::Parity> getParityMap();
static QMap<QString,QSerialPort::DataBits> getDataMap();
static QMap<QString,QSerialPort::StopBits> getStopMap();
static QMap<QString, QSerialPort::FlowControl> getFlowMap();
public:
explicit SerialPortWrap(QObject *parent = nullptr);
void setSerialPort(QSerialPort *port);
bool sendNoReply(QByteArray data);
bool sendReply(QByteArray data, QByteArray &rec);
signals:
void receivedData(QByteArray data);
public slots:
private:
QSerialPort *_serial=nullptr;
QList<QByteArray> _recList;
void waitMs(int ms);
private slots:
void onError(QSerialPort::SerialPortError err);
void onReadyReady();
};
#endif // SERIALPORTWRAP_H
cpp
#include <QMap>
#include <QDebug>
#include <QEventLoop>
#include <QElapsedTimer>
#include <QTimer>
#include "serialportwrap.h"
QMap<QString, QSerialPort::Parity> SerialPortWrap::getParityMap()
{
QMap<QString,QSerialPort::Parity> parityMap={
{"NoPraity",QSerialPort::NoParity},
{"EvenParity",QSerialPort::EvenParity},
{"OddParity",QSerialPort::OddParity},
{"SpaceParity",QSerialPort::SpaceParity},
{"MarkParity",QSerialPort::MarkParity}
};
return parityMap;
}
QMap<QString, QSerialPort::DataBits> SerialPortWrap::getDataMap()
{
QMap<QString,QSerialPort::DataBits> dataMap={
{"Data5",QSerialPort::Data5},
{"Data6",QSerialPort::Data6},
{"Data7",QSerialPort::Data7},
{"Data8",QSerialPort::Data8}
};
return dataMap;
}
QMap<QString, QSerialPort::StopBits> SerialPortWrap::getStopMap()
{
QMap<QString,QSerialPort::StopBits> stopMap={
{"OneStop",QSerialPort::OneStop},
{"OneAndHalfStop",QSerialPort::OneAndHalfStop},
{"TwoStop",QSerialPort::TwoStop}
};
return stopMap;
}
QMap<QString, QSerialPort::FlowControl> SerialPortWrap::getFlowMap()
{
QMap<QString,QSerialPort::FlowControl> flowMap={
{"NoFlowControl",QSerialPort::NoFlowControl},
{"HardwareControl",QSerialPort::HardwareControl},
{"SoftwareControl",QSerialPort::SoftwareControl},
{"UnknownFlowControl",QSerialPort::UnknownFlowControl}
};
return flowMap;
}
SerialPortWrap::SerialPortWrap(QObject *parent) : QObject(parent)
{
}
void SerialPortWrap::setSerialPort(QSerialPort *port)
{
_serial=port;
connect(_serial,&QSerialPort::errorOccurred,this,&SerialPortWrap::onError);
connect(_serial,&QSerialPort::readyRead,this,&SerialPortWrap::onReadyReady);
}
bool SerialPortWrap::sendNoReply(QByteArray data)
{
_recList.clear();
return _serial->write(data)!=-1;
}
bool SerialPortWrap::sendReply(QByteArray data,QByteArray &rec)
{
_recList.clear();
_serial->write(data);
QElapsedTimer ela;
ela.start();
while(_recList.count()==0)
{
waitMs(100);
if(ela.elapsed()>3000)
{
throw QString("%1 time out").arg(_serial->portName());
}
}
waitMs(50);
QByteArray arr;
for(int i=0;i<_recList.count();i++)
{
arr.append(_recList.at(i));
}
rec=arr;
return true;
}
void SerialPortWrap::waitMs(int ms)
{
QEventLoop loop;
QTimer::singleShot(ms, &loop, &QEventLoop::quit); // 设置定时器,在超时时退出事件循环
loop.exec(); // 进入事件循环
}
void SerialPortWrap::onError(QSerialPort::SerialPortError err)
{
qDebug()<<__FUNCTION__<<__LINE__<<_serial->portName()<<_serial->errorString();
}
void SerialPortWrap::onReadyReady()
{
QByteArray arr=_serial->readAll();
_recList.append(arr);
emit receivedData(arr);
}