原文地址:点击打开链接
MSComm控件使用详解
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 ]
CommPort 属性语法包括下列部分:
部分 描述
object 对象表达式,其值是“应用于”列表中的对象。
value 一整型值,说明端口号。
说明
在设计时,value 可以设置成从 1 到 16 的任何数(缺省值为 1)。但是如果用 PortOpen 属性打开一个并不存在的端口时,MSComm 控件会产生错误 68(设备无效)。
警告 必须在打开端口之前设置 CommPort 属性。
数据类型
Integer
Settings 属性
设置并返回波特率、奇偶校验、数据位、停止位参数。
语法
object.Settings[ = value]
Settings 属性语法包括下列部分:
部分 描述
object 对象表达式,其值是“应用于”列表中的对象。
value 字符串表达式,说明通讯端口的设置值,如下所述。
说明
当端口打开时,如果 value 非法,则 MSComm 控件产生错误 380(非法属性值)。
Value 由四个设置值组成,有如下的格式:
"BBBB,P,D,S"
BBBB 为波特率,P 为奇偶校验,D 为数据位数,S 为停止位数。value 的缺省值是:
"9600,N,8,1"
下表列出合法的波特率:
设置值
110
300
600
1200
2400
9600(缺省)
14400
19200
28800
38400
56000
128000
256000
下表说明合法的奇偶校验值。
设置值 描述
E 偶数 (Even)
M 标记 (Mark)
N 缺省 (Default)
None
O 奇数 (Odd)
S 空格 (Space)
下表列出合法的数据位值。
设置值
4
5
6
7
8 (缺省)
下表列出合法的停止位值。
设置值
1 (缺省)
1.5
2
数据类型
String
Settings 示例
下面的例子设置控件端口通讯,波特率 9600,无奇偶校验检查,8 个数据位,1 个停止位:
MSComm1.Settings = "9600,1"
PortOpen 属性
设置并返回通讯端口的状态(开或关)。在设计时无效。
语法
object.PortOpen[ = value]
PortOpen 属性语法包括下列部分:
部分 描述
object 对象表达式,其值是“应用于”列表中的对象。
value 布尔表达式,说明通讯端口的状态。
设置值
value 设置值是:
设置值 描述
True 端口开
False 端口关
说明
设置 PortOpen 属性为 True 打开端口。设置为 False 关闭端口并清除接收和传输缓冲区。当应用程序终止时,MSComm 控件自动关闭串行端口。
在打开端口之前,确定 CommPort 属性设置为一个合法的端口号。如果 CommPort 属性设置为一个非法的端口号,则当打开该端口时,MSComm 控件产生错误 68(设备无效)。
另外,串行端口设备必须支持 Settings 属性当前的设置值。如果 Settings 属性包含硬件不支持的通讯设置值,那么硬件可能不会正常工作。
如果在端口打开之前,DTREnable 或 RTSEnable 属性设置为 True,当关闭端口时,该属性设置为 False。否则,DTR 和 RTS 线保持其先前的状态。
数据类型
Boolean
PortOpen 属性示例
下例以波特率 9600 打开 1 号通讯端口,没有奇偶检查,8 个数据位,1 个停止位。
MSComm1.Settings = "9600,n,1"
MSComm1.CommPort = 1
MSComm1.PortOpen = True
Input 属性
返回并删除接收缓冲区中的数据流。该属性在设计时无效,在运行时为只读。
语法
object.Input
Input 属性语法包括下列部分:
部分 描述
object 对象表达式,其值是“应用于”列表中的对象。
说明
InputLen 属性确定被 Input 属性读取的字符数。设置 InputLen 为 0,则 Input 属性读取缓冲区中全部的内容。
InputMode 属性确定用 Input 属性读取的数据类型。如果设置 InputMode 为 comInputModeText,Input 属性通过一个 Variant 返回文本数据。如果设置 InputMode 为 comInputModeBinary,Input 属性通过一个 Variant .返回一二进制数据的数组。
数据类型
Variant
Input 属性示例
该例子说明如何从接收缓冲区读取数据。
Private Sub Command1_Click()
Dim InString as String
' 读取所有可用数据。
MSComm1.InputLen = 0
' 检查数据。
If MSComm1.InBufferCount Then
' Read data.
InString = MSComm1.Input
End If
End Sub
Output 属性
往传输缓冲区写数据流。该属性在设计时无效,在运行时为只读。
语法
object.Output [ = value ]
Output 属性语法包括下列部分:
部分 描述
object 对象表达式,其值是“应用于”列表中的对象。
value 要写到传输缓冲区中的一个字符串。
说明
Output 属性可以传输文本数据或二进制数据。用 Output 属性传输文本数据,必须定义一个包含一个字符串的 Variant。发送二进制数据,必须传递一个包含字节数组的 Variant 到 Output 属性。
正常情况下,如果发送一个 ANSI 字符串到应用程序,可以以文本数据的形式发送。如果发送包含嵌入控制字符、Null 字符等等的数据,要以二进制形式发送。
数据类型
Variant
Output 属性示例
下面的例子说明如何将用户键入的每一个字符送到串行端口:
Private Sub Form_KeyPress (KeyAscii As Integer)
Dim Buffer as Variant
' 设置并打开窗口
MSComm1.CommPort = 1
MSComm1.PortOpen = True
Buffer = Chr$(KeyAscii)
MSComm1.Output = Buffer
End Sub
OnComm 事件
无论何时当 CommEvent 属性的值变化时,就产生 OnComm 事件,标志发生了一个通讯事件或一个错误。
语法
Private Sub object_OnComm ()
OnComm 事件语法包括下列部分: 部分 描述 object 对象表达式,其值是“应用于”列表中的对象。 说明 CommEvent 属性包含实际错误或产生 OnComm 事件的数码。注意,设置 Rthreshold 或 Sthreshold 属性为 0,分别使捕获 comEvReceive 和 comEvSend 事件无效。 OnComm 事件示例 下例说明如何处理通讯错误和事件。可以在相关的 Case 语句之后插入代码来处理特定的错误或事件。 Private Sub MSComm_OnComm () Select Case MSComm1.CommEvent ' Handle each event or error by placing ' code below each case statement ' 错误 Case comEventBreak ' 收到 Break。 Case comEventCDTO ' CD (RLSD) 超时。 Case comEventCTSTO ' CTS Timeout。 Case comEventDSRTO ' DSR Timeout。 Case comEventFrame ' Framing Error Case comEventOverrun '数据丢失。 Case comEventRxOver '接收缓冲区溢出。 Case comEventRxParity ' Parity 错误。 Case comEventTxFull '传输缓冲区已满。 Case comEventDCB '获取 DCB 时意外错误 ' 事件 Case comEvCD ' CD 线状态变化。 Case comEvCTS ' CTS 线状态变化。 Case comEvDSR ' DSR 线状态变化。 Case comEvRing ' Ring Indicator 变化。 Case comEvReceive ' 收到 RThreshold # ofchars. Case comEvSend ' 传输缓冲区有 Sthreshold 个字符 ' Case comEvEof ' 输入数据流中发现 EOF 字符 End Select End Sub CommEvent 属性 返回最近的通讯事件或错误。该属性在设计时无效,在运行时为只读。 语法 object.CommEvent CommEvent 属性语法包括下列部分: 部分 描述 object 对象表达式,其值是“应用于”列表中的对象。 说明 只要有通讯错误或事件发生时都会产生 OnComm 事件,CommEvent 属性存有该错误或事件的数值代码。要确定引发 OnComm 事件的确切的错误或事件,请参阅 CommEvent 属性。 CommEvent 属性返回下列值之一来表示不同的通讯错误或事件。这些常数可以在该控件的对象库中找到。通讯错误包括下列设置值: 常数 值 描述 comEventBreak 1001 接收到一个中断信号。 comEventCTSTO 1002 Clear To Send 超时。在系统规定时间内传输一个字符时,Clear To Send 线为低电平。 comEventDSRTO 1003 Data Set Ready 超时。在系统规定时间内传输一个字符时,Data Set Ready 线为低电平。 comEventFrame 1004 帧错误。硬件检测到一帧错误。 comEventOverrun 1006 端口超速。没有在下一个字符到达之前从硬件读取字符,该字符丢失。 comEventCDTO 1007 载波检测超时。在系统规定时间内传输一个字符时,Carrier Detect 线为低电平。Carrier Detect 也称为 Receive Line Signal Detect (RLSD)。 comEventRxOver 1008 接受缓冲区溢出。接收缓冲区没有空间。 comEventRxParity 1009 奇偶校验。硬件检测到奇偶校验错误 comEventTxFull 1010 传输缓冲区已满。传输字符时传输缓冲区已满 comEventDCB 1011 检索端口的设备控制块 (DCB) 时的意外错误 通讯事件包括下列设置值: 常数 值 描述 comEvSend 1 在传输缓冲区中有比 Sthreshold 数少的字符。 comEvReceive 2 收到 Rthreshold 个字符。该事件将持续产生直到用 Input 属性从接收缓冲区中删除数据。 comEvCTS 3 Clear To Send 线的状态发生变化。 comEvDSR 4 Data Set Ready 线的状态发生变化。该事件只在 DST 从 1 变到 0 时才发生。 comEvCD 5 Carrier Detect 线的状态发生变化。 comEvRing 6 检测到振铃信号。一些 UART(通用异步接收— 传输)可能不支持该事件。 comEvEOF 7 收到文件结束(ASCII 字符为 26)字符。 数据类型 Integer MSComm 控件示例 下面这个简单的例子演示了用调制解调器进行基本的串行通讯: Private Sub Form_Load () ' 保存输入子串的缓冲区 Dim Instring As String ' 使用 COM1。 MSComm1.CommPort = 1 ' 9600 波特,无奇偶校验,8 位数据,一个停止位。 MSComm1.Settings = "9600,1" ' 当输入占用时, ' 告诉控件读入整个缓冲区。 MSComm1.InputLen = 0 ' 打开端口。 MSComm1.PortOpen = True ' 将 attention 命令送到调制解调器。 ' Chr$函数:返回 String,其中包含有与指定的字符代码相关的字符 。 MSComm1.Output = "ATV1Q0" & Chr$(13) ' 确保 ' 调制解调器以"OK"响应。 ' 等待数据返回到串行端口。 Do DoEvents Buffer$ = Buffer$ & MSComm1.Input Loop Until InStr(Buffer$,"OK" & vbCRLF) ' 从串行端口读 "OK" 响应。 ' 关闭串行端口。 MSComm1.PortOpen = False End Sub 注意 MSComm 控件可以采用轮询或事件驱动的方法从端口获取数据。这个简单的例子使用了轮询方法。 实例1:计算机拨号 在一些实际应用中经常需要使用计算机拨号。下面这个例子利用MSComm控件操作Modem进行拨号,实现串口通信。 实现步骤: 1.建窗体 添加一个MSComm控件,用来建立与串口的连接; 添加一个Text控件,Name属性为Txttel,用来输入电话号码; 添加3个CommandButton控件,Name属性分别为DialButton、CancellButton、QuitButton,分别用来实现拨号、中止拨号、中止程序; 添加一个Label控件,用来显示所有与拨号有关的信息。窗体见图1。 2.设置MSComm控件属性 InBufferSize=1024; ’ InBufferSize 是指整个接收缓冲区的大小。缺省值是 1024 字节。 Inputlen=0; ’ InputLen 属性的缺省值是 0。设置 InputLen 为 0 时,使用 Input 将使 MSComm 控件读取接收缓冲区中全部的内容。 InputMode=0; ’0---(缺省)数据通过 Input 属性以文本形式取回。 1--数据通过 Input 属性以二进制形式取回 Rthreshold=2; ’ 当接收字符后,若 Rthreshold 属性设置为 0(缺省值)则不产生 OnComm 事件。 RTSEnable=True; ’ 当 RTSEnable 设置为 True,端口打开时,Request To Send 线设置为高电平,端口关闭时,设置为低电平。 Settings=“9600,1”; Sthreshold=0。 ’ 若设置 Sthreshold 属性为 0(缺省值),数据传输事件不会产生 OnComm 事件。若设置 Sthreshold 属性为 1,当传输缓冲区完全空时,MSComm 控件产生 OnComm 事件。 因为每一台计算机的串口使用状态都不会一样。为使程序具有通用性,在窗体的Load方法中首先进行串口测试,找到第一个可用串口后再进行设置。 3.程序功能 程序根据输入的电话号码进行拨号,Modem正常拨号后,提示用户摘机,准备通话。 图1 电话拨号实例 4.主要方法与事件代码 '设置可用串口 Private Sub Form_Load() On Error GoTo error_open For i = 1 To 4 MSComm1.CommPort = 1 MSComm1.PortOpen = True '设置可用的第一个串口 On Error GoTo 0 Exit Sub error_resume: Next error_open: Resume error_resume End Sub Private Sub DialButton_Click() Dim Number$,Temp$ Number$ = Trim$(Txttel.Text) ’ 返回 Variant (String),其中包含指定字符串的拷贝,没有前导空白 (LTrim)、尾随空白 (RTrim) 或前导和尾随空白 (Trim)。 If Number$ = “" Then MsgBox “请输入电话号码" Txttel.SetFocus Exit Sub End If DialButton.Enabled = False QuitButton.Enabled = False DialString$ =“ATDT”+ Number$ + “;” + vbCr |