哎哟我去，根据最近老板催我干活的状态，大概我离去帝都某查水表研究所搬砖的日子不远了，那边的活要做一个系统，系统里面包含一个上位机软件，上位机软件和各种硬件各种通信，然后其中一个精密的东西通信用的是串口，于是，有了这篇东西；

作为一个Google的代码搬运工，我看了好多别人的串口代码，但是都发现没有封装得很简洁很给力的API；

之前用的某个代码扔给师弟用后，发现有些端口检测不到，而且接受数据那个模块是每收到一个字节就会调用一次回调函数，有没有接收完还要我自己写代码判断；

其他的代码完全没有把串口这个模块彻底封装起来，在MFC里面操作串口那些函数还和各种修改窗口的控件的代码混在一起，基本不具备可移植性；

再有一些代码就是很底层很细的，每次用起来都好麻烦的样子。。

考虑到到时帝都的工作环境是绝对不允许我接触互联网的，所以我现在只能把可以做的那些模块尽可能的完善掉，保证去到那不会出什么意外，至少出了意外我要可以在不google的情况下解决；再另外，又为了可以尽快滚离帝都，我需要一个几行就可以用得上的API代码；懒得找，没找着，于是乎，我花了点时间，读了某个几千行的强大的串口助手的源码，一边剥一边改，捣鼓出来一个简单易用不知道稳不稳定的API来了。。

东西我扔Github上了。。有爱自取。。

下面把说明也扔一份在这博客了(其实是为了水一篇博文)，搞不好可以帮助到路过的骚年们。。

食用方法：

环境：MFC，VS2008下测试通过；(实验室的机子没有跑得起VS2013的，所以没法测试，估计没问题。。)

需要添加文件：

• SerialPort.h
• SerialPort.cpp
• SerialPortApi.h
• SerialPortApi.cpp

设置头文件：

#include "SerialPortApi.h"

添加封装的API变量：

CSerialPortApi COMPort;

打开串口并设置定时器（其实不一定要定时器，可以再开一个线程监视）:

if(OPEN_PORT_SUCCESS == 
 COMPort.OpenPort("COM3",CBR_57600,8,NOPARITY,ONESTOPBIT)){
	SetTimer(RECV_TIMER_ID,50,NULL);
}
else{
	AfxMessageBox(COMPort.ErrorMsg());
}

定时器/监视线程内部读取数据方法：

if(COMPort.ReceiveFlag){//检测是否有接收到数据
	CString str += COMPort.ReadRecv();
	//Todo
}

发送数据：

COMPort.Send(str);

关闭串口：

COMPort.ClosePort();

妈蛋就这么几个，为什么别人要搞这么复杂？！

API说明：

1.打开串口：

INT CSerialPortApi::OpenPort(
       CString sPort,
       DWORD dwBaudRate,
       BYTE byDataBits,
       BYTE byParity,
       BYTE byStopBits);

输入参数：

• sPort:端口号，一定要属于PortList(见下文)中的元素，否则会返回错误；
• dwBaudRate:波特率，使用BAUDRATE中的宏元素，否则会返回错误；

static const DWORD BAUDRATE[] = {
CBR_110,CBR_300,CBR_600,CBR_1200,CBR_2400,
CBR_4800,CBR_9600,CBR_14400,CBR_19200,
CBR_38400,CBR_56000 ,CBR_57600,
CBR_115200 ,CBR_128000 ,CBR_256000};

• byDataBits:数据位，可选值只有6,7,8，否则返回错误；
• byParity:校验位，使用PARITY中的宏元素(分别表示无校验,奇校验,偶校验,标记,空格)，否则会返回错误；

static const DWORD PARITY[] = {
NOPARITY,ODDPARITY,EVENPARITY,MARKPARITY,SPACEPARITY};

• byStopBits:停止位，使用STOPBITS中的宏元素(分别表示1,1.5,2)，否则会返回错误；

static const DWORD STOPBITS[]={
ONESTOPBIT,ONE5STOPBITS,TWOSTOPBITS};

返回值：

• 串口名有误： PORT_NUM_INVALID
• 波特率有误：BAUDRATE_INVALID
• 数据位有误：DATABITS_INVALID
• 校验位有误：PARITY_INVALID
• 停止位有误：STOPBIT_INVALID
• 成功：OPEN_PORT_SUCCESS
• 打开失败：OPEN_PORT_FAIL

OPEN_PORT_FAIL的详细错误信息可以用CString CSerialPortApi::ErrorMsg()获取，另外如果打开串口失败又找不到原因的话，可以将SerialPortApi.h中的：

#define PORT_DEBUG_MODE 0

改成：

#define PORT_DEBUG_MODE 1

这样出错了会以弹窗显示错误原因；

2.关闭串口：

返回值:

• 成功：CLOSE_PORT_SUCCESS
• 失败：CLOSR_PORT_FAIL

3.发送数据：

输入参数：

• str：待发送数据

4.读取数据：

返回值:

• 读取到的数据

说明：读取数据之前请先判断ReceiveFlag是否为TRUE,否则读到的是空字符串；

5.读取错误信息：

返回值:

• 错误代码和错误消息

可用变量和方法：

1.可用的端口：
CString PortList[MAX_PORT_NUM];

2.获取可用的端口数目：
size_t GetPortNum();

3.缓冲区是否有接受数据未读取：
BOOL ReceiveFlag;

Private函数说明：

说明：由于是私有函数，这一部分函数原则上是无法直接拿来用的，使用者原则上无需知晓内部怎么实现，如为了读代码或者修复BUG可以稍作了解；

1.获取所有可用的端口：

基于读取注册表项HARDWARE\DEVICEMAP\SERIALCOMM，理论上和设备管理器看到的一样。

调用后将会初始化CSerialPortApi内的两个变量:PortNum,PortList,分别表示读取到的串口的数目和列表;

API类变量外部读取PortNum要使用size_t GetPortNum()函数；

getExistPort放在了CSerialPortApi的构造函数中，所以定义变量后即可读取PortList;

2.发送数据线程:

线程开启后，只要b_portIsOpen为TRUE，即一直在一个while循环中等待，由m_hSendEvent变量激活发送模块，激活方法是:SetEvent(m_hSendEvent);,激活后即会发送Str4Send中的信息；

3.接受数据线程:

该线程如果接收到数据，会把数据放到deque m_dequeRevData的尾部，并且设置ReceiveFlag为TRUE;

如果检测到ReceiveFlag为TRUE，可以调用ReadRecv()读取数据，将读取到的缓存数据转化为CString类型变量返回，并且清空队列,设置ReceiveFlag为FALSE；

由于采用了信号锁机制，所以不会发生RevThreadProc对m_dequeRevData写信息的同时ReadRecv()对m_dequeRevData读信息这种事情；

其他：

如果想像串口助手等辅助软件一样添加若干个CComboBox,然后供用户选择的话，可以设置如下五个CComboBox变量关联相关控件：

CComboBox m_port;
CComboBox m_baudrate;
CComboBox m_parity;
CComboBox m_databits;
CComboBox m_stopbits;

然后使用下面代码初始化即可:

	m_port.ResetContent();

	//Set Port
	for(size_t i = 0;i < COMPort.GetPortNum();i++)
	{
		m_port.AddString(COMPort.PortList[i]);
	}
	m_port.SetCurSel(0);

	//Set Baudrate
	CString str = "";
	m_baudrate.ResetContent();
	int i = 0;
	for(i = 0;i<sizeof(BAUDRATE)/sizeof(DWORD);i++)
	{
		str.Format(_T("%d"),BAUDRATE[i]);
		m_baudrate.AddString(str);
	}
	m_baudrate.SelectString(-1,"57600");

	m_parity.ResetContent();
	m_parity.AddString(_T("无校验"));
	m_parity.AddString(_T("奇校验"));
	m_parity.AddString(_T("偶校验"));
	m_parity.AddString(_T("标记"));
	m_parity.AddString(_T("空格"));
	m_parity.SetCurSel(0);

	m_databits.ResetContent();
	m_databits.AddString(_T("6"));
	m_databits.AddString(_T("7"));
	m_databits.AddString(_T("8"));
	m_databits.SelectString(-1,"8");

	m_stopbits.ResetContent();
	m_stopbits.AddString(_T("1"));
	m_stopbits.AddString(_T("1.5"));
	m_stopbits.AddString(_T("2"));
	m_stopbits.SetCurSel(0);

以上！！【唉~刷完存在感~浑身舒畅！！】

【完】

本文内容遵从CC版权协议，转载请注明出自http://www.kylen314.com