VC++实现串口通信基础教程

最新推荐文章于 2026-05-09 06:25:52 发布

原创最新推荐文章于 2026-05-09 06:25:52 发布 · 1.8k 阅读

本内容遵循CC 4.0 BY-SA版权协议

简介：串口通信是计算机与外部设备间交换数据的一种方式，在嵌入式系统和物联网中非常重要。VC++（Visual C++）是强大的C++开发环境，专为Windows平台设计。本教程将通过“VC++串口上位机简单例程”，深入讲解如何使用VC++进行串口通信编程。包括Windows API串口编程、使用MFC进行串口操作，以及利用第三方库Boost.Asio简化开发过程。教程还会介绍如何打开和关闭串口，配置串口参数，以及发送接收数据等基本功能。 VC++串口上位机简单例程

1. 串口通信概念

在计算机和通讯设备的历史中，串口通信长期以来扮演了至关重要的角色。串行通信，通常称为串口通信，是一种异步数据传输方式，它通过单一的信号线来发送和接收数据。串口通信允许设备之间通过简单的电线连接进行通讯，这使得它在早期的计算机外设连接和远程通信设备中极为普遍。

串口通信按传输速率可分为低速和高速，按工作方式可分为异步和同步。异步串口通信不需要时钟信号，每个数据帧的开始用起始位标记，数据传输结束后有停止位指示，而同步串口通信则需要一个额外的时钟信号来保证数据的同步接收。随着技术的发展，虽然USB和其他高速通信标准变得越来越流行，串口依然在某些特定领域，如工业控制和嵌入式系统中，发挥着不可替代的作用。

在接下来的章节中，我们将深入探讨Windows API以及MFC和Boost.Asio库下如何进行串口编程，以及如何设置串口参数和处理数据发送与接收。我们会从基础开始，逐步深入到具体的编程实践，使你能够掌握串口通信的核心技能。

2. Windows API串口编程基础

2.1 串口编程的基本步骤

2.1.1 打开串口

在Windows中，使用串口进行通信的第一步是打开一个串口设备。可以使用Win32 API中的CreateFile函数来打开串口。串口设备通常位于 COM 端口，例如 COM1 、 COM2 等。下面是一个打开串口的基本示例代码：

HANDLE hSerial = CreateFile("COM1", GENERIC_READ | GENERIC_WRITE, 0, 0, OPEN_EXISTING, FILE_ATTRIBUTE_NORMAL, 0);
if (hSerial == INVALID_HANDLE_VALUE) {
    // Handle error - unable to open the serial port.
}

上述代码尝试打开COM1串口进行读写操作。如果 CreateFile 返回的是 INVALID_HANDLE_VALUE ，则表示打开串口失败，需要进行错误处理。

2.1.2 配置串口参数

打开串口之后，接下来需要配置串口的相关参数。这些参数包括波特率、数据位、停止位和校验位等，它们定义了串口通信的协议。在Windows中，可以使用 SetCommState 函数配合 DCB 结构体来配置串口参数。

2.1.3 读写串口数据

串口打开并配置好后，就可以进行数据的读写操作了。 ReadFile 函数用于从串口读取数据，而 WriteFile 函数用于向串口写入数据。这两个函数都是异步的，不过也可以进行同步操作。

DWORD bytesRead;
BOOL readResult = ReadFile(hSerial, buffer, sizeof(buffer), &bytesRead, NULL);

上述代码尝试从串口读取数据到 buffer 中。如果操作成功， bytesRead 将会包含读取的数据字节数。

2.1.4 关闭串口

完成数据传输后，必须关闭串口以释放系统资源。可以使用 CloseHandle 函数来关闭串口：

CloseHandle(hSerial);

2.1.2 配置串口参数详解

配置串口参数时，需要根据通信需求设置正确的通信参数。在Windows中，这可以通过 DCB 结构体实现。以下是 DCB 结构体的关键字段：

DCB dcbSerialParams = {0};
dcbSerialParams.DCBlength = sizeof(dcbSerialParams);

if (!GetCommState(hSerial, &dcbSerialParams)) {
    // Handle error - unable to get the serial port's current state.
}

dcbSerialParams.BaudRate = CBR_9600; // 设置波特率为9600
dcbSerialParams.ByteSize = 8;         // 数据位为8位
dcbSerialParams.StopBits = ONESTOPBIT; // 设置为一个停止位
dcbSerialParams.Parity = NOPARITY;    // 无校验位

if (!SetCommState(hSerial, &dcbSerialParams)) {
    // Handle error - unable to set the serial port's parameters.
}

上述代码首先获取当前串口的状态，然后配置波特率、数据位、停止位和校验位等参数，并应用到串口。

2.1.3 读写串口数据详解

在实际开发中，我们经常需要向串口写入数据，或者从串口读取数据。以下是使用 WriteFile 和 ReadFile 进行数据读写的示例代码：

// 向串口写入数据
const char *data = "Hello, Serial Port!";
BOOL writeResult = WriteFile(hSerial, data, strlen(data), NULL, NULL);

// 从串口读取数据
char buffer[1024];
DWORD bytesRead;
BOOL readResult = ReadFile(hSerial, buffer, sizeof(buffer), &bytesRead, NULL);

WriteFile 函数将数据写入串口，返回值为 TRUE 表示成功。 ReadFile 函数从串口读取数据，成功时返回 TRUE ，并且 bytesRead 将提供读取的数据字节数。

2.1.4 关闭串口详解

关闭串口是一个非常重要的操作，它将确保所有资源被正确释放，避免资源泄露。关闭串口的操作应按照打开串口的逆顺序进行，使用 CloseHandle 函数来完成。代码示例如下：

if (hSerial != INVALID_HANDLE_VALUE) {
    CloseHandle(hSerial);
    hSerial = INVALID_HANDLE_VALUE;
}

2.2 Windows API串口操作函数详解

Windows API为串口编程提供了丰富的函数支持。下面是几个常用的函数和它们的详细解释：

2.2.1 CreateFile函数

CreateFile 是Windows API中的一个核心函数，用于创建或打开文件、串口、管道等。此函数在串口编程中用于打开串口设备。

2.2.2 SetCommState函数

SetCommState 函数用于设置串口的设备控制块（DCB）。DCB结构体包含串口通信的各种参数，如波特率、数据位数、停止位、校验方式等。该函数是配置串口参数的关键。

2.2.3 ReadFile函数

ReadFile 函数用于从已打开的串口设备读取数据。它是一个异步函数，但也可以同步操作。在使用 ReadFile 时需要提供缓冲区来接收数据，并等待函数完成。

2.2.4 WriteFile函数

WriteFile 函数用于向已打开的串口设备写入数据。和 ReadFile 类似， WriteFile 也是一个异步函数，可以同步执行。

在下一章节中，我们将详细介绍如何使用MFC库进行串口编程，以及如何实现串口的异步读写操作和事件处理。

3. MFC串口编程方法

3.1 MFC串口编程的框架

3.1.1 CSerialPort类概述

在MFC（Microsoft Foundation Classes）中， CSerialPort 类是用于处理串口通信的便捷工具。它封装了Windows API中的串口操作，使得开发者可以更加容易地进行串口编程。 CSerialPort 类提供了一套丰富的接口来管理串口的打开、配置、读取、写入和关闭等操作。通过继承自 CObject 类， CSerialPort 为串口通信提供了一种面向对象的解决方案，使得程序结构更加清晰、易于维护。

3.1.2 串口的初始化和关闭

使用 CSerialPort 类进行串口初始化和关闭涉及几个关键的成员函数，包括但不限于 Create 、 Open 、 Close 和 Destroy 。在初始化串口时，首先需要创建一个 CSerialPort 对象实例，然后调用 Create 函数设置串口的名称以及初始化相关的成员变量。接着， Open 函数用于打开指定的串口，并配置必要的参数，如波特率、数据位、停止位和校验位。关闭串口时， Close 函数将停止数据传输并释放资源，最后可以调用 Destroy 来清理 CSerialPort 对象。

// 示例代码：使用CSerialPort类初始化和关闭串口
#include <afxwin.h>
#include <afx控件.h>

// 全局CSerialPort对象
CSerialPort m_SerialPort;

// 初始化串口
BOOL InitializeSerialPort(const CString& portName, UINT baudRate, BYTE byteSize, BYTE stopBits, BYTE parity)
{
    if (!m_SerialPort.Create(portName, baudRate, byteSize, stopBits, parity))
    {
        AfxMessageBox(_T("串口创建失败"));
        return FALSE;
    }
    if (!m_SerialPort.Open())
    {
        AfxMessageBox(_T("串口打开失败"));
        return FALSE;
    }
    return TRUE;
}

// 关闭串口
void CloseSerialPort()
{
    m_SerialPort.Close();
    m_SerialPort.Destroy();
}

在上述代码中， m_SerialPort.Create 和 m_SerialPort.Open 分别用于创建和打开串口，而 m_SerialPort.Close 和 m_SerialPort.Destroy 用于关闭和销毁串口对象。需要特别注意的是，在销毁串口对象之前确保已经关闭了串口，否则可能会造成资源泄露。

3.2 MFC中的异步读写操作

3.2.1 异步读取实现方法

在MFC中，异步读取通过注册消息处理函数来响应串口事件。MFC的串口控件会在有数据到达时触发一个消息（默认是 OnReceive ），程序需要在相应的消息处理函数中读取数据。这涉及到一个消息映射和相应的消息处理函数。

// 消息映射宏
ON_MESSAGE(RM传真接收, OnReceive)

// 消息处理函数
LRESULT CMyDialog::OnReceive(WPARAM wParam, LPARAM lParam)
{
    // 读取串口数据
    BYTE data;
    DWORD dwBytesRead;
    m_SerialPort.Read(&data, 1, dwBytesRead);

    // 处理接收到的数据...
}

// 在初始化函数中启动异步接收
m_SerialPort.AsyncModeTRUE();

在 OnReceive 函数中， m_SerialPort.Read 被用来读取数据。这里使用了异步模式，即当有数据可读时， Read 函数不会阻塞程序运行。异步读取模式下，串口控件会自动将接收到的数据存储在内部缓冲区中，并在接收到新数据时触发 OnReceive 消息。

3.2.2 异步发送实现方法

异步发送数据与异步读取类似，也是通过注册一个消息处理函数来实现的，但这次是响应 OnTransmit 消息。在发送数据前，需要先将数据写入到一个缓冲区中，然后使用 Transmit 函数将数据发送出去。

// 消息映射宏
ON_MESSAGE(RM传真发送, OnTransmit)

// 消息处理函数
LRESULT CMyDialog::OnTransmit(WPARAM wParam, LPARAM lParam)
{
    // 发送数据到串口
    DWORD dwBytesWritten;
    m_SerialPort.Transmit((LPVOID)lParam, dwBytesWritten);

    // 发送完成后的处理...
}

// 在发送函数中准备数据并开始异步发送
void CMyDialog::SendData(LPVOID lpBuf, DWORD dwSize)
{
    m_SerialPort.AsyncModeTRUE();
    m_SerialPort.Transmit(lpBuf, dwSize);
}

在 OnTransmit 函数中，通过调用 Transmit 方法发送数据。通常情况下，数据发送是异步的，但也可以选择同步发送，具体取决于 Transmit 函数的调用方式。

3.3 MFC串口事件处理

3.3.1 事件驱动模型

事件驱动模型是MFC串口编程的核心，它允许程序在串口有特定事件发生时，如数据到达、传输完成或者错误发生时执行相应的处理。这种模型的优点是能够提高程序效率，因为程序不需要时刻检查串口状态，而是在事件发生时才进行处理。

在MFC中，串口事件通过注册消息处理函数来处理。当串口事件发生时，MFC框架会自动调用相应的消息处理函数，因此开发者需要在这些函数中编写具体的事件处理代码。例如，当串口接收到数据时， OnReceive 消息处理函数将被调用。

3.3.2 事件处理函数的编写

编写事件处理函数需要对串口事件及其处理方法有清晰的认识。这些函数需要正确地设置消息映射，并使用MFC提供的消息处理宏。

// 示例：定义一个消息处理函数，用于处理接收数据
BEGIN_MESSAGE_MAP(CMyDialog, CDialog)
    // 其他消息映射
    ON_MESSAGE(RM传真接收, &CMyDialog::OnReceive)
END_MESSAGE_MAP()

// 串口接收数据的消息处理函数
LRESULT CMyDialog::OnReceive(WPARAM wParam, LPARAM lParam)
{
    // 串口接收缓冲区的数据
    BYTE buffer[1024];
    DWORD dwBytesRead;

    // 读取串口数据
    BOOL bResult = m_SerialPort.Read(buffer, sizeof(buffer), dwBytesRead);

    if (bResult)
    {
        // 成功接收到数据，进行处理...
    }
    else
    {
        // 错误处理
    }

    return 0;
}

在 OnReceive 函数中， m_SerialPort.Read 尝试从串口接收缓冲区读取数据。如果成功读取，可以在函数内部处理这些数据，否则进行错误处理。这种方式的编程模式使整个程序的执行流程更加清晰，事件驱动模型也使得串口编程更加高效。

4. Boost.Asio串口编程应用

4.1 Boost.Asio库简介

4.1.1 Boost.Asio库的特点

Boost.Asio是一个跨平台的C++库，它主要用于网络和低级I/O编程。它对于串口通信而言，提供了强大的抽象，使得开发者可以使用统一的接口处理各种I/O操作。Boost.Asio库广泛应用于需要处理并发网络连接的系统中，它的设计目标之一就是提供异步操作的能力，这与串口通信的特性十分契合。由于其出色的稳定性和性能，Boost.Asio被许多重要的开源项目所采用，如Boost组织的其他库、LLVM、Chromium等。

4.1.2 Boost.Asio在串口通信中的应用

Boost.Asio在串口通信中的应用极大地简化了跨平台串口通信的开发工作。开发者不需要关心底层的系统调用，也不需要处理繁杂的异步事件处理逻辑，Boost.Asio已经将这些抽象化，并提供了简洁的接口。使用Boost.Asio进行串口编程，开发者可以专注于业务逻辑的实现，而不是底层的通信细节。此外，Boost.Asio提供的异步I/O功能，能够帮助开发者编写高效且响应快速的串口通信应用，这对于性能要求较高的应用场景尤为重要。

4.2 Boost.Asio串口编程实践

4.2.1 串口的打开和关闭

在使用Boost.Asio进行串口通信前，我们需要打开串口并创建相应的串口服务对象。这通常涉及到调用 boost::asio::serial_port 类的构造函数，并传入串口名称以及一个 boost::asio::io_service 对象。关闭串口则需要调用 close 方法。

#include <boost/asio.hpp>
#include <iostream>

int main() {
    try {
        boost::asio::io_service io_service;
        boost::asio::serial_port serial_port(io_service, "COM1"); // Windows平台
        // boost::asio::serial_port serial_port(io_service, "/dev/ttyS0"); // Linux平台
        // 其他平台根据具体情况进行串口名称的替换

        // ... 进行串口通信相关操作 ...

        serial_port.close(); // 关闭串口
    } catch (std::exception& e) {
        std::cerr << "Exception: " << e.what() << "\n";
    }

    return 0;
}

在上述代码中，我们首先包含了Boost.Asio库的头文件，并定义了主函数。通过 boost::asio::io_service 对象初始化串口，并指定了串口的名称。在完成通信任务后，通过调用 close 方法来关闭串口。这是最基本的操作，之后的配置和数据传输都是在这个基础上进行的。

4.2.2 串口参数的设置

串口参数配置包括波特率、数据位、停止位、校验位等。在Boost.Asio中，可以通过设置 serial_port 对象的成员函数来配置这些参数。这包括调用 set_option 方法和相应的选项对象，例如 boost::asio::serial_port_base::baud_rate 。

// 继续上述代码片段

// 设置串口参数
boost::asio::serial_port_base::baud_rate baud_rate_option(9600);
boost::asio::serial_port_base::character_size char_size_option(8);
boost::asio::serial_port_base::stop_bits stop_bits_option(boost::asio::serial_port_base::stop_bits::stop_1);
boost::asio::serial_port_base::parity parity_option(boost::asio::serial_port_base::parity::none);

serial_port.set_option(baud_rate_option);
serial_port.set_option(char_size_option);
serial_port.set_option(stop_bits_option);
serial_port.set_option(parity_option);

// ... 进行串口通信相关操作 ...

以上代码展示了如何设置串口通信的基本参数。这里我们指定了9600波特率、8位数据位、1位停止位和无校验位作为示例。实际上，每种参数的选择取决于具体设备的通信协议和需求。配置完成之后，就可以进行数据的发送和接收操作了。

4.2.3 数据的发送和接收

Boost.Asio支持异步和同步的发送和接收操作。在异步操作中，开发者需要提供回调函数来处理完成的事件。而同步操作则会阻塞直到操作完成。在串口通信中，异步操作通常更受青睐，因为它不会阻塞程序的其他部分，使得程序能够同时处理其他任务。

// 继续上述代码片段

// 同步发送数据
std::string write_buf = "Hello, Serial Port!";
boost::asio::write(serial_port, boost::asio::buffer(write_buf));

// 异步接收数据
void handle_read(const boost::system::error_code& error, size_t bytes_transferred) {
    if (!error) {
        std::cout << "Received: " << std::string(data_, bytes_transferred) << std::endl;
    } else {
        std::cerr << "Error on receive: " << error.message() << "\n";
    }
}

boost::array<char, 128> data_;
boost::asio::async_read(serial_port, boost::asio::buffer(data_),
                        boost::bind(handle_read, _1, boost::asio::placeholders::bytes_transferred));

// ... 其他程序代码 ...

在这里，我们向串口发送了一段文本，并尝试异步接收数据。当数据到达时， handle_read 函数将被调用，并处理接收到的数据。Boost.Asio允许我们以非常简洁的方式实现串口通信的复杂逻辑，使得代码既清晰又易于维护。

5. 串口参数配置

5.1 串口参数的类型和作用

串口通信是基于RS-232标准的，此标准定义了计算机与串行通信设备之间进行数据交换的物理层和数据链路层的规范。串口通信的参数配置包括了多个关键的设置项，这些参数的合理配置对于实现可靠的串口通信至关重要。

5.1.1 波特率

波特率（Baud Rate）是衡量数据传输速率的单位，它指每秒传输的符号数。一个符号可以是位（bit），也可以是更复杂的信号元素。例如，9600波特率表示每秒传输9600个符号。波特率的配置必须在通信双方之间匹配，否则会导致数据无法正确解析。

5.1.2 数据位

数据位指的是每个数据包中实际包含的数据量，通常可以设置为5、6、7或8位。数据位的设置决定了数据包的最大容量。例如，在8位数据位设置下，每个数据包可以携带8位数据，如果使用ASCII编码，则可以携带一个字符。

5.1.3 停止位

停止位用于标示数据包的结束。它可以是1位、1.5位或2位。停止位的数量影响了数据包的总长度和传输效率。例如，如果数据位设置为8位，加上1位停止位，则每个数据包至少需要9位。

5.1.4 校验位

校验位用于检测数据传输过程中的错误。常见的校验方式包括无校验位、奇校验、偶校验和标记校验（Mark）和空格校验（Space）。在某些情况下，校验位可选，但在其他情况下，如要求较高通信可靠性时，校验位就变得十分重要。

5.2 Windows API中的参数配置方法

在Windows API中配置串口参数需要使用到DCB（Device Control Block）结构体，该结构体包含了所有与串口设置相关的参数。配置串口参数主要通过 SetCommState 函数来完成。

5.2.1 DCB结构体详解

DCB结构体中的主要字段包括：

DCBlength ：DCB结构体的长度。
BaudRate ：波特率。
ByteSize ：数据位数。
StopBits ：停止位。
Parity ：校验位类型。
fParity ：是否使用校验位。
fOutxCtsFlow ：是否使用硬件流控制。

每个字段都有其默认值，开发者可以根据需要对这些字段进行修改。

5.2.2 SetCommState函数的使用

SetCommState 函数用于设置串口设备的当前控制状态。函数原型如下：

BOOL SetCommState(
  [in] HANDLE hCommDev,
  [in] LPDCB lpDCB
);

hCommDev ：是使用 CreateFile 函数打开串口设备时返回的句柄。
lpDCB ：是一个指向DCB结构体的指针，包含了需要设置的参数。

在调用 SetCommState 之前，必须先填充DCB结构体，然后将其地址传递给该函数。一旦设置了DCB，所有后续对该串口设备的读写操作都将遵循新的参数设置。

5.3 Boost.Asio中的参数配置方法

Boost.Asio库提供了一种更为现代和面向对象的方式来处理串口通信，其中包含了对串口参数配置的支持。

5.3.1 io_service对象和串口对象的创建

在Boost.Asio中，首先需要创建一个 io_service 对象，它负责管理所有的I/O服务。然后，创建一个 serial_port 对象，该对象代表了一个实际的串口。

boost::asio::io_service io_service;
boost::asio::serial_port serial_port(io_service);

5.3.2 串口参数的设置

Boost.Asio提供了 set_option 成员函数来设置串口参数。以下是如何设置波特率、数据位、停止位和校验位的示例代码：

boost::asio::serial_port::baud_rate baud_rate(9600);
boost::asio::serial_port::character_size character_size(8);
boost::asio::serial_port::stop_bits stop_bits(boost::asio::serial_port::stop_bits::one);
boost::asio::serial_port::parity parity(boost::asio::serial_port::parity::none);

serial_port.set_option(baud_rate);
serial_port.set_option(character_size);
serial_port.set_option(stop_bits);
serial_port.set_option(parity);

在Boost.Asio中设置串口参数与Windows API有所不同，它提供了更为简洁和面向对象的接口。每种参数的设置都是通过调用相应的 set_option 函数实现的，这些函数接收特定类型的参数对象。

通过上述配置，串口通信的基本参数便设置完成，接下来就可以进行数据的发送和接收操作了。