简介
QtSerialPort模块是Qt5库的附加部分,为硬件和虚拟的串口提供了统一的接口。注意:该模块也增加了对Qt4的支持。
串口由于其简单和可靠,目前在像嵌入式系统,机器人等工业中依旧用得很多。使用QtSerialPort模块,开发者可以大大缩短开发串口相关的应用程序的周期。使用QtSerialPort模块最初是来源于第三方库QSerialDevice(2.0分支),现在QtSerialPort已经移到了https://codereview.qt-project.org/代码库上。
功能介绍
目前,该模块API只包括两个类:Serial和SerialPortInfo。
【SerialPort】
SerialPort是该模块的基础类,提供了一系列基础的方法和属性来访问串口资源。
SerialPort类对操作系统的支持如下:
对Symbian平台的支持只是部分的,是因为缺乏开发者,因为诺基亚已经决定放弃该平台,Qt5也不会包括对该平台的支持。
【SerialPortInfo】
SerialPortInfo是一个帮助类。它提供了系统上可用的串口的信息。
SerialPortInfo类对操作系统的支持如下:
对Symbian平台的支持只是部分的,是因为缺乏开发者,因为诺基亚已经决定放弃该平台,Qt5也不会包括对该平台的支持。
源代码
目前,QtSerialPort相关的源代码都可以通过浏览器浏览:https://qt.gitorious.org/qt/qtserialport
也可以通过git下载:git clone git://gitorious.org/qt/qtserialport.git
编译和安装
注意:最好选择影子构建,因为这样的话构建目录和源代码目录是分开的,这样就允许你保持源代码目录是干净的。
编译步骤:
1、配置编译环境
*安装Perl
*确保环境变量设置正确:Qt4/Qt5;编译器;Perl
*创建编译目录:跟源代码目录同级
/
|- /serialport-src
|- /serialport-build
2、Perl只是在Qt5的时候才需要,Qt4的情况下可以不配置
3、使用如下推荐步骤在Qt4/Qt5下编译和安装QtSerialPort库
cd serialport-build
qmake ../serialport-src/qtserialport.pro
make [or 'nmake' for MSVC compiler, or 'mingw32-make' for MinGW compiler]
make install [or 'nmake install' for MSVC compiler, or 'mingw32-make install' for MinGW compiler]
注意:在*nix系统上,你可能需要超级用户的权限才能执行安装这一步骤:
sudo make install
使用方法
QtSerialPort提供相应的库文件,我们在编写自己的应用程序的时候可以使用这些库,使用方法如下:
Qt4
CONFIG += serialport
Qt5
QT += serialport
然后在工程中包含相应的头文件就行:
...
#include <QtSerialPort/QSerialPort>
#include <QtSerialPort/QSerialPortInfo>
...
示例代码
include <QtCore/QCoreApplication>
#include <QtCore/QDebug>
#include <QtSerialPort/QSerialPort>
#include <QtSerialPort/QSerialPortInfo>
QT_USE_NAMESPACE
int main(int argc, char *argv[])
{
QCoreApplication a(argc, argv);
// Example use QSerialPortInfo
foreach (const QSerialPortInfo &info, QSerialPortInfo::availablePorts()) {
qDebug() << "Name : " << info.portName();
qDebug() << "Description : " << info.description();
qDebug() << "Manufacturer: " << info.manufacturer();
// Example use QSerialPort
QSerialPort serial;
serial.setPort(info);
if (serial.open(QIODevice::ReadWrite))
serial.close();
}
return a.exec();
}
注意:CONFIG += serialport必须是.pro文件中的第一行或者第二行。
实际操作
1、代码下载:
2、编译:
3、安装:
sudo make install后,我的系统上因为设置了Qt5的环境变量:
头文件安装到了:/opt/Qt5.0.1/5.0.1/gcc/include/QtSerialPort
库文件安装到了:/opt/Qt5.0.1/5.0.1/gcc/lib
4、测试,运行自带的examples:
4、使用QSerialPort库
(1)创建一个Qt Console应用程序
修改.pro文件,添加serialport库,如下:
(2)修改main函数
如下:添加QtSerialPort库的相应头文件,并实现简单的代码:
include <QCoreApplication>
#include <QtCore/QDebug>
#include "QSerialPort"
#include "QSerialPortInfo"
int main(int argc, char *argv[])
{
QCoreApplication a(argc, argv);
// Example use QSerialPortInfo
foreach (const QSerialPortInfo &info, QSerialPortInfo::availablePorts()) {
qDebug() << "Name : " << info.portName();
qDebug() << "Description : " << info.description();
qDebug() << "Manufacturer: " << info.manufacturer();
// Example use QSerialPort
QSerialPort serial;
serial.setPort(info);
if (serial.open(QIODevice::ReadWrite))
serial.close();
}
return a.exec();
}
(3)编译后运行如下: