CSerialPort串口类最新修正版(解决关闭死锁问题)2011-11-06

liquanhai 2011-11-07 09:01:37
本文分享给大家的是CSerialPort串口类最新修正版（2011-11-06），一个串口控件能屹立14年不倒唯有CSerialPort类。

Remon提供的串口类原帖网址为：http://codeguru.earthweb.com/network/serialport.shtml， 原文的问答部分罗列出来这么多年来的问题，经过网友们的总结归纳，补充和修改原来代码后，整理出一份相对比较完美的代码。
这是一份优秀的类文件，好多的地方值得我们学习，具体在多线程，事件，自定义消息，类的封装方面等等。

本文附带一份小项目的源代码，它超越了串口助手，给人一种耳目一新的感觉。亮点如下：

1. 它解决了串口关闭时出现线程出现死锁，软件关闭后，进程在后台没有关闭问题（所谓的线程死锁），可以直接用到开发的项目上。
2. 并且是扩展了的串口助手，具有通信协议编辑和使用功能，
3. 软件升级检测，值得做软件升级例子使用。
4. 最重要的是源代码很不错，很值得大家去研究。
分享给需要的朋友们，有问题，可以在留言，以便做进一步修正。
详情参见：
http://blog.csdn.net/liquanhai/article/details/6941574
...全文
1212 13 打赏 收藏 转发到动态 举报
AI 作业
写回复
用AI写文章
13 条回复
切换为时间正序
请发表友善的回复…
发表回复
longzhishen 2014-04-15
  • 打赏
  • 举报
 回复
引用 16 楼 jzli2011 的回复:
为什么win32项目会报错呢？
CWnd 这些带 C 开头的都是微软 MFC 封装类，WIN32 默认不使用 MFC，所以会报错。
一笑倾人城 2014-03-19
  • 打赏
  • 举报
 回复
为什么win32项目会报错呢？

zyp904 2013-12-26
  • 打赏
  • 举报
 回复
我是初学者，已经研究了好几天 CSerialPort这个类了，程序总是出现WaitCommEvent（）Failed with the following error：句柄无效 Port：1. 希望这个新的能好用，下下来试试。多谢楼主
Antony_WU_SZ 2011-11-11
  • 打赏
  • 举报
 回复
用API自写，很容易出现死机问题...up,up,up!
Antony_WU_SZ 2011-11-11
  • 打赏
  • 举报
 回复
用API自写，很容易出现死机问题...up,up,up!
liquanhai 2011-11-11
  • 打赏
  • 举报
 回复
如何添加CSerialPort类以及相应的消息函数
Step1:
将类文件SerialPort.cpp和SerialPort.h复制到工程所在的文件夹中，然后点击VC菜单上的Project->Add to Project->Files,再在打开的对话框里选择上面的两个文件，单击OK，就把类文件加入了当前工程，在Dlg.h中添加SerialPort.h说明：#include"SerialPort.h"，完成这个类的加入。
Step2:
在Dlg.h中定义CSerialPort类对象，这里定义的类对象为m_SerialPort,在定义一个布尔型的变量m_bSerialPortOpened用来标志串口是否打开。在CSerialPort类中有多个串口事件可以响应，在一般的串口编程中，只需要处理WM_COMM_RXCHAR消息就可以了，该类的所有消息均需要人工添加消息处理函数。将处理函数名定义为OnComm()，首先在Dlg.h中添加字符接收消息WM_COMM_RXCHAR（串口接收缓冲区内有一个字符）的响应函数声明：
// Generated message map functions
//{{AFX_MSG(CV2Dlg)
afx_msg LONG OnComm(WPARAM ch,LPARAM port);
//}}AFX_MSG
在Dlg.cpp文件中进行WM_COMM_RXCHAR消息映射：
BEGIN_MESSAGE_MAP(CV2Dlg, CDialog)
//{{AFX_MSG_MAP(CV2Dlg)
ON_MESSAGE(WM_COMM_RXCHAR,OnComm)
//}}AFX_MSG_MAP
在Dlg.cpp文件中加入函数OnComm()的实现，并在其中完成对接收到字符的处理。
LONG CV2Dlg::OnComm(WPARAM ch,LPARAM port)
{
……
return 0;
}
好了，这样就完成了这个类的添加了。个人感觉这个类还是不错的，至少比VC上带的控件要好很多，很容易掌握的
liquanhai 2011-11-09
  • 打赏
  • 举报
 回复
liquanhai 2011-11-09
  • 打赏
  • 举报
 回复
下载已经被推荐了，O(∩_∩)O谢谢~！
liquanhai 2011-11-08
  • 打赏
  • 举报
 回复
好的代码值得借鉴和学习，我想每个做上位机开发的同道都值得认真研究这份代码。
liquanhai 2011-11-08
  • 打赏
  • 举报
 回复
此外总结一下：
串口的封装类最有名的有两个
1. CserialPort：Remon Spekreijse写的串口类，经历了十几年的考验了。 http://www.codeguru.com/cpp/i-n/network/serialcommunications/article.php/c2483
2. CnComm：堪称国人封装的最好串口类http://blog.csdn.net/wujian53/

其他的都类似，或者改进版，建议初学者认真研究一下这两个类即可！
pirate1986 2011-11-08
  • 打赏
  • 举报
 回复
刚好现在正用到，谢谢了
liquanhai 2011-11-08
  • 打赏
  • 举报
 回复
希望做上位机的朋友帮着顶一下，O(∩_∩)O~
havedown 2011-11-07
  • 打赏
  • 举报
 回复
虽然串口的都是自已用SDK在写。

还是要谢谢楼主share.
CSerialPort串口类最新修正版2016-08-02
CSerialPort First Version by Remon Spekreijse on 2000-02-08 http://www.codeguru.com/cpp/i-n/network/serialcommunications/article.php/c2483/A-communication-class-for-serial-port.htm Second Version by mrlong on 2007-12-25 https://code.google.com/p/mycom/ 增加 ClosePort 增加 WriteToPort 两个方法 增加 SendData 与 RecvData 方法 by liquanhai on 2011-11-04 http://blog.csdn.net/liquanhai/article/details/4955253 增加 ClosePort 中交出控制权，防止死锁问题 by liquanhai on 2011-11-06 http://blog.csdn.net/liquanhai/article/details/6941574 增加 ReceiveChar 中防止线程死锁 by viruscamp on 2013-12-04 https://github.com/viruscamp/CSerialPort 增加 IsOpen 判断是否打开 修正 InitPort 中 parity Odd Even 参数取值错误 修改 InitPort 中 portnr 取值范围，portnr>9 时特殊处理 取消对 MFC 的依赖，使用 HWND 替代 CWnd，使用 win32 thread 函数而不是 MFC 的 增加用户消息编号自定义，方法来自 CnComm by itas109 on 2014-01-10 http://blog.csdn.net/itas109/article/details/18358297 解决COM10以上端口无法显示的问题 扩展可选择端口，最大值MaxSerialPortNum可以自定义 添加QueryKey()和Hkey2ComboBox两个方法，用于自动查询当前有效的串口号。 by liquanhai on 2014-12-18 增加一些处理措施，主要是对减少CPU占用率 by itas109 on 2016-05-07 http://blog.csdn.net/itas109 修复每次打开串口发送一次，当串口无应答时，需要关闭再打开或者接收完数据才能发送的问题。 解决办法：在m_hEventArray中调整m_hWriteEvent的优先级高于读的优先级。CommThread(LPVOID pParam)函数中读写的位置也调换。 参考：http://zhidao.baidu.com/link?url=RSrbPcfTZRULFFd2ziHZPBwnoXv1iCSu_Nmycb_yEw1mklT8gkoNZAkWpl3UDhk8L35DtRPo5VV5kEGpOx-Gea 修复停止位在头文件中定义成1导致SetCommState报错的问题，应为1对应的停止位是1.5。UINT stopsbits = ONESTOPBIT switch(stopbits)和switch(parity)增加默认情况，增强程序健壮性 by itas109 on 2016-06-22 http://blog.csdn.net/itas109 增加ReceiveStr方法，用于接收字符串（接收缓冲区有多少字符就接收多少字符）。 解决ReceiveChar只能接收单个字符的问题。 by itas109 on 2016-06-29 http://blog.csdn.net/itas109 解决RestartMonitoring方法和StopMonitoring方法命令不准确引起的歧义，根据实际作用。 将RestartMonitoring更改为ResumeMonitoring，将StopMonitoring更改为SuspendMonitoring。 增加IsThreadSuspend方法，用于判断线程是否挂起。 改进ClosePort方法，增加线程挂起判断，解决由于线程挂起导致串口关闭死锁的问题。 增加IsReceiveString宏定义，用于接收时采用单字节接收还是多字节接收 by itas109 on 2016-08-02 http://blog.csdn.net/itas109 https://github.com/itas109 改进IsOpen方法，m_hComm增加INVALID_HANDLE_VALUE的情况，因为CreateFile
CSerialPort串口类最新修正版2016-08-10
CSerialPort First Version by Remon Spekreijse on 2000-02-08 http://www.codeguru.com/cpp/i-n/network/serialcommunications/article.php/c2483/A-communication-class-for-serial-port.htm Second Version by mrlong on 2007-12-25 https://code.google.com/p/mycom/ 增加 ClosePort 增加 WriteToPort 两个方法 增加 SendData 与 RecvData 方法 by liquanhai on 2011-11-04 http://blog.csdn.net/liquanhai/article/details/4955253 增加 ClosePort 中交出控制权，防止死锁问题 by liquanhai on 2011-11-06 http://blog.csdn.net/liquanhai/article/details/6941574 增加 ReceiveChar 中防止线程死锁 by viruscamp on 2013-12-04 https://github.com/viruscamp/CSerialPort 增加 IsOpen 判断是否打开 修正 InitPort 中 parity Odd Even 参数取值错误 修改 InitPort 中 portnr 取值范围，portnr>9 时特殊处理 取消对 MFC 的依赖，使用 HWND 替代 CWnd，使用 win32 thread 函数而不是 MFC 的 增加用户消息编号自定义，方法来自 CnComm by itas109 on 2014-01-10 http://blog.csdn.net/itas109/article/details/18358297 解决COM10以上端口无法显示的问题 扩展可选择端口，最大值MaxSerialPortNum可以自定义 添加QueryKey()和Hkey2ComboBox两个方法，用于自动查询当前有效的串口号。 by liquanhai on 2014-12-18 增加一些处理措施，主要是对减少CPU占用率 by itas109 on 2016-05-07 http://blog.csdn.net/itas109 修复每次打开串口发送一次，当串口无应答时，需要关闭再打开或者接收完数据才能发送的问题。 解决办法：在m_hEventArray中调整m_hWriteEvent的优先级高于读的优先级。CommThread(LPVOID pParam)函数中读写的位置也调换。 参考：http://zhidao.baidu.com/link?url=RSrbPcfTZRULFFd2ziHZPBwnoXv1iCSu_Nmycb_yEw1mklT8gkoNZAkWpl3UDhk8L35DtRPo5VV5kEGpOx-Gea 修复停止位在头文件中定义成1导致SetCommState报错的问题，应为1对应的停止位是1.5。UINT stopsbits = ONESTOPBIT switch(stopbits)和switch(parity)增加默认情况，增强程序健壮性 by itas109 on 2016-06-22 http://blog.csdn.net/itas109 增加ReceiveStr方法，用于接收字符串（接收缓冲区有多少字符就接收多少字符）。 解决ReceiveChar只能接收单个字符的问题。 by itas109 on 2016-06-29 http://blog.csdn.net/itas109 解决RestartMonitoring方法和StopMonitoring方法命令不准确引起的歧义，根据实际作用。 将RestartMonitoring更改为ResumeMonitoring，将StopMonitoring更改为SuspendMonitoring。 增加IsThreadSuspend方法，用于判断线程是否挂起。 改进ClosePort方法，增加线程挂起判断，解决由于线程挂起导致串口关闭死锁的问题。 增加IsReceiveString宏定义，用于接收时采用单字节接收还是多字节接收 by itas109 on 2016-08-02 http://blog.csdn.net/itas109 https://github.com/itas109 改进IsOpen方法，m_hComm增加INVALID_HANDLE_VALUE的情况，因为CreateFile
CSerialPort串口类最新修正版2016-06-29
CSerialPort First Version by Remon Spekreijse on 2000-02-08 http://www.codeguru.com/cpp/i-n/network/serialcommunications/article.php/c2483/A-communication-class-for-serial-port.htm Second Version by mrlong on 2007-12-25 https://code.google.com/p/mycom/ 增加 ClosePort 增加 WriteToPort 两个方法 增加 SendData 与 RecvData 方法 by liquanhai on 2011-11-04 http://blog.csdn.net/liquanhai/article/details/4955253 增加 ClosePort 中交出控制权，防止死锁问题 by liquanhai on 2011-11-06 http://blog.csdn.net/liquanhai/article/details/6941574 增加 ReceiveChar 中防止线程死锁 by viruscamp on 2013-12-04 https://github.com/viruscamp/CSerialPort 增加 IsOpen 判断是否打开 修正 InitPort 中 parity Odd Even 参数取值错误 修改 InitPort 中 portnr 取值范围，portnr>9 时特殊处理 取消对 MFC 的依赖，使用 HWND 替代 CWnd，使用 win32 thread 函数而不是 MFC 的 增加用户消息编号自定义，方法来自 CnComm by itas109 on 2014-01-10 http://blog.csdn.net/itas109/article/details/18358297 解决COM10以上端口无法显示的问题 扩展可选择端口，最大值MaxSerialPortNum可以自定义 添加QueryKey()和Hkey2ComboBox两个方法，用于自动查询当前有效的串口号。 by liquanhai on 2014-12-18 增加一些处理措施，主要是对减少CPU占用率 by itas109 on 2016-05-07 http://blog.csdn.net/itas109 修复每次打开串口发送一次，当串口无应答时，需要关闭再打开或者接收完数据才能发送的问题。 解决办法：在m_hEventArray中调整m_hWriteEvent的优先级高于读的优先级。CommThread(LPVOID pParam)函数中读写的位置也调换。 参考：http://zhidao.baidu.com/link?url=RSrbPcfTZRULFFd2ziHZPBwnoXv1iCSu_Nmycb_yEw1mklT8gkoNZAkWpl3UDhk8L35DtRPo5VV5kEGpOx-Gea 修复停止位在头文件中定义成1导致SetCommState报错的问题，应为1对应的停止位是1.5。UINT stopsbits = ONESTOPBIT switch(stopbits)和switch(parity)增加默认情况，增强程序健壮性 by itas109 on 2016-06-22 http://blog.csdn.net/itas109 增加ReceiveStr方法，用于接收字符串（接收缓冲区有多少字符就接收多少字符）。 解决ReceiveChar只能接收单个字符的问题。 by itas109 on 2016-06-29 http://blog.csdn.net/itas109 解决RestartMonitoring方法和StopMonitoring方法命令不准确引起的歧义，根据实际作用。 将RestartMonitoring更改为ResumeMonitoring，将StopMonitoring更改为SuspendMonitoring。 增加IsThreadSuspend方法，用于判断线程是否挂起。 改进ClosePort方法，增加线程挂起判断，解决由于线程挂起导致串口关闭死锁的问题。 增加IsReceiveString宏定义，用于接收时采用单字节接收还是多字节接收 博客：blog.csdn.net/itas109 Email:itas109@qq.com
CSerialPort串口类最新修正版2017-02-14
CSerialPort First Version by Remon Spekreijse on 2000-02-08 http://www.codeguru.com/cpp/i-n/network/serialcommunications/article.php/c2483/A-communication-class-for-serial-port.htm Second Version by mrlong on 2007-12-25 https://code.google.com/p/mycom/ 增加 ClosePort 增加 WriteToPort 两个方法 增加 SendData 与 RecvData 方法 by liquanhai on 2011-11-04 http://blog.csdn.net/liquanhai/article/details/4955253 增加 ClosePort 中交出控制权，防止死锁问题 by liquanhai on 2011-11-06 http://blog.csdn.net/liquanhai/article/details/6941574 增加 ReceiveChar 中防止线程死锁 by viruscamp on 2013-12-04 https://github.com/viruscamp/CSerialPort 增加 IsOpen 判断是否打开 修正 InitPort 中 parity Odd Even 参数取值错误 修改 InitPort 中 portnr 取值范围，portnr>9 时特殊处理 取消对 MFC 的依赖，使用 HWND 替代 CWnd，使用 win32 thread 函数而不是 MFC 的 增加用户消息编号自定义，方法来自 CnComm by itas109 on 2014-01-10 http://blog.csdn.net/itas109/article/details/18358297 解决COM10以上端口无法显示的问题 扩展可选择端口，最大值MaxSerialPortNum可以自定义 添加QueryKey()和Hkey2ComboBox两个方法，用于自动查询当前有效的串口号。 by liquanhai on 2014-12-18 增加一些处理措施，主要是对减少CPU占用率 by itas109 on 2016-05-07 http://blog.csdn.net/itas109 修复每次打开串口发送一次，当串口无应答时，需要关闭再打开或者接收完数据才能发送的问题。 解决办法：在m_hEventArray中调整m_hWriteEvent的优先级高于读的优先级。CommThread(LPVOID pParam)函数中读写的位置也调换。 参考：http://zhidao.baidu.com/link?url=RSrbPcfTZRULFFd2ziHZPBwnoXv1iCSu_Nmycb_yEw1mklT8gkoNZAkWpl3UDhk8L35DtRPo5VV5kEGpOx-Gea 修复停止位在头文件中定义成1导致SetCommState报错的问题，应为1对应的停止位是1.5。UINT stopsbits = ONESTOPBIT switch(stopbits)和switch(parity)增加默认情况，增强程序健壮性 by itas109 on 2016-06-22 http://blog.csdn.net/itas109 增加ReceiveStr方法，用于接收字符串（接收缓冲区有多少字符就接收多少字符）。 解决ReceiveChar只能接收单个字符的问题。 by itas109 on 2016-06-29 http://blog.csdn.net/itas109 解决RestartMonitoring方法和StopMonitoring方法命令不准确引起的歧义，根据实际作用。 将RestartMonitoring更改为ResumeMonitoring，将StopMonitoring更改为SuspendMonitoring。 增加IsThreadSuspend方法，用于判断线程是否挂起。 改进ClosePort方法，增加线程挂起判断，解决由于线程挂起导致串口关闭死锁的问题。 增加IsReceiveString宏定义，用于接收时采用单字节接收还是多字节接收 by itas109 on 2016-08-02 http://blog.csdn.net/itas109 https://github.com/itas109 改进IsOpen方法，m_hComm增加INVALID_HANDLE_VALUE的情况，因为CreateFile方法失败返回的是INVALID_HANDLE_VALUE，不是NULL 改进ClosePort方法：增加串口句柄无效的判断(防止关闭死锁)；m_hWriteEvent不使用CloseHandle关闭 改进CommThread、ReceiveChar、ReceiveStr和WriteChar方法中异常处理的判断，增加三种判断：串口打开失败(error code:ERROR_INVALID_HANDLE)、连接过程中非法断开(error code:ERROR_BAD_COMMAND)和拒绝访问(error code:ERROR_ACCESS_DENIED) 采用安全函数sprintf_s和strcpy_s函数替换掉sprintf和strcpy 改进QueryKey方法，用于查询注册表的可用串口值，可以搜索到任意的可用串口 改进InitPort方法，串口打开失败，增加提示信息:串口不存在(error code:ERROR_FILE_NOT_FOUND)和串口拒绝访问(error code:ERROR_ACCESS_DENIED) 加入viruscamp 取消对 MFC 的依赖 改进InitPort方法，如果上次串口是打开，再次调用InitPort方法，关闭串口需要做一定的延时，否则有几率导致ERROR_ACCESS_DENIED拒绝访问，也就是串口占用问题 初始化默认波特率修改为9600 修复一些释放的BUG 规范了一些错误信息，参考winerror.h -- error code definitions for the Win32 API functions 删除SendData和RecvData方法 by itas109 on 2016-08-10 http://blog.csdn.net/itas109 https://github.com/itas109 改进ReceiveStr方法，comstat.cbInQue = 0xcccccccc的情况（如串口异常断开），会导致RXBuff初始化失败 by itas109 on 2017-02-14 http://blog.csdn.net/itas109 https://github.com/itas109 兼容ASCII和UNICODE编码 ReceiveStr函数中发送函数SendMessage的第二个参数采用结构体形式，包括portNr串口号和bytesRead读取的字节数，可以处理16进制的时候0x00截断问题 精简不必要的函数SendData和RecvData 尽量的取消对 MFC 的依赖，Hkey2ComboBox函数暂时保留 其他小问题修改 博客：blog.csdn.net/itas109 Email:itas109@qq.com
CSerialPort串口类最新修正版2016-05-07
CSerialPort =========== First Version by Remon Spekreijse on 2000-02-08 http://www.codeguru.com/cpp/i-n/network/serialcommunications/article.php/c2483/A-communication-class-for-serial-port.htm Second Version by mrlong on 2007-12-25 https://code.google.com/p/mycom/ * 增加 ClosePort * 增加 WriteToPort 两个方法 * 增加 SendData 与 RecvData 方法 by liquanhai on 2011-11-04 http://blog.csdn.net/liquanhai/article/details/4955253 * 增加 ClosePort 中交出控制权，防止死锁问题 by liquanhai on 2011-11-06 http://blog.csdn.net/liquanhai/article/details/6941574 * 增加 ReceiveChar 中防止线程死锁 by viruscamp on 2013-12-04 https://github.com/viruscamp/CSerialPort * 增加 IsOpen 判断是否打开 * 修正 InitPort 中 parity Odd Even 参数取值错误 * 修改 InitPort 中 portnr 取值范围，portnr>9 时特殊处理 * 取消对 MFC 的依赖，使用 HWND 替代 CWnd，使用 win32 thread 函数而不是 MFC 的 * 增加用户消息编号自定义，方法来自 CnComm by itas109 on 2014-01-10 http://blog.csdn.net/itas109/article/details/18358297 * 解决COM10以上端口无法显示的问题 * 扩展可选择端口，最大值MaxSerialPortNum可以自定义 * 添加QueryKey()和Hkey2ComboBox两个方法，用于自动查询当前有效的串口号。 by liquanhai on 2014-12-18 * 增加一些处理措施，主要是对减少CPU占用率 by itas109 on 2016-05-07 http://blog.csdn.net/itas109 * 修复每次打开串口发送一次，当串口无应答时，需要关闭再打开或者接收完数据才能发送的问题。 解决办法：在m_hEventArray中调整m_hWriteEvent的优先级高于读的优先级。CommThread(LPVOID pParam)函数中读写的位置也调换。 参考：http://zhidao.baidu.com/link?url=RSrbPcfTZRULFFd2ziHZPBwnoXv1iCSu_Nmycb_yEw1mklT8gkoNZAkWpl3UDhk8L35DtRPo5VV5kEGpOx-Gea * 修复停止位在头文件中定义成1导致SetCommState报错的问题，应为1对应的停止位是1.5。UINT stopsbits = ONESTOPBIT * switch(stopbits)和switch(parity)增加默认情况，增强程序健壮性 博客：blog.csdn.net/itas109 Email:itas109@qq.com
界面

15,978

社区成员

115,866

社区内容

发帖
与我相关
我的任务
社区描述
VC/MFC 界面
社区管理员
  • 界面
加入社区
  • 近7日
  • 近30日
  • 至今

加载中

查看更多榜单
社区公告
暂无公告

试试用AI创作助手写篇文章吧

+ 用AI写文章