Qt Library库系列----Serial串口

前言

        每次写串口相关的功能时，总是需要重新写或者复制原来写过的文件，容易出错不说，这也不是码农的风格，所以还是得有一套自己得代码库，方便调用，又能保持神秘感。

一、开发需求

        1.有个实例类；

        2.设置串口参数：COM,Baudrate，databits等；

        3.打开，关闭；

        4.发送，接收功能，而且数据类型比较多；

        5.bytearry和hex转换；

        6.定时发送（非必要）；

        7.获取所有串口；

        8.串口当前状态；

二、工作流

三、实现过程

        1.创建lib，名称为 Serialportlibrary

2.pro中添加 QT += serialport  .h中添加引用

3.定义参数（.h）

    QSerialPort *m_serialPort;QTimer *m_timer;QByteArray m_timerSendData;

4.修改类（.cpp），AutoRead是手动添加的，用来区分是否自动读取数据，还是可自定义读取数据。

Serialportlibrary::Serialportlibrary(bool AutoRead, QObject *parent):QObject(parent)
{m_serialPort = new QSerialPort(this);//实例化串口m_timer = new QTimer(this);//实例化timerif(AutoRead) connect(m_serialPort, &QSerialPort::readyRead, this, &Serialportlibrary::handleReadyRead);connect(m_timer, &QTimer::timeout, this, &Serialportlibrary::handleTimeout);
}

5.析构，主要是关闭串口，否则连续操作会有问题。

Serialportlibrary::~Serialportlibrary()
{if (m_serialPort->isOpen()) {m_serialPort->close();}
}

6.获取所有串口，并返回一个QString的List格式，可以直接用Combobox调用。

QList<QString> Serialportlibrary::getSerialPorts()
{QList<QString>  stringlist;QList<QSerialPortInfo> portInfoList;portInfoList = QSerialPortInfo::availablePorts();for(const QSerialPortInfo &portinfo:portInfoList){stringlist.append(portinfo.portName());}return stringlist;
}

7.设置Serial参数，只有设置，没有打开操作，返回状态（内部可以判断，但是我直接判断是否能打开串口，这里默认true）。

bool Serialportlibrary::setSerialPortParams(const QString &portName, qint32 baudRate,QSerialPort::DataBits dataBits,QSerialPort::Parity parity,QSerialPort::StopBits stopBits,QSerialPort::FlowControl flowControl)
{m_serialPort->setPortName(portName);m_serialPort->setBaudRate(baudRate);m_serialPort->setDataBits(dataBits);m_serialPort->setParity(parity);m_serialPort->setStopBits(stopBits);m_serialPort->setFlowControl(flowControl);return true;
}

8.打开串口，返回bool值

bool Serialportlibrary::openSerialPort()
{if (m_serialPort->open(QIODevice::ReadWrite)) {return true;}return false;
}

9.关闭串口，要判断是否open，ClearBuffer在后面（可以和open放在一起，但是尽量结构简单化，愿意的话可以自己二次封装）。

void Serialportlibrary::closeSerialPort()
{if (m_serialPort->isOpen()) {ClearBuffer();m_serialPort->close();}
}

10.发送，共2种方式。

qint64 Serialportlibrary::sendData(const QByteArray &data)
{if (m_serialPort->isOpen()) {return m_serialPort->write(data);}return -1;
}qint8 Serialportlibrary::sendData(char data)
{if(m_serialPort->isOpen()){return m_serialPort->write(&data,1);}return -1;
}

11.转换，注意这个转换是自定义的，2个char中间添加空格，备用的方法，在库里没用到，在外面可以调用。

QByteArray Serialportlibrary::hexStringToByteArray(const QString &hexString)
{QByteArray byteArray;QString trimmedHex = hexString.trimmed();for (int i = 0; i < trimmedHex.length(); i += 2) {QString byteString = trimmedHex.mid(i, 2);bool ok;char byte = static_cast<char>(byteString.toInt(&ok, 16));if (ok) {byteArray.append(byte);}}return byteArray;
}QString Serialportlibrary::byteArrayToHexString(const QByteArray &byteArray)
{return byteArray.toHex(' ').toUpper();
}

12.接收，如果定义AutoRead，则自动发射信号，否则需要手动读取，接收返回值

//自动读取
void Serialportlibrary::handleReadyRead()
{QByteArray data = m_serialPort->readAll();emit dataReceived(data);
}
//手动读取
QByteArray Serialportlibrary::ReadData(uint8_t size)
{if(size != 0)return m_serialPort->read(size);elsereturn  m_serialPort->readAll();
}

13.定时发送

//设置发送事件间隔
void Serialportlibrary::setTimerInterval(int interval)
{m_timer->setInterval(interval);
}//开始发送
void Serialportlibrary::startTimerSend(const QByteArray &data)
{m_timerSendData = data;m_timer->start();
}//停止发送
void Serialportlibrary::stopTimerSend()
{m_timer->stop();
}//触发发送
void Serialportlibrary::handleTimeout()
{sendData(m_timerSendData);
}

14.清除buffer，在关闭Serial时调用，防止再打开后还有上次的数据。

void Serialportlibrary::ClearBuffer()
{if(m_serialPort->isOpen())m_serialPort->clear();
}

15.串口是否打开检测

bool Serialportlibrary::ComIsOpen()
{if(m_serialPort->isOpen())return true;return false;
}

四、结尾

        这就完成了串口的基本功能与需求，上层需要自己去进行二次开发，库只保留最基本最通用的功能。

        本人想创建一些基础的开源库使用，大家可以使用，也可以帮忙完善。

generaltoolshttps://gitee.com/klein_tools/general_tools