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

news2026/5/6 9:15:42
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_WRITEdwFlagsAndAttributes同步模式设为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(baud9600 parityN data8 stop1), dcb); SetCommState(hCom, dcb); // 应用新配置我曾经调试过一个RS-485设备通信总是不稳定。后来发现是DCB结构中的fOutxCtsFlow流控制标志被无意中开启了导致在没有CTS信号时数据发送被阻塞。这个教训让我明白每个DCB标志位都需要仔细检查。3. 串口配置详解3.1 DCB结构体深度解析DCBDevice Control Block是串口配置的核心结构体包含近30个成员变量。掌握关键参数对稳定通信至关重要BaudRate波特率常用值有9600、115200等ByteSize数据位通常为8Parity奇偶校验NOPARITY、EVENPARITY等StopBits停止位ONESTOPBIT、TWOSTOPBITS等fDtrControlDTR流控制DTR_CONTROL_ENABLE常用fRtsControlRTS流控制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/XOFFdcb.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.coloradmin.cn/o/2531082.html

如若内容造成侵权/违法违规/事实不符,请联系多彩编程网进行投诉反馈,一经查实,立即删除!

相关文章

SpringBoot-17-MyBatis动态SQL标签之常用标签

文章目录 1 代码1.1 实体User.java1.2 接口UserMapper.java1.3 映射UserMapper.xml1.3.1 标签if1.3.2 标签if和where1.3.3 标签choose和when和otherwise1.4 UserController.java2 常用动态SQL标签2.1 标签set2.1.1 UserMapper.java2.1.2 UserMapper.xml2.1.3 UserController.ja…

wordpress后台更新后 前端没变化的解决方法

使用siteground主机的wordpress网站,会出现更新了网站内容和修改了php模板文件、js文件、css文件、图片文件后,网站没有变化的情况。 不熟悉siteground主机的新手,遇到这个问题,就很抓狂,明明是哪都没操作错误&#x…

网络编程(Modbus进阶)

思维导图 Modbus RTU(先学一点理论) 概念 Modbus RTU 是工业自动化领域 最广泛应用的串行通信协议,由 Modicon 公司(现施耐德电气)于 1979 年推出。它以 高效率、强健性、易实现的特点成为工业控制系统的通信标准。 包…

UE5 学习系列(二)用户操作界面及介绍

这篇博客是 UE5 学习系列博客的第二篇,在第一篇的基础上展开这篇内容。博客参考的 B 站视频资料和第一篇的链接如下: 【Note】:如果你已经完成安装等操作,可以只执行第一篇博客中 2. 新建一个空白游戏项目 章节操作,重…

IDEA运行Tomcat出现乱码问题解决汇总

最近正值期末周,有很多同学在写期末Java web作业时,运行tomcat出现乱码问题,经过多次解决与研究,我做了如下整理: 原因: IDEA本身编码与tomcat的编码与Windows编码不同导致,Windows 系统控制台…

利用最小二乘法找圆心和半径

#include <iostream> #include <vector> #include <cmath> #include <Eigen/Dense> // 需安装Eigen库用于矩阵运算 // 定义点结构 struct Point { double x, y; Point(double x_, double y_) : x(x_), y(y_) {} }; // 最小二乘法求圆心和半径 …

使用docker在3台服务器上搭建基于redis 6.x的一主两从三台均是哨兵模式

一、环境及版本说明 如果服务器已经安装了docker,则忽略此步骤,如果没有安装,则可以按照一下方式安装: 1. 在线安装(有互联网环境): 请看我这篇文章 传送阵>> 点我查看 2. 离线安装(内网环境):请看我这篇文章 传送阵>> 点我查看 说明&#xff1a;假设每台服务器已…

XML Group端口详解

在XML数据映射过程中&#xff0c;经常需要对数据进行分组聚合操作。例如&#xff0c;当处理包含多个物料明细的XML文件时&#xff0c;可能需要将相同物料号的明细归为一组&#xff0c;或对相同物料号的数量进行求和计算。传统实现方式通常需要编写脚本代码&#xff0c;增加了开…

LBE-LEX系列工业语音播放器|预警播报器|喇叭蜂鸣器的上位机配置操作说明

LBE-LEX系列工业语音播放器|预警播报器|喇叭蜂鸣器专为工业环境精心打造&#xff0c;完美适配AGV和无人叉车。同时&#xff0c;集成以太网与语音合成技术&#xff0c;为各类高级系统&#xff08;如MES、调度系统、库位管理、立库等&#xff09;提供高效便捷的语音交互体验。 L…

(LeetCode 每日一题) 3442. 奇偶频次间的最大差值 I (哈希、字符串)

题目&#xff1a;3442. 奇偶频次间的最大差值 I 思路 &#xff1a;哈希&#xff0c;时间复杂度0(n)。 用哈希表来记录每个字符串中字符的分布情况&#xff0c;哈希表这里用数组即可实现。 C版本&#xff1a; class Solution { public:int maxDifference(string s) {int a[26]…

【大模型RAG】拍照搜题技术架构速览:三层管道、两级检索、兜底大模型

摘要 拍照搜题系统采用“三层管道&#xff08;多模态 OCR → 语义检索 → 答案渲染&#xff09;、两级检索&#xff08;倒排 BM25 向量 HNSW&#xff09;并以大语言模型兜底”的整体框架&#xff1a; 多模态 OCR 层 将题目图片经过超分、去噪、倾斜校正后&#xff0c;分别用…

【Axure高保真原型】引导弹窗

今天和大家中分享引导弹窗的原型模板&#xff0c;载入页面后&#xff0c;会显示引导弹窗&#xff0c;适用于引导用户使用页面&#xff0c;点击完成后&#xff0c;会显示下一个引导弹窗&#xff0c;直至最后一个引导弹窗完成后进入首页。具体效果可以点击下方视频观看或打开下方…

接口测试中缓存处理策略

在接口测试中&#xff0c;缓存处理策略是一个关键环节&#xff0c;直接影响测试结果的准确性和可靠性。合理的缓存处理策略能够确保测试环境的一致性&#xff0c;避免因缓存数据导致的测试偏差。以下是接口测试中常见的缓存处理策略及其详细说明&#xff1a; 一、缓存处理的核…

龙虎榜——20250610

上证指数放量收阴线&#xff0c;个股多数下跌&#xff0c;盘中受消息影响大幅波动。 深证指数放量收阴线形成顶分型&#xff0c;指数短线有调整的需求&#xff0c;大概需要一两天。 2025年6月10日龙虎榜行业方向分析 1. 金融科技 代表标的&#xff1a;御银股份、雄帝科技 驱动…

观成科技:隐蔽隧道工具Ligolo-ng加密流量分析

1.工具介绍 Ligolo-ng是一款由go编写的高效隧道工具&#xff0c;该工具基于TUN接口实现其功能&#xff0c;利用反向TCP/TLS连接建立一条隐蔽的通信信道&#xff0c;支持使用Let’s Encrypt自动生成证书。Ligolo-ng的通信隐蔽性体现在其支持多种连接方式&#xff0c;适应复杂网…

铭豹扩展坞 USB转网口 突然无法识别解决方法

当 USB 转网口扩展坞在一台笔记本上无法识别,但在其他电脑上正常工作时,问题通常出在笔记本自身或其与扩展坞的兼容性上。以下是系统化的定位思路和排查步骤,帮助你快速找到故障原因: 背景: 一个M-pard(铭豹)扩展坞的网卡突然无法识别了,扩展出来的三个USB接口正常。…

未来机器人的大脑:如何用神经网络模拟器实现更智能的决策?

编辑&#xff1a;陈萍萍的公主一点人工一点智能 未来机器人的大脑&#xff1a;如何用神经网络模拟器实现更智能的决策&#xff1f;RWM通过双自回归机制有效解决了复合误差、部分可观测性和随机动力学等关键挑战&#xff0c;在不依赖领域特定归纳偏见的条件下实现了卓越的预测准…

Linux应用开发之网络套接字编程(实例篇)

服务端与客户端单连接 服务端代码 #include <sys/socket.h> #include <sys/types.h> #include <netinet/in.h> #include <stdio.h> #include <stdlib.h> #include <string.h> #include <arpa/inet.h> #include <pthread.h> …

华为云AI开发平台ModelArts

华为云ModelArts&#xff1a;重塑AI开发流程的“智能引擎”与“创新加速器”&#xff01; 在人工智能浪潮席卷全球的2025年&#xff0c;企业拥抱AI的意愿空前高涨&#xff0c;但技术门槛高、流程复杂、资源投入巨大的现实&#xff0c;却让许多创新构想止步于实验室。数据科学家…

深度学习在微纳光子学中的应用

深度学习在微纳光子学中的主要应用方向 深度学习与微纳光子学的结合主要集中在以下几个方向&#xff1a; 逆向设计 通过神经网络快速预测微纳结构的光学响应&#xff0c;替代传统耗时的数值模拟方法。例如设计超表面、光子晶体等结构。 特征提取与优化 从复杂的光学数据中自…