1. 为什么还在用 MFC 串口:VS2010/VS2017 工程里的最短路径
手上还有一台跑 Win7 的工控机,上位机是 VS2010 编的 MFC 对话框程序,下位采集板固定 9600 波特率、每 100ms 吐一帧 12 字节。现在搜串口资料,满屏是 Python 的 pyserial 和 C# 的 SerialPort,可产线不能停,你只能回到代码开发工具里的老位置:MFC 串口通信。这篇不讲新潮方案,只讲两条能落地的路——VS2010 里用 MSComm 控件快速接通,VS2017 里用 CSerialPort 封装类把超时、缓冲和线程焊稳。从控件注册、参数配对,到 12 字节帧的粘包切分,再到关闭时不崩,都是现场能照做的步骤。适合维护老上位机的现场工程师,也适合还在用 VC 做串口课设、被控件注册卡住的人。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 把串口工具接进对话框工程:MSComm 控件注册与 CSerialPort 类落位
2.1 MSComm 控件在 VS2010 对话框里的注册与插入
MSComm 不是普通 DLL,它是 ActiveX 控件,文件通常是 mscomm32.ocx。MFC 对话框资源里插入的只是一个占位,程序运行时才通过 COM 去创建真正的控件窗口。注册表里没有这条控件记录,或者 ocx 位数和工程对不上,对话框 DoModal 的时候就会直接创建失败。现场最常见的翻车不是代码写错,而是拿了一个 64 位环境注册过的控件去跑 32 位工程,或者反过来。
操作顺序可以固定成下面几步,每步都能单独验证:
- 确认工程是 32 位还是 64 位,ocx 的位数必须一致。VS2010 的 MFC 工程默认多为 32 位。
- 以管理员身份打开 CMD,执行 regsvr32 注册。
- 回到 VS2010 对话框编辑器,右键「插入 ActiveX 控件」,选 Microsoft Communications Control。
- 用类向导给这个控件添加成员变量,类型选 CMSComm。
- 在 OnInitDialog 里创建并配置,创建失败就弹提示,不要让它静默失败。
bash复制# 以管理员身份运行,注册 32 位 MSComm 控件
regsvr32 "C:\Windows\System32\mscomm32.ocx"
# 如果系统是 64 位而工程是 32 位,注意 ocx 的位数要和工程一致
# 注册成功会弹 "DllRegisterServer in ... succeeded"
注册只是第一步,代码里还要显式创建控件并配置参数:
cpp复制// 对话框类头文件
#include "mscomm.h"
CMSComm m_comm;
// OnInitDialog 中创建并配置
BOOL CSerialDemoDlg::OnInitDialog()
{
CDialogEx::OnInitDialog();
// 动态创建 ActiveX 控件,IDC_MSCOMM1 是对话框资源里的占位 ID
if (!m_comm.Create(NULL, WS_CHILD | WS_VISIBLE, CRect(0, 0, 0, 0), this, IDC_MSCOMM1))
{
AfxMessageBox(_T("MSComm 创建失败:先确认 mscomm32.ocx 已注册且位数匹配"));
return TRUE;
}
m_comm.put_CommPort(1); // COM1,按设备管理器实际端口改
m_comm.put_Settings(_T("9600,n,8,1")); // 9600 波特率、无校验、8 数据位、1 停止位
m_comm.put_InputMode(1); // 1 = 二进制,避免按文本处理
m_comm.put_InBufferSize(4096); // 接收缓冲区
m_comm.put_RThreshold(1); // 收到 1 字节就触发 OnComm
m_comm.put_InputLen(0); // 0 = 一次读空接收缓冲区
m_comm.put_PortOpen(TRUE); // 打开端口
return TRUE;
}
CommPort 是串口号,填 1 表示 COM1;Settings 的四个段分别是波特率、校验位、数据位、停止位,顺序不能乱;InputMode 必须设成 1,否则控件会把收到的字节当文本处理,二进制帧里的 0x00 和 0xFF 会被吞掉或改写;RThreshold 设 1 表示每收到一个字节就触发一次 OnComm,适合 12 字节的小帧;InputLen 设 0 表示一次把接收缓冲区读空。Create 的返回值一定要判断,这是后面排查创建失败的第一现场。
2.2 CSerialPort 封装类在 VS2017 工程里的落位
CSerialPort 通常就是几个 .h/.cpp 文件,内部用 CreateFile 打开 COM 口,SetCommState 配 DCB,SetCommTimeouts 设超时,ReadFile/WriteFile 收发,再用 OVERLAPPED 或独立线程等事件。它把「打开—配置—读—写—关」封装成类方法,对话框不用直接碰 HANDLE,也不用自己拼 COMMTIMEOUTS。对 VS2017 的新工程来说,它比 ActiveX 控件少一层注册依赖,部署时不用再往目标机拷 ocx。
落位步骤比 MSComm 少,但字符集和超时两个地方容易出问题:
- 把 CSerialPort 的 .h/.cpp 加入工程,不要只把头文件拖进来。
- 在对话框类里放一个 CSerialPort 成员,不要用指针加 new,除非你确定析构顺序。
- 打开前先调 InitPort 配参数,再调 OpenPort。
- 设置读超时,避免 ReadFile 在没数据时永久阻塞。
- 接收可以用消息通知,也可以自己起线程轮询,按工程现有消息循环选。
cpp复制// CSerialPort 的接口名随版本略有差异,下面按常见形态示意
#include "SerialPort.h"
CSerialPort m_port;
bool CSerialDemoDlg::OpenSerial(int nPort)
{
if (m_port.IsOpen())
m_port.ClosePort();
// 9600, N, 8, 1;不同版本参数顺序以头文件为准
if (!m_port.InitPort(this, nPort, 9600, 'N', 8, 1))
return false;
// 读超时:总超时、字节间隔超时,避免 ReadFile 永久阻塞
m_port.SetReadTimeouts(100, 0, 100, 0, 100);
m_port.SetReadIntervalTimeout(50);
return m_port.OpenPort();
}
InitPort 的 this 参数是为了把接收到的数据以消息形式投递给窗口,如果你的版本用回调或线程,这个参数可能不叫这个名字。SetReadTimeouts 的五个参数对应 COMMTIMEOUTS 里的读间隔超时、读总超时乘数、读总超时常数、写总超时乘数、写总超时常数,具体顺序一定以你手里那个头文件为准,别照抄。VS2017 默认 Unicode 字符集,老版 CSerialPort 里大量用 char,要么把工程字符集改成多字节,要么在类里统一做 TCHAR 转换,否则编译期就是一堆不能转换的错误。
2.3 两种接入方式的边界与选型
这两条路不是谁先进谁落后,而是边界不同。MSComm 控件胜在快,拖进对话框、绑个变量就能跑,适合 VS2010 老工程和现场临时验证;CSerialPort 胜在可控,超时、缓冲区、线程都在自己手里,适合 VS2017 新工程和需要长时间稳定收发的场景。
| 维度 | MSComm 控件 | CSerialPort 封装 |
|---|---|---|
| 接入方式 | ActiveX 控件,需要注册 ocx | 源码类,加入工程即可 |
| 部署依赖 | 目标机也要注册 ocx | 编译进 exe,无额外注册 |
| 线程模型 | OnComm 在 UI 线程触发 | 可用工作线程接收,或消息通知 |
| 缓冲区控制 | 控件内部缓冲区,靠 InputLen/RThreshold 调 | 自己管理缓冲区,超时可设 |
| 异常处理 | 创建失败、注册失败要自己判断 | 打开失败、读写失败返回值和错误码更直接 |
| 适合场景 | VS2010 老工程、快速接通 | VS2017 新工程、要稳定和线程安全 |
选型时先看现场环境:如果目标机已经装好了 MSComm 控件、工程也是 VS2010,硬换 CSerialPort 反而增加迁移成本;如果是新做的 VS2017 对话框工程,目标机不一定允许你注册 ocx,那就直接用 CSerialPort。还有一条血泪经验:不管选哪个,先把「打开—发一条—收一条—关闭」跑通,再往里加粘包和线程,别一上来就把解析、界面刷新、数据库写入全塞进接收回调。
3. 串口参数与收发循环:9600 波特率下 12 字节帧怎么收全
3.1 打开串口前的参数表
9600 波特率下,一个字节按 1 个起始位、8 个数据位、1 个停止位算,大约 10 位,传输时间约 1.04ms。12 字节一帧约 12.5ms,帧间隔 100ms,留给接收和解析的余量很足。参数配错时,最先表现出来的不是打不开,而是乱码或半帧,所以这张表要对着下位机协议逐项核。
| 参数 | 值 | 说明 |
|---|---|---|
| 波特率 | 9600 | 必须与采集板一致 |
| 数据位 | 8 | 常规二进制帧 |
| 停止位 | 1 | 常规配置 |
| 校验 | N | 无校验,靠帧内校验字节 |
| 流控 | None | 不握手,避免下位机不支持 |
| 输入模式 | 二进制 | MSComm 的 InputMode 设 1 |
| RThreshold | 1 | 每字节触发,适合小帧 |
| InputLen | 0 | 一次读空接收缓冲区 |
| 接收缓冲区 | 4096 | 留足余量,防止突发堆积 |
参数表不是抄一次就完事。同一台上位机换不同采集板时,波特率和帧长都可能变,尤其是 12 字节这种小帧,RThreshold 设成 12 看起来更「整」,但一旦某次只到了 11 字节,OnComm 就不触发,帧就卡在缓冲区里。设 1 虽然触发频繁,但每次只做搬运,反而更稳。
3.2 发送:WriteFile 与 MSComm Output 的差别
MSComm 的发送接口是 put_Output,参数是 VARIANT。二进制字节数组不能直接塞 CString,要包成 SAFEARRAY,否则控件会按 BSTR 处理,遇到 0x00 就截断,表现就是「发 10 个字只收到 3 个还夹着 0x00」。CSerialPort 那边通常直接写 char 缓冲区,长度自己传,反而直观。
cpp复制void CSerialDemoDlg::SendFrame(const BYTE* pData, int nLen)
{
if (!m_comm.get_PortOpen())
return;
// MSComm 的 Output 接收 VARIANT,二进制要包成 SAFEARRAY
COleSafeArray sa;
sa.CreateOneDim(VT_UI1, nLen, (void*)pData);
COleVariant var(sa);
m_comm.put_Output(var);
}
CreateOneDim 的第一个参数是元素类型,二进制用 VT_UI1;第二个参数是长度;第三个参数是源缓冲区。包成 COleSafeArray 之后,VARIANT 的类型是 VT_ARRAY | VT_UI1,控件才知道这是字节数组而不是字符串。发送前先判断 PortOpen,端口没开时 put_Output 不会给你有用的报错,只会在 OnComm 里给一个事件码,容易误判。
CSerialPort 的发送通常长这样,返回值要判断:
cpp复制bool CSerialDemoDlg::SendFrame(const BYTE* pData, int nLen)
{
if (!m_port.IsOpen())
return false;
// 不同版本方法名可能是 WriteToPort / Write,返回值表示实际写入字节数
return m_port.WriteToPort((const char*)pData, nLen) == nLen;
}
发送失败不一定是串口坏了,先看端口有没有被别的程序占用,再看下位机是不是流控要求不一样。有些 USB 转串口模块在 9600 下很稳,换到高波特率才出问题;现场如果只能用 9600,就别为了「看起来快」去改波特率,改了双方都得跟着改。
3.3 接收:事件驱动、轮询与粘包处理
MSComm 的接收入口是 OnComm 事件,事件码 2 表示 ComEvReceive。很多人第一次写就在这个函数里直接解析帧、刷新编辑框,结果 100ms 一帧时界面越来越卡。OnComm 运行在 UI 线程,里面做重活会阻塞消息循环,前一波没处理完,后一波又来了,最后表现为假死。
正确的做法是 OnComm 里只做搬运:把收到的字节追加到环形缓冲区,解析交给工作线程。下面这段只负责取数据和入队:
cpp复制void CSerialDemoDlg::OnCommMscomm1()
{
if (m_comm.get_CommEvent() != 2) // 2 = ComEvReceive
return;
COleVariant var = m_comm.get_Input();
if (var.vt != (VT_ARRAY | VT_UI1))
return;
COleSafeArray sa(var);
DWORD nLen = sa.GetOneDimSize();
if (nLen == 0)
return;
BYTE* p = NULL;
sa.AccessData((void**)&p);
if (p != NULL)
{
m_ring.Write(p, nLen); // 只搬运到环形缓冲区,不解析
sa.UnaccessData();
}
}
get_Input() 取回来的是 VARIANT,先判断类型是不是字节数组,不是就直接返回,避免把文本模式的数据当二进制解析。AccessData 拿到内部指针后不要长期持有,拷完立刻 UnaccessData。这里不判断「是不是一整帧」,因为一次 OnComm 可能收到半帧,也可能收到一帧半,粘包和拆包必须在缓冲区层面做,不能假设「一次事件等于一帧」。
如果用的是 CSerialPort 的工作线程模式,接收循环里同样只做 Read 到缓冲区,解析放在另一个函数。轮询间隔可以设 10ms,100ms 一帧的节奏下完全够用;不要用 Sleep(100) 去卡着帧周期读,一旦下位机提前或延后发帧,就会读不到或者一次读两帧。
4. 粘包与线程:100ms 一帧数据下的缓冲区设计
4.1 为什么 OnComm 里不能直接刷新界面
OnComm 是控件事件,最终还是在 UI 线程的消息循环里执行。你在里面做帧解析、字符串拼接、编辑框追加,每一样都在占用消息循环时间。100ms 一帧、12 字节,看起来数据量很小,但界面刷新一次可能就要几毫秒,叠加起来就把消息循环堵住了。用户看到的是「点不动、拖不动」,日志里却没有任何报错,这种问题最难查。
把接收和显示拆成两段:OnComm 只把字节写进环形缓冲区,工作线程按固定节奏取数据、切帧,切出完整帧后再把结果 PostMessage 给 UI 线程。这样 UI 线程只负责显示,不参与串口读取和帧同步。环形缓冲区要加锁,但锁的粒度只包住读写指针的移动和单字节拷贝,不要在工作线程持锁做解析。
cpp复制class CRingBuffer
{
public:
CRingBuffer(size_t nSize = 4096) : m_buf(nSize), m_read(0), m_write(0) {}
void Write(const BYTE* pData, size_t nLen)
{
std::lock_guard<std::mutex> lock(m_mutex);
for (size_t i = 0; i < nLen; ++i)
{
m_buf[m_write] = pData[i];
m_write = (m_write + 1) % m_buf.size();
if (m_write == m_read) // 满了,丢最老的一个字节
m_read = (m_read + 1) % m_buf.size();
}
}
size_t Read(BYTE* pOut, size_t nMax)
{
std::lock_guard<std::mutex> lock(m_mutex);
size_t n = 0;
while (m_read != m_write && n < nMax)
{
pOut[n++] = m_buf[m_read];
m_read = (m_read + 1) % m_buf.size();
}
return n;
}
private:
std::vector<BYTE> m_buf;
size_t m_read;
size_t m_write;
std::mutex m_mutex;
};
缓冲区大小按 100ms 一帧 12 字节算,一秒约 120 字节,4096 已经留了三十多秒余量。写满时丢最老的字节,保证新数据能进来,同时不越界。这个策略适合「帧有校验、丢一帧可接受」的采集场景;如果协议不允许丢帧,就要在写满时置错误标志,让上层决定是断开还是清空重来。
4.2 接收缓冲区的环形队列与帧切分
帧切分不能靠「收到多少字节就切多少」,要有帧头和长度。假设协议是 0xAA 0x55 + 长度 + 数据 + 校验和,切帧函数先找帧头,再按长度等整帧,校验失败只丢帧头,不整段清空。整段清空会把后面已经到达的下一帧一起扔掉,表现就是「偶尔丢一帧,频率还不固定」。
cpp复制void CSerialDemoDlg::ParseFrames()
{
BYTE tmp[256];
size_t n = m_ring.Read(tmp, sizeof(tmp));
m_parseBuf.insert(m_parseBuf.end(), tmp, tmp + n);
while (m_parseBuf.size() >= 4)
{
// 找帧头 0xAA 0x55
size_t i = 0;
while (i + 1 < m_parseBuf.size() &&
!(m_parseBuf[i] == 0xAA && m_parseBuf[i + 1] == 0x55))
++i;
if (i > 0)
m_parseBuf.erase(m_parseBuf.begin(), m_parseBuf.begin() + i);
if (m_parseBuf.size() < 4)
break;
BYTE len = m_parseBuf[2];
size_t frameLen = 3 + len + 1; // 帧头2 + 长度1 + 数据len + 校验1
if (m_parseBuf.size() < frameLen)
break; // 半帧,等下一批数据
if (CheckSum(m_parseBuf.data(), frameLen - 1) == m_parseBuf[frameLen - 1])
{
OnFrame(m_parseBuf.data(), frameLen);
m_parseBuf.erase(m_parseBuf.begin
