PC程序跟RS232串口进行通信算是比较老的题目了,不过老归老,只要用这个接口的硬件还在,就难免要去折腾它。而这个时候就会发现老的坏处在于资料都是半截入土,拍一拍烟尘四起,抖一抖蛛丝乱飞的玩意。
现在做这个的基本都是用的SerialPort这个类,而这个类的最新更新已经有一段岁月,所以本人在下载了这个东西之后,费了些功夫才将其修改到能运行在VS2015版本的PC程序上,在此把修改完的版本贴出来做下记录。并将一般调试串口程序都会用到的两个软件拿出来和大家分享。
OK,下面进入贴代码类的环节
SerialPort.h
//
/// COPYRIGHT NOTICE
/// Copyright (c) 2009, 华中科技大学tickTick Group (版权声明)
/// 2015,深圳大学 EDA实验室 黄伟鑫 修改
/// All rights reserved.
///
/// @file SerialPort.h
/// @brief 串口通信类头文件
///
/// 本文件完成串口通信类的声明
///
/// @version 1.0
/// @author 卢俊
/// @E-mail:lujun.hust@gmail.com
/// @date 2010/03/19
///
/// 修订说明:
//
#ifndef SERIALPORT_H_
#define SERIALPORT_H_
#define WM_COMM_RXCHAR WM_USER+7 //句柄,用以发送消息给主窗体
#include <Windows.h>
/** 串口通信类
*
* 本类实现了对串口的基本操作
* 例如监听发到指定串口的数据、发送指定数据到串口
*/
class CSerialPort
{
public:
CSerialPort(void);
~CSerialPort(void);
public:
/** 初始化串口函数
*
* @param: UINT portNo 串口编号,默认值为1,即COM1,注意,尽量不要大于9
* @param: UINT baud 波特率,默认为9600
* @param: char parity 是否进行奇偶校验,'Y'表示需要奇偶校验,'N'表示不需要奇偶校验
* @param: UINT databits 数据位的个数,默认值为8个数据位
* @param: UINT stopsbits 停止位使用格式,默认值为1
* @param: DWORD dwCommEvents 默认为EV_RXCHAR,即只要收发任意一个字符,则产生一个事件
* @return: bool 初始化是否成功
* @note: 在使用其他本类提供的函数前,请先调用本函数进行串口的初始化
* \n本函数提供了一些常用的串口参数设置,若需要自行设置详细的DCB参数,可使用重载函数
* \n本串口类析构时会自动关闭串口,无需额外执行关闭串口
* @see:
*/
bool InitPort(CWnd* pPortOwner, UINT portNo = 1, UINT baud = CBR_9600, char parity = 'N', UINT databits = 8,
UINT stopsbits = 1, DWORD dwCommEvents = EV_RXCHAR);
/** 串口初始化函数
*
* 本函数提供直接根据DCB参数设置串口参数
* @param: UINT portNo
* @param: const LPDCB & plDCB
* @return: bool 初始化是否成功
* @note: 本函数提供用户自定义地串口初始化参数
* @see:
*/
bool InitPort(UINT portNo, const LPDCB& plDCB);
/** 开启监听线程
*
* 本监听线程完成对串口数据的监听,并将接收到的数据打印到屏幕输出
* @return: bool 操作是否成功
* @note: 当线程已经处于开启状态时,返回flase
* @see:
*/
bool OpenListenThread();
/** 关闭监听线程
*
*
* @return: bool 操作是否成功
* @note: 调用本函数后,监听串口的线程将会被关闭
* @see:
*/
bool CloseListenTread();
/** 向串口写数据
*
* 将缓冲区中的数据写入到串口
* @param: unsigned char * pData 指向需要写入串口的数据缓冲区
* @param: unsigned int length 需要写入的数据长度
* @return: bool 操作是否成功
* @note: length不要大于pData所指向缓冲区的大小
* @see:
*/
bool WriteData(unsigned char* pData, unsigned int length);
/** 获取串口缓冲区中的字节数
*
*
* @return: UINT 操作是否成功
* @note: 当串口缓冲区中无数据时,返回0
* @see:
*/
UINT GetBytesInCOM();
/** 读取串口接收缓冲区中一个字节的数据
*
*
* @param: char & cRecved 存放读取数据的字符变量
* @return: bool 读取是否成功
* @note:
* @see:
*/
bool ReadChar(char &cRecved);
private:
/** 打开串口
*
*
* @param: UINT portNo 串口设备号
* @return: bool 打开是否成功
* @note:
* @see:
*/
bool openPort(UINT portNo);
/** 关闭串口
*
*
* @return: void 操作是否成功
* @note:
* @see:
*/
void ClosePort();
/** 串口监听线程
*
* 监听来自串口的数据和信息
* @param: void * pParam 线程参数
* @return: UINT WINAPI 线程返回值
* @note:
* @see:
*/
static UINT WINAPI ListenThread(void* pParam);
CWnd* m_pOwner;//窗口句柄,用于跟主窗体进行通信
int mportNo;//记录串口
private:
/** 串口句柄 */
HANDLE m_hComm;
/** 线程退出标志变量 */
static bool s_bExit;
/** 线程句柄 */
volatile HANDLE m_hListenThread;
/** 同步互斥,临界区保护 */
CRITICAL_SECTION m_csCommunicationSync; //!< 互斥操作串口
};
#endif //SERIALPORT_H_
SerialPort.cpp
//
/// COPYRIGHT NOTICE
/// Copyright (c) 2009, 华中科技大学tickTick Group (版权声明)
/// 2015,深圳大学 EDA实验室 黄伟鑫 修改
/// All rights reserved.
///
/// @file SerialPort.cpp
/// @brief 串口通信类的实现文件
///
/// 本文件为串口通信类的实现代码
///
/// @version 1.0
/// @author 卢俊
/// @E-mail:lujun.hust@gmail.com
/// @date 2010/03/19
///
///
/// 修订说明:
//
#include "StdAfx.h"
#include "SerialPort.h"
#include <process.h>
#include <iostream>
/** 线程退出标志 */
bool CSerialPort::s_bExit = false;
/** 当串口无数据时,sleep至下次查询间隔的时间,单位:秒 */
const UINT SLEEP_TIME_INTERVAL = 5;
CSerialPort::CSerialPort(void)
: m_hListenThread(INVALID_HANDLE_VALUE)
{
m_hComm = INVALID_HANDLE_VALUE;
m_hListenThread = INVALID_HANDLE_VALUE;
InitializeCriticalSection(&m_csCommunicationSync);
}
CSerialPort::~CSerialPort(void)
{
CloseListenTread();
ClosePort();
DeleteCriticalSection(&m_csCommunicationSync);
}
bool CSerialPort::InitPort(CWnd* pPortOwner, UINT portNo /*= 1*/, UINT baud /*= CBR_9600*/, char parity /*= 'N'*/,
UINT databits /*= 8*/, UINT stopsbits /*= 1*/, DWORD dwCommEvents /*= EV_RXCHAR*/)
{
m_pOwner = pPortOwner;
/** 临时变量,将制定参数转化为字符串形式,以构造DCB结构 */
char szDCBparam[50];
sprintf_s(szDCBparam, "baud=%d parity=%c data=%d stop=%d", baud, parity, databits, stopsbits);
/** 打开指定串口,该函数内部已经有临界区保护,上面请不要加保护 */
if (!openPort(portNo))
{
return false;
}
/** 进入临界段 */
EnterCriticalSection(&m_csCommunicationSync);
/** 是否有错误发生 */
BOOL bIsSuccess = TRUE;
/** 在此可以设置输入输出的缓冲区大小,如果不设置,则系统会设置默认值.
* 自己设置缓冲区大小时,要注意设置稍大一些,避免缓冲区溢出
*/
/*if (bIsSuccess )
{
bIsSuccess = SetupComm(m_hComm,10,10);
}*/
/** 设置串口的超时时间,均设为0,表示不使用超时限制 */
COMMTIMEOUTS CommTimeouts;
CommTimeouts.ReadIntervalTimeout = 0;
CommTimeouts.ReadTotalTimeoutMultiplier = 0;
CommTimeouts.ReadTotalTimeoutConstant = 0;
CommTimeouts.WriteTotalTimeoutMultiplier = 0;
CommTimeouts.WriteTotalTimeoutConstant = 0;
if (bIsSuccess)
{
bIsSuccess = SetCommTimeouts(m_hComm, &CommTimeouts);
}
DCB dcb;
if (bIsSuccess)
{
// 将ANSI字符串转换为UNICODE字符串
DWORD dwNum = MultiByteToWideChar(CP_ACP, 0, szDCBparam, -1, NULL, 0);
wchar_t *pwText = new wchar_t[dwNum];
if (!MultiByteToWideChar(CP_ACP, 0, szDCBparam, -1, pwText, dwNum))
{
bIsSuccess = TRUE;
}
/** 获取当前串口配置参数,并且构造串口DCB参数 */
bIsSuccess = GetCommState(m_hComm, &dcb) && BuildCommDCB(pwText, &dcb);
/** 开启RTS flow控制 */
dcb.fRtsControl = RTS_CONTROL_ENABLE;
/** 释放内存空间 */
delete[] pwText;
}
if (bIsSuccess)
{
/** 使用DCB参数配置串口状态 */
bIsSuccess = SetCommState(m_hComm, &dcb);
}
/** 清空串口缓冲区 */
PurgeComm(m_hComm, PURGE_RXCLEAR | PURGE_TXCLEAR | PURGE_RXABORT | PURGE_TXABORT);
/** 离开临界段 */
LeaveCriticalSection(&m_csCommunicationSync);
return bIsSuccess == TRUE;
}
bool CSerialPort::InitPort(UINT portNo, const LPDCB& plDCB)
{
/** 打开指定串口,该函数内部已经有临界区保护,上面请不要加保护 */
if (!openPort(portNo))
{
return false;
}
/** 进入临界段 */
EnterCriticalSection(&m_csCommunicationSync);
/** 配置串口参数 */
if (!SetCommState(m_hComm, plDCB))
{
return false;
}
/** 清空串口缓冲区 */
PurgeComm(m_hComm, PURGE_RXCLEAR | PURGE_TXCLEAR | PURGE_RXABORT | PURGE_TXABORT);
/** 离开临界段 */
LeaveCriticalSection(&m_csCommunicationSync);
return true;
}
void CSerialPort::ClosePort()
{
/** 如果有串口被打开,关闭它 */
if (m_hComm != INVALID_HANDLE_VALUE)
{
CloseHandle(m_hComm);
m_hComm = INVALID_HANDLE_VALUE;
}
}
bool CSerialPort::openPort(UINT portNo)
{
/** 进入临界段 */
EnterCriticalSection(&m_csCommunicationSync);
mportNo = portNo;
/** 把串口的编号转换为设备名 */
char szPort[50];
sprintf_s(szPort, "COM%d", portNo);
/** 打开指定的串口 */
m_hComm = CreateFileA(szPort, /** 设备名,COM1,COM2等 */
GENERIC_READ | GENERIC_WRITE, /** 访问模式,可同时读写 */
0, /** 共享模式,0表示不共享 */
NULL, /** 安全性设置,一般使用NULL */
OPEN_EXISTING, /** 该参数表示设备必须存在,否则创建失败 */
0,
0);
/** 如果打开失败,释放资源并返回 */
if (m_hComm == INVALID_HANDLE_VALUE)
{
LeaveCriticalSection(&m_csCommunicationSync);
return false;
}
/** 退出临界区 */
LeaveCriticalSection(&m_csCommunicationSync);
return true;
}
bool CSerialPort::OpenListenThread()
{
/** 检测线程是否已经开启了 */
if (m_hListenThread != INVALID_HANDLE_VALUE)
{
/** 线程已经开启 */
return false;
}
s_bExit = false;
/** 线程ID */
UINT threadId;
/** 开启串口数据监听线程 */
m_hListenThread = (HANDLE)_beginthreadex(NULL, 0, ListenThread, this, 0, &threadId);
if (!m_hListenThread)
{
return false;
}
/** 设置线程的优先级,高于普通线程 */
if (!SetThreadPriority(m_hListenThread, THREAD_PRIORITY_ABOVE_NORMAL))
{
return false;
}
return true;
}
bool CSerialPort::CloseListenTread()
{
if (m_hListenThread != INVALID_HANDLE_VALUE)
{
/** 通知线程退出 */
s_bExit = true;
/** 等待线程退出 */
Sleep(10);
/** 置线程句柄无效 */
CloseHandle(m_hListenThread);
m_hListenThread = INVALID_HANDLE_VALUE;
}
return true;
}
UINT CSerialPort::GetBytesInCOM()
{
DWORD dwError = 0; /** 错误码 */
COMSTAT comstat; /** COMSTAT结构体,记录通信设备的状态信息 */
memset(&comstat, 0, sizeof(COMSTAT));
UINT BytesInQue = 0;
/** 在调用ReadFile和WriteFile之前,通过本函数清除以前遗留的错误标志 */
if (ClearCommError(m_hComm, &dwError, &comstat))
{
BytesInQue = comstat.cbInQue; /** 获取在输入缓冲区中的字节数 */
}
return BytesInQue;
}
UINT WINAPI CSerialPort::ListenThread(void* pParam)
{
/** 得到本类的指针 */
CSerialPort *pSerialPort = reinterpret_cast<CSerialPort*>(pParam);
// 线程循环,轮询方式读取串口数据
while (!pSerialPort->s_bExit)
{
UINT BytesInQue = pSerialPort->GetBytesInCOM();
/** 如果串口输入缓冲区中无数据,则休息一会再查询 */
if (BytesInQue == 0)
{
Sleep(SLEEP_TIME_INTERVAL);
continue;
}
/** 读取输入缓冲区中的数据并输出显示 */
char cRecved = 0x00;
do
{
cRecved = 0x00;
if (pSerialPort->ReadChar(cRecved) == true)
{
//std::cout << cRecved;
continue;
}
} while (--BytesInQue);
}
return 0;
}
bool CSerialPort::ReadChar(char &cRecved)
{
BOOL bResult = TRUE;
DWORD BytesRead = 0;
if (m_hComm == INVALID_HANDLE_VALUE)
{
return false;
}
/** 临界区保护 */
EnterCriticalSection(&m_csCommunicationSync);
/** 从缓冲区读取一个字节的数据 */
bResult = ReadFile(m_hComm, &cRecved, 1, &BytesRead, NULL);
if ((!bResult))
{
/** 获取错误码,可以根据该错误码查出错误原因 */
DWORD dwError = GetLastError();
/** 清空串口缓冲区 */
PurgeComm(m_hComm, PURGE_RXCLEAR | PURGE_RXABORT);
LeaveCriticalSection(&m_csCommunicationSync);
return false;
}
/** 离开临界区 */
LeaveCriticalSection(&m_csCommunicationSync);
::SendMessage((m_pOwner)->m_hWnd, WM_COMM_RXCHAR, (WPARAM)cRecved, (LPARAM)mportNo);
return (BytesRead == 1);
}
bool CSerialPort::WriteData(unsigned char* pData, unsigned int length)
{
BOOL bResult = TRUE;
DWORD BytesToSend = 0;
if (m_hComm == INVALID_HANDLE_VALUE)
{
return false;
}
/** 临界区保护 */
EnterCriticalSection(&m_csCommunicationSync);
/** 向缓冲区写入指定量的数据 */
bResult = WriteFile(m_hComm, pData, length, &BytesToSend, NULL);
if (!bResult)
{
DWORD dwError = GetLastError();
/** 清空串口缓冲区 */
PurgeComm(m_hComm, PURGE_RXCLEAR | PURGE_RXABORT);
LeaveCriticalSection(&m_csCommunicationSync);
return false;
}
/** 离开临界区 */
LeaveCriticalSection(&m_csCommunicationSync);
return true;
}
OK,这个类贴完了,用的时候包含这两个文件,然后在用到的文件里面包含.h文件就可以了。具体的是先创建一个CSerialPort对象
CSerialPort m_SerialPort;
然后初始化这个对象
m_SerialPort.InitPort(this, 2);//初始化
m_SerialPort.OpenListenThread();//开启侦听线程
到此,就可以往端口2写数据了,调用十分简单
m_SerialPort.WriteToPort(L"哈哈\n");
这样就写了个“哈哈”到端口中
而读数据比较麻烦一点,因为是串口读到字符会发条消息,我们需要去响应这个消息,具体的做法是在对话框类中声明一个消息响应函数
afx_msg LONG OnComm(WPARAM ch, LPARAM port);//串口字符接收消息
在对话框实现文件.cpp的BEGIN_MESSAGE_MAP和END_MESSAGE_MAP间添加消息和函数之间的绑定,也就是
BEGIN_MESSAGE_MAP(CComDemoDlg, CDialogEx)
/*在这里添加消息绑定*/
END_MESSAGE_MAP()
绑定代码如下
//串口消息映射
ON_MESSAGE(WM_COMM_RXCHAR, OnComm)
接着对响应函数进行编写即可,本人是这么写的,这个写法可以参考单不严谨,实际要用的话还是要做些修改
LONG CComDemoDlg::OnComm(WPARAM ch, LPARAM port)
{
if ((clock()- revtime)>(1000 / 9600+1))//间隔时间超时计算,这里本人将超过(1000 / 9600+1)时间间隔的两个字符分开,而在这个时间内的字符当成是一串字符,这个时间间隔的计算并不精确,如果需要严格按照波特率来判断字符串是否连接的话需要加以修改
{
printf("\n");
}
printf("%c", ch);
revtime = clock();
return 0;
}
OK,到此关于RS232通信的内容就讲完了,如果觉得还是比较乱的话可以下载文章最后的DEMO。下面介绍会用到的两个辅助软件,其一是Virtual Serial Port Driver 7.2,这个软件的用处在于虚拟出两个连接着的串口出来,你可以用程序绑定其中一个,然后发数据,用串口调试工具绑定另外一个来收程序,然后看看你的程序发送有没有问题。而接受也是一样的。另外一个辅助软件就是上面提到的串口调试助手了,没什么好说的。这两个程序会跟我的DEMO打包到一起。
DEMO和两个辅助工具地址(后来发现发布的DEMO有点问题,代码已经修改,请复制上面.h和.cpp两文件代码覆盖掉原来的)