在工业控制中,工控机(一般都基于 Windows 平台)经常需要与智能仪表通过串口
进行通信.串口通信方便易行,应用广泛.
半双工的,只能由作为主节点的工控 PC 机依次轮询网络上的各智能控制单元子节点.
每次通信都是由 PC 机通过串口向智能控制单元发布命令,智能控制单元在接收到正
确的命令后作出应答.
方法程序简单,但欠灵活.其二是调用 Windows的 API 函数,这种方法可以清楚地掌握
串口通信的机制,并且自由灵活.下面只介绍 API 串口通信部分.
方式).同步操作时,API 函数会阻塞直到操作完成以后才能返回(在多线程方式中,
虽然不会阻塞主线程,但是仍然会阻塞监听线程);而重叠操作方式,API 函数会立即
返回,操作在后台进行,避免线程的阻塞.
无论哪种操作方式,一般都通过四个步骤来完成:
(1)打开串口
(2)配置串口
(3)读写串口
(4)关闭串口
一 打开串口
Win32 系统把文件的概念进行了扩展.无论是文件、通信设备、命名管道、邮件
槽、磁盘、还是控制台,都是用 API 函数 CreateFile来打开或创建的.该函数的原型
为:
HANDLE CreateFile( LPCTSTR lpFileName,
DWORD dwFlagsAndAttributes,
HANDLE hTemplateFile);
• lpFileName:将要打开的串口逻辑名,如“COM1”;
• dwDesiredAccess: 指定串口访问的类型,可以是读取、写入或二者并列;
• dwShareMode:指定共享属性,由于串口不能共享,该参数必须置为 0;
• lpSecurityAttributes:引用安全性属性结构,缺省值为 NULL;
• dwCreationDistribution:创建标志,对串口操作该参数必须置为
OPEN_EXISTING;
• dwFlagsAndAttributes:属性描述,用于指定该串口是否进行异步操作,该值
为 FILE_FLAG_OVERLAPPED,表示使用异步的 I/O;该值为 0,表示同步 I/O 操
作;
• hTemplateFile:对串口而言该参数必须置为 NULL;
同步 I/O 方式打开串口的示例:
HANDLE hCom;//全局变量,串口句柄
hCom=CreateFile("COM1",// 串口名称
if(hCom==(HANDLE)-1)
{
MessageBox("打开 COM 失败!");
return FALSE;
}
return TRUE;
重叠 I/O 打开串口的示例:
HANDLE hCom;//全局变量,串口句柄
hCom =CreateFile("COM1",//串口名称
if(hCom==INVALID_HANDLE_VALUE)
{
MessageBox("打开 COM 失败!");
return FALSE;
}
return TRUE;
二 配置串口
在打开通讯设备句柄后,常需要对串口进行一些初始化配置工作.这需要通过一个
DCB 结构来进行.DCB 结构包含了诸如波特率、数据位数、奇偶校验和停止位数等信
息.在查询或配置串口的属性时,都要用 DCB 结构来作为缓冲区.
置.要修改串口的配置,应该先修改 DCB 结构,然后再调用 SetCommState 函数设置串
口.
typedef struct _DCB{
DWORD BaudRate;
//CBR_110,CBR_300,CBR_600,CBR_1200,CBR_2400,CBR_4800,CBR_9600,CBR_19200,
//CBR_38400,
//CBR_56000,CBR_57600,CBR_115200,CBR_128000,CBR_256000,CBR_14400
DWORD fParity;// 指定奇偶校验使能.若此成员为 1,允许奇偶校验检查
BYTE ByteSize;// 通信字节位数,4—8
BYTE Parity;//指定奇偶校验方法.此成员可以有下列值:
//EVENPARITY 偶校验 NOPARITY 无校验
//MARKPARITY 标记校验 ODDPARITY 奇校验
BYTE StopBits;// 指定停止位的位数.此成员可以有下列值:
//ONESTOPBIT 1 位停止位 TWOSTOPBITS 2 位停止位
//ONE5STOPBITS 1.5 位停止位
在 winbase.h 文件中定义了以上用到的常量.如下所示:
#define NOPARITY 0
#define ODDPARITY 1
#define EVENPARITY 2
#define ONESTOPBIT 0
#define ONE5STOPBITS 1
#define TWOSTOPBITS 2
#define CBR_110 110
#define CBR_300 300
#define CBR_600 600
#define CBR_1200 1200
#define CBR_2400 2400
#define CBR_4800 4800
#define CBR_9600 9600
#define CBR_14400 14400
#define CBR_19200 19200
#define CBR_38400 38400
#define CBR_56000 56000
#define CBR_57600 57600
#define CBR_115200 115200
#define CBR_128000 128000
#define CBR_256000 256000
GetCommState 函数可以获得 COM 口的设备控制块,从而获得相关参数:
BOOL GetCommState(
SetCommState 函数设置 COM 口的设备控制块:
BOOL SetCommState(
除了在 BCD 中的设置外,程序一般还需要设置 I/O 缓冲区的大小和超时.
Windows
用 I/O 缓冲区来暂存串口输入和输出的数据.如果通信的速率较高,则应该设置较大
的缓冲区.
调用 SetupComm 函数可以设置串行口的输入和输出缓冲区的大小.
BOOL SetupComm(
定的时间内没有读入或发送指定数量的字符,ReadFile 或 WriteFile 的操作仍然会
结束.
调
用 SetCommTimeouts 可以用某一个 COMMTIMEOUTS 结构的内容
来设置超时.
的最大时延.总超时是指读写操作总共花费的最大时间.写操作只支持总超时,而读
操作两种超时均支持.用 COMMTIMEOUTS 结构可以规定读写操作的超时.
typedef struct _COMMTIMEOUTS {
} COMMTIMEOUTS,*LPCOMMTIMEOUTS;
COMMTIMEOUTS 结构的成员都以毫秒为单位.总超时的计算公式是:
总超时=时间系数×要求读/写的字符数+时间常量
例如:要读入 10 个字符,那么读操作的总超时的计算公式为:
读总超时=ReadTotalTimeoutMultipli er×10+ReadTotalTimeoutConstant
各种超时.
0,那么就不使用读间隔超时.如果 ReadTotalTimeoutMultipli er 和
ReadTotalTimeoutConstant
都为 0,
则不使用读总超时.如果读间隔超时被设置成
MAXDWORD 并且读时间系数和读时间常量都为 0,
那么在读一次输入缓冲区的内容后
读操作就立即返回,而不管是否读入了要求的字符.
回,但超时仍然是起作用的.在这种情况下,超时规定的是操作的完成时间,而不是
ReadFile 和 WriteFile 的返回时间.
配置串口的示例:
SetupComm(hCom,1024,1024);//输入缓冲区和输出缓冲区的大小都是 1024
COMMTIMEOUTS TimeOuts;
//设定读超时
TimeOuts.ReadIntervalTimeout=1000;
TimeOuts.ReadTotalTimeoutMultipli er=500;
TimeOuts.ReadTotalTimeoutConstant =5000;
//设定写超时
TimeOuts.WriteTotalTimeoutMultipl ier=500;
TimeOuts.WriteTotalTimeoutConstan t=2000;
SetCommTimeouts(hCom,&TimeOuts);//设置超时
DCB dcb;
GetCommState(hCom,&dcb);
dcb.BaudRate=9600;//波特率为 9600
dcb.ByteSize=8;//每个字节有 8 位
dcb.Parity=NOPARITY;//无奇偶校验位
dcb.StopBits=TWOSTOPBITS;//两个停止位
SetCommState(hCom,&dcb);
PurgeComm(hCom,PURGE_TXCLEAR|PURGE_RXCLEAR);
在读写串口之前,还要用 PurgeComm()函数清空缓冲区,该函数原型:
BOOL PurgeComm(
参数 dwFlags 指定要完成的操作,可以是下列值的组合:
PURGE_TXABORT 中断所有写操作并立即返回,即使写操作还没有完成.
PURGE_RXABORT 中断所有读操作并立即返回,即使读操作还没有完成.
PURGE_TXCLEAR 清除输出缓冲区
PURGE_RXCLEAR 清除输入缓冲区
三 读写串口
使用 ReadFile 和 WriteFile 读写串口,下面是两个函数的声明:
BOOL ReadFile(
BOOL WriteFile(
在用 ReadFile 和 WriteFile 读写串口时,既可以同步执行,也可以重叠执行.在同
步执行时,函数直到操作完成后才返回.这意味着同步执行时线程会被阻塞,从而导
致效率下降.在重叠执行时,即使操作还未完成,这两个函数也会立即返回,费时的
I/O 操作在后台进行.
CreateFile 创建句柄时指定了 FILE_FLAG_OVERLAPPED 标志,那么调用 ReadFile 和
WriteFile 对该句柄进行的操作就应该是重叠的;如果未指定重叠标志,则读写操作
应该是同步的.ReadFile 和 WriteFile 函数的同步或者异步应该和 CreateFile 函数
相一致.
WriteFile 函数不但要把指定数量的字符拷入到输出缓冲区,而且要等这些字符从
串行口送出去后才算完成操作.
返回 FALSE时,不一定就是操作失败,线程应该调用 GetLastError函数分析返回的结
果.例如,在重叠操作时如果操作还未完成函数就返回,那么函数就返回 FALSE,而且
GetLastError 函数返回 ERROR_IO_PENDING.这说明重叠操作还未完成.
下面是同步方式读写串口的示例:
//同步读串口
char str[100];
DWORD wCount;//读取的字节数
BOOL bReadStat;
bReadStat=ReadFile(hCom,str,100,&wCount,NULL);
if(!bReadStat)
{
MessageBox("读串口失败!");
return FALSE;
}
return TRUE;
//同步写串口
char lpOutBuffer[100];
DWORD dwBytesWrite=100;
COMSTAT ComStat;
DWORD dwErrorFlags;
BOOL bWriteStat;
ClearCommError(hCom,&dwErrorFlags,&ComStat);
bWriteStat=WriteFile(hCom,lpOutBuffer,dwBytesWrite,& dwBytesWrite,NULL);
if(!bWriteStat)
{
MessageBox("写串口失败!");
}
PurgeComm(hCom, PURGE_TXABORT|
PURGE_RXABORT|PURGE_TXCLEAR|PURGE_RXCLEAR);
在重叠操作时,操作还未完成函数就返回.
重叠 I/O 非常灵活,它也可以实现阻塞(例如我们可以设置一定要读取到一个数据
才能进行到下一步操作).有两种方法可以等待操作完成:一种方法是用象
WaitForSingleObject 这样的等待函数来等待 OVERLAPPED 结构的 hEvent 成员;另一
种方法是调用 GetOverlappedResult 函数等待,后面将演示说明.
下面先简单介绍一下 OVERLAPPED 结构和 GetOverlappedResult 函数:
OVERLAPPED 结构
OVERLAPPED 结构包含了重叠 I/O 的一些信息,定义如下:
typedef struct _OVERLAPPED {
} OVERLAPPED;
在使用 ReadFile 和 WriteFile重叠操作时,线程需要创建OVERLAPPED 结构以供这
两个函数使用.线程通过 OVERLAPPED 结构获得当前的操作状态,该结构最重要的成
员是 hEvent.hEvent 是读写事件.当串口使用异步通讯时,函数返回时操作可能还没
有完成,程序可以通过检查该事件得知是否读写完毕.
叠操作完成后,该成员变量会自动被置为有信号状态.
GetOverlappedResult 函数
BOOL GetOverlappedResult(
该函数返回重叠操作的结果,用来判断异步操作是否完成,它是通过判断
OVERLAPPED 结构中的 hEvent 是否被置位来实现的.
异步读串口的示例:
char lpInBuffer[1024];
DWORD dwBytesRead=1024;
COMSTAT ComStat;
DWORD dwErrorFlags;
OVERLAPPED m_osRead;
memset(&m_osRead,0,sizeof(OVERLAPPED));
m_osRead.hEvent=CreateEvent(NULL,TRUE,FALSE,NULL);
ClearCommError(hCom,&dwErrorFlags,&ComStat);
dwBytesRead=min(dwBytesRead,(DWORD)ComStat.cbInQue);
if(!dwBytesRead)
return FALSE;
BOOL bReadStatus;
bReadStatus=ReadFile(hCom,lpInBuffer,
dwBytesRead,&dwBytesRead,&m_osRead);
if(!bReadStatus)//如果 ReadFile 函数返回 FALSE
{
if(GetLastError()==ERROR_IO_PENDING) {
//GetLastError() 函数返回ERROR_IO_PENDING,表明串口正在进行读操作
WaitForSingleObject(m_osRead.hEvent,2000);
PurgeComm(hCom, PURGE_TXABORT|
PURGE_RXABORT|PURGE_TXCLEAR|PURGE_RXCLEAR);
return dwBytesRead;
}
return 0;
}
PurgeComm(hCom,PURGE_TXABORT|
return dwBytesRead;
对以上代码再作简要说明:在使用 ReadFile 函数进行读操作前,应先使用
ClearCommError 函数清除错误.ClearCommError 函数的原型如下:
BOOL ClearCommError(
该函数获得通信错误并报告串口的当前状态,同时,该函数清除串口的错误标志以
便继续输入、输出操作.
COMSTAT 结构包含串口的信息,结构定义如下:
typedef struct _COMSTAT{//cst
} COMSTAT, *LPCOMSTAT;
这里只用到了 cbInQue 成员变量,该成员变量的值代表输入缓冲区的字节数.
这段代码用 WaitForSingleObject 函数来等待 OVERLAPPED 结构的 hEvent 成员.
下面是调用 GetOverlappedResult 函数等待的异步读串口示例:
char lpInBuffer[1024];
DWORD dwBytesRead=1024;
BOOL bReadStatus;
DWORD dwErrorFlags;
COMSTAT ComStat;
OVERLAPPED m_osRead;
ClearCommError(hCom,&dwErrorFlags,&ComStat);
if(!ComStat.cbInQue)
{
return 0;
}
dwBytesRead=min(dwBytesRead,(DWORD)ComStat.cbInQue);
bReadStatus=ReadFile(hCom, lpInBuffer,dwBytesRead,
if(!bReadStatus)//如果 ReadFile 函数返回 FALSE
{
if(GetLastError()==ERROR_IO_PENDING)
{
GetOverlappedResult(hCom,&m_osRead,&dwBytesRead,TRUE);
return dwBytesRead;
}
return 0;
}
return dwBytesRead;
异步写串口的示例:
char buffer[1024];
DWORD dwBytesWritten=1024;
DWORD dwErrorFlags;
COMSTAT ComStat;
OVERLAPPED m_osWrite;
BOOL bWriteStat;
bWriteStat=WriteFile(hCom,buffer,dwBytesWritten,
if(!bWriteStat)
{
if(GetLastError()==ERROR_IO_PENDING)
{
WaitForSingleObject(m_osWrite.hEvent,1000);
return dwBytesWritten;
}
return 0;
}
return dwBytesWritten;
四 关闭串口
利用 API 函数关闭串口非常简单,只需使用 CreateFile 函数返回的句柄作为参数
调用 CloseHandle 即可:
BOOL CloseHandle(
);
为了更好地理解串口编程,下面分别编写两个实例,这两个实例都实现了工控机与
百特显示仪表通过 RS485 接口进行的串口通信.其中第一个实例采用同步串口操作,
第二个实例采用异步串口操作.
实例 1
打开 VC++6.0,新建基于对话框的工程 RS485Comm,在主对话框窗口
IDD_RS485COMM_DIALOG 上添加两个按钮,ID 分别为 IDC_SEND 和 IDC_RECEIVE,标题
分别为”发送”和”接收”;添加一个静态文本框 IDC_DISP,用于显示串口接收到
的内容.
①在 RS485CommDlg.cpp 文件中添加全局变量:
HANDLE hCom;//全局变量,串口句柄
②在 RS485CommDlg.cpp 文件中的 OnInitDialog()函数添加如下代码:
// TODO: Add extra initialization here
hCom=CreateFile("COM1",// 串口名称
if(hCom==(HANDLE)-1)
{
MessageBox("打开 COM 失败!");
return FALSE;
}
SetupComm(hCom,100,100);//输入缓冲区和输出缓冲区的大小都是 1024
COMMTIMEOUTS TimeOuts;
//设定读超时
TimeOuts.ReadIntervalTimeout=MAXDWORD;
TimeOuts.ReadTotalTimeoutMultipli er=0;
TimeOuts.ReadTotalTimeoutConstant =0;
//在读一次输入缓冲区的内容后读操作就立即返回,
//而不管是否读入了要求的字符.
//设定写超时
TimeOuts.WriteTotalTimeoutMultipl ier=100;
TimeOuts.WriteTotalTimeoutConstan t=500;
SetCommTimeouts(hCom,&TimeOuts);//设置超时
DCB dcb;
GetCommState(hCom,&dcb);
dcb.BaudRate=9600;//波特率为 9600
dcb.ByteSize=8;//每个字节有 8 位
dcb.Parity=NOPARITY;//无奇偶校验位
dcb.StopBits=TWOSTOPBITS;//两个停止位
SetCommState(hCom,&dcb);
PurgeComm(hCom,PURGE_TXCLEAR|PURGE_RXCLEAR);
③分别双击 IDC_SEND 按钮和 IDC_RECEIVE 按钮,添加两个按钮的响应函数:
void CRS485CommDlg::OnSend()//发送数据
{
//TODO: Add your control notification handler code here
//在此需要简单介绍百特公司 XMA5000 的通讯协议:
//该仪表 RS485 通讯采用主机广播方式通讯.
//串行半双工,帧 11 位,1 个起始位(0),8 个数据位,2 个停止位(1)
//如:读仪表显示的瞬时值,主机发送:DC1 AAA BB ETX
//其中:DC1 是标准 ASCII 码的一个控制符号,码值为 11H(十进制的 17)
//在 XMA5000 的通讯协议中,DC1 表示读瞬时值
//AAA 是从机地址码,也就是 XMA5000 显示仪表的通讯地址
//BB 为通道号,读瞬时值时该值为 01
//ETX 也是标准ASCII 码的一个控制符号,码值为 03H
//在 XMA5000 的通讯协议中,ETX 表示主机结束符
char lpOutBuffer[7];
memset(lpOutBuffer,'\0',7);//前 7 个字节先清零
lpOutBuffer[0]= '\x11';// 发送缓冲区的第 1 个字节为 DC1
lpOutBuffer[1]= '0';//第 2 个字节为字符 0(30H)
lpOutBuffer[2]='0';//第 3 个字节为字符 0(30H)
lpOutBuffer[3]='1';// 第 4 个字节为字符 1(31H)
lpOutBuffer[4]='0';//第 5 个字节为字符 0(30H)
lpOutBuffer[5]='1';//第 6 个字节为字符 1(31H)
lpOutBuffer[6]='\x03';//第 7 个字节为字符 ETX
//从该段代码可以看出,仪表的通讯地址为 001
DWORD dwBytesWrite=7;
COMSTAT ComStat;
DWORD dwErrorFlags;
BOOL bWriteStat;
ClearCommError(hCom,&dwErrorFlags,&ComStat);
bWriteStat=WriteFile(hCom,lpOutBuffer,dwBytesWrite,& dwBytesWrite,NULL);
if(!bWriteStat)
{
MessageBox("写串口失败!");
}
}
void CRS485CommDlg::OnReceive() //接收数据
{
// TODO: Add your control notification handler code here
char str[100];
memset(str,'\0',100);
DWORD wCount=100;//读取的字节数
BOOL bReadStat;
bReadStat=ReadFile(hCom,str,wCount,&wCount,NULL);
if(!bReadStat)
{
}
PurgeComm(hCom,PURGE_TXABORT|
m_disp=str;
UpdateData(FALSE);
}
可以观察返回的字符串,其中有和仪表显示值相同的部分,可以进行相应的字符串操
作取出仪表的显示值.
④打开 ClassWizard,为静态文本框IDC_DISP 添加 CString 类型变量 m_disp,同时添
加 WM_CLOSE 的相应函数:
void CRS485CommDlg::OnClose()
{
//TODO: Add your message handler code here and/or call default
CloseHandle(hCom);//程序退出时关闭串口
CDialog::OnClose();
}
实例 2
打开 VC++6.0,新建基于对话框的工程 RS485Comm,在主对话框窗口
IDD_RS485COMM_DIALOG 上添加两个按钮,ID 分别为 IDC_SEND 和 IDC_RECEIVE,标题
分别为”发送”和”接收”;添加一个静态文本框 IDC_DISP,用于显示串口接收到
的内容.
①在 RS485CommDlg.cpp 文件中添加全局变量:
HANDLE hCom;//全局变量,串口句柄
②在 RS485CommDlg.cpp 文件中的 OnInitDialog()函数添加如下代码:
hCom=CreateFile("COM1",// 串口名称
if(hCom==(HANDLE)-1)
{
MessageBox("打开 COM 失败!");
return FALSE;
}
SetupComm(hCom,100,100);//输入缓冲区和输出缓冲区的大小都是 100
COMMTIMEOUTS TimeOuts;
//设定读超时
TimeOuts.ReadIntervalTimeout=MAXDWORD;
TimeOuts.ReadTotalTimeoutMultipli er=0;
TimeOuts.ReadTotalTimeoutConstant =0;
//在读一次输入缓冲区的内容后读操作就立即返回,
//而不管是否读入了要求的字符.
//设定写超时
TimeOuts.WriteTotalTimeoutMultipl ier=100;
TimeOuts.WriteTotalTimeoutConstan t=500;
SetCommTimeouts(hCom,&TimeOuts);//设置超时
DCB dcb;
GetCommState(hCom,&dcb);
dcb.BaudRate=9600;//波特率为 9600
dcb.ByteSize=8;//每个字节有 8 位
dcb.Parity=NOPARITY;//无奇偶校验位
dcb.StopBits=TWOSTOPBITS;//两个停止位
SetCommState(hCom,&dcb);
PurgeComm(hCom,PURGE_TXCLEAR|PURGE_RXCLEAR);
③分别双击 IDC_SEND 按钮和 IDC_RECEIVE 按钮,添加两个按钮的响应函数:
void CRS485CommDlg::OnSend()//发送数据
{
// TODO: Add your control notification handler code here
OVERLAPPED m_osWrite;
memset(&m_osWrite,0,sizeof(OVERLAPPED));
m_osWrite.hEvent=CreateEvent(NULL,TRUE,FALSE,NULL);
char lpOutBuffer[7];
memset(lpOutBuffer,'\0',7);
lpOutBuffer[0]='\x11'';
lpOutBuffer[1]='0';
lpOutBuffer[2]='0';
lpOutBuffer[3]='1';
lpOutBuffer[4]='0';
lpOutBuffer[5]='1';
lpOutBuffer[6]='\x03';
DWORD dwBytesWrite=7;
COMSTAT ComStat;
DWORD dwErrorFlags;
BOOL bWriteStat;
ClearCommError(hCom,&dwErrorFlags,&ComStat);
bWriteStat=WriteFile(hCom,lpOutBuffer,
if(!bWriteStat)
{
if(GetLastError()==ERROR_IO_PENDING)
{
WaitForSingleObject(m_osWrite.hEvent,1000);
}
}
}
void CRS485CommDlg::OnReceive() //接收数据
{
// TODO: Add your control notification handler code here
OVERLAPPED m_osRead;
memset(&m_osRead,0,sizeof(OVERLAPPED));
m_osRead.hEvent=CreateEvent(NULL,TRUE,FALSE,NULL);
COMSTAT ComStat;
DWORD dwErrorFlags;
char str[100];
memset(str,'\0',100);
DWORD dwBytesRead=100;//读取的字节数
BOOL bReadStat;
ClearCommError(hCom,&dwErrorFlags,&ComStat);
dwBytesRead=min(dwBytesRead,(DWORD)ComStat.cbInQue);
bReadStat=ReadFile(hCom,str,
if(!bReadStat)
{
if(GetLastError()==ERROR_IO_PENDING)
//GetLastError() 函数返回ERROR_IO_PENDING,表明串口正在进行读操作
{
WaitForSingleObject(m_osRead.hEvent,2000);
//使用 WaitForSingleObject 函数等待,直到读操作完成或延时已达到 2 秒钟
//当串口读操作进行完毕后,m_osRead 的 hEvent 事件会变为有信号
}
}
PurgeComm(hCom,PURGE_TXABORT|
m_disp=str;
UpdateData(FALSE);
}
④打开 ClassWizard,为静态文本框IDC_DISP 添加 CString 类型变量 m_disp,同时添
加 WM_CLOSE 的相应函数:
void CRS485CommDlg::OnClose()
{
//TODO: Add your message handler code here and/or call default
CDialog::OnClose();
}