VB中 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 控件的常用属性
      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,N,8,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,8,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
              ' 读取数据.
              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,N,8,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,N,8,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
      '清除接收缓冲区
      MSComm1.InBufferCount =0
      '拨电话号码
      MSComm1.Output = DialString$
      Lblmessage.Caption = “正在拨号码 －”＋Number$
      DialButton.Enabled = True
      QuitButton.Enabled = True
      End Sub
      Private Sub MSComm1_OnComm()
      Select Case MSComm1.CommEvent
      Case comEvReceive
      '读取串口数据
      COMBUF=COMBUF ＋ MSComm1.Input
      lc = InStr(1, COMBUF, “OK”)
      If lc = 0 Then Exit Sub
      'Modem已正常拨号，返回OK
      Lblmessage.Caption = “请您摘下电话机， 准备通话”
      Case comEvSend
      End Select
      End Sub
      Private Sub CancelButton_Click()
      '断开与调制解调器的连接
      MSComm1.Output = “ATH” ＋ vbCr
      End Sub

      实例2：实现来电显示
      在一些实际应用中，需要显示并保存来电号码，并根据电话号码显示相应资料，比如小区物业管理和110报警等系统。
      实现步骤：
      1．创建窗体
      添加一个MSComm控件，用来建立与串口的连接；
      添加4个Option控件，用来确定使用的串口号；
      添加4个Label控件，用来显示来电号码及日期时间；
      添加一个ProgressBar控件，用来显示电话振铃次数；
      为方便调试程序，添加一个Text控件Text 5，用来显示Modem传来的所有信息。窗体见图2。
      图2 来电显示窗体
      2．设置MSComm控件属性
      InBufferSize=1024；
      Inputlen=0；
      InputMode=0；
      Rthreshold=1；
      RTSEnable=True；
      Settings=“9600,N,8,1"；
      Sthreshold=0。
      3．程序功能
      程序首先初始化Modem，然后等待来电。当有来电时，MSComm产生OnComm事件。Modem送出的信息格式为“DATE = 月日回车换行TIME
      = 时分回车换行NMBR =
      电话号码回车换行”。在OnComm事件处理程序中对读入信息进行截取，截取电话号码后，以该电话号码为关键字，查询并显示数据库中有关信息。
      4．主要方法与事件代码
      '通用声明部分
      Const DEBFLG = 1
      Public COMX, BEEPNO, HANGUP,PNLOC As Integer
      Public COMBUF, COMLIN As String
      Private Sub Form_Load()
      '检测串行口
      Dim I, C As Integer
      COMX = 0
      COMBUF = “”
      COMLIN = “”
      BEEPNO = 0
      HANGUP = 0
      '正常运行程序，关闭右侧Text5
      If DEBFLG= 0 Then
      Form1.Width = Form1.Width － Text5.Width
      Text5.Enabled = False
      Text5.Visible = False
      End If
      On Error GoTo ERROR_FORM_LOAD
      '检测可用串口
      For C = 1 To 4
      If MSComm1.PortOpen Then MSComm1.PortOpen = False
      MSComm1.CommPort = C
      If Not MSComm1.PortOpen Then
      MSComm1.PortOpen = True
      If MSComm1.PortOpen Then MSComm1.PortOpen = False
      If COMX = 0 Then COMX = C
      FORM_LOAD_1:
      Next C
      If COMX = 0 Then End
      On Error GoTo 0
      Option1(COMX － 1).Value = True
      Exit Sub
      ERROR_FORM_LOAD:
      Option1(C － 1).Enabled = False
      Resume FORM_LOAD_1
      End Sub
      '选择串行口
      Private Sub Option1_Click(Index As Integer)
      COMX = Index ＋ 1
      Call INIT_MODEM
      End Sub
      '初试化Modem
      Private Sub INIT_MODEM()
      If MSComm1.PortOpen Then MSComm1.PortOpen = False
      MSComm1.CommPort = COMX
      If Not MSComm1.PortOpen Then MSComm1.
      PortOpen = True
      MSComm1.Output = “AT＃CID=1” ＋ vbCr
      '检查Modem命令是否完成
      Call CHK_MODEM
      MSComm1.Output = “ATS0=0” ＋ vbCr
      End Sub
      '检查Modem命令是否完成
      Private Sub CHK_MODEM()
      Dim T As Single
      Dim L As Integer
      T = Timer
      Do
      COMBUF = COMBUF ＋ MSComm1.Input
      L = InStr(1, COMBUF,“OK”)
      Loop Until L <> 0 Or Timer － T > 1
      If L = 0 Then
      Line1.Visible = True
      Line2.Visible = True
      Form1.Show
      MsgBox “MODEM未联机”,vbOKOnly＋vbCritical,“测试MODEM”
      Else
      Line1.Visible = False
      Line2.Visible = False
      End If
      End Sub
      '串行口接收事件处理
      Private Sub MSComm1_OnComm()
      Dim CH, ST As String
      Dim LC As Integer
      Select Case MSComm1.CommEvent
      '接收到Rthreshold个字符
      Case comEvReceive
      COMBUF = COMBUF ＋ MSComm1.Input
      '读取串口数据
      Do
      LC = InStr(1, COMBUF, Chr(10))
      If LC = 0 Then Exit Do
      COMLIN = Left(COMBUF, LC)
      COMBUF = Mid(COMBUF, LC ＋ 1)
      CH = Left(COMLIN, 1)
      If “ ” < CH And CH < Chr(127) And DEBFLG = 1 Then
      Text5.Text = Text5.Text ＋ COMLIN
      Text5.SelStart = Len(Text5.Text)
      End If
      '截取来电号码,并显示
      If InStr(1, COMLIN“NMBR=”)<> 0 Then
      ST = Mid(COMLIN, 8)
      Text2.Text=“ ”＋Left$(ST,Len (ST) －2) ＋ “ ”
      Form1.WindowState = 0
      Timer1.Enabled = True
      Call BEEP_NO
      '截取来电日期,并显示
      ElseIf InStr(1, COMLIN, “DATE = ”) <> 0 Then
      Text3.Text = Str(Year(DATE)) ＋ “.”＋ Mid(COMLIN, 8, 2) ＋ “.” ＋ Mid(COMLIN,
      10, 2) ＋ “ ”
      '截取来电时间,并显示
      ElseIf InStr(1, COMLIN, “TIME = ”) <> 0 Then
      Text4.Text = “ ” ＋ Mid(COMLIN, 8, 2) ＋ “:” ＋ Mid(COMLIN, 10, 2)
      '检测振铃个数
      ElseIf InStr(1, COMLIN, “RING”) <> 0 Then
      Call BEEP_NO
      If HANGUP = 1 Or BEEPNO = 15 Then Call HANG_UP
      '检测是否停止振铃
      ElseIf Left(COMLIN, 3) = “000” Then
      BEEPNO = 0
      Timer1.Enabled = False
      Form1.WindowState = 1
      ProgressBar1.Value = 0
      Frame3.Caption = “振铃数”
      End If
      Loop
      '其他事件处理
      Case comEvCTS
      Case comEvDSR
      Case comEvCD
      Case comEvRing
      Case comEventBreak
      Call INIT_MODEM
      Case Else
      MsgBox “串口接收事件号：” ＆ MSComm1.CommEvent ＆ “ ”, vbOKOnly ＋
      vbCritical, “测试串行口”
      End Select
      End Sub