使用MSCOMM32控件编写串口程序

MSCOMM32控件的基本属性

  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 向传输缓冲区写一个字符串。

下面分别描述：

2.1 CommPort属性

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

2.2 RThreshold 属性

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

2.3 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 属性。

2.4 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 事件将毫不会发生。

2.5 Handshake 常数

常数 值 描述
comNone 0 无握手。
comXonXoff 1 XOn/Xoff 握手。
comRTS 2 Request-to-send/clear-to-send 握手。
comRTSXOnXOff 3 Request-to-send 和 clear-to-send 握手皆可。

comEVENT的值在产生事件时，将会是下面的这些值：表明不一样的事件发生。

2.6 OnComm 常数

常数 值 描述
comEvSend 1 发送事件。
comEvReceive 2 接收事件。
comEvCTS 3 clear-to-send 线变化。
comEvDSR 4 data-set ready 线变化。
comEvCD 5 carrier detect 线变化。
comEvRing 6 振铃检测。
comEvEOF 7 文件结束。

2.7 Error 常数

常数 值 描述

comEventBreak 1001 接收到中断信号
comEventCTSTO 1002 Clear-to-send 超时
comEventDSRTO 1003 Data-set ready 超时
comEventFrame 1004 帧错误
comEventOverrun 1006 端口超速
comEventCDTO 1007 Carrier detect 超时
comEventRxOver 1008 接收缓冲区溢出
comEventRxParity 1009 Parity 错误
comEventTxFull 1010 传输缓冲区满
comEventDCB 1011 检索端口 设备控制块 (DCB) 时的意外错误

2.8 InputMode 常数

常数 值 描述
comInputModeText 0 （缺省）经过 Input 属性以文本方式取回数据。
comInputModeBinary 1 经过 Input 属性以二进制方式检取回数据。

2.9 CDHolding 属性

      经过查询 Carrier Detect (CD) 线的状态肯定当前是否有传输。Carrier Detect 是从调制解调器发送到相联计算机的一个信号，指示调制解调器正在联机。该属性在设计时无效，在运行时为只读。

语法 object.CDHolding
设置值：CDHolding 属性的设置值为：
设置 描述
True Carrier Detect 线为高电平
False Carrier Detect 线为低电平
说明：注意当 Carrier Detect 线为高电平 (CDHolding = True) 且超时时，MSComm 控件设置CommEvent 属性为 comEventCDTO（Carrier Detect 超时错误），并产生 OnComm 事件。
注意 在主机应用程序中捕获一个丢失的传输是特别重要的，例如一个公告板，由于呼叫者能够随时挂起（放弃传输）。
Carrier Detect 也被称为 Receive Line Signal Detect (RLSD)。
数据类型 Boolean

2.10 DSRHolding 属性

      肯定 Data Set Ready (DSR) 线的状态。Data Set Ready 信号由调制解调器发送到相连计算机，指示做好操做准备。该属性在设计时无效，在运行时为只读。
语法：object.DSRHolding
object 所在处表示对象表达式，其值是“应用于”列表中的对象。
DSRHolding 属性返回如下值：
值 描述
True Data Set Ready 线高
False Data Set Ready 线低
说明：当 Data Set Ready 线为高电平 (DSRHolding = True) 且超时时，MSComm 控件设置 CommEvent 属性为 comEventDSRTO（数据准备超时）并产生 OnComm 事件。
当为 Data Terminal Equipment (DTE) 机器写 Data Set Ready/Data Terminal Ready 握手例程时该属性是十分有用的。
数据类型：Boolean

2.11 Settings 属性

     设置并返回波特率、奇偶校验、数据位、中止位参数。

语法: object.Settings[ = value]
说明：当端口打开时，若是 value 非法，则 MSComm 控件产生错误 380（非法属性值）。
value 由四个设置值组成，有以下的格式：
"BBBB,P,D,S"
BBBB 为波特率，P 为奇偶校验，D 为数据位数，S 为中止位数。value 的缺省值是：
"9600,N,8,1"

2.12 InputLen 属性

     设置并返回 Input 属性从接收缓冲区读取的字符数。

语法 object.InputLen [ = value]
InputLen 属性语法包括下列部分：
value 整型表达式，说明 Input 属性从接收缓冲区中读取的字符数。
说明：InputLen 属性的缺省值是 0。设置 InputLen 为 0 时，使用 Input 将使 MSComm 控件读取接收缓冲区中所有的内容。

若接收缓冲区中 InputLen 字符无效，Input 属性返回一个零长度字符串 ("")。在使用 Input 前，用户能够选择检查 InBufferCount 属性来肯定缓冲区中是否已有须要数目的字符。该属性在从输出格式为定长数据的机器读取数据时很是有用。

2.13 EOFEnable 属性

      肯定在输入过程当中 MSComm 控件是否寻找文件结尾 (EOF) 字符。若是找到 EOF 字符，将中止输入并激活 OnComm 事件，此时 CommEvent 属性设置为 comEvEOF，
语法：object.EOFEnable [ = value ]
EOFEnable 属性语法包括下列部分：
value 布尔表达式，肯定当找到 EOF 字符时，OnComm 事件是否被激活，如“设置值”中所描述。
value 的设置值：
True 当 EOF 字符找到时 OnComm 事件被激活。
False （缺省）当 EOF 字符找到时 OnComm 事件不被激活。
说明：当 EOFEnable 属性设置为 False，OnComm 控件将不在输入流中寻找 EOF 字符。

2.14 错误消息（MS Comm 控件）

下表列出 MSComm 控件能够捕获的错误：

值 描述
380 无效属性值 comInvalidPropertyvalue
383 属性为只读 comSetNotSupported
394 属性为只读 comGetNotSupported
8000 端口打开时操做不合法 comPortOpen
8001 超时值必须大于 0
8002 无效端口号 comPortInvalid
8003 属性只在运行时有效
8004 属性在运行时为只读
8005 端口已经打开 comPortAlreadyOpen
8006 设备标识符无效或不支持该标识符
8007 不支持设备的波特率
8008 指定的字节大小无效
8009 缺省参数错误
8010 硬件不可用（被其它设备锁定）
8011 函数不能分配队列
8012 设备没有打开 comNoOpen
8013 设备已经打开
8014 不能使用 comm 通知
8015 不能设置 comm 状态 comSetCommStateFailed
8016 不能设置 comm 事件屏蔽
8018 仅当端口打开时操做才有效 comPortNotOpen
8019 设备忙
8020 读 comm 设备错误 comReadError
8021 为该端口检索设备控制块时的内部错误 comDCBError

 补充，若是是偶校验则将ole_1.object.settings="1200,n,8,1" 中的n改成e,奇校验为o
 w1 = asc(ole_1.object.input)
//若是读入的是7位的acs码，则将w1 – 48 既为所要的值，48的16进制是30H，是十进制的0
若是ole_1.object.commevent的返回值为3 ：clear-to-send 线变化，则是由于设备与电脑的链接线有问题，须要将标准rc-232线进行调线，即将2线和3线进行交换。即将设备的发送接到电脑的接收上，将设备的接收接到电脑的发送上。

 

3 一个例子

下面两张图 是一个 利用MsCom进行串口通信（中断方式）的程序框图和回调VI的程序框图

使用RTThrsehold属性设置触发接收中断事件的触发条件，本程序设置为1，当缓冲器接收到一个字符 时，就会发生中断事件——oncomm事件中断，不少条件均可以产生oncomm事件，区分产生中断的缘由有Comevent的属性值来肯定，当 conevent为2时，表示是因为接收到字符产生的中断，由此进入接受中断处理程序。

而中断处理程序，接收到的数据是变体数据，转换为数组型数据，发送数组中，最后送到返回变量中，供显示和绘制实时图使用。

commevent的参数 对比表！

根据应用程序的用途和功能，在链接到其它设备过程当中，以及接收或发送数据过程当中，可能须要监视并响应一些事件和错误。 可使用 OnComm 事件和 CommEvent 属性捕捉并检查通信事件和错误的值。 在发生通信事件或错误时，将触发 OnComm 事件，CommEvent 属性的值将被改变。所以，在发生 OnComm 事件的时候，若是有必要，能够检查 CommEvent 属性的值。因为通信（特别是经过电话线的通信）是不可预料的，捕捉这些事件和错误将有助于使应用程序对这些状况做出相应的反应。 下表列出了可能触发 OnComm 事件的通信事件。对应的值将在发生事件时被写入 CommEvent 属性。
常数	值	描述
ComEvSend	1	发送缓冲区中的字符数少于 SThreshold。
ComEvReceive	2	接收到 Rthreshold 个字符。在使用 Input 属性移去接收缓冲区中的数据以前，该事件将持续产生。
ComEvCTS	3	CTS 信号发生变化。
ComEvDSR	4	DSR 信号发生变化。该事件仅在 DSR 由 1 变为 0 时触发。
ComEvCD	5	CD 信号发生变化。
ComEvRing	6	检测到电话振铃。某些 UART（通用异步收发器）可能不支持本事件。
ComEvEOF	7	收到文件结束符（ASCII 字符 26）。
下列错误一样会触发 OnComm 事件，而且在 CommEvent 属性中写入相应的值。
设置值	值	描述
ComEventBreak	1001	收到 Break 信号。
ComEventFrame	1004	帧错误。硬件检测到帧错误。
ComEventOverrun	1006	端口超限。在下一个字符到达端口以前，前一字符尚未从硬件中读走，于是丢失。
ComEventRxOver	1008	接收缓冲区溢出。接收缓冲区已没有空间。
ComEventRxParity	1009	奇偶校验错误。硬件检测到奇偶校验错误。
comEventTxFull	1010	发送缓冲区满。在试图将字符传入发送缓冲区时，该缓冲区已满。
ComEventDCB	1011	在为端口获取设备控制块 (DCB) 时，发生不可预料的错误。

另外： 须要注意的是  给output属性赋值输出时，有两种可用的形式：1是字符串 2是字节型数值 数组，就是占一个字节的数值组成的数组。而后转化为变体数据类型。

以下图所示：

U8类型数值的数组。

————————————————————————————————————————————————

关于RTThrsehold  和 inputlen  的设置，我一直搞不明白，因此在实际应用中出现过这样那样的问题。

例如 接收到的数据远远小于发送的数据了，接收到的数据出现乱码了，等等。

通过反复的实验

我发现 若是将inputlen设置的太小(如1)，同时呢，发送的波特率太高，就会出现接受到的数据小于实际发送出的数据。

由于将RTHrsehold设置为1的时候，每收到一个字符就会产生一次中断，此次中断会提取 inputlen个数的字符。

若是波特率太高，就会致使，中断不可以及时发生（每次中断只读取一个字符，而产生的中断数目小于实际发送的字符数），不少数据到最后积累在缓冲区内。

（这是我经过程序最后读取缓冲区的数据大小进行的判断）

所以必要时，能够将RTHrsehold和inputlen的值都设大一些，才可以正常。（使得中断处理函数的时间远远小于产生中断的时间便可）