当前位置：首页 > news >正文

Windows串口通信API实战：从CreateFile到异步I/O操作

news 2026/4/18 20:01:28

1. Windows串口通信基础入门

第一次接触Windows串口通信时，我完全被那些晦涩的API函数吓到了。CreateFile、ReadFile、WriteFile这些名字看起来跟串口毫无关联，为什么用文件操作函数来处理串口？后来才明白，这正是Windows设计的巧妙之处——把设备当作文件来操作。这种统一化的设计理念，让开发者可以用熟悉的文件操作方式来控制硬件设备。

串口通信在工业控制、物联网设备调试等场景中非常常见。比如通过串口连接传感器采集数据，或者与PLC控制器进行通信。Windows平台提供了一套完整的API函数集，让我们能够轻松实现这些功能。不同于Linux下的tty设备操作，Windows API虽然初看复杂，但结构非常清晰。

要开始串口编程，首先需要了解几个核心概念：

串口被抽象为文件对象，使用文件操作API进行控制
通信参数通过DCB结构体配置，包括波特率、数据位等
支持同步和异步两种I/O模式，后者效率更高
超时控制机制可以防止程序无限制等待

记得我第一次用CreateFile打开COM口时，总是返回INVALID_HANDLE_VALUE。调试半天才发现，原来其他程序已经占用了这个串口。这就是为什么CreateFile的fdwShareMode参数必须设为0——串口是独占资源，不能多程序共享。

2. 从CreateFile开始串口操作

2.1 打开串口的正确姿势

CreateFile函数是串口操作的起点，它的原型看起来令人望而生畏：

HANDLE CreateFile( LPCTSTR lpFileName, // 串口名称，如"COM1" DWORD dwDesiredAccess, // 访问权限，读/写 DWORD dwShareMode, // 共享模式，必须为0 LPSECURITY_ATTRIBUTES lpSecurityAttributes, // 安全属性 DWORD dwCreationDisposition, // 必须为OPEN_EXISTING DWORD dwFlagsAndAttributes, // 文件属性，异步I/O需设置 HANDLE hTemplateFile // 模板文件，必须为NULL );

实际使用时，可以简化为以下关键参数配置：

lpFileName：填写"COM1"这样的串口名称，注意在Windows 10以后，需要写成"\\.\COM10"这样的格式才能正确打开COM10及以上的端口
dwDesiredAccess：通常组合使用GENERIC_READ | GENERIC_WRITE
dwFlagsAndAttributes：同步模式设为0，异步模式设为FILE_FLAG_OVERLAPPED

我曾遇到一个坑：在Windows 7上测试正常的代码，在Windows 10上却打不开COM10。后来发现这是Windows版本差异导致的，解决方案很简单：

// 对于COM10及以上的端口，需要使用特殊格式 TCHAR szPort[32]; _stprintf(szPort, _T("\\\\.\\COM%d"), nPortNumber); hCom = CreateFile(szPort, ...);

2.2 串口初始化最佳实践

成功打开串口后，建议立即进行以下初始化操作：

调用SetupComm设置输入输出缓冲区大小。虽然Windows会提供默认缓冲区，但显式设置可以避免后续问题：

// 设置1024字节的输入输出缓冲区 SetupComm(hCom, 1024, 1024);

配置超时参数非常重要，特别是对于同步I/O操作。没有合理设置超时可能导致线程永久阻塞：

COMMTIMEOUTS timeouts; timeouts.ReadIntervalTimeout = 50; // 字符间超时50ms timeouts.ReadTotalTimeoutMultiplier = 10; // 每字节附加10ms timeouts.ReadTotalTimeoutConstant = 1000; // 固定超时1s timeouts.WriteTotalTimeoutMultiplier = 10; timeouts.WriteTotalTimeoutConstant = 1000; SetCommTimeouts(hCom, &timeouts);

配置DCB结构体时，BuildCommDCB是个好帮手，它可以从字符串初始化大部分参数：

DCB dcb; GetCommState(hCom, &dcb); // 先获取当前配置 BuildCommDCB(_T("baud=9600 parity=N data=8 stop=1"), &dcb); SetCommState(hCom, &dcb); // 应用新配置

我曾经调试过一个RS-485设备，通信总是不稳定。后来发现是DCB结构中的fOutxCtsFlow流控制标志被无意中开启了，导致在没有CTS信号时数据发送被阻塞。这个教训让我明白：每个DCB标志位都需要仔细检查。

3. 串口配置详解

3.1 DCB结构体深度解析

DCB（Device Control Block）是串口配置的核心结构体，包含近30个成员变量。掌握关键参数对稳定通信至关重要：

BaudRate：波特率，常用值有9600、115200等
ByteSize：数据位，通常为8
Parity：奇偶校验，NOPARITY、EVENPARITY等
StopBits：停止位，ONESTOPBIT、TWOSTOPBITS等
fDtrControl：DTR流控制，DTR_CONTROL_ENABLE常用
fRtsControl：RTS流控制，RTS_CONTROL_ENABLE常用

调试Modbus RTU设备时，我曾遇到一个棘手问题：设备只在特定波特率下响应，但尝试各种波特率都不成功。最后发现是DCB结构没有正确清零，残留的奇偶校验设置导致通信失败。解决方案是：

DCB dcb = {0}; // 确保结构体清零 dcb.DCBlength = sizeof(DCB); // 必须设置长度 GetCommState(hCom, &dcb); // 获取当前配置

3.2 流控制的正确使用方式

硬件流控制能有效避免数据丢失，但配置不当会导致通信卡死。主要控制线有：

RTS/CTS：请求发送/清除发送
DSR/DTR：数据设备就绪/数据终端就绪

配置示例：

dcb.fOutxCtsFlow = TRUE; // 使用CTS输出流控制 dcb.fRtsControl = RTS_CONTROL_HANDSHAKE; // RTS握手模式 dcb.fOutxDsrFlow = TRUE; // 使用DSR输出流控制 dcb.fDtrControl = DTR_CONTROL_HANDSHAKE; // DTR握手模式

实际项目中，我发现很多国产设备对硬件流控制支持不完善。这时可以改用软件流控制（XON/XOFF）：

dcb.fOutX = TRUE; // 启用发送XON/XOFF控制 dcb.fInX = TRUE; // 启用接收XON/XOFF控制 dcb.XonChar = 0x11; // XON字符 dcb.XoffChar = 0x13; // XOFF字符

4. 高效的异步I/O操作

4.1 重叠I/O模型实战

同步I/O在读写时会导致线程阻塞，而异步I/O（重叠I/O）能显著提高效率。关键步骤：

打开串口时指定FILE_FLAG_OVERLAPPED标志
每次读写操作提供OVERLAPPED结构
使用WaitForSingleObject或GetOverlappedResult检查操作状态

典型异步写操作示例：

OVERLAPPED ovWrite = {0}; ovWrite.hEvent = CreateEvent(NULL, TRUE, FALSE, NULL); char szData[] = "Hello Serial Port"; DWORD dwWritten; if (!WriteFile(hCom, szData, strlen(szData), &dwWritten, &ovWrite)) { if (GetLastError() == ERROR_IO_PENDING) { // 等待写操作完成，超时设为1000ms WaitForSingleObject(ovWrite.hEvent, 1000); GetOverlappedResult(hCom, &ovWrite, &dwWritten, FALSE); } } CloseHandle(ovWrite.hEvent);

4.2 异步读操作的陷阱与技巧

异步读操作更复杂，常见问题包括：

数据到达时间不确定
需要合理设置超时
缓冲区管理要谨慎

可靠的异步读实现：

OVERLAPPED ovRead = {0}; ovRead.hEvent = CreateEvent(NULL, TRUE, FALSE, NULL); char buf[256]; DWORD dwRead; // 启动异步读操作 if (!ReadFile(hCom, buf, sizeof(buf), &dwRead, &ovRead)) { if (GetLastError() == ERROR_IO_PENDING) { // 等待数据到达，超时500ms DWORD dwRes = WaitForSingleObject(ovRead.hEvent, 500); if (dwRes == WAIT_OBJECT_0) { GetOverlappedResult(hCom, &ovRead, &dwRead, FALSE); // 处理接收到的数据... } else { // 超时处理 CancelIo(hCom); // 取消未完成的I/O } } } CloseHandle(ovRead.hEvent);

在工业自动化项目中，我发现异步读配合完成端口(IOCP)能实现极高的吞吐量。但对于大多数应用，简单的重叠I/O已经足够。

5. 实战中的常见问题解决

5.1 串口数据粘包处理

串口通信常见的问题是数据粘包——多条消息粘连在一起到达。解决方案包括：

固定长度协议：每条消息长度固定
分隔符协议：用特定字符分隔消息
超时判定：间隔超过阈值视为新消息

示例代码实现超时判定：

COMMTIMEOUTS timeouts; timeouts.ReadIntervalTimeout = 50; // 字符间超时50ms SetCommTimeouts(hCom, &timeouts); char buf[256]; DWORD dwRead; while (true) { if (ReadFile(hCom, buf, sizeof(buf), &dwRead, NULL)) { if (dwRead > 0) { // 处理接收到的数据 ProcessData(buf, dwRead); } } }

5.2 错误处理与恢复

健壮的串口程序需要完善的错误处理：

DWORD dwErrors; COMSTAT comStat; if (!ClearCommError(hCom, &dwErrors, &comStat)) { // 处理严重错误 ReopenSerialPort(); return; } if (dwErrors) { if (dwErrors & CE_FRAME) { /* 帧错误处理 */ } if (dwErrors & CE_OVERRUN) { /* 溢出处理 */ } // 其他错误处理... } // 检查待读取数据量 if (comStat.cbInQue > 0) { // 有数据待读取... }

在医疗设备数据采集中，我曾遇到间歇性通信中断的问题。通过添加自动重连机制解决了这个问题：

void CheckAndReconnect() { DWORD dwErrors; if (!ClearCommError(hCom, &dwErrors, NULL) || dwErrors) { CloseHandle(hCom); Sleep(1000); // 等待1秒 hCom = CreateFile(...); // 重新打开串口 // 重新初始化串口配置... } }

6. 串口调试技巧与工具

6.1 调试输出与日志记录

在开发过程中，详细的日志非常重要。我通常会实现这样的调试输出函数：

void LogSerialData(LPCTSTR szPrefix, const BYTE* pData, DWORD dwSize) { TCHAR szDebug[1024]; _stprintf(szDebug, _T("%s (%d bytes): "), szPrefix, dwSize); for (DWORD i = 0; i < dwSize; i++) { TCHAR szByte[8]; _stprintf(szByte, _T("%02X "), pData[i]); _tcscat(szDebug, szByte); } OutputDebugString(szDebug); // 输出到调试器 // 同时写入日志文件... }

6.2 虚拟串口工具推荐

在没有实际硬件时，虚拟串口工具非常有用：

com0com：开源虚拟串口驱动，可创建成对的虚拟串口
Virtual Serial Port Driver：商业软件，功能更强大
HW VSP3：支持多种虚拟串口场景

在开发跨平台串口应用时，我经常用com0com创建COM1<->COM2对来测试通信逻辑，无需连接实际设备。

7. 性能优化进阶技巧

7.1 双缓冲技术应用

高频数据采集时，双缓冲能有效避免数据丢失：

#define BUF_SIZE 4096 char buf1[BUF_SIZE], buf2[BUF_SIZE]; char *pCurrentBuf = buf1; DWORD dwBytesInBuf = 0; // 在异步读完成回调中 void OnReadComplete(DWORD dwBytesRead) { if (pCurrentBuf == buf1) { ProcessData(buf1, dwBytesRead); pCurrentBuf = buf2; } else { ProcessData(buf2, dwBytesRead); pCurrentBuf = buf1; } // 立即启动下一轮读取 StartAsyncRead(pCurrentBuf, BUF_SIZE); }

7.2 零拷贝优化

对于高性能场景，可以尝试内存映射等零拷贝技术。但需要注意，Windows串口驱动层已经做了很多优化，应用层的优化效果可能有限。

在股票行情接收系统中，我通过以下措施将吞吐量提升了3倍：

使用更大的I/O缓冲区（16KB以上）
适当增加读操作的重叠数量（2-3个异步读同时挂起）
减少不必要的线程切换

8. 完整示例代码解析

下面是一个功能完善的异步串口类框架：

class CSerialPort { public: CSerialPort() : m_hCom(INVALID_HANDLE_VALUE) {} ~CSerialPort() { Close(); } BOOL Open(LPCTSTR szPort, int nBaudRate) { Close(); TCHAR szRealPort[32]; _stprintf(szRealPort, _T("\\\\.\\%s"), szPort); m_hCom = CreateFile(szRealPort, GENERIC_READ | GENERIC_WRITE, 0, NULL, OPEN_EXISTING, FILE_FLAG_OVERLAPPED, NULL); if (m_hCom == INVALID_HANDLE_VALUE) return FALSE; // 初始化串口配置... return SetupPort(nBaudRate); } void Close() { if (m_hCom != INVALID_HANDLE_VALUE) { CancelIo(m_hCom); CloseHandle(m_hCom); m_hCom = INVALID_HANDLE_VALUE; } } BOOL Write(const BYTE* pData, DWORD dwSize) { OVERLAPPED ov = {0}; ov.hEvent = CreateEvent(NULL, TRUE, FALSE, NULL); DWORD dwWritten; if (!WriteFile(m_hCom, pData, dwSize, &dwWritten, &ov)) { if (GetLastError() == ERROR_IO_PENDING) { WaitForSingleObject(ov.hEvent, INFINITE); GetOverlappedResult(m_hCom, &ov, &dwWritten, FALSE); } else { CloseHandle(ov.hEvent); return FALSE; } } CloseHandle(ov.hEvent); return dwWritten == dwSize; } // 其他成员函数... private: HANDLE m_hCom; // 其他成员变量... };

这个框架经过多个项目的验证，稳定可靠。在具体项目中，我会根据需求添加数据解析、错误恢复等特性。

查看全文

http://www.jsqmd.com/news/662409/