VBNET开发全功能串口调试助手.doc

VB.NET开发全功能串口调试助手 （含完整工程）小记：VB.NET的串口通信用了很长时间了，也只用Write和Read这样的方法，以前都是用这种方式做上位机软件，如此足矣。而前几天研究GSM模块时对串口返回的数据总是把握不好，参考开发板附送的例程，发现采用SerialPort的DataReceived事件，可以实现中断触发式的数据接收。于是想到要自己做一个串口调试助手，在实现基本功能的前提下增加一些方便自己调试的功能。经过断断续续的编写，就做成了下面这个小软件：这个软件能够实现串口调试助手的全部功能，经过通信测试，数据接收性能不亚于呼啸工作室的SComAssistant2.2，通过加大输入缓冲区，可以满足大量数据接收。VB.NET的串口通信主要使用VS自带的SerialPort控件，而不是早先的MSComm，更具有兼容性，这也是很久以前就放弃VB改用.NET的直接原因。该控件的主要方法、属性如下（该数据来自VS的MSDN帮助库）：方法说明Open打开一个新的串行端口连接。Close关闭端口连接，将IsOpen属性设置为false，并释放内部Stream对象。Read已重载。从SerialPort输入缓冲区中读取。ReadByte从SerialPort输入缓冲区中同步读取一个字节。ReadChar从SerialPort输入缓冲区中同步读取一个字符。ReadExisting在编码的基础上，读取SerialPort对象的流和输入缓冲区中所有立即可用的字节。ReadLine一直读取到输入缓冲区中的NewLine值。ReadTo一直读取到输入缓冲区中的指定value的字符串。Write已重载。将数据写入串行端口输出缓冲区。WriteLine将指定的字符串和NewLine值写入输出缓冲区。DiscardInBuffer丢弃来自串行驱动程序的接收缓冲区的数据。DiscardOutBuffer丢弃来自串行驱动程序的传输缓冲区的数据。GetPortNames获取当前计算机的串行端口名称数组。属性说明PortName获取或设置通信端口，包括但不限于所有可用的COM端口。BaudRate获取或设置串行波特率。DataBits获取或设置每个字节的标准数据位长度。Parity获取或设置奇偶校验检查协议。StopBits获取或设置每个字节的标准停止位数。IsOpen获取一个值，该值指示SerialPort对象的打开或关闭状态。BytesToRead获取接收缓冲区中数据的字节数。BytesToWrite获取发送缓冲区中数据的字节数。Encoding获取或设置传输前后文本转换的字节编码。ReadBufferSize获取或设置SerialPort输入缓冲区的大小。ReceivedBytesThreshold获取或设置DataReceived事件发生前内部输入缓冲区中的字节数。WriteBufferSize获取或设置串行端口输出缓冲区的大小。想要通过串口收发数据，就需要对串口进行配置，包括设置端口、波特率、数据格式（如COM1端口、9600bps、8位数据位、无校验位、1位停止位）等属性，之后通过Open方法打开串口。打开串口可通过手动指定，也可以使用GetPortNames方法获取计算机中存在的串口。如果打开出错，则可能是串口不存在或者已被占用。下面是相应代码：PrivateSubSerialPortOpen()OnErrorGoToErrIfSerialPort.IsOpen =TrueThenSerialPort.Close()避免重复打开端口SerialPort.Open()LabelCOMStatus.Text =串口已打开ExitSubErr:MsgBox(串口不存在或已被占用！+ vbNewLine + ErrorToString()出现错误，显示错误信息EndSub如果想要在串口中支持中文字符收发，则可在初始化时设置串口控件的编码：SerialPort.Encoding = System.Text.Encoding.Default发送数据通过Write方法来完成，由于串口调试助手需要支持文本和16进制，需要加入转换代码：PrivateSubButtonSendData_Click(ByValsenderAsSystem.Object,ByValeAsSystem.EventArgs)HandlesButtonSendData.ClickOnErrorGoToErrDimoutDataBufAsString= TextBoxSend.TextIfoutDataBuf =ThenExitSub如果输入文本框中没有数据则不发送IfSerialPort.IsOpen =TrueThen判断串口是否打开IfHexSendFlag =TrueThen-十六进制发送-outDataBuf = outDataBuf.Replace( ,)清除空格与回车outDataBuf = outDataBuf.Replace(vbNewLine,)十六进制数据位数为偶数，例如：FF 00 15 AC 0DIfoutDataBuf.LengthMod2 0ThenMsgBox(请输入正确的十六进制数，用空格和回车隔开。)ExitSubEndIfDimoutBytes(outDataBuf.Length / 2 - 1)AsByteForIAsInteger= 1TooutDataBuf.Length - 1Step2outBytes(I - 1) / 2) = Val(&H+ Mid(outDataBuf, I, 2)VB的十六进制表示方法，例如0x1D表示为&H1DNextSerialPort.Write(outBytes, 0, outDataBuf.Length / 2)BarCountTx.Text = Val(BarCountTx.Text) + outDataBuf.Length / 2Else-文本发送-SerialPort.Write(outDataBuf)BarCountTx.Text = Val(BarCountTx.Text) + outDataBuf.Length发送字节计数EndIfElseMsgBox(串口未打开，请先打开串口。)EndIfExitSubErr:MsgBox(数据输入或发送错误！+ vbNewLine + ErrorToString()EndSub接收数据采用DataReceived事件，该事件在串口输入缓冲区中的字节数满足设置条件时触发，并执行事件中的代码。事件触发的字节数在ReceivedBytesThreshold属性中设置，默认为1字节。由于DataReceived事件采用了独立的线程，无法对软件界面中的控件进行直接操作，因而在现实时需要采用委托实例的方法。首先建立委托：DelegateSubRecieveRefreshMethodDelegate(ByValtextAsString)声明委托DimRecieveRefreshAsNewRecieveRefreshMethodDelegate(AddressOfRecieveRefreshMethod)定义数据显示委托实例SubRecieveRefreshMethod(ByValstrAsString)定义一个数据显示委托实例的方法ShowRecieveData(str)EndSub其中ShowRecieveData函数将str字符串显示到TextBox控件中。下面是DataReceived事件中对十六进制数据的处理。同发送数据一样，读取数据时也要根据不同的显示方式使用不同的方法。VB.NET通过Read方法，根据缓冲区中存在的字节数读取十六进制数据，而文本显示则简单的多，只需ReadExisting即可。最后通过Invoke方法调用委托，显示数据。PrivateSubSerialPort_DataReceived(ByValsenderAsObject,ByValeAsSystem.IO.Ports.SerialDataReceivedEventArgs)HandlesSerialPort.DataReceivedIfHexRecieveFlagThen-十六进制显示-DiminDataLenAsInteger= SerialPort.BytesToRead()获取可读取的字节数IfinDataLen 0ThenDiminBytes(inDataLen - 1)AsByte, bytesAsByteDimstrHexAsString=SerialPort.Read(inBytes, 0, inDataLen)读取数据ForEachbytesIninBytesstrHex = strHex + String.Format(0:X2 , bytes)格式化成十六进制（不含&H）NextTextBoxRecieve.Invoke(RecieveRefresh, strHex)调用委托，显示接收的数据BarCountRx.Text = (Val(BarCountRx.Text) + inDataLen).ToString接收字节计数EndIfElse-文本显示-DimstrAsStringstr = SerialPort.ReadExisting读取全部可用字符串TextBoxRecieve.Invoke(RecieveRefresh, str)BarCountRx.