使用MICROSOFT提供的MSComm ActiveX组件 使用API 使用SerialPort类设计串口通讯程序 一．概述 在Visual Studio 6.0中编写串口通讯程序，一般都使用Microsoft Communication Control（简称MSComm）的通讯控件，只要通 过对此控件的属性和事件进行相应编程操作，就可以轻松地实现串口通讯。但在Microsoft.Net技术广泛应用的今天，Visual Studio.Net没有将此控件加入控件库，所以人们采用了许多方法在Visual Studio.Net来编写串口通讯程序：第一种方法是通过采用Visual Studio 6.0中原来的MSComm控件这是最简单的，最方便的方法，但需要注册；第二种方法是采用微软在.NET推出了一个串口控件，基于.NET的P/Invoke调用方法实现；第三种方法是自己用API写串口通信，虽然难度高，但可以方便实现自己想要的各种功能。 现在微软推出了最新版本的Visual Studio 2005开发工具，可以不再采用第三方控件的方法来设计串口通讯程序。NET Framework 2.0 类库包含了SerialPort 类,方便地实现了所需要串口通讯的多种功能，为了使MSComm编程方法快速转换到以SerialPort类为核心的串口通讯的设计方法，本文着重讨论了Visual Studio 6.0的MSComm控件和SerialPort 类设计方法的异同点。 二．SerialPort常用属性、方法和事件 1．命名空间 System.IO.Ports命名空间包含了控制串口重要的SerialPort类，该类提供了同步 I/O 和事件驱动的 I/O、对管脚和中断状态的访问以及对串行驱动程序属性的访问，所以在程序代码起始位置需加入Using System.IO.Ports。 2．串口的通讯参数 串口通讯最常用的参数就是通讯端口号及通讯格式(波特率、数据位、停止位和校验位)，在MSComm中相关的属性是CommPort和Settings。SerialPort类与MSComm有一些区别: a.通讯端口号 [PortName]属性获取或设置通信端口，包括但不限于所有可用的 COM 端口，请注意该属性返回类型为String，不是Mscomm.CommPort的short类型。通常情况下，PortName正常返回的值为COM1、COM2……，SerialPort类最大支持的端口数突破了CommPort控件中CommPort属性不能超过16的限止，大大方便了用户串口设备的配置。 b. 通讯格式 SerialPort类对分别用[BaudRate]、[Parity]、[DataBits]、[StopBits]属性设置通讯格式中的波特率、数据位、停止位和校验位，其中[Parity]和[StopBits]分别是枚举类型Parity、StopBits，Parity类型中枚举了Odd(奇)、Even(偶)、Mark、None、Space，Parity枚举了None、One、OnePointFive、Two。 SerialPort类提供了七个重载的构造函数，既可以对已经实例化的SerialPort对象设置上述相关属性的值，也可以使用指定的端口名称、波特率和奇偶校验位数据位和停止位直接初始化 SerialPort 类的新实例。 3．串口的打开和关闭 SerialPort类没有采用MSComm.PortOpen=True/False设置属性值打开关闭串口，相应的是调用类的Open()和Close()方法。 4. 数据的发送和读取 Serial类调用重载的Write和WriteLine方法发送数据，其中WriteLine可发送字符串并在字符串末尾加入换行符，读取串口缓冲区的方法有许多，其中除了ReadExisting和ReadTo,其余的方法都是同步调用，线程被阻塞直到缓冲区有相应的数据或大于ReadTimeOut属性设定的时间值后，引发ReadExisting异常。 5.DataReceived事件 该事件类似于MSComm控件中的OnComm事件，DataReceived事件在接收到了[ReceivedBytesThreshold]设置的字符个数或接收到了文件结束字符并将其放入了输入缓冲区时被触发。其中[ReceivedBytesThreshold]相当于MSComm控件的[Rthreshold]属性，该事件的用法与MsComm控件的OnComm事件在CommEvent为comEvSend和comEvEof时是一致的。 三．SerialPort的使用 对于熟悉MSComm控件的程序设计者，SerialPort类是相当容易上手的。在进行串口通讯时，一般的流程是设置通讯端口号及波特率、数据位、停止位和校验位，再打开端口连接，发送数据，接收数据，最后关闭端口连接这样几个步骤。 数据接收的设计方法在这里比较重要，采用轮询的方法比较浪费时间，在Visual Basic中的延时方法中一般会调用API并用DOEvents方法来处理，但程序不易控制，建议采用DataReceived事件触发的方法，合理的设置ReceivedBytesThreshold的值，若接收的是定长的数据，则将ReceivedBytesThreshold设为接收数据的长度，若接收数据的结尾是固定的字符或字符串则可采用ReadTo的方法或在DataReceived事件中判断接收的字符是否满足条件。 SerialPort类读取数据的许多方法是同步阻塞调用，尽量避免在主线程中调用，可以使用异步处理或线程间处理调用这些读取数据的方法。 由于DataReceived事件在辅线程被引发，当收到完整的一条数据，返回主线程处理或在窗体上显示时，请注意跨线程的处理，C#可采用控件异步委托的方法Control.BeginInvoke及同步委托的方法Invoke。 四．结束语 在.NET平台下熟练使用SerialPort 类，可以很好地开发出串口通讯类程序，对于过去使用MSComm控件设计了一些通讯程序，也可以将MSComm控件替换为SerialPort类，当然为了避免对以前的项目做大的改动，可以使用SerialPort类设计一些与MSComm控件具有相同接口的类，在今后工业控制中，SerialPort类将广泛地应用于串口通讯程序的设计中，发挥着与MSComm控件一样的作用。 相关关键词 串口通讯 MSComm控件 Visual C++为我们提供了一种好用的ActiveX控件Microsoft Communications Control(即MSComm)来支持应用程序对串口的访问，在应用程序中插入MSComm控件后就可以较为方便地实现对通过计算机串口收发数据。 要使用ActiveX控件MSComm，程序员必须将其添加入工程，其方法是： （1）单击主菜单project的子菜单Add To project的Components and Controls选项； （2）在弹出的”Components and Controls Gallery”对话框中选择Registered ActiveX Controls文件夹中的”Microsoft Communications Control,version 6.0”选项，如下图：
单击其中的”Insert”按钮，MSComm控件就被增加到工程中了。与此同时，类CMSComm的相关文件mscomm.h和mscomm.cpp也一并被加入Project的Header Files和Source Files中。当然，程序员可以自己修改文件名，如下图：
直接分析mscomm.h头文件就可以完备地获取这个控件的使用方法（主要是public类型的接口函数），下面我们摘取了头文件的主要代码并对其关键部分给出了注释：
#if !defined(AFX_MSCOMM_H__) #define AFX_MSCOMM_H__ #if _MSC_VER > 1000 #pragma once #endif // _MSC_VER > 1000 // Machine generated IDispatch wrapper class(es) created by Microsoft Visual C++ // NOTE: Do not modify the contents of this file. If this class is regenerated by // Microsoft Visual C++, your modifications will be overwritten. ///////////////////////////////////////////////////////////////////////////// // CMSComm wrapper class class CMSComm : public CWnd { protected: DECLARE_DYNCREATE(CMSComm) public: CLSID const& GetClsid() { static CLSID const clsid = { 0x648a5600, 0x2c6e, 0x101b, { 0x82, 0xb6, 0x0, 0x0, 0x0, 0x0, 0x0, 0x14 } }; return clsid; } virtual BOOL Create(LPCTSTR lpszClassName, LPCTSTR lpszWindowName, DWORD dwStyle, const RECT& rect, CWnd* pParentWnd, UINT nID, CCreateContext* pContext = NULL) { return CreateControl(GetClsid(), lpszWindowName, dwStyle, rect, pParentWnd, nID); } BOOL Create(LPCTSTR lpszWindowName, DWORD dwStyle, const RECT& rect, CWnd* pParentWnd, UINT nID, CFile* pPersist = NULL, BOOL bStorage = FALSE, BSTR bstrLicKey = NULL) { return CreateControl(GetClsid(), lpszWindowName, dwStyle, rect, pParentWnd, nID, pPersist, bStorage, bstrLicKey); } // Attributes public: // Operations public: void SetCDHolding(BOOL bNewValue); BOOL GetCDHolding(); void SetCommID(long nNewValue); long GetCommID(); void SetCommPort(short nNewValue); //设置端口号，如nNewValue =1表示COM1 short GetCommPort(); void SetCTSHolding(BOOL bNewValue); BOOL GetCTSHolding(); void SetDSRHolding(BOOL bNewValue); BOOL GetDSRHolding(); void SetDTREnable(BOOL bNewValue); BOOL GetDTREnable(); void SetHandshaking(long nNewValue); long GetHandshaking(); void SetInBufferSize(short nNewValue); short GetInBufferSize(); void SetInBufferCount(short nNewValue); short GetInBufferCount(); void SetBreak(BOOL bNewValue); BOOL GetBreak(); void SetInputLen(short nNewValue); short GetInputLen(); void SetNullDiscard(BOOL bNewValue); BOOL GetNullDiscard(); void SetOutBufferSize(short nNewValue); short GetOutBufferSize(); void SetOutBufferCount(short nNewValue); short GetOutBufferCount(); void SetParityReplace(LPCTSTR lpszNewValue); CString GetParityReplace(); void SetPortOpen(BOOL bNewValue); //打开或关闭串口，TRUE：打开，FALSE：关闭 BOOL GetPortOpen(); //串口是否已打开，TRUE：打开，FALSE：关闭 void SetRThreshold(short nNewValue); //如果设置为1，表示一接收到字符就发送2号事件 short GetRThreshold(); void SetRTSEnable(BOOL bNewValue); //硬件握手使能？ BOOL GetRTSEnable(); void SetSettings(LPCTSTR lpszNewValue); //Settings由4部分组成，其格式为：”BBBB,P,D,S”，即”波特率,是否奇偶校验,数据位 //个数,停止位”，如设置为：”9600,n,8,1” CString GetSettings(); void SetSThreshold(short nNewValue); //如果保持缺省值0不变，则表示发送数据的过程中串口上不发生事件 short GetSThreshold(); void SetOutput(const VARIANT& newValue); //一个非常重要的函数，用于写串口，注意其接收的输入参数为VARIANT类型对象， //我们需要将字符串转化为VARIANT类型对象 VARIANT GetOutput(); void SetInput(const VARIANT& newValue); VARIANT GetInput(); //一个非常重要的函数，用于读串口，注意其返回的是VARIANT类型对象，我们需要 //将其转化为字符串 void SetCommEvent(short nNewValue); short GetCommEvent(); //一个非常重要的函数，获得串口上刚发生的事件（”事件”可以理解为软件意义上的 //“消息”或硬件意义上的”中断”），事件的发送会导致OnComm消息的诞生！ void SetEOFEnable(BOOL bNewValue); BOOL GetEOFEnable(); void SetInputMode(long nNewValue); long GetInputMode(); }; // // Microsoft Visual C++ will insert additional declarations immediately before the previous line. #endif
分析上述源代码可知，基本上，MSComm的诸多接口可以分为如下几类： （1）打开与设置串口接口函数； （2）获得串口设置和串口状态接口函数； （3）设置串口发送数据方式、缓冲区接口及发送数据接口函数； （4）设置串口接收数据方式、缓冲区接口及接收数据接口函数； （5）设置与获取串口上发生的事件接口函数。
打开串口
来的一直循环到打开为止的方法行了，后来想改成初始化时全部打开通过数组调用那个端口，但没有行 do{ if(m_bCommOpen[0] = m_tstPort[0].InitPort(this,5)) {m_tstPort[0].StartMonitoring();openLP=0;} else{openLP=1; } }while(openLP);
关闭串口函数
CSerialPort::wlyClosePort() { /* */ do { SetEvent(m_hShutdownEvent); } while (m_bThreadAlive); // delete [] m_szWriteBuffer; //没有中间这部分会有问题 if (m_ov.hEvent != NULL) CloseHandle(m_ov.hEvent); if (m_hWriteEvent != NULL) CloseHandle(m_hWriteEvent); if (m_hShutdownEvent != NULL) CloseHandle(m_hShutdownEvent); m_ov.hEvent = NULL; m_hWriteEvent = NULL; m_hShutdownEvent = NULL; if (m_hComm != NULL) { CloseHandle(m_hComm); m_hComm = NULL; } TRACE(“关闭了\n”); }
单个发送和连续发送
port->m_ov.Offset = 0; port->m_ov.OffsetHigh = 0; // Clear buffer PurgeComm(port->m_hComm, PURGE_RXCLEAR PURGE_TXCLEAR PURGE_RXABORT PURGE_TXABORT); for(UINT i = 0;i
