目录
1、简述
QtSerialPort模块是QT5中附加模块的一个模块,为硬件和虚拟的串口提供统一的接口。
串口由于其简单和可靠,目前在像嵌入式系统、机器人等工业中依旧用得很多。使用QtSerialPort模块,开发者可以大大缩短开发串口相关的应用程的周期。
Qt SerialPort提供了基本的功能,包括配置、I/O操作、获取和设置RS-232引脚的信号。
2、配置
串口通信需要添加Qt相关库:
QT += serialport
3、源代码
首先可以利用QSerialPortInfo读取设备相关信息,然后我们用容器把他们装起来,再利用QSerialPort与端口进行输入输出交互。
读取设备信息时,可以这样做:
foreach (const QSerialPortInfo &info, QSerialPortInfo::availablePorts()) {
qDebug() << "Name : " << info.portName();
qDebug() << "Description : " << info.description();
qDebug() << "Manufacturer: " << info.manufacturer();
qDebug() << "Serial Number: " << info.serialNumber();
qDebug() << "System Location: " << info.systemLocation();
}
在设置端口时,可以这样做:
m_serialport= new QSerialPort();
//设置COM口
m_serialport->setPortName(ui->comboBox->currentText());
//设置波特率和读写方向
m_serialport->setBaudRate(QSerialPort::Baud9600,QSerialPort::AllDirections);
//数据位为8位
m_serialport->setDataBits(QSerialPort::Data8);
//无流控制
m_serialport->setFlowControl(QSerialPort::NoFlowControl);
//无校验位
m_serialport->setParity(QSerialPort::NoParity);
//一位停止位
m_serialport->setStopBits(QSerialPort::OneStop);
//先关串口,再打开,可以保证串口不被其它函数占用。
m_serialport->close();
//以可读写的方式打开串口
if(m_serialport->open(QIODevice::ReadWrite))
{
//读取数据 串口读取出来的数据类型 是QByteArray 不是QString
m_requestData = m_serialport->readAll();
}
4、QSerialPort介绍
QSerialPort提供了访问串口的接口函数。使用辅助类QSerialPortInfo可以获取可用的串口信息。将QSerialPortInfo辅助类对象做为参数,使用setPort()或setPortName()函数可以设置要访问的串口设备。
设置好端口后,可以使用open()函数以只读、只写或读写的模式打开使用。
注意,串口使用独占方式打开。使用close()函数关闭串口并且取消IO操作。
串口成功打开后,QSerialPort会尝试确定串口的当前配置并初始化。可以使用setBaudRate()、setDataBits()、setParity()、setStopBits()和setFlowControl()函数重新配置端口设置。
有一对名为QSerialPort::dataTerminalReady、QSerialPort::requestToSend的属性
QSerialPort提供了中止正在调用线程直到信号触发的一系列函数。这些函数用于阻塞串口。
waitForReadyRead():阻塞调用,直到有新的数据可读
waitForBytesWritten():阻塞调用,直到数据以及写入串口
阻塞串口编程与非阻塞串口编程完全不同。阻塞串口不会要求时间循环并且通常会简化代码。然而,在GUI程序中,为了避免冻结用户界面,阻塞串口编程只能用于非GUI线程。
QSerialPort也能使用QTextStream和QDataStream的流操作符。在试图使用流操作符>>读时,需要确保有足够可用的数据。
5、QSerialPort成员函数
//构造函数
QSerialPort::QSerialPort(QObject *parent = Q_NULLPTR)
QSerialPort::QSerialPort(const QString &name, QObject *parent = Q_NULLPTR)
QSerialPort::QSerialPort(const QSerialPortInfo &serialPortInfo, QObject *parent = Q_NULLPTR)
//如果当前没有数据可读,返回true
[virtual] bool QSerialPort::atEnd() const
//波特率改变后,信号触发
[signal] void QSerialPort::baudRateChanged(qint32 baudRate, QSerialPort::Directions directions)
//返回可读数据的字节数
[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)
6、参考示例(串口示例)
main.cpp代码
#include "mainwindow.h"
#include <QApplication>
int main(int argc, char *argv[])
{
QApplication a(argc, argv);
MainWindow w;
w.show();
return a.exec();
}
mainwindows.h代码参考如下:
#ifndef MAINWINDOW_H
#define MAINWINDOW_H
#include <QMainWindow>
#include <QtSerialPort/QSerialPort>
#include <QtSerialPort/QSerialPortInfo>
#include <QList>
#include <QDebug>
namespace Ui {
class MainWindow;
}
class MainWindow : public QMainWindow
{
Q_OBJECT
public:
explicit MainWindow(QWidget *parent = 0);
~MainWindow();
private slots:
void on_btn_openConsole_clicked();
void on_btn_send_clicked();
void on_btn_clearRecv_clicked();
void on_btn_clearSend_clicked();
void readData();
private:
Ui::MainWindow *ui;
QSerialPort *serial;
};
#endif // MAINWINDOW_H
mainwindows.cpp代码
#include "mainwindow.h"
#include "ui_mainwindow.h"
static const char blankString[] = QT_TRANSLATE_NOOP("SettingsDialog", "N/A");
MainWindow::MainWindow(QWidget *parent) :
QMainWindow(parent),
ui(new Ui::MainWindow)
{
ui->setupUi(this);
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();
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);
ui->comboBox_serialPort->addItem(list.first(), list);
}
ui->comboBox_serialPort->addItem(tr("custom"));
//设置波特率
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"));
//设置数据位
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);
//设置奇偶校验位
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);
//设置停止位
ui->comboBox_stopBit->addItem(QStringLiteral("1"), QSerialPort::OneStop);
ui->comboBox_stopBit->addItem(QStringLiteral("2"), QSerialPort::TwoStop);
//添加流控
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()
{
//delete serial;
delete 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))
{
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("关闭串口"));
//信号与槽函数关联
connect(serial, &QSerialPort::readyRead, this, &MainWindow::readData);
}
}
else
{
//关闭串口
//serial->clear();
serial->close();
//serial->deleteLater();
//恢复设置功能
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()
{
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);
ui->textEdit_recv->clear();
ui->textEdit_recv->append(str);
}
}
7、效果
8、分享
示例代码已上传CSDN:http://download.csdn.net/detail/u014597198/9834104