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佔用率