VC++ 的串口通讯

有时会无缘无故的说mscomm 不能用了，需要手工来注册安装MSComm控件。

点击“开始”->"运行"，再在中填入：
    Regsvr32 C:/winnt/system32/Mscomm32.ocx

即可。

在VC++中有两种方法可以进行串口通讯。一种是利用Microsoft公司提供的ActiveX控件 Microsoft

Communications Control。另一种是直接用VC++访问串口。下面将简述这两种方法。

　　一、Microsoft Communications Control

　　Microsoft公司在WINDOWS中提供了一个串口通讯控件，用它，我们可以很简单的利用串口进行通讯。

在使用它之前，应将控件加在应用程序的对话框上。然后再用ClassWizard 生成相应的对象。现在我们可

以使用它了。

　　该控件有很多自己的属性，你可以通过它的属性窗口来设置，也可以用程序设置。我推荐用程序设置

，这样更灵活。

　　　SetCommPort：指定使用的串口。

　　　GetCommPort：得到当前使用的串口。

　　　SetSettings：指定串口的参数。一般设为默认参数"9600，N，8，1"。这样方便与其他串口进行通

讯。

　　　GetSettings：取得串口参数。

　　　SetPortOpen：打开或关闭串口，当一个程序打开串口时，另外的程序将无法使用该串口。

　　　GetPortOpen：取得串口状态。

　　　GetInBufferCount：输入缓冲区中接受到的字符数。

　　　SetInPutLen：一次读取输入缓冲区的字符数。设置为0时，程序将读取缓冲区的全部字符。

　　　GetInPut：读取输入缓冲区。

　　　GetOutBufferCount：输出缓冲区中待发送的字符数。

　　　SetOutPut：写入输出缓冲区。

　　一般而言，使用上述函数和属性就可以进行串口通讯了。


*********************************************************************
MSComm类
CommPort属性
void SetCommPort(short nNewValue); short GetCommPort();
这一属性设置并返回连接的串行端口号，Windows将会利用该串口和外界通信。设置端口号，如nNewValue

=1表示COM1.在设计时，nNewValue可以设置成从1~16的任何数(默认值为1)。但是如果用PortOpen属性打

开一个并不存在的端口时，MSComm控件会产生错误68(设备无效)。

void SetPortOpen(BOOL bNewValue);
打开或关闭串口，TRUE：打开，FALSE：关闭
BOOL GetPortOpen();
串口是否已打开，TRUE：打开，FALSE：关闭
PortOpen 属性用于打开或者关闭端口。如果bNewValue设为TRUE，可以打开端口；设为FALSE时可以关闭

端口。一般情况下在程序开始时打开端口，在程序结束时关闭端口。当应用程序终止时，MSComm控件将自

动关闭串口。在打开端口前，确定CommPort属性调协为正确的端口号。而且，用户的串口设备必须支持

Settings属性中的设置。如果硬件设备不支持Settings属性中的一些设置，则硬件工作或许不正确。

void SetRThreshold(short nNewValue);
short GetRThreshold();
在MSComm控件设置CommEvent属性为comEvReceive并产生OnComm之前，RThreshold属性设置并返回的要接

收的字符数。这里nNewValue是short型参数，说明在产生OnComm事件之前要接收的字符数。
当接收字符后，若RThreshold属性设置为0(默认值)则不会产生OnComm事件。否则，该属性为一阈值，当

接收缓冲区内字节个数达到或超过该值后就会产生OnComm事件，例如，设置RThreshold为1，接收缓冲区

收到每一个字符都会使MSComm控件产生OnComm事件。

void SetRTSEnable(BOOL bNewValue);//硬件握手使能？
BOOL GetRTSEnable();
RTSEnable属性确定是否使用RTS线有效。一般情况下，由计算机发送RTS信号到连接的调制解调器，请求

允许发送数据。

void SetSettings(LPCTSTR lpszNewValue);
Settings由4部分组成，其格式为："BBBB,P,D,S"，即"波特率,是否奇偶校验,数据位个数,停止位"，如设

置为："9600,n,8,1"

void SetSThreshold(short nNewValue);
short GetSThreshold();
MSComm控件设置CommEvent属性为comEvSend并产生OnComm事件之前，设置并返回传输缓冲区中允许的最小

字符数。这里nNewValue是short型数据，代表在OnComm事件产生之前在传输缓冲区中的最小字符数。
若设置Sthreshold属性为0(默认值)，数据传输事件不会产生OnComm事件。若设置Sthreshold属性为0，当

传输缓冲区完全空时， MSComm控件产生OnComm事件。如果在传输缓冲区的字符数小于value，CommEvent

属性设置为comEvSend，并产生OnComm 事件。comEvSend事件仅当字符数与Sthreshold交叉时被激活一次

。例如，如果Sthreshold等于5，仅当在输出队列中字符数从5降到4时，comEvSend才发生。如果在输出队

列中从没有比Sthreshold多的字符，comEvSend事件将绝不会发生。

void SetOutput(const VARIANT & newValue);
Output属性用于向发送缓冲区写数据流。属性为VARIANT变量。该属性在端口未打开时不可用，在运行时

只是写的。
注意：Output属性可以发送文本数据或二进制数据。传输文本数据时，应该将字符型数据放入VARIANT变

量中；传输二进制数据(即按字节传送)时，应将字节型数据放入VARIANT型变量中。如果通常给应用程序

发送ANSI字符串，可以以文本方式发送。如果数据包含了内嵌控制字符、NULL字符等，必须将其作为二进

制传递过去。

VARIANT GetInput();
Input属性表示从接收缓冲区移走一串字符，将缓冲区中收到的数据读入变量。属性值为VARIAN型变量。

该属性在端口未打开时不可用，在运行时是只读的。
注意：当InputMode属性值 为0时(文本模式)，变量中含String型数据。当InputMode属性值为1(二进制模

式)，变量中含Byte型数组数据。

short GetCommEvent();
一个非常重要的函数，获得串口上刚发生的事件（"事件"可以理解为软件意义上的"消息"或硬件意义上的

"中断"），事件的发送会导致OnComm消息的诞生！
如果在通信过程中发生错误或事件，将会引发OnComm事件并且改变其属性值。CommEvent属性值反映错误

或者事件类型，通信的设计中可以根据该属性值执行同的操作。该属性在端口未打开时不可用，在运行时

是只读的。通信错误及通信事件的设定值分别如下两表所示。


*************************************************************************************
二、直接用VC++访问串口。

　　在VC++中，串口和磁盘文件可以统一的方式来简单读写。这两者几乎没有什么不同，只是在WINDOWS

9X下磁盘文件只能做同步访问，而串口只能做异步访问。

　　CreateFile：用指定的方式打开指定的串口。通常的方式为

　　m_hCom = CreateFile( "COM1", GENERIC_READ | GENERIC_WRITE, 0, NULL, OPEN_EXISTING,

FILE_ATTRIBUTE_NORMAL | FILE_FLAG_OVERLAPPED, NULL );

　　m_hCom为文件句柄。GENERIC_READ | GENERIC_WRITE指定可以对串口进行读写操作。第三个参数0表

示串口为独占打开。OPEN_EXISTING表示当指定串口不存在时，程序将返回失败。

FILE_ATTRIBUTE_NORMAL | FILE_FLAG_OVERLAPPED则表示文件属性。当打开串口时，必须指定

FILE_FLAG_OVERLAPPED，它表示文件或设备不会维护访问指针，则在读写时，必须使用OVERLAPPED 结构

指定访问的文件偏移量。

　　　ReadFile：读取串口数据。

　　　WriteFile：向串口写数据。

　　　CloseHandle：关闭串口。

　　COMMTIMEOUTS：COMMTIMEOUTS主要用于串口超时参数设置。COMMTIMEOUTS结构如下：

typedef struct _COMMTIMEOUTS {
DWORD ReadIntervalTimeout;
DWORD ReadTotalTimeoutMultiplier;
DWORD ReadTotalTimeoutConstant;
DWORD WriteTotalTimeoutMultiplier;
DWORD WriteTotalTimeoutConstant;
} COMMTIMEOUTS,*LPCOMMTIMEOUTS;

　　ReadIntervalTimeout：两字符之间最大的延时，当读取串口数据时，一旦两个字符传输的时间差超

过该时间，读取函数将返回现有的数据。设置为0表示该参数不起作用。

　　ReadTotalTimeoutMultiplier：读取每字符间的超时。

　　ReadTotalTimeoutConstant：一次读取串口数据的固定超时。所以在一次读取串口的操作中，其超时

为 ReadTotalTimeoutMultiplier乘以读取的字节数再加上 ReadTotalTimeoutConstant。将

ReadIntervalTimeout设置为MAXDWORD，并将 ReadTotalTimeoutMultiplier 和

ReadTotalTimeoutConstant设置为0，表示读取操作将立即返回存放在输入缓冲区的字符。

　　WriteTotalTimeoutMultiplier：写入每字符间的超时。

　　WriteTotalTimeoutConstant：一次写入串口数据的固定超时。所以在一次写入串口的操作中，其超

时为WriteTotalTimeoutMultiplier乘以写入的字节数再加上 WriteTotalTimeoutConstant。

　　SetCommTimeouts函数可以设置某设备句柄的超时参数，要得到某设备句柄的超时参数可以用

GetCommTimeouts函数。

　　DCB：DCB结构主要用于串口参数设置。该结构太庞大，这里就不一一讲述了，有兴趣者可查看MSDN关

于DCB的描述。其中下面两个是比较重要的属性。

　　BaudRate：串口的通讯速度。一般设置为9600。

　　ByteSize：字节位数。一般设置为8。

　　DCB结构可以用SetCommState函数来设置，并可以用GetCommState来得到现有串口的属性。

　　SetupComm：设置串口输入、输出缓冲区。

　　OVERLAPPED：保存串口异步通讯的信息。具体结构如下：

typedef struct _OVERLAPPED {
DWORD Internal;
DWORD InternalHigh;
DWORD Offset;
DWORD OffsetHigh;
HANDLE hEvent;
} OVERLAPPED;

　　Internal，InternalHigh是保留给系统使用的，用户不需要设置。

　　Offset，OffsetHigh是读写串口的偏移量，一般设置OffsetHigh为NULL，可以支持2GB数据。

　　hEvent读写事件，因为串口是异步通讯，操作可能被其他进程堵塞，程序可以通过检查该时间来得知

是否读写完毕。事件将在读写完成后，自动设置为有效。

　　通过以上这些函数和结构，我们就可以通过串口进行通讯了，现在我们具体看下面的实例：

BOOL CSerial::Open( int nPort, int nBaud )
{
if( m_bOpened ) return( TRUE );

char szPort[15];
DCB dcb;

wsprintf( szPort, "COM%d", nPort );
m_hComDev = CreateFile( szPort, GENERIC_READ | GENERIC_WRITE, 0, NULL, OPEN_EXISTING,

FILE_ATTRIBUTE_NORMAL | FILE_FLAG_OVERLAPPED, NULL );
if( m_hComDev == NULL ) return( FALSE );

memset( &m_OverlappedRead, 0, sizeof( OVERLAPPED ) );
memset( &m_OverlappedWrite, 0, sizeof( OVERLAPPED ) );

COMMTIMEOUTS CommTimeOuts;
CommTimeOuts.ReadIntervalTimeout = 0xFFFFFFFF;
CommTimeOuts.ReadTotalTimeoutMultiplier = 0;
CommTimeOuts.ReadTotalTimeoutConstant = 0;
CommTimeOuts.WriteTotalTimeoutMultiplier = 0;
CommTimeOuts.WriteTotalTimeoutConstant = 5000;
SetCommTimeouts( m_hComDev, &CommTimeOuts );

m_OverlappedRead.hEvent = CreateEvent( NULL, TRUE, FALSE, NULL );
m_OverlappedWrite.hEvent = CreateEvent( NULL, TRUE, FALSE, NULL );

dcb.DCBlength = sizeof( DCB );
GetCommState( m_hComDev, &dcb );
dcb.BaudRate = nBaud;
dcb.ByteSize = 8;
if( !SetCommState( m_hComDev, &dcb ) ||
!SetupComm( m_hComDev, 10000, 10000 ) ||
m_OverlappedRead.hEvent == NULL ||
m_OverlappedWrite.hEvent == NULL ){
DWORD dwError = GetLastError();
if( m_OverlappedRead.hEvent != NULL ) CloseHandle( m_OverlappedRead.hEvent );
if( m_OverlappedWrite.hEvent != NULL ) CloseHandle( m_OverlappedWrite.hEvent );
CloseHandle( m_hComDev );
return FALSE;
}

m_bOpened = TRUE;

return m_bOpened;

}

int CSerial::InBufferCount( void )
{

if( !m_bOpened || m_hComDev == NULL ) return( 0 );

DWORD dwErrorFlags;
COMSTAT ComStat;

ClearCommError( m_hIDComDev, &dwErrorFlags, &ComStat );

return (int)ComStat.cbInQue;

}

DWORD CSerial::ReadData( void *buffer, DWORD dwBytesRead)
{

if( !m_bOpened || m_hComDev == NULL ) return 0;

BOOL bReadStatus;
DWORD dwErrorFlags;
COMSTAT ComStat;

ClearCommError( m_hComDev, &dwErrorFlags, &ComStat );
if( !ComStat.cbInQue ) return 0;

dwBytesRead = min(dwBytesRead,(DWORD) ComStat.cbInQue);

bReadStatus = ReadFile( m_hComDev, buffer, dwBytesRead, &dwBytesRead, &m_OverlappedRead );
if( !bReadStatus ){
if( GetLastError() == ERROR_IO_PENDING ){
WaitForSingleObject( m_OverlappedRead.hEvent, 2000 );
return dwBytesRead;
}
return 0;
}

return dwBytesRead;

}

DWORD CSerial::SendData( const char *buffer, DWORD dwBytesWritten)
{

if( !m_bOpened || m_hComDev == NULL ) return( 0 );

BOOL bWriteStat;

bWriteStat = WriteFile( m_hComDev, buffer, dwBytesWritten, &dwBytesWritten,

&m_OverlappedWrite );
if( !bWriteStat){
if ( GetLastError() == ERROR_IO_PENDING ) {
WaitForSingleObject( m_OverlappedWrite.hEvent, 1000 );
return dwBytesWritten;
}
return 0;
}
return dwBytesWritten;

}


　　上述函数基本实现串口的打开，读写操作。本文章略去该串口类的说明和关闭函数。读者应该能将这

些内容写完。接下来，你就可以在你的程序中调用该串口类了。关于本文有任何疑问，请与作者联系。


*****************************************************
MSComm 控件通过串行端口传输和接收数据，为应用程序提供串行通讯功能。MSComm控件在串口编程时非常方便，程序员不必去花时间去了解较为复杂的API函数，而且在VC、VB、Delphi等语言中均可使用。 Microsoft Communications Control（以下简称MSComm）是Microsoft公司提供的简化Windows下串行通信编程的ActiveX控件，它为应用程序提供了通过串行接口收发数据的简便方法。具体的来说，它提供了两种处理通信问题的方法：一是事件驱动(Event－driven)方法，一是查询法。

1.MSComm控件两种处理通讯的方式

MSComm控件提供下列两种处理通讯的方式：事件驱动方式和查询方式。 
1.1 事件驱动方式

事件驱动通讯是处理串行端口交互作用的一种非常有效的方法。在许多情况下，在事件发生时需要得到通知，例如，在串口接收缓冲区中有字符，或者 Carrier Detect (CD) 或 Request To Send (RTS) 线上一个字符到达或一个变化发生时。在这些情况下，可以利用 MSComm 控件的 OnComm 事件捕获并处理这些通讯事件。OnComm 事件还可以检查和处理通讯错误。所有通讯事件和通讯错误的列表，参阅 CommEvent 属性。在编程过程中，就可以在OnComm事件处理函数中加入自己的处理代码。这种方法的优点是程序响应及时，可靠性高。每个MSComm 控件对应着一个串行端口。如果应用程序需要访问多个串行端口，必须使用多个 MSComm 控件。

1.2 查询方式 

查询方式实质上还是事件驱动，但在有些情况下，这种方式显得更为便捷。在程序的每个关键功能之后，可以通过检查 CommEvent 属性的值来查询事件和错误。如果应用程序较小，并且是自保持的，这种方法可能是更可取的。例如，如果写一个简单的电话拨号程序，则没有必要对每接收一个字符都产生事件，因为唯一等待接收的字符是调制解调器的“确定”响应。 

2.MSComm 控件的常用属性
MSComm 控件有很多重要的属性，但首先必须熟悉几个属性。
CommPort 设置并返回通讯端口号。 
Settings 以字符串的形式设置并返回波特率、奇偶校验、数据位、停止位。 
PortOpen 设置并返回通讯端口的状态。也可以打开和关闭端口。 
Input 从接收缓冲区返回和删除字符。 
Output 向传输缓冲区写一个字符串。

下面分别描述： 

CommPort属性 设置并返回通讯端口号。
语法 object.CommPort[value ] (value 一整型值，说明端口号。) 
说明 在设计时，value 可以设置成从 1 到 16 的任何数（缺省值为 1）。但是如果用 PortOpen 属性打开一个并不存在的端口时，MSComm 控件会产生错误 68（设备无效）。
注意：必须在打开端口之前设置 CommPort 属性。

RThreshold 属性：在 MSComm 控件设置 CommEvent 属性为 comEvReceive 并产生 OnComm 之前，设置并返回的要接收的字符数。
语法 object.Rthreshold [ = value ]（value 整型表达式，说明在产生 OnComm 事件之前要接收的字符数。 ）
说明 当接收字符后，若 Rthreshold 属性设置为 0（缺省值）则不产生 OnComm 事件。例如，设置 Rthreshold 为 1，接收缓冲区收到每一个字符都会使 MSComm 控件产生 OnComm 事件。

CTSHolding 属性：确定是否可通过查询 Clear To Send (CTS) 线的状态发送数据。Clear To Send 是调制解调器发送到相联计算机的信号，指示传输可以进行。该属性在设计时无效，在运行时为只读。
语法： object.CTSHolding（Boolean）

Mscomm 控件的 CTSHolding 属性设置值：
True Clear To Send 线为高电平。 
False Clear To Send 线为低电平。 

说明：如果 Clear To Send 线为低电平 (CTSHolding = False) 并且超时时，MSComm 控件设置 CommEvent 属性为 comEventCTSTO (Clear To Send Timeout) 并产生 OnComm 事件。

Clear To Send 线用于 RTS/CTS (Request To Send/Clear To Send) 硬件握手。如果需要确定 Clear To Send 线的状态，CTSHolding 属性给出一种手工查询的方法。

详细信息 有关握手协议，请参阅 Handshaking 属性。

SThreshold 属性： MSComm 控件设置 CommEvent 属性为 comEvSend 并产生 OnComm 事件之前，设置并返回传输缓冲区中允许的最小字符数。

语法 object.SThreshold [ = value ]
value 整形表达式，代表在 OnComm 事件产生之前在传输缓冲区中的最小字符数。 

说明：若设置 Sthreshold 属性为 0（缺省值），数据传输事件不会产生 OnComm 事件。若设置 Sthreshold 属性为 1，当传输缓冲区完全空时，MSComm 控件产生 OnComm 事件。如果在传输缓冲区中的字符数小于 value，CommEvent 属性设置为 comEvSend，并产生 OnComm 事件。comEvSend 事件仅当字符数与 Sthreshold 交叉时被激活一次。例如，如果 Sthreshold 等于 5，仅当在输出队列中字符数从 5 降到 4 时，comEvSend 才发生。如果在输出队列中从没有比 Sthreshold 多的字符，comEvSend 事件将绝不会发生。