CSerialPort跨平台串口类库2020-04-29

如需转载请标明出处：http://blog.csdn.net/itas109
QQ技术交流群：129518033

相关：
windows串口编程
linux串口编程
串口类库
串口第三方库
serial port communication class
Serial Programming Guide
windows串口编程C/C++
串口通信类库

前言

CSerialPort是一份优秀的串口类文件，好多的地方值得我们学习，具体在多线程，事件，自定义消息，类的封装方面等等。 Remon提供的串口类网址为： https://www.codeguru.com/cpp/i-n/network/serialcommunications/article.php/c2483/A-communication-class-for-serial-port.htm，由于已经运行十几年了，原文的问答部分列出来这么多年来的问题，经过网友们的总结，补充和修改原来代码后，整理出一份相对比较完美的代码。

但是，CSerialPort只适应于Windows平台，我们希望有一个轻量级、跨平台、高效的串口通信类库。因此，这里将设计一个以CSerialPort命名的跨平台类库。

为什么会再写一篇文章，因为CSDN的评论系统有问题，博文CSerialPort串口类最新修正版2018-06-21无法显示评论。多次给官方反映没有结果。

本文最新修改时间：2020-04-29

news 最近进展

跨平台串口类库CSerialPort：
目前进展

2019-07-28：
Windows:
1.支持异步和同步方式串口读写
2.精简sigslot代码
Unix & Unix Like:
1.支持异步方式串口读写
2.基本功能完成

2018-11-20
Windows:
1.重新设计多线程，支持读写并发
2.重新设计通知模块，提高读写效率
Unix & Unix Like:
框架搭建完成…

2020-01-08
跨平台基础稳定版v4.0.2发布

新的跨平台类库，将具有极高的扩展性，开发者可以自己设计自己平台的类库

2020-04-29

v4.0.3发布

Fixed:

fixed memory leak 修复内存泄露问题
Optimize function closePort under windows 优化windows下的closePort函数
#21 typo setFlowControl
#22 function CSerialPortWinBase::openPort error when set error parameter
#24 sigslot can not define static
#26 linux receive miss 0x11 0x13 0x0d
fixed compile error when baudrate not difine 修复波特率未定义错误

Feature:

support mingw 支持mingw 4.8.2
support mac 支持mac 10.13
add Common baud rate 增加波特率
add test case by gtest 增加测试用例
add function CSerialPortInfo::availablePortInfos 增加通用串口信息枚举函数
support linux list ports add /dev/pts/* 支持linux虚拟串口

增加Chm说明文档
https://github.com/itas109/CSerialPort/wiki
English Document
https://github.com/itas109/CSerialPort/blob/master/doc/CSerialPort_doc_en.chm
简体中文文档
https://github.com/itas109/CSerialPort/blob/master/doc/CSerialPort_doc_cn.chm

a lightweight library of serial port, which can easy to read and write serical port on windows with C++

一个使用C++实现的轻量级串口类库，可以轻松在windows和linux下进行串口读写

License

since V3.0.0.171216 use LGPL v3 License

自 V3.0.0.171216版本后采用LGPL v3协议

Design Principles 设计原则

Cross-platform 跨平台
Easy use 简单易用
higher efficiency 高效

Todo List

1.通用通信协议封装
2.尽可能的封包完整数据给开发者，实际由开发者控制
3.基于通用通信协议的打包类库
4.跨平台类库的整合与分离，如定时器、多线程等

CSerialPort类地址：

https://github.com/itas109/CSerialPort

https://gitee.com/itas109/CSerialPort

Last Modify

跨平台版本

Version: 4.0.3.200429
by itas109 on 2020-04-29

下载地址：
https://download.csdn.net/download/itas109/12374409
https://github.com/itas109/CSerialPort/releases/tag/v4.0.3
https://gitee.com/itas109/CSerialPort/tree/v4.0.3

历史下载
v4.0.2

windows稳定版

CSerialPort_win_3.0.3

CSDN下载地址：

历史下载：
V3.0.3.180621
V3.0.2.180615

Result 结果

linux：

Gui 界面

Demo Path: CSerialPort/Demo/CommQT

No Gui 无界面

Demo Path: CSerialPort/Demo/CommNoGui

windows:

Gui 界面

Demo Path: CSerialPort/Demo/CommQT

No Gui 无界面

Demo Path : CSerialPort/Demo/CommNoGui

directory List

update : 2020-04-12

|-- CSerialPort # root
    |-- LICENSE # LGPL3.0 license
    |-- README.md
    |-- README-EN.md
    |-- VERSION # version 版本号
    |-- Demo # example 示例目录
    |   |-- CommMFC # CSerialPort MFC Demo use source code win32直接调用源码MFC程序示例
    |   |-- CommDLL # CSerialPort MFC Demo use Win32 Dll win32动态库MFC程序示例
    |   |-- CommQT # CSerialPort QT win/linux Demo QT win/linux 程序示例
    |   |-- CommNoGui # CSerialPort No Gui win/linux Demo win/linux无界面程序示例
    |-- doc # document 文档目录
    |   |-- CSerialPort_doc_cn.chm # Chinese documnet 简体中文说明书
    |   |-- CSerialPort_doc_en.chm # English documnet 英文说明书
    |   |-- directory_list.md # directory list 目录列表
    |   |-- FAQ.md # Frequently Asked Questions 常见问题回答
    |   |-- error_guide.md # error guide 错误指南文档
    |   |-- How To Use.txt
    |   |-- suspending.txt
    |-- lib # lib 库目录
    |   |-- Linux # windows lib windows库目录
    |       |-- compile.sh # sh compile 命令编译
    |       |-- Makefile # Makefile compile Makefile编译
    |   |-- Windows # windows lib windows库目录
    |       |-- VC12 # windows lib for vs2013 windows vs2013库目录
    |           |-- libcserialport
    |               |-- libcserialport
    |   |--  CMakeLists.txt # win/linux library cmake
    |-- pic # picture 图片
    |-- src # source 源代码
        |-- osplatformutil.h # os platform define 操作系统定义
        |-- SerialPort.cpp
        |-- SerialPort.h # Lightweight library of serial port, which can easy to read and write serical port on windows and linux with C++ 轻量级跨平台串口读写类库
        |-- SerialPortBase.cpp
        |-- SerialPortBase.h # CSerialPort Base class 串口基类 
        |-- SerialPortInfo.cpp
        |-- SerialPortInfo.h # CSerialPortInfo class 串口信息辅助类 
        |-- SerialPortInfoBase.cpp
        |-- SerialPortInfoBase.h # CSerialPortInfo Base class 串口信息辅助类基类 
        |-- SerialPortInfoUnixBase.cpp
        |-- SerialPortInfoUnixBase.h # CSerialPortInfo unix class unix串口信息辅助类基类 
        |-- SerialPortInfoWinBase.cpp
        |-- SerialPortInfoWinBase.h # CSerialPortInfo windows class windows串口信息辅助类基类 
        |-- SerialPortUnixBase.cpp
        |-- SerialPortUnixBase.h # CSerialPort unix Base class unix串口基类 
        |-- SerialPortWinBase.cpp
        |-- SerialPortWinBase.h # CSerialPort Windows Base class windows串口基类 
        |-- SerialPort_global.h # Global difine of CSerialPort 串口全局定义 
        |-- sigslot.h # signal and slot 信号与槽

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
https://github.com/itas109

解决COM10以上端口无法显示的问题
扩展可选择端口，最大值MaxSerialPortNum可以自定义
添加QueryKey()和Hkey2ComboBox两个方法，用于自动查询当前有效的串口号。

##by liquanhai on 2014-12-18

增加一些处理措施，主要是对减少CPU占用率