常见串口问题
在正式开始代码之前,我们先说说在串口操作过程中,我们容易遇到的几个问题:
1、获取串口数据异常;
2、串口号大于10时,操作串口报异常。
针对问题1
我们解决方案是进行流控设置,因为一般是由于读写未同步,导致缓冲区满后,数据写入异常。流控相关知识及方法可参考:
串口使用系列学习之什么是流控
串口使用系列学习之C++如何进行流控
针对问题2
在Windows上,要打开COM10以后的串口(包括COM10),串口名称不再是“COM10”,而是“\.\COM10”,因此在open函数中,如果是COM10及以后的串口,串口名(假设当前要打开COM10)应该写“\\.\COM10”,其中“\\.\”为“\.\”的转义。
流控说明
软件流控:
fOutX:
XON/XOFF输出流量控制,用于判断发送时是否可用。
如果为TRUE,
当 XOFF 值被收到的时候,发送停止;
当 XON 值被收到的时候,发送继续
fInX:
XON/XOFF 输入流量控制在接收时是否可用。
如果为TRUE,
当 输入缓冲区已接收满XoffLim 字节时,发送XOFF字符;
当输入缓冲区已经有XonLim 字节的空余容量时,发送XON字符
简单说来就是,软件流控只要设置后,后面驱动会自动进行判断缓冲区什么时候能发送数据、什么时候能接收数据。
硬件流控
硬件流控在设置后,看设置情况,如果设置为DTR_CONTROL_HANDSHAKE,驱动会自动进行缓冲区数据收发控制,而设置为其他时,需要我们使用EscapeCommFunction函数,进行手动数据发送,通知串口是否可以发送数据。
串口打开、关闭、设置、流控、读写源码
以下源码基于https://github.com/ayowin/WZSerialPort上修改,增加流控部分代码。
头文件:
#ifndef _WZSERIALPORT_H
#define _WZSERIALPORT_H
/*
类名:WZSerialPort
用途:串口读写
示例:
参考 main.cpp
*/
class WzSerialPort
{
public:
enum FlowControl
{
NoFlowControl,
CtsRtsFlowControl,
CtsDtrFlowControl,
DsrRtsFlowControl,
DsrDtrFlowControl,
XonXoffFlowControl
};
WzSerialPort();
~WzSerialPort();
// 打开串口,成功返回true,失败返回false
// portname(串口名): 在Windows下是"COM1""COM2"等,在Linux下是"/dev/ttyS1"等
// baudrate(波特率): 9600、19200、38400、43000、56000、57600、115200
// parity(校验位): 0为无校验,1为奇校验,2为偶校验,3为标记校验(仅适用于windows)
// databit(数据位): 4-8(windows),5-8(linux),通常为8位
// stopbit(停止位): 1为1位停止位,2为2位停止位,3为1.5位停止位
// synchronizeflag(同步、异步,仅适用与windows): 0为异步,1为同步
bool open(const char* portname, int baudrate, char parity, char databit, char stopbit, FlowControl fc, char synchronizeflag=1);
//关闭串口,参数待定
void close();
//发送数据或写数据,成功返回发送数据长度,失败返回0
int send(const void *buf,int len);
//接受数据或读数据,成功返回读取实际数据的长度,失败返回0
int receive(void *buf,int maxlen);
private:
int pHandle[16];
char synchronizeflag;
};
#endif
cpp文件
#include "WzSerialPort.h"
#include <stdio.h>
#include <string.h>
#include <WinSock2.h>
#include <windows.h>
WzSerialPort::WzSerialPort()
{
}
WzSerialPort::~WzSerialPort()
{
}
bool WzSerialPort::open(const char* portname,
int baudrate,
char parity,
char databit,
char stopbit,
FlowControl fc,
char synchronizeflag)
{
this->synchronizeflag = synchronizeflag;
HANDLE hCom = NULL;
if (this->synchronizeflag)
{
//同步方式
hCom = CreateFileA(portname, //串口名
GENERIC_READ | GENERIC_WRITE, //支持读写
0, //独占方式,串口不支持共享
NULL,//安全属性指针,默认值为NULL
OPEN_EXISTING, //打开现有的串口文件
0, //0:同步方式,FILE_FLAG_OVERLAPPED:异步方式
NULL);//用于复制文件句柄,默认值为NULL,对串口而言该参数必须置为NULL
}
else
{
//异步方式
hCom = CreateFileA(portname, //串口名
GENERIC_READ | GENERIC_WRITE, //支持读写
0, //独占方式,串口不支持共享
NULL,//安全属性指针,默认值为NULL
OPEN_EXISTING, //打开现有的串口文件
FILE_FLAG_OVERLAPPED, //0:同步方式,FILE_FLAG_OVERLAPPED:异步方式
NULL);//用于复制文件句柄,默认值为NULL,对串口而言该参数必须置为NULL
}
if(hCom == (HANDLE)-1)
{
return false;
}
//配置缓冲区大小
if(! SetupComm(hCom,1024, 1024))
{
return false;
}
// 配置参数
DCB dcb;
if (!GetCommState(hCom, &dcb))
{
// 获取参数失败
return false;
}
memset(&dcb, 0, sizeof(dcb));
dcb.DCBlength = sizeof(dcb);
dcb.BaudRate = baudrate; // 波特率
dcb.ByteSize = databit; // 数据位
switch (parity) //校验位
{
case 0:
dcb.Parity = NOPARITY; //无校验
break;
case 1:
dcb.Parity = ODDPARITY; //奇校验
break;
case 2:
dcb.Parity = EVENPARITY; //偶校验
break;
case 3:
dcb.Parity = MARKPARITY; //标记校验
break;
}
switch(stopbit) //停止位
{
case 1:
dcb.StopBits = ONESTOPBIT; //1位停止位
break;
case 2:
dcb.StopBits = TWOSTOPBITS; //2位停止位
break;
case 3:
dcb.StopBits = ONE5STOPBITS; //1.5位停止位
break;
}
//流控设置
dcb.fDsrSensitivity = FALSE;
dcb.fTXContinueOnXoff = FALSE;
dcb.fRtsControl = RTS_CONTROL_DISABLE;
dcb.fDtrControl = DTR_CONTROL_ENABLE;
switch (fc)
{
//不流控
case NoFlowControl:
{
dcb.fOutxCtsFlow = FALSE;
dcb.fOutxDsrFlow = FALSE;
dcb.fOutX = FALSE;
dcb.fInX = FALSE;
break;
}
//硬件CtsRts流控
case CtsRtsFlowControl:
{
dcb.fOutxCtsFlow = TRUE;
dcb.fOutxDsrFlow = FALSE;
dcb.fRtsControl = RTS_CONTROL_HANDSHAKE;
dcb.fOutX = FALSE;
dcb.fInX = FALSE;
break;
}
//硬件 CtsDtr流控
case CtsDtrFlowControl:
{
dcb.fOutxCtsFlow = TRUE;
dcb.fOutxDsrFlow = FALSE;
dcb.fDtrControl = DTR_CONTROL_HANDSHAKE;
dcb.fOutX = FALSE;
dcb.fInX = FALSE;
break;
}
//硬件DsrRts流控
case DsrRtsFlowControl:
{
dcb.fOutxCtsFlow = FALSE;
dcb.fOutxDsrFlow = TRUE;
dcb.fRtsControl = RTS_CONTROL_HANDSHAKE;
dcb.fOutX = FALSE;
dcb.fInX = FALSE;
break;
}
//硬件DsrDtr流控
case DsrDtrFlowControl:
{
dcb.fOutxCtsFlow = FALSE;
dcb.fOutxDsrFlow = TRUE;
dcb.fDtrControl = DTR_CONTROL_HANDSHAKE;
dcb.fOutX = FALSE;
dcb.fInX = FALSE;
break;
}
//软件流控
case XonXoffFlowControl:
{
dcb.fOutxCtsFlow = FALSE;
dcb.fOutxDsrFlow = FALSE;
dcb.fOutX = TRUE;
dcb.fInX = TRUE;
dcb.XonChar = 0x11;
dcb.XoffChar = 0x13;
dcb.XoffLim = 100;
dcb.XonLim = 100;
break;
}
if(! SetCommState(hCom, &p))
{
// 设置参数失败
return false;
}
//超时处理,单位:毫秒
//总超时=时间系数×读或写的字符数+时间常量
COMMTIMEOUTS TimeOuts;
TimeOuts.ReadIntervalTimeout = 1000; //读间隔超时
TimeOuts.ReadTotalTimeoutMultiplier = 500; //读时间系数
TimeOuts.ReadTotalTimeoutConstant = 5000; //读时间常量
TimeOuts.WriteTotalTimeoutMultiplier = 500; // 写时间系数
TimeOuts.WriteTotalTimeoutConstant = 2000; //写时间常量
SetCommTimeouts(hCom,&TimeOuts);
PurgeComm(hCom,PURGE_TXCLEAR|PURGE_RXCLEAR);//清空串口缓冲区
memcpy(pHandle, &hCom, sizeof(hCom));// 保存句柄
return true;
}
void WzSerialPort::close()
{
HANDLE hCom = *(HANDLE*)pHandle;
CloseHandle(hCom);
}
int WzSerialPort::send(const void *buf,int len)
{
HANDLE hCom = *(HANDLE*)pHandle;
if (this->synchronizeflag)
{
// 同步方式
DWORD dwBytesWrite = len; //成功写入的数据字节数
BOOL bWriteStat = WriteFile(hCom, //串口句柄
buf, //数据首地址
dwBytesWrite, //要发送的数据字节数
&dwBytesWrite, //DWORD*,用来接收返回成功发送的数据字节数
NULL); //NULL为同步发送,OVERLAPPED*为异步发送
if (!bWriteStat)
{
return 0;
}
return dwBytesWrite;
}
else
{
//异步方式
DWORD dwBytesWrite = len; //成功写入的数据字节数
DWORD dwErrorFlags; //错误标志
COMSTAT comStat; //通讯状态
OVERLAPPED m_osWrite; //异步输入输出结构体
//创建一个用于OVERLAPPED的事件处理,不会真正用到,但系统要求这么做
memset(&m_osWrite, 0, sizeof(m_osWrite));
m_osWrite.hEvent = CreateEvent(NULL, TRUE, FALSE, L"WriteEvent");
ClearCommError(hCom, &dwErrorFlags, &comStat); //清除通讯错误,获得设备当前状态
BOOL bWriteStat = WriteFile(hCom, //串口句柄
buf, //数据首地址
dwBytesWrite, //要发送的数据字节数
&dwBytesWrite, //DWORD*,用来接收返回成功发送的数据字节数
&m_osWrite); //NULL为同步发送,OVERLAPPED*为异步发送
if (!bWriteStat)
{
if (GetLastError() == ERROR_IO_PENDING) //如果串口正在写入
{
WaitForSingleObject(m_osWrite.hEvent, 1000); //等待写入事件1秒钟
}
else
{
ClearCommError(hCom, &dwErrorFlags, &comStat); //清除通讯错误
CloseHandle(m_osWrite.hEvent); //关闭并释放hEvent内存
return 0;
}
}
return dwBytesWrite;
}
}
int WzSerialPort::receive(void *buf,int maxlen)
{
HANDLE hCom = *(HANDLE*)pHandle;
if (this->synchronizeflag)
{
//同步方式
DWORD wCount = maxlen; //成功读取的数据字节数
BOOL bReadStat = ReadFile(hCom, //串口句柄
buf, //数据首地址
wCount, //要读取的数据最大字节数
&wCount, //DWORD*,用来接收返回成功读取的数据字节数
NULL); //NULL为同步发送,OVERLAPPED*为异步发送
if (!bReadStat)
{
return 0;
}
return wCount;
}
else
{
//异步方式
DWORD wCount = maxlen; //成功读取的数据字节数
DWORD dwErrorFlags; //错误标志
COMSTAT comStat; //通讯状态
OVERLAPPED m_osRead; //异步输入输出结构体
//创建一个用于OVERLAPPED的事件处理,不会真正用到,但系统要求这么做
memset(&m_osRead, 0, sizeof(m_osRead));
m_osRead.hEvent = CreateEvent(NULL, TRUE, FALSE, L"ReadEvent");
ClearCommError(hCom, &dwErrorFlags, &comStat); //清除通讯错误,获得设备当前状态
if (!comStat.cbInQue)return 0; //如果输入缓冲区字节数为0,则返回false
BOOL bReadStat = ReadFile(hCom, //串口句柄
buf, //数据首地址
wCount, //要读取的数据最大字节数
&wCount, //DWORD*,用来接收返回成功读取的数据字节数
&m_osRead); //NULL为同步发送,OVERLAPPED*为异步发送
if (!bReadStat)
{
if (GetLastError() == ERROR_IO_PENDING) //如果串口正在读取中
{
//GetOverlappedResult函数的最后一个参数设为TRUE
//函数会一直等待,直到读操作完成或由于错误而返回
GetOverlappedResult(hCom, &m_osRead, &wCount, TRUE);
}
else
{
ClearCommError(hCom, &dwErrorFlags, &comStat); //清除通讯错误
CloseHandle(m_osRead.hEvent); //关闭并释放hEvent的内存
return 0;
}
}
return wCount;
}
}