qt串口通信教程，初学者参考

yafeilinux 作品 www.yafeilinux.com 开源，共享，自由

第 1 页，共 17 页

Qt 串口通信专题教程

前言

去年我使用 Qt 编写串口通信程序时，将自己的学习过程写成了教程（Qt 编写串口通信

程序全程图文讲解），但是由于时间等原因，我只实现了 Windows 下的串口通信，并没有去

图为 Windows 下的 Wincom 软件 图为 Linux 下的 Lincom 软件

教程概述

该教程分三部分讲述，第一部分讲解 qextserialport 类的一些东东；第二部分讲解在

Windows 下使用 qextserialport 类实现串口通信的方法，这里将讲述两种不同的方法；第三部

分讲解在 Linux 下利用 qextserialport 类实现串口通信的方法。

在这个教程中我们更注重知识的讲解，而不是界面的设计。关于界面和其他应用问题，

深对本教程知识的理解。

yafeilinux 作品 www.yafeilinux.com 开源，共享，自由

第 2 页，共 17 页

第一部分 Qextserialport 类介绍

在 Qt 中并没有特定的串口控制类，现在大部分人使用的是第三方写的 qextserialport 类，我

们这里也使用了该类。

一、文件下载

文件下载地址：

下面分别介绍：

（1）doc 文件夹中的文件内容是 QextSerialPort 类和 QextBaseType 的简单的说明，我们可以

使用记事本程序将它们打开。

（2）examples 文件夹中是几个例子程序，可以看一下它的源码，不过想运行它们好像会出

很多问题啊。

（3）html 文件夹中是 QextSerialPort 类的使用文档。

（4）然后就是剩下的几个文件了。其中 qextserialenumerator.cpp 及 qextserialenumerator.h 文

件中定义的 QextSerialEnumerator 类是用来获取平台上可用的串口信息的。不过，这个类好

像并不怎么好用，而且它不是我们关注的重点，所以下面就不再介绍它了。

yafeilinux 作品 www.yafeilinux.com 开源，共享，自由

第 3 页，共 17 页

类就是我们上面所说的那个，它是所有这些类的子类，是最高的抽象，它屏蔽了平台特征，

使得在任何平台上都可以使用它。

2.几个类的简单介绍。

下面是这几个类的关系图。

还有一个 QextBaseType 类，其实它只是一个标识，没有具体的内 容，它用来表示

Win_QextSerialPort 或 Posix_QextSerialPort 中的一个类，因为在 QextSerialPort 类中使用了

条件编译，所以 QextSerialPort 类既可以继承自 Win_QextSerialPort 类，也可以继承自

Posix_QextSerialPort 类，所以使用了 QextBaseType来表示。这一点我们可以在 qextserialport.h

文件中看到。再说 QextSerialPort 类，其实它只是为了方便程序的跨平台编译，使用它可以

在不同的平台上，根据不同的条件编译继承不同的类。所以它只是一个抽象，提供了几个构

造函数而已，并没有具体的内容。在 qextserialport.h 文件中的条件编译内容如下：

/*POSIX CODE*/

#ifdef _TTY_POSIX_

#include "posix_qextserialport.h"

#endif

所以，其实我们没有必要使用这个类，直接使用 Win_QextSerialPort 或 Posix_QextSerialPort

就可以了。当然如果你想使用这个类，实现同样的源程序可以直接在 Windows 和 Linux 下

编译运行，那么一定要注意在 Linux 下这里需要添加 #define _TTY_POSIX_ 。而我们这里

为了使得程序更明了，所以没有使用该类，下面也就不再介绍它了。

QextSerialBase 类继承自 QIODevice 类，它提供了操作串口所必需的一些变量和函数等，

而 Win_QextSerialPort和 Posix_QextSerialPort 均继承自QextSerialBase类，Win_QextSerialPort

类添加了 Windows 平台下操作串口的一些功能，Posix_QextSerialPort 类添加了 Linux 平台

yafeilinux 作品 www.yafeilinux.com 开源，共享，自由

第 4 页，共 17 页

3.在 QextSerialBase 类中还涉及到了一个枚举变量 QueryMode。

它有两个值 Polling 和 EventDriven 。QueryMode 指的是读取串口的方式，下面我们称

为查询模式，我们将 Polling 称为查询方式 Polling，将 EventDriven 称为事件驱动方式。

事件驱动方式 EventDriven 就是使用事件处理串口的读取，一旦有数据到来，就会发出

readyRead()信号，我们可以关联该信号来读取串口的数据。在事件驱动的方式下，串口的读

而查询方式 Polling 则不同，读写函数是同步执行的，信号不能工作在这种模式下，而

且有些功能也无法实现。但是这种模式下的开销较小。我们需要自己建立定时器来读取串口

在 Windows 下是：

qextserialbase.cpp 和 qextserialbase.h 以及 win_qextserialport.cpp 和 win_qextserialport.h

在 Linux 下是：

qextserialbase.cpp 和 qextserialbase.h 以及 posix_qextserialport.cpp 和 posix_qextserialport.h

而在 Windows 下我们可以使用事件驱动 EventDriven 方式，也可以使用查询 Polling 方

式，但是在 Linux 下我们只能使用查询 Polling 方式。

yafeilinux 作品 www.yafeilinux.com 开源，共享，自由

第 5 页，共 17 页

我们的环境是 Windows xp，Qt4.6.3 及 Qt Creator2.0。

2.添加文件。

我们将那四个文件添加到工程文件夹中。如下图。

然后我们将这四个文件添加到工程中，在 Qt Creator 的工程列表中的工程文件夹上点击鼠标

右键，在弹出的菜单中选择“Add Existing Files”菜单。如下图。